Ravenports generated: 10 Feb 2024 22:55
[ravenports.git] / bucket_24 / python-pymemcache
1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
2
3 NAMEBASE=               python-pymemcache
4 VERSION=                4.0.0
5 KEYWORDS=               python
6 VARIANTS=               v11 v12
7 SDESC[v11]=             Pure Python memcached client (3.11)
8 SDESC[v12]=             Pure Python memcached client (3.12)
9 HOMEPAGE=               https://github.com/pinterest/pymemcache
10 CONTACT=                Python_Automaton[python@ironwolf.systems]
11
12 DOWNLOAD_GROUPS=        main
13 SITES[main]=            PYPIWHL/41/ba/2f7b22d8135b51c4fefb041461f8431e1908778e6539ff5af6eeaaee367a
14 DISTFILE[1]=            pymemcache-4.0.0-py2.py3-none-any.whl:main
15 DF_INDEX=               1
16 SPKGS[v11]=             single
17 SPKGS[v12]=             single
18
19 OPTIONS_AVAILABLE=      PY311 PY312
20 OPTIONS_STANDARD=       none
21 VOPTS[v11]=             PY311=ON PY312=OFF
22 VOPTS[v12]=             PY311=OFF PY312=ON
23
24 DISTNAME=               pymemcache-4.0.0.dist-info
25
26 GENERATED=              yes
27
28 [PY311].USES_ON=                        python:v11,wheel
29
30 [PY312].USES_ON=                        python:v12,wheel
31
32 [FILE:2746:descriptions/desc.single]
33 pymemcache
34 ==========
35
36         :alt: Master Documentation Status
37
38 A comprehensive, fast, pure-Python memcached client.
39
40 pymemcache supports the following features:
41
42 * Complete implementation of the memcached text protocol.
43 * Connections using UNIX sockets, or TCP over IPv4 or IPv6.
44 * Configurable timeouts for socket connect and send/recv calls.
45 * Access to the "noreply" flag, which can significantly increase the speed
46 of writes.
47 * Flexible, modular and simple approach to serialization and
48 deserialization.
49 * The (optional) ability to treat network and memcached errors as cache
50 misses.
51
52 Installing pymemcache
53 =====================
54
55 Install from pip:
56
57 .. code-block:: bash
58
59   pip install pymemcache
60
61 For development, clone from github and run the tests:
62
63 .. code-block:: bash
64
65     git clone https://github.com/pinterest/pymemcache.git
66     cd pymemcache
67
68 Run the tests (make sure you have a local memcached server running):
69
70 .. code-block:: bash
71
72     tox
73
74 Usage
75 =====
76
77 See the documentation here: https://pymemcache.readthedocs.io/en/latest/
78
79 Django
80 ------
81
82 Since version 3.2, Django has included a pymemcache-based cache backend.
83 See [its documentation 
84 ].
85
86 On older Django versions, you can use
87 `django-pymemcache
88 <https://github.com/django-pymemcache/django-pymemcache>`_.
89
90 Comparison with Other Libraries
91 ===============================
92
93 pylibmc
94 -------
95
96 The pylibmc library is a wrapper around libmemcached, implemented in C. It
97 is
98 fast, implements consistent hashing, the full memcached protocol and
99 timeouts.
100 It does not provide access to the "noreply" flag. It also isn't pure
101 Python,
102 so using it with libraries like gevent is out of the question, and its
103 dependency on libmemcached poses challenges (e.g., it must be built against
104 the same version of libmemcached that it will use at runtime).
105
106 python-memcached
107 ----------------
108
109 The python-memcached library implements the entire memcached text protocol,
110 has
111 a single timeout for all socket calls and has a flexible approach to
112 serialization and deserialization. It is also written entirely in Python,
113 so
114 it works well with libraries like gevent. However, it is tied to using
115 thread
116 locals, doesn't implement "noreply", can't treat errors as cache misses and
117 is
118 slower than both pylibmc and pymemcache. It is also tied to a specific
119 method
120 for handling clusters of memcached servers.
121
122 memcache_client
123 ---------------
124
125 The team at mixpanel put together a pure Python memcached client as well.
126 It
127 has more fine grained support for socket timeouts, only connects to a
128 single
129 host. However, it doesn't support most of the memcached API (just get, set,
130 delete and stats), doesn't support "noreply", has no serialization or
131 deserialization support and can't treat errors as cache misses.
132
133
134
135 [FILE:116:distinfo]
136 f507bc20e0dc8d562f8df9d872107a278df049fa496805c1431b926f3ddd0eab        60772 pymemcache-4.0.0-py2.py3-none-any.whl
137