Skip to main content

Package to help maintaining HISTORY file for Python project.

Project description

https://badge.fury.io/py/pyhistory.png https://travis-ci.org/beregond/pyhistory.png?branch=master https://pypip.in/d/pyhistory/badge.png

Package to help maintaining HISTORY file for Python project.

Note

This package is created to help maintaining history file in environment of high concurrency (literally: each pull request on GitHub had conflicts in HISTORY.rst file because it was updated before creating PR). Take into account it may NOT fit into your environment and/or workflow since it was cutted for specific case, but it’s good if so. :)

History directory

Pyhistory will traverse directory tree until it finds history file (by default HISTORY.rst, can be changed in setup.cfg, see section Config file) and this will be root, where history directory will be created, in which all entries will be stored. Thanks to that you can add, list or remove entries from any point in your project - all commands will be executed in context of root directory.

Features

(All commands can start either with pyhistory or 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:

    $ pyhi update 0.4.2
  • 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
  • Config file:

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

    [pyhistory]
    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 header

History

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.

Source Distribution

pyhistory-1.3.tar.gz (15.8 kB view hashes)

Uploaded Source

Built Distribution

pyhistory-1.3-py2.py3-none-any.whl (8.5 kB view hashes)

Uploaded Python 2 Python 3

Supported by

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