git-up


Namegit-up JSON
Version 2.3.0 PyPI version JSON
download
home_pagehttps://github.com/msiemens/PyGitUp
SummaryA python implementation of 'git up'
upload_time2024-10-05 20:00:30
maintainerNone
docs_urlNone
authorMarkus Siemens
requires_python<4.0,>=3.8
licenseMIT
keywords database nosql
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            PyGitUp |Version| |Build Status| |Coverage Status|
==================================================

|PyGitUp|_ is a Python port of
`aanand/git-up <https://github.com/aanand/git-up/>`__. It not only
fully covers the abilities of git-up and should be a drop-in replacement,
but also extends it slightly.

.. |PyGitUp| replace:: ``PyGitUp``
.. _PyGitUp: https://github.com/msiemens/PyGitUp

Why use ``git up``?
-------------------

    git pull has two problems:

    * It merges upstream changes by default, when it's really more polite to `rebase
      over them <http://gitready.com/advanced/2009/02/11/pull-with-rebase.html>`__,
      unless your collaborators enjoy a commit graph that looks like bedhead.

    * It only updates the branch you're currently on, which means git push will
      shout at you for being behind on branches you don't particularly care about
      right now.

    (https://github.com/aanand/git-up/)

Demonstration
-------------

.. image:: http://i.imgur.com/EC3pvYu.gif

Why use the Python port?
------------------------

I wasn't able to use the original ``git-up``, because I didn't want to install
a whole Ruby suite just for `git-up` and even with Ruby installed, there were
some problems running on my Windows machine. So, my reasons for writing
and using this port are:

1. Windows support.
2. Written in Python ;)

How do I install it?
--------------------

1. Install ``git-up`` via `pip <https://pip.pypa.io/en/latest/installing.html>`__: ``$ pip install git-up``
2. ``cd`` to your project's directory.
3. Run ``git up`` and enjoy!

Homebrew users can also use ``brew``: ``brew install pygitup``

How to run it locally?
----------------------

Could also checkout the **.github/workflows/ci-workflow.yml**

1. clone repo and ``cd`` to repo directory.
2. Install ``poetry`` as guided by `poetry installation doc <https://python-poetry.org/docs/#installation>`__
3. Run ``poetry install``
4. Run program with ``poetry run git-up``
5. Run all tests with ``poetry run pytest -v --cov=PyGitUp`` or ``poetry run pytest -v --cov=PyGitUp --cov-report html``
6. Run one test with ``poetry run pytest -q PyGitUp/tests/test_version.py -v --cov=PyGitUp``

Note for Windows users:
~~~~~~~~~~~~~~~~~~~~~~~

See `these instructions <http://stackoverflow.com/q/4750806/997063>`__
for installing pip, if you haven't already installed it. And don't forget
to either:

- make your ``Python/Scripts`` and ``Python/Lib/site-packages`` writable for
  you,
- run ``pip`` with admin privileges
- or use ``pip install --user git-up`` and add ``%APPDATA%/Python/Scripts``
  to ``%PATH%``.

Otherwise pip will refuse to install ``git-up`` due to ``Access denied`` errors.

Python version compatibility:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Python 3.7 and upwards are supported :)

Options and Configuration
-------------------------

Command Line Arguments
~~~~~~~~~~~~~~~~~~~~~~

- ``git up -h`` shows a help message.

- ``git up --quiet`` suppresses all output except for error messages.

- ``git up --no-fetch`` skips fetching the remote and rebases all local branches.

- ``git up --version`` shows the current version and optionally checks for
  updates (see below).

Configuration
~~~~~~~~~~~~~

To configure ``PyGitUp``, you can set options in your git config. Run
``git config [--global] git-up.[name] [value]`` to set one of these
options:

-  ``git-up.fetch.prune [*true*|false]``: If set to ``true``,
   ``PyGitUp`` will append the ``--prune``\ option to ``git fetch`` and
   thus remove any remote tracking branches which no longer exist on
   the remote (see `git fetch
   --help <http://linux.die.net/man/1/git-fetch>`__).

-  ``git-up.fetch.all [true|*false*]``: If set to ``false``, ``PyGitUp``
   will only fetch remotes for which there is at least one local
   tracking branch. Setting this option will make ``git up`` always fetch
   from all remotes, which is useful if e.g. you use a remote to push to
   your CI system but never check those branches out.

- ``git-up.push.auto [true|*false*]``: Push the current branch after
  rebasing and fast-forwarding.

- ``git-up.push.all [true|*false*]``: Push all branches when auto-pushing.

- ``git-up.push.tags [true|*false*]``: Push tags when auto-pushing.

-  ``git-up.rebase.arguments [string]``: If set, ``PyGitUp`` will use
   this string as additional arguments when calling ``git rebase``.
   Example: ``--preserve-merges`` to recreate merge commits in the
   rebased branch.

