{"id":17875981,"url":"https://github.com/bnjjj/fixme_report","last_synced_at":"2025-10-26T16:46:42.612Z","repository":{"id":56621146,"uuid":"236215939","full_name":"bnjjj/fixme_report","owner":"bnjjj","description":"Tool to automate issues creation directly from // TODO and // FIXME comments in your code","archived":false,"fork":false,"pushed_at":"2020-10-28T11:29:33.000Z","size":163,"stargazers_count":11,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-18T06:35:55.649Z","etag":null,"topics":["cli","code","comment","fixme","git-diff","hacktoberfest","issue","parser","todo","tool"],"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/bnjjj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-01-25T19:04:38.000Z","updated_at":"2023-10-20T00:10:34.000Z","dependencies_parsed_at":"2022-08-15T22:10:13.390Z","dependency_job_id":null,"html_url":"https://github.com/bnjjj/fixme_report","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bnjjj%2Ffixme_report","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bnjjj%2Ffixme_report/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bnjjj%2Ffixme_report/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bnjjj%2Ffixme_report/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bnjjj","download_url":"https://codeload.github.com/bnjjj/fixme_report/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244890102,"owners_count":20527030,"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":["cli","code","comment","fixme","git-diff","hacktoberfest","issue","parser","todo","tool"],"created_at":"2024-10-28T11:26:27.744Z","updated_at":"2025-10-26T16:46:37.569Z","avatar_url":"https://github.com/bnjjj.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FIXME report\n\nFIXME report is a simple tool to automate your issues creation directly from `// TODO` and `// FIXME` comments in your codebase.\nToo often you write these comments and forget to delete them or take them into account for your project's next milestone. Note that you can also assign your issues to an assignee by writing a comment with the following syntax `// TODO (@bnjjj): clean this function`\nAt the current stage FIXME report only supports GitHub issue creation, but take a look at our [roadmap](#roadmap) to know the next platforms supported.\n\n## Configuration\n\nSave your configuration in a JSON file:\n\n```json\n{\n    \"type\": \"github\",\n    \"repository\": \"bnjjj/fixme_report\",\n    \"token\": \"PERSONAL_TOKEN_FROM_GITHUB\",\n    \"username\": \"bnjjj\",\n    \"url\": \"https://github.com\"\n}\n```\n\nYou can save it into a file named `fixme_settings.json` in the same directory of your project. If you want to have it somewhere else you can use a flag to indicate the path to your configuration file as following `fixme_report -c $HOME/my_settings.json`.\n\n## Usage\n\nThe default behavior is to read a patchset (git diff) directly from stdin. If you want to specify a `.patch` file you can do it by adding the following parameter `-f=yourFile.patch` to the CLI.\n\nExample: create issues based on your last commit:\n\n```bash\n$ git diff HEAD^1 HEAD | fixme_report\n```\n\nThe purpose is to add this CLI to your CI/CD pipeline in order to launch it on every commit merged to master.\n\n\n```bash\nUSAGE:\n    fixme_report [FLAGS] [OPTIONS]\n\nFLAGS:\n    -d, --dry-run    display issues to create without creating them\n    -h, --help       Prints help information\n    -V, --version    Prints version information\n\nOPTIONS:\n    -c, --config \u003cconfig-file\u003e               giving configuration file, default is fixme_settings.json in the current\n                                             directory\n    -f, --file \u003cfile\u003e                        giving patchset file instead of parsing it via stdin\n    -m, --fixme-template \u003cfixme-template\u003e    giving template (handlebars) file for fixme cases (OPTIONAL)\n    -t, --todo-template \u003ctodo-template\u003e      giving template (handlebars) file for todo cases (OPTIONAL)\n```\n\nHere is an example of an issue created with [this of git diff](samples/sample_with_todo):\n\n![example issue](example_issue.png)\n\n+ You can also give for each kind of comment (TODO, FIXME) create a template for to create description of issue as you want. [Here is an example file](./example_todo.tmpl). You just have to use `--todo-template` and/or `--fixme-template` to use your specified file. In these templates you can access 3 different variables as `file`, `line` and `details` to have the comment details. It must be a [handlebars](https://handlebarsjs.com/) compliant template.\n\n\n## Roadmap\n\n+ Add support of Bitbucket Cloud\n+ Add support of Bitbucket Server\n+ Add support of Gitlab\n+ Add support of Jira\n+ Add more tests\n+ Better lib architecture\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbnjjj%2Ffixme_report","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbnjjj%2Ffixme_report","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbnjjj%2Ffixme_report/lists"}