Small improvements to the makefile and readme (#9)

Author: giograno

Makefile

@@ -1,29 +1,28 @@
-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 venv
 	uv sync --no-dev
 
 install-dev:		## create the venv and install
+	uv venv
 	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/
 
+generate:			## Generate the code from the OpenAPI specs
+	./bin/generate.sh
+
 format:
 	($(VENV_RUN); python -m ruff format --exclude packages .; python -m ruff check --output-format=full --exclude packages --fix .)
 

README.md

@@ -1,21 +1,23 @@
 # LocalStack Python SDK
+[![PyPI version](https://img.shields.io/pypi/v/localstack-sdk-python)](https://pypi.org/project/localstack-sdk-python/)
 
 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.
+> 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.
+- `packages/localstack-sdk-generated` is a Python project generated from the OpenAPI specs with [openapi-generator](https://github.com/OpenAPITools/openapi-generator).
+LocalStack's OpenAPI specs are available in the [openapi repository](https://github.com/localstack/openapi).
+- `localstack-sdk-python` is the main project that has `localstack-sdk-generated` as 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.
+The code needs to be re-generated from specs every time using the `generate.sh` script in the `bin` folder.
 
 This project uses [uv](https://github.com/astral-sh/uv) as package/project manager.