Browse trending repos on Github by ⭐ stars ⭐ from your command line 💻

Prerequisites

Requires Python 3.7 or greater

Installation

pip install starcli

Usage

Usage: starcli [OPTIONS]

  Returns repositories based on the language. repositories are sorted by
  stars

Options:
  -l, --language TEXT  language filter (eg: python)
  -d, --date TEXT      date in the ISO8601 format which is YYYY-MM-DD (year-
                       month-day)
  -L, --layout TEXT       output format, it can be either table or list
  --help               Show this message and exit.

Development

Make sure you read CONTRIBUTING.md first!

note: this proj is still in its early stage, if CONTRIBUTING.md is not yet created, create an issue to remind the maintainer!

First, fork this repo then,

git clone https://github.com/{your_username}/starcli.git
cd starcli
python -m virtualenv venv
source venv/bin/activate
pip install -r requirements.txt
git checkout -b your_br_name_here

Make the neccessary changes, test your changes, then

git add .
git commit -m 'my commit message'
git push -u origin main

Start a pull request and wait for it to be reviewed!

8 Open More issues

Closed

Search by Topic

related to any bug?

why should this feature be implemented?

More and more projects are tagged with relevant keywords (topic). Search by language is sometimes too broad. I would like to search within javascript language by topic react.

how do you think should it be implemented?

Command line flag --topic -t Search by topic that is used in combination with language flag.

is the feature similar to anything from other projects?

Not sure

enhancement good first issue

opened Jul 12, 2020 by mgutz 16

Closed

Add grid view option to `--layout`, implement grid view output

Currently, for the --layout option we have list or table, it would be awesome if we also have a grid option so the output can be displayed in grid view format.

To do so we should add a function called something like grid_layout() in starcli/layouts.py, with one parameter repos. This function should then be imported from starcli/__main__.py using the same logic as list_layout and table_layout to be called when --layout grid is specified. Also, don't forget to update click.Choices(["list", "table", "grid"]) in the starcli/__main__.py, with the help argument updated and the usage copied to the README.

You can use the panel and columns functionality from rich. See this example for reference

Start a pull request when you are done (or have started the draft PR)

Edit: added columns link as to the suggestion from @willmcgugan

enhancement good first issue

opened Jun 27, 2020 by hedythedev 11

Closed

Add CLI tests (pytest) to test the CLI itself

Currently we only have a search() test (you can check out the tests dir), we probably need a way to emulate a real terminal and call it from that command line (With different options) to test the full functionality, can use: https://click.palletsprojects.com/en/7.x/testing/

Just add some test_*.py files in tests/ and in it add test_* functions to do your test. Then you can run python -m pytest and make sure they pass. We need these because they are part of the GitHub action workflow, all pull request and pushed commits will then be tested using it

enhancement good first issue tests

opened Jul 9, 2020 by hedythedev 7

Closed

Added support for caching results

Checklist

[X] My code is properly formatted using the latest black
[ ] I have added/updated tests if needed
[X] I have tried running my code manually
[X] I have checked for spelling errors

Description Resolves #61 Added support to cache the responses to a JSON file which will get created when the user first runs the program and also added it to .gitignore so that it will not be tracked by git.

The cache file looks something like this after few requests

Those are the keys, which contains the content of the responses.

opened Feb 13, 2021 by AkashD-Developer 7

Closed

Feat/grid view

Description

Implements a grid layout option. Screenshot

Context

Resolves Issue #23

More details

Repo names for this view don't link to their repos.
I had some trouble rendering emojis with the colon syntax (:star:) but using the unicode character directly seemed to work ok.

opened Jul 7, 2020 by swellander 7

Closed

Added number shortening

Description

Added a number shortening function as needed, works with a newly added --long-stats flag.

Context

Adds the enhancement as in issue #40 .

More details Rounding up and if the value after rounding up is more than 1000, it's shortened.

Remember that your code will be checked by the black formatter, pylint, codespell, and pytest.

opened Jul 9, 2020 by shivam212 7

