β¨ 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