jsonalias
A microlibrary that defines a Json type alias for Python.
Decision gist · record as of 2026-08-14
Yes, if you use type hints and work with JSON data. The package is stable, has no dependencies, and solves a genuine typing problem. Dormant maintenance is not a concern for a minimal, self-contained type alias. Verify mypy version and configuration requirements before adopting in strict type-checking environments.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires mypy >= 0.981 with --enable-recursive-aliases flag for type checking to work correctly.
- Low friction: pure Python, no runtime dependencies, distributed as a wheel.
- Dormant maintenance (last release October 2022, last commit January 2025) but the package is minimal and stable—no active development needed.
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution in commercial and private projects with minimal attribution requirements.
last release 2022-10-30 (1384 days) · last repo commit 2025-01-14 · 20 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 1,380,947 downloads/mo, #3,981 on PyPI
Alternatives
Verify before relying
from jsonalias import Json
d: Json = {"foo": ["bar", {"x": "y"}]}- Whether mypy >= 0.981 with --enable-recursive-aliases is a hard requirement or merely recommended for full type-checking support
- Compatibility with type checkers other than mypy (e.g., pyright, pyre)
What it is and what it does
jsonalias exports a single recursive type alias, `Json`, that represents any valid JSON value: a dictionary with string keys and JSON values, a list of JSON values, or a primitive (string, integer, float, boolean, or None). The alias is defined using Python's `typing` module and supports recursive self-reference, allowing you to annotate variables and function parameters that hold JSON-compatible data.
The package exists because this type alias is useful across multiple projects but verbose enough to be tedious to redefine. It requires mypy >= 0.981 with the --enable-recursive-aliases flag to type-check correctly. The implementation is minimal—just a few lines of type definition—and carries no runtime dependencies, making it a zero-cost addition to your type-checking workflow.
Use it for
- Annotate function parameters that accept arbitrary JSON data from APIs or file parsing
- Type-hint configuration dictionaries or settings objects with mixed nested structures
- Define return types for JSON serialization or deserialization functions
- Validate type consistency in data transformation pipelines that work with JSON
- Document expected shapes for dynamically-structured data in codebases using strict typing
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use type hints and work with JSON data.
The package is stable, has no dependencies, and solves a genuine typing problem. Dormant maintenance is not a concern for a minimal, self-contained type alias. Verify mypy version and configuration requirements before adopting in strict type-checking environments.
Install
jsonalias on PyPI
Before you install
Low friction: pure Python, no runtime dependencies, distributed as a wheel. Dormant maintenance (last release October 2022, last commit January 2025) but the package is minimal and stable—no active development needed.
Requires mypy >= 0.981 with --enable-recursive-aliases flag for type checking to work correctly.
License in practice
MIT license permits unrestricted use, modification, and distribution in commercial and private projects with minimal attribution requirements.
Quickstart
from jsonalias import Json
d: Json = {"foo": ["bar", {"x": "y"}]}Verify before relying
- Whether mypy >= 0.981 with --enable-recursive-aliases is a hard requirement or merely recommended for full type-checking support
- Compatibility with type checkers other than mypy (e.g., pyright, pyre)
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.7,<4.0 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Dormant 1,384 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 1,380,947 / month, #3,981 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9 |
Evidence: jsonalias-0.1.2-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “json type alias python”
- jsonaliasProvides a recursive type alias for JSON-compatible data structures…
- typing-aliasesProvides a collection of type aliases for Python's typing system,…
- pyserdeSerialize and deserialize Python dataclasses to and from JSON, YAML,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also typing-json · json-strong-typing · flatdict · jsonschema-typed-v2 · jsoncompat · jsonlines · databind · condense-json · json-normalize · pampy