Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(413)

Unified Diff: third_party/google-endpoints/cachetools-1.1.6.dist-info/DESCRIPTION.rst

Issue 2666783008: Add google-endpoints to third_party/. (Closed)
Patch Set: Created 3 years, 11 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: third_party/google-endpoints/cachetools-1.1.6.dist-info/DESCRIPTION.rst
diff --git a/third_party/google-endpoints/cachetools-1.1.6.dist-info/DESCRIPTION.rst b/third_party/google-endpoints/cachetools-1.1.6.dist-info/DESCRIPTION.rst
new file mode 100644
index 0000000000000000000000000000000000000000..73a6a509515055dabd7f82968faf957d5f73c550
--- /dev/null
+++ b/third_party/google-endpoints/cachetools-1.1.6.dist-info/DESCRIPTION.rst
@@ -0,0 +1,91 @@
+cachetools
+========================================================================
+
+This module provides various memoizing collections and decorators,
+including variants of the Python 3 Standard Library `@lru_cache`_
+function decorator.
+
+.. code-block:: pycon
+
+ >>> from cachetools import LRUCache
+ >>> cache = LRUCache(maxsize=2)
+ >>> cache.update([('first', 1), ('second', 2)])
+ >>> cache
+ LRUCache([('second', 2), ('first', 1)], maxsize=2, currsize=2)
+ >>> cache['third'] = 3
+ >>> cache
+ LRUCache([('second', 2), ('third', 3)], maxsize=2, currsize=2)
+ >>> cache['second']
+ 2
+ >>> cache['fourth'] = 4
+ >>> cache
+ LRUCache([('second', 2), ('fourth', 4)], maxsize=2, currsize=2)
+
+For the purpose of this module, a *cache* is a mutable_ mapping_ of a
+fixed maximum size. When the cache is full, i.e. by adding another
+item the cache would exceed its maximum size, the cache must choose
+which item(s) to discard based on a suitable `cache algorithm`_. In
+general, a cache's size is the total size of its items, and an item's
+size is a property or function of its value, e.g. the result of
+``sys.getsizeof(value)``. For the trivial but common case that each
+item counts as ``1``, a cache's size is equal to the number of its
+items, or ``len(cache)``.
+
+Multiple cache classes based on different caching algorithms are
+implemented, and decorators for easily memoizing function and method
+calls are provided, too.
+
+
+Installation
+------------------------------------------------------------------------
+
+Install cachetools using pip::
+
+ pip install cachetools
+
+
+Project Resources
+------------------------------------------------------------------------
+
+.. image:: http://img.shields.io/pypi/v/cachetools.svg?style=flat
+ :target: https://pypi.python.org/pypi/cachetools/
+ :alt: Latest PyPI version
+
+.. image:: http://img.shields.io/pypi/dm/cachetools.svg?style=flat
+ :target: https://pypi.python.org/pypi/cachetools/
+ :alt: Number of PyPI downloads
+
+.. image:: http://img.shields.io/travis/tkem/cachetools/master.svg?style=flat
+ :target: https://travis-ci.org/tkem/cachetools/
+ :alt: Travis CI build status
+
+.. image:: http://img.shields.io/coveralls/tkem/cachetools/master.svg?style=flat
+ :target: https://coveralls.io/r/tkem/cachetools
+ :alt: Test coverage
+
+- `Documentation`_
+- `Issue Tracker`_
+- `Source Code`_
+- `Change Log`_
+
+
+License
+------------------------------------------------------------------------
+
+Copyright (c) 2014-2016 Thomas Kemmer.
+
+Licensed under the `MIT License`_.
+
+
+.. _@lru_cache: http://docs.python.org/3/library/functools.html#functools.lru_cache
+.. _mutable: http://docs.python.org/dev/glossary.html#term-mutable
+.. _mapping: http://docs.python.org/dev/glossary.html#term-mapping
+.. _cache algorithm: http://en.wikipedia.org/wiki/Cache_algorithms
+
+.. _Documentation: http://pythonhosted.org/cachetools/
+.. _Issue Tracker: https://github.com/tkem/cachetools/issues/
+.. _Source Code: https://github.com/tkem/cachetools/
+.. _Change Log: https://github.com/tkem/cachetools/blob/master/CHANGES.rst
+.. _MIT License: http://raw.github.com/tkem/cachetools/master/LICENSE
+
+
« no previous file with comments | « third_party/google-endpoints/builtins/__init__.py ('k') | third_party/google-endpoints/cachetools-1.1.6.dist-info/INSTALLER » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698