Smyth is a versatile tool designed to enhance your AWS Lambda development experience. It is a pure Python tool that allows for easy customization and state persistence, making your Lambda development more efficient and developer-friendly.
Project description
Smyth
Smyth is a versatile tool designed to enhance your AWS Lambda development experience. It is a pure Python tool that allows for easy customization and state persistence, making your Lambda development more efficient and developer-friendly.
Features
- Pure Python: Entirely written in Python, allowing flexibility to tailor it to your specific requirements.
- Customizability: Modify both the
event
andcontext
data structures as needed. - State Persistence: Simulates both cold and warm starts, retaining state across invocations, mimicking actual AWS Lambda behavior.
- Efficiency: Streamlined and efficient, relying solely on Python for code execution.
- Inspired by Serverless Framework: Designed with insights from the Serverless framework, effectively managing serverless applications.
- Developer-Friendly: Integrates seamlessly with common development tools and practices, such as PDB, iPDB, VSCode debugging, and .env file support.
Installation
Install Smyth as a development dependency using Poetry or pip:
Poetry
poetry add --group dev smyth
pip
pip install smyth
Define the following settings in your Lambda project's pyproject.toml
file:
[tool.smyth]
host = "0.0.0.0"
port = 8080
[tool.smyth.handlers.saleor_handler]
handler_path = "my_project.handlers.saleor.handler.saleor_http_handler"
url_path = "/saleor/{path:path}"
Run Smyth with:
python -m smyth
Working with Docker
Assuming you have this already installed by Poetry you can use the Dockerfile.example
and docker-compose.example.yml
files from this repository to get started.
Working with VS Code
To utilize the VS Code debugger with the Smyth tool, you can set up your launch.json
configuration file as follows. This setup will enable you to debug your Lambda functions directly within VS Code, providing a seamless development experience.
{
"version": "0.2.0",
"configurations": [
{
"name": "Python Debugger: Module",
"type": "debugpy",
"request": "launch",
"module": "smyth",
"args": ["run"],
}
]
}
Caveats
The combination of Uvicorn reload process and HTTP server process with what is being done with the Lambda processes is tricky. If a Lambda process is doing something and the HTTP server is killed in the wrong moment it's likely going to bork your terminal. This is not solved yet. It's best to use in a Docker container or have the ability to kill -9 {PID of the Uvicorn reload process}
at hand.
TODO
- Write tests
- Publish on PyPi
Name
This name blends "Smith" (as in a blacksmith, someone who works in a forge) with "Py" for Python, altering the spelling to "Smyth". Blacksmiths are craftsmen who work with metal in a forge, shaping it into desired forms. Similarly, "Smyth" suggests a tool that helps developers craft and shape their serverless projects with the precision and skill of a smith, but in the realm of Python programming. This name retains the essence of craftsmanship and transformation inherent in a forge while being associated with Python.
Crafted with ❤️ by Mirumee Software hello@mirumee.com
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for smyth-0.6.0.post1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 21f7de5319800c8b74b29b5cface3cc15384f52cf69674a191e43dca642e1680 |
|
MD5 | d6c0da33bf4b45b4303b7df7c0444a60 |
|
BLAKE2b-256 | ea2f566beb21042d95dbc2e915b568299dcb862ebe16877ce8ac98a4c778cfa7 |