Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/masutaka/github-nippou

Print today's your GitHub activity for issues and pull requests.
https://github.com/masutaka/github-nippou

cli cobra go-github golang

Last synced: 12 days ago
JSON representation

Print today's your GitHub activity for issues and pull requests.

Host: GitHub
URL: https://github.com/masutaka/github-nippou
Owner: masutaka
License: mit
Created: 2014-12-07T07:27:54.000Z (almost 10 years ago)
Default Branch: main
Last Pushed: 2024-10-13T14:47:49.000Z (about 1 month ago)
Last Synced: 2024-10-13T16:44:49.213Z (about 1 month ago)
Topics: cli, cobra, go-github, golang
Language: Go
Homepage:
Size: 553 KB
Stars: 65
Watchers: 5
Forks: 9
Open Issues: 6
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
- Security: SECURITY.md

Awesome Lists containing this project

README

        # github-nippou

[![Test](https://github.com/masutaka/github-nippou/actions/workflows/test.yml/badge.svg?branch=main)][Test]

[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fmasutaka%2Fgithub-nippou.svg?type=shield)][fossa]

[![Go Report Card](https://goreportcard.com/badge/github.com/masutaka/github-nippou/v4)][Go Report Card]

[![Go Reference](https://pkg.go.dev/badge/github.com/masutaka/github-nippou/v4.svg)][Go Reference]

[Test]: https://github.com/masutaka/github-nippou/actions/workflows/test.yml?query=branch%3Amain

[fossa]: https://app.fossa.com/projects/git%2Bgithub.com%2Fmasutaka%2Fgithub-nippou?ref=badge_shield

[Go Report Card]: https://goreportcard.com/report/github.com/masutaka/github-nippou/v4

[Go Reference]: https://pkg.go.dev/github.com/masutaka/github-nippou/v4

Print today's your GitHub activity for issues and pull requests.

This is a helpful CLI when you write a daily report in reference to GitHub. Nippou is a japanese word which means a daily report.

A web version of this CLI is also available at https://github.com/MH4GF/github-nippou-web .

## Installation

Grab the latest binary from the [releases](https://github.com/masutaka/github-nippou/releases) page.

On macOS you can install or upgrade to the latest released version with Homebrew:

```

$ brew install masutaka/tap/github-nippou

$ brew upgrade github-nippou

```

If you're interested in hacking on `github-nippou`, you can install via `go install`:

```

$ go install github.com/masutaka/github-nippou/v4@latest

```

Also you can use make command, it's easy to build `github-nippou`:

```

$ make deps

$ make

$ ./github-nippou

```

## Setup

    $ github-nippou init

The initialization will be update your [Git global configuration file](https://git-scm.com/docs/git-config#Documentation/git-config.txt-XDGCONFIGHOMEgitconfig).

1. Add `github-nippou.user`

2. Add `github-nippou.token`

3. Create Gist, and add `github-nippou.settings-gist-id` for customizing output format (optional)

## Usage

```

$ github-nippou help

Print today's your GitHub activity for issues and pull requests

Usage:

  github-nippou [flags]

  github-nippou [command]

Available Commands:

  completion    Generate the autocompletion script for the specified shell

  help          Help about any command

  init          Initialize github-nippou settings

  list          Print today's your GitHub activity for issues and pull requests

  open-settings Open settings url with web browser

  version       Print version

Flags:

  -d, --debug               Debug mode

  -h, --help                help for github-nippou

  -s, --since-date string   Retrieves GitHub user_events since the date (default "20231028")

  -u, --until-date string   Retrieves GitHub user_events until the date (default "20231028")

Use "github-nippou [command] --help" for more information about a command.

```

You can get your GitHub Nippou on today.

```

$ github-nippou

### masutaka/github-nippou

* [v3.0.0](https://github.com/masutaka/github-nippou/issues/59) by @[masutaka](https://github.com/masutaka)

* [Enable to inject settings_gist_id instead of the settings](https://github.com/masutaka/github-nippou/pull/63) by @[masutaka](https://github.com/masutaka) **merged!**

* [Add y/n prompt to sub command \`init\`](https://github.com/masutaka/github-nippou/pull/64) by @[masutaka](https://github.com/masutaka) **merged!**

* [Add sub command \`open-settings\`](https://github.com/masutaka/github-nippou/pull/65) by @[masutaka](https://github.com/masutaka) **merged!**

* [Dockerize](https://github.com/masutaka/github-nippou/pull/66) by @[masutaka](https://github.com/masutaka) **merged!**

```

## Optional: Customize Output Format

Customize the list output format as needed. Configurations are stored in a Gist.   

Running `github-nippou init` creates your Gist and adds its ID to `github-nippou.settings-gist-id`.

View the default configuration [here](./config/settings.yml).

### Available Properties

#### `format.subject`

| Property | Type | Description |

| --- | --- | --- |

| `subject` | `string` | Represents the repository name. |

#### `format.line`

| Property | Type | Description |

| --- | --- | --- |

| `user` | `string` | Displays the username of author of the issue or pull request. |

| `title` | `string` | Displays the title of the issue or pull request. |

| `url` | `string` | Displays the URL of the issue or pull request. |

| `status` | `string \| nil` | Displays the status, utilizing the format in `dictionary.status`. |

#### `format.dictionary.status`

| Property | Type | Description |

| --- | --- | --- |

| `closed` | `string` | Displays when the issue or pull request is closed. |

| `merged` | `string` | Displays when the pull request is merged. Applicable to pull requests only. |

## Limitations and Latency

github-nippou uses the GitHub [List events for the authenticated user](https://docs.github.com/ja/rest/activity/events?apiVersion=2022-11-28#list-events-for-the-authenticated-user) API.

:link: [REST API endpoints for events \- GitHub Docs](https://docs.github.com/en/rest/activity/events?apiVersion=2022-11-28)

> Only events created within the past 90 days will be included in timelines. Events older than 90 days will not be included (even if the total number of events in the timeline is less than 300).

github-nippou can create past daily reports, but the above limitations apply.

> This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.

As of July 29, 2024, the above is a note regarding the [List repository events](https://docs.github.com/en/enterprise-cloud@latest/rest/activity/events?apiVersion=2022-11-28#list-repository-events) API, but I confirmed with GitHub support that it applies to all Event APIs.

## Contributing

1. Fork it ( https://github.com/masutaka/github-nippou/fork )

2. Create your feature branch (`git checkout -b my-new-feature`)

3. Commit your changes (`git commit -am 'Add some feature'`)

4. Push to the branch (`git push origin my-new-feature`)

5. Create a new Pull Request

## Contributors



  



*Made with [contrib.rocks](https://contrib.rocks).*

## License

[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fmasutaka%2Fgithub-nippou.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fmasutaka%2Fgithub-nippou?ref=badge_large)

## External articles

In Japanese

1. [いつも日報書くときに使っているスクリプトをGem化した | マスタカの ChangeLog メモ](https://masutaka.net/2014-12-07-1/)

1. [github-nippou v0.1.1 released | マスタカの ChangeLog メモ](https://masutaka.net/2014-12-18-1/)

1. [github-nippou v1.1.0 and v1.1.1 released | マスタカの ChangeLog メモ](https://masutaka.net/2016-03-21-1/)

1. [github-nippou v1.2.0 released | マスタカの ChangeLog メモ](https://masutaka.net/2016-03-23-1/)

1. [社内勉強会で github-nippou v2.0.0 をライブリリースした | マスタカの ChangeLog メモ](https://masutaka.net/2016-04-09-1/)

1. [github-nippou v3.0.0 released | マスタカの ChangeLog メモ](https://masutaka.net/2017-08-07-1/)

1. [github-nippou という gem を golang で書き直したという発表をした - Feedforce Developer Blog](https://developer.feedforce.jp/entry/2017/10/16/150000)

1. [github-nippou を golang で書き換えて v4.0.1 リリースしてました | マスタカの ChangeLog メモ](https://masutaka.net/2017-10-22-1/)

1. [github-nippou のリリースを gox+ghr の手動実行から、tagpr+goreleaser の自動実行に変えた | マスタカの ChangeLog メモ](https://masutaka.net/2023-11-14-1/)

1. [github\-nippou の Web 版を App Router \+ Go \+ Vercel で作った \| Hirotaka Miyagi](https://www.mh4gf.dev/articles/github-nippou-web)

1. [github\-nippou のリリース時に formula ファイルも自動更新するようにした \| マスタカの ChangeLog メモ](https://masutaka.net/2024-07-30-1/)