Skip to main content

Bar-Raiser is a cutting-edge framework designed to help engineering teams tackle technical debt, streamline development workflows, and elevate code quality.

Project description

Bar-Raiser

Bar-Raiser is a cutting-edge framework designed to help engineering teams tackle technical debt, streamline development workflows, and elevate code quality.

Main Features

Create GitHub Checks for Enhanced Developer Experiences

  • Simplified Results: View linter or test results in a dedicated check page, eliminating the need to sift through console output.
  • Inline Annotations: View linter or test errors as annotations on GitHub Pull Requests, making it easier to understand errors in the context of the code.
  • Autofix Support: Apply auto-fixes with a single click. This feature requires setting up a web service to receive GitHub webhook events and apply the autofix on the PR.
  • Slack Notifications: Sends Slack notifications on check failures based on a provided mapping from GitHub login to Slack user ID. A SLACK_BOT_TOKEN and a GitHub login to Slack user ID mapping file are needed.

Examples

Available Checks

The following checks are available and can be configured in a CI workflow e.g. build.yml file. Ensure to provide the necessary environment variables (APP_ID, PRIVATE_KEY, PULL_NUMBER, SLACK_BOT_TOKEN (optional)).

checks/annotate_ruff.py Module

  • Ruff Integration: Runs Ruff formatter and linter, parses the output, and creates GitHub check runs with annotations and actions.
  • Autofix Support: Provides an autofix action to automatically fix issues detected by Ruff.

checks/annotate_pytest.py Module

  • Pytest Integration: Parses Pytest JSON reports and creates GitHub check runs with annotations for failed tests.

checks/annotate_pyright.py Module

  • Pyright Integration: Runs Pyright type checker, parses the output, and creates GitHub check runs with annotations and actions.
  • Autofix Support: Provides an autofix action to automatically fix issues detected by Pyright.

Getting Started (For Developers)

Prerequisites

  1. Clone the repository:
    git clone https://github.com/ZipHQ/bar-raiser.git
    
  2. Install PDM:
    pip install pdm
    
  3. Install dependencies in a local .venv folder:
    pdm install
    
  4. Install pre-commit hooks:
    pdm run pre-commit install
    

Dependencies

The project uses the following dependencies:

  • PyGithub (MIT License): A Python library to access the GitHub API v3.
  • GitPython (BSD License): A Python library used to interact with Git repositories.
  • cryptography (Apache License 2.0 or BSD License): A Python library providing cryptographic recipes and primitives.
  • slackclient (MIT License): A Python library for interacting with the Slack API.

Development Dependencies

The project also includes development dependencies for testing, linting, and code quality:

  • pytest (MIT License): A framework that makes building simple and scalable test cases easy.
  • diff-cover (MIT License): A tool for checking which lines of code are covered by tests.
  • pytest-cov (MIT License): A plugin for measuring code coverage with pytest.
  • ruff (MIT License): An extremely fast Python linter and formatter.
  • pyright (MIT License): A static type checker for Python.
  • pre-commit (MIT License): A framework for managing and maintaining multi-language pre-commit hooks.
  • pytest-json-report (MIT License): A plugin for creating JSON reports with pytest.

Pre-commit Hooks

Pre-commit hooks are used to run checks automatically when you commit code. These checks help ensure code quality and consistency. The following hooks are configured:

  • Trailing whitespace removal
  • End-of-file fixer
  • YAML file checks
  • Large file checks
  • PDM lock file check
  • PDM sync
  • Ruff for linting and formatting
  • Pyright for type checking
  • Pytest for running tests with coverage

To manually run the pre-commit hooks on all files, use:

pdm run pre-commit run --all-files

Running Tests

To execute the test suite, run:

pdm run pytest

API Changes

  • CI Interface: The CI interface will be maintained for compatibility until the next major version release.
  • Python API: The Python API is still under development, and backward compatibility may change at any time.

Contributing

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature-branch).
  3. Make your changes.
  4. Commit your changes (git commit -m 'Add some feature').
  5. Push to the branch (git push origin feature-branch).
  6. Open a pull request.

Coding Standards

  • Follow the existing code style.
  • Write unit tests for new features.
  • Ensure all tests pass before submitting a pull request.

Making a Release

To make a release, follow these steps:

  1. Ensure all changes are committed and pushed to the main branch.
  2. Create a new tag for the release:
    git tag -a vX.Y.Z -m "Release version X.Y.Z"
    git push origin vX.Y.Z
    
  3. The GitHub release workflow will automatically build and publish the release based on the tagged commit.

Credits

This project was developed collaboratively by the Zip Infra team. For insights into our work and ongoing updates, check out our tech blog. tech blog.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bar_raiser-0.0.7.tar.gz (24.2 kB view details)

Uploaded Source

Built Distribution

bar_raiser-0.0.7-py3-none-any.whl (19.0 kB view details)

Uploaded Python 3

File details

Details for the file bar_raiser-0.0.7.tar.gz.

File metadata

  • Download URL: bar_raiser-0.0.7.tar.gz
  • Upload date:
  • Size: 24.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: pdm/2.24.1 CPython/3.13.3 Linux/6.11.0-1013-azure

File hashes

Hashes for bar_raiser-0.0.7.tar.gz
Algorithm Hash digest
SHA256 90c2eaa391ffeb3f319ca8f87ebadbb28cceb0b213a89a19a8355b943f0ea46a
MD5 f52281fb7e82244ee974a67033e35ad1
BLAKE2b-256 c62f454fcd518d1a4c55503f728ff33760ac6f2e9e7cb343cb0a3c96c2ac4d9a

See more details on using hashes here.

File details

Details for the file bar_raiser-0.0.7-py3-none-any.whl.

File metadata

  • Download URL: bar_raiser-0.0.7-py3-none-any.whl
  • Upload date:
  • Size: 19.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: pdm/2.24.1 CPython/3.13.3 Linux/6.11.0-1013-azure

File hashes

Hashes for bar_raiser-0.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 f6730163f87d7d7bffdc83e19996ac006be2e2daa507e0e12c82938c7db7ea0c
MD5 d755d4b4e2c8f85dbc965a7e83fc3afc
BLAKE2b-256 b535d6af3798dc030a2edd29017ad94c41810e1e5683b1c291b763da04d3c903

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page