senzing-grpc 0.0.2

Python SDK for Senzing API over gRPC

g2-sdk-python-grpc

:warning: WARNING: g2-sdk-python-grpc is still in development :warning: _

At the moment, this is "work-in-progress" with Semantic Versions of 0.n.x. Although it can be reviewed and commented on, the recommendation is not to use it yet.

Synopsis

The Senzing g2-sdk-python-grpc package provides a Python Software Development Kit adhering to the abstract classes of g2-sdk-python-next that communicates with a Senzing gRPC server.

Overview

The Senzing g2-sdk-python-grpc packages enable Python programs to call Senzing library functions across a network to a Senzing gRPC server.

The g2-sdk-python-grpc package implement thes following g2-sdk-python interfaces:

1. G2config
2. G2configmgr
3. G2diagnostic
4. G2engine
5. G2product

Other implementations of the g2-sdk-python interface include:

• g2-sdk-python-next - for calling Senzing SDK APIs natively

Use

The following example shows how to start a Senzing gRPC server Docker container and access it using the senzing_grpc python package.

1. In a separate window, run a Senzing gRPC service using Docker.

   Note: In this example, SENZING_TOOLS_DATABASE_URL specifies a file inside the container. Thus it is temporal and will be deleted when the container is killed. Example:

   docker run \
     --env SENZING_TOOLS_COMMAND=serve-grpc \
     --env SENZING_TOOLS_DATABASE_URL=sqlite3://na:na@/tmp/sqlite/G2C.db \
     --env SENZING_TOOLS_ENABLE_ALL=true \
     --name senzing-tools-serve-grpc \
     --publish 8261:8261 \
     --rm \
     senzing/senzing-tools
   

2. Install the senzing-grpc python package. Example:

   python3 -m pip install senzing-grpc
   

3. Start an interactive python session. Example:

   python3
   

4. Paste the following into the interactive Python session. Example:

   import grpc
   from senzing_grpc import G2ProductGrpc
   g2_product = G2ProductGrpc(grpc_channel=grpc.insecure_channel("localhost:8261"))
   print(g2_product.version())
   

References

1. Development
2. Errors
3. Examples
4. g2-sdk-python-next package reference