git-portfolio

Git Portfolio

|PyPI| |Python Version| |License|

|Read the Docs| |Tests| |Codecov|

|pre-commit| |Black|

.. |PyPI| image:: https://img.shields.io/pypi/v/git-portfolio.svg :target: https://pypi.org/project/git-portfolio/ :alt: PyPI .. |Python Version| image:: https://img.shields.io/pypi/pyversions/git-portfolio :target: https://pypi.org/project/git-portfolio :alt: Python Version .. |License| image:: https://img.shields.io/pypi/l/git-portfolio :target: https://en.wikipedia.org/wiki/GNU_Lesser_General_Public_License :alt: License .. |Read the Docs| image:: https://img.shields.io/readthedocs/git-portfolio/latest.svg?label=Read%20the%20Docs :target: https://git-portfolio.readthedocs.io/ :alt: Read the documentation at https://git-portfolio.readthedocs.io/ .. |Tests| image:: https://github.com/staticdev/git-portfolio/workflows/Tests/badge.svg :target: https://github.com/staticdev/git-portfolio/actions?workflow=Tests :alt: Tests .. |Codecov| image:: https://codecov.io/gh/staticdev/git-portfolio/branch/main/graph/badge.svg :target: https://app.codecov.io/gh/staticdev/git-portfolio :alt: Codecov .. |pre-commit| image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white :target: https://github.com/pre-commit/pre-commit :alt: pre-commit .. |Black| image:: https://img.shields.io/badge/code%20style-black-000000.svg :target: https://github.com/psf/black :alt: Black

Features

• Configure multiple working repositories.
• Batch git_ commands with subcommands: add, branch, checkout, commit, diff, fetch, init, merge, mv, pull, push, rebase, reset, rm, show, switch, status and tag.
• Batch API calls on GitHub_: create/close/reopen issues, create/close/reopen/merge pull requests and delete branches by name.
• Batch Poetry_ commands such as: add, version patch, install or update.

Requirements

• Create an auth token for GitHub_, with the repo privileges enabled by clicking on Generate new token. You will be asked to select scopes for the token. Which scopes you choose will determine what information and actions you will be able to perform against the API. You should be careful with the ones prefixed with write:, delete: and admin: as these might be quite destructive. You can find description of each scope in docs here.

Important: safeguard your token (once created you won't be able to see it again).

• Install git_ (optional) - this is needed for all git_ commands. For colored outputs please use the configuration:

.. code:: console

$ git config --global color.ui always

Installation

You can install Git Portfolio via pip_ from PyPI_:

.. code:: console

$ pip install git-portfolio

.. basic-usage

Basic usage

• Create initial configuration with:

.. code:: console

$ gitp config init

• Execute all the commands you want. Eg.:

.. code:: console

$ gitp issues create # create same issue for all projects $ gitp checkout -b new-branch # checks out new branch new-branch in all projects $ gitp poetry version minor # bumps minor version of all projects that have pyproject.toml version

Note: by convention GitHub commands are always the resource name and action: eg. branches delete, issues create and prs merge (for pull requests). This avoid conflicts with batch git commands, as in gitp branch (executes git command) and gitp branches delete (execute operations using GitHub API).

.. end-basic-usage

Complete instructions can be found at git-portfolio.readthedocs.io_.

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide_.

License

Distributed under the terms of the MIT_ license, Git Portfolio is free and open source software.

Issues

If you encounter any problems, please file an issue_ along with a detailed description.

Credits

This project was generated from @cjolowicz's Hypermodern Python Cookiecutter template.

.. _Create an auth token for GitHub: https://github.com/settings/tokens .. _@cjolowicz: https://github.com/cjolowicz .. _Cookiecutter: https://github.com/audreyr/cookiecutter .. _git: https://git-scm.com .. _GitHub: https://github.com .. _MIT: https://opensource.org/licenses/MIT .. _PyPI: https://pypi.org/ .. _Hypermodern Python Cookiecutter: https://github.com/cjolowicz/cookiecutter-hypermodern-python .. _file an issue: https://github.com/staticdev/git-portfolio/issues .. _pip: https://pip.pypa.io/ .. _Poetry: https://python-poetry.org/ .. _git-portfolio.readthedocs.io: https://git-portfolio.readthedocs.io .. github-only .. _Contributor Guide: https://git-portfolio.readthedocs.io/en/latest/contributing.html