Custom Entrypoint
Starting from Smyth 0.4.0, you can use it outside of the provided entrypoint (python -m smyth
). You can build your own entrypoint for Smyth, which would not require a TOML config but instead have a Python script living in your project like any other development helper script.
Example
Project Structure
Let's assume you have an etc
directory that is not part of the final production package. Put your smyth_conf.py
file there.
myproject
├── pyproject.toml
├── etc
│ └── smyth_conf.py
└── src
└── my_app
└── handlers.py
Your Smyth Configuration
Here's an example smyth_conf.py
file:
my_project/etc/smyth_conf.py |
---|
| import uvicorn
from starlette.requests import Request
from smyth.smyth import Smyth
from smyth.server.app import SmythStarlette
def my_handler(event, context):
return {"statusCode": 200, "body": "Hello, World!"}
async def my_event_data_generator(request: Request):
return {
"requestContext": {
"http": {
"method": "GET",
"path": "/hello",
}
}
}
smyth = Smyth()
smyth.add_handler(
name="hello",
path="/hello",
lambda_handler=my_handler,
timeout=1,
concurrency=1,
event_data_generator=my_event_data_generator,
)
app = SmythStarlette(smyth=smyth, smyth_path_prefix="/smyth")
if __name__ == "__main__":
uvicorn.run("smyth_conf:app", host="0.0.0.0", port=8080, reload=True)
|
Normally, the handler would be imported, but including the custom event generator in this file is a good use case. Use the SmythStarlette
subclass of Starlette
- it ensures all subprocesses are run at server start and killed on stop (using ASGI Lifetime). Create a Smyth instance and pass it to your SmythStarlette
instance. Here, you can fine-tune logging, change Uvicorn settings, etc.
After that, run your script:
python etc/smyth_conf.py
INFO: Will watch for changes in these directories: ['/Users/pkucmus/Development/mirumee/smyth_test_app']
INFO: Uvicorn running on http://0.0.0.0:8080 (Press CTRL+C to quit)
INFO: Started reloader process [29441] using StatReload
INFO: Started server process [29443]
INFO: Waiting for application startup.
INFO: Application startup complete.