Skip to main content

A library for buffering function calls

Project description


Build status pypi pypi license

A simple to use decorator to buffer function calls. Supports python versions 3.7 and up. Works for both regular and async functions.


$ pip install pyfuncbuffer

Example usage

Let's say you have a scraper, and don't want sites to timeout you. You can use the @buffer() wrapper to make your function calls buffered!

from pyfuncbuffer import buffer

# We specify scrape_links to always buffer at least 0.5 seconds
# and by a random delay of 0 to 0.5
@buffer(seconds=0.5, random_delay=0.5)
def scrape_links(url) -> []: ...

links = scrape_links("")

while True:
    link = links.pop(0)

The @buffer() wrapper works both for regular functions, and instance methods!


  • seconds: Required

Seconds to buffer. Can be an int or a float.

  • random_delay: Optional

Seconds to define a random delay between 0 and random_delay. Can be an int or a float. Alternativelly if a tuple is passed, delay is chosen between random_delay[0] and random_delay[1].

  • always_buffer: Optional

Whether or not to always buffer. If specified, buffer_on_same_arguments is ignored.

  • buffer_on_same_arguments: Optional

Only buffer if the arguments on the buffered function are the same. False by default.

  • share_buffer: Optional

Share buffer between processes. This is only useful when using multiprocessing, and still wanting to have function calls buffered even if called in seperate processes.


Testing is done using pytest and pytest-asyncio.


$ python -m pytest tests/

in the project root to run all the tests.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyfuncbuffer-0.2.2.tar.gz (15.7 kB view hashes)

Uploaded Source

Built Distribution

pyfuncbuffer-0.2.2-py3-none-any.whl (16.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page