---
id: py-key-value-shared
version: "0.3.0"
license: unclear
license_treatment: permissive
maintenance: aging
---

# py-key-value-shared — Shared Key-Value

License: permissive · Maintenance: aging · Downloads: 8.0M/mo

## What it is and what it does

py-key-value-shared is a utility library that extracts and centralizes shared code between two related key-value storage packages (key-value-aio and key-value-sync). It is not intended for direct end-user consumption but rather as an internal dependency to reduce code duplication across those sibling packages. The package depends on typing-extensions for enhanced type hints and beartype for runtime type checking, and it supports Python 3.10 through 3.13.

Because this is a shared library component, you would typically encounter it as a transitive dependency when installing key-value-aio or key-value-sync, rather than installing it directly. Its value lies in keeping the two related packages DRY and maintainable by centralizing common logic and type definitions.

Use it for:

- Installed automatically as a dependency when using key-value-aio or key-value-sync packages.
- Provides shared type definitions and utilities to both async and sync key-value storage implementations.
- Reduces code duplication and maintenance burden across related key-value storage libraries.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides shared utility code and type definitions for key-value storage libraries, designed to be used as a dependency by key-value-aio and key-value-sync packages.

No — this is a shared library component designed to be pulled in as a transitive dependency by key-value-aio or key-value-sync, not installed directly. Install it only if you are actively developing one of those downstream packages or have a specific reason to depend on its shared utilities. The alpha status and 270-day release gap suggest limited active development.

## Install

pip install py-key-value-shared
uv add py-key-value-shared
poetry add py-key-value-shared

## Installing py-key-value-shared

Before you install: Low install friction with only two runtime dependencies (typing-extensions and beartype). Package is in alpha status and has not received updates in 270 days, suggesting it may be stable but not actively maintained.

License in practice: Licensed under Apache Software License (permissive), meaning you can use, modify, and distribute this package freely with minimal restrictions.

Quickstart:

pip install py-key-value-shared

from py_key_value_shared import <shared_component>
# Use shared types or utilities in your key-value implementation

Requires Python 3.10 or later; designed primarily as a dependency for other packages rather than direct end-user use.

Verify before relying:

- What specific shared components, types, or utilities does this package export for downstream use?
- Is this package actively maintained or in maintenance mode given the 270-day gap since last release?
- What is the actual relationship and coupling between this package and key-value-aio/key-value-sync?

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 8.0M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

key-value shared utilities, shared code library, key-value storage base, type definitions for key-value, reusable key-value components, shared-library, key-value-storage

[View on SkillFed](https://skillfed.io/packages/py-key-value-shared) · [View on PyPI](https://pypi.org/project/py-key-value-shared/)