Update and reorganize documentation

.gitignore

@@ -127,3 +127,6 @@ dmypy.json
 
 # Pyre type checker
 .pyre/
+
+# IDEs and editors
+.idea/

README.md

@@ -10,18 +10,19 @@ This repository is a kind of documentation about my knowledge about Python, here
 
 Python official page: https://www.python.org/
 
-- [Python Functions](https://github.com/lbrealdev/0k-python/tree/main/python-functions)
-- [Python Classes and OOP](https://github.com/lbrealdev/0k-python/tree/main/python-OOP)
-- [Python Data Structures](https://github.com/lbrealdev/0k-python/tree/main/python-data-structure)
-- [Python Packaging and Dependency Management](https://github.com/lbrealdev/0k-python/tree/main/python-packaging)
-- [Python Builds](https://github.com/lbrealdev/0k-python/tree/main/python-builds)
-- [Python Virtual Environments](https://github.com/lbrealdev/0k-python/tree/main/python-virtualenvs)
-- [Python Enhancement Proposals](https://github.com/lbrealdev/0k-python/blob/main/python-peps)
-- [Python Testing](https://github.com/lbrealdev/0k-python/blob/main/python-testing)
-- [Python GUI](https://github.com/lbrealdev/0k-python/blob/main/python-gui)
-- [Python TUI](https://github.com/lbrealdev/0k-python/blob/main/python-tui)
-- [Python Blogs](https://github.com/lbrealdev/0k-python/blob/main/python-blogs)
-- [Python Web](https://github.com/lbrealdev/0k-python/blob/main/python-web)
+- ## Python
+  - [functions](python/functions/README.md)
+  - [classes and OOP](python/oop/README.md)
+  - [data structures](python/data-structure/README.md)
+  - [packaging](python/packaging/README.md)
+  - [builds](python/builds/README.md)
+  - [venvs](python/virtualenvs/README.md)
+  - [peps](python/peps/README.md)
+  - [tests](python/testing/README.md)
+  - [gui](python/gui/README.md)
+  - [tui](python/tui/README.md)
+  - [blogs](python/python-blogs/README.md)
+  - [web](python/web/README.md)
 
 ## Python Resources
 

python-blogs/README.md

@@ -7,18 +7,12 @@
 - [Python's Built-in Exceptions: A Walkthrough With Examples](https://realpython.com/python-built-in-exceptions/)
 - [Ruff: A Modern Python Linter for Error-Free and Maintainable Code](https://realpython.com/ruff-python/)
 - [Python's assert: Debug and Test Your Code Like a Pro](https://realpython.com/python-assert-statement/)
-- [Python's property(): Add Managed Attributes to Your Classes](https://realpython.com/python-property/)
-- [Using Python Optional Arguments When Defining Functions](https://realpython.com/python-optional-arguments/)
-- [How Do You Choose Python Function Names?](https://realpython.com/python-function-names/)
 - [Python Mappings: A Comprehensive Guide](https://realpython.com/python-mappings/)
 - [Logging in Python](https://realpython.com/python-logging/)
 - [Asynchronous Iterators and Iterables in Python](https://realpython.com/python-async-iterators/)
-- [How to Use Generators and yield in Python](https://realpython.com/introduction-to-python-generators/)
 - [Defining Main Functions in Python](https://realpython.com/python-main-function/)
 - [Python's Built-in Functions: A Complete Exploration](https://realpython.com/python-built-in-functions/)
 - [Python Command-Line Arguments](https://realpython.com/python-command-line-arguments/)
-- [Python Metaclasses](https://realpython.com/python-metaclasses/)
-- [Python Classes: The Power of Object-Oriented Programming](https://realpython.com/python-classes/)
 - [Python Protocols: Leveraging Structural Subtyping](https://realpython.com/python-protocol/)
 - [Duck Typing in Python: Writing Flexible and Decoupled Code](https://realpython.com/duck-typing-python/)
 - [Python's pathlib Module: Taming the File System](https://realpython.com/python-pathlib/)
@@ -37,17 +31,30 @@
 - [Build a Command-Line To-Do App With Python and Typer](https://realpython.com/python-typer-cli/)
 - [Control Flow Structures in Python](https://realpython.com/python-control-flow/)
 - [Thinking Recursively in Python](https://realpython.com/python-thinking-recursively/)
-- [Defining Your Own Python Function](https://realpython.com/defining-your-own-python-function/)
-- [How Can You Structure Your Python Script?](https://realpython.com/python-script-structure/)
 - [Python Textual: Build Beautiful UIs in the Terminal](https://realpython.com/python-textual/)
 - [How to Get a List of All Files in a Directory With Python](https://realpython.com/get-all-files-in-directory-python/)
-- [What Is Python's __init__.py For?](https://realpython.com/python-init-py/)
 - [How to Read User Input From the Keyboard in Python](https://realpython.com/python-keyboard-input/)
 - [Build a Contact Book App With Python, Textual, and SQLite](https://realpython.com/contact-book-python-textual/)
 - [Python Scope and the LEGB Rule: Resolving Names in Your Code](https://realpython.com/python-scope-legb-rule/)
 - [What Does isinstance() Do in Python?](https://realpython.com/what-does-isinstance-do-in-python/)
 - [Python Glossary](https://realpython.com/ref/glossary/)
 
+- [Defining Your Own Python Function](https://realpython.com/defining-your-own-python-function/)
+- [What Does -> Mean in Python Function Definitions?](https://realpython.com/what-does-arrow-mean-in-python/)
+- [How Do You Choose Python Function Names?](https://realpython.com/python-function-names/)
+- [Using Python Optional Arguments When Defining Functions](https://realpython.com/python-optional-arguments/)
+
+- [Python Classes: The Power of Object-Oriented Programming](https://realpython.com/python-classes/)
+- [Python Class Constructors: Control Your Object Instantiation](https://realpython.com/python-class-constructor/)
+- [Python Metaclasses](https://realpython.com/python-metaclasses/)
+- [What Is Python's __init__.py For?](https://realpython.com/python-init-py/)
+- [Python's property(): Add Managed Attributes to Your Classes](https://realpython.com/python-property/)
+
+- [How to Run Your Python Scripts and Code](https://realpython.com/run-python-scripts/)
+- [How Can You Structure Your Python Script?](https://realpython.com/python-script-structure/)
+
+- [How to Use Generators and yield in Python](https://realpython.com/introduction-to-python-generators/)
+
 ## Mathspp
 > Website: https://mathspp.com
 

python-OOP/README.md → python/oop/README.md

@@ -37,4 +37,4 @@
 
 #### Year 7: [Class Methods, Static Methods, and Class Attributes](https://thepythoncodingstack.substack.com/p/python-oop-special-methods-6)
 
-:arrow_right: [The Python Coding Stack](https://thepythoncodingstack.substack.com/p/a-magical-tour-through-object-oriented)
+:arrow_right: [The Python Coding Stack](https://thepythoncodingstack.substack.com/p/a-magical-tour-through-object-oriented)

python-packaging/tools/uv/README.md → python/packaging/tools/uv/README.md

@@ -41,6 +41,11 @@ Update `uv` to the latest version:
 uv self update
 ```
 
+Get `uv` version:
+```shell
+uv self version
+```
+
 ### Python
 
 Install a specific Python version:

python-pypi/README.md → python/pypi/README.md

@@ -9,3 +9,9 @@
 
 - [Publishing to PyPI with a Trusted Publisher](https://docs.pypi.org/trusted-publishers/)
 - [Attestations: A new generation of signatures on PyPI](https://blog.trailofbits.com/2024/11/14/attestations-a-new-generation-of-signatures-on-pypi/)
+
+## PyPI API
+
+```shell
+curl -s "https://pypi.org/simple/<package-name>/?format=application/vnd.pypi.simple.v1+json" | jq
+```

python-virtualenvs/python-virtualenv.md → python/virtualenvs/python-virtualenv.md

@@ -93,4 +93,4 @@ wheel      0.34.2
 You can see the difference of your packages list Python installed on virtualenv with packages Python installed in your system.
 
 
-Source: [python.org](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/)
+Source: [python.org](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/)