Open

Update rich requirement from <10.0.0,>=4.0.0 to >=4.0.0,<11.0.0

Updates the requirements on rich to permit the latest version.

Release notes

Sourced from rich's releases.

Update to render protocol

Some significant signature to render protocol, hence the major version bump. These are unlikely to impact many people unless you are implementing your own renderables.

Most of the work in this version was to aid development of adding more dynamic features to future versions.

See changelog for details...

[10.0.0] - 2021-03-27

Changed

Made pydoc import lazy as at least one use found it slow to import willmcgugan/rich#1104

Modified string highlighting to not match in the middle of a word, so that apostrophes are not considered strings

New way of encoding control codes in Segment

New signature for Control class

Changed Layout.split to use new Splitter class

Improved layout.tree

Changed default theme color for repr.number to cyan

__rich_measure__ signature changed to accept ConsoleOptions rather than max_width

Added

Added __rich_repr__ protocol method to Pretty

Added rich.region.Region

Added ConsoleOptions.update_dimensions

Added rich.console.ScreenUpdate

Added Console.is_alt_screen

Added Control.segment, Control.bell, Control.home, Control.move_to, Control.clear, Control.show_cursor, Control.alt_screen

Added Console.update_screen and Console.update_screen_lines

Added Layout.add_split, Layout.split_column, Layout.split_row, layout.refresh

Added new Rich repr protocol __rich_repr__

Fixed

Fixed table style taking precedence over row style willmcgugan/rich#1129

Fixed incorrect measurement of Text with new lines and whitespace willmcgugan/rich#1133

Made type annotations consistent for various total keyword arguments in rich.progress and rich.progress_bar

Disabled Progress no longer displays itself when starting willmcgugan/rich#1125

Changelog

Sourced from rich's changelog.

[10.0.0] - 2021-03-27

Changed

Made pydoc import lazy as at least one use found it slow to import willmcgugan/rich#1104

Modified string highlighting to not match in the middle of a word, so that apostrophes are not considered strings

New way of encoding control codes in Segment

New signature for Control class

Changed Layout.split to use new Splitter class

Improved layout.tree

Changed default theme color for repr.number to cyan

__rich_measure__ signature changed to accept ConsoleOptions rather than max_width

Added

Added __rich_repr__ protocol method to Pretty

Added rich.region.Region

Added ConsoleOptions.update_dimensions

Added rich.console.ScreenUpdate

Added Console.is_alt_screen

Added Control.segment, Control.bell, Control.home, Control.move_to, Control.clear, Control.show_cursor, Control.alt_screen

Added Console.update_screen and Console.update_screen_lines

Added Layout.add_split, Layout.split_column, Layout.split_row, layout.refresh

Added new Rich repr protocol __rich_repr__

Fixed

Fixed table style taking precedence over row style willmcgugan/rich#1129

Fixed incorrect measurement of Text with new lines and whitespace willmcgugan/rich#1133

Made type annotations consistent for various total keyword arguments in rich.progress and rich.progress_bar

Disabled Progress no longer displays itself when starting willmcgugan/rich#1125

[9.13.0] - 2021-03-06

Added

Pretty printer now supports dataclasses

Fixed

Fixed Syntax background willmcgugan/rich#1088

Fix for double tracebacks when no formatter willmcgugan/rich#1079

Changed

Added ws and wss to url highlighter

[9.12.4] - 2021-03-01

Fixed

... (truncated)

Commits

b9e0014 Merge pull request #1125 from JoshKarpel/really-disable-pbar
34c5620 test that Progress writes nothing when disabled
3e079ff Merge branch 'master' into really-disable-pbar
472ed32 Merge pull request #1122 from Adilius/master
fe5db3c Merge pull request #1126 from willmcgugan/dependabot/pip/sphinx-3.5.3
d1f819a Merge pull request #1131 from neutrinoceros/type_annotations_progress_total
e08a838 Merge branch 'master' into type_annotations_progress_total
95016f4 Merge pull request #1119 from willmcgugan/control-codes
86a3844 win32 skip
f1492a0 skip alt screen if LW
Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

