Home

Awesome

Serverless Functions Python 💜

PyPI version pre-commit.ci status pre-commit.ci status

Scaleway Serverless Functions Python is a framework that simplifies Scaleway Serverless Functions local development. It enables you to debug your function locally and provide the event data format used in Scaleway Serverless Functions.

This library helps you to write functions but for deployment please refer to the documentation.

Get started with Scaleway Functions:

Testing frameworks for Scaleway Serverless Functions in other languages can be found here:

⚙️ Quickstart

You can use pip to install the framework:

pip install scaleway-functions-python
# handler.py

# Standard entrypoint to a Scaleway serverless function
def handler(event, context):
    if event["httpMethod"] != "GET":
         return {"statusCode": 405, "body": "Invalid method!"}
    return "Hello World!"

if __name__ == "__main__":
    # The import is conditional so that you do not need
    # to package the library when deploying on Scaleway Functions.
    from scaleway_functions_python import local
    local.serve_handler(handler, port=8080)

You can then run your function locally:

$ python handler.py
$ curl http://localhost:8080
> Hello World!
$ curl -X POST http://localhost:8080
> Invalid method!

🚀 Features

This repository aims to provide a better experience on local testing, utils, and documentation

🏡 Local testing

What this package does:

What this package does not:

🧱 Type hints

The framework provides some types hints to make it easier to develop your handler. See this example for more information on how to use them.

❓ FAQ

Why do I need an additional package to call my function?

Your Function Handler can be served by a simple HTTP server but Serverless Ecosystem involves a lot of different layers that will change changes the headers, input and output of your function. This package aims to simulate everything your request will go through to help you debug your application properly. This library is not mandatory to use Scaleway Serverless Functions.

How my function will be deployed

To deploy your function please refer to our official documentation.

Do I need to deploy my function differently?

No, this framework does not affect deployment or performance.

How can I use my packaged dependencies?

When deploying Python functions, your dependencies must be bundled in a package folder at the root of your project. For local testing, you can set PYTHONPATH=$(pwd)/package to make your dependencies available. This can be useful to avoid packaging your dependencies in multiple locations.

Please note that this does not work for native dependencies as the Scaleway Python runtime is different from your local machine.

Why are my logs not showing up when using the print function?

By default, stdout is buffered in Python, so calling print without flush=True can lead to missing logs when running locally. If you experience this issue, you can export the environment variable PYTHONUNBUFFERED with export PYTHONUNBUFFERED=1. This will flush stdout on every print call.

🎓 Contributing

We welcome all contributions to our open-source projects, please see our contributing guidelines.

Do not hesitate to raise issues and pull requests we will have a look at them.

📭 Reach Us

We love feedback. Feel free to: