dynamodb-local 1.0.0__tar.gz

dynamodb_local-1.0.0/PKG-INFO

@@ -0,0 +1,55 @@
+Metadata-Version: 2.4
+Name: dynamodb-local
+Version: 1.0.0
+Summary: DynamoDB local downloader
+Author-email: Tim Heiko <175552092+timheiko@users.noreply.github.com>
+License: Apache-2.0 AND MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/x-rst
+
+=========================
+DynamoDB local downloader
+=========================
+
+Getting Started
+---------------
+
+1. Install the library
+
+.. code-block:: bash
+
+    % python3 -m pip install dynamodb_local
+
+2. Usage
+
+Non-async
+
+.. code-block:: python
+
+    from dynamodb_local import download_dynamodb
+    ...
+    dynamodb_local_jar_path = download_dynamodb()
+
+Async
+
+.. code-block:: python
+
+   from dynamodb_local import download_dynamodb_async
+   ...
+   dynamodb_local_jar_path = await download_dynamodb_async()
+
+Features
+--------
+* Downloads `DynamoDB local <https://d1ni2b6xgvw0s0.cloudfront.net/v2.x/dynamodb_local_latest.tar.gz>`_ archive and unpacks it to a given parent directory.
+* Prevents redundant downloading of `DynamoDB local <https://d1ni2b6xgvw0s0.cloudfront.net/v2.x/dynamodb_local_latest.tar.gz>`_ on every run by verifying the downloaded local version against its `sha256 digest <https://d1ni2b6xgvw0s0.cloudfront.net/v2.x/dynamodb_local_latest.tar.gz.sha256>`_.
+* No external dependencies.
+
+Notes
+-----
+* This library does not Starting the `DynamoDB local <https://d1ni2b6xgvw0s0.cloudfront.net/v2.x/dynamodb_local_latest.tar.gz>`_ it downloaded and unpacked.
+* Starting the actual DynamoDB lolal process requieres a JRE or JDK.
+
+
+Credits
+-------
+* `DynamoDBLocal Deploying DynamoDB locally on your computer <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.DownloadingAndRunning.html#DynamoDBLocal.DownloadingAndRunning.title>`_.

dynamodb_local-1.0.0/README.rst

@@ -0,0 +1,46 @@
+=========================
+DynamoDB local downloader
+=========================
+
+Getting Started
+---------------
+
+1. Install the library
+
+.. code-block:: bash
+
+    % python3 -m pip install dynamodb_local
+
+2. Usage
+
+Non-async
+
+.. code-block:: python
+
+    from dynamodb_local import download_dynamodb
+    ...
+    dynamodb_local_jar_path = download_dynamodb()
+
+Async
+
+.. code-block:: python
+
+   from dynamodb_local import download_dynamodb_async
+   ...
+   dynamodb_local_jar_path = await download_dynamodb_async()
+
+Features
+--------
+* Downloads `DynamoDB local <https://d1ni2b6xgvw0s0.cloudfront.net/v2.x/dynamodb_local_latest.tar.gz>`_ archive and unpacks it to a given parent directory.
+* Prevents redundant downloading of `DynamoDB local <https://d1ni2b6xgvw0s0.cloudfront.net/v2.x/dynamodb_local_latest.tar.gz>`_ on every run by verifying the downloaded local version against its `sha256 digest <https://d1ni2b6xgvw0s0.cloudfront.net/v2.x/dynamodb_local_latest.tar.gz.sha256>`_.
+* No external dependencies.
+
+Notes
+-----
+* This library does not Starting the `DynamoDB local <https://d1ni2b6xgvw0s0.cloudfront.net/v2.x/dynamodb_local_latest.tar.gz>`_ it downloaded and unpacked.
+* Starting the actual DynamoDB lolal process requieres a JRE or JDK.
+
+
+Credits
+-------
+* `DynamoDBLocal Deploying DynamoDB locally on your computer <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.DownloadingAndRunning.html#DynamoDBLocal.DownloadingAndRunning.title>`_.

dynamodb_local-1.0.0/pyproject.toml

