{"id":31103609,"url":"https://github.com/kushagras22/chronofs","last_synced_at":"2025-09-17T02:10:18.846Z","repository":{"id":309979005,"uuid":"1037573254","full_name":"kushagras22/ChronoFS","owner":"kushagras22","description":"ChronoFS is a lightweight, C++17-based file management and version control system built from scratch, no external VCS like Git.","archived":false,"fork":false,"pushed_at":"2025-08-14T22:24:32.000Z","size":8101,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-15T00:16:13.853Z","etag":null,"topics":["abstraction-layer","cli-interface","cpp17","filemanagement","version-control"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kushagras22.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"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}},"created_at":"2025-08-13T19:29:05.000Z","updated_at":"2025-08-14T22:24:35.000Z","dependencies_parsed_at":"2025-08-15T00:26:22.334Z","dependency_job_id":null,"html_url":"https://github.com/kushagras22/ChronoFS","commit_stats":null,"previous_names":["kushagras22/chronofs"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/kushagras22/ChronoFS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kushagras22%2FChronoFS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kushagras22%2FChronoFS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kushagras22%2FChronoFS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kushagras22%2FChronoFS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kushagras22","download_url":"https://codeload.github.com/kushagras22/ChronoFS/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kushagras22%2FChronoFS/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275521497,"owners_count":25479612,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-17T02:00:09.119Z","response_time":84,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["abstraction-layer","cli-interface","cpp17","filemanagement","version-control"],"created_at":"2025-09-17T02:10:16.605Z","updated_at":"2025-09-17T02:10:18.837Z","avatar_url":"https://github.com/kushagras22.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ChronoFS\n\n## Overview\n**ChronoFS** is a lightweight, C++17-based file management and version control system **built from scratch**, no external VCS like Git.  \n\nIt allows you to:\n- Create, delete, rename, and move files or directories (folders/sub-folders)\n- Maintain **version history** for every file with the ability to rollback or restore\n- Perform **diff** operations between file versions\n- Log and track all file changes\n- Query **status** of the working directory\n- Use a **command-line interface** for all operations\n\nDesigned for scalability and modularity, **ChronoFS** uses an **object-oriented architecture** that makes it easy to extend with new commands and storage backends.\n\n---\n\n## Architecture\nChronoFS follows a **layered modular architecture**:\n\n### **Modules**\n- **CLI Module (`cli/`)** → Parses commands (`status`, `log`, `diff`, etc.) and executes corresponding service calls.\n- **File System Module (`fs/`)** → Abstracts file/directory manipulation, path handling, and file metadata.\n- **Version Control Module (`vcs/`)** → Manages snapshot creation, storage, and retrieval of file versions.\n- **Utilities Module (`util/`)** → Logging, color output, config parsing, error handling.\n\n---\n\n##  Features\n- Create, delete, move, and rename files/folders\n- Track file history with version timestamps\n- Restore any previous file version\n- Show file changes using a `diff` command\n- Query working directory status\n- Logging with detailed change history\n- Modular architecture for easy future expansion\n\n---\n\n## Folder Structure\n.\n├── cli/ # Command-line interface handlers\n├── fs/ # File system abstraction layer\n├── vcs/ # Version control implementation\n├── util/ # Utility functions and helpers\n├── CMakeLists.txt\n└── README.md\n\n## Prerequisites\n- **C++17 or newer** compiler (GCC ≥ 9, Clang ≥ 9, MSVC ≥ 2019)\n- **CMake 3.10+**\n- **MinGW-w64** or **MSYS2** (for Windows users)\n- **Visual Studio Code** or any preferred IDE\n\n\n## Setup \u0026 Build Instructions\n1️⃣ Clone the repository\ngit clone https://github.com/kushagras22/ChronoFS.git\ncd chronofs\n\n2️⃣ Create a build directory\nmkdir build \u0026\u0026 cd build\n\n3️⃣ Run CMake\ncmake ..\n\n4️⃣ Build the project\ncmake --build .\n\n5️⃣ Run ChronoFS\n./chronofs\n\n##  Commands\n\n| Command         | Description                                           |\n|-----------------|-------------------------------------------------------|\n| `init`          | Initialize ChronoFS in the current directory          |\n| `status`        | Show current working directory status                 |\n| `log`           | Show commit history and version logs                   |\n| `diff`          | Show differences between file versions                |\n| `add \u003cfile\u003e`    | Track or update a file in ChronoFS                     |\n| `rm \u003cfile\u003e`     | Remove a file from working directory and history       |\n| `restore \u003cid\u003e`  | Restore a file version using version ID                |\n\n\n## Contributing\nContributions are welcome!\n\n1. **Fork the repository** on GitHub.\n2. **Clone your fork** locally:\ngit clone https://github.com/kushagras22/ChronoFS.git\n\n3. **Create a feature branch**:\ngit checkout -b feature-name\n\n4. **Commit changes**:\ngit commit -m \"Description of changes\"\n\n5. **Push to your fork**:\ngit push origin feature-name\n\n6. **Open a Pull Request**.\n\n\n## Roadmap\n- Add compression for stored versions\n- Add networking support for remote repositories\n- Implement file tagging and search\n- Cross-platform GUI frontend\n\n\n## Acknowledgments\nBuilt with ❤️ in C++17 to show how **version control concepts** can be implemented **from scratch** without Git.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkushagras22%2Fchronofs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkushagras22%2Fchronofs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkushagras22%2Fchronofs/lists"}