{"id":16931407,"url":"https://github.com/leodido/maintainers-generator","last_synced_at":"2026-05-04T21:39:10.114Z","repository":{"id":46154195,"uuid":"320546545","full_name":"leodido/maintainers-generator","owner":"leodido","description":"Parse OWNERS file across repositories and output maintainers","archived":false,"fork":false,"pushed_at":"2021-11-17T14:57:24.000Z","size":129,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-01-26T00:14:35.946Z","etag":null,"topics":["generator","hacktoberfest","maintainers","open-source","owners","owners-file","prow"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/leodido.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-12-11T10:50:53.000Z","updated_at":"2023-03-21T22:05:17.000Z","dependencies_parsed_at":"2022-09-11T15:31:13.285Z","dependency_job_id":null,"html_url":"https://github.com/leodido/maintainers-generator","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leodido%2Fmaintainers-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leodido%2Fmaintainers-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leodido%2Fmaintainers-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leodido%2Fmaintainers-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leodido","download_url":"https://codeload.github.com/leodido/maintainers-generator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244730480,"owners_count":20500454,"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":["generator","hacktoberfest","maintainers","open-source","owners","owners-file","prow"],"created_at":"2024-10-13T20:43:53.932Z","updated_at":"2026-05-04T21:39:05.081Z","avatar_url":"https://github.com/leodido.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# maintainers-generator\n\n\u003e Parse OWNERS file across repositories to output YAML containing all the maintainers!\n\n## Install\n\n```console\ngo get github.com/leodido/maintainers-generator\n```\n\n## Usage\n\nThis is the CLI.\n\n```console\nUsage of ./bin/maintainers-generator:\n  -banner\n        Whether you want a header on top of the output YAML maintainers file\n  -dedupe\n        Whether to dedupe or not sub-project areas for every maintainer. (default true)\n  -dry-run\n        Dry run for testing (uses API tokens but does not mutate).\n  -github-app-id string\n        ID of the GitHub app. If set, requires --github-app-private-key-path to be set and --github-token-path to be unset.\n  -github-app-private-key-path string\n        Path to the private key of the github app. If set, requires --github-app-id to bet set and --github-token-path to be unset\n  -github-endpoint value\n        GitHub's API endpoint (may differ for enterprise). (default https://api.github.com)\n  -github-graphql-endpoint string\n        GitHub GraphQL API endpoint (may differ for enterprise). (default \"https://api.github.com/graphql\")\n  -github-host string\n        GitHub's default host (may differ for enterprise) (default \"github.com\")\n  -github-token-path string\n        Path to the file containing the GitHub OAuth secret.\n  -log-level string\n        Log level. (default \"info\")\n  -org string\n        The GitHub organization name.\n  -output string\n        The path where to write the output YAML maintainers (default \"stdout\")\n  -persons-db string\n        The path to a JSON file containing handle =\u003e name/company mappings (default \"data/data.json\")\n  -repo string\n        The GitHub repository name.\n  -sort\n        Whether to sort the projects alphabetically. (default true)\n  -version\n        Print the version.\n```\n\nFor example, you could run:\n\n```console\n./bin/maintainers-generator --github-token-path /etc/token --org falcosecurity\n```\n\nWhich will output a YAML to STDOUT like the following one:\n\n```yaml\n- name: user1\n  github: https://github.com/user1\n  company: UNKNOWN\n  projects:\n  - https://github.com/falcosecurity/falcosecurity/community\n- name: user2\n  github: https://github.com/user2\n  company: UNKNOWN\n  projects:\n  - https://github.com/falcosecurity/falcosecurity/.github\n  - https://github.com/falcosecurity/falcosecurity/advocacy\n  - https://github.com/falcosecurity/falcosecurity/charts\n  - https://github.com/falcosecurity/falcosecurity/client-go\n  - https://github.com/falcosecurity/falcosecurity/client-rs\n```\n\n## TODOs\n\n- Extensive test suite\n- Complete support for the [OWNERS spec](https://github.com/kubernetes/community/blob/master/contributors/guide/owners.md)\n  - Support for `no_parent_owners: true`\n  - Support for OWNERS file with `filters`\n  - Support for `emeritus_approvers`\n\n---\n\n[![Analytics](https://ga-beacon.appspot.com/UA-49657176-1/maintainers-generator?flat)](https://github.com/igrigorik/ga-beacon)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleodido%2Fmaintainers-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleodido%2Fmaintainers-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleodido%2Fmaintainers-generator/lists"}