Python Functions and Modules

Welcome to python-functions-and-modules, part of the practice-python-for-beginners series.

This repository helps learners understand how to write and use Python functions and organize reusable code into modules.

---

📚 Topics Covered

• Defining and calling functions
• Function arguments (positional, keyword, default, *args, **kwargs)
• Return values
• Importing modules (import, from ... import)
• Using built-in and custom modules

---

🧩 Repository: python-functions-and-modules

Purpose:
Teach learners about defining and calling functions, passing arguments, returning values, using built-in and custom modules, and writing modular, reusable Python code.

---

🗂 Directory Structure

python-functions-and-modules/
│
├── LICENSE
├── README.md
│
├── exercises/
│   ├── defining_functions.py
│   ├── arguments_and_returns.py
│   ├── custom_module_example.py
│   ├── importing_modules.py
│   └── tests/
│       ├── test_defining_functions.py
│       ├── test_arguments_and_returns.py
│       ├── test_importing_modules.py
│
└── requirements.txt

---

⚙️ Setup Instructions

1. Clone this repository:

   git clone https://github.com/practice-python-for-beginners/python-functions-and-modules.git
   cd python-functions-and-modules

2. Create and activate a virtual environment (optional):

   python -m venv venv
   source venv/bin/activate   # Windows: venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

4. Run tests to validate your understanding:

   pytest

---

🧠 Learning Outcomes

By working through these exercises, you will learn:

• How to define and call Python functions
• Importance of parameters and return values
• How to import and use standard and user-defined modules
• How modular Python code improves readability and reusability

---

🧾 License

This codebase is licensed under the GNU General Public License v3 (GPLv3).
See LICENSE for details.

---