-  ``git-up.rebase.auto [*true*|false]``: If set to ``false``,
   ``PyGitUp`` won't rebase your branches for you but notify you that
   they diverged. This can be useful if you have a lot of in-progress
   work that you don't want to deal with at once, but still want to
   update other branches.

-  ``git-up.rebase.log-hook [cmd]``: Runs ``cmd`` every time a branch
   is rebased or fast-forwarded, with the old head as ``$1`` and the new
   head as ``$2``. This can be used to view logs or diffs of incoming
   changes. Example:
   ``echo "changes on $1:"; git log --oneline --decorate $1..$2``.

- ``git-up.rebase.show-hashes [true|*false*]``: If set to ``true``,
  ``PyGitUp`` will show the hashes of the current commit (or the point
  where the rebase starts) and the target commit like ``git pull`` does.

New in v1.0.0:
~~~~~~~~~~~~~~

- ``git-up.updates.check [*true*|false]``: When running ``git up --version``,
  it shows the version number and checks for updates. If you feel
  uncomfortable with it, just set it to ``false`` to turn off the checks.

Credits
-------

The original ``git-up`` has been written by aanand:
`aanand/git-up/ <https://github.com/aanand/git-up/>`__.


Changelog
---------

v2.3.0 (*2024-10-05*)
~~~~~~~~~~~~~~~~~~~~~

- Improve logging when updating large repositories. Thanks
  `@bdmartin <https://github.com/bdmartin>`_ for `Pull Request #132
  <https://github.com/msiemens/PyGitUp/pull/132>`_.
- Drop support for Python 3.7

v2.2.0 (*2022-11-21*)
~~~~~~~~~~~~~~~~~~~~~

- Add support for Python 3.11. Thanks
  `@hugovk <https://github.com/hugovk>`_ for `Pull Request #118
  <https://github.com/msiemens/PyGitUp/pull/118>`_.

v2.1.0 (*2021-10-02*)
~~~~~~~~~~~~~~~~~~~~~

- Switch to Python's ``argparse`` for CLI argument parsing. Thanks
  `@ekohl <https://github.com/ekohl>`_ for `Pull Request #96
  <https://github.com/msiemens/PyGitUp/pull/96>`_.

v2.0.3 (*2021-09-23*)
~~~~~~~~~~~~~~~~~~~~~

- Drop support for Python 3.6 (following GitPython)
- Update PyGitUp's CLI argument parser `Click <https://click.palletsprojects.com/en/8.0.x/>`_
  to version 8.0. Thanks `@hugovk <https://github.com/hugovk>`_
  for `Pull Request #109 <https://github.com/msiemens/PyGitUp/pull/109>`_.
- Update other dependencies

v2.0.2 (*2020-12-30*)
~~~~~~~~~~~~~~~~~~~~~

- Remove old Python 2 code. Thanks `@hugovk <https://github.com/hugovk>`_
  for `Pull Request #104 <https://github.com/msiemens/PyGitUp/pull/104>`_.

v2.0.1 (*2020-08-26*)
~~~~~~~~~~~~~~~~~~~~~

- Update dependencies

v2.0.0 (*2020-08-15*)
~~~~~~~~~~~~~~~~~~~~~

- Drop Python 2 support in order to fix `Issue 102 <https://github.com/msiemens/PyGitUp/issues/102>`_
- Drop Ruby Bundler integration
- Migrate tests to ``py.test``

v1.6.1 (*2018-12-12*)
~~~~~~~~~~~~~~~~~~~~~

- Upgrade to click>=7.0.0. Thanks `@no-preserve-root <https://github.com/no-preserve-root>`_
  for `Pull Request #87 <https://github.com/msiemens/PyGitUp/pull/87>`_.

v1.6.0 (*2018-10-26*)
~~~~~~~~~~~~~~~~~~~~~

- Skip stashing changes when possible. Thanks `@Chronial <https://github.com/Chronial>`_
  for `Pull Request #86 <https://github.com/msiemens/PyGitUp/pull/86>`_.
- Added faster fast-forward on branches that are not checked out. Thanks `@Chronial <https://github.com/Chronial>`_
  for `Pull Request #83 <https://github.com/msiemens/PyGitUp/pull/83>`_.

v1.5.2 (*2018-09-28*)
~~~~~~~~~~~~~~~~~~~~~

- Fixed version requirement for Click dependency (`#82 <https://github.com/msiemens/PyGitUp/issues/82>`__).

v1.5.1 (*2018-09-13*)
~~~~~~~~~~~~~~~~~~~~~

- Fixed crash on Cygwin with rebase log hook enabled (`#80 <https://github.com/msiemens/PyGitUp/issues/80>`__).

v1.5.0 (*2018-04-26*)
~~~~~~~~~~~~~~~~~~~~~

- Added auto-push support. Thanks `@WoLpH <https://github.com/WoLpH>`_
  for `Pull Request #74 <https://github.com/msiemens/PyGitUp/pull/74>`_.

