cloudsearch

What it is and what it does

Cloudsearch is a thin Python wrapper around AWS CloudSearch that handles query construction and result parsing. It takes a search term, credentials, and a CloudSearch endpoint URL, then returns results either as raw dictionaries or as a pandas DataFrame via the sortedSearch() method. The wrapper supports query options like field boosting and filter queries to refine results.

The package depends on boto3 for AWS interaction and pandas for DataFrame output. It's designed for developers who want to query CloudSearch without writing low-level AWS API calls directly. However, the project has been abandoned since April 2021 and may not be compatible with current versions of its dependencies or recent CloudSearch API changes.

Use it for:

• Query an AWS CloudSearch domain and retrieve results as a pandas DataFrame for analysis or export.
• Boost specific fields in CloudSearch queries to prioritize certain attributes in search rankings.
• Apply filter queries to narrow CloudSearch results by category or other structured fields.
• Prototype or script CloudSearch interactions without writing raw boto3 CloudSearch API calls.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Wrapper for AWS CloudSearch that simplifies querying and returns results as pandas DataFrames, with support for filtering and field boosting.

No. The package is abandoned (last release 2021-04-20) and offers only a thin convenience wrapper around boto3 CloudSearch calls. For new projects, call boto3's CloudSearch client directly or use a maintained alternative. For existing code already using this package, consider migrating to direct boto3 calls to avoid potential compatibility issues as dependencies and AWS APIs evolve.

Install

cloudsearch on PyPI

pip install cloudsearch

uv add cloudsearch

poetry add cloudsearch

Installing cloudsearch

Before you install

Low install friction with only two runtime dependencies (boto3 and pandas). However, the package is abandoned—last release was 2021-04-20, over 1942 days ago. No recent maintenance or updates.

License in practice

Licensed under Apache Software License 2.0 (permissive), so you can use, modify, and distribute it freely with minimal restrictions.

Quickstart

pip install cloudsearch

from cloudsearch.cloudsearch import Search
searcher = Search(searchTerm='banana', key=USER, pw=PW, endpoint=searchEndpoint)
result = searcher.search(size=1000)
print(f'found {len(list(result))} results')

Requires valid AWS CloudSearch endpoint URL, credentials (key and password), and an active CloudSearch domain.

Verify before relying

• Whether the package works with modern versions of boto3 and pandas given its 1942-day age since last release.
• Current compatibility with Python 3.9+ (package declares support only through 3.8).
• Whether AWS CloudSearch API changes since 2021 have broken the wrapper's functionality.

Package facts

Evidence: cloudsearch-0.0.12-py3-none-any.whl

Keywords: cloudsearch, sdk

Tags

More Front-Ends packages