Describe the proposal

Implement actor service via aiohttp which is similar to flask_dapr extension implementation.

Describe the proposal

Add publish api to convenient layer

Describe the proposal

Use flask-dapr pkg in actor example

Describe the proposal

Create convenient layer for gRPC API. This is to create the convenient layer for gRPC API.

Reference:
JAVA SDK - https://github.com/dapr/java-sdk/blob/master/sdk/src/main/java/io/dapr/client/DaprClient.java
https://github.com/dapr/java-sdk/blob/master/sdk/src/main/java/io/dapr/client/DaprClientGrpc.java

Location: dapr/clients/grpc

Describe the proposal

This is the release plan to ship dapr-python v0.5.0b.

• Package name: dapr
  • python-sdk includes actor sdk implemenation with the generated proto client so that it makes sense to rename from dapr-clients to dapr
• Package version: 0.5.0b
• Release work items.
  • Merge features/actor to master
  • Set up CI/CD
  • Improve README.md
  • validate with dotnet-sdk
  • Release dapr-python 0.5.0a

Describe the proposal

Serialize state value without base64 encoding

Describe the proposal

This is to implement the similar attributes in asp.net integration for http appcallback as a flask extension.

Changes are needed in the SDK corresponding to runtime changes here (see bottom of that issue for proposal):
dapr/dapr#1038

Reference for corresponding change in dapr/dotnet-sdk:
dapr/dotnet-sdk#313

Describe the proposal

This is to update protobuf client along with dapr/dapr#1409

Describe the proposal

Add Statestore apis to convenient layer.

Parent epic : #67

• Implementation
• Unit-tests
• Documentation in code
• update examples

Describe the proposal

Add a script file to generate gRPC client code/stubs from dapr proto files by installing necessary tooling, plugins for python.

Describe the proposal

Current Pub/Sub example doesn't use update proto APIs. I propose to update the example and adapt it to the changes.

(A PR will follow shortly 😃 )

Describe the proposal

Add binding apis to convenient layer.

Parent epic : #67

• Implementation
• Unit-tests
• Documentation in code
• update examples

Describe the proposal

In the convenient layer spec, DaprClient doesn't have the default json serializer, but let users to handle JSON serialization. Like the other python pkgs, such as flask, requests, etc, DaprClient can have default json serializer to serialize and deserialize python dict type or primitive objects and provide .json() helper to DaprResponse and DataContent in AppCallback Layer. It will improve development experience instead of serializing and deserializing data object.

Expected Behavior

Service should spinn up with hitting dapr run --app-id python-subscriber --protocol grpc --app-port 50051 python subscriber.py

Actual Behavior

It throws following error when we try to spin up subscriber.py

== APP == Exception calling application: Protocol message ListTopicSubscriptionsResponse has no "topics" field.

== APP == Traceback (most recent call last):

== APP ==   File "/home/girish/Documents/dapr/dapr-samples/python-sdk/examples/pubsub-simple/venv/lib/python3.8/site-packages/grpc/_server.py", line 435, in _call_behavior

== APP ==     response_or_iterator = behavior(argument, context)

== APP ==   File "subscriber.py", line 21, in ListTopicSubscriptions

== APP ==     return appcallback_v1.ListTopicSubscriptionsResponse(topics=['TOPIC_A'])

== APP == ValueError: Protocol message ListTopicSubscriptionsResponse has no "topics" field.

Complete logs
dapr_logs.txt

Steps to Reproduce the Problem

Run dapr run --app-id python-subscriber --protocol grpc --app-port 50051 python subscriber.py from examples/pubsub-simple

Settings & configurations

• using standalone dapr
• tried with both dapr & dapr-dev
• CLI version: 0.8.0
• Runtime version: 0.8.0

Describe the proposal

Add state management to python actor-sdk

Describe the proposal

Add more realistic application examples which can show the capabilities of the convenient layer.

Describe the proposal

The ultimate goal of ML and DL model development is to integrate with the production services. Typically, ML and DL engineers focus on model development rather than how they will integrate model with their services.

Many articles and tutorials introduces how to serve the model with Flask. Once they have Flask service with their model to their production, the backend and frontend services need to implement client code to talk to model server.

Dapr and Python-sdk will be able to resolve this problem easier. So ML engineer creates micro service and deploy it to production cluster without the knowledge of http restful api server and microservice deployment. Backend engineer can use service invocation api to use the model without model server client implementation.

Describe the proposal

• Add more code level comments
• Generate sphinx docs

related to #40

Proposal

Add an example (similar to invoke-simple ) showing pubsub pattern.

Why to add?

Pubsub is a very essential feature and it's hard to find a template to make a subscriber.

Describe the proposal

Update proto client for 0.8.0

I currently do not see a way to implement actor methods, is this already supported in the Python SDK? 😊

Describe the proposal

Sphinx can be used to generate documentation automatically with the autodoc extension. Napoleon extension can be used to process the Google comment style.

Describe the proposal

Add Invoke service api to convenient layer.

Parent epic : #67

