✨ Project Template Repository Guide ✨
Hello Brain team! 👋
Here is a quick reminder on how to use our project template repository. Let's make our code clean and consistent! 😃
Usage Instructions 📚:
- Install Ruff: Run
pip install ruff
- Lint your code: Run
ruff check --fix
- Format your code: Run
ruff format
- For VSCode users: Install Ruff plugin from VSCode Marketplace
Let's keep our code neat and tidy! 🧹
Other Conventions 📝:
-
Type Annotations: Please include type annotations for intuitive and clear codes (your editor may help you more!). Here's an example:
def add(a: int, b: int) -> int: return a + b
-
Comments and Docstrings: Make sure to add comments and docstrings. For example:
def greet(name: str) -> str: """Return a greeting message for the given name. Args: name (str): The name to greet. Returns: str: Greeting message. """ return f"Hello, {name}!"
-
Dependencies: Record your dependencies in
requirements.txt
📄 -
README: Write a clear and concise
README.md
file 📘 -
Versioning: Update the
CHANGELOG.md
when releasing new versions 📈
For any other guidelines, please refer to the Google Python Style Guide. Let's adhere to these standards to maintain high-quality code! 🙏
Always appreciate for your dedicated effors! Happy hacking! 💻✨
Copyright (c) 2024 maum.ai Brain