https://github.com/konh/githubexplorer

Terminal wrapper to retrieve & serialize info using Github API
https://github.com/konh/githubexplorer

csharp csharp-library dotnet-core dotnetcore github-api global-tool

Last synced: 16 days ago
JSON representation

Terminal wrapper to retrieve & serialize info using Github API

• Host: GitHub
• URL: https://github.com/konh/githubexplorer
• Owner: KonH
• License: mit
• Created: 2020-11-13T11:32:38.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2024-03-25T21:31:49.000Z (9 months ago)
• Last Synced: 2024-03-25T22:34:15.040Z (9 months ago)
• Topics: csharp, csharp-library, dotnet-core, dotnetcore, github-api, global-tool
• Language: C#
• Homepage:
• Size: 42 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Github Explorer

[![Build status](https://ci.appveyor.com/api/projects/status/kpkcc3urwdbv0819?svg=true)](https://ci.appveyor.com/project/KonH/githubexplorer)

[![codecov](https://codecov.io/gh/KonH/GithubExplorer/branch/master/graph/badge.svg)](https://codecov.io/gh/KonH/GithubExplorer)

[![Nuget](https://img.shields.io/nuget/v/GithubExplorer.CommandLine)](https://www.nuget.org/packages/GithubExplorer.CommandLine)

## Description

Simple terminal wrapper to retrieve small information subset using Github API and serialize it.

This tool can be installed as .NET Core Global Tool, manual build is not required.

## Installation

```

dotnet tool install --global GithubExplorer.CommandLine

```

## Usage

### Access token

You should have environment variable with GitHub access token with name `GH_ACCESS_TOKEN`.

### Repositories

```

github_explorer --target repositories --username %USER% --output repositories.json

```

```

info: GithubExplorer.Explorer[0]

      Retrieving user information for '...'

info: GithubExplorer.Explorer[0]

      Retrieving repositories for '...'

info: GithubExplorer.Explorer[0]

      Found ... repositories for '...'

info: GithubExplorer.Writer[0]

      Result saved into 'repositories.json'

```

=> repositories.json:

```

[

  {

    "Url": "https://api.github.com/repos/...",

    "HtmlUrl": "https://github.com/...",

    "CloneUrl": "https://github.com/...",

    "GitUrl": "git://github.com/...",

    "SshUrl": "[email protected]:...",

    "SvnUrl": "https://github.com/...",

    "MirrorUrl": null,

    "Id": ...,

    "NodeId": "MDEwOlJlcG9zaXRvcnkxNDI3NjY0NjY=",

    "Owner": {

        ...

    },

    "Name": "...",

    ...

  },

  ...

]

```

### Pull requests

**Attention!** Filter here is required, serialization breaks without specifying safe properties (at least not selecting StringEnum based ones).

```

github_explorer -t pullrequests -u %USER% -o pull_requests.json --filter "Title;CreatedAt"

```

```

info: GithubExplorer.Explorer[0]

      Found ... pull requests for '...'

info: GithubExplorer.Writer[0]

      Result saved into 'pull_requests.json'

```

=> pull_requests.json:

```

[

  {

    "Title": "Circular buffer yields on single-core machines",

    "CreatedAt": "2020-10-29T23:49:30+00:00"

  },

  ...

]

```