Release v0.0.2

Author: giograno

Makefile

@@ -19,6 +19,7 @@ build-spec:			## build the entire localstack api spec (openapi.yaml in the root
 
 clean:         		## Clean up the virtual environment
 	rm -rf $(VENV_DIR)
+	rm -rf dist/
 
 clean-generated:	## Cleanup generated code
 	rm -rf packages/localstack-sdk-generated/localstack/

README.md

@@ -1,42 +1,26 @@
 # LocalStack Python SDK
 
-This repository is a PoC for generating a Python SDK for the LocalStack public endpoint.
-
-### Generate the spec
-
-The first step is to generate the `openapi.yaml` spec.
-We have a script in `scripts/create_spec.py`
-- [ ] todo: fix the script; make sure it also fetches ext spec;
-`localstack-core` and `localstack-ext` are part of the dev dependencies for this very step.
-
-### Generate the code
-We use openapi-generator from `openapitools`.
-To run the generation, run `./bin/generate.sh`.
-The script uses the docker image of the CLI and use the `openapi.yaml` file as input.
-By default, the generator creates a bunch of files, but the most important things are:
-- `api` package: with the all APIs categorized by tags;
-- `models` package: with the methods derived from the components or the inline specs;
-- [ ] the code from the inline components is much uglier, but we can overwrite some naming with come config (or move to components).
-
-The python generator by default creates 3 functions for each path:
-- a normal function (the name is taken from the `operationId` in the specs) just with the validated response payload;
-- a function suffixed by `without_preloaded_content`: where the JSON responses are not validated;
-- a function suffixed by `with_http_info` which also returns the response header and status.
-
-The code in these `api` files (but also in any other generated artifacts), can be modified by providing custom mustache templates.
-[These](https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator/src/main/resources/python) are the
-default for Python.
-Templates are not super immediate, but looking at them and at the generated code you can do it.
-For instance, I deleted the `without_preloaded_content` and `with_http_info` generated functions.
-
-### Supporting files
-The generated code uses some supporting files, i.e., some utilities that are responsible of making the actual HTTP calls,
-validating and parsing the responses.
-I just checked in this code and take it as granted, but I am pretty sure we can come up with some simpler code and avoid
-to generate this part (would move out from `generated`).
-- [ ] see if I can write my own api client and all the necessary supporting code.
-
-### TODO
-- [ ] understand if this can be viable at all;
-- [ ] devise a way to update the spec automatically and regenerate every time the code in `generated`;
-- much more...fill this list up
+This is the Python SDK for LocalStack.
+LocalStack offers a number of developer endpoints (see [docs](https://docs.localstack.cloud/references/internal-endpoints/)).
+This SDK provides a programmatic and easy way to interact with them.
+
+> [!WARNING]
+> This project is still in a preview phase, and will be subject to fast and breaking changes.
+
+### Project Structure
+
+This project follows the following structure:
+
+- `packages/localstack-sdk-generated` is a python project generated from the OpenAPI specs with [openapi-generator](https://github.com/OpenAPITools/openapi-generator).
+- `localstack-sdk-python` is the main project that has `localstack-sdk-generated` has the main dependency.
+
+Developers are not supposed to modify at all `localstack-sdk-generated`.
+The code needs to be every time re-generated from specs using the `generate.sh` script in the `bin` folder.
+
+This project uses [uv](https://github.com/astral-sh/uv) as package/project manager.
+
+### Install & Run
+
+You can simply run `make install-dev` to install the two packages and the needed dependencies.
+`make test` runs the test suite.
+Note that LocalStack (pro) should be running in the background to execute the test.

VERSION

@@ -1 +1 @@
-0.0.1
+0.0.2

packages/localstack-sdk-generated/localstack/sdk/api_client.py

@@ -91,7 +91,7 @@ def __init__(
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'OpenAPI-Generator/0.0.1/python'
+        self.user_agent = 'OpenAPI-Generator/0.0.2/python'
         self.client_side_validation = configuration.client_side_validation
 
     def __enter__(self):

packages/localstack-sdk-generated/localstack/sdk/configuration.py

@@ -385,7 +385,7 @@ def to_debug_report(self):
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
                "Version of the API: 3.8.1.dev4\n"\
-               "SDK Package Version: 0.0.1".\
+               "SDK Package Version: 0.0.2".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self):

packages/localstack-sdk-generated/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "localstack-sdk-generated"
-version = "0.0.1"
+version = "0.0.2"
 description = "LocalStack REST API - Generated Code"
 authors = [
         { name = "LocalStack Contributors", email = "info@localstack.cloud" }

pyproject.toml

@@ -5,7 +5,7 @@ description = "Python SDK for LocalStack"
 authors = [
         { name = "LocalStack Team", email = "info@localstack.cloud"}
 ]
-version = "0.0.1"
+version = "0.0.2"
 dependencies = [
     "localstack-sdk-generated"
 ]
@@ -20,6 +20,9 @@ Issues = "https://github.com/localstack/localstack-sdk-python/issues"
 requires = ["setuptools>=64"]
 build-backend = "setuptools.build_meta"
 
+[tool.setuptools.dynamic]
+readme = { file = ["README.md"], content-type = "text/markdown"}
+
 [tool.uv]
 dev-dependencies=[
     "pytest",
@@ -77,4 +80,4 @@ ignore = [
     "T201", # TODO `print` found
     "T203", # TODO `pprint` found
 ]
-select = ["B", "C", "E", "F", "I", "W", "T", "B9", "G"]
+select = ["B", "C", "E", "F", "I", "W", "T", "B9", "G"]