{"id":25543538,"url":"https://github.com/origin-ayoub/foldora","last_synced_at":"2026-04-20T18:42:44.651Z","repository":{"id":277406258,"uuid":"932327230","full_name":"origin-ayoub/foldora","owner":"origin-ayoub","description":"A CLI tool that manages files and directories.","archived":false,"fork":false,"pushed_at":"2025-12-05T00:58:15.000Z","size":49,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-03-05T04:06:09.566Z","etag":null,"topics":["click-python","pypi-package","python","python-cli","python-click"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/foldora","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/origin-ayoub.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-13T18:27:12.000Z","updated_at":"2025-12-05T02:03:01.000Z","dependencies_parsed_at":"2025-05-23T06:10:55.500Z","dependency_job_id":"77c9b631-b871-4397-baa7-4b29287e3f83","html_url":"https://github.com/origin-ayoub/foldora","commit_stats":null,"previous_names":["ayoub-aberbach/foldora","old-ghost/foldora"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/origin-ayoub/foldora","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/origin-ayoub%2Ffoldora","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/origin-ayoub%2Ffoldora/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/origin-ayoub%2Ffoldora/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/origin-ayoub%2Ffoldora/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/origin-ayoub","download_url":"https://codeload.github.com/origin-ayoub/foldora/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/origin-ayoub%2Ffoldora/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32060840,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T11:35:06.609Z","status":"ssl_error","status_checked_at":"2026-04-20T11:34:48.899Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["click-python","pypi-package","python","python-cli","python-click"],"created_at":"2025-02-20T07:20:01.278Z","updated_at":"2026-04-20T18:42:44.615Z","avatar_url":"https://github.com/origin-ayoub.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Foldora - File \u0026 Directory Manager CLI Tool\r\n\r\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\r\n[![Downloads](https://img.shields.io/pypi/dm/foldora)](https://pypi.org/project/foldora/)\r\n[![PyPI version](https://img.shields.io/pypi/v/foldora)](https://pypi.org/project/foldora/)\r\n[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](code_of_conduct.md)\r\n\r\n**Foldora** is a Python command-line interface (CLI) tool designed to help you efficiently manage files and directories.\r\n\r\n---\r\n\r\n## 🚀 Features\r\n\r\nFoldora provides essential file and directory management commands:\r\n\r\n- 📁 List files and directories  \r\n- 📂 Create directories and files  \r\n- 🧹 Delete (purge) files and directories  \r\n- 📝 Display file contents  \r\n- ✏️ Replace spaces in file and folder names with underscores  \r\n\r\n---\r\n\r\n## 🛠️ Installation\r\n\r\nInstall Foldora from PyPI:\r\n\r\n```bash\r\npip install foldora\r\n```\r\n\r\n\u003e **Note:** Ensure Python is installed and available in your system path.\r\n\r\n---\r\n\r\n## 📦 Usage\r\n\r\nRun Foldora using the `fd` command followed by the desired operation.\r\n\r\n---\r\n\r\n### 📁 List Files and Directories\r\n\r\nList the files and directories within one or more specified paths.  \r\nIf no paths are provided, the current working directory is used.\r\n\r\n**Command:**\r\n```bash\r\nfd la [paths] [--files] [--dirs]\r\n```\r\n\r\n**Notes:**\r\n- If a specified path is a file, only that file will be listed.  \r\n- Hidden files and directories may be included depending on your system settings.  \r\n- Multiple paths can be provided to list contents from different directories simultaneously.  \r\n\r\n**Examples:**\r\n```bash\r\nfd la\r\nfd la --files\r\nfd la --dirs\r\nfd la --files /path/to/dir\r\nfd la --dirs /path/to/dir\r\nfd la --files /path1 /path2\r\nfd la --dirs /path1 /path2\r\n```\r\n\r\n---\r\n\r\n### 📂 Create Directories\r\n\r\nCreate one or more directories.  \r\nAll necessary parent directories are created automatically if they do not exist.\r\n\r\n**Command:**\r\n```bash\r\nfd nd [paths]\r\n```\r\n\r\n**Notes:**\r\n- Does not modify existing directories.  \r\n- Supports creating multiple directories in a single command.  \r\n\r\n**Examples:**\r\n```bash\r\nfd nd directory1 directory2\r\nfd nd /path/to/parent/new_directory\r\n```\r\n\r\n---\r\n\r\n### 📄 Create Files\r\n\r\nCreate one or more empty files in the current directory or a specified path.\r\n\r\n**Command:**\r\n```bash\r\nfd nf '[-tp path_to_dir]' [filenames]\r\n```\r\n\r\n**Notes:**\r\n- Supports creating multiple files in one command.  \r\n- Existing files will not be overwritten.  \r\n- If the specified directory does not exist, an error will be raised.  \r\n\r\n**Examples:**\r\n```bash\r\nfd nf file1.txt file2.txt\r\nfd nf -tp /path/to/dir file1.txt file2.txt\r\n```\r\n\r\n---\r\n\r\n### 🧹 Delete Files and Directories\r\n\r\nPermanently delete specified files and directories, with user confirmation before proceeding.\r\n\r\n**Command:**\r\n```bash\r\nfd pg [paths]\r\n```\r\n\r\n**Notes:**\r\n- Use with caution — this action **cannot be undone**.  \r\n- Directories are deleted recursively, including all contents.  \r\n- Requires proper permissions to delete the specified paths.  \r\n\r\n**Examples:**\r\n```bash\r\nfd pg file1 directory1\r\n```\r\n\r\n---\r\n\r\n### 📝 Display File Contents\r\n\r\nDisplay the contents of one or more files in the console.\r\n\r\n**Command:**\r\n```bash\r\nfd vc [files]\r\n```\r\n\r\n**Notes:**\r\n- Files must be readable.  \r\n- Supports multiple files — each file’s content is displayed in sequence.  \r\n\r\n**Examples:**\r\n```bash\r\nfd vc file1.txt file2.txt\r\n```\r\n\r\n---\r\n\r\n### ✏️ Replace Spaces in File/Folder Names\r\n\r\nRename files and folders by replacing spaces in their names with underscores.\r\n\r\n**Command:**\r\n```bash\r\nfd fs [path]\r\n```\r\n\r\n**Notes:**\r\n- Defaults to the current directory if no path is specified.  \r\n- By default, only top-level files and folders are renamed.  \r\n\r\n**Examples:**\r\n```bash\r\nfd fs\r\nfd fs /path/to/dir\r\n```\r\n\r\n---\r\n\r\n## 🤝 Contributing\r\n\r\nContributions are welcome!  \r\nFeel free to open issues or submit pull requests to help improve Foldora.\r\n\r\n---\r\n\r\n## 📄 License\r\n\r\nThis project is licensed under the **MIT License**.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forigin-ayoub%2Ffoldora","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Forigin-ayoub%2Ffoldora","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forigin-ayoub%2Ffoldora/lists"}