localstack-sdk-python 0.0.2__tar.gz → 0.0.3__tar.gz

localstack_sdk_python-0.0.3/.github/workflows/test.yml

@@ -0,0 +1,63 @@
+name: Python LocalStack Client / Run Test
+
+on:
+  pull_request:
+    paths:
+      - .github/workflows/test.yml
+      - localstack-sdk-python/**
+      - tests/**
+      - packages/**
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+
+  test_python:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v4
+
+    - name: Set up Python 3.11
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.11"
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v3
+
+    - name: Install project
+      run: |
+        make install-dev
+
+    - name: Install LocalStack
+      run: |
+        pip install --pre --upgrade localstack
+
+    - name: Pull image
+      run: |
+        docker pull localstack/localstack-pro
+
+    - name: Start Localstack
+      env:
+       LOCALSTACK_AUTH_TOKEN: ${{ secrets.LOCALSTACK_AUTH_TOKEN }}
+      run: |
+          source .venv/bin/activate
+          DEBUG=1 DISABLE_EVENTS="1" IMAGE_NAME="localstack/localstack-pro:latest" localstack start -d
+          localstack wait -t 120 || (python -m localstack.cli.main logs && false)
+
+    - name: Run Python Tests
+      env:
+        LOCALSTACK_AUTH_TOKEN: ${{ secrets.LOCALSTACK_AUTH_TOKEN }}
+      run: |
+        make test
+
+    - name: Stop Localstack
+      if: always()
+      run: |
+          source .venv/bin/activate
+          localstack logs
+          localstack stop

localstack_sdk_python-0.0.3/.gitignore

@@ -0,0 +1,66 @@
+*.pyc
+*.pyo
+*.log
+*.keys.json
+/nosetests.xml
+/.venv*
+*/.venv*
+*/.mypy_cache
+.settings/
+.project
+.classpath
+.coverage*
+.DS_Store
+/build/
+dist/
+*.egg-info/
+.eggs/
+*.sw*
+~*
+*~
+.idea/
+*.iml
+.vscode/
+
+node_modules/
+app/build
+package-lock.json
+
+.serverless
+
+target/
+
+testdata/
+
+etc/docker/lambda/*.tmp
+etc/docker/lambda/Dockerfile
+etc/docker/lambda/entrypoint.sh
+
+*.crt
+!localstack-pro-azure/localstack/pro/azure/server/proxy/ca.crt
+
+backend_states/
+api_states/
+.python_packages/
+
+terraform.tfstate*
+.terraform*
+**/terraform/tfplan
+.env
+
+# test resources
+metastore_db/
+parity-metrics/
+.pytest-report.xml
+*.raw.snapshot.json
+localstack-pro-azure/visited_urls.csv
+localstack-pro-azure/implemented_features.csv
+localstack-pro-azure/tests/otherlangs/scripts/website/.azure/config
+
+# dotnet files
+localstack-pro-azure/tests/otherlangs/dotnet/*/bin
+localstack-pro-azure/tests/otherlangs/dotnet/*/obj
+
+# setuptools_scm version.py
+*/*/*/*/version.py
+localstack-sdk-python-2/.openapi-generator/

localstack_sdk_python-0.0.3/Makefile

@@ -0,0 +1,36 @@
+VENV_CMD ?= python3 -m venv
+VENV_DIR ?= .venv
+VENV_BIN = python3 -m venv
+VENV_RUN = . $(VENV_DIR)/bin/activate
+VENV_ACTIVATE = $(VENV_DIR)/bin/activate
+TEST_PATH ?= .
+TEST_EXEC ?= python -m
+PYTEST_LOGLEVEL ?= warning
+PIP_CMD ?= pip
+
+install:			## omit dev dependencies
+	uv sync --no-dev
+
+install-dev:		## create the venv and install
+	uv sync
+
+build-spec:			## build the entire localstack api spec (openapi.yaml in the root folder)
+	$(VENV_RUN); python scripts/create_spec.py
+
+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/
+
+format:
+	($(VENV_RUN); python -m ruff format --exclude packages .; python -m ruff check --output-format=full --exclude packages --fix .)
+
+lint:
+	($(VENV_RUN); python -m ruff check --exclude packages --output-format=full . && python -m ruff format --exclude packages --check .)
+
+test:              		  ## Run automated tests
+	($(VENV_RUN); $(TEST_EXEC) pytest --durations=10 --log-cli-level=$(PYTEST_LOGLEVEL) $(PYTEST_ARGS) $(TEST_PATH))
+
+.PHONY: clean install install-dev

