https://github.com/kabeep/yeareport
ЁЯУС A Node.js CLI library to summarize git commit for year-end report.
https://github.com/kabeep/yeareport
annual-report automatic changelog cli git-commit-message git-log markdown nodejs year-end year-end-report
Last synced: 6 months ago
JSON representation
ЁЯУС A Node.js CLI library to summarize git commit for year-end report.
- Host: GitHub
- URL: https://github.com/kabeep/yeareport
- Owner: kabeep
- License: mit
- Created: 2024-01-11T23:32:30.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2025-01-09T01:13:56.000Z (about 1 year ago)
- Last Synced: 2025-01-09T02:24:38.480Z (about 1 year ago)
- Topics: annual-report, automatic, changelog, cli, git-commit-message, git-log, markdown, nodejs, year-end, year-end-report
- Language: TypeScript
- Homepage: https://github.com/kabeep/yeareport
- Size: 4.03 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.hi-IN.md
- License: LICENSE
Awesome Lists containing this project
README
yeareport
рд╡рд░реНрд╖ рдХреЗ рдЕрдВрдд рдХреА рд░рд┐рдкреЛрд░рдЯ рдХреЗ рд▓рд┐рдП git commit рдХрд╛ рд╕рд╛рд░рд╛рдВрд╢ рджреЗрдиреЗ рд╡рд╛рд▓рд╛ NodeJS рдЙрдкрдХрд░рдг, Markdown рдХрд╛ рд╕реНрд╡рдЪрд╛рд▓рд┐рдд рдирд┐рд░реНрдорд╛рдг
---


[](LICENSE)
[English](README.md) | [чоАф╜Уф╕нцЦЗ](README.zh-CN.md) | [цЧецЬмшкЮ](README.ja-JP.md) | рд╣рд┐рдВрджреА
## ЁЯУЦ рдкрд░рд┐рдЪрдп
year-report рд╡реНрдпрдХреНрддрд┐рдпреЛрдВ рдХреА рд╕реЗрд╡рд╛ рдХреЗ рд▓рд┐рдП рд╕рдорд░реНрдкрд┐рдд рдПрдХ рдЙрдкрдХрд░рдг рд╣реИ, рдЬреЛ рд╡рд╛рд░реНрд╖рд┐рдХ рд░рд┐рдкреЛрд░реНрдЯ рд▓рд┐рдЦрдиреЗ рдореЗрдВ рд╕рд╣рд╛рдпрддрд╛ рдХрд░рддрд╛ рд╣реИред
> рдпрд╣ рдЖрдкрдХреА рд╕рд╣рд╛рдпрддрд╛ рдХрд░ рд╕рдХрддрд╛ рд╣реИ:
>
> рд╡реНрдпрдХреНрддрд┐рдЧрдд рдЧрд┐рдЯ рдХрд╛рд░реНрдп рд▓реЙрдЧ рдХрд╛ рд╕рд╛рд░рд╛рдВрд╢ рддреИрдпрд╛рд░ рдХрд░рдирд╛
>
> рд╕реБрдВрджрд░ рдорд╛рд░реНрдХрдбрд╛рдЙрди рдЖрдЙрдЯрдкреБрдЯ рдХрд░рдирд╛
>
> рдирд┐рд░реНрджрд┐рд╖реНрдЯ рдХрд╛рд░реНрдп рдкреНрд░рдХрд╛рд░реЛрдВ рдХреА рд╕реВрдЪреА рдФрд░ рд╕рдВрдЦреНрдпрд╛ рдирд┐рдХрд╛рд▓рдирд╛
>
> рдпрд╣ changelog-cli рд╕реЗ рдХреИрд╕реЗ рдЕрд▓рдЧ рд╣реИ:
>
> рд╡реНрдпрдХреНрддрд┐рдпреЛрдВ рдХреА рд╕реЗрд╡рд╛ рдкрд░ рдХреЗрдВрджреНрд░рд┐рдд рд╣реИ
>
> рд▓рдЪреАрд▓рд╛ рдФрд░ рдирд┐рдпрдВрддреНрд░рдг рдпреЛрдЧреНрдп рд╕рдордп рд╕реАрдорд╛
>
> рдЕрдзрд┐рдХ рдирд┐рдпрдВрддреНрд░рд┐рдд рдЖрдЙрдЯрдкреБрдЯ рдкрд░рд┐рдгрд╛рдо рдореЛрдб
>
> рд╡рд╛рд░реНрд╖рд┐рдХ рд░рд┐рдкреЛрд░реНрдЯ рд▓рд┐рдЦрдиреЗ рд╡рд╛рд▓реЗ рдбреЗрд╡рд▓рдкрд░реНрд╕ рдХреЗ рд▓рд┐рдП рдмреЗрд╣рддрд░ рдорд╛рдирдХ рд╕рд╛рдордЧреНрд░реА
>
> GPT рдХреЛ рдЦрд┐рд▓рд╛рдП рдЧрдП рдбреЗрдЯрд╛ рдХрд╛ рдкреВрд░реНрд╡-рдкрд╛рд░реНрд╕
[Markdown](example/example.md) рдЖрдЙрдЯрдкреБрдЯ рдкрд░рд┐рдгрд╛рдо рдкреНрд░рджрд░реНрд╢рди

## тЪЩя╕П рд╕реНрдерд╛рдкрдирд╛
1. рд░рд┐рдкреЛрдЬрд┐рдЯрд░реА рдХреНрд▓реЛрди рдХрд░реЗрдВ
```shell
git clone https://github.com/kabeep/yeareport.git
```
2. рдЗрдВрд╕реНрдЯрд╛рд▓реЗрд╢рди рдирд┐рд░реНрднрд░рддрд╛
```shell
cd yeareport
# NPM
npm install
# рдпрд╛ Yarn
yarn
```
3. рдкреНрд░реЛрдЧреНрд░рд╛рдо рдХрдВрдкрд╛рдЗрд▓ рдХрд░реЗрдВ
```shell
npm run build
```
4. рдПрдирдкреАрдПрдо рд╕реЙрдлреНрдЯ рд▓рд┐рдВрдХ
```shell
npm link
```
5. рдкрд░реАрдХреНрд╖рдг
```shell
yeareport -h
```
## ЁЯЪА рдЙрдкрдпреЛрдЧ

```text
yeareport [options]
рдЖрджреЗрд╢:
yeareport add рд╡рд░реНрддрдорд╛рди рдбрд╛рдпрд░реЗрдХреНрдЯрд░реА рдХреЛ рдХрддрд╛рд░ рдореЗрдВ рдЬреЛрдбрд╝реЗрдВ
yeareport remove рд╡рд░реНрддрдорд╛рди рдХрд╛рд░реНрдп рдбрд╛рдпрд░реЗрдХреНрдЯрд░реА рдХреЛ рдХрддрд╛рд░ рд╕реЗ рд╣рдЯрд╛рдПрдВ [aliases: rm]
yeareport clear рдХрддрд╛рд░ рдХреЛ рд╕рд╛рдл рдХрд░реЗрдВ [aliases: clr]
yeareport print рдХрддрд╛рд░ рдХреЛ рдорд╛рд░реНрдХрдбрд╛рдЙрди рдлрд╝рд╛рдЗрд▓ рдХреЗ рд░реВрдк рдореЗрдВ рдЖрдЙрдЯрдкреБрдЯ рдХрд░реЗрдВ [aliases: ptr]
yeareport show рдХрддрд╛рд░ рдореЗрдВ рд▓реЙрдЧ рд╕реВрдЪреА рджрд┐рдЦрд╛рдПрдВ
рд╡рд┐рдХрд▓реНрдк:
--author `auto` рдкрд░, git global config рд╕реЗ рдЦреЛрдЬреЗрдВ, рдбрд┐рдлреЙрд▓реНрдЯ рд╕рднреА рд▓реЙрдЧ рдЖрдЙрдЯрдкреБрдЯ
рдХрд░реЗрдВ [рд╕реНрдЯреНрд░рд┐рдВрдЧ]
--since рдХрд┐рд╕реА рддрд╛рд░реАрдЦ рд╕реЗ рдЖрдЙрдЯрдкреБрдЯ рд╢реБрд░реВ рдХрд░реЗрдВ, рдбрд┐рдлреЙрд▓реНрдЯ рд╣реИ `2023-01-01`
[рд╕реНрдЯреНрд░рд┐рдВрдЧ]
--before рдХрд┐рд╕реА рддрд╛рд░реАрдЦ рдкрд░ рдЖрдЙрдЯрдкреБрдЯ рдЦрддреНрдо рдХрд░реЗрдВ, рдбрд┐рдлреЙрд▓реНрдЯ рд╣реИ `2024-01-01`
[рд╕реНрдЯреНрд░рд┐рдВрдЧ]
--lunar рк╡рк░рлНрк╖ ркЕркВркдркирлА рк░рк┐рккрлЛрк░рлНркЯ ркорк╛ркЯрлЗ ркЪркВркжрлНрк░ ркХрлЗрк▓рлЗркирлНркбрк░ркирлЗ ркЕркВркдрк░рк╛рк▓ ркдрк░рлАркХрлЗ ркЙрккркпрлЛркЧ ркХрк░рлЛ
[рдмреВрд▓рд┐рдпрди]
--output рдкреНрд░рд┐рдВрдЯ рдЖрдЙрдЯрдкреБрдЯ рдбрд╛рдпрд░реЗрдХреНрдЯрд░реА, рд╡рд░реНрддрдорд╛рди рдХрд╛рд░реНрдп рдбрд╛рдпрд░реЗрдХреНрдЯрд░реА рдХреЗ
рд╕рд╛рдкреЗрдХреНрд╖, рдбрд┐рдлреЙрд▓реНрдЯ User/Downloads` [рд╕реНрдЯреНрд░рд┐рдВрдЧ]
-o, --overwrite add рдУрд╡рд░рд░рд╛рдЗрдЯ рдкреНрд░рд╛рдзрд┐рдХрд░рдг, рдЬрдм рд╡рд░реНрддрдорд╛рди рдХрд╛рд░реНрдп рдбрд╛рдпрд░реЗрдХреНрдЯрд░реА рдкрд╣рд▓реЗ рд╕реЗ
рдореМрдЬреВрдж рд╣реЛ рддреЛ рдУрд╡рд░рд░рд╛рдЗрдЯ рдХрд░рдиреЗ рдХреА рдХреНрд░рд┐рдпрд╛ рдХрд░реЗрдВ [рдмреВрд▓рд┐рдпрди] [рдбрд┐рдлрд╝реЙрд▓реНрдЯ рдорд╛рди: false]
-p, --pretty рдкреНрд░рд┐рдВрдЯ рд╕реБрдВрджрд░ рд╢реАрд░реНрд╖рдХ, рдЗрдореЛрдЬреА рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░рдХреЗ Markdown рд╢реАрд░реНрд╖рдХреЛрдВ
рдХреЛ рд╕реБрдВрджрд░ рдмрдирд╛рдПрдВ [рдмреВрд▓рд┐рдпрди] [рдбрд┐рдлрд╝реЙрд▓реНрдЯ рдорд╛рди: false]
-h, --help рдорджрдж рдХреА рдЬрд╛рдирдХрд╛рд░реА рджрд┐рдЦрд╛рдПрдВ [рдмреВрд▓рд┐рдпрди]
-v, --version рд╕рдВрд╕реНрдХрд░рдг рд╕рдВрдЦреНрдпрд╛ рджрд┐рдЦрд╛рдПрдВ [рдмреВрд▓рд┐рдпрди]
рдЙрджрд╛рд╣рд░рдг:
yeareport add -o add рдХрдорд╛рдВрдб рдХреЗ рд▓рд┐рдП рдЕрдзрд┐рдХрд╛рд░ рджреЗрдВ рдЬрдм
рд╡рд░реНрддрдорд╛рди рдХрд╛рд░реНрдп рдбрд╛рдпрд░реЗрдХреНрдЯрд░реА рдХреЗ рд▓реЙрдЧ рдкрд╣рд▓реЗ
рд╕реЗ рдХрддрд╛рд░ рдореЗрдВ рд╣реЛрдВ рддреЛ рдУрд╡рд░рд░рд╛рдЗрдЯ рдХрд░реЗрдВ
yeareport add --author=kabeep рдХреЗрд╡рд▓ рд▓реЗрдЦрдХ kabeep рдХреЗ рд▓реЙрдЧ рдХреЛ рдХрддрд╛рд░ рдореЗрдВ
рдЬреЛрдбрд╝реЗрдВ
yeareport add --since=2023-01-01 2023-01-01 рд╕реЗ 2024-01-01 рддрдХ рдХреЗ рд▓реЙрдЧ
--before=2024-01-01 рдХрддрд╛рд░ рдореЗрдВ рдЬреЛрдбрд╝реЗрдВ
yeareport print -p Markdown рд╢реАрд░реНрд╖рдХ рдЗрд╕ рдкреНрд░рдХрд╛рд░ рдЖрдЙрдЯрдкреБрдЯ
рд╣реЛрдВрдЧреЗ # {emoji} {commit-type}
```
## ЁЯОп RoadMap
- рд╕рд╛рдВрдЦреНрдпрд┐рдХреАрдп рд╡рд┐рд╢реНрд▓реЗрд╖рдг рдФрд░ рд╢рдмреНрдж рд╡рд┐рднрд╛рдЬрди
- рдкреНрд░рддрд┐рд╢рдд рдЧрдгрдирд╛
- рдкреНрд░рд╡реГрддреНрддрд┐ рдЪрд╛рд░реНрдЯ
- рдЧреИрдВрдЯ рдЪрд╛рд░реНрдЯ
## ЁЯдЭ рдпреЛрдЧрджрд╛рди
рдкреБрд▓ рд░рд┐рдХреНрд╡реЗрд╕реНрдЯреНрд╕ рдпрд╛ [Issues](https://github.com/kabeep/yeareport/issues) рдХреЗ рдорд╛рдзреНрдпрдо рд╕реЗ рдпреЛрдЧрджрд╛рди рдХрд╛ рд╕реНрд╡рд╛рдЧрдд рд╣реИред
# ЁЯУД рд▓рд╛рдЗрд╕реЗрдВрд╕
рдпрд╣ рдкрд░рд┐рдпреЛрдЬрдирд╛ рдПрдордЖрдИрдЯреА рд▓рд╛рдЗрд╕реЗрдВрд╕ рдХреЗ рдЕрдВрддрд░реНрдЧрдд рд▓рд╛рдЗрд╕реЗрдВрд╕ рдкреНрд░рд╛рдкреНрдд рд╣реИред рд╡рд┐рд╡рд░рдг рдХреЗ рд▓рд┐рдП [LICENSE](LICENSE) рдлрд╝рд╛рдЗрд▓ рджреЗрдЦреЗрдВред