PyPI 官网下载 | dapr-dev-1.4.0rc1.dev655.tar.gz

# Dapr SDK for Python [](https://badge.fury.io/py/dapr) [](https://badge.fury.io/py/dapr-dev)  [](https://codecov.io/gh/dapr/python-sdk) [](https://discord.com/channels/778680217417809931/778680217417809934) [](https://opensource.org/licenses/MIT) [Dapr](https://docs.dapr.io/concepts/overview/) is a portable, event-driven, serverless runtime for building distributed applications across cloud and edge. Dapr SDK for Python allows you to implement the [Virtual Actor model](https://docs.dapr.io/developing-applications/building-blocks/actors/actors-overview/), based on the actor design pattern. This SDK can run locally, in a container and in any distributed systems environment. This includes the following packages: * [dapr.actor](./dapr/actor): Actor Framework * [dapr.clients](./dapr/clients): Dapr clients for Dapr building blocks * [dapr.conf](./dapr/conf): Configuration * [dapr.serializers](./dapr/serializers): serializer/deserializer * [dapr.proto](./dapr/proto): Dapr gRPC autogenerated gRPC clients * [dapr.ext.grpc](./ext/dapr-ext-grpc): gRPC extension for Dapr * [dapr.ext.fastapi](./ext/dapr-ext-fastapi): FastAPI extension (actor) for Dapr * [flask.dapr](./ext/flask_dapr): Flask extension (actor) for Dapr ## Status > Note: Dapr SDK for python is currently under community development in alpha phase. ## Getting started ### Prerequisites * [Install Dapr standalone mode](https://github.com/dapr/cli#install-dapr-on-your-local-machine-standalone) * [Install Python 3.7+](https://www.python.org/downloads/) ### Install Dapr python sdk * Official package ```sh # Install Dapr client sdk pip3 install dapr # Install Dapr gRPC AppCallback service extension pip3 install dapr-ext-grpc # Install Dapr Fast Api extension for Actor pip3 install dapr-ext-fastapi ``` * Development package ```sh # Install Dapr client sdk pip3 install dapr-dev # Install Dapr gRPC AppCallback service extension pip3 install dapr-ext-grpc-dev # Install Dapr Fast Api extension for Actor pip3 install dapr-ext-fastapi-dev ``` > Note: Do not install both packages. ### Try out examples Go to [Examples](./examples) ## Developing ### Build and test 1. Clone python-sdk ```bash git clone https://github.com/dapr/python-sdk.git cd python-sdk ``` 2. Install a project in a editable mode ```bash pip3 install -e . pip3 install -e ./ext/dapr-ext-grpc/ pip3 install -e ./ext/dapr-ext-fastapi/ ``` 3. Install required packages ```bash pip3 install -r dev-requirements.txt ``` 4. Run unit-test ```bash tox -e py37 ``` 5. Run type check ```bash tox -e type ``` ## Documentation Documentation is generated using Sphinx. Extensions used are mainly Napoleon (To process the Google Comment Style) and Autodocs (For automatically generating documentation). The `.rst` files are generated using Sphinx-Apidocs. To generate documentation: ```bash tox -e doc ``` The generated files will be found in `docs/_build`. ## Generate gRPC Protobuf client ```sh pip3 install -r dev-requirements.txt ./tools/regen_grpcclient.sh ``` ## Code of Conduct This project has adopted the [Microsoft Open Source Code of conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.