{"categories":[{"label":"Software Development","url":"https://skillfed.io/packages/category/software-development/7"}],"enrichment":{"capability":"Acres provides a consistent, scoped interface for accessing package resources across different installation contexts (zipped or unpacked), with support for temporary, context-managed, and interpreter-lifetime resource access.","skillfed_tags":["package-resources","importlib-wrapper"],"use_cases":["Expose bundled configuration, template, or data files from a package submodule without exposing importlib complexity.","Access resources that must exist on the filesystem (e.g., for passing to external tools) with guaranteed lifetime.","Read small resource files (text or binary) from a package without managing temporary file cleanup.","Handle packages that may be installed as zipped archives without code changes or runtime bugs."],"what_it_does":"Acres wraps importlib.resources to provide a clearer, more predictable interface for accessing bundled package data. It solves the problem that importlib.resources returns Traversable objects that may or may not exist on the filesystem depending on whether the package is zipped, and that context managers like as_file() have inconvenient scoping when resource access is deferred. Acres offers three access patterns: cached() for interpreter-lifetime resources, as_path() for context-managed temporary access, and readable() for Path-like objects with read_text() and read_bytes() methods.\n\nThe package is designed to be used as a module-level loader in data packages, allowing submodules to expose a simple load_resource function that hides the complexity of resource access. It is fully type-annotated and tested against Python 3.9 through 3.13.","worth_installing":"Yes, if you have bundled package resources and want to avoid the complexity and scoping gotchas of importlib.resources directly. The low install friction, active maintenance, permissive license, and clear API make it a straightforward choice. Not necessary if you only occasionally access resources or are comfortable with importlib.resources's Traversable interface."},"id":"acres","links":{"html":"https://skillfed.io/packages/acres","md":"https://skillfed.io/packages/acres.md","pypi":"https://pypi.org/project/acres/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2025-06-04","license_spdx":null,"license_treatment":"permissive","name":"acres","python_support":"supports_current","summary":"Access resources on your terms"},"popularity":{"monthly_downloads":549731,"position":6054,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"0.5.0"}