Metadata-Version: 1.1
Name: diskcache
Version: 0.2.3
Summary: Disk and file-based cache
Home-page: http://www.grantjenks.com/docs/diskcache/
Author: Grant Jenks
Author-email: contact@grantjenks.com
License: Apache 2.0
Description: DiskCache: Disk and File-based Cache
        ====================================
        
        Rationale: file-based cache in Django is essentially broken. Culling files is
        too costly. Large caches are forced to scan lots of files and do lots of
        deletes on some operations. Takes too long in the request/response cycle.
        
        Solution: Each operation, "set" and "del" should delete at most two to ten
        expired keys.
        
        Each "get" needs only check expiry and delete if needed. Make it speedy.
        
        If only we had some kind of file-based database... we do! It's called
        SQLite. For metadata and small stuff, use SQLite and for bigger things use
        files.
        
        Features
        --------
        
        - Pure-Python
        - Developed on Python 2.7
        - Tested on CPython 2.6, 2.7, 3.3, 3.4, 3.5 and PyPy, PyPy3
        - Get full_path reference to value.
        - Allow storing raw data.
        - Small values stored in database.
        - Leverages SQLite native types: int, float, unicode, blob.
        - Thread-safe and process-safe.
        - Multiple eviction policies
          - Least-Recently-Stored
          - Least-Recently-Used
          - Least-Frequently-Used
        - Stampede barrier decorator.
        - Metadata support for "tag" to evict a group of keys at once.
        
        Quickstart
        ----------
        
        Installing DiskCache is simple with
        `pip <http://www.pip-installer.org/>`_::
        
          $ pip install diskcache
        
        You can access documentation in the interpreter with Python's built-in help
        function::
        
          >>> from diskcache import DjangoCache
          >>> help(DjangoCache)
        
        Caveats
        -------
        
        * Types matter in key equality comparisons. Comparisons like ``1 == 1.0`` and
          ``b'abc' == u'abc'`` return False.
        
        Tutorial
        --------
        
        TODO
        
        Reference and Indices
        ---------------------
        
        * `DiskCache Documentation`_
        * `DiskCache at PyPI`_
        * `DiskCache at GitHub`_
        * `DiskCache Issue Tracker`_
        
        .. _`DiskCache Documentation`: http://www.grantjenks.com/docs/diskcache/
        .. _`DiskCache at PyPI`: https://pypi.python.org/pypi/diskcache/
        .. _`DiskCache at GitHub`: https://github.com/grantjenks/python-diskcache/
        .. _`DiskCache Issue Tracker`: https://github.com/grantjenks/python-diskcache/issues/
        
        License
        -------
        
        Copyright 2016 Grant Jenks
        
        Licensed under the Apache License, Version 2.0 (the "License");
        you may not use this file except in compliance with the License.
        You may obtain a copy of the License at
        
            http://www.apache.org/licenses/LICENSE-2.0
        
        Unless required by applicable law or agreed to in writing, software
        distributed under the License is distributed on an "AS IS" BASIS,
        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        See the License for the specific language governing permissions and
        limitations under the License.
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
