{"categories":[{"label":"Software Development","url":"https://skillfed.io/packages/category/software-development/7"}],"enrichment":{"capability":"Provides File and Dir classes that wrap filesystem operations as ORM-like objects with properties and methods for reading, writing, traversing, and manipulating files and directories across multiple formats.","skillfed_tags":["abandoned-project","filesystem-abstraction","format-agnostic-io"],"use_cases":["Automate batch file operations (rename, move, delete) on mixed file types using property assignment instead of function calls.","Read and write multiple document formats (PDF, Word, Excel, JSON, images) with a single unified File.read()/File.write() interface.","Recursively search and filter directory trees by file extension, regex patterns, or content without manual os.walk() loops.","Traverse filesystem hierarchies using attribute access (e.g., my_dir.f.subfolder.file_name) instead of path string manipulation.","Compress directories into zip files or visualize directory trees as ASCII art for debugging or reporting."],"what_it_does":"Pathmagic wraps filesystem paths in ORM-like File and Dir classes that trigger I/O operations when their properties are modified\u2014similar to how database ORMs work. Instead of calling functions like os.rename() or os.remove(), you set properties like Dir.name or File.path, and the filesystem changes automatically. The File class adds a FormatHandler factory that detects file type by extension and reads or writes using the appropriate library: PDF via PyPDF2, images via Pillow, audio via pydub, video via moviepy, Word docs via python-docx, spreadsheets via pysubtypes, and JSON, pickle, HTML, and XML via standard or custom handlers.\n\nThe package is in alpha and explicitly under development, with the maintainer warning that the API will likely break and documentation will fall out of sync. The project has been abandoned since early 2022, with no releases or commits since then. It carries 13 runtime dependencies, several of which are heavy media libraries, making it a substantial addition to any environment. Use it only if you need its specific abstraction style and are prepared to maintain a fork if issues arise.","worth_installing":"No. The project is abandoned (last commit April 2022, last release February 2021) and explicitly in alpha with a warning that the API will break. The 13 runtime dependencies\u2014including unmaintained or slow-moving libraries like moviepy\u2014add significant install weight and potential security risk. Unless you need its specific ORM-style abstraction and are willing to fork and maintain it yourself, use pathlib (standard library) or a more actively maintained alternative."},"id":"pathmagic","links":{"html":"https://skillfed.io/packages/pathmagic","md":"https://skillfed.io/packages/pathmagic.md","pypi":"https://pypi.org/project/pathmagic/"},"maintenance":{"status":"abandoned"},"meta":{"latest_release":"2021-02-01","license_spdx":null,"license_treatment":"permissive","name":"pathmagic","python_support":"unspecified","summary":"Provides ORM path classes (File and Dir), which automatically emit file system IO operations upon having their attributes modified. File objects allow for easy content manipulation of many forms of files."},"popularity":{"monthly_downloads":608153,"position":5783,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"0.3.14"}