{"id":1990844,"url":"https://github.com/stevearc/dql","last_synced_at":"2025-04-05T05:06:39.782Z","repository":{"id":12327392,"uuid":"14965189","full_name":"stevearc/dql","owner":"stevearc","description":"A SQL-ish language for DynamoDB","archived":false,"fork":false,"pushed_at":"2024-03-20T16:03:02.000Z","size":643,"stargazers_count":148,"open_issues_count":6,"forks_count":14,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-03-29T04:06:59.415Z","etag":null,"topics":["aws","dynamodb","python"],"latest_commit_sha":null,"homepage":"http://dql.readthedocs.org/","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/stevearc.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGES.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-12-05T20:41:05.000Z","updated_at":"2024-11-28T16:28:24.000Z","dependencies_parsed_at":"2024-06-18T18:30:27.185Z","dependency_job_id":"682031ce-0919-495f-bc02-d628a9436312","html_url":"https://github.com/stevearc/dql","commit_stats":{"total_commits":400,"total_committers":8,"mean_commits":50.0,"dds":0.4,"last_synced_commit":"9666cfba19773c20c7b4be29adc7d6179cf00d44"},"previous_names":[],"tags_count":41,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevearc%2Fdql","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevearc%2Fdql/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevearc%2Fdql/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevearc%2Fdql/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stevearc","download_url":"https://codeload.github.com/stevearc/dql/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247289427,"owners_count":20914464,"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":["aws","dynamodb","python"],"created_at":"2024-01-20T15:38:53.571Z","updated_at":"2025-04-05T05:06:39.754Z","avatar_url":"https://github.com/stevearc.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"DQL\n===\n:Build: |build|_ |coverage|_\n:Documentation: http://dql.readthedocs.org/\n:Downloads: http://pypi.python.org/pypi/dql\n:Source: https://github.com/stevearc/dql\n\n.. |build| image:: https://github.com/stevearc/dql/actions/workflows/code-workflows.yml/badge.svg\n.. _build: https://github.com/stevearc/dql/actions/workflows/code-workflows.yml\n.. |coverage| image:: https://coveralls.io/repos/stevearc/dql/badge.png?branch=master\n.. _coverage: https://coveralls.io/r/stevearc/dql?branch=master\n\nA simple, SQL-ish language for DynamoDB\n\nAs of November 2020, Amazon has released `PartiQL\nsupport \u003chttps://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.html\u003e`__\nfor DynamoDB. You should investigate that first to see if it addresses your\nneeds.\n\nGetting Started\n---------------\nInstallation can be done in a variety of ways\n\n* An executable `pex \u003chttps://github.com/pantsbuild/pex\u003e`__ file is available on `the release page \u003chttps://github.com/stevearc/dql/releases\u003e`__.\n* You can run a script to generate the pex file yourself: ``curl -o- install.py https://raw.githubusercontent.com/stevearc/dql/master/bin/install.py | python``\n* With pip: ``pip install dql``\n\nExamples\n--------\n\nHere are some basic DQL examples to get you going:\n\nStart the REPL::\n\n    $ dql\n    us-west-1\u003e\n\nCreating a table::\n\n    us-west-1\u003e CREATE TABLE forum_threads (name STRING HASH KEY,\n             \u003e                             subject STRING RANGE KEY,\n             \u003e                             THROUGHPUT (4, 2));\n\nInserting data::\n\n    us-west-1\u003e INSERT INTO forum_threads (name, subject, views, replies)\n             \u003e VALUES ('Self Defense', 'Defense from Banana', 67, 4),\n             \u003e ('Self Defense', 'Defense from Strawberry', 10, 0),\n             \u003e ('Cheese Shop', 'Anyone seen the camembert?', 16, 1);\n\nQueries::\n\n    us-west-1\u003e SCAN * FROM forum_threads;\n    us-west-1\u003e SELECT count(*) FROM forum_threads WHERE name = 'Self Defense';\n    us-west-1\u003e SELECT * FROM forum_threads WHERE name = 'Self Defense';\n\nMutations::\n\n    us-west-1\u003e UPDATE forum_threads ADD views 1 WHERE\n             \u003e name = 'Self Defense' AND subject = 'Defense from Banana';\n    us-west-1\u003e DELETE FROM forum_threads WHERE name = 'Cheese Shop';\n\nChanging tables::\n\n    us-west-1\u003e ALTER TABLE forum_threads SET THROUGHPUT (8, 4);\n    us-west-1\u003e DROP TABLE forum_threads;\n\nAnd don't forget to use ``help``!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstevearc%2Fdql","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstevearc%2Fdql","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstevearc%2Fdql/lists"}