@@ -0,0 +1,15 @@
+[project]
+description = "DynamoDB local downloader"
+name = "dynamodb-local"
+license = {text = "Apache-2.0 AND MIT"}
+authors = [
+  {name = "Tim Heiko", email = "175552092+timheiko@users.noreply.github.com"},
+]
+requires-python = ">= 3.10"
+readme = "README.rst"
+dynamic = [
+  "version",
+]
+
+[tool.setuptools.dynamic]
+version = {attr = "dynamodb_local.__version__"}

dynamodb_local-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

dynamodb_local-1.0.0/src/dynamodb_local/__init__.py

@@ -0,0 +1,77 @@
+#!/usr/bin/env python3
+
+import asyncio
+from urllib import request
+import shutil
+from pathlib import Path
+from os import makedirs, path
+from hashlib import sha256
+
+from logging import getLogger
+
+__version__ = "1.0.0"
+
+# https://pypi.org/project/pytest-dynamodb/
+DYNAMODB_LOCAL_DIR = Path("tmp/dynamodb")
+
+logger = getLogger(__name__)
+
+
+def download_dynamodb(parent_dir: Path = DYNAMODB_LOCAL_DIR) -> None:
+    tar_gz_url = (
+        "https://d1ni2b6xgvw0s0.cloudfront.net/v2.x/dynamodb_local_latest.tar.gz"
+    )
+    sha256_url = (
+        "https://d1ni2b6xgvw0s0.cloudfront.net/v2.x/dynamodb_local_latest.tar.gz.sha256"
+    )
+    tar_gz_filepath = parent_dir / "dynamodb.tar.gz"
+    sha256_filepath = parent_dir / "dynamodb_local_latest.tar.gz.sha256"
+    jar_file_name = "DynamoDBLocal.jar"
+
+    if not check_sha26(
+        tar_gz_filepath=tar_gz_filepath, sha256_filepath=sha256_filepath
+    ):
+        if path.exists(parent_dir):
+            logger.debug(f"Cleaning up {parent_dir}")
+            shutil.rmtree(parent_dir)
+
+        logger.debug(f"Creating {parent_dir}")
+        makedirs(parent_dir)
+
+        logger.debug(f"Downloading DynamodDB to {parent_dir}")
+        request.urlretrieve(tar_gz_url, tar_gz_filepath)
+        shutil.unpack_archive(tar_gz_filepath, parent_dir)
+        request.urlretrieve(sha256_url, sha256_filepath)
+
+    return parent_dir / jar_file_name
+
+
+def check_sha26(tar_gz_filepath: Path, sha256_filepath: Path) -> bool:
+    if path.exists(tar_gz_filepath) and path.exists(sha256_filepath):
+        logger.debug(
+            f"Checking SHA256 of DynamoDB local archive: {sha256_filepath} {tar_gz_filepath}"
+        )
+        sha256_hash = sha256()
+        with open(file=tar_gz_filepath, mode="rb") as file:
+            for block in iter(lambda: file.read(4_096), b""):
+                sha256_hash.update(block)
+
+        sha256_digest = sha256_hash.hexdigest()
+
+        with open(file=sha256_filepath, mode="r") as file:
+            expected_sha256_digest = file.readline().strip().split()[0]
+            return sha256_digest == expected_sha256_digest
+
+    return False
+
+
+async def download_dynamodb_async(
+    parent_dir: Path = DYNAMODB_LOCAL_DIR,
+    event_loop: "asyncio.EventLoop" = None,
+):
+    event_loop = event_loop or asyncio.get_running_loop()
+    return await event_loop.run_in_executor(None, download_dynamodb, parent_dir)
+
+
+if __name__ == "__main__":
+    download_dynamodb_local()

dynamodb_local-1.0.0/src/dynamodb_local/tests/test_dynamodb_local.py

