typemapping 0.1.3

Advanced type compatibility and checking system for Python

🧬 typemapping

Advanced Type Compatibility and Runtime Checking for Python 3.8+

typemapping is a powerful and extensible package for deep type introspection and runtime type validation. It goes far beyond Python's built-in isinstance and issubclass, supporting generic types, Annotated, Union, specialized collections, and more — with compatibility across Python 3.8+ including typing_extensions support.

---

🚀 Features

• ✅ Generic type compatibility (List[int] ~ Sequence[int])
• 🧠 Concrete-to-abstract compatibility (Counter, OrderedDict, ChainMap)
• 🔁 Full Union and Optional type support
• 🛠️ Python 3.8+ Annotated compatibility layer
• 🧪 Runtime type validation with container sampling
• 🔍 Field and function argument mapping with Annotated metadata extraction
• 📦 Framework-friendly: works with FastAPI, Pydantic, SQLAlchemy, etc.

---

📦 Installation

pip install typemapping

⚠️ typing_extensions is required for full support on Python 3.8.

---

🧑‍💻 Example

from typing import List, Annotated
from typemapping.type_check import extended_isinstance

# Check generic type compatibility
print(extended_isinstance([1, 2, 3], List[int]))  # True
print(extended_isinstance([1, 2, 3], List[str]))  # False

---

🧩 Key APIs

🔎 Type Checking & Compatibility

• extended_isinstance(obj, type_hint)
• generic_issubclass(subtype, supertype)
• is_equal_type(t1, t2)
• defensive_issubclass(cls, classinfo)

🧬 Annotated Type Handling

• is_annotated_type(type)
• strip_annotated(type)
• get_annotated_metadata(type)

🧠 Function and Class Introspection

• get_func_args(func)
• map_model_fields(cls)
• map_dataclass_fields(cls)
• get_field_type(cls, fieldname)

🔁 Origin Compatibility

• is_equivalent_origin(t1, t2)
• get_equivalent_origin(t)
• is_fully_compatible(t1, t2)
• get_compatibility_chain(t)

---

⚙️ Compatibility

• ✅ Python 3.8 and above
• 🔄 Backward-compatible via typing_extensions

---

🧪 Running Tests

pytest

---

📄 License

MIT License

---

🤝 Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.