eoapi-cdk 5.0.0__tar.gz

eoapi-cdk-5.0.0/LICENSE

@@ -0,0 +1,8 @@
+ISC License:
+
+Copyright (c) 2004-2010 by Internet Systems Consortium, Inc. ("ISC")
+Copyright (c) 1995-2003 by Internet Software Consortium
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

eoapi-cdk-5.0.0/MANIFEST.in

@@ -0,0 +1 @@
+include pyproject.toml

eoapi-cdk-5.0.0/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.1
+Name: eoapi-cdk
+Version: 5.0.0
+Summary: A set of constructs deploying pgSTAC with CDK
+Home-page: https://github.com/developmentseed/eoapi-cdk.git
+Author: Anthony Lukach<anthony@developmentseed.org>
+License: ISC
+Project-URL: Source, https://github.com/developmentseed/eoapi-cdk.git
+Platform: UNKNOWN
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: JavaScript
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Typing :: Typed
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved
+Requires-Python: ~=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# eoAPI CDK Constructs
+
+eoapi-cdk is a package of [AWS CDK constructs](https://docs.aws.amazon.com/prescriptive-guidance/latest/best-practices-cdk-typescript-iac/constructs-best-practices.html) designed to encapsulate eoAPI services and best practices as simple reusable components.
+
+For more background on the included services see [The Earth Observation API](https://eoapi.dev/)
+
+## Included constructs
+
+Detailed API docs for the constructs can be found [here](https://developmentseed.org/eoapi-cdk/).
+
+### [pgSTAC Database](https://developmentseed.org/eoapi-cdk/#pgstacdatabase-)
+
+An [RDS](https://aws.amazon.com/rds/) instance with [pgSTAC](https://github.com/stac-utils/pgstac) installed and the Postgres parameters optimized for the selected instance type.
+
+### [STAC API](https://developmentseed.org/eoapi-cdk/#pgstacapilambda-)
+
+A STAC API implementation using [stac-fastapi](https://github.com/stac-utils/stac-fastapi) with a [pgSTAC backend](https://github.com/stac-utils/stac-fastapi-pgstac). Packaged as a complete runtime for deployment with API Gateway and Lambda.
+
+### [pgSTAC Titiler API](https://developmentseed.org/eoapi-cdk/#titilerpgstacapilambda-)
+
+A complete dynamic tiling API using [titiler-pgstac](https://github.com/stac-utils/titiler-pgstac) to create dynamic mosaics of assets based on [STAC Search queries](https://github.com/radiantearth/stac-api-spec/tree/master/item-search).  Packaged as a complete runtime for deployment with API Gateway and Lambda and fully integrated with the pgSTAC Database construct.
+
+### [STAC Ingestor](https://developmentseed.org/eoapi-cdk/#stacingestor-)
+
+An API for large scale STAC data ingestion and validation into a pgSTAC instance.
+
+![ingestor](/diagrams/ingestor_diagram.png)
+
+Authentication for the STAC Ingestor API can be configured with JWTs authenticated by JWKS.  To learn more about securing FastAPI applications with this approach see [Securing FastAPI with JWKS (AWS Cognito, Auth0)](https://alukach.com/posts/fastapi-rs256-jwt/).
+
+A sample Cognito-based authentication system is available at [aws-asdi-auth](https://github.com/developmentseed/aws-asdi-auth).
+
+### [Bastion Host](https://developmentseed.org/eoapi-cdk/#bastionhost-)
+
+A bastion host is a secure gateway that provides access to resources in a private subnet.  In this case it provides the ability to make administrative connections to eoAPI's pgSTAC instance.
+
+![Alt text](/diagrams/bastion_diagram.png)
+
+For more background on bastion hosts in AWS see [this article](https://dev.to/aws-builders/bastion-host-in-aws-vpc-2i63).
+
+And for configuration instructions for this construct see [the docs](https://developmentseed.org/eoapi-cdk/#bastionhost-).
+
+## Published Packages
+
+* https://pypi.org/project/eoapi-cdk/
+* https://www.npmjs.com/package/eoapi-cdk/
+
+## Release
+
+Versioning is automatically handled via [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) and [Semantic Release](https://semantic-release.gitbook.io/semantic-release/).
+
+*Warning*: If you rebase `main`, you must ensure that the commits referenced by tags point to commits that are within the `main` branch. If a commit references a commit that is no longer on the `main` branch, Semantic Release will fail to detect the correct version of the project. [More information](https://github.com/semantic-release/semantic-release/issues/1121#issuecomment-517945233).
+
+

eoapi-cdk-5.0.0/README.md

@@ -0,0 +1,52 @@
+# eoAPI CDK Constructs
+
+eoapi-cdk is a package of [AWS CDK constructs](https://docs.aws.amazon.com/prescriptive-guidance/latest/best-practices-cdk-typescript-iac/constructs-best-practices.html) designed to encapsulate eoAPI services and best practices as simple reusable components.
+
+For more background on the included services see [The Earth Observation API](https://eoapi.dev/)
+
+## Included constructs
+
+Detailed API docs for the constructs can be found [here](https://developmentseed.org/eoapi-cdk/).
+
+### [pgSTAC Database](https://developmentseed.org/eoapi-cdk/#pgstacdatabase-)
+
+An [RDS](https://aws.amazon.com/rds/) instance with [pgSTAC](https://github.com/stac-utils/pgstac) installed and the Postgres parameters optimized for the selected instance type.
+
+### [STAC API](https://developmentseed.org/eoapi-cdk/#pgstacapilambda-)
+
+A STAC API implementation using [stac-fastapi](https://github.com/stac-utils/stac-fastapi) with a [pgSTAC backend](https://github.com/stac-utils/stac-fastapi-pgstac). Packaged as a complete runtime for deployment with API Gateway and Lambda.
+
+### [pgSTAC Titiler API](https://developmentseed.org/eoapi-cdk/#titilerpgstacapilambda-)
+
+A complete dynamic tiling API using [titiler-pgstac](https://github.com/stac-utils/titiler-pgstac) to create dynamic mosaics of assets based on [STAC Search queries](https://github.com/radiantearth/stac-api-spec/tree/master/item-search).  Packaged as a complete runtime for deployment with API Gateway and Lambda and fully integrated with the pgSTAC Database construct.
+
+### [STAC Ingestor](https://developmentseed.org/eoapi-cdk/#stacingestor-)
+
+An API for large scale STAC data ingestion and validation into a pgSTAC instance.
+
+![ingestor](/diagrams/ingestor_diagram.png)
+
+Authentication for the STAC Ingestor API can be configured with JWTs authenticated by JWKS.  To learn more about securing FastAPI applications with this approach see [Securing FastAPI with JWKS (AWS Cognito, Auth0)](https://alukach.com/posts/fastapi-rs256-jwt/).
+
+A sample Cognito-based authentication system is available at [aws-asdi-auth](https://github.com/developmentseed/aws-asdi-auth).
+
+### [Bastion Host](https://developmentseed.org/eoapi-cdk/#bastionhost-)
+
+A bastion host is a secure gateway that provides access to resources in a private subnet.  In this case it provides the ability to make administrative connections to eoAPI's pgSTAC instance.
+
+![Alt text](/diagrams/bastion_diagram.png)
+
+For more background on bastion hosts in AWS see [this article](https://dev.to/aws-builders/bastion-host-in-aws-vpc-2i63).
+
+And for configuration instructions for this construct see [the docs](https://developmentseed.org/eoapi-cdk/#bastionhost-).
+
+## Published Packages
+
+* https://pypi.org/project/eoapi-cdk/
+* https://www.npmjs.com/package/eoapi-cdk/
+
+## Release
+
+Versioning is automatically handled via [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) and [Semantic Release](https://semantic-release.gitbook.io/semantic-release/).
+
+*Warning*: If you rebase `main`, you must ensure that the commits referenced by tags point to commits that are within the `main` branch. If a commit references a commit that is no longer on the `main` branch, Semantic Release will fail to detect the correct version of the project. [More information](https://github.com/semantic-release/semantic-release/issues/1121#issuecomment-517945233).

eoapi-cdk-5.0.0/pyproject.toml

@@ -0,0 +1,9 @@
+[build-system]
+requires = ["setuptools~=62.1.0", "wheel~=0.37.1"]
+build-backend = "setuptools.build_meta"
+
+[tool.pyright]
+defineConstant = { DEBUG = true }
+pythonVersion = "3.7"
+pythonPlatform = "All"
+reportSelfClsParameterName = false

eoapi-cdk-5.0.0/setup.cfg

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

eoapi-cdk-5.0.0/setup.py

@@ -0,0 +1,67 @@
+import json
+import setuptools
+
+kwargs = json.loads(
+    """
+{
+    "name": "eoapi-cdk",
+    "version": "5.0.0",
+    "description": "A set of constructs deploying pgSTAC with CDK",
+    "license": "ISC",
+    "url": "https://github.com/developmentseed/eoapi-cdk.git",
+    "long_description_content_type": "text/markdown",
+    "author": "Anthony Lukach<anthony@developmentseed.org>",
+    "bdist_wheel": {
+        "universal": true
+    },
+    "project_urls": {
+        "Source": "https://github.com/developmentseed/eoapi-cdk.git"
+    },
+    "package_dir": {
+        "": "src"
+    },
+    "packages": [
+        "eoapi_cdk",
+        "eoapi_cdk._jsii"
+    ],
+    "package_data": {
+        "eoapi_cdk._jsii": [
+            "eoapi-cdk@5.0.0.jsii.tgz"
+        ],
+        "eoapi_cdk": [
+            "py.typed"
+        ]
+    },
+    "python_requires": "~=3.7",
+    "install_requires": [
+        "aws-cdk-lib>=2.75.0, <3.0.0",
+        "aws-cdk.aws-apigatewayv2-integrations-alpha>=2.47.0.a0, <3.0.0",
+        "aws-cdk.aws-lambda-python-alpha>=2.47.0.a0, <3.0.0",
+        "constructs>=10.1.113, <11.0.0",
+        "jsii>=1.69.0, <2.0.0",
+        "publication>=0.0.3",
+        "typeguard~=2.13.3"
+    ],
+    "classifiers": [
+        "Intended Audience :: Developers",
+        "Operating System :: OS Independent",
+        "Programming Language :: JavaScript",
+        "Programming Language :: Python :: 3 :: Only",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Typing :: Typed",
+        "Development Status :: 4 - Beta",
+        "License :: OSI Approved"
+    ],
+    "scripts": []
+}
+"""
+)
+
+with open("README.md", encoding="utf8") as fp:
+    kwargs["long_description"] = fp.read()
+
+
+setuptools.setup(**kwargs)