senzing 1.3.0

Python SDK for Senzing API

g2-sdk-python

Synopsis

Senzing Software Development Kit (SDK) for Python. Files are located in src/senzing.

Overview

This repository contains the Senzing SDK for Python files in src/senzing. It also contains:

• Tooling to create Python "wheel" packages
• Test suites
• Instructions for publishing to PyPi.

Contents

1. Develop
   1. Prerequisites for development
   2. FIXME:

Develop

The following instructions are used when modifying and building the Docker image.

Prerequisites for development

:thinking: The following tasks need to be complete before proceeding. These are "one-time tasks" which may already have been completed.

1. The following software programs need to be installed:

   1. git
   2. make
   3. pip

2. Install python tools. Example:

   python3 -m pip install --upgrade build
   python3 -m pip install --upgrade twine
   

Clone repository

For more information on environment variables, see Environment Variables.

1. Set these environment variable values:

   export GIT_ACCOUNT=senzing
   export GIT_REPOSITORY=g2-sdk-python
   export GIT_ACCOUNT_DIR=~/${GIT_ACCOUNT}.git
   export GIT_REPOSITORY_DIR="${GIT_ACCOUNT_DIR}/${GIT_REPOSITORY}"
   

2. Using the environment variables values just set, follow steps in clone-repository to install the Git repository.

Build python packages

1. Build pip package using python3 -m build. Example:

   cd ${GIT_REPOSITORY_DIR}
   make package
   

   Output will be in the dist directory.

Local test

Install from file

1. Install using pip. Example:

   make file-install
   

Test local package

1. Run testcases found in tests directory. Example:

   make test
   

Uninstall local package

1. Remove senzing. Example:

   pip3 uninstall senzing
   

Publish

:warning: On PyPi, pip package versions are immmutable. They cannot be deleted nor updated. Since only one instance of a version can be published, be careful on what is published.

1. Publish to https://test.pypi.org. This is a test PyPi server. Example:

   cd ${GIT_REPOSITORY_DIR}
   make test-publish
   

Install from test.pypi.org

1. Install using pip. Example:

   pip3 install \
     --index-url https://test.pypi.org/simple/ \
     --no-deps \
     senzing
   

Test

1. Run testcases found in tests directory. Example:

   make test
   

Uninstall

1. Remove Senzing SDK for Python. Example:

   pip3 uninstall senzing
   

Verify Uninstall

1. Identify python version. Example:

   export SENZING_PYTHON_VERSION=3.8
   

2. Verify deletion in user python repository. Example:

   ls ~/.local/lib/python${SENZING_PYTHON_VERSION}/site-packages | grep senzing
   

   Should return nothing.

3. Verify deletion in system repository. Example:

   ls /usr/local/lib/python${SENZING_PYTHON_VERSION}/dist-packages | grep senzing
   

   Should return nothing.

References

1. Packaging Python Projects