hedyhli/starcli

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

d84-n1nj4 opened this issue · 0 comments

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 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

  • I have checked for existing issues and this is not a duplicate