cleaned pkg on basic odc

Docs/Basic/06-pkg-modules.md

@@ -1,61 +1,218 @@
+# 06 – Packages and Modules in Python
+
+This document explains how **modules**, **packages**, and the `__name__` concept work in Python.
+These features help organize code, reuse functionality, and build scalable projects.
+
+---
+
+## 1. Importing External Modules
+
+Python allows you to import **external libraries** installed in your environment.
+
+### Example: Using the `emoji` Module
+
+### Code
+
 ```python
 import emoji
 print(emoji.emojize("abbas is :red_heart:"))
 ```
 
+### Explanation
+
+* `import emoji` imports the entire `emoji` module.
+* `emoji.emojize()` converts emoji aliases into actual emoji characters.
+* You must use the module name (`emoji`) to access its functions.
+
+---
+
+### Importing a Specific Function
+
+### Code
+
 ```python
 from emoji import emojize
 print(emojize("abbas is :red_heart:"))
 ```
 
+### Explanation
+
+* `from emoji import emojize` imports only the `emojize` function.
+* You can call the function directly without prefixing the module name.
+* This approach is cleaner when you only need a specific function.
+
 ---
 
-create modules
+## 2. Creating a Module
 
+A **module** is a single Python file containing functions, classes, or variables.
+
+### File Structure
+
+```
 hi.py
+main.py
+```
+
+### `hi.py`
+
 ```python
 def hi():
     print("Hi :)")
 ```
-main.py
+
+### `main.py`
+
 ```python
 import hi
 hi.hi()
 ```
 
+### Explanation
 
---- 
+* `hi.py` is a module.
+* `hi()` is a function defined inside the module.
+* `import hi` loads the module.
+* `hi.hi()` calls the function from the module.
 
-create package
+---
+
+## 3. Creating a Package
+
+A **package** is a directory that contains multiple modules.
+
+### Package Structure
+
+```
+honor/
+│── __init__.py
+│── hi.py
+main.py
+```
+
+### `honor/hi.py`
 
-honor/hi.py
 ```python
 def hello():
     print("Hi :)")
 ```
-honor/__init__.py
+
+### `honor/__init__.py`
+
 ```python
 ```
 
-Can Be Empty But Must Be Exist
+### Explanation
+
+* The `honor` directory is a package.
+* `__init__.py` tells Python that this directory is a package.
+* The file can be empty, but it **must exist** (especially for older Python versions and clarity).
+
+---
+
+### Importing from a Package (Method 1)
+
+### `main.py`
 
-main.py
 ```python
 from honor import hi
 hi.hello()
 ```
-or
-main.py
+
+#### Explanation
+
+* Imports the `hi` module from the `honor` package.
+* Accesses the function using `hi.hello()`.
+
+---
+
+### Importing from a Package (Method 2)
+
+### `main.py`
+
 ```python
 from honor.hi import hello
 hello()
 ```
 
+#### Explanation
 
-__name__ conecpt :
+* Imports the `hello` function directly.
+* Allows calling the function without the module name.
+* Cleaner when only one function is needed.
+
+---
+
+## 4. The `__name__` Concept
+
+Every Python file has a built-in variable called `__name__`.
+
+### Code
 
 ```python
 print(__name__)
 ```
 
-if we run dirctly for example python3 abbas.py the output is __main__ but if import it that is diffrent
+### Behavior
+
+#### When a File Is Run Directly
+
+```bash
+python3 abbas.py
+```
+
+Output:
+
+```text
+__main__
+```
+
+* This means the file is the **entry point** of the program.
+
+#### When a File Is Imported
+
+```python
+import abbas
+```
+
+Output:
+
+```text
+abbas
+```
+
+* `__name__` is set to the **module name**, not `__main__`.
+
+---
+
+## 5. Why `__name__ == "__main__"` Is Important
+
+This pattern allows code to run **only when the file is executed directly**, not when imported.
+
+### Example
+
+```python
+def main():
+    print("Running directly")
+
+if __name__ == "__main__":
+    main()
+```
+
+### Explanation
+
+* The code inside the `if` block runs only when the file is executed directly.
+* Prevents unwanted execution when the file is imported as a module.
+* This is a standard Python best practice.
+
+---
+
+## Summary
+
+* **Module**: A single `.py` file
+* **Package**: A directory containing modules
+* `__init__.py`: Marks a directory as a package
+* `import module`: Imports the whole module
+* `from module import item`: Imports specific items
+* `__name__`: Identifies how a file is executed
+