Metadata-Version: 2.4
Name: sqs-list-filled-queues
Version: 0.2
Summary: A Python script to monitor and list Amazon SQS queues with messages, featuring real-time updates and AWS console links.
Home-page: https://github.com/baztian/sqs-list-filled-queues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: boto3
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: summary

# SQS List Filled Queues

A Python script that lists Amazon SQS queues containing messages and updates the display periodically. This tool leverages the `boto3` library to interact with AWS SQS, making it easy to monitor your message queues.

## Features

- Lists all SQS queues with at least one message.
- Displays the number of messages in each queue.
- Provides direct links to the AWS SQS console for each queue.
- Supports periodic updates to refresh the displayed information.
- Configurable number of worker threads for fetching queue information.

## Prerequisites

- Python 3.x
- AWS credentials configured (via environment variables, AWS config file, or IAM roles).

## Usage

You can run the script directly from the command line. Here are some usage examples:

- To list queues and display results once:

   sqs-list-filled-queues

- To watch the queues and refresh every 60 seconds:

   sqs-list-filled-queues --watch

- To specify a custom refresh interval (e.g., 30 seconds):

   sqs-list-filled-queues --watch 30

- To adjust the number of worker threads (e.g., 8):

   sqs-list-filled-queues --workers 8

### Controls During Watching

- Press `R` to force a refresh.
- Press `Q` to quit the program.

## Example Output

    Reading list of queues...Processed 5 out of 10 queues...
    QueueName1: 12 msgs
        https://console.aws.amazon.com/sqs/v2/home?region=us-west-2#/queues/QueueName1
    QueueName2: 5 msgs
        https://console.aws.amazon.com/sqs/v2/home?region=us-west-2#/queues/QueueName2
    ...

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
