Giter Club home page Giter Club logo

github-stats's Introduction

Github Stats (gstats)

gstats is a CLI tool that provides comprehensive statistics and information about GitHub repositories and users.

Installation

gstats can be installed either by cloning the repository and building from source or by downloading a precompiled executable from the release page. Below are the instructions for both methods:

Installing from Source

  1. Clone the Repository: Clone gstats from GitHub to your local machine using the following command:

    git clone https://github.com/cqb13/github-stats
    cd gstats
  2. Build and Install with Cargo (requires Rust's cargo tool): If you have Rust and Cargo installed, you can directly build and install the application using:

    cargo build --release
    ./target/release/gstats install

Installing from Precompiled Executables

  1. Download the Latest Release: Go to the Releases page of the gstats repository and download the appropriate executable for your operating system.

  2. Run Install Command: After downloading, you need to run the installation command. Assuming you have downloaded gstats.exe, you can install it by navigating to the download location and running:

    ./gstats install

    This command will set up gstats on your system, making it ready for use.

Post-Installation

After installing gstats, you can run gstats help to see all available commands and how to use them. Make sure that the installation path of gstats is added to your system's PATH, so it can be run from any terminal session.

Usage

USAGE:
    github-stats [COMMAND] [OPTIONS]

COMMANDS:
    version      -v
        Displays the current version of github-stats
    install      -
        Installs the files and directories
    repo          -
        Gives all stats found on a repository as json
        -u           --user       <USER>       The user who owns the repository
        -r           --repository <REPOSITORY> Name of the repository
        -o           --output     <OUTPUT>     File path to save the json
        -d           --display    <>           Converts the json to an easier format (will remove some data)
    releases     -
        Gives information on github releases
        -u           --user       <USER>       The user who owns the repository
        -r           --repository <REPOSITORY> Name of the repository
        -i           --individual <>           Downloads per release
        -l           --link       <>           Download links for releases (if not individual then for latest)
        -o           --output     <OUTPUT>     File path to save the json
        -a           --all        <>           All json from request
        -d           --display    <>           Converts the json to an easier format (will remove some data)
    user         -
        Gives information about a github user
        -u           --user       <USER>       The user you want information on
        -o           --output     <OUTPUT>     File path to save the json
        -d           --display    <>           Converts the json to an easier format (will remove some data)
    followers    -
        Lists the followers of a github user
        -u           --user       <USER>       The user you want information on
        -t           --total      <TOTAL>      Gives the follower count
        -o           --output     <OUTPUT>     File path to save the json
        -d           --display    <>           Converts the json to an easier format (will remove some data)
    following    -
        Lists users the user is following
        -u           --user       <USER>       The user you want information on
        -t           --total      <TOTAL>      Gives the following count
        -o           --output     <OUTPUT>     File path to save the json
        -d           --display    <>           Converts the json to an easier format (will remove some data)
    help         -h

Contributing

Contributions are welcome! Feel free to fork this repository and submit pull requests.

License

This project is licensed under the MIT License - see the LICENSE file for details.

github-stats's People

Contributors

cqb13 avatar

Stargazers

Rishab avatar  avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.