• Implementation
• Unit-tests
• Documentation in code
• update examples

Describe the proposal

Add dev-container for python-sdk dev environment

Describe the proposal

Set up GitHub Actions workflow for build and publish pkg

• Create workflow for building pkg
• Create workflow for publishing pkg

related to #40

Add an example for deploying on Kubernetes

Describe the proposal

feature branch: https://github.com/dapr/python-sdk/tree/features/actor

Add reminder to actor sdk.

Describe the proposal

Replace all deprecated cli commands and k8s annotations. Part of this parent epic.

Describe the proposal

Improve code comments

Describe the proposal

Test compatibility between python sdk and dotnet sdk

Describe the proposal

Add one requirments.txt file in the root of python-sdk
It is required for python pkg installation.

Description

There is an unnecessary return statement in line 32 of /invoke-simple/invoke-receiver.py

How to fix

Removing lines 31-32 will do just fine.

Describe the proposal

Split flask_dapr package from dapr package

• create setup.py and setup.cfg for flask_dapr
• configure ci to build flask_dapr package

When trying to import daprclient_pb2_grpc.py to access the OnInvoke method, an error is thrown. Without this, a correct example utilizing the OnInvoke method can not be created, disallowing the E2E communication of 2 RPC microservices (client and server).

It seems that on the source repo the following proto files are found:

• https://github.com/dapr/dapr/blob/master/pkg/proto/daprclient/daprclient.proto
• https://github.com/dapr/dapr/blob/master/pkg/proto/dapr/dapr.proto

It might be that there is some wrong packaging behavior happening?

Expected Behavior

This should work to allow the creation of the OnInvoke method.

Actual Behavior

== APP == Traceback (most recent call last):
== APP ==   File "server.py", line 7, in <module>
== APP ==     from dapr import daprclient_pb2_grpc as servicesClient
== APP ==   File "C:\Python37\lib\site-packages\dapr\daprclient_pb2_grpc.py", line 4, in <module>
== APP ==     from daprclient import daprclient_pb2 as daprclient_dot_daprclient__pb2
== APP == ModuleNotFoundError: No module named 'daprclient'

Steps to Reproduce the Problem

1. Create a new Python file (e.g. server.py)
2. Add line from dapr import daprclient_pb2_grpc as services
3. Run the application (e.g. dapr run --app-id python-grpc --port 3500 --protocol grpc --grpc-port 50001 python server.py)

Describe the proposal

Adding an example on how to utilize the OnInvoke method from the proto bindings. This example helps users on how to create a gRPC server that can listen on direct method invocations.

Describe the proposal

Add K8s deployment yaml for demo actor example

Describe the proposal

grpc_asyncio is still WIP. We may need to support it later when grpc_asyncio is stable.
https://grpc.github.io/grpc/python/grpc_asyncio.html

Update: grpc_asyncio is now available, however we should publish an asynchronous Dapr Python SDK as a separate SDK, or at least sub package - like dapr.aio (from dapr.aio.clients import DaprClient)

There were concerns from several users about the performance overhead of calling asynchronous methods and running them in a synchronous context, so simply switching over to grpc.aio is not an option unfortunately.

Describe the proposal

I would like to see Python >= 3.7 supported instead of 3.8 (which is cutting edge), seeing that a lot of libraries are still depending on 3.7 at the moment.

Note: Currently I manually clone and install it locally and it's working on Python 3.7 for me

Describe the proposal

feature branch: https://github.com/dapr/python-sdk/tree/features/actor

Add timer to actor sdk.

Describe the proposal

This is to support dapr api token authentication. - Reference: https://github.com/dapr/docs/blob/master/howto/enable-dapr-api-token-based-authentication/README.md

1. read DAPR_API_TOKEN environment variable
2. set dapr-api-token metadata in each api call.

Use grpc client interceptor.

Describe the proposal

Publish auto-generated Python SDK doc to GitHub page.

Describe the proposal

Create AppCallback wrapper and decorator.

Describe the proposal

Improve README.md and convert it to rst format.

related to #40

Expected Behavior

Add appcallback versioning to HTTP APIs. Make necessary changes to python-sdk and samples
Related to: dapr/dapr#1678

Describe the proposal

Update auto-generated sdk for changes in proto files(multi store feature)

Expected Behavior

pip install dapr-client should install the latest version (0.2 now)

Actual Behavior

installs the first version 0.1

Steps to Reproduce the Problem

pip search dapr-client

or

open https://pypi.org/project/dapr-client/

Need requirement.txt to install grpcio package

Describe the proposal

Add Secrets apis to convenient layer.

Parent epic : #67

• Implementation
• Unit-tests
• Documentation in code
• update or add examples

Allow to pass W3C trace header(traceparent) or grpc-trace-bin to Dapr Api call.

0.8.0 supports traceparent and grpc-trace-bin. Python-sdk needs the way to pass traceparent for http or grpc-trace-bin metadata for grpc.

RELEASE NOTE: ADD W3C trace headers to Dapr API calls.