plain-cache changelog
0.27.2 (2026-04-05)
What's changed
- Removed OTel span instrumentation from cache operations. Cache operations (
get, set, delete, exists) no longer create their own OTel spans. The underlying postgres queries already produce db.* spans automatically, making the cache-level spans redundant noise. (b56a9edc9c7d)
Upgrade instructions
0.27.1 (2026-03-29)
What's changed
- Removed
AddIndex and RenameIndex operations from migrations — indexes are now managed by convergence. (c58b4ba1fec9)
- Updated docs to reference
plain postgres sync instead of plain migrate. (b026895edc4c)
Upgrade instructions
0.27.0 (2026-03-28)
What's changed
- Replaced
CharField with TextField in models and migration files to match plain-postgres 0.90.0 (5062ee4dd1fd)
Upgrade instructions
- Requires
plain-postgres>=0.90.0
- Replace
CharField with TextField in migration files that reference this package's models
0.26.3 (2026-03-27)
What's changed
- Changed
cache clear-all confirmation flag from --force to --yes/-y for consistency across all CLI commands (0af36e101f03)
Upgrade instructions
- If you use
plain cache clear-all --force in scripts, change it to plain cache clear-all --yes.
0.26.2 (2026-03-25)
What's changed
- Renamed indexes to use readable
{table}_{column}_idx naming convention, replacing the old truncated hash-based names. Includes a migration with RenameIndex operations (instant ALTER INDEX RENAME, no locks). (74aa8b76aa40)
Upgrade instructions
- Run
plain migrate to apply the index rename migration. This is an instant metadata-only operation with no performance impact.
0.26.1 (2026-03-22)
What's changed
- Switched from
plain.postgres.IntegrityError to psycopg.IntegrityError directly (d4b170e60a2c)
Upgrade instructions
0.26.0 (2026-03-12)
What's changed
- Updated all imports from
plain.models to plain.postgres in admin, core, models, and migrations.
Upgrade instructions
- Update imports:
from plain.models to from plain.postgres, from plain import models to from plain import postgres.
0.25.4 (2026-02-26)
What's changed
- Removed redundant
allow_global_search = False from cache admin views — this is now the default in plain-admin (05d6fa2764)
Upgrade instructions
0.25.3 (2026-02-26)
What's changed
- Auto-formatted config files with updated linter configuration (028bb95c3ae3)
Upgrade instructions
0.25.2 (2026-02-04)
What's changed
- Added
__all__ exports to models module for explicit public API boundaries (f26a63a5c941)
Upgrade instructions
0.25.1 (2026-01-28)
What's changed
- Updated admin views to use the new
get_initial_queryset hook instead of get_objects (99d6f042b8)
Upgrade instructions
- If you have customized the cache admin views, rename
get_objects() to get_initial_queryset().
0.25.0 (2026-01-15)
What's changed
- Admin interface updated with new "database" icon and added description for cached items list view (0fc4dd3)
Upgrade instructions
0.24.0 (2026-01-13)
What's changed
- Expanded README documentation with comprehensive usage examples, FAQs, and improved structure (da37a78)
Upgrade instructions
0.23.0 (2025-11-24)
What's changed
- Removed unused type ignore comment for improved code cleanliness (bfb851f)
Upgrade instructions
0.22.1 (2025-11-17)
What's changed
- QuerySet manager type annotation updated from
ClassVar to standard annotation for improved type checker compatibility (1c624ff)
Upgrade instructions
0.22.0 (2025-11-13)
What's changed
- QuerySet manager now uses
ClassVar type annotation for improved type checking (c3b00a6)
Upgrade instructions
0.21.0 (2025-11-13)
What's changed
- Model field definitions now use type stub syntax with
plain.models.types for improved type checking and IDE support (c8f40fc)
Upgrade instructions
0.20.2 (2025-11-03)
What's changed
- CLI commands now include descriptive docstrings for improved help text (fdb9e80)
Upgrade instructions
0.20.1 (2025-10-31)
What's changed
- Added BSD-3-Clause license metadata to package configuration (8477355)
Upgrade instructions
0.20.0 (2025-10-17)
What's changed
- Chores have been rewritten as abstract base classes instead of function-based decorators (c4466d3)
Upgrade instructions
- If you have custom chores defined, update them from function-based decorators to class-based chores that inherit from
Chore and implement a run() method (see plain.chores documentation)
0.19.0 (2025-10-07)
What's changed
- Model configuration updated from
class Meta to model_options descriptor for improved type safety (17a378d)
- QuerySet is now a proper descriptor with enhanced type annotations (2578301)
- Improved type safety by removing
type: ignore comments throughout the package (73ba469)
Upgrade instructions
0.18.1 (2025-10-06)
What's changed
- Added comprehensive type annotations throughout the package, achieving 100% type coverage (154d4c4)
Upgrade instructions
0.18.0 (2025-09-12)
What's changed
- Model manager API has been updated from
.objects to .query (037a239)
- Minimum Python version requirement raised to 3.13 (d86e307)
Upgrade instructions
- Update any custom code that references
CachedItem.objects to use CachedItem.query instead
0.17.2 (2025-08-22)
What's changed
- Updated README.md with improved documentation structure and formatting (4ebecd1)
- Admin interface icon positioning updated to be on nav sections (5a6479a)
Upgrade instructions
0.17.1 (2025-07-23)
What's changed
- Added archive icon to the cache admin interface navigation (9e9f8b0)
Upgrade instructions
0.17.0 (2025-07-22)
What's changed
- Database migrations updated to use new PrimaryKeyField instead of BigAutoField (4b8fa6a)
- Admin interface now uses
id instead of pk for queryset ordering
Upgrade instructions
0.16.0 (2025-07-18)
What's changed
- Added OpenTelemetry tracing support for all cache operations (get, set, delete, exists) (b0224d0)
Upgrade instructions
0.15.0 (2025-07-18)
What's changed
- Database migrations have been restarted and consolidated into a single initial migration (484f1b6)
- Admin interface query optimization restored using
.only() to fetch minimal fields for list views
Upgrade instructions
- Run
plain migrate --prune plaincache to handle the migration restart and remove old migration files
0.14.3 (2025-06-26)
What's changed
- No user-facing changes. This release only adds and formats the package CHANGELOG file (82710c3).
Upgrade instructions