@@ -0,0 +1,54 @@
+import pytest
+from dynamodb_local import download_dynamodb, download_dynamodb_async
+from tempfile import TemporaryDirectory, mkdtemp
+from pathlib import Path
+from time import perf_counter
+
+
+@pytest.fixture
+def temp_directory() -> Path:
+    tmpdirectory = TemporaryDirectory(prefix="dynamodb_local_")
+
+    yield Path(tmpdirectory.name)
+
+    return tmpdirectory.cleanup()
+
+
+def test_download_dynamodb_fresh(temp_directory: Path):
+    assert (
+        download_dynamodb(parent_dir=temp_directory)
+        == temp_directory / "DynamoDBLocal.jar"
+    )
+
+
+def test_download_dynamodb_cached(temp_directory: Path):
+    download_dynamodb(parent_dir=temp_directory)
+
+    t0 = perf_counter()
+    assert (
+        download_dynamodb(parent_dir=temp_directory)
+        == temp_directory / "DynamoDBLocal.jar"
+    )
+    t1 = perf_counter()
+    assert t1 - t0 < 1.0
+
+
+@pytest.mark.asyncio
+async def test_download_dynamodb_async_fresh(temp_directory: Path):
+    assert (
+        await download_dynamodb_async(parent_dir=temp_directory)
+        == temp_directory / "DynamoDBLocal.jar"
+    )
+
+
+@pytest.mark.asyncio
+async def test_download_dynamodb_async_cached(temp_directory: Path):
+    await download_dynamodb_async(parent_dir=temp_directory)
+
+    t0 = perf_counter()
+    assert (
+        await download_dynamodb_async(parent_dir=temp_directory)
+        == temp_directory / "DynamoDBLocal.jar"
+    )
+    t1 = perf_counter()
+    assert t1 - t0 < 1.0

dynamodb_local-1.0.0/src/dynamodb_local.egg-info/PKG-INFO

@@ -0,0 +1,55 @@
+Metadata-Version: 2.4
+Name: dynamodb-local
+Version: 1.0.0
+Summary: DynamoDB local downloader
+Author-email: Tim Heiko <175552092+timheiko@users.noreply.github.com>
+License: Apache-2.0 AND MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/x-rst
+
+=========================
+DynamoDB local downloader
+=========================
+
+Getting Started
+---------------
+
+1. Install the library
+
+.. code-block:: bash
+
+    % python3 -m pip install dynamodb_local
+
+2. Usage
+
+Non-async
+
+.. code-block:: python
+
+    from dynamodb_local import download_dynamodb
+    ...
+    dynamodb_local_jar_path = download_dynamodb()
+
+Async
+
+.. code-block:: python
+
+   from dynamodb_local import download_dynamodb_async
+   ...
+   dynamodb_local_jar_path = await download_dynamodb_async()
+
+Features
+--------
+* Downloads `DynamoDB local <https://d1ni2b6xgvw0s0.cloudfront.net/v2.x/dynamodb_local_latest.tar.gz>`_ archive and unpacks it to a given parent directory.
+* Prevents redundant downloading of `DynamoDB local <https://d1ni2b6xgvw0s0.cloudfront.net/v2.x/dynamodb_local_latest.tar.gz>`_ on every run by verifying the downloaded local version against its `sha256 digest <https://d1ni2b6xgvw0s0.cloudfront.net/v2.x/dynamodb_local_latest.tar.gz.sha256>`_.
+* No external dependencies.
+
+Notes
+-----
+* This library does not Starting the `DynamoDB local <https://d1ni2b6xgvw0s0.cloudfront.net/v2.x/dynamodb_local_latest.tar.gz>`_ it downloaded and unpacked.
+* Starting the actual DynamoDB lolal process requieres a JRE or JDK.
+
+
+Credits
+-------
+* `DynamoDBLocal Deploying DynamoDB locally on your computer <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.DownloadingAndRunning.html#DynamoDBLocal.DownloadingAndRunning.title>`_.

dynamodb_local-1.0.0/src/dynamodb_local.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.rst
+pyproject.toml
+src/dynamodb_local/__init__.py
+src/dynamodb_local.egg-info/PKG-INFO
+src/dynamodb_local.egg-info/SOURCES.txt
+src/dynamodb_local.egg-info/dependency_links.txt
+src/dynamodb_local.egg-info/top_level.txt
+src/dynamodb_local/tests/__init__.py
+src/dynamodb_local/tests/test_dynamodb_local.py

dynamodb_local-1.0.0/src/dynamodb_local.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dynamodb_local-1.0.0/src/dynamodb_local.egg-info/top_level.txt

@@ -0,0 +1 @@
+dynamodb_local