Metadata-Version: 2.1
Name: olutils
Version: 0.2.0
Summary: tools for common operations in a module
Home-page: https://github.com/OctaveLauby/olutils
Author: Octave Lauby
Author-email: 
License: Apache 2.0
Description: olutils
        ---
        
        
        # Introduction
        
        The module ***olutils*** provide common tools to simplify project creation. It includes:
        - class with logger
        - parameter management
        - object management (copy, saving, loading)
        
        
        ## Installation
        
        One can install olutils using pip install command:
        
        ```bash
        pip install olutils
        ```
        
        
        ## Usage
        
        
        Use of temporal converters and deep defaultdict:
        
        ```python
        import olutils
        
        
        # Building a deep default dict with datetimes as values
        flights = olutils.deepdefaultdict(lambda x: None, depth=2)
        
        # Filling it
        flights['Paris-NY']['departure'] = olutils.str2dt("2019-01-15 08:00+01:00")
        flights['Paris-NY']['arrival'] = olutils.str2dt("2019-01-15 10:30-05:00")
        flights['NY-Paris']['departure'] = olutils.str2dt("2019-01-17 23:00-05:00")
        flights['NY-Paris']['arrival'] = olutils.str2dt("2019-01-15 11:00+01:00")
        
        flights.pprint()
        ```
        
        
        File reading and object storing:
        
        ```python
        import olutils
        
        my_dict = {'key_1': "value_1", 'key_2': 2}
        my_rows = [{'col_1': 11, 'col_2': 21}, {'col_1': 21, 'col_2': 22}]
        olutils.save(my_dict, "output/my_dict.json")
        olutils.save(my_rows, "output/my_rows.csv")
        olutils.save(my_rows, "output/my_rows.unknown", mthd="json")
        
        my_loaded_dict = olutils.load("output/my_dict.json")
        my_loaded_rows = olutils.load("output/my_rows.csv")
        my_loaded_rows_ = olutils.load("output/my_rows.unknown", mthd="json")
        ```
        
        
        
        # For developers
        
        ## Download the project
        
        Clone it using code:
        
        ```bash
        git clone https://github.com/OctaveLauby/olutils.git
        cd olutils
        ```
        
        One can make an editable code installation:
        
        ```bash
        pip install -e .
        ```
        
        
        ## Virtual Environment
        
        Using new pipenv feature (`pip install pipenv`)
        
        ```bash
        pipenv install
        pipenv shell
        ...
        exit
        ```
        
        
        **Comments**:
        
        1. Matplotlib does not have to be imported: plotting submodule is not loaded in that case
        
        2. One can alternatively use classic virtual environment:
        
        ```bash
        python -m venv venv
        source venv/Scripts/activate
        python -m pip install -r requirements.txt
        ...
        deactivate
        ```
        
        
        ## Distribution
        
        
        1. Building manifest file:
        
        ```bash
        check-manifest --create
        ```
        
        2. Building the wheel:
        
        ```bash
        python setup.py bdist_wheel
        ```
        
        3. Building the source distribution:
        
        ```bash
        python setup.py sdist
        ```
        
        4. Publishing:
        
        ```bash
        python setup.py bdist_wheel sdist
        twine upload dist/*
        ```
        
        > For TestPyPi publication:  `twine upload --repository-url https://test.pypi.org/legacy/ dist/* `
        
        
        > [Not working on Git terminal](https://github.com/pypa/packaging-problems/issues/197) for some reason
        
        
        
        ## Testing
        
        ```bash
        python -m pytest olutils -vv
        python -m pylint olutils --ignore-patterns=test*
        ```
        
Keywords: utils tools
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
