Metadata-Version: 2.1
Name: frequent
Version: 0.1.1
Summary: Frequently used components for Python projects.
Home-page: https://www.github.com/douglasdaly/frequent-py
Author: Douglas Daly
Author-email: contact@douglasdaly.com
License: MIT
Project-URL: Source Code, https://www.github.com/douglasdaly/frequent-py
Project-URL: Documentation, https://frequent-py.readthedocs.io/
Description: # Frequent
        
        *Frequently used components for Python projects.*
        
        
        [![PyPI Version](https://img.shields.io/pypi/v/frequent.svg)](https://pypi.org/project/frequent/ "PyPI Page")
        [![Build Status](https://travis-ci.org/douglasdaly/frequent-py.svg?branch=master)](https://travis-ci.org/douglasdaly/frequent-py "Travis CI")
        [![Coverage Status](https://coveralls.io/repos/github/douglasdaly/frequent-py/badge.svg)](https://coveralls.io/github/douglasdaly/frequent-py "Coveralls")
        [![Documentation Status](https://readthedocs.org/projects/frequent-py/badge/?version=latest)](https://frequent-py.readthedocs.io/en/latest/?badge=latest "Documentation")
        [![Python Versions](https://img.shields.io/pypi/pyversions/frequent.svg)](https://pypi.org/project/frequent "PyPI Page")
        
        - Free software: [MIT License](./LICENSE "License File")
        - Documentation: https://frequent-py.readthedocs.io/
        
        
        ## Features
        
        All of the components in ``frequent`` have extensive code documentation (as 
        well as extensive usage documentation and examples) and unit tests.  The 
        modules (and their associated unit tests) are entirely self-contained and 
        depend solely on the standard library.
        
        - [``config``](./src/frequent/config.py): components providing global 
          application configuration settings management and storage.
        
        - [``messaging``](./src/frequent/messaging.py): the foundations for building 
          custom messaging frameworks.
        
        - [``repository``](./src/frequent/repository.py): base class (and exception 
          classes) for implementing the repository pattern for back-end agnostic object 
          storage.
        
        - [``singleton``](./src/frequent/singleton.py): metaclass for creating 
          singleton classes.
        
        - [``unit_of_work``](./src/frequent/unit_of_work.py): base classes for 
          implementing the unit of work pattern for transactional blocks.
        
        
        ## Installation
        
        You have a few options for installing/using `frequent`.  The first is to
        install using your package manager of choice, `pipenv` for instance:
        
        ```bash
        $ pipenv install frequent
        ```
        
        However, taking a cue from the excellent 
        [boltons](https://github.com/mahmoud/boltons "boltons on Github") 
        package, each component is self-contained in its respective file/folder
        allowing for easy vendorization.  Components are not dependent on one
        another and rely solely on the standard library.  This makes
        vendorization of a component as simple as copying just the file/folder
        for the component(s) that you need (same goes for the unit tests).
        
        
        ## About
        
        I found myself copying/re-writing certain components for my projects over and
        over again.  This library is an attempt to take some of these components I find
        myself needing frequently (and re-writing *too frequently*) and package them up
        in a convenient and easy-to-use format.
        
        
        ## License
        
        Frequent &copy; Copyright 2019, Douglas Daly.  All rights reserved. This
        project is licensed under the MIT License, see the 
        [`LICENSE`](./LICENSE "License File") file for more details.
        
        
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3.5
Description-Content-Type: text/markdown
Provides-Extra: test
