---
# HoloOps
## Overview
**HoloOps** is a unified, production-ready system for advanced directory and file operations in Python applications.
It manages directory structures, file access, storage strategies, and project layout for modern, scalable software ecosystems.
**Highlights:**
* **Automatic project location detection:** Instantly detects where your project lives on the system—no manual path setup required.
* **Centralized directory and file management:** Organize, create, move, and remove directories and files with a consistent API.
* **Thread-safe singleton design:** Safe for use in multi-threaded and concurrent applications.
* **Cloud and local storage support:** Seamlessly migrate or sync directories between local and cloud environments.
* **Extensible mapping:** Map and resolve project assets, resources, or configuration layouts dynamically.
* **Clean project architecture:** Detects project root, enforces marker files, and keeps your structure organized.
---
## Why HoloOps?
Typical file/directory utilities are limited in scope:
* Manual, repetitive directory and file management code.
* No awareness of cloud storage, project roots, or naming conventions.
* Prone to errors in concurrent or large-scale environments.
**HoloOps** solves these challenges by:
* **Automatically detecting your project location** anywhere on the system, reducing configuration friction.
* Providing a **centralized system** to manage all directories and files according to project needs.
* Offering robust helpers for all major operations—creation, deletion, movement, permissions, and more.
* Supporting dynamic base directory mappings and configuration.
* Handling cloud and local storage strategies with automatic migration tools.
---
## Key Features
* **Automatic Project Root Detection:**
Instantly find your project’s root directory—no manual paths, no guessing.
* **Unified Directory Management:**
Define, create, move, or remove project directories with one API.
* **Comprehensive File Operations:**
Write, read, append, copy, move, remove, and list files with robust helpers.
* **Project-Aware:**
Auto-detect project root and enforce marker files for reliable setup.
* **Cloud and Local Flexibility:**
Seamless migration and support for leading cloud storage providers.
* **Thread-Safe Singleton:**
Safe, consistent instance across multi-threaded and parallel apps.
* **Customizable Mapping:**
Easily map logical names to directory or file paths for your ecosystem.
---
## How It Works
1. **Initialize the HoloOps manager** at application start—project location is auto-detected.
2. **Configure your directory and file mappings** according to project requirements.
3. **Use the unified API** for any file or directory operation—local or cloud, utility or class-based.
---
## FAQ
**Q: Do I need to specify my project’s location?**
A: No. HoloOps automatically detects your project root and sets up all necessary paths.
**Q: Can I use HoloOps for both cloud and local storage?**
A: Yes. HoloOps is designed for seamless switching or migration between storage strategies.
**Q: Is HoloOps suitable for concurrent or multi-threaded applications?**
A: Yes. The thread-safe singleton pattern ensures reliable usage in all environments.
---
## Code Examples
You can find code examples on my [GitHub repository](https://github.com/TristanMcBrideSr/TechBook).
---
## License
This project is licensed under the [Apache License, Version 2.0](LICENSE).
Copyright 2025 Tristan McBride Sr.
---
## Acknowledgements
Project by:
- Tristan McBride Sr.
- Sybil
Raw data
{
"_id": null,
"home_page": null,
"name": "HoloOps",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "\"Tristan McBride Sr.\" <142635792+TristanMcBrideSr@users.noreply.github.com>",
"keywords": "Python, File Management, Directory Management, Project Root Detection, Cloud Storage, Automation, AI Tools, Productivity",
"author": "Tristan McBride Sr.",
"author_email": "\"Tristan McBride Sr.\" <142635792+TristanMcBrideSr@users.noreply.github.com>",
"download_url": "https://files.pythonhosted.org/packages/0f/66/4a4dff5c1b6e57d81de17cb0801ec54c050a732f8ec86364d6273e101a71/holoops-0.1.1.tar.gz",
"platform": null,
"description": "\ufeff\r\n---\r\n\r\n# HoloOps\r\n\r\n## Overview\r\n\r\n**HoloOps** is a unified, production-ready system for advanced directory and file operations in Python applications.\r\nIt manages directory structures, file access, storage strategies, and project layout for modern, scalable software ecosystems.\r\n\r\n**Highlights:**\r\n\r\n* **Automatic project location detection:** Instantly detects where your project lives on the system\u2014no manual path setup required.\r\n* **Centralized directory and file management:** Organize, create, move, and remove directories and files with a consistent API.\r\n* **Thread-safe singleton design:** Safe for use in multi-threaded and concurrent applications.\r\n* **Cloud and local storage support:** Seamlessly migrate or sync directories between local and cloud environments.\r\n* **Extensible mapping:** Map and resolve project assets, resources, or configuration layouts dynamically.\r\n* **Clean project architecture:** Detects project root, enforces marker files, and keeps your structure organized.\r\n\r\n---\r\n\r\n## Why HoloOps?\r\n\r\nTypical file/directory utilities are limited in scope:\r\n\r\n* Manual, repetitive directory and file management code.\r\n* No awareness of cloud storage, project roots, or naming conventions.\r\n* Prone to errors in concurrent or large-scale environments.\r\n\r\n**HoloOps** solves these challenges by:\r\n\r\n* **Automatically detecting your project location** anywhere on the system, reducing configuration friction.\r\n* Providing a **centralized system** to manage all directories and files according to project needs.\r\n* Offering robust helpers for all major operations\u2014creation, deletion, movement, permissions, and more.\r\n* Supporting dynamic base directory mappings and configuration.\r\n* Handling cloud and local storage strategies with automatic migration tools.\r\n\r\n---\r\n\r\n## Key Features\r\n\r\n* **Automatic Project Root Detection:**\r\n Instantly find your project\u2019s root directory\u2014no manual paths, no guessing.\r\n\r\n* **Unified Directory Management:**\r\n Define, create, move, or remove project directories with one API.\r\n\r\n* **Comprehensive File Operations:**\r\n Write, read, append, copy, move, remove, and list files with robust helpers.\r\n\r\n* **Project-Aware:**\r\n Auto-detect project root and enforce marker files for reliable setup.\r\n\r\n* **Cloud and Local Flexibility:**\r\n Seamless migration and support for leading cloud storage providers.\r\n\r\n* **Thread-Safe Singleton:**\r\n Safe, consistent instance across multi-threaded and parallel apps.\r\n\r\n* **Customizable Mapping:**\r\n Easily map logical names to directory or file paths for your ecosystem.\r\n\r\n---\r\n\r\n## How It Works\r\n\r\n1. **Initialize the HoloOps manager** at application start\u2014project location is auto-detected.\r\n2. **Configure your directory and file mappings** according to project requirements.\r\n3. **Use the unified API** for any file or directory operation\u2014local or cloud, utility or class-based.\r\n\r\n---\r\n\r\n## FAQ\r\n\r\n**Q: Do I need to specify my project\u2019s location?**\r\nA: No. HoloOps automatically detects your project root and sets up all necessary paths.\r\n\r\n**Q: Can I use HoloOps for both cloud and local storage?**\r\nA: Yes. HoloOps is designed for seamless switching or migration between storage strategies.\r\n\r\n**Q: Is HoloOps suitable for concurrent or multi-threaded applications?**\r\nA: Yes. The thread-safe singleton pattern ensures reliable usage in all environments.\r\n\r\n---\r\n\r\n## Code Examples\r\n\r\nYou can find code examples on my [GitHub repository](https://github.com/TristanMcBrideSr/TechBook).\r\n\r\n---\r\n\r\n## License\r\n\r\nThis project is licensed under the [Apache License, Version 2.0](LICENSE).\r\nCopyright 2025 Tristan McBride Sr.\r\n\r\n---\r\n\r\n## Acknowledgements\r\n\r\nProject by:\r\n- Tristan McBride Sr.\r\n- Sybil\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Unified, production-ready file and directory management for modern Python applications.",
"version": "0.1.1",
"project_urls": {
"Homepage": "https://github.com/TristanMcBrideSr"
},
"split_keywords": [
"python",
" file management",
" directory management",
" project root detection",
" cloud storage",
" automation",
" ai tools",
" productivity"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "723134b0e6f6a334536f50f6b6261efef878ecf288b724a89f7af0223867930e",
"md5": "a1da8e564fcc485c6b5785345e175d4d",
"sha256": "7dd7b7b0f6e1e22f96f057d9ec75342eea2bc36d3d9c7be6b32b40508d368b34"
},
"downloads": -1,
"filename": "holoops-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a1da8e564fcc485c6b5785345e175d4d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 7519,
"upload_time": "2025-08-05T22:39:22",
"upload_time_iso_8601": "2025-08-05T22:39:22.411890Z",
"url": "https://files.pythonhosted.org/packages/72/31/34b0e6f6a334536f50f6b6261efef878ecf288b724a89f7af0223867930e/holoops-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0f664a4dff5c1b6e57d81de17cb0801ec54c050a732f8ec86364d6273e101a71",
"md5": "d4b95cb177c404595a897b8f2a587297",
"sha256": "22abd5d7705853255723323ddc10b386d91018d01eddbd6ee8dd3694e62c5632"
},
"downloads": -1,
"filename": "holoops-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "d4b95cb177c404595a897b8f2a587297",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 6995,
"upload_time": "2025-08-05T22:39:24",
"upload_time_iso_8601": "2025-08-05T22:39:24.897519Z",
"url": "https://files.pythonhosted.org/packages/0f/66/4a4dff5c1b6e57d81de17cb0801ec54c050a732f8ec86364d6273e101a71/holoops-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-05 22:39:24",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "holoops"
}
JSON