assetkit 0.1.2

A Python toolkit for managing runtime asset packages

AssetKit

A Python toolkit for packaging, discovering, and loading structured runtime assets.

---

🚀 Features

• Structured asset packaging with a clean resources/ convention
• Auto-discovery of asset packages via entry_points
• Pythonic runtime asset access with AssetManager
• CLI scaffolding to create new asset packages

---

📦 Installation

pip install assetkit

---

⚡ Quick Example

from assetkit.asset_manager import AssetManager

assets = AssetManager(package_root="your_package", resource_dir="resources")
print(assets.list())
print(assets["config/main.yaml"].text())

To discover multiple asset packages dynamically:

from assetkit.discovery import discover_asset_managers

packages = discover_asset_managers()
for name, assets in packages.items():
    print(name, assets.list())

---

🛠 Scaffolding a New Package

assetkit new myplugin

This creates a new Python package with an embedded resources/ directory and a sample main.py.

---

📂 Project Structure Example

myplugin/
├── pyproject.toml
├── main.py
└── myplugin/
    ├── __init__.py
    └── resources/
        ├── config/
        │   └── main.yaml
        └── images/
            └── test.jpg

---

🧪 Testing Asset Packages

After installing a package (pip install ./myplugin):

from assetkit.discovery import discover_asset_managers
assets = discover_asset_managers()["myplugin"]
print(assets.list())

---

📄 License

MIT — See LICENSE

---

📬 More Info

• GitHub Repository
• PyPI Project Page