Metadata-Version: 2.1
Name: cmdline-provenance
Version: 1.0.0
Summary: A Python package for keeping track of your data processing steps
Home-page: https://github.com/DamienIrving/cmdline_provenance
Author: Damien Irving
Author-email: irving.damien@gmail.com
License: MIT License
Description: [![PyPI version](https://badge.fury.io/py/cmdline-provenance.svg)](https://badge.fury.io/py/cmdline-provenance)
        [![Documentation Status](https://readthedocs.org/projects/cmdline-provenance/badge/?version=latest)](https://cmdline-provenance.readthedocs.io/en/latest/?badge=latest)
        [![Downloads](https://pepy.tech/badge/cmdline-provenance/week)](https://pepy.tech/project/cmdline-provenance/week)
        [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
        
        # Command line provenance
        
        `cmdline_provenance` is a Python package for keeping track of your data processing steps.
        
        It was inspired by the popular [NCO](http://nco.sourceforge.net/)
        and [CDO](https://code.mpimet.mpg.de/projects/cdo) command line tools,
        which automatically generate a record of what was executed at the command line,
        append that record to the history attribute from the input (netCDF) data file,
        and then set the new extended record as the history attribute of the output (netCDF) data file.
        
        For example, after selecting the 2001-2005 time period from a rainfall data file
        and then deleting the `long_name` file attribute,
        the command log would look as follows:
        ```
        Fri Dec 08 10:05:47 2017: ncatted -O -a long_name,pr,d,, rainfall_data_2001-2005.nc
        Fri Dec 01 07:59:16 2017: cdo seldate,2001-01-01,2005-12-31 rainfall_data_1850-2005.nc rainfall_data_2001-2005.nc
        ```
        Following this simple approach to data provenance,
        it is possible maintain a record of all data processing steps
        from intial download/creation of your data files to the end result (e.g. a .png image).
        
        `cmdline_provenance` contains a series of functions for generating history records in the NCO/CDO format,
        and for combining the current record with previous records to maintain a complete command log.
        
        ## Documentation
        
        http://cmdline-provenance.readthedocs.io/en/latest/
        
        ## Installation
        
        ```
        pip install cmdline-provenance
        ```
        or
        ```
        conda install cmdline_provenance
        ```
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
