skyl / corpora

Corpora is a self-building corpus that can help build other arbitrary corpora
GNU Affero General Public License v3.0
2 stars 0 forks source link

Evaluate Ruff vs. Black for Python Codebase #21

Closed skyl closed 1 day ago

skyl commented 2 weeks ago

Background

The Corpora project currently uses Black for Python code formatting as mentioned in the TODO.md. However, there is a consideration to potentially use Ruff, another tool for static code analysis and formatting in Python.

Task

  1. Compare Ruff and Black:

    • Evaluate the differences between Ruff and Black in terms of features, ease of use, integration capabilities, and community support.
    • Identify what other static code checkers can complement Black if we continue to use it.
    • Determine if Ruff can serve as a standalone solution or if it needs to be used in conjunction with other tools.
  2. Compatibility with the Multi-Package Structure:

    • Assess how easily Ruff and Black can be integrated into the existing multi-package repository structure of Corpora.
    • Identify any potential issues or benefits in terms of maintainability and setup.
  3. Documentation & Best Practices:

    • Provide guidelines or document best practices on how to implement Ruff or Black in the current setup, focusing on usage in a development container as indicated in the README.md file.
    • Ensure that any new tools or methods align with the project’s emphasis on scalable, modular, and top-quality software development.

Deliverables

Context Related Files

skyl commented 1 day ago

62 - might as well go with ruff