@dependabot rebase will rebase this PR
@dependabot recreate will recreate this PR, overwriting any edits that have been made to it
@dependabot merge will merge this PR after your CI passes on it
@dependabot squash and merge will squash and merge this PR after your CI passes on it
@dependabot cancel merge will cancel a previously requested merge and block automerging
@dependabot reopen will reopen this PR if it is closed
@dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
@dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
@dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
@dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

dependencies

opened Mar 29, 2021 by dependabot[bot] 0

Open

Added tests for cached results

Checklist

[X] My code is properly formatted using the latest black
[X] I have added/updated tests if needed
[X] I have tried running my code manually
[X] I have checked for spelling errors

Description Added cli tests for the code added in #97. Resolves #99

opened Mar 9, 2021 by AkashD-Developer 0

Open

Add tests for cached results

Caching results was added in #97 by @AkashD-Developer, it would be nice if CLI tests were added for it.

The details of implementation is up to you, here's some ideas:

Checking for the cache json
Running same command again and time differences

enhancement

opened Feb 28, 2021 by hedythedev 1

Open

Feat: View the main README.md from the terminal as well

Description Hi all,

I put together this bash script that let's you view the main README.md for GitHub repos you find with this tool. This will only work with output format list. Let's say you run starcli -L list -t deep-learning -p '>=2020-11-20' -r 10 -l pytorch and you decide you want to look at one of those ten repos and view the README.md without leaving the terminal, and one of those repos is fastai/fastbook.

You'd create a shell script, say in your ~/Downloads path with vim viewREADME.sh and insert the following code:

#!/bin/bash

url=$1;
program=$2
base="https://raw.githubusercontent.com/";
file="README.md";
end="/master/README.md"

cd ~/Downloads;

curl -H 'Authorization: token INSERT_PERSONAL_TOKEN' \
  -H 'Accept: application/vnd.github.v3.raw' \
  -O \
  -L "${base}${url}${end}"

sleep 5

if [ ${program} = "glow" ]; then
    ${program} -s dark ${file}
else
    ${program} ${file}
fi

sleep 2

rm ${file}

This script has a couple prerequisites. You need to install a program like glow or grip to handle the markdown file. Also, you'll need to get an access token from GitHub. You can follow this guide for the token [https://docs.github.com/en/[email protected]/github/authenticating-to-github/creating-a-personal-access-token](Create a personal access token). Then update the code above with your personal access token. Once that is complete, you'd run ./viewREADME.sh fastai/fastbook glow to view the README.md for that repo.

I'm sure this script could be cleaned up a bit, or further customized, but it works for my purposes.

Why do you think it would be a good idea?

Easy access to the README.md file.

Checklist

[x] I have checked for existing issues and this is not a duplicate

enhancement

opened Dec 16, 2020 by d84-n1nj4 0

Open

New demo gif

Checklist

[x] My code is properly formatted using the latest black
[x] I have added/updated tests if needed
[x] I have tried running my code manually
[x] I have checked for spelling errors

Description

Demo gif addition https://github.com/hedythedev/starcli/issues/80#issue-681655147

opened Sep 30, 2020 by sameeravithanage 0

Open

Better gif/svg animation of starcli usage/demo

The latest usage gif was outdated and since then there were new features and bug fixes. We should provide a new, up-to-date when to show the full features.

Requirements:

Shouldn’t be too slow, it is recommended that it is sped up, but users should see clearly what is happening
No need to show all the features, but show as much as possible
It should be run like a user who downloaded it as a package using starcli <args> not python -m starcli. To do so you have several options:
1. clone this repo and do python setup.py install
2. Make a new directory in a virtual environment and use pip install starcli (or you favourite package manager)
3. Install starcli globally as a package like a normal user would
Once you have your SVG (or gif) saved, put it in the images folder (replace the original gif), update the link in the README and push to remote to open a PR

Some tools you could use:

