|
| 1 | +<a id="index"></a> |
| 2 | + |
| 3 | +<div align="center"> |
| 4 | + |
| 5 | +<!-- Hacktoberfest 2025 Banner --> |
| 6 | +<a href="https://hacktoberfest.com/"> |
| 7 | + <img src="https://img.shields.io/badge/Hacktoberfest-2025-blueviolet?style=for-the-badge&logo=hacktoberfest" alt="Hacktoberfest 2025"> |
| 8 | +</a> |
| 9 | + |
| 10 | +<br><br> |
| 11 | + |
| 12 | +<!-- Title: --> |
| 13 | + <a href="https://github.com/TheAlgorithms/"> |
| 14 | + <img src="https://raw.githubusercontent.com/TheAlgorithms/website/1cd824df116b27029f17c2d1b42d81731f28a920/public/logo.svg" height="100"> |
| 15 | + </a> |
| 16 | + <h1><a href="https://github.com/TheAlgorithms/">The Algorithms</a> - Python</h1> |
| 17 | + |
| 18 | +<!-- Labels: --> |
| 19 | + <!-- First row: --> |
| 20 | + <a href="https://gitpod.io/#https://github.com/TheAlgorithms/Python"> |
| 21 | + <img src="https://img.shields.io/badge/Gitpod-Ready--to--Code-blue?logo=gitpod&style=flat-square" height="20" alt="Gitpod Ready-to-Code"> |
| 22 | + </a> |
| 23 | + <a href="https://github.com/TheAlgorithms/Python/blob/master/CONTRIBUTING.md"> |
| 24 | + <img src="https://img.shields.io/static/v1.svg?label=Contributions&message=Welcome&color=0059b3&style=flat-square" height="20" alt="Contributions Welcome"> |
| 25 | + </a> |
| 26 | + <img src="https://img.shields.io/github/repo-size/TheAlgorithms/Python.svg?label=Repo%20size&style=flat-square" height="20"> |
| 27 | + <a href="https://the-algorithms.com/discord"> |
| 28 | + <img src="https://img.shields.io/discord/808045925556682782.svg?logo=discord&colorB=7289DA&style=flat-square" height="20" alt="Discord chat"> |
| 29 | + </a> |
| 30 | + <a href="https://gitter.im/TheAlgorithms/community"> |
| 31 | + <img src="https://img.shields.io/badge/Chat-Gitter-ff69b4.svg?label=Chat&logo=gitter&style=flat-square" height="20" alt="Gitter chat"> |
| 32 | + </a> |
| 33 | + |
| 34 | + <!-- Second row: --> |
| 35 | + <br> |
| 36 | + <a href="https://github.com/TheAlgorithms/Python/actions"> |
| 37 | + <img src="https://img.shields.io/github/actions/workflow/status/TheAlgorithms/Python/build.yml?branch=master&label=CI&logo=github&style=flat-square" height="20" alt="GitHub Workflow Status"> |
| 38 | + </a> |
| 39 | + <a href="https://github.com/pre-commit/pre-commit"> |
| 40 | + <img src="https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=flat-square" height="20" alt="pre-commit"> |
| 41 | + </a> |
| 42 | + <a href="https://docs.astral.sh/ruff/formatter/"> |
| 43 | + <img src="https://img.shields.io/static/v1?label=code%20style&message=ruff&color=black&style=flat-square" height="20" alt="code style: black"> |
| 44 | + </a> |
| 45 | + |
| 46 | +<!-- Short description: --> |
| 47 | + <h3>All algorithms implemented in Python - for education π</h3> |
| 48 | +</div> |
| 49 | + |
| 50 | +Implementations are for learning purposes only. They may be less efficient than the implementations in the Python standard library. Use them at your discretion. |
| 51 | + |
| 52 | +--- |
| 53 | + |
| 54 | +## π Hacktoberfest 2025 |
| 55 | + |
| 56 | +This repository is participating in **Hacktoberfest 2025**! π |
| 57 | + |
| 58 | +We welcome contributions from developers of all skill levels. Whether you're a beginner or an experienced developer, there's something for everyone! |
| 59 | + |
| 60 | +### How to Participate |
| 61 | + |
| 62 | +1. Register at [hacktoberfest.com](https://hacktoberfest.com/) |
| 63 | +2. Find issues labeled `hacktoberfest` or `good first issue` |
| 64 | +3. Submit quality pull requests |
| 65 | +4. Make 4 valid PRs between October 1-31 to earn rewards! |
| 66 | + |
| 67 | +### Hacktoberfest Guidelines |
| 68 | + |
| 69 | +- β
Read our [Contributing Guidelines](CONTRIBUTING.md) first |
| 70 | +- β
Look for issues tagged with `hacktoberfest` |
| 71 | +- β
Submit quality PRs (no spam!) |
| 72 | +- β
Be respectful and collaborative |
| 73 | +- β Low-quality PRs will be marked as `invalid` or `spam` |
| 74 | + |
| 75 | +**Happy Hacking!** π |
| 76 | + |
| 77 | +--- |
| 78 | + |
| 79 | +## π Getting Started |
| 80 | + |
| 81 | +π Read through our [Contribution Guidelines](CONTRIBUTING.md) before you contribute. |
| 82 | + |
| 83 | +## π Community Channels |
| 84 | + |
| 85 | +We are on [Discord](https://the-algorithms.com/discord) and [Gitter](https://gitter.im/TheAlgorithms/community)! Community channels are a great way for you to ask questions and get help. Please join us! |
| 86 | + |
| 87 | +## π List of Algorithms |
| 88 | + |
| 89 | +See our [directory](DIRECTORY.md) for easier navigation and a better overview of the project. |
| 90 | + |
| 91 | +--- |
| 92 | + |
| 93 | +## π€ Contributing |
| 94 | + |
| 95 | +We love contributions! π |
| 96 | + |
| 97 | +Before you start contributing, please read our [Contribution Guidelines](CONTRIBUTING.md) to understand our coding standards, commit message conventions, and pull request process. |
| 98 | + |
| 99 | +### How to Contribute |
| 100 | + |
| 101 | +1. **Fork the repository** to your GitHub account |
| 102 | +2. **Clone your fork** to your local machine |
| 103 | + |
| 104 | +```bash |
| 105 | + git clone https://github.com/YOUR_USERNAME/Python.git |
| 106 | +``` |
| 107 | + |
| 108 | +## π License |
| 109 | + |
| 110 | +This project is licensed under the terms of the [MIT License](LICENSE). |
| 111 | +You are free to use, modify, and distribute the code as long as proper credit is given. |
0 commit comments