Skip to main content

A user-friendly wrapper around PyGithub with workflow automation for common GitHub operations.

Project description

Documentation Status https://github.com/MacHu-GWU/pygithub_mate-project/actions/workflows/main.yml/badge.svg https://codecov.io/gh/MacHu-GWU/pygithub_mate-project/branch/main/graph/badge.svg https://img.shields.io/pypi/v/pygithub-mate.svg https://img.shields.io/pypi/l/pygithub-mate.svg https://img.shields.io/pypi/pyversions/pygithub-mate.svg https://img.shields.io/badge/✍️_Release_History!--None.svg?style=social&logo=github https://img.shields.io/badge/⭐_Star_me_on_GitHub!--None.svg?style=social&logo=github
https://img.shields.io/badge/Link-API-blue.svg https://img.shields.io/badge/Link-Install-blue.svg https://img.shields.io/badge/Link-GitHub-blue.svg https://img.shields.io/badge/Link-Submit_Issue-blue.svg https://img.shields.io/badge/Link-Request_Feature-blue.svg https://img.shields.io/badge/Link-Download-blue.svg

Welcome to pygithub_mate Documentation

https://pygithub-mate.readthedocs.io/en/latest/_static/pygithub_mate-logo.png

pygithub_mate is a user-friendly Python library that builds upon PyGithub to provide both simple wrappers and sophisticated workflow automation for GitHub operations. While PyGithub offers comprehensive access to the GitHub API, pygithub_mate focuses on making common tasks more intuitive and reliable through carefully designed abstractions and intelligent workflows.

The library offers two types of functionality: direct API wrappers that simplify common operations like tag and release creation, and advanced workflow methods that handle complex multi-step processes automatically. For example, while creating a simple tag is straightforward, the put_tag_on_commit method intelligently handles scenarios like checking if a tag already exists, whether it points to the correct commit, and automatically cleaning up and recreating tags when necessary.

Built around the command pattern, pygithub_mate encapsulates GitHub operations as self-contained, configurable objects with comprehensive logging and error handling. This design makes it particularly valuable for automation scripts, CI/CD pipelines, and release management workflows where reliability and visibility into the process are essential.

Install

pygithub_mate is released on PyPI, so all you need is to:

$ pip install pygithub-mate

To upgrade to latest version:

$ pip install --upgrade pygithub-mate

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

pygithub_mate-0.1.1.tar.gz (15.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pygithub_mate-0.1.1-py3-none-any.whl (17.0 kB view details)

Uploaded Python 3

File details

Details for the file pygithub_mate-0.1.1.tar.gz.

File metadata

  • Download URL: pygithub_mate-0.1.1.tar.gz
  • Upload date:
  • Size: 15.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.8

File hashes

Hashes for pygithub_mate-0.1.1.tar.gz
Algorithm Hash digest
SHA256 8934b140784116fb3ba362e4a91846bdeeb654b5f370b5057dc7045f1bb7e652
MD5 aa2b8c708b4d1af598ae875b62875551
BLAKE2b-256 693a0ed290e37819673b4019b5cb1d86368646ff4ef515bbfdf103f4f7caf958

See more details on using hashes here.

File details

Details for the file pygithub_mate-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: pygithub_mate-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 17.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.8

File hashes

Hashes for pygithub_mate-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f9f7ab96c0b611b90ad2d7827f0595339685f49549bdbb6b1ecaade29a246509
MD5 73adb8ab7fbe6d740f413d3c374312bc
BLAKE2b-256 2ca0625ffb16fabbc01eaf1795bfe1ac062c83018c934df8b9481e99a51b5002

See more details on using hashes here.

Supported by

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