Skip to main content
https://img.shields.io/pypi/v/findref.svg https://img.shields.io/pypi/l/findref.svg https://img.shields.io/pypi/pyversions/findref.svg https://img.shields.io/badge/Release_History!--None.svg?style=social https://img.shields.io/badge/STAR_Me_on_GitHub!--None.svg?style=social
https://img.shields.io/badge/Link-Install-blue.svg https://img.shields.io/badge/Link-GitHub-blue.svg https://img.shields.io/badge/Link-Submit_Issue-blue.svg https://img.shields.io/badge/Link-Request_Feature-blue.svg https://img.shields.io/badge/Link-Download-blue.svg

Welcome to findref Documentation

findref is an interactive terminal app that can search tech documentation reference. It is Python, cross-platform, easy-to-install, and blazing fast.

https://github.com/MacHu-GWU/findref-project/assets/6800411/e7bc899d-cf8b-46ea-84e3-2437e5a65014

Usage Example

# install (you need Python3.8+)
$ pip install findref

# enter the interactive terminal app
$ fr

Then you can follow the hint and enter your query to search, it support fuzzy search, ngram search (See 🚀 supported-dataset)

It will ask you to wait for building the search index for the first time. After that, it will be very fast to search.

The dataset will be updated automatically every 30 days. You can also use !~ followed by any query to force update the dataset. For example, if tf aws s3 bucket doesn’t give you result, you can use tf aws s3 bucket!~ to search again on the latest data.

Keyboard shortcuts:

  • ⬆️: hit Ctrl + E or UP to move item selection up.

  • ⏫: hit Ctrl + R to scroll item selection up.

  • ⬇️: hit Ctrl + D or DOWN to move item selection down.

  • ⏬: hit Ctrl + F to scroll item selection down.

  • ⬅️: hit Ctrl + H or LEFT to move query input cursor to the left (this won’t work on Windows).

  • ➡️: hit Ctrl + L or RIGHT to move query input cursor to the right.

  • ⏪: hit Ctrl + G to move query input cursor to the previous word.

  • ⏩: hit Ctrl + K to move query input cursor to the next word.

  • ↩️: hit Ctrl + X to clear the query input.

  • ◀️: hit BACKSPACE to delete query input backward.

  • ▶️: hit DELETE to delete query input forward.

  • 🌐: hit Enter to open the reference in web browser.

  • ✅: hit Ctrl + A to copy the url to clipboard.

  • 🔴: hit Ctrl + C to quit the app.

Request for New Dataset

You can create a new issue and add the new dataset label to request for a new dataset. Please leave your comments, show me the link to the dataset you want to add, and provide some sample query and matched url items and @MacHu-GWU (me).

Request for Enterprise Support

findref works for enterprise internal dataset too. If you want a customized version to support your enterprise internal dataset, please follow the instruction in this ticket, our team will contact you soon.

Supported Dataset

🚀 Airflow Reference

https://asciinema.org/a/616811.svg

🚀 AWS CloudFormation Reference

todo

🚀 AWS boto3 Python SDK Reference

https://asciinema.org/a/616817.svg

🚀 AWS CDK Python Reference

https://asciinema.org/a/616818.svg

🚀 AWS CDK TypeScript Reference

https://asciinema.org/a/616819.svg

🚀 PySpark Reference

https://asciinema.org/a/616821.svg

🚀 Pandas Reference

todo

🚀 Terraform Reference

Support AWS, Azure, GCP.

https://asciinema.org/a/616822.svg

Install

findref is released on PyPI, so all you need is to:

# you need Python3.8+
$ pip install findref

To upgrade to latest version:

$ pip install --upgrade findref

Metadata

Release files for findref 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for findref 0.2.2
File Size Uploaded
findref-0.2.2.tar.gz 28.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for findref 0.2.2
File Interpreter ABI Platform
findref-0.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 52.0 kB

Release files / findref-0.2.2.tar.gz

Download URL findref-0.2.2.tar.gz
Size 28.4 kB
Tags Source
SHA-256 checksum
How to use checksums
b4203a92d2dac670779dbb858154d5f1dda50756b67d5f2e2abaf3e01dfc56e3
BLAKE2b-256 checksum
How to use checksums
f82b50164288a401669555f8cabacd3a3fee176afe036323b0d53ecc02e7e059
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.8.13

Release files / findref-0.2.2-py3-none-any.whl

Download URL findref-0.2.2-py3-none-any.whl
Size 23.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8a97f00825a17c97b259bd8aac41c621017530deb31d2cfc2619b28f7a20292d
BLAKE2b-256 checksum
How to use checksums
e95487e7ff4a45831a35cc7c39c4facb415183730cecc918c24ec8a13e48933a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.8.13

Release history Release notifications | RSS feed

This release

0.2.2 This release

2 release files

0.2.1

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page