-
- GitHub
- GitLab
- Bitbucket
-
By logging in you accept
our terms of service
and privacy policy
A 'dogpile' lock, typically used as a component of a larger caching solution
Homepage Repository PyPI Python
pip install dogpile.core==0.3.0dev
Note
The dogpile.core package has been rolled into dogpile.cache directly. dogpile.core as a separate package is effectively EOL.
A "dogpile" lock, one which allows a single thread to generate an expensive resource while other threads use the "old" value, until the "new" value is ready.
Dogpile is basically the locking code extracted from the Beaker package, for simple and generic usage.
A simple example:
from dogpile.core import Dogpile
# store a reference to a "resource", some
# object that is expensive to create.
the_resource = [None]
def some_creation_function():
# create the resource here
the_resource[0] = create_some_resource()
def use_the_resource():
# some function that uses
# the resource. Won't reach
# here until some_creation_function()
# has completed at least once.
the_resource[0].do_something()
# create Dogpile with 3600 second
# expiry time
dogpile = Dogpile(3600)
with dogpile.acquire(some_creation_function):
use_the_resource()
Above, some_creation_function() will be called
when Dogpile.acquire() is first called. The
remainder of the with block then proceeds. Concurrent threads which
call Dogpile.acquire() during this initial period
will be blocked until some_creation_function() completes.
Once the creation function has completed successfully the first time,
new calls to Dogpile.acquire() will call some_creation_function()
each time the "expiretime" has been reached, allowing only a single
thread to call the function. Concurrent threads
which call Dogpile.acquire() during this period will
fall through, and not be blocked. It is expected that
the "stale" version of the resource remain available at this
time while the new one is generated.
dogpile.core is at the core of the dogpile.cache package which provides for a basic cache API and sample backends based on the dogpile concept.
dogpile.core has been in use in a small number of production environments for a period of months, and as of 0.3.2 has entered beta status. No issues have been reported yet with its core synchronization model, and overall the project hasn't seen many changes. Most development continues within dogpile.cache.
The Tidelift Subscription provides access to a continuously curated stream of human-researched and maintainer-verified data on open source packages and their licenses, releases, vulnerabilities, and development practices.
Learn more →Something wrong with this page? Make a suggestion
Export .ABOUT file for this package
Last synced: 2023-12-02 01:10:09 UTC
Login to resync this project