v1.4.7 (*2018-04-07*)
~~~~~~~~~~~~~~~~~~~~~

- Added shorthand commandline arguments (``-V, -q, -h``, see `#73 <https://github.com/msiemens/PyGitUp/issues/73>`__).

v1.4.6 (*2017-12-19*)
~~~~~~~~~~~~~~~~~~~~~

- 3rd party dependencies have been updated (see `#65 <https://github.com/msiemens/PyGitUp/issues/65>`__).

v1.4.5 (*2017-01-02*)
~~~~~~~~~~~~~~~~~~~~~

- Fixed problems when working with branches containing hash signs in their name
  (`#55 <https://github.com/msiemens/PyGitUp/issues/55>`__).
- No longer installs a now unneeded script on ``pip install``. Thanks `@ekohl <https://github.com/ekohl>`_
  for `Pull Request #60 <https://github.com/msiemens/PyGitUp/pull/60>`_.

v1.4.4 (*2016-11-30*)
~~~~~~~~~~~~~~~~~~~~~

- Fixed a bug when working with ``git worktree`` (`#58 <https://github.com/msiemens/PyGitUp/issues/58>`__).

v1.4.3 (*2016-11-22*)
~~~~~~~~~~~~~~~~~~~~~

- Fixed a bug with GitPython <= 2.0.8 (`#56 <https://github.com/msiemens/PyGitUp/issues/56>`__, `#57 <https://github.com/msiemens/PyGitUp/issues/57>`__).

v1.4.2 (*2016-09-29*)
~~~~~~~~~~~~~~~~~~~~~

- Switched the command line argument parsing library (`#53 <https://github.com/msiemens/PyGitUp/issues/53>`__).

v1.4.1 (*2016-08-02*)
~~~~~~~~~~~~~~~~~~~~~

- Include tests in PyPI distribution (`#51 <https://github.com/msiemens/PyGitUp/issues/51>`__).

v1.4.0 (*2016-02-29*)
~~~~~~~~~~~~~~~~~~~~~

- 3rd party dependencies have been updated.
- Dependencies on 3rd party libraries have been loosened to better interact with other installed packages.
  Thanks `MaximilianR <https://github.com/MaximilianR>`_ for `Pull Request #45 <https://github.com/msiemens/PyGitUp/pull/45>`_.
- Added an command line argument to turn of fetching (``--no-fetch``). Thanks `@buoto <https://github.com/buoto>`_
  for `Pull Request #46 <https://github.com/msiemens/PyGitUp/pull/46>`_.
- Don't show a stacktrace anymore when stashing fails (`#35 <https://github.com/msiemens/PyGitUp/issues/35>`_).
- Fixed a bug that caused problems with submodules if the submodule had unstashed changes/ Thanks
  `@Javex <https://github.com/Javex>`_ for `Pull Request #27 <https://github.com/msiemens/PyGitUp/pull/27>`_.

v1.3.1 (*2015-08-31*)
~~~~~~~~~~~~~~~~~~~~~

- Fixed a bug when showing the version on Python 3 `#34 <https://github.com/msiemens/PyGitUp/issues/34>`__.

v1.3.0 (*2015-04-08*)
~~~~~~~~~~~~~~~~~~~~~

- Support for Python 3 has been added. Thanks `@r4ts0n <https://github.com/r4ts0n>`_
  for `Pull Request #23 <https://github.com/msiemens/PyGitUp/pull/23>`_
  and `@Byron <https://github.com/Byron>`_ for quickly merging a Pull Request
  in `GitPython <https://github.com/gitpython-developers/GitPython>`_
  and releasing a new version on which this release depends.

v1.2.2 (*2015-02-23*)
~~~~~~~~~~~~~~~~~~~~~

- Now updates submodules when called from ``git submodule foreach`` (`#8 <https://github.com/msiemens/PyGitUp/issues/8>`__).

v1.2.1 (*2014-12-16*)
~~~~~~~~~~~~~~~~~~~~~

- Fixed a problem with ``setuptools 8.x`` (`#19 <https://github.com/msiemens/PyGitUp/issues/19>`__).
- 3rd party dependencies have been updated

v1.2.0 (*2014-12-10*)
~~~~~~~~~~~~~~~~~~~~~

- Added an option to show hashes when fast-forwarding/rebasing like ``git pull``
  does (``git-up.rebase.show-hashes``).
- Fixed a bug when having branches with both local tracking branches and
  remote tracking branches (`#17 <https://github.com/msiemens/PyGitUp/issues/17>`__).

v1.1.5 (*2014-11-19*)
~~~~~~~~~~~~~~~~~~~~~

- 3rd party dependencies have been updated to fix a problem with a 3rd party
  library (`#18 <https://github.com/msiemens/PyGitUp/issues/18>`__).

v1.1.4 (*2014-04-18*)
~~~~~~~~~~~~~~~~~~~~~

