Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/callmegreg/gh-language
A gh CLI extension to analyze languages in GitHub Organizations.
https://github.com/callmegreg/gh-language
gh-extension
Last synced: 25 days ago
JSON representation
A gh CLI extension to analyze languages in GitHub Organizations.
- Host: GitHub
- URL: https://github.com/callmegreg/gh-language
- Owner: CallMeGreg
- License: mit
- Created: 2023-04-27T20:58:33.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-28T17:08:11.000Z (4 months ago)
- Last Synced: 2024-11-20T14:48:12.607Z (about 2 months ago)
- Topics: gh-extension
- Language: Go
- Homepage:
- Size: 7.87 MB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# GitHub Language Analyzer
This is an extension to the `gh` command-line tool for analyzing the count of programming languages used in repositories across a GitHub organization. It retrieves a list of repositories and their associated languages, and then aggregates the data to produce a report of language frequency.
> [!NOTE]
> If you are looking to compare your language frequnecy against public trends, you can access quarterly data from 2020 onward [here](https://innovationgraph.github.com/global-metrics/programming-languages) as part of GitHub's [Innovation Graph](https://innovationgraph.github.com/) project.
# Pre-requisites
1. Install the GitHub CLI: https://github.com/cli/cli#installation
2. Confirm that you are authenticated with an account that has access to the org you would like to analyze:
```
gh auth status
```
# Installation
To install this extension, run the following command:
```
gh extension install CallMeGreg/gh-language
```
# Usage
## Count command
Display the count of programming languages used in repos across an organization.
```
gh language count YOUR_ORG_NAME
```
Optionally specify the repo limit (`--limit`) and/or the number of languages to return (`--top`)
```
gh language count YOUR_ORG_NAME --limit 1000 --top 20
```
Optionally filter by a specific language (`--language`)
```
gh language count YOUR_ORG_NAME --language Java
```
> [!NOTE]
> The `--language` flag values are case-sensitive.
## Trend command
Display the breakdown of programming languages used in repos across an organization per year, based on the repo creation date.
```
gh language trend YOUR_ORG_NAME
```
Optionally specify the repo limit (`--limit`) and/or the number of languages to return (`--top`)
```
gh language trend YOUR_ORG_NAME --limit 1000 --top 20
```
Optionally filter by a specific language (`--language`)
```
gh language trend YOUR_ORG_NAME --language Java
```
> [!NOTE]
> The `--language` flag values are case-sensitive.
## Help
For help, run:
```
gh language -h
```
```
Usage:
language [command]
Available Commands:
count Analyze the count of programming languages used in repos across an organization
help Help about any command
trend Analyze the trend of programming languages used in repos across an organization over time
Flags:
-h, --help help for language
-L, --language string The language to filter on
-l, --limit int The maximum number of repositories to evaluate (default 100)
-t, --top int Return the top N languages (ignored when a language is specified) (default 10)
Use "language [command] --help" for more information about a command.
```
# License
This tool is licensed under the MIT License. See the [LICENSE](https://github.com/CallMeGreg/gh-language/blob/main/LICENSE) file for details.