asciinema for terminal session recordings
How to speed up and Asciinema recording
Turn asciinema cast into clear, pretty SVGs

If you would like to work on this, there is no need to ask, just open a PR. If there are multiple, I will choose one that works best or even include all of them

documentation good first issue help wanted

opened Aug 19, 2020 by hedythedev 6

v2.17.0(Feb 21, 2021)

Added caching results (#97)

Source code(tar.gz)
Source code(zip)

v2.16.0(Oct 2, 2020)

improved HTTP error handling logic
Added tests for the CLI itself (#77 by @jSadoski)
Improved fetching for GitHub trending by using the gtrending library (#86 by @odmishien)
Better debug logging with RichHandler (#84 by @ineelshah)
Fixed checking for <=> in --created and --pushed logic

Source code(tar.gz)
Source code(zip)

v2.15.0(Aug 4, 2020)

add --auth option for username/password authentication

Source code(tar.gz)
Source code(zip)

v2.14.2(Aug 2, 2020)

hotfix for previous release --topic
fixed extra ’end’ parameter when calling click.secho

Source code(tar.gz)
Source code(zip)

v2.14.1(Aug 1, 2020)

better help texts for options
renamed --topics to --topic

Source code(tar.gz)
Source code(zip)

v2.14.0(Aug 1, 2020)

Added/Changed:

Added functionality to use >=< when specifying last push
rename: --last-updated -> --pushed, which means --user can now have -u

Code changes:

Added error handling for HTTP status codes

Source code(tar.gz)
Source code(zip)

Information

Category: Linux / Miscellaneous
Watchers: 6
Star: 314
Fork: 22
Last update: Jun 13, 2021

Resource links

https://github.com/hedythedev/starcli

Share this repo

Related Repos

Miscellaneous

2.3k

Taobao System Activity Reporter

Introduction Tsar (Taobao System Activity Reporter) is a monitoring tool, which can be used to gather and summarize system information, e.g. CPU, load, IO, and application information, e.g. nginx, HAProxy, Squid, etc. The results

Popular

Miscellaneous

2.6k

✨ Standard library for JavaScript and Node.js. ✨

stdlib (/ˈstændərd lɪb/ "standard lib") is a standard library for JavaScript and Node.js, with an emphasis on numerical and scientific computing applications. The library provides a collection of robust, high pe

Miscellaneous

149

Adding the Intel MKL to a Debian / Ubuntu system via one simple script

MKL for .deb-based systems: An easy recipe This post describes how to easily install the Intel Math Kernel Library (MKL) on a Debian or Ubuntu system. Very good basic documentation is provided by Intel at their site. The discussi

Miscellaneous

259

Elegant vim theme with bright colors.

vim-snazzy Elegant vim theme with bright colors. Based on hyper-snazzy by Sindre Sorhus. This is still an early build, I'll be implementing better language support as I use this more myself. All feedback, comments, and PRs

Miscellaneous

129

For forgetful vim users

Remembrall This is a small plugin that makes it easier to remember mappings. Installation Using vim-plug: Plug 'urbainvaes/vim-remembrall' Usage To scroll down and up the list, use <c-e>, <c

Miscellaneous

335

Automated security reporting from markdown templates (HackerOne and Bugcrowd are currently...

bountyplz – automated security reporting from markdown templates description This is a project created by Frans Rosén. The idea is to be able to submit a report without any interaction. It's taking advantage of all fea

Miscellaneous

Find your Vim commands faster : An interactive cheat sheet for vim. (Site might be slow t...

VIM INTERACTIVE CHEAT SHEET Find your Vim commands faster. install git clone [email protected]:nyl-auster/vim-interactive-cheat-sheet.git cd vim-interactive-cheat-sheet yarn install yarn start contribute A

Miscellaneous

15.4k

A tree explorer plugin for vim.

The NERDTree Introduction The NERDTree is a file system explorer for the Vim editor. Using this plugin, users can visually browse complex directory hierarchies, quickly open files for reading or editing, and perform b