pysubtypes

What it is and what it does

pysubtypes provides drop-in subclasses of Python's built-in types (str, list, dict) and popular library types (datetime, Enum, pandas DataFrame, BeautifulSoup) that add convenience methods and improved string representations. The Str class adds slicing, regex operations, fuzzy matching, and clipboard functionality; List and Dict add method chaining on mutations and filtering; DateTime adds timedelta operations via keyword arguments; Frame (DataFrame subclass) adds pivoting, casing changes, and improved Excel/SQL export; and several other utility classes wrap requests.Session, subprocess.Popen, and colour.Color with similar enhancements.

The package is designed for developers who want to work with these types using a richer API without replacing them entirely. However, it is in abandoned status—the last release was 2021-02-01 and the last commit 2022-04-16—meaning no active maintenance, bug fixes, or compatibility updates should be expected. The description explicitly warns that the API may undergo significant breaking changes and documentation may fall out of sync.

Use it for:

• Add method chaining and regex filtering to dict operations in data processing pipelines.
• Use enhanced Str class with fuzzy matching and clipboard integration for text manipulation tasks.
• Leverage Frame (DataFrame subclass) for cleaner Excel export with automatic table formatting and SQL type inference.
• Simplify datetime arithmetic with DateTime.delta() keyword-argument syntax instead of timedelta objects.
• Extend Enum functionality with automatic lowercased values via AutoEnum without manual value assignment.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides enhanced subclasses for Python builtins (str, list, dict) and common types (datetime, Enum, DataFrame, BeautifulSoup) with additional convenience methods and better string representations.

No. The package is abandoned (last release 2021-02-01, last commit 2022-04-16) with no active maintenance. The description warns of API instability and documentation drift. While install friction is low and the MIT license is permissive, the 20 runtime dependencies and lack of maintenance create risk for compatibility issues and unpatched bugs. Use only if you are maintaining a legacy codebase already depending on it.

Install

pysubtypes on PyPI

pip install pysubtypes

uv add pysubtypes

poetry add pysubtypes

Installing pysubtypes

Before you install

Low install friction, but the package is abandoned—last release was 2021-02-01 and last commit 2022-04-16. No active maintenance or bug fixes should be expected.

License in practice

MIT license permits commercial and private use with minimal restrictions, though the abandoned status means no ongoing legal or security updates.

Quickstart

pip install pysubtypes

from pysubtypes import Str, List, Dict, DateTime, Frame

s = Str("hello world")
print(s.upper())  # Enhanced str subclass

l = List([1, 2, 3])
l.append(4)  # Method chaining on in-place mutations

Verify before relying

• Whether the 20 runtime dependencies are all actively maintained and compatible with modern Python versions.
• Whether the API breakage warnings in the description remain relevant after 2021-02-01 or if the package reached stability.
• Compatibility with Python versions beyond 3.8 (officially supported version in classifiers).

Package facts

Evidence: pysubtypes-0.3.18-py3-none-any.whl

Tags

More Software Development packages