- Fixed some typos in README and ``PyGitUp`` output.
- 3rd party dependencies have been updated.

v1.1.3 (*2014-03-23*)
~~~~~~~~~~~~~~~~~~~~~

- ``ahead of upstream`` messages are now cyan (see `aanand/git-up#60 <https://github.com/aanand/git-up/issues/60>`__).
- Fixed problem when using % in the log hook (`#11 <https://github.com/msiemens/PyGitUp/issues/11>`__).

v1.1.2 (*2013-10-08*)
~~~~~~~~~~~~~~~~~~~~~

- Fixed problems with the dependency declaration.

v1.1.1 (*2013-10-07*)
~~~~~~~~~~~~~~~~~~~~~

- Fix for `#7 <https://github.com/msiemens/PyGitUp/issues/7>`__
  (AttributeError: 'GitUp' object has no attribute 'git') introduced by
  v1.1.0.

v1.1.0 (*2013-10-07*)
~~~~~~~~~~~~~~~~~~~~~

- Prior to v1.1.0, ``PyGitUp`` tried to guess the upstream branch for a local
  branch by looking for a branch on any remote with the same name. With v1.1.0,
  ``PyGitUp`` stops guessing and uses the upstream branch config instead.

  This by the way fixes issue `#6 <https://github.com/msiemens/PyGitUp/issues/6>`__
  (``git up`` doesn't work with local only branches).

  **Note:**
  This change may break setups, where a local branch accidentally has
  the same name as a remote branch without any tracking information set. Prior
  to v1.1.0, ``git up`` would still fetch and rebase from the remote branch.
  If you run into troubles with such a setup, setting tracking information
  using ``git branch -u <remote>/<remote branch> <local branch>`` should help.

- 3rd party dependencies have been updated.

- Allows to run ``git up --version`` from non-git dirs, too.

v1.0.0 (*2013-09-05*)
~~~~~~~~~~~~~~~~~~~~~

Finally ``PyGitUp`` reaches 1.0.0. You can consider it stable now :)

- Added a comprehensive test suite, now with a coverage of about 90%.
- Lots of code cleanup.
- Added option ``-h`` to display a help screen (``--help`` **won't** work, because
  ``git`` catches this option and handles it before ``PyGitUp`` can do).
- Added option ``--version`` to show, what version of ``PyGitUp`` is running.
  Also checks for updates (can be disabled, see configuration).
- Added option ``--quiet`` to be quiet and only display error messages.

v0.2.3 (*2013-06-05*)
~~~~~~~~~~~~~~~~~~~~~

- Fixed issue `#4 <https://github.com/msiemens/PyGitUp/issues/4>`__ (ugly
  exception if remote branch has been deleted).

v0.2.2 (*2013-05-04*)
~~~~~~~~~~~~~~~~~~~~~

- Fixed issue `#3 <https://github.com/msiemens/PyGitUp/issues/3>`__ (didn't
  return to previous branch).


v0.2.1 (*2013-03-18*)
~~~~~~~~~~~~~~~~~~~~~

- Fixed problem: check-bundler.rb has not been installed when installing via
  PyPI (problems with setup.py).

v0.2 (*2013-03-18*)
~~~~~~~~~~~~~~~~~~~

- Incorporated `aanand/git-up#41 <https://github
  .com/aanand/git-up/pull/41>`__: Support for ``bundle install --local`` and
  ``rbenv rehash``.
- Fixed issue `#1 <https://github.com/msiemens/PyGitUp/issues/1>`__ (strange
  output buffering when having multiple remotes to fetch from).
- Some under-the-hood improvements.

v0.1 (*2013-03-14*)
~~~~~~~~~~~~~~~~~~~

- Initial Release

.. |Build Status| image:: https://img.shields.io/github/actions/workflow/status/msiemens/PyGitUp/ci-workflow.yml?style=flat-square
   :target: https://dev.azure.com/msiemens/github/_build?definitionId=1

.. |Coverage Status| image:: http://img.shields.io/coveralls/msiemens/PyGitUp/master.svg?style=flat-square
  :target: https://coveralls.io/r/msiemens/PyGitUp