{localstack_sdk_python-0.0.2 → localstack_sdk_python-0.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: localstack-sdk-python
-Version: 0.0.2
+Version: 0.0.3
 Summary: Python SDK for LocalStack
 Author-email: LocalStack Team <info@localstack.cloud>
 Project-URL: Homepage, https://localstack.cloud

localstack_sdk_python-0.0.3/bin/generate.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+
+version=$(cat VERSION)
+
+docker run --rm -v "${PWD}:/local" openapitools/openapi-generator-cli:v7.9.0 generate \
+    -i https://raw.githubusercontent.com/localstack/openapi/refs/heads/main/openapi/emulators/localstack-spec-latest.yml \
+    --skip-validate-spec \
+    -g python \
+    -o /local//packages/localstack-sdk-generated \
+    --global-property models,apis,supportingFiles \
+    -p packageName=localstack.sdk \
+    -p packageVersion=$version \
+    --template-dir /local/packages/localstack-sdk-generated/templates \
+    --global-property apiTests=false,modelTests=false \
+    --global-property apiDocs=false,modelDocs=False

localstack_sdk_python-0.0.3/localstack-sdk-python/localstack/sdk/aws/__init__.py

@@ -0,0 +1,3 @@
+from localstack.sdk.aws.client import AWSClient
+
+__all__ = ["AWSClient"]

localstack_sdk_python-0.0.3/localstack-sdk-python/localstack/sdk/aws/client.py

@@ -0,0 +1,68 @@
+import json
+
+from localstack.clients import BaseClient
+from localstack.sdk.api.aws_api import AwsApi
+from localstack.sdk.models import Message, SesSentEmail
+
+
+def _from_sqs_query_to_json(xml_dict: dict) -> list[Message]:
+    """
+    todo: developer endpoint implements sqs-query protocol. Remove this workaround one we move them to json.
+    """
+    raw_messages = (
+        xml_dict.get("ReceiveMessageResponse", {}).get("ReceiveMessageResult", {}) or {}
+    ).get("Message", [])
+    if isinstance(raw_messages, dict):
+        raw_messages = [raw_messages]
+    messages = []
+    for msg in raw_messages:
+        _attributes = msg.get("Attribute", [])
+        attributes = {i["Name"]: i["Value"] for i in _attributes}
+        _m = {
+            "MessageId": msg.get("MessageId"),
+            "ReceiptHandle": msg.get("ReceiptHandle"),
+            "MD5OfBody": msg.get("MD5OfBody"),
+            "Body": msg.get("Body"),
+            "Attributes": attributes,
+        }
+        m = Message.from_dict(_m)
+        messages.append(m)
+    return messages
+
+
+class AWSClient(BaseClient):
+    def __init__(self, **kwargs) -> None:
+        super().__init__(**kwargs)
+        self._client = AwsApi(self._api_client)
+
+    ########
+    # SQS
+    ########
+
+    def list_sqs_messages(self, account_id: str, region: str, queue_name: str) -> list[Message]:
+        response = self._client.list_sqs_messages_with_http_info(
+            account_id=account_id, region=region, queue_name=queue_name
+        )
+        return _from_sqs_query_to_json(json.loads(response.raw_data))
+
+    def list_sqs_messages_from_queue_url(self, queue_url) -> list[Message]:
+        response = self._client.list_all_sqs_messages_with_http_info(queue_url=queue_url)
+        return _from_sqs_query_to_json(json.loads(response.raw_data))
+
+    ########
+    # SES
+    ########
+
+    def get_ses_messages(
+        self, id_filter: str | None = None, email_filter: str | None = None
+    ) -> list[SesSentEmail]:
+        response = self._client.get_ses_messages(id=id_filter, email=email_filter)
+        return response.messages
+
+    def discard_ses_messages(self, id_filter: str | None = None) -> None:
+        return self._client.discard_ses_messages(id=id_filter)
+
+
+def get_default(**args) -> AwsApi:
+    """Return a client with a default configuration"""
+    return AwsApi(args)

localstack_sdk_python-0.0.3/localstack-sdk-python/localstack/sdk/state/__init__.py

@@ -0,0 +1,3 @@
+from localstack.sdk.state.client import StateClient
+
+__all__ = ["StateClient"]

localstack_sdk_python-0.0.3/localstack-sdk-python/localstack/sdk/state/client.py

@@ -0,0 +1,11 @@
+from localstack.clients import BaseClient
+from localstack.sdk.api import StateApi
+
+
+class StateClient(BaseClient):
+    def __init__(self, **args) -> None:
+        super().__init__(**args)
+        self._client = StateApi(self._api_client)
+
+    def reset_state(self) -> None:
+        self._client.localstack_state_reset_post_0()

{localstack_sdk_python-0.0.2 → localstack_sdk_python-0.0.3}/localstack-sdk-python/localstack_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: localstack-sdk-python
-Version: 0.0.2
+Version: 0.0.3
 Summary: Python SDK for LocalStack
 Author-email: LocalStack Team <info@localstack.cloud>
 Project-URL: Homepage, https://localstack.cloud

localstack_sdk_python-0.0.3/localstack-sdk-python/localstack_sdk_python.egg-info/SOURCES.txt

@@ -0,0 +1,109 @@
+.gitignore
+LICENSE.txt
+Makefile
+README.md
+pyproject.toml
+requirements-spec.txt
+uv.lock
+.github/workflows/test.yml
+bin/generate.sh
+localstack-sdk-python/localstack/clients.py
+localstack-sdk-python/localstack/sdk/aws/__init__.py
+localstack-sdk-python/localstack/sdk/aws/client.py
+localstack-sdk-python/localstack/sdk/chaos/__init__.py
+localstack-sdk-python/localstack/sdk/chaos/client.py
+localstack-sdk-python/localstack/sdk/chaos/managers.py
+localstack-sdk-python/localstack/sdk/pods/__init__.py
+localstack-sdk-python/localstack/sdk/pods/client.py
+localstack-sdk-python/localstack/sdk/state/__init__.py
+localstack-sdk-python/localstack/sdk/state/client.py
+localstack-sdk-python/localstack_sdk_python.egg-info/PKG-INFO
+localstack-sdk-python/localstack_sdk_python.egg-info/SOURCES.txt
+localstack-sdk-python/localstack_sdk_python.egg-info/dependency_links.txt
+localstack-sdk-python/localstack_sdk_python.egg-info/requires.txt
+localstack-sdk-python/localstack_sdk_python.egg-info/top_level.txt
+packages/localstack-sdk-generated/.gitignore
+packages/localstack-sdk-generated/.openapi-generator-ignore
+packages/localstack-sdk-generated/pyproject.toml
+packages/localstack-sdk-generated/requirements.txt
+packages/localstack-sdk-generated/.openapi-generator/FILES
+packages/localstack-sdk-generated/.openapi-generator/VERSION
+packages/localstack-sdk-generated/localstack/sdk/api_client.py
+packages/localstack-sdk-generated/localstack/sdk/api_response.py
+packages/localstack-sdk-generated/localstack/sdk/configuration.py
+packages/localstack-sdk-generated/localstack/sdk/exceptions.py
+packages/localstack-sdk-generated/localstack/sdk/py.typed
+packages/localstack-sdk-generated/localstack/sdk/rest.py
+packages/localstack-sdk-generated/localstack/sdk/api/__init__.py
+packages/localstack-sdk-generated/localstack/sdk/api/aws_api.py
+packages/localstack-sdk-generated/localstack/sdk/api/chaos_api.py
+packages/localstack-sdk-generated/localstack/sdk/api/default_api.py
+packages/localstack-sdk-generated/localstack/sdk/api/localstack_api.py
+packages/localstack-sdk-generated/localstack/sdk/api/pods_api.py
+packages/localstack-sdk-generated/localstack/sdk/api/pro_api.py
+packages/localstack-sdk-generated/localstack/sdk/api/state_api.py
+packages/localstack-sdk-generated/localstack/sdk/models/__init__.py
+packages/localstack-sdk-generated/localstack/sdk/models/aws_pinpoint_application_id_reference_id_get200_response.py
+packages/localstack-sdk-generated/localstack/sdk/models/cloud_watch_metrics.py
+packages/localstack-sdk-generated/localstack/sdk/models/cloud_watch_metrics_metrics_inner.py
+packages/localstack-sdk-generated/localstack/sdk/models/cloud_watch_metrics_metrics_inner_d_inner.py
+packages/localstack-sdk-generated/localstack/sdk/models/cloud_watch_metrics_metrics_inner_d_inner_v.py
+packages/localstack-sdk-generated/localstack/sdk/models/cloud_watch_metrics_metrics_inner_t.py
+packages/localstack-sdk-generated/localstack/sdk/models/cloud_watch_metrics_metrics_inner_v.py
+packages/localstack-sdk-generated/localstack/sdk/models/create_remote_request.py
+packages/localstack-sdk-generated/localstack/sdk/models/delete_ddb_expired_items200_response.py
+packages/localstack-sdk-generated/localstack/sdk/models/fault_rule.py
+packages/localstack-sdk-generated/localstack/sdk/models/fault_rule_error.py
+packages/localstack-sdk-generated/localstack/sdk/models/get_diagnostics200_response.py
+packages/localstack-sdk-generated/localstack/sdk/models/get_diagnostics200_response_logs.py
+packages/localstack-sdk-generated/localstack/sdk/models/get_diagnostics200_response_version.py
+packages/localstack-sdk-generated/localstack/sdk/models/get_diagnostics200_response_version_host.py
+packages/localstack-sdk-generated/localstack/sdk/models/get_diagnostics200_response_version_image_version.py
+packages/localstack-sdk-generated/localstack/sdk/models/get_diagnostics200_response_version_localstack_version.py
+packages/localstack-sdk-generated/localstack/sdk/models/get_features_and_services200_response.py
+packages/localstack-sdk-generated/localstack/sdk/models/get_lambda_runtimes200_response.py
+packages/localstack-sdk-generated/localstack/sdk/models/get_remote200_response.py
+packages/localstack-sdk-generated/localstack/sdk/models/get_ses_messages200_response.py
+packages/localstack-sdk-generated/localstack/sdk/models/get_sns_messages200_response.py
+packages/localstack-sdk-generated/localstack/sdk/models/get_sns_sms_messages200_response.py
+packages/localstack-sdk-generated/localstack/sdk/models/get_sns_subscription_token200_response.py
+packages/localstack-sdk-generated/localstack/sdk/models/init_scripts.py
+packages/localstack-sdk-generated/localstack/sdk/models/init_scripts_completed.py
+packages/localstack-sdk-generated/localstack/sdk/models/init_scripts_scripts_inner.py
+packages/localstack-sdk-generated/localstack/sdk/models/init_scripts_stage.py
+packages/localstack-sdk-generated/localstack/sdk/models/init_scripts_stage_scripts_inner.py
+packages/localstack-sdk-generated/localstack/sdk/models/list_remotes200_response.py
+packages/localstack-sdk-generated/localstack/sdk/models/list_remotes200_response_remotes_inner.py
+packages/localstack-sdk-generated/localstack/sdk/models/localstack_pods_environment_get200_response.py
+packages/localstack-sdk-generated/localstack/sdk/models/localstack_stackinfo_get200_response.py
+packages/localstack-sdk-generated/localstack/sdk/models/manage_session_request.py
+packages/localstack-sdk-generated/localstack/sdk/models/message.py
+packages/localstack-sdk-generated/localstack/sdk/models/network_effects_config.py
+packages/localstack-sdk-generated/localstack/sdk/models/pod_list.py
+packages/localstack-sdk-generated/localstack/sdk/models/pod_list_cloudpods_inner.py
+packages/localstack-sdk-generated/localstack/sdk/models/pod_remote.py
+packages/localstack-sdk-generated/localstack/sdk/models/pod_save_request.py
+packages/localstack-sdk-generated/localstack/sdk/models/pod_versions.py
+packages/localstack-sdk-generated/localstack/sdk/models/pod_versions_versions_inner.py
+packages/localstack-sdk-generated/localstack/sdk/models/receive_message_request.py
+packages/localstack-sdk-generated/localstack/sdk/models/receive_message_result.py
+packages/localstack-sdk-generated/localstack/sdk/models/remote_config.py
+packages/localstack-sdk-generated/localstack/sdk/models/remote_config_one_of.py
+packages/localstack-sdk-generated/localstack/sdk/models/ses_sent_email.py
+packages/localstack-sdk-generated/localstack/sdk/models/ses_sent_email_body.py
+packages/localstack-sdk-generated/localstack/sdk/models/session_info.py
+packages/localstack-sdk-generated/localstack/sdk/models/sns_subscription_token_error.py
+packages/localstack-sdk-generated/localstack/sdk/models/state_result.py
+packages/localstack-sdk-generated/localstack/sdk/models/store_data200_response.py
+packages/localstack-sdk-generated/localstack/sdk/models/update_config_option200_response.py
+packages/localstack-sdk-generated/localstack/sdk/models/update_config_option_request.py
+packages/localstack-sdk-generated/templates/pyproject.mustache
+packages/localstack-sdk-generated/templates/rest.mustache
+scripts/create_spec.py
+tests/__init__.py
+tests/utils.py
+tests/integration/__init__.py
+tests/integration/test_aws.py
+tests/integration/test_chaos.py
+tests/integration/test_pods.py
+tests/integration/test_state.py

localstack_sdk_python-0.0.3/packages/localstack-sdk-generated/.gitignore

@@ -0,0 +1,66 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*,cover
+.hypothesis/
+venv/
+.venv/
+.python-version
+.pytest_cache
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+#Ipython Notebook
+.ipynb_checkpoints

localstack_sdk_python-0.0.3/packages/localstack-sdk-generated/.openapi-generator/FILES

@@ -0,0 +1,71 @@
+.gitignore
+localstack/sdk/api/__init__.py
+localstack/sdk/api/aws_api.py
+localstack/sdk/api/chaos_api.py
+localstack/sdk/api/default_api.py
+localstack/sdk/api/localstack_api.py
+localstack/sdk/api/pods_api.py
+localstack/sdk/api/pro_api.py
+localstack/sdk/api/state_api.py
+localstack/sdk/api_client.py
+localstack/sdk/api_response.py
+localstack/sdk/configuration.py
+localstack/sdk/exceptions.py
+localstack/sdk/models/__init__.py
+localstack/sdk/models/aws_pinpoint_application_id_reference_id_get200_response.py
+localstack/sdk/models/cloud_watch_metrics.py
+localstack/sdk/models/cloud_watch_metrics_metrics_inner.py
+localstack/sdk/models/cloud_watch_metrics_metrics_inner_d_inner.py
+localstack/sdk/models/cloud_watch_metrics_metrics_inner_d_inner_v.py
+localstack/sdk/models/cloud_watch_metrics_metrics_inner_t.py
+localstack/sdk/models/cloud_watch_metrics_metrics_inner_v.py
+localstack/sdk/models/create_remote_request.py
+localstack/sdk/models/delete_ddb_expired_items200_response.py
+localstack/sdk/models/fault_rule.py
+localstack/sdk/models/fault_rule_error.py
+localstack/sdk/models/get_diagnostics200_response.py
+localstack/sdk/models/get_diagnostics200_response_logs.py
+localstack/sdk/models/get_diagnostics200_response_version.py
+localstack/sdk/models/get_diagnostics200_response_version_host.py
+localstack/sdk/models/get_diagnostics200_response_version_image_version.py
+localstack/sdk/models/get_diagnostics200_response_version_localstack_version.py
+localstack/sdk/models/get_features_and_services200_response.py
+localstack/sdk/models/get_lambda_runtimes200_response.py
+localstack/sdk/models/get_ses_messages200_response.py
+localstack/sdk/models/get_sns_messages200_response.py
+localstack/sdk/models/get_sns_sms_messages200_response.py
+localstack/sdk/models/get_sns_subscription_token200_response.py
+localstack/sdk/models/init_scripts.py
+localstack/sdk/models/init_scripts_completed.py
+localstack/sdk/models/init_scripts_scripts_inner.py
+localstack/sdk/models/init_scripts_stage.py
+localstack/sdk/models/init_scripts_stage_scripts_inner.py
+localstack/sdk/models/list_remotes200_response.py
+localstack/sdk/models/localstack_pods_environment_get200_response.py
+localstack/sdk/models/localstack_stackinfo_get200_response.py
+localstack/sdk/models/manage_session_request.py
+localstack/sdk/models/message.py
+localstack/sdk/models/network_effects_config.py
+localstack/sdk/models/pod_list.py
+localstack/sdk/models/pod_list_cloudpods_inner.py
+localstack/sdk/models/pod_remote.py
+localstack/sdk/models/pod_save_request.py
+localstack/sdk/models/pod_versions.py
+localstack/sdk/models/pod_versions_versions_inner.py
+localstack/sdk/models/receive_message_request.py
+localstack/sdk/models/receive_message_result.py
+localstack/sdk/models/remote_config.py
+localstack/sdk/models/remote_config_one_of.py
+localstack/sdk/models/ses_destination.py
+localstack/sdk/models/ses_sent_email.py
+localstack/sdk/models/ses_sent_email_body.py
+localstack/sdk/models/session_info.py
+localstack/sdk/models/sns_subscription_token_error.py
+localstack/sdk/models/state_result.py
+localstack/sdk/models/store_data200_response.py
+localstack/sdk/models/update_config_option200_response.py
+localstack/sdk/models/update_config_option_request.py
+localstack/sdk/py.typed
+localstack/sdk/rest.py
+pyproject.toml
+requirements.txt

localstack_sdk_python-0.0.3/packages/localstack-sdk-generated/.openapi-generator/VERSION

@@ -0,0 +1 @@
+7.9.0

localstack_sdk_python-0.0.3/packages/localstack-sdk-generated/.openapi-generator-ignore

@@ -0,0 +1,14 @@
+# OpenAPI Generator Ignore
+# Generated by openapi-generator https://github.com/openapitools/openapi-generator
+
+.github/workflows/python.yml
+.gitlab-ci.yml
+.travis.yml
+git_push.sh
+README.md
+tox.ini
+localstack/sdk/__init__.py
+localstack/__init__.py
+setup.py
+setup.cfg
+test-requirements.txt

localstack_sdk_python-0.0.3/packages/localstack-sdk-generated/localstack/sdk/api/__init__.py

@@ -0,0 +1,11 @@
+# flake8: noqa
+
+# import apis into api package
+from localstack.sdk.api.aws_api import AwsApi
+from localstack.sdk.api.chaos_api import ChaosApi
+from localstack.sdk.api.default_api import DefaultApi
+from localstack.sdk.api.localstack_api import LocalstackApi
+from localstack.sdk.api.pods_api import PodsApi
+from localstack.sdk.api.pro_api import ProApi
+from localstack.sdk.api.state_api import StateApi
+