Skip to main content

PyHistory maintains history entries for your project.

Project description

App to maintain history file for your project.


PyHistory maintains history entries in distributed work environment, which allows many developers to add/remove history entries between releases without conflicts.


pip install pyhistory


(All commands can start either with pyhistory or shortcut - pyhi.)

  • Add history entry:

    $ pyhi add 'New feature'
    $ pyhi add Something
  • List history entries:

    $ pyhi list
    * New feature
    * Something
  • Update your history file with entries for given release:

    $ cat HISTORY.rst
    my project
    0.4.1 (2015-08-04)
    * Added PyHistory to project.
    * Improved codebase.
    * Other features.
    $ pyhi update 0.4.2
    $ cat HISTORY.rst
    my project
    0.4.2 (2015-08-05)
    * Bug fixes
    * Change in API
    * Removed old features
    0.4.1 (2015-08-04)
    * Added PyHistory to project
    * Improved codebase
    * Other features
  • Delete selected entries:

    $ pyhi delete
    1. New feature
    2. Something
    3. Another one
    4. Wrong one
    (Delete by choosing entries numbers.)
    $ pyhi delete 2 4
    $ pyhi list
    * New feature
    * Another one
  • Clear all history:

    $ pyhi clear
    Do you really want to remove all entries? [y/N]: y

    Or without prompt:

    $ pyhi clear --yes

Config file

You can adjust Pyhistory behaviour to your needs by setup.cfg file. Just put pyhistory section in there:

history_dir = some_dir  # 'history' by default
history_file = myhistory.rst  # 'HISTORY.rst' by default
at_line = 42  # by default history will be injected after first headline


2.1 (2017-09-29)

  • Fixed error for empty file.
  • Unpinned hard requirements for package.
  • Added support for py35 and py36.

2.0 (2015-08-07)

  • Added line splitting.
  • Moved CLI interface to Click library.
  • Added ‘–yes’ flag for clear command.
  • Removed ‘squash’ subcommand.
  • Added microseconds to generated files.
  • 0 as at-line option in no longer valid.

1.3 (2014-10-17)

  • Timestamps are now in miliseconds (again).
  • Added load config from file.

1.2.1 (2014-08-06)

  • Improved format of generated hash (no miliseconds now).

1.2 (2014-07-22)

  • Added delete command.

1.1 (2014-07-15)

  • Added timestamp to generated files, so now entries are properly ordered.
  • Pyhistory traverses directory tree to find proper place for history directory.

1.0.3 (2014-06-23)

  • Added squash command (alias to update).

1.0.2 (2014-06-22)

  • Further bug fixing of start detecting.

1.0.1 (2014-06-20)

  • Fixed error raised by clear when history dir is absent.
  • Fixed update - command will now try to find file start.

1.0 (2014-06-20)

  • First release on PyPI.

Project details

Download files

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

Files for pyhistory, version 2.1
Filename, size File type Python version Upload date Hashes
Filename, size pyhistory-2.1.linux-x86_64.tar.gz (10.9 kB) File type Source Python version None Upload date Hashes View
Filename, size pyhistory-2.1-py2.py3-none-any.whl (9.6 kB) File type Wheel Python version py2.py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page