An open API service indexing awesome lists of open source software.

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.

Awesome Lists containing this project

README

          

yeareport



рд╡рд░реНрд╖ рдХреЗ рдЕрдВрдд рдХреА рд░рд┐рдкреЛрд░рдЯ рдХреЗ рд▓рд┐рдП git commit рдХрд╛ рд╕рд╛рд░рд╛рдВрд╢ рджреЗрдиреЗ рд╡рд╛рд▓рд╛ NodeJS рдЙрдкрдХрд░рдг, Markdown рдХрд╛ рд╕реНрд╡рдЪрд╛рд▓рд┐рдд рдирд┐рд░реНрдорд╛рдг

---

![nodejs](https://img.shields.io/badge/NodeJS-тЙе16.x-lightseagreen?logo=powershell)
![Version](https://img.shields.io/badge/Version-1.0.0-cornflowerblue)
[![License](https://img.shields.io/badge/License-MIT-slateblue)](LICENSE)

[English](README.md) | [чоАф╜Уф╕нцЦЗ](README.zh-CN.md) | [цЧецЬмшкЮ](README.ja-JP.md) | рд╣рд┐рдВрджреА

## ЁЯУЦ рдкрд░рд┐рдЪрдп

year-report рд╡реНрдпрдХреНрддрд┐рдпреЛрдВ рдХреА рд╕реЗрд╡рд╛ рдХреЗ рд▓рд┐рдП рд╕рдорд░реНрдкрд┐рдд рдПрдХ рдЙрдкрдХрд░рдг рд╣реИ, рдЬреЛ рд╡рд╛рд░реНрд╖рд┐рдХ рд░рд┐рдкреЛрд░реНрдЯ рд▓рд┐рдЦрдиреЗ рдореЗрдВ рд╕рд╣рд╛рдпрддрд╛ рдХрд░рддрд╛ рд╣реИред

> рдпрд╣ рдЖрдкрдХреА рд╕рд╣рд╛рдпрддрд╛ рдХрд░ рд╕рдХрддрд╛ рд╣реИ:
>
> рд╡реНрдпрдХреНрддрд┐рдЧрдд рдЧрд┐рдЯ рдХрд╛рд░реНрдп рд▓реЙрдЧ рдХрд╛ рд╕рд╛рд░рд╛рдВрд╢ рддреИрдпрд╛рд░ рдХрд░рдирд╛
>
> рд╕реБрдВрджрд░ рдорд╛рд░реНрдХрдбрд╛рдЙрди рдЖрдЙрдЯрдкреБрдЯ рдХрд░рдирд╛
>
> рдирд┐рд░реНрджрд┐рд╖реНрдЯ рдХрд╛рд░реНрдп рдкреНрд░рдХрд╛рд░реЛрдВ рдХреА рд╕реВрдЪреА рдФрд░ рд╕рдВрдЦреНрдпрд╛ рдирд┐рдХрд╛рд▓рдирд╛
>
> рдпрд╣ changelog-cli рд╕реЗ рдХреИрд╕реЗ рдЕрд▓рдЧ рд╣реИ:
>
> рд╡реНрдпрдХреНрддрд┐рдпреЛрдВ рдХреА рд╕реЗрд╡рд╛ рдкрд░ рдХреЗрдВрджреНрд░рд┐рдд рд╣реИ
>
> рд▓рдЪреАрд▓рд╛ рдФрд░ рдирд┐рдпрдВрддреНрд░рдг рдпреЛрдЧреНрдп рд╕рдордп рд╕реАрдорд╛
>
> рдЕрдзрд┐рдХ рдирд┐рдпрдВрддреНрд░рд┐рдд рдЖрдЙрдЯрдкреБрдЯ рдкрд░рд┐рдгрд╛рдо рдореЛрдб
>
> рд╡рд╛рд░реНрд╖рд┐рдХ рд░рд┐рдкреЛрд░реНрдЯ рд▓рд┐рдЦрдиреЗ рд╡рд╛рд▓реЗ рдбреЗрд╡рд▓рдкрд░реНрд╕ рдХреЗ рд▓рд┐рдП рдмреЗрд╣рддрд░ рдорд╛рдирдХ рд╕рд╛рдордЧреНрд░реА
>
> GPT рдХреЛ рдЦрд┐рд▓рд╛рдП рдЧрдП рдбреЗрдЯрд╛ рдХрд╛ рдкреВрд░реНрд╡-рдкрд╛рд░реНрд╕

[Markdown](example/example.md) рдЖрдЙрдЯрдкреБрдЯ рдкрд░рд┐рдгрд╛рдо рдкреНрд░рджрд░реНрд╢рди

![default_example](example/screenshot.png)

## тЪЩя╕П рд╕реНрдерд╛рдкрдирд╛

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
```

## ЁЯЪА рдЙрдкрдпреЛрдЧ

![Usage](example/usage.png)

```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) рдлрд╝рд╛рдЗрд▓ рджреЗрдЦреЗрдВред