isik
Everyday Python utilities, and a set of Django and Django REST Framework building blocks: base models with history tracking, per-host feedback and tag models attached without hand-written migrations, scoped permissions, serializer and viewset mixins, and HTTP exceptions you can raise from anywhere.
Install
pip install isik # isik.common only - no dependencies
pip install isik[django] # isik.django.apps, isik.django.http_exceptions
pip install isik[drf] # isik.django.drf - brings the django extra with it
pip install isik[celery] # isik.django.celery - brings the django extra with it
pip install isik[all] # everything, sentry/tiptap/templated_fields included
Requires Python 3.11+. The django and drf extras assume PostgreSQL: BaseModel's timestamps
and history tracking run on database triggers
(django-pgtrigger,
django-pghistory), so add pgtrigger and
pghistory to INSTALLED_APPS. Bring your own database driver (psycopg or psycopg2); isik doesn't
choose one for you.
Documentation
The full index is docs/INDEX.md.
- isik.common - caching, concurrency, error handling, functional helpers, typed settings from environment variables
- isik.django.apps -
BaseModel, history tracking, and thevotes()/comments()/notes()/bookmarks()/tags()makers - Idempotency keys -
Idempotency-Keyon DRF views: a retry replays the first response instead of doing the work twice - isik.django.drf - permissions
(
guarding,django_permission, ...), request policies on any view, serializer and viewset mixins, filters, pagination - isik.django.celery - a task base whose history rows name whoever caused the task, not nobody
- isik.django.http_exceptions - raise an HTTP status directly instead of threading responses back up the call stack
- isik.sentry - Sentry-reporting exception suppression
- Translations - every user-facing string is translatable, through Django's catalogs or stdlib gettext
Plain Python, and worth knowing about in a Django project
A Django project's imports all start with isik.django, so isik.common.utils is easy to never
see. It needs no Django and these come up in Django code constantly:
first_of(iterable, default=None, pred=None)/not_none- the first item, or the first one matching a predicate, without anext(...)and aStopIterationto handle.with_attrs(**attrs)- set attributes on a function as a decorator (short_description,booleanon an admin method).returns(value)/raises(exception)/noop/identity- small callables for defaults and hooks.DeclaredString- astrsentinel whose reason, validation and attributes are declared:Exemption("why"),NoComment("why").TransformExceptions/SuppressAndRun- turn one exception into another, or run something when one is swallowed.
See isik.common for all of it.
What changed in each release: CHANGELOG.md.
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for isik 0.14.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| isik-0.14.0.tar.gz | 443.4 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| isik-0.14.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 613.2 kB
Release files / isik-0.14.0.tar.gz
| Download URL | isik-0.14.0.tar.gz |
|---|---|
| Size | 443.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fd9abc72e84635f979bcb18177854fe36df6b329a9bfbeecaceb55f7715c4a3e
|
|
BLAKE2b-256 checksum How to use checksums |
65ef0de355dc5f32e71e3e212bfbbad5f3ca072ce1a32f220d452e8dd50ed1fd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 4, 2026.
Transparency logRelease files / isik-0.14.0-py3-none-any.whl
| Download URL | isik-0.14.0-py3-none-any.whl |
|---|---|
| Size | 169.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2479f964b61b664b939d25bd694dbb1de844063803731b2601e12b9ab74766a4
|
|
BLAKE2b-256 checksum How to use checksums |
2bf7d57e9c9cf2d5baad0a761241b2ae0fc5e62d3d2622e13e919379eb2e8efe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 4, 2026.
Transparency logSecurity for isik 0.14.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for isik-0.14.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 4, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
