|
| 1 | +# Python Projects |
| 2 | + |
| 3 | +An open-source GitHub repository containing Python project ideas, steps, tips, and code solutions. |
| 4 | + |
| 5 | +This repository is designed to help Python learners at all levels, starting with beginner-friendly projects and gradually progressing to more advanced ones. Each project includes clear instructions and a working code implementation. |
| 6 | + |
| 7 | +## Table of Contents |
| 8 | +1. [Setup](#setup) |
| 9 | +2. [Beginner Projects](#beginner-projects) |
| 10 | +3. [Contributing](#contributing) |
| 11 | +4. [License](#license) |
| 12 | + |
| 13 | +## Setup |
| 14 | + |
| 15 | +- Make sure that you have at least Python `3.6` or later (we recommend `3.12`) installed on your computer. You can do a quick search and download it from a trusted provider for your platform. |
| 16 | + |
| 17 | +- Make sure that you have an IDE, or a place where you could code and run the Python interpreter. |
| 18 | +> [!TIP] |
| 19 | +> We use Visual Studio Code. It's fast, efficient, and has many extensions and customizability options. |
| 20 | + |
| 21 | +## Beginner Projects |
| 22 | +These projects are ideal for those new to Python. Each project includes a description, steps to follow, and tips for completing it. |
| 23 | + |
| 24 | +### 1. Calculator |
| 25 | +- **Description**: Build a simple calculator that performs basic arithmetic operations (`+`, `-`, `*`, `/`). |
| 26 | + |
| 27 | +- **Steps**: |
| 28 | + 1. Prompt the user for two numbers and an operator. |
| 29 | + 2. Perform the chosen operation. |
| 30 | + 3. Display the result. |
| 31 | + |
| 32 | +- **Tips:** |
| 33 | + |
| 34 | + </summary> |
| 35 | + <details><summary>Tip 1:</summary> |
| 36 | + |
| 37 | + Use `input()` to get the user's input. |
| 38 | + |
| 39 | + > [!TIP] |
| 40 | + > Learn more from here: https://docs.python.org/3/library/functions.html#input |
| 41 | + |
| 42 | + </details> |
| 43 | + <details><summary>Tip 2:</summary> |
| 44 | + |
| 45 | + Use `variables` to store the user's input. |
| 46 | + |
| 47 | + </details> |
| 48 | + <details><summary>Tip 3:</summary> |
| 49 | + |
| 50 | + Use `conditional` statements to check for valid values, and perform certain operations. |
| 51 | + |
| 52 | + > [!TIP] |
| 53 | + > Learn more from here: https://www.w3schools.com/python/python_conditions.asp |
| 54 | + |
| 55 | + </details> |
| 56 | + <details><summary>Tip 4:</summary> |
| 57 | + |
| 58 | + Print out the result using `print()`. |
| 59 | + |
| 60 | + > [!TIP] |
| 61 | + > Learn more from here: https://docs.python.org/3/library/functions.html#print |
| 62 | + |
| 63 | + </details> |
| 64 | + |
| 65 | +Working code solutions can be found in the `/Beginner` folder. |
| 66 | + |
| 67 | +--- |
| 68 | + |
| 69 | +## Contributing |
| 70 | +Contributions are welcome! If you have project ideas or improvements, feel free to fork the repository and open a pull request. |
| 71 | + |
| 72 | +--- |
| 73 | + |
| 74 | +## License |
| 75 | +This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details. |
0 commit comments