Metadata-Version: 2.1
Name: aws-resource-search
Version: 0.2.1
Summary: A terminal application that enables interactive searches for AWS resources. It is a mini AWS console in your terminal or shell environment.
Home-page: https://github.com/MacHu-GWU/aws_resource_search-project
Download-URL: https://pypi.python.org/pypi/aws_resource_search/0.2.1#downloads
Author: Sanhe Hu
Author-email: husanhe@gmail.com
Maintainer: Sanhe Hu
Maintainer-email: husanhe@gmail.com
License: GPL
Platform: Windows
Platform: MacOS
Platform: Unix
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Natural Language :: English
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3 :: Only
License-File: LICENSE.txt
License-File: AUTHORS.rst
Requires-Dist: pathlib-mate <2.0.0,>=1.2.1
Requires-Dist: iterproxy <1.0.0,>=0.3.1
Requires-Dist: sayt <1.0.0,>=0.6.5
Requires-Dist: boto-session-manager >=1.5.4
Requires-Dist: aws-console-url <2.0.0,>=1.3.2
Requires-Dist: aws-arns <2.0.0,>=1.4.3
Requires-Dist: jmespath >=1.0.1
Requires-Dist: zelfred ==0.2.4
Requires-Dist: pyperclip <2.0.0,>=1.8.2
Requires-Dist: fire <1.0.0,>=0.1.3
Requires-Dist: awscli-mate ==1.0.1
Requires-Dist: cached-property >=1.5.2 ; python_version < "3.8"
Requires-Dist: typing-extensions <4.7.0,>=4.6.0 ; python_version < "3.8"
Provides-Extra: docs
Requires-Dist: Sphinx ==5.3.0 ; extra == 'docs'
Requires-Dist: sphinx-jinja ==2.0.2 ; extra == 'docs'
Requires-Dist: sphinx-copybutton ==0.5.1 ; extra == 'docs'
Requires-Dist: sphinx-design ==0.5.0 ; extra == 'docs'
Requires-Dist: furo ==2023.03.27 ; extra == 'docs'
Requires-Dist: nbsphinx ==0.8.12 ; extra == 'docs'
Requires-Dist: rstobj ==1.2.1 ; extra == 'docs'
Requires-Dist: pygments ==2.15.1 ; extra == 'docs'
Requires-Dist: ipython ==8.10.0 ; extra == 'docs'
Requires-Dist: docfly ==2.0.1 ; extra == 'docs'
Provides-Extra: tests
Requires-Dist: pytest ; extra == 'tests'
Requires-Dist: pytest-cov ; extra == 'tests'
Requires-Dist: moto ; extra == 'tests'
Requires-Dist: moto[sts] ; extra == 'tests'
Requires-Dist: moto[cloudformation] ; extra == 'tests'
Requires-Dist: moto[dynamodb] ; extra == 'tests'
Requires-Dist: moto[iam] ; extra == 'tests'
Requires-Dist: moto[s3] ; extra == 'tests'
Requires-Dist: fixa <1.0.0,>=0.10.2 ; extra == 'tests'
Requires-Dist: Faker ; extra == 'tests'
Requires-Dist: rich ; extra == 'tests'


.. 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

.. image:: https://img.shields.io/badge/Link-Request_Feature-blue.svg
    :target: https://github.com/MacHu-GWU/aws_resource_search-project/issues

.. 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 <https://ars.readthedocs.io/en/latest/index.html>`_

**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
