punkz 0.0.1

Python utilities developed by Devpunks.

PUNKZ

This is a package developed by Devpunks that contains some utilities for our projects. At the moment it includes:

• Cache System (local, AWS S3 bucket)
• Processor Framework (very experimental)

Table of Contents

• Installation
• Usage
• License

Installation

You can easily install this package using pip. At the moment the package is in test on the test.pypi repository.

In 'test.pypi' some of the dependencies needed to use this library are not present. Please, install these dependencies first:

pip install boto3 botocore

Then you can install the library.

pip install -i https://test.pypi.org/simple/ punkz

This will be automatically be solved once the library will be realeased on PyPI

Usage

There are many utilities contained in this package.

Cache System

Local Caching

Example Code for local caching.

from punkz.core import Cache, LocalCacheProvider
from punkz.packages import get_logger

logger = get_logger("cache_logger")
provider = LocalCacheProvider(".cache", logger=logger)
my_cache = Cache(
    provider=provider,
    cache_instance_id="test",
    expiration="1d",
    logger=logger
    )

@my_cache.cache
def my_func(x):
    return x + 1

print(my_func(99))

Note: not passing logger to the Cache or the Provider is possible and if done it will simply deactivate logging and printing.

Caching on AWS

Example Code for caching on an AWS S3 bucket.

from punkz.core import Cache, AWSS3CacheProvider
from punkz.packages import get_logger

logger = get_logger("cache_logger")
provider = AWSS3CacheProvider(
    bucket_name="your-bucket-name",
    access_key_id="your-access-key-id",
    secret_access_key="your-secret-access-key",
    logger=logger
    )
my_cache = Cache(
    provider=provider,
    cache_instance_id="test",
    expiration="1d",
    logger=logger
    )

@my_cache.cache
def my_func(x):
    return x + 1

print(my_func(99))

License

This package is released under MIT License as specified in the LICENSE file.

Disclaimer

This package is highly experimental and it will be further expanded and refactored in the future.