Metadata-Version: 2.1
Name: singletons
Version: 0.2.3
Summary: Singleton metaclasses and singleton factories
Home-page: https://github.com/jamesmallen/python-singletons
Author: James M Allen
Author-email: james.m.allen@gmail.com
License: MIT license
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Utilities
Provides-Extra: eventlet
Requires-Dist: eventlet; extra == 'eventlet'
Provides-Extra: gevent
Requires-Dist: gevent; extra == 'gevent'

========
Overview
========



Declaring singleton classes and singleton factories with different scopes of instantiation, striving for thread-safety and simplicity.

* Free software: MIT license

Installation
============

::

    pip install singletons

Quick Example
=============

::

	import singletons

    @singletons.GlobalFactory
    def my_uuid():
        return uuid.uuid4()

    # elsewhere...
    my_uuid()  # will return the global instance of a UUID object

Documentation
=============

https://python-singletons.readthedocs.io/

Development
===========

To run the all tests run::

    tox


Changelog
=========

master
------

0.2.2 (2018-02-01)
------------------

* Shows warning rather than giving exception when using greenthread singletons without a greenthread environment

0.2.1 (2018-01-29)
------------------

* CI changes

0.2.0 (2018-01-23)
------------------

* More tests
* Usage examples added to documentation
* Fixed issues revealed by tests

0.1.0 (2018-01-22)
------------------

* First release on PyPI.


