Your turn updated for packaging chapter.

Author: mikeckennedy

your-turn/11-python-packages/readme.md

@@ -5,7 +5,7 @@
 1. Create a project
 2. Make it a package
 3. Add a feature
-4. Include a setup
+4. Include a package definition file
 5. Use the package
 
 ## Create a project
@@ -74,40 +74,67 @@ In this special environment, it should work.
 
 ## Include a pyproject.toml
 
-It's great you can run your code locally. But for real packages, you'll need to be able to install it for consumers. To do this, we need a `setup.py`. 
-
-Luckily, PyCharm has our back. First select the top-level folder in the project (the one which contains the `calcy` folder with `__init__.py`. Choose `Tools > Create setup.py` and fill in the dialog. Most values are somewhat irrelevant. But name the package `calcy`.
-
-PyCharm may go overboard and include a bunch of stuff in the virtual environment. Just cut that out but leave:
-
-```python
-packages=['calcy']
+It's great you can run your code locally. But for real packages, you'll need to be able to install it for consumers. To do this, we need a `pyproject.toml` file. 
+
+Luckily, we can easily add one. While, at the time of this writing, PyCharm doesn't have support to generate one, they are pretty straightforward. Here is a template you can use. 
+
+```toml
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "calcy"
+version = "0.0.1"
+description = "A LIBRARY DESCRIPTION"
+# readme = "readme.md"
+license = "MIT"
+authors = [
+    { name = "YOUR NAME", email = "[email protected]" }
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent"
+]
+keywords = ["calcy", "math", "cacluator"]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/YOURNAME/calcy"
+
+[tool.hatch.version]
+path = "calcy/__init__.py"
+
+[tool.hatch.build.targets.sdist]
+include = ["calcy/", "readme.md"]
+
+[tool.hatch.build.targets.wheel]
+include = ["calcy/"]
 ```
 
+1. Create a new file in the top-level folder and name it `pyproject.toml`. Then copy the contents above into it and adjust as needed (e.g. your name).
+
 ## Use the package
 
 Now let's install the package. Open a terminal / shell. Activate the virtual environment in the project folder:
 
-```
+```bash
 # mac / linux
-. .env/bin/activate 
+. .venv/bin/activate 
 ```
 
+```bash
+# Windows
+.venv/scripts/activate
 ```
-Windows
-.env/scripts/activate
-```
-
-Now run `setup.py` **from the same directory** as it is in as follows. The easiest way to do this is with Python's builtin terminal (make sure the env is activated):
 
-```
-python3 setup.py develop
-```
+Now run `pip install -e .` **from the same directory** as it is in as follows. The easiest way to do this is with Python's builtin terminal (make sure the env is activated). If you have used uv, then you'll need `uv pip install -e .` (yes, the dot is part of the command, it means the current working directory)
 
-Now, in the terminal, change out of that folder to somewhere else. Run Python 3 and try to import and use it:
+Now, in the terminal, change out of that folder to somewhere else. Run Python and try to import and use it:
 
-```
-$ python3
+```python
+$ (venv) python
 import calcy
 calcy.math.add(7, 5)
 12