This is a community-supported project, meaning there is no official level of support. The code is not covered by any SLA or deprecation policy.
Feel free to start a [discussion] to share thoughts or open issues for bugs and feature requests.
Functions Framework | Unit Tests | Lint Test | Conformance Tests |
---|---|---|---|
Dart | [![][ff_dart_unit_img]][ff_dart_unit_link] | [![][ff_dart_lint_img]][ff_dart_lint_link] | [![][ff_dart_conformance_img]][ff_dart_conformance_link] |
An open source FaaS (Function as a Service) framework for writing portable Dart functions, brought to you by the Google Dart and Cloud Functions teams.
The Functions Framework lets you write lightweight functions that run in many different environments, including:
Google Cloud Functions does not currently provide an officially supported Dart language runtime, but we're working to make running on [Google Cloud Run] as seamless and symmetric an experience as possible for your Dart Functions Framework projects.
The framework allows you to go from:
[examples/hello/lib/functions.dart]
import 'package:functions_framework/functions_framework.dart';
import 'package:shelf/shelf.dart';
@CloudFunction()
Response function(Request request) => Response.ok('Hello, World!');
To:
curl https://<your-app-url>
# Output: Hello, World!
All without needing to worry about writing an HTTP server or request handling logic.
See more demos under the [examples] directory.
From the [Dart quickstart] on your local machine:
$ cd examples/hello
$ docker build -t app .
...
$ docker run -it -p 8080:8080 --name demo --rm app
Listening on :8080
In another terminal:
$ curl localhost:8080
Hello, World!
See more [quickstarts].
See [CONTRIBUTING.md
][contributing] for details on how to contribute to this
project, including how to build and test your changes as well as how to properly
format your code.
Apache 2.0; see [LICENSE
][license] for details.
[ff_dart_unit_img]: https://github.com/GoogleCloudPlatform/functions-framework-dart/workflows/Dart%20Unit%20CI/badge.svg [ff_dart_unit_link]: https://github.com/GoogleCloudPlatform/functions-framework-dart/actions?query=workflow%3A"Dart+Unit+CI"
[ff_dart_lint_img]: https://github.com/GoogleCloudPlatform/functions-framework-dart/workflows/Dart%20Lint%20CI/badge.svg [ff_dart_lint_link]: https://github.com/GoogleCloudPlatform/functions-framework-dart/actions?query=workflow%3A"Dart+Lint+CI"
[ff_dart_conformance_img]: https://github.com/GoogleCloudPlatform/functions-framework-dart/workflows/Dart%20Conformance%20CI/badge.svg [ff_dart_conformance_link]: https://github.com/GoogleCloudPlatform/functions-framework-dart/actions?query=workflow%3A"Dart+Conformance+CI"
[dart quickstart]: https://github.com/GoogleCloudPlatform/functions-framework-dart/blob/main/docs/quickstarts/01-quickstart-dart.md [discussion]: https://github.com/GoogleCloudPlatform/functions-framework-dart/discussions [examples]: https://github.com/GoogleCloudPlatform/functions-framework-dart/tree/main/examples [examples/hello/lib/functions.dart]: https://github.com/GoogleCloudPlatform/functions-framework-dart/blob/main/examples/hello/lib/functions.dart [google cloud run]: https://cloud.google.com/run/docs/quickstarts/build-and-deploy
[cloud run quickstart]: https://github.com/GoogleCloudPlatform/functions-framework-dart/blob/main/docs/quickstarts/03-quickstart-cloudrun.md [quickstarts]: https://github.com/GoogleCloudPlatform/functions-framework-dart/tree/main/docs/quickstarts [contributing]: https://github.com/GoogleCloudPlatform/functions-framework-dart/blob/main/CONTRIBUTING.md [license]: https://github.com/GoogleCloudPlatform/functions-framework-dart/blob/main/functions_framework/LICENSE