{"id":19042272,"url":"https://github.com/mrmorais/guarda-clj","last_synced_at":"2025-06-10T13:02:32.405Z","repository":{"id":82401022,"uuid":"211173615","full_name":"mrmorais/guarda-clj","owner":"mrmorais","description":"Very Simple Hash Keeper","archived":false,"fork":false,"pushed_at":"2019-09-30T13:49:39.000Z","size":15,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-21T22:46:03.434Z","etag":null,"topics":["clojure"],"latest_commit_sha":null,"homepage":"","language":"Clojure","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mrmorais.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2019-09-26T20:13:37.000Z","updated_at":"2024-03-01T22:44:12.000Z","dependencies_parsed_at":"2023-06-25T23:50:11.362Z","dependency_job_id":null,"html_url":"https://github.com/mrmorais/guarda-clj","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrmorais%2Fguarda-clj","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrmorais%2Fguarda-clj/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrmorais%2Fguarda-clj/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrmorais%2Fguarda-clj/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrmorais","download_url":"https://codeload.github.com/mrmorais/guarda-clj/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrmorais%2Fguarda-clj/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259080921,"owners_count":22802393,"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","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":["clojure"],"created_at":"2024-11-08T22:36:14.432Z","updated_at":"2025-06-10T13:02:32.363Z","avatar_url":"https://github.com/mrmorais.png","language":"Clojure","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Clj Guarda\n\nClojure implementation of a very simple hash keeper. It's a git-like application that stores associated MD5 hashes to identify file tampering.\n\n## Installation\n\nTo build from the source code you'll need to use Leiningen. Download from https://leiningen.org/.\n\nAlso you can download .jar executable from the project's Github releases section.\n\n## Usage\n\nRun the executable as .jar\n\n    $ java -jar guarda-x.x.x-alias.jar [args]\n\nOr run with `lein` (being on the project root path)\n\n    $ lein run\n\n## Options\n\nThe usage modes of Guarda and parameters definition must be setted as program args:\n\n- **method**: defines which hash type is going to be used between:\n  - `-hash`: simple hash algorithm (MD5)\n  - `-hmac`: hash with a key. With that method the key must follow the -hmac statement as a parameter setting.\n\n- **option**: defines which mode Guarda is running it could be three diferent ones:\n  - `-i`: The **init** mode. It reads a path three of a desired directory and stores a initial, ground truthly hashes.\n  - `-t`: The **tracking** mode. It tracks the directory recalculating hashes and highlighting tampered, included or deleted files.\n  - `-x`: The **purge** mode. It removes the Guarda current structure.\n\n- **path**: defines the root directory that is going to be analysed.\n  - Usage pattern: `-path /home/user` (relative path is supported)\n\n- **output**: defines the output report filename that will be generated after executing the tracking mode.\n\n## Examples\n\nCreate and store a path tree hashed structure:\n\n```\n$ java -jar guarda-x.x.x-alias.jar -i -path .\n```\n\nUsing HMAC mode for initializing a structure:\n\n```\n$ java -jar guarda-x.x.x-alias.jar -i -path . -hmac password\n```\n\nTracking a path tree against guarda stored structure:\n\n```\n$ java -jar guarda-x.x.x-alias.jar -t -path .\n```\n\nRemoving guarda metadata by using purge mode:\n\n```\n$ java -jar guarda-x.x.x-alias.jar -x -path .\n```\n\n### Bugs\n\n- There's a know bug in the function that verify if a path has hidden directories on it (guarda.core/is-hidden?) caused by a badly formatted regex expression. It's not spotting directories with a special character on it. `.guaca-mole` for instance is not matched because of the `-`. \n\n## License\n\nCopyright © 2019 Guarda\n\nThis program and the accompanying materials are made available under the\nterms of the Eclipse Public License 2.0 which is available at\nhttp://www.eclipse.org/legal/epl-2.0.\n\nThis Source Code may also be made available under the following Secondary\nLicenses when the conditions for such availability set forth in the Eclipse\nPublic License, v. 2.0 are satisfied: GNU General Public License as published by\nthe Free Software Foundation, either version 2 of the License, or (at your\noption) any later version, with the GNU Classpath Exception which is available\nat https://www.gnu.org/software/classpath/license.html.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrmorais%2Fguarda-clj","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrmorais%2Fguarda-clj","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrmorais%2Fguarda-clj/lists"}