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

Uploaded Source

Built Distribution

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

Uploaded Python 2Python 3

File details

Details for the file awesome-finder-1.2.3.tar.gz.

File metadata

  • Download URL: awesome-finder-1.2.3.tar.gz
  • Upload date:
  • Size: 10.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/42.0.2 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.6.5

File hashes

Hashes for awesome-finder-1.2.3.tar.gz
Algorithm Hash digest
SHA256 7e90133fd9a22d82d1e249181d50b3368f73ff99ea0b6accd08e0507c9dfb8ef
MD5 53df164f58eb8359a51c45233a9cb020
BLAKE2b-256 cf2bf87b327f4e8f55be237e6def13d699989961596e0b97e073ba2a6c566167

See more details on using hashes here.

File details

Details for the file awesome_finder-1.2.3-py2.py3-none-any.whl.

File metadata

  • Download URL: awesome_finder-1.2.3-py2.py3-none-any.whl
  • Upload date:
  • Size: 21.0 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/42.0.2 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.6.5

File hashes

Hashes for awesome_finder-1.2.3-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 496a209e69a4b5f645eb4dc323f9a44e594cdaeb852c881d7075807bbbe4e569
MD5 641027ed5715106d9f1cdad2ba2ce3d3
BLAKE2b-256 3102ecf8fb3628360d54e4431a4b537e1b7c1c764b44862797a84700269ea2a2

See more details on using hashes here.

Supported by

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