Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wolfg1969/oh-my-stars
An offline CLI tool to search your GitHub Stars.
https://github.com/wolfg1969/oh-my-stars
alfred-workflow cli github github-stars python
Last synced: about 1 month ago
JSON representation
An offline CLI tool to search your GitHub Stars.
- Host: GitHub
- URL: https://github.com/wolfg1969/oh-my-stars
- Owner: wolfg1969
- License: mit
- Created: 2014-11-15T03:07:19.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2023-10-26T11:53:44.000Z (11 months ago)
- Last Synced: 2024-07-19T05:18:45.538Z (about 2 months ago)
- Topics: alfred-workflow, cli, github, github-stars, python
- Language: Python
- Homepage:
- Size: 2.4 MB
- Stars: 94
- Watchers: 5
- Forks: 6
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# oh-my-stars
Search your stars locally.
```
usage: mystars [-h] [-l LANGUAGE [LANGUAGE ...]] [-u] [-r] [-a] [-3] [-i]
[-v]
[keywords [keywords ...]]
a CLI tool to search your starred Github repositories.
positional arguments:
keywords Search by keywords
optional arguments:
-h, --help show this help message and exit
-l LANGUAGE [LANGUAGE ...], --language LANGUAGE [LANGUAGE ...]
Filter by language
-u, --update Create(first time) or update the local stars index
-r, --reindex Re-create the local stars index
-c WHEN, --color WHEN
Colorize the output; WHEN can be 'always' (default if
omitted), 'auto', or 'never'
-a, --alfred Format search result as Alfred Script Filter output
-3, --three Alfred 3 support
-i, --install Import Alfred workflow
-v, --version show program's version number and exit
```
##### Works with Alfred Workflow
### Configuration
You can avoid entering your GitHub API credentials every time you update the index, by adding them to the ``~/.netrc`` file as follows:
```ini
machine api.github.com
login ‹GH_USERNAME›
password ‹GH_API_TOKEN›
```
Use an API token as the password – you can create one via *Settings » Developer settings » Personal access tokens* in the GitHub web interface.
Once you have stored credentials, you can also automate the index update by adding a job with ``crontab -e``:
```sh
# GitHub stars
0 6 * * * ~/.local/bin/mystars -u >~/.oh-my-stars/update.log
```
### Installation (Mac OSX)
```sh
$ pip install oh-my-stars --upgrade --user
$ mystars --help
$ mystars --update
$ mystars angular upload
$ mystars --language python
$ mystars awesome python
```
if install failed, try following commands
```sh
$ pip uninstall distribute
$ pip install setuptools
$ pip install --upgrade setuptools
```
### Integration with Alfred
```sh
$ mystars -i -3
```
For Alfred v2
```sh
$ mystars -i
```
### Change logs
#### v1.5.1
- Fix error 'IOError: [Errno 32] Broken pipe'
##### v1.5.0
- Disable the pagination and add a --color option. Thanks for the suggestions from @jhermann
- Speed up result display with CachingMiddleware of TinyDB
##### v1.4.9
- Fix workflow for Alfred v2
##### v1.4.8
- Fix Alfred XML output
- Rewrite Alfred workflow script
##### v1.4.5
- Drop Python 2.6 Support
- Update docs: using ~/.netrc + cron. @jhermann
##### v1.3.5
- Output Alfred 3 JSON ouput with "-a -3" option.
- Import Alfred Workflow with "-i" (append "-3" for Alfred 3) option.
##### v1.2.3
- Get user + password from netrc. @jhermann.
- Use pipenv to manage project requirements.
##### v1.1.3
- Upgrade to TinyDB 3.7.0.
- Build index when updating.
- Search result pagination.
*Note*
- Uninstall existing version.
- Rebuild existing index with `mystars -r`.
##### v1.0.2
- Rename to oh-my-stars.
##### v1.0.1
- Support Github two-factor authentication. @yanyaoer
##### v1.0.0
- Replace kc with [TinyDB](https://github.com/msiemens/tinydb), no more non-python dependencies.
- Only update stars since last time.