Skip to main content

A TUI based awesome curated list finder

Project description



Awesome Finder

Search the awesome curated list without browser




What does mean awesome? The awesome series provide a curated list of awesome frameworks, libraries, software and resources for a specific topic. An example is awesome-python

A TUI based finder for searching the awesome resources on awesome series such as awesome-python, awesome-go and so on.

With it, you can browse the awesome libraries, resources on your terminal without browser.

asciicast

Installation

It supports Python 3+ only.

pip install awesome-finder # or pip3 install awesome-finder 

Usage

# Find awesome things from awesome-<topic>
awesome-hub <topic>

# Find awesome things from latest awesome-<topic> (not use cache)
awesome-hub <topic> -f (--force)

# Find awesome things with initial query
awesome-hub <topic> -q (--query) 'query string you want to search'

# Show help messages (can see supported awesome topics)
awesome-hub -h (--help)

There are some helpful key bindings:

Key Description
Key up () Scroll up
Key down () Scroll down
Key left () Page up
Key right () Page down
Enter (↵) Open the selected awesome link on default browser
Esc Close the awesome finder

Supported awesome topics

Updated: 2018-03-04

These will be updated continuously

  • awesome
  • awesome-android
  • awesome-elixir
  • awesome-erlang
  • awesome-go
  • awesome-ios
  • awesome-java
  • awesome-javascript
  • awesome-nodejs
  • awesome-php
  • awesome-python
  • awesome-ruby
  • awesome-rust
  • awesome-scala
  • awesome-swift
  • awesome-vue

Contributing

Details on CONTRIBUTING

Changelog

Details on CHANGELOG

TODO

  • Query highlighting
  • Supports paging with Key left (←) and Key right (→)
  • Smart parsing with hierachical structure
  • Supports all awesome series
  • Supports initial query (example: awesome python -q 'django oauth')
  • Add options to open the Issue and Pull Request page of a specific awesome series

License

FOSSA Status

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

awesome-finder-1.2.3.tar.gz (10.4 kB view hashes)

Uploaded Source

Built Distribution

awesome_finder-1.2.3-py2.py3-none-any.whl (21.0 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page