{"id":15374719,"url":"https://github.com/mondeja/hledger-fmt","last_synced_at":"2025-04-15T15:12:07.669Z","repository":{"id":257802628,"uuid":"863849921","full_name":"mondeja/hledger-fmt","owner":"mondeja","description":"An opinionated hledger's journal files formatter.","archived":false,"fork":false,"pushed_at":"2025-04-14T14:07:55.000Z","size":103,"stargazers_count":10,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-15T15:11:59.959Z","etag":null,"topics":["accounting","cli","format","formatter","hledger","journal","ledger","pre-commit-hooks","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/mondeja.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,"zenodo":null}},"created_at":"2024-09-27T03:10:08.000Z","updated_at":"2025-04-14T14:07:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"3b8a1bd6-c6f0-4ff7-8d30-a4eddab5eb86","html_url":"https://github.com/mondeja/hledger-fmt","commit_stats":{"total_commits":10,"total_committers":1,"mean_commits":10.0,"dds":0.0,"last_synced_commit":"a3aface5392a6876a6f8d55dddb4c33bb7810f61"},"previous_names":["mondeja/hledger-fmt"],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mondeja%2Fhledger-fmt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mondeja%2Fhledger-fmt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mondeja%2Fhledger-fmt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mondeja%2Fhledger-fmt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mondeja","download_url":"https://codeload.github.com/mondeja/hledger-fmt/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249094932,"owners_count":21211837,"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":["accounting","cli","format","formatter","hledger","journal","ledger","pre-commit-hooks","rust"],"created_at":"2024-10-01T13:59:35.700Z","updated_at":"2025-04-15T15:12:07.663Z","avatar_url":"https://github.com/mondeja.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hledger-fmt\n\n[![Crates.io](https://img.shields.io/crates/v/hledger-fmt?logo=rust)](https://crates.io/crates/hledger-fmt)\n[![docs.rs](https://img.shields.io/docsrs/hledger-fmt?logo=docs.rs)](https://docs.rs/hledger-fmt)\n[![Tests](https://img.shields.io/github/actions/workflow/status/mondeja/hledger-fmt/ci.yml?label=tests\u0026logo=github)](https://github.com/mondeja/hledger-fmt/actions)\n[![License](https://img.shields.io/crates/l/hledger-fmt)](https://github.com/mondeja/hledger-fmt/blob/master/LICENSE)\n\nAn opinionated [hledger]'s journal files formatter.\n\n## Installation\n\n[![Crates.io downloads](https://img.shields.io/crates/d/hledger-fmt?label=Crate%20downloads)](https://crates.io/crates/hledger-fmt)\n![GitHub downloads](https://img.shields.io/github/downloads/mondeja/hledger-fmt/total?label=GitHub%20downloads)\n\n### Standalone pre-built binaries\n\nDownload standalone pre-built binaries from [releases page].\n\n### Cargo binaries\n\nInstall from pre-built binaries using [cargo-binstall]:\n\n```sh\ncargo binstall hledger-fmt\n```\n\n### Build from source\n\nBuild from source using [cargo]:\n\n```sh\ncargo install hledger-fmt\n```\n\n### pre-commit\n\nUse it with [pre-commit] by adding the hook to your _.pre-commit-config.yaml_:\n\n```yaml\nrepos:\n  - repo: https://github.com/mondeja/hledger-fmt\n    rev: vX.Y.Z\n    hooks:\n      # id: hledger-fmt       # Use this id to format files in place\n      - id: hledger-fmt-check # Use this id to check files without formatting\n```\n\n### VSCode\n\nWith hledger-fmt in your PATH, use the [VSCode Custom Local Formatters]\nextension. Just install it and add the next configuration to your\n_settings.json_:\n\n```json\n{\n  \"customLocalFormatters.formatters\": [\n    {\n      \"command\": \"hledger-fmt - --no-diff\",\n      \"languages\": [\"hledger\"]\n    }\n  ]\n}\n```\n\nTo format on save:\n\n```json\n{\n  \"editor.formatOnSave\": true\n}\n```\n\n## Usage\n\nWhen you don't pass files to format, it reads all the files with\nthe extensions `.journal`, `.hledger` and `.j` in the current directory\nand its subdirectories.\n\n```sh\nhledger-fmt [OPTIONS] [FILES]...\n```\n\nTo fix them in place, use the `--fix` option:\n\n\u003e [!WARNING]\\\n\u003e This is a potentially destructive operation. Make sure to make a backup\n\u003e of your files before running this command for the first time.\n\n```sh\nhledger-fmt --fix [FILES]...\n```\n\nSee `hledger-fmt --help` for more information.\n\n## Features\n\n- **`color`** (enabled by default): Build with terminal color support.\n- **`auto-color`** (enabled by default): Automatically detects if your terminal\n  supports colors.\n\n[cargo-binstall]: https://github.com/cargo-bins/cargo-binstall\n[hledger]: https://hledger.org\n[cargo]: https://doc.rust-lang.org/cargo/\n[releases page]: https://github.com/mondeja/hledger-fmt/releases\n[pre-commit]: https://pre-commit.com\n[VSCode Custom Local Formatters]: https://marketplace.visualstudio.com/items?itemName=jkillian.custom-local-formatters\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmondeja%2Fhledger-fmt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmondeja%2Fhledger-fmt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmondeja%2Fhledger-fmt/lists"}