{"id":17478140,"url":"https://github.com/jpetrucciani/qoo","last_synced_at":"2025-10-17T02:34:50.805Z","repository":{"id":52311889,"uuid":"198237048","full_name":"jpetrucciani/qoo","owner":"jpetrucciani","description":"A simple library for interacting with Amazon SQS. ","archived":false,"fork":false,"pushed_at":"2022-12-08T06:37:18.000Z","size":154,"stargazers_count":3,"open_issues_count":7,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-18T23:21:31.026Z","etag":null,"topics":["amazon-sqs","aws","boto","boto3","hacktoberfest","python","sqs"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jpetrucciani.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-07-22T14:13:46.000Z","updated_at":"2023-09-15T03:32:26.000Z","dependencies_parsed_at":"2022-08-27T21:01:10.329Z","dependency_job_id":null,"html_url":"https://github.com/jpetrucciani/qoo","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpetrucciani%2Fqoo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpetrucciani%2Fqoo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpetrucciani%2Fqoo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpetrucciani%2Fqoo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jpetrucciani","download_url":"https://codeload.github.com/jpetrucciani/qoo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250228696,"owners_count":21395958,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amazon-sqs","aws","boto","boto3","hacktoberfest","python","sqs"],"created_at":"2024-10-18T20:11:26.598Z","updated_at":"2025-10-17T02:34:50.662Z","avatar_url":"https://github.com/jpetrucciani.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![image](https://travis-ci.org/jpetrucciani/qoo.svg?branch=master)](https://travis-ci.org/jpetrucciani/qoo)\n[![PyPI\nversion](https://badge.fury.io/py/qoo.svg)](https://badge.fury.io/py/qoo)\n[![Code style:\nblack](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)\n[![Python 3.5+\nsupported](https://img.shields.io/badge/python-3.5+-blue.svg)](https://www.python.org/downloads/release/python-350/)\n[![Documentation style:\narchives](https://img.shields.io/badge/docstyle-archives-lightblue.svg)](https://github.com/jpetrucciani/archives)\n\n**qoo** is a very simple Amazon SQS client, written in Python. It aims\nto be much more straight-forward to use than boto3, and specializes only\nin Amazon SQS, ignoring the rest of the AWS ecosystem.\n\n# Features\n\n- Easier interaction with SQS queues\n- Automatic support for `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`,\n  and `AWS_DEFAULT_REGION` environment variables.\n- automatic useful message/job metadata\n\n# Usage\n\n## Installation\n\n```bash\npip install qoo\n```\n\n## Basic Usage\n\n```python\nimport qoo\n\n# list SQS queue names\nqoo.list_queues()\n\n# get an existing queue\nqueue = qoo.get(\"$QUEUE_NAME\")\n\n# or create a queue\nqueue = qoo.create(\"$QUEUE_NAME\")\n\n# send a job, pass info/keys as kwargs\nqueue.send(info=\"foo\", user_id=\"test_user\")  # etc.\n\n# get an approximate count of messages in the queue\nlen(queue)                # approximate total messages\nqueue.approx_not_visible  # approximate number of message in the visibility timeout\n\n# get a job\njob = queue.receive(wait_time=1)\njob.elapsed      # time between sending the job and receiving it\njob.md5_matches  # boolean property to show that the md5 of the job matches what was sent\n\n# and the data from the job is automatically converted into attrs\njob.info         # the string \"foo\"\njob.user_id      # the string \"test_user\"\n\n# delete the job from the SQS queue\njob.delete()\n```\n\n# Testing\n\nTests can be run with tox\\!\n\n```bash\n# run tests\ntox\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjpetrucciani%2Fqoo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjpetrucciani%2Fqoo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjpetrucciani%2Fqoo/lists"}