.. |Version| image:: http://img.shields.io/pypi/v/git-up.svg?style=flat-square
  :target: https://pypi.python.org/pypi/git-up

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/msiemens/PyGitUp",
    "name": "git-up",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4.0,>=3.8",
    "maintainer_email": null,
    "keywords": "database, nosql",
    "author": "Markus Siemens",
    "author_email": "markus@m-siemens.de",
    "download_url": "https://files.pythonhosted.org/packages/43/d3/8fa476380d3b330a9284efd9b8f309cb239a90d7a86b0446f189d05692c0/git_up-2.3.0.tar.gz",
    "platform": null,
    "description": "PyGitUp |Version| |Build Status| |Coverage Status|\n==================================================\n\n|PyGitUp|_ is a Python port of\n`aanand/git-up <https://github.com/aanand/git-up/>`__. It not only\nfully covers the abilities of git-up and should be a drop-in replacement,\nbut also extends it slightly.\n\n.. |PyGitUp| replace:: ``PyGitUp``\n.. _PyGitUp: https://github.com/msiemens/PyGitUp\n\nWhy use ``git up``?\n-------------------\n\n    git pull has two problems:\n\n    * It merges upstream changes by default, when it's really more polite to `rebase\n      over them <http://gitready.com/advanced/2009/02/11/pull-with-rebase.html>`__,\n      unless your collaborators enjoy a commit graph that looks like bedhead.\n\n    * It only updates the branch you're currently on, which means git push will\n      shout at you for being behind on branches you don't particularly care about\n      right now.\n\n    (https://github.com/aanand/git-up/)\n\nDemonstration\n-------------\n\n.. image:: http://i.imgur.com/EC3pvYu.gif\n\nWhy use the Python port?\n------------------------\n\nI wasn't able to use the original ``git-up``, because I didn't want to install\na whole Ruby suite just for `git-up` and even with Ruby installed, there were\nsome problems running on my Windows machine. So, my reasons for writing\nand using this port are:\n\n1. Windows support.\n2. Written in Python ;)\n\nHow do I install it?\n--------------------\n\n1. Install ``git-up`` via `pip <https://pip.pypa.io/en/latest/installing.html>`__: ``$ pip install git-up``\n2. ``cd`` to your project's directory.\n3. Run ``git up`` and enjoy!\n\nHomebrew users can also use ``brew``: ``brew install pygitup``\n\nHow to run it locally?\n----------------------\n\nCould also checkout the **.github/workflows/ci-workflow.yml**\n\n1. clone repo and ``cd`` to repo directory.\n2. Install ``poetry`` as guided by `poetry installation doc <https://python-poetry.org/docs/#installation>`__\n3. Run ``poetry install``\n4. Run program with ``poetry run git-up``\n5. Run all tests with ``poetry run pytest -v --cov=PyGitUp`` or ``poetry run pytest -v --cov=PyGitUp --cov-report html``\n6. Run one test with ``poetry run pytest -q PyGitUp/tests/test_version.py -v --cov=PyGitUp``\n\nNote for Windows users:\n~~~~~~~~~~~~~~~~~~~~~~~\n\nSee `these instructions <http://stackoverflow.com/q/4750806/997063>`__\nfor installing pip, if you haven't already installed it. And don't forget\nto either:\n\n- make your ``Python/Scripts`` and ``Python/Lib/site-packages`` writable for\n  you,\n- run ``pip`` with admin privileges\n- or use ``pip install --user git-up`` and add ``%APPDATA%/Python/Scripts``\n  to ``%PATH%``.\n\nOtherwise pip will refuse to install ``git-up`` due to ``Access denied`` errors.\n\nPython version compatibility:\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nPython 3.7 and upwards are supported :)\n\nOptions and Configuration\n-------------------------\n\nCommand Line Arguments\n~~~~~~~~~~~~~~~~~~~~~~\n\n- ``git up -h`` shows a help message.\n\n- ``git up --quiet`` suppresses all output except for error messages.\n\n- ``git up --no-fetch`` skips fetching the remote and rebases all local branches.\n\n- ``git up --version`` shows the current version and optionally checks for\n  updates (see below).\n\nConfiguration\n~~~~~~~~~~~~~\n\nTo configure ``PyGitUp``, you can set options in your git config. Run\n``git config [--global] git-up.[name] [value]`` to set one of these\noptions:\n\n-  ``git-up.fetch.prune [*true*|false]``: If set to ``true``,\n   ``PyGitUp`` will append the ``--prune``\\ option to ``git fetch`` and\n   thus remove any remote tracking branches which no longer exist on\n   the remote (see `git fetch\n   --help <http://linux.die.net/man/1/git-fetch>`__).\n\n-  ``git-up.fetch.all [true|*false*]``: If set to ``false``, ``PyGitUp``\n   will only fetch remotes for which there is at least one local\n   tracking branch. Setting this option will make ``git up`` always fetch\n   from all remotes, which is useful if e.g. you use a remote to push to\n   your CI system but never check those branches out.\n\n- ``git-up.push.auto [true|*false*]``: Push the current branch after\n  rebasing and fast-forwarding.\n\n- ``git-up.push.all [true|*false*]``: Push all branches when auto-pushing.\n\n- ``git-up.push.tags [true|*false*]``: Push tags when auto-pushing.\n\n-  ``git-up.rebase.arguments [string]``: If set, ``PyGitUp`` will use\n   this string as additional arguments when calling ``git rebase``.\n   Example: ``--preserve-merges`` to recreate merge commits in the\n   rebased branch.\n\n-  ``git-up.rebase.auto [*true*|false]``: If set to ``false``,\n   ``PyGitUp`` won't rebase your branches for you but notify you that\n   they diverged. This can be useful if you have a lot of in-progress\n   work that you don't want to deal with at once, but still want to\n   update other branches.\n\n-  ``git-up.rebase.log-hook [cmd]``: Runs ``cmd`` every time a branch\n   is rebased or fast-forwarded, with the old head as ``$1`` and the new\n   head as ``$2``. This can be used to view logs or diffs of incoming\n   changes. Example:\n   ``echo \"changes on $1:\"; git log --oneline --decorate $1..$2``.\n\n- ``git-up.rebase.show-hashes [true|*false*]``: If set to ``true``,\n  ``PyGitUp`` will show the hashes of the current commit (or the point\n  where the rebase starts) and the target commit like ``git pull`` does.\n\nNew in v1.0.0:\n~~~~~~~~~~~~~~\n\n- ``git-up.updates.check [*true*|false]``: When running ``git up --version``,\n  it shows the version number and checks for updates. If you feel\n  uncomfortable with it, just set it to ``false`` to turn off the checks.\n\nCredits\n-------\n\nThe original ``git-up`` has been written by aanand:\n`aanand/git-up/ <https://github.com/aanand/git-up/>`__.\n\n\nChangelog\n---------\n\nv2.3.0 (*2024-10-05*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Improve logging when updating large repositories. Thanks\n  `@bdmartin <https://github.com/bdmartin>`_ for `Pull Request #132\n  <https://github.com/msiemens/PyGitUp/pull/132>`_.\n- Drop support for Python 3.7\n\nv2.2.0 (*2022-11-21*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Add support for Python 3.11. Thanks\n  `@hugovk <https://github.com/hugovk>`_ for `Pull Request #118\n  <https://github.com/msiemens/PyGitUp/pull/118>`_.\n\nv2.1.0 (*2021-10-02*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Switch to Python's ``argparse`` for CLI argument parsing. Thanks\n  `@ekohl <https://github.com/ekohl>`_ for `Pull Request #96\n  <https://github.com/msiemens/PyGitUp/pull/96>`_.\n\nv2.0.3 (*2021-09-23*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Drop support for Python 3.6 (following GitPython)\n- Update PyGitUp's CLI argument parser `Click <https://click.palletsprojects.com/en/8.0.x/>`_\n  to version 8.0. Thanks `@hugovk <https://github.com/hugovk>`_\n  for `Pull Request #109 <https://github.com/msiemens/PyGitUp/pull/109>`_.\n- Update other dependencies\n\nv2.0.2 (*2020-12-30*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Remove old Python 2 code. Thanks `@hugovk <https://github.com/hugovk>`_\n  for `Pull Request #104 <https://github.com/msiemens/PyGitUp/pull/104>`_.\n\nv2.0.1 (*2020-08-26*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Update dependencies\n\nv2.0.0 (*2020-08-15*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Drop Python 2 support in order to fix `Issue 102 <https://github.com/msiemens/PyGitUp/issues/102>`_\n- Drop Ruby Bundler integration\n- Migrate tests to ``py.test``\n\nv1.6.1 (*2018-12-12*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Upgrade to click>=7.0.0. Thanks `@no-preserve-root <https://github.com/no-preserve-root>`_\n  for `Pull Request #87 <https://github.com/msiemens/PyGitUp/pull/87>`_.\n\nv1.6.0 (*2018-10-26*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Skip stashing changes when possible. Thanks `@Chronial <https://github.com/Chronial>`_\n  for `Pull Request #86 <https://github.com/msiemens/PyGitUp/pull/86>`_.\n- Added faster fast-forward on branches that are not checked out. Thanks `@Chronial <https://github.com/Chronial>`_\n  for `Pull Request #83 <https://github.com/msiemens/PyGitUp/pull/83>`_.\n\nv1.5.2 (*2018-09-28*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Fixed version requirement for Click dependency (`#82 <https://github.com/msiemens/PyGitUp/issues/82>`__).\n\nv1.5.1 (*2018-09-13*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Fixed crash on Cygwin with rebase log hook enabled (`#80 <https://github.com/msiemens/PyGitUp/issues/80>`__).\n\nv1.5.0 (*2018-04-26*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Added auto-push support. Thanks `@WoLpH <https://github.com/WoLpH>`_\n  for `Pull Request #74 <https://github.com/msiemens/PyGitUp/pull/74>`_.\n\nv1.4.7 (*2018-04-07*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Added shorthand commandline arguments (``-V, -q, -h``, see `#73 <https://github.com/msiemens/PyGitUp/issues/73>`__).\n\nv1.4.6 (*2017-12-19*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- 3rd party dependencies have been updated (see `#65 <https://github.com/msiemens/PyGitUp/issues/65>`__).\n\nv1.4.5 (*2017-01-02*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Fixed problems when working with branches containing hash signs in their name\n  (`#55 <https://github.com/msiemens/PyGitUp/issues/55>`__).\n- No longer installs a now unneeded script on ``pip install``. Thanks `@ekohl <https://github.com/ekohl>`_\n  for `Pull Request #60 <https://github.com/msiemens/PyGitUp/pull/60>`_.\n\nv1.4.4 (*2016-11-30*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Fixed a bug when working with ``git worktree`` (`#58 <https://github.com/msiemens/PyGitUp/issues/58>`__).\n\nv1.4.3 (*2016-11-22*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Fixed a bug with GitPython <= 2.0.8 (`#56 <https://github.com/msiemens/PyGitUp/issues/56>`__, `#57 <https://github.com/msiemens/PyGitUp/issues/57>`__).\n\nv1.4.2 (*2016-09-29*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Switched the command line argument parsing library (`#53 <https://github.com/msiemens/PyGitUp/issues/53>`__).\n\nv1.4.1 (*2016-08-02*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Include tests in PyPI distribution (`#51 <https://github.com/msiemens/PyGitUp/issues/51>`__).\n\nv1.4.0 (*2016-02-29*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- 3rd party dependencies have been updated.\n- Dependencies on 3rd party libraries have been loosened to better interact with other installed packages.\n  Thanks `MaximilianR <https://github.com/MaximilianR>`_ for `Pull Request #45 <https://github.com/msiemens/PyGitUp/pull/45>`_.\n- Added an command line argument to turn of fetching (``--no-fetch``). Thanks `@buoto <https://github.com/buoto>`_\n  for `Pull Request #46 <https://github.com/msiemens/PyGitUp/pull/46>`_.\n- Don't show a stacktrace anymore when stashing fails (`#35 <https://github.com/msiemens/PyGitUp/issues/35>`_).\n- Fixed a bug that caused problems with submodules if the submodule had unstashed changes/ Thanks\n  `@Javex <https://github.com/Javex>`_ for `Pull Request #27 <https://github.com/msiemens/PyGitUp/pull/27>`_.\n\nv1.3.1 (*2015-08-31*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Fixed a bug when showing the version on Python 3 `#34 <https://github.com/msiemens/PyGitUp/issues/34>`__.\n\nv1.3.0 (*2015-04-08*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Support for Python 3 has been added. Thanks `@r4ts0n <https://github.com/r4ts0n>`_\n  for `Pull Request #23 <https://github.com/msiemens/PyGitUp/pull/23>`_\n  and `@Byron <https://github.com/Byron>`_ for quickly merging a Pull Request\n  in `GitPython <https://github.com/gitpython-developers/GitPython>`_\n  and releasing a new version on which this release depends.\n\nv1.2.2 (*2015-02-23*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Now updates submodules when called from ``git submodule foreach`` (`#8 <https://github.com/msiemens/PyGitUp/issues/8>`__).\n\nv1.2.1 (*2014-12-16*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Fixed a problem with ``setuptools 8.x`` (`#19 <https://github.com/msiemens/PyGitUp/issues/19>`__).\n- 3rd party dependencies have been updated\n\nv1.2.0 (*2014-12-10*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Added an option to show hashes when fast-forwarding/rebasing like ``git pull``\n  does (``git-up.rebase.show-hashes``).\n- Fixed a bug when having branches with both local tracking branches and\n  remote tracking branches (`#17 <https://github.com/msiemens/PyGitUp/issues/17>`__).\n\nv1.1.5 (*2014-11-19*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- 3rd party dependencies have been updated to fix a problem with a 3rd party\n  library (`#18 <https://github.com/msiemens/PyGitUp/issues/18>`__).\n\nv1.1.4 (*2014-04-18*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Fixed some typos in README and ``PyGitUp`` output.\n- 3rd party dependencies have been updated.\n\nv1.1.3 (*2014-03-23*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- ``ahead of upstream`` messages are now cyan (see `aanand/git-up#60 <https://github.com/aanand/git-up/issues/60>`__).\n- Fixed problem when using % in the log hook (`#11 <https://github.com/msiemens/PyGitUp/issues/11>`__).\n\nv1.1.2 (*2013-10-08*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Fixed problems with the dependency declaration.\n\nv1.1.1 (*2013-10-07*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Fix for `#7 <https://github.com/msiemens/PyGitUp/issues/7>`__\n  (AttributeError: 'GitUp' object has no attribute 'git') introduced by\n  v1.1.0.\n\nv1.1.0 (*2013-10-07*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Prior to v1.1.0, ``PyGitUp`` tried to guess the upstream branch for a local\n  branch by looking for a branch on any remote with the same name. With v1.1.0,\n  ``PyGitUp`` stops guessing and uses the upstream branch config instead.\n\n  This by the way fixes issue `#6 <https://github.com/msiemens/PyGitUp/issues/6>`__\n  (``git up`` doesn't work with local only branches).\n\n  **Note:**\n  This change may break setups, where a local branch accidentally has\n  the same name as a remote branch without any tracking information set. Prior\n  to v1.1.0, ``git up`` would still fetch and rebase from the remote branch.\n  If you run into troubles with such a setup, setting tracking information\n  using ``git branch -u <remote>/<remote branch> <local branch>`` should help.\n\n- 3rd party dependencies have been updated.\n\n- Allows to run ``git up --version`` from non-git dirs, too.\n\nv1.0.0 (*2013-09-05*)\n~~~~~~~~~~~~~~~~~~~~~\n\nFinally ``PyGitUp`` reaches 1.0.0. You can consider it stable now :)\n\n- Added a comprehensive test suite, now with a coverage of about 90%.\n- Lots of code cleanup.\n- Added option ``-h`` to display a help screen (``--help`` **won't** work, because\n  ``git`` catches this option and handles it before ``PyGitUp`` can do).\n- Added option ``--version`` to show, what version of ``PyGitUp`` is running.\n  Also checks for updates (can be disabled, see configuration).\n- Added option ``--quiet`` to be quiet and only display error messages.\n\nv0.2.3 (*2013-06-05*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Fixed issue `#4 <https://github.com/msiemens/PyGitUp/issues/4>`__ (ugly\n  exception if remote branch has been deleted).\n\nv0.2.2 (*2013-05-04*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Fixed issue `#3 <https://github.com/msiemens/PyGitUp/issues/3>`__ (didn't\n  return to previous branch).\n\n\nv0.2.1 (*2013-03-18*)\n~~~~~~~~~~~~~~~~~~~~~\n\n- Fixed problem: check-bundler.rb has not been installed when installing via\n  PyPI (problems with setup.py).\n\nv0.2 (*2013-03-18*)\n~~~~~~~~~~~~~~~~~~~\n\n- Incorporated `aanand/git-up#41 <https://github\n  .com/aanand/git-up/pull/41>`__: Support for ``bundle install --local`` and\n  ``rbenv rehash``.\n- Fixed issue `#1 <https://github.com/msiemens/PyGitUp/issues/1>`__ (strange\n  output buffering when having multiple remotes to fetch from).\n- Some under-the-hood improvements.\n\nv0.1 (*2013-03-14*)\n~~~~~~~~~~~~~~~~~~~\n\n- Initial Release\n\n.. |Build Status| image:: https://img.shields.io/github/actions/workflow/status/msiemens/PyGitUp/ci-workflow.yml?style=flat-square\n   :target: https://dev.azure.com/msiemens/github/_build?definitionId=1\n\n.. |Coverage Status| image:: http://img.shields.io/coveralls/msiemens/PyGitUp/master.svg?style=flat-square\n  :target: https://coveralls.io/r/msiemens/PyGitUp\n\n.. |Version| image:: http://img.shields.io/pypi/v/git-up.svg?style=flat-square\n  :target: https://pypi.python.org/pypi/git-up\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A python implementation of 'git up'",
    "version": "2.3.0",
    "project_urls": {
        "Homepage": "https://github.com/msiemens/PyGitUp"
    },
    "split_keywords": [
        "database",
        " nosql"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "083cef44656feab91a762b06e3bc4ab9baadc36875d39e8b68f1b8589ba66d85",
                "md5": "1bc167ac8fca7c80c29fd01f25c9c14f",
                "sha256": "434d0d125c7dd62cf816c080bd1264b7c7e9f7554e532457b2180726ab665d39"
            },
            "downloads": -1,
            "filename": "git_up-2.3.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1bc167ac8fca7c80c29fd01f25c9c14f",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0,>=3.8",
            "size": 41218,
            "upload_time": "2024-10-05T20:00:28",
            "upload_time_iso_8601": "2024-10-05T20:00:28.369535Z",
            "url": "https://files.pythonhosted.org/packages/08/3c/ef44656feab91a762b06e3bc4ab9baadc36875d39e8b68f1b8589ba66d85/git_up-2.3.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "43d38fa476380d3b330a9284efd9b8f309cb239a90d7a86b0446f189d05692c0",
                "md5": "2b57440940a4a933d5629273d759b89f",
                "sha256": "4a771b9cae8bc6c95e2916bfb120a6ffc76c80fc3f5c91af61f91c21e5980f2e"
            },
            "downloads": -1,
            "filename": "git_up-2.3.0.tar.gz",
            "has_sig": false,
            "md5_digest": "2b57440940a4a933d5629273d759b89f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0,>=3.8",
            "size": 22414,
            "upload_time": "2024-10-05T20:00:30",
            "upload_time_iso_8601": "2024-10-05T20:00:30.096484Z",
            "url": "https://files.pythonhosted.org/packages/43/d3/8fa476380d3b330a9284efd9b8f309cb239a90d7a86b0446f189d05692c0/git_up-2.3.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-10-05 20:00:30",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "msiemens",
    "github_project": "PyGitUp",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "lcname": "git-up"
}
        
Elapsed time: 0.72024s