{"id":13474895,"url":"https://github.com/lerna/lerna-changelog","last_synced_at":"2025-05-14T00:09:40.263Z","repository":{"id":37677499,"uuid":"59603130","full_name":"lerna/lerna-changelog","owner":"lerna","description":":book: PR-based changelog generator with monorepo support","archived":false,"fork":false,"pushed_at":"2025-05-12T19:48:58.000Z","size":3971,"stargazers_count":808,"open_issues_count":75,"forks_count":97,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-05-12T20:51:02.329Z","etag":null,"topics":["changelog","changelog-generator","github","hacktoberfest","lerna","lerna-changelog","monorepo"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/lerna.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":"2016-05-24T19:41:40.000Z","updated_at":"2025-05-04T15:51:14.000Z","dependencies_parsed_at":"2022-07-12T16:42:57.388Z","dependency_job_id":"e8c8f1e4-7c91-434a-b4f8-d46ad855bdc8","html_url":"https://github.com/lerna/lerna-changelog","commit_stats":{"total_commits":958,"total_committers":22,"mean_commits":43.54545454545455,"dds":0.5062630480167014,"last_synced_commit":"de9a389b91538d560f009eb0726b6cf1e3313916"},"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lerna%2Flerna-changelog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lerna%2Flerna-changelog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lerna%2Flerna-changelog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lerna%2Flerna-changelog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lerna","download_url":"https://codeload.github.com/lerna/lerna-changelog/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253823352,"owners_count":21969844,"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":["changelog","changelog-generator","github","hacktoberfest","lerna","lerna-changelog","monorepo"],"created_at":"2024-07-31T16:01:15.763Z","updated_at":"2025-05-14T00:09:35.254Z","avatar_url":"https://github.com/lerna.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","工程","hacktoberfest","Changelog Tools"],"sub_categories":["redux 扩展","macros","Generators","调试"],"readme":"lerna-changelog\n==============================================================================\n\n[![TravisCI Build Status][travis-badge]][travis-badge-url]\n[![Latest NPM release][npm-badge]][npm-badge-url]\n\n[npm-badge]: https://img.shields.io/npm/v/lerna-changelog.svg\n[npm-badge-url]: https://www.npmjs.com/package/lerna-changelog\n[travis-badge]: https://img.shields.io/travis/lerna/lerna-changelog/master.svg\n[travis-badge-url]: https://travis-ci.org/lerna/lerna-changelog\n\nPR-based changelog generator with monorepo support\n\n\nUsage\n------------------------------------------------------------------------------\n\n```bash\nnpx lerna-changelog\n```\n\n```md\n## Unreleased (2018-05-24)\n\n#### :bug: Bug Fix\n* [#198](https://github.com/my-org/my-repo/pull/198) Avoid an infinite loop ([@helpful-hacker](https://github.com/helpful-hacker))\n\n#### :house: Internal\n* [#183](https://github.com/my-org/my-repo/pull/183) Standardize error messages ([@careful-coder](https://github.com/careful-coder))\n\n#### Commiters: 2\n- Helpful Hacker ([@helpful-hacker](https://github.com/helpful-hacker))\n- [@careful-coder](https://github.com/careful-coder)\n```\n\nBy default `lerna-changelog` will show all pull requests that have been merged\nsince the latest tagged commit in the repository. That is however only true for\npull requests with certain labels applied. The labels that are supported by\ndefault are:\n\n- `breaking` (:boom: Breaking Change)\n- `enhancement` (:rocket: Enhancement)\n- `bug` (:bug: Bug Fix)\n- `documentation` (:memo: Documentation)\n- `internal` (:house: Internal)\n\nYou can also use the `--from` and `--to` options to view a different\nrange of pull requests:\n\n```bash\nnpx lerna-changelog --from=v1.0.0 --to=v2.0.0\n```\n\n### Monorepo support\n\nIf you have a packages folder and your projects in subfolders of that folder `lerna-changelog` will detect it and include the package names in the changelog for the relevant changes.\n\n### GitHub Token\n\nSince `lerna-changelog` interacts with the GitHub API you may run into rate\nlimiting issues which can be resolved by supplying a \"personal access token\":\n\n```\nexport GITHUB_AUTH=\"...\"\n```\n\nYou'll need a [personal access token](https://github.com/settings/tokens)\nfor the GitHub API with the `repo` scope for private repositories or just\n`public_repo` scope for public repositories.\n\n\nConfiguration\n------------------------------------------------------------------------------\n\nYou can configure `lerna-changelog` in various ways. The easiest way is by\nadding a `changelog` key to the `package.json` file of your project:\n\n```json5\n{\n  // ...\n  \"changelog\": {\n    \"labels\": {\n      \"feature\": \"New Feature\",\n      \"bug\": \"Bug Fix\"\n    }\n  }\n}\n```\n\nThe supported options are:\n\n- `repo`: Your \"org/repo\" on GitHub\n  (automatically inferred from the `package.json` file)\n\n- `nextVersion`: Title for unreleased commits\n  (e.g. `Unreleased`)\n\n- `labels`: GitHub PR labels mapped to changelog section headers\n\n- `ignoreCommitters`: List of committers to ignore (exact or partial match).\n  Useful for example to ignore commits from bots.\n\n- `cacheDir`: Path to a GitHub API response cache to avoid throttling\n  (e.g. `.changelog`)\n\n\nLicense\n------------------------------------------------------------------------------\n\n`lerna-changelog` is released under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flerna%2Flerna-changelog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flerna%2Flerna-changelog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flerna%2Flerna-changelog/lists"}