{
    "info": {
        "author": "Daniel Greenfeld",
        "author_email": "pydanny@gmail.com",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 5 - Production/Stable",
            "Intended Audience :: Developers",
            "License :: OSI Approved :: BSD License",
            "Natural Language :: English",
            "Operating System :: OS Independent",
            "Programming Language :: Python",
            "Programming Language :: Python :: 2",
            "Programming Language :: Python :: 2.7",
            "Programming Language :: Python :: 3",
            "Programming Language :: Python :: 3.4",
            "Programming Language :: Python :: 3.5",
            "Programming Language :: Python :: 3.6",
            "Programming Language :: Python :: 3.7"
        ],
        "description": "===============================\nproperty-cached\n===============================\n\n.. image:: https://img.shields.io/travis/althonos/property-cached/master.svg?style=flat-square\n   :target: https://travis-ci.org/althonos/property-cached\n\n.. image:: https://img.shields.io/codecov/c/gh/althonos/property-cached.svg?style=flat-square\n   :target: https://codecov.io/gh/althonos/property-cached\n\n.. image:: https://img.shields.io/pypi/v/property-cached.svg?style=flat-square\n   :target: https://pypi.python.org/pypi/property-cached\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square\n   :target: https://github.com/ambv/black\n\n\nA decorator for caching properties in classes (forked from ``cached-property``).\n\nThis library was forked from the upstream library ``cached-property`` since its\ndeveloper does not seem to be maintaining it anymore. It works as a drop-in\nreplacement with fully compatible API (import ``property_cached`` instead of\n``cached_property`` in your code and *voil\u00e0*). In case development resumes on\nthe original library, this one is likely to be deprecated.\n\n*Original readme included below:*\n\nWhy?\n-----\n\n* Makes caching of time or computational expensive properties quick and easy.\n* Because I got tired of copy/pasting this code from non-web project to non-web project.\n* I needed something really simple that worked in Python 2 and 3.\n\nHow to use it\n--------------\n\nLet's define a class with an expensive property. Every time you stay there the\nprice goes up by $50!\n\n.. code-block:: python\n\n    class Monopoly(object):\n\n        def __init__(self):\n            self.boardwalk_price = 500\n\n        @property\n        def boardwalk(self):\n            # In reality, this might represent a database call or time\n            # intensive task like calling a third-party API.\n            self.boardwalk_price += 50\n            return self.boardwalk_price\n\nNow run it:\n\n.. code-block:: python\n\n    >>> monopoly = Monopoly()\n    >>> monopoly.boardwalk\n    550\n    >>> monopoly.boardwalk\n    600\n\nLet's convert the boardwalk property into a ``cached_property``.\n\n.. code-block:: python\n\n    from cached_property import cached_property\n\n    class Monopoly(object):\n\n        def __init__(self):\n            self.boardwalk_price = 500\n\n        @cached_property\n        def boardwalk(self):\n            # Again, this is a silly example. Don't worry about it, this is\n            #   just an example for clarity.\n            self.boardwalk_price += 50\n            return self.boardwalk_price\n\nNow when we run it the price stays at $550.\n\n.. code-block:: python\n\n    >>> monopoly = Monopoly()\n    >>> monopoly.boardwalk\n    550\n    >>> monopoly.boardwalk\n    550\n    >>> monopoly.boardwalk\n    550\n\nWhy doesn't the value of ``monopoly.boardwalk`` change? Because it's a **cached property**!\n\nInvalidating the Cache\n----------------------\n\nResults of cached functions can be invalidated by outside forces. Let's demonstrate how to force the cache to invalidate:\n\n.. code-block:: python\n\n    >>> monopoly = Monopoly()\n    >>> monopoly.boardwalk\n    550\n    >>> monopoly.boardwalk\n    550\n    >>> # invalidate the cache\n    >>> del monopoly.__dict__['boardwalk']\n    >>> # request the boardwalk property again\n    >>> monopoly.boardwalk\n    600\n    >>> monopoly.boardwalk\n    600\n\nWorking with Threads\n---------------------\n\nWhat if a whole bunch of people want to stay at Boardwalk all at once? This means using threads, which\nunfortunately causes problems with the standard ``cached_property``. In this case, switch to using the\n``threaded_cached_property``:\n\n.. code-block:: python\n\n    from cached_property import threaded_cached_property\n\n    class Monopoly(object):\n\n        def __init__(self):\n            self.boardwalk_price = 500\n\n        @threaded_cached_property\n        def boardwalk(self):\n            \"\"\"threaded_cached_property is really nice for when no one waits\n                for other people to finish their turn and rudely start rolling\n                dice and moving their pieces.\"\"\"\n\n            sleep(1)\n            self.boardwalk_price += 50\n            return self.boardwalk_price\n\nNow use it:\n\n.. code-block:: python\n\n    >>> from threading import Thread\n    >>> from monopoly import Monopoly\n    >>> monopoly = Monopoly()\n    >>> threads = []\n    >>> for x in range(10):\n    >>>     thread = Thread(target=lambda: monopoly.boardwalk)\n    >>>     thread.start()\n    >>>     threads.append(thread)\n\n    >>> for thread in threads:\n    >>>     thread.join()\n\n    >>> self.assertEqual(m.boardwalk, 550)\n\n\nWorking with async/await (Python 3.5+)\n--------------------------------------\n\nThe cached property can be async, in which case you have to use await\nas usual to get the value. Because of the caching, the value is only\ncomputed once and then cached:\n\n.. code-block:: python\n\n    from cached_property import cached_property\n\n    class Monopoly(object):\n\n        def __init__(self):\n            self.boardwalk_price = 500\n\n        @cached_property\n        async def boardwalk(self):\n            self.boardwalk_price += 50\n            return self.boardwalk_price\n\nNow use it:\n\n.. code-block:: python\n\n    >>> async def print_boardwalk():\n    ...     monopoly = Monopoly()\n    ...     print(await monopoly.boardwalk)\n    ...     print(await monopoly.boardwalk)\n    ...     print(await monopoly.boardwalk)\n    >>> import asyncio\n    >>> asyncio.get_event_loop().run_until_complete(print_boardwalk())\n    550\n    550\n    550\n\nNote that this does not work with threading either, most asyncio\nobjects are not thread-safe. And if you run separate event loops in\neach thread, the cached version will most likely have the wrong event\nloop. To summarize, either use cooperative multitasking (event loop)\nor threading, but not both at the same time.\n\n\nTiming out the cache\n--------------------\n\nSometimes you want the price of things to reset after a time. Use the ``ttl``\nversions of ``cached_property`` and ``threaded_cached_property``.\n\n.. code-block:: python\n\n    import random\n    from cached_property import cached_property_with_ttl\n\n    class Monopoly(object):\n\n        @cached_property_with_ttl(ttl=5) # cache invalidates after 5 seconds\n        def dice(self):\n            # I dare the reader to implement a game using this method of 'rolling dice'.\n            return random.randint(2,12)\n\nNow use it:\n\n.. code-block:: python\n\n    >>> monopoly = Monopoly()\n    >>> monopoly.dice\n    10\n    >>> monopoly.dice\n    10\n    >>> from time import sleep\n    >>> sleep(6) # Sleeps long enough to expire the cache\n    >>> monopoly.dice\n    3\n    >>> monopoly.dice\n    3\n\n**Note:** The ``ttl`` tools do not reliably allow the clearing of the cache. This\nis why they are broken out into seperate tools. See https://github.com/pydanny/cached-property/issues/16.\n\nCredits\n--------\n\n* ``@pydanny`` for the original ``cached-property`` implementation.\n* Pip, Django, Werkzueg, Bottle, Pyramid, and Zope for having their own implementations. This package originally used an implementation that matched the Bottle version.\n* Reinout Van Rees for pointing out the `cached_property` decorator to me.\n* ``@audreyr``_ who created ``cookiecutter``_, which meant rolling this out took ``@pydanny`` just 15 minutes.\n* ``@tinche`` for pointing out the threading issue and providing a solution.\n* ``@bcho`` for providing the time-to-expire feature\n\n.. _`@audreyr`: https://github.com/audreyr\n.. _`cookiecutter`: https://github.com/audreyr/cookiecutter\n\n.. :changelog:\n\nHistory\n-------\n\n1.6.3 (2019-09-07)\n++++++++++++++++++\n\n* Resolve `cached_property` docstring not showing (`#171 <https://github.com/pydanny/cached-property/pull/171>`_).\n\n1.6.2 (2019-07-22)\n++++++++++++++++++\n\n* Fix metadata to keep original author and add @althonos as maintainer\n\n1.6.1 (2019-07-22)\n++++++++++++++++++\n\n* Fix unneeded dependencies being present in ``setup.cfg``\n\n1.6.0 (2019-07-22)\n++++++++++++++++++\n\n* Fixed class hierarchy, ``cached_property`` now inherits from ``property``\n* Add support for slotted classes and stop using the object ``__dict__``\n* Improve function wrapping using ``functools.update_wrapper``\n* Implement the ``__set_name__`` magic method available since Python 3.6\n\n1.5.1 (2018-08-05)\n++++++++++++++++++\n\n* Added formal support for Python 3.7\n* Removed formal support for Python 3.3\n\n1.4.3  (2018-06-14)\n+++++++++++++++++++\n\n* Catch SyntaxError from asyncio import on older versions of Python, thanks to @asottile\n\n1.4.2 (2018-04-08)\n++++++++++++++++++\n\n* Really fixed tests, thanks to @pydanny\n\n1.4.1 (2018-04-08)\n++++++++++++++++++\n\n* Added conftest.py to manifest so tests work properly off the tarball, thanks to @dotlambda\n* Ensured new asyncio tests didn't break Python 2.7 builds on Debian, thanks to @pydanny\n* Code formatting via black, thanks to @pydanny and @ambv\n\n\n1.4.0 (2018-02-25)\n++++++++++++++++++\n\n* Added asyncio support, thanks to @vbraun\n* Remove Python 2.6 support, whose end of life was 5 years ago, thanks to @pydanny\n\n\n1.3.1 (2017-09-21)\n++++++++++++++++++\n\n* Validate for Python 3.6\n\n\n1.3.0 (2015-11-24)\n++++++++++++++++++\n\n* Drop some non-ASCII characters from HISTORY.rst, thanks to @AdamWill\n* Added official support for Python 3.5, thanks to @pydanny and @audreyr\n* Removed confusingly placed lock from example, thanks to @ionelmc\n* Corrected invalidation cache documentation, thanks to @proofit404\n* Updated to latest Travis-CI environment, thanks to @audreyr\n\n1.2.0 (2015-04-28)\n++++++++++++++++++\n\n* Overall code and test refactoring, thanks to @gsakkis\n* Allow the del statement for resetting cached properties with ttl instead of del obj._cache[attr], thanks to @gsakkis.\n* Uncovered a bug in PyPy, https://bitbucket.org/pypy/pypy/issue/2033/attributeerror-object-attribute-is-read, thanks to @gsakkis\n* Fixed threaded_cached_property_with_ttl to actually be thread-safe, thanks to @gsakkis\n\n1.1.0 (2015-04-04)\n++++++++++++++++++\n\n* Regression: As the cache was not always clearing, we've broken out the time to expire feature to its own set of specific tools, thanks to @pydanny\n* Fixed typo in README, thanks to @zoidbergwill\n\n1.0.0 (2015-02-13)\n++++++++++++++++++\n\n* Added timed to expire feature to ``cached_property`` decorator.\n* **Backwards incompatiblity**: Changed ``del monopoly.boardwalk`` to ``del monopoly['boardwalk']`` in order to support the new TTL feature.\n\n0.1.5 (2014-05-20)\n++++++++++++++++++\n\n* Added threading support with new ``threaded_cached_property`` decorator\n* Documented cache invalidation\n* Updated credits\n* Sourced the bottle implementation\n\n0.1.4 (2014-05-17)\n++++++++++++++++++\n\n* Fix the dang-blarged py_modules argument.\n\n0.1.3 (2014-05-17)\n++++++++++++++++++\n\n* Removed import of package into ``setup.py``\n\n0.1.2 (2014-05-17)\n++++++++++++++++++\n\n* Documentation fixes. Not opening up a RTFD instance for this because it's so simple to use.\n\n0.1.1 (2014-05-17)\n++++++++++++++++++\n\n* setup.py fix. Whoops!\n\n0.1.0 (2014-05-17)\n++++++++++++++++++\n\n* First release on PyPI.\n\n\n",
        "description_content_type": "",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/althonos/property-cached/",
        "keywords": "cached-property,cache,property",
        "license": "BSD",
        "maintainer": "Martin Larralde",
        "maintainer_email": "martin.larralde@ens-paris-saclay.fr",
        "name": "property-cached",
        "package_url": "https://pypi.org/project/property-cached/",
        "platform": "any",
        "project_url": "https://pypi.org/project/property-cached/",
        "project_urls": {
            "Homepage": "https://github.com/althonos/property-cached/"
        },
        "release_url": "https://pypi.org/project/property-cached/1.6.3/",
        "requires_dist": null,
        "requires_python": ">= 2.7, != 3.0.*, != 3.1.*, != 3.2.*, != 3.3.*",
        "summary": "A decorator for caching properties in classes (forked from cached-property).",
        "version": "1.6.3"
    },
    "last_serial": 5796514,
    "releases": {
        "1.6.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "1912535319dac3c40278192f23384800",
                    "sha256": "f18a12ab56e378f93c0dadb1afd0f1d74054e0859939b30909868394ed78e34d"
                },
                "downloads": -1,
                "filename": "property_cached-1.6.0-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "1912535319dac3c40278192f23384800",
                "packagetype": "bdist_wheel",
                "python_version": "py2.py3",
                "requires_python": ">= 2.7, != 3.0.*, != 3.1.*, != 3.2.*, != 3.3.*",
                "size": 7880,
                "upload_time": "2019-07-22T09:25:17",
                "url": "https://files.pythonhosted.org/packages/ae/83/c8ef474f88b5b66653753e798d30fa52d4f6335ddc7b1ad23aff6a46298a/property_cached-1.6.0-py2.py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "7f4e0badffc28ca057ad79821c735a44",
                    "sha256": "ae2412a51ad57e712004d69ae0323d72058dba46686269281e0a539910e456c8"
                },
                "downloads": -1,
                "filename": "property-cached-1.6.0.zip",
                "has_sig": false,
                "md5_digest": "7f4e0badffc28ca057ad79821c735a44",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">= 2.7, != 3.0.*, != 3.1.*, != 3.2.*, != 3.3.*",
                "size": 23878,
                "upload_time": "2019-07-22T09:25:19",
                "url": "https://files.pythonhosted.org/packages/64/8c/ca8bef09cae0d6dfa7271dd104d8cdeb1d9fa30514c3bd1347a4a0d608df/property-cached-1.6.0.zip"
            }
        ],
        "1.6.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "db2e29e98e0a7cca4ea99ad82a4114d2",
                    "sha256": "3e3b1a1fd3239dab9dd8eb8d51be51c4fd67bfe957482478a22afe228d977a6a"
                },
                "downloads": -1,
                "filename": "property_cached-1.6.1-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "db2e29e98e0a7cca4ea99ad82a4114d2",
                "packagetype": "bdist_wheel",
                "python_version": "py2.py3",
                "requires_python": ">= 2.7, != 3.0.*, != 3.1.*, != 3.2.*, != 3.3.*",
                "size": 7761,
                "upload_time": "2019-07-22T09:34:01",
                "url": "https://files.pythonhosted.org/packages/3d/b6/4a25ea7d8303ec398b86c400a6ef034e2a1ebfa2444bbb964054086b8d5a/property_cached-1.6.1-py2.py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "f5a06a5c0db7a2cca2999fea123ce506",
                    "sha256": "bbe12fe9160509d054ea358b87c2c9aaa30d50ec9f09d0fe25801f597e8b488c"
                },
                "downloads": -1,
                "filename": "property-cached-1.6.1.zip",
                "has_sig": false,
                "md5_digest": "f5a06a5c0db7a2cca2999fea123ce506",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">= 2.7, != 3.0.*, != 3.1.*, != 3.2.*, != 3.3.*",
                "size": 23375,
                "upload_time": "2019-07-22T09:34:03",
                "url": "https://files.pythonhosted.org/packages/ca/1e/3caa4e146b63b1eec457e66f24f349aff618861715b4ba8aff29af787fb1/property-cached-1.6.1.zip"
            }
        ],
        "1.6.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "71f556a29c2ee091fae00587697bf748",
                    "sha256": "dda945000d0305b16d8df0e0771e77e7469d0f26618588580964203ca4310a9f"
                },
                "downloads": -1,
                "filename": "property_cached-1.6.2-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "71f556a29c2ee091fae00587697bf748",
                "packagetype": "bdist_wheel",
                "python_version": "py2.py3",
                "requires_python": ">= 2.7, != 3.0.*, != 3.1.*, != 3.2.*, != 3.3.*",
                "size": 7829,
                "upload_time": "2019-07-22T12:30:15",
                "url": "https://files.pythonhosted.org/packages/6e/22/243c685330c29ccb92acbfe5f25a5bd7e4f6b0de0a9adc6c17f5604b87b7/property_cached-1.6.2-py2.py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "dfb48e968bb8366a28fbb95760f33bfd",
                    "sha256": "a1ccbfa6e8235798119ee8881981e344c0754a409f96a9d423f9c6e3a168aefc"
                },
                "downloads": -1,
                "filename": "property-cached-1.6.2.zip",
                "has_sig": false,
                "md5_digest": "dfb48e968bb8366a28fbb95760f33bfd",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">= 2.7, != 3.0.*, != 3.1.*, != 3.2.*, != 3.3.*",
                "size": 23544,
                "upload_time": "2019-07-22T12:30:17",
                "url": "https://files.pythonhosted.org/packages/80/a0/43ed636b8c5d211bc12e220be5d4cf594163e92d751af70af92bb58a866e/property-cached-1.6.2.zip"
            }
        ],
        "1.6.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "6210a3104c1d164424bc681eb90a29b8",
                    "sha256": "92ff817530a115a307fc837fdb7ee7ee2f36250e222af19eed913d26d5ade5f2"
                },
                "downloads": -1,
                "filename": "property_cached-1.6.3-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "6210a3104c1d164424bc681eb90a29b8",
                "packagetype": "bdist_wheel",
                "python_version": "py2.py3",
                "requires_python": ">= 2.7, != 3.0.*, != 3.1.*, != 3.2.*, != 3.3.*",
                "size": 7885,
                "upload_time": "2019-09-07T15:41:55",
                "url": "https://files.pythonhosted.org/packages/c0/11/6e91ff5fe0476492f023cebad434a1a34fc513cfa98ddb1f3e5c856d2d99/property_cached-1.6.3-py2.py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "399075817345e4a1ff0b46e2f931e784",
                    "sha256": "614b6972e279d981b7bccabd0b1ce4601c1739a6eb9905fd79a9c485fb20a1e0"
                },
                "downloads": -1,
                "filename": "property-cached-1.6.3.zip",
                "has_sig": false,
                "md5_digest": "399075817345e4a1ff0b46e2f931e784",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">= 2.7, != 3.0.*, != 3.1.*, != 3.2.*, != 3.3.*",
                "size": 23672,
                "upload_time": "2019-09-07T15:41:57",
                "url": "https://files.pythonhosted.org/packages/13/54/7368cd41deae178826be943992868b26a520b6f5e8972ef9d54cb5d1198d/property-cached-1.6.3.zip"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "6210a3104c1d164424bc681eb90a29b8",
                "sha256": "92ff817530a115a307fc837fdb7ee7ee2f36250e222af19eed913d26d5ade5f2"
            },
            "downloads": -1,
            "filename": "property_cached-1.6.3-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "6210a3104c1d164424bc681eb90a29b8",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": ">= 2.7, != 3.0.*, != 3.1.*, != 3.2.*, != 3.3.*",
            "size": 7885,
            "upload_time": "2019-09-07T15:41:55",
            "url": "https://files.pythonhosted.org/packages/c0/11/6e91ff5fe0476492f023cebad434a1a34fc513cfa98ddb1f3e5c856d2d99/property_cached-1.6.3-py2.py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "399075817345e4a1ff0b46e2f931e784",
                "sha256": "614b6972e279d981b7bccabd0b1ce4601c1739a6eb9905fd79a9c485fb20a1e0"
            },
            "downloads": -1,
            "filename": "property-cached-1.6.3.zip",
            "has_sig": false,
            "md5_digest": "399075817345e4a1ff0b46e2f931e784",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">= 2.7, != 3.0.*, != 3.1.*, != 3.2.*, != 3.3.*",
            "size": 23672,
            "upload_time": "2019-09-07T15:41:57",
            "url": "https://files.pythonhosted.org/packages/13/54/7368cd41deae178826be943992868b26a520b6f5e8972ef9d54cb5d1198d/property-cached-1.6.3.zip"
        }
    ]
}