kok-s0s / github_trending_repos_cli

A command-line tool for retrieving trending GitHub repositories based on different time periods.

GitHub Trending Repositories CLI

A command-line tool for retrieving trending GitHub repositories based on different time periods.

Table of Contents

• Features
• Installation
• Usage
• Options
• Examples
• License

Features

• Fetch trending repositories from GitHub.
• Filter repositories by programming language.
• Display repository information including name, author, link, description, language, stars, and forks.

Installation

pip install github-trending-repos

Usage

github-trending-repos daily --language python --page 1

• daily, weekly, or monthly are the available time periods.
• --language allows you to filter repositories by programming language.
• --page lets you navigate through different pages of results (0 to 4).

Options

• period: Trending period (daily, weekly, or monthly).
• language: Filter repositories by programming language.
• save: Save data as JSON (optional).
• page: Page index (default: 0).

Examples

• Retrieve daily trending Python repositories:

  github-trending-repos daily --language python

• Save weekly trending repositories with JavaScript language to a JSON file:

  github-trending-repos weekly --language javascript --save

• View the second page of monthly trending repositories:

  github-trending-repos monthly --page 1

License

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