No project description provided
Project description
ckanext-toolbelt
Collection of different tools for daily use.
Requirements
| CKAN version | Compatible? |
|---|---|
| 2.8 and earlier | no |
| 2.9 | yes |
| master | yes |
Content
Decorators (ckanext.toolbelt.decorators)
Collector
Creates a decorator that can collect functions and return them in a dictionary. Originally designed for actions, auth functions, validators and helpers.
:information_source: CKAN v2.10 has tk.blanket module. It does the same
things in a bit different manner.
Can be used as decorator. Call Collector.get_collection when you need
dictionary with names of helpers mapped to helper functions
helper = Collector()
@helper
def func():
pass
###
# ITemplateHelpers
def get_helpers(self):
return helper.get_collection()
Collector.split allows you to visually separate decorator from the method,
that returns collection
action, get_actions = Collector().split()
@action
def func():
pass
###
# IActions
def get_actions(self):
return get_actions()
If you want your functions prefixed by the plugin name, provide this prefix as
a first argument to the Collector's constructor. If particular items must
remain unprefixed, you can specify what name to use, when decorating an item
validator, get_validators = Collector("toolbelt").split()
@validator
def func():
"""I am toolbelt_func
"""
pass
@validator("custom_func")
def func():
"""I am custom_func
"""
pass
###
# IValidators
def get_validators(self):
return get_validators()
Cache
Cache for functions.
Cache()
def func(v):
return v * v
By default, cache is based on:
- module, where function is defined
- name of the function
- positional arguments
- named arguments
That means that following two invocations cached separately:
func(10)
func(v=10)
Cached data stored in redis as a JSON serialized structure. In order to use
different serializers, you can specify dumper and loader parameters when
creating Cache instance. Any function that accepts single value and returns
str or bytes can be used as a dumper. Any function that accepts str or
bytes and returns unserialized value can be used as loader.
from pickle import dumps, loads
@Cache(dumper=dumps, loader=loads)
def func(v):
return v
As mentioned before, cache key computed using module, name of the function and
parameters. It can be changed by passing a function as key argument to the
Cache constructor. Expected signature is key_strategy(func, *args, **kwargs).
# this function will be called only once, because cache key is based on its name.
# And name will never change. Unless you change it
@Cache(key=lambda f, *a, **k: f.__name__)
def func(v):
return v
Cache duration(in seconds) can be configured via duration parameter of the
constructor(which can be a callable that returns comuted duration).
cache = Cache(duration=3600)
@cache
def func(v):
return v + v
Plugins
CLI
As soon as you've installed ckanext-toolbelt, it will register ckan toolbelt
route for CLI. You don't have to add toolbelt to the list of enabled
plugins. But depending on the list of enabled plugins, extra subroutes will be
added to the ckan toolbelt route.
In addition, there is global ctb command that allows to use this package
without CKAN installed or without CKAN config file. But in this way some of
commands (search-index for example) are not available, because they use CKAN
core.
Global commands, available via ctb and ckan toolbelt routes:
# Print basic Makefile for ckan-deps-installer
make deps-makefile
# Print pyproject example with black, isort, pytest and pyright configuration.
make pyproject -p <plugin_name>
# Parse config declarations of the given plugins and print them in the format,
# suitable for the README.md
make config-readme <plugin1> <plugin2> <plugin3>
# Start mail server that will catch outcomming mails.
dev mail-server
Commands that depends on CKAN core and available only via ckan toolbelt
route:
# Drop packages that are only in search index but not in DB.
search-index clear-missing
# Clean the DB, optionally keeping data in the given tables.
db clean --yes [-k user] [-k group] [-k ...]
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file ckanext-toolbelt-0.2.16.tar.gz.
File metadata
- Download URL: ckanext-toolbelt-0.2.16.tar.gz
- Upload date:
- Size: 37.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0535f3ae36f993f123e2be6508e015e0f672ea9e9231310c984eb9de10ccf232 |
|
| MD5 | 62543b90ba4831098801b3d8aaa551f8 |
|
| BLAKE2b-256 | 430b25ccaa7e48ef1673b939fd54820188a55cf6bdccccb6b4864e426c76adfd |
Provenance
File details
Details for the file ckanext_toolbelt-0.2.16-py3-none-any.whl.
File metadata
- Download URL: ckanext_toolbelt-0.2.16-py3-none-any.whl
- Upload date:
- Size: 44.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 58f8635dfcff54b26c35d08fce0d25f1b09bd4e5f0d4925223c7d93de4e17a9e |
|
| MD5 | 5d56d8c8230361ccb27a26c9feebcaa8 |
|
| BLAKE2b-256 | f1de0a79b42b557bf00a2e46943039b7cd9935d61bf95db1837338627bce6c34 |
