https://github.com/machu-gwu/aws_resource_search-project
A terminal application that enables interactive searches for AWS resources. It is a mini AWS console in your terminal or shell environment.
https://github.com/machu-gwu/aws_resource_search-project
aws console full-text-search fuzzy-search python search terminal
Last synced: 7 months ago
JSON representation
A terminal application that enables interactive searches for AWS resources. It is a mini AWS console in your terminal or shell environment.
- Host: GitHub
- URL: https://github.com/machu-gwu/aws_resource_search-project
- Owner: MacHu-GWU
- License: gpl-2.0
- Created: 2023-04-02T05:20:50.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-01-24T17:32:21.000Z (over 1 year ago)
- Last Synced: 2024-05-02T06:01:00.262Z (over 1 year ago)
- Topics: aws, console, full-text-search, fuzzy-search, python, search, terminal
- Language: Python
- Homepage:
- Size: 816 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: LICENSE.txt
- Authors: AUTHORS.rst
Awesome Lists containing this project
README
.. image:: https://readthedocs.org/projects/ars/badge/?version=latest
:target: https://ars.readthedocs.io/en/latest/index.html
:alt: Documentation Status
.. image:: https://github.com/MacHu-GWU/aws_resource_search-project/workflows/CI/badge.svg
:target: https://github.com/MacHu-GWU/aws_resource_search-project/actions?query=workflow:CI
.. image:: https://codecov.io/gh/MacHu-GWU/aws_resource_search-project/branch/main/graph/badge.svg
:target: https://codecov.io/gh/MacHu-GWU/aws_resource_search-project
.. image:: https://img.shields.io/pypi/v/aws_resource_search.svg
:target: https://pypi.python.org/pypi/aws_resource_search
.. image:: https://img.shields.io/pypi/l/aws_resource_search.svg
:target: https://pypi.python.org/pypi/aws_resource_search
.. image:: https://img.shields.io/pypi/pyversions/aws_resource_search.svg
:target: https://pypi.python.org/pypi/aws_resource_search
.. image:: https://img.shields.io/badge/Release_History!--None.svg?style=social
:target: https://github.com/MacHu-GWU/aws_resource_search-project/blob/main/release-history.rst
.. image:: https://img.shields.io/badge/STAR_Me_on_GitHub!--None.svg?style=social
:target: https://github.com/MacHu-GWU/aws_resource_search-project
------
.. image:: https://img.shields.io/badge/Link-Document-blue.svg
:target: https://ars.readthedocs.io/en/latest/index.html
.. image:: https://img.shields.io/badge/Link-API-blue.svg
:target: https://ars.readthedocs.io/en/latest/py-modindex.html
.. image:: https://img.shields.io/badge/Link-Source_Code-blue.svg
:target: https://ars.readthedocs.io/en/latest/py-modindex.html
.. image:: https://img.shields.io/badge/Link-Install-blue.svg
:target: `install`_
.. image:: https://img.shields.io/badge/Link-GitHub-blue.svg
:target: https://github.com/MacHu-GWU/aws_resource_search-project
.. image:: https://img.shields.io/badge/Link-Submit_Issue-blue.svg
:target: https://github.com/MacHu-GWU/aws_resource_search-project/issues/new/choose
.. image:: https://img.shields.io/badge/Link-Request_Feature-blue.svg
:target: https://github.com/MacHu-GWU/aws_resource_search-project/issues/new/choose
.. image:: https://img.shields.io/badge/Link-Download-blue.svg
:target: https://pypi.org/pypi/aws_resource_search#files
Welcome to ``aws_resource_search`` Documentation
==============================================================================
.. image:: https://ars.readthedocs.io/en/latest/_static/aws_resource_search-logo.png
:target: https://ars.readthedocs.io/en/latest/index.html
:align: center
:width: 256px
📙 `Full Documentation HERE `_
**AWS Resource Search (ARS)** is a terminal application that enables interactive searches for AWS resources. It is a mini AWS console in your terminal or shell environment.
It utilizes advanced indexing techniques that support ``full-text search`` (any word, no longer restricted to prefix or suffix matching), ``fuzzy search`` (tolerating spelling mistakes), and ``n-gram`` search (allowing matching of series of n adjacent characters).
ARS comes with built-in query caching, ensuring ``blazing-fast performance`` even when dealing with a large number of AWS resources such as IAM roles, Lambda Functions, CloudFormation stacks, and more.
As a Python library, installation is as simple as running ``pip install aws_resource_search``. There's no need to set up databases, additional search tools, or install any other software.
The data stays on your laptop, there's no remote server involved.
The **open-source Community Edition** of ARS allows searching within a single AWS Account and one AWS region at a time. You can switch between different AWS accounts before conducting your searches. On the other hand, the **Enterprise Edition** of ARS offers the capability to search across multiple AWS accounts and AWS regions, providing an aggregated view. Currently, the enterprise version is in beta and is expected to become generally available in early 2024."
Demo
------------------------------------------------------------------------------
Search S3 Bucket.
.. image:: https://asciinema.org/a/618423.svg
:target: https://asciinema.org/a/618423
Search StepFunction execution, which is a child resource of StepFunction state machine.
.. image:: https://asciinema.org/a/618428.svg
:target: https://asciinema.org/a/618428
.. _install:
Install
------------------------------------------------------------------------------
``aws_resource_search`` is released on PyPI, so all you need is:
.. code-block:: console
$ pip install aws_resource_search
To upgrade to latest version:
.. code-block:: console
$ pip install --upgrade aws_resource_search