Configure Nox and basic Poetry support

- Use new structure for code blocks in README

README.md

@@ -293,52 +293,37 @@ This saved one line of code, and implicitly prevented invoking `some_func` twice
 ### ▶ Strings can be tricky sometimes
 
 <!-- Example ID: 30f1d3fc-e267-4b30-84ef-4d9e7091ac1a --->
-1\.
-
-```py
->>> a = "some_string"
->>> id(a)
-140420665652016
->>> id("some" + "_" + "string") # Notice that both the ids are same.
-140420665652016
-```
 
-2\.
-```py
->>> a = "wtf"
->>> b = "wtf"
->>> a is b
-True
-
->>> a = "wtf!"
->>> b = "wtf!"
->>> a is b
-False
+1\. Notice that both the ids are same.
 
+```python:snippets/2_tricky_strings.py -s 2 -e 3
+assert id("some_string") == id("some" + "_" + "string")
+assert id("some_string") == id("some_string")
 ```
 
-3\.
+2\. `True` because it is invoked in script. Might be `False` in `python shell` or `ipython`
 
-```py
->>> a, b = "wtf!", "wtf!"
->>> a is b # All versions except 3.7.x
-True
+```python:snippets/2_tricky_strings.py -s 6 -e 12
+a = "wtf"
+b = "wtf"
+assert a is b
 
->>> a = "wtf!"; b = "wtf!"
->>> a is b # This will print True or False depending on where you're invoking it (python shell / ipython / as a script)
-False
-```
-
-```py
-# This time in file some_file.py
 a = "wtf!"
 b = "wtf!"
-print(a is b)
+assert a is b
+```
+
+3\. `True` because it is invoked in script. Might be `False` in `python shell` or `ipython`
+
+```python:snippets/2_tricky_strings.py -s 15 -e 19
+a, b = "wtf!", "wtf!"
+assert a is b
 
-# prints True when the module is invoked!
+a = "wtf!"; b = "wtf!"
+assert a is b
 ```
 
-4\.
+4\. __Disclaimer - snippet is not relavant in modern Python versions__
 
 **Output (< Python3.7 )**
 

noxfile.py

@@ -0,0 +1,13 @@
+from typing import TYPE_CHECKING
+
+import nox
+
+
+if TYPE_CHECKING:
+    from nox.sessions import Session
+
+python_versions = ["3.9", "3.10", "3.11", "3.12", "3.13"]
+
+@nox.session(python=python_versions, reuse_venv=True)
+def tests(session: "Session") -> None:
+    _ = session.run("python", "snippets/2_tricky_strings.py")

pyproject.toml

@@ -0,0 +1,16 @@
+[tool.poetry]
+name = "wtfpython"
+version = "3.0.0"
+description = "What the f*ck Python!"
+authors = ["Satwik Kansal <[email protected]>"]
+license = "WTFPL 2.0"
+readme = "README.md"
+
+[tool.poetry.dependencies]
+python = "^3.9"
+nox = "^2024.10.9"
+
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

snippets/2_tricky_strings.py

@@ -0,0 +1,19 @@
+# 1
+assert id("some_string") == id("some" + "_" + "string")
+assert id("some_string") == id("some_string")
+
+# 2
+a = "wtf"
+b = "wtf"
+assert a is b
+
+a = "wtf!"
+b = "wtf!"
+assert a is b
+
+# 3
+a, b = "wtf!", "wtf!"
+assert a is b
+
+a = "wtf!"; b = "wtf!"
+assert a is b