darca-space-manager 0.4.0

Storage abstraction layer for managing logical spaces.

A lightweight, fully-tested Python library to manage logical file-based spaces. Ideal for sandboxing, test environments, or dynamic storage orchestration.

🚀 Overview

darca-space-manager provides a simple abstraction over local file storage by organizing content in logical “spaces”. Each space has its own metadata and supports file-level operations such as reading, writing, deleting, and listing — including support for structured content like YAML and JSON.

✨ Features

• Space creation, deletion, existence checks, and metadata tracking

• File read/write/delete operations within a given space

• Automatic handling of .yaml, .yml, and .json for dictionaries

• Strict ASCII validation when reading text

• Custom exceptions for robust error tracing (SpaceFileManagerException, SpaceManagerException)

• Parallel-safe test fixtures (100% test coverage)

• CI/CD pipelines, auto-doc generation, and live documentation via GitHub Pages

📦 Installation

pip install darca-space-manager

Or using Poetry:

poetry add darca-space-manager

🔧 Usage

from darca_space_manager import SpaceManager, SpaceFileManager

sm = SpaceManager()
sfm = SpaceFileManager()

sm.create_space("demo")
sfm.set_file("demo", "example.yaml", {"foo": "bar"})
print(sfm.get_file("demo", "example.yaml"))  # raw text
sm.delete_space("demo")

📚 Documentation

Visit the full documentation:

👉 https://roelkist.github.io/darca-space-manager/

To build locally:

make docs

📂 Project Layout

darca_space_manager/
├── config.py
├── space_file_manager.py
├── space_manager.py
└── __version__.py

🧪 Testing

Run all tests using:

make test

Coverage and reports:

• Generates coverage.svg badge

• Stores HTML output in htmlcov/

• Fully parallel test support with xdist

🤝 Contributing

We welcome all contributions!

• Create a new branch from main

• Use PRs to submit changes

• You can also open feature requests or issues using our GitHub templates

See CONTRIBUTING.rst for detailed guidelines.

📄 License

This project is licensed under the MIT License. See LICENSE for details.