g2-sdk-python

If you are beginning your journey with Senzing, please start with Senzing Quick Start guides.

You are in the Senzing Garage where projects are "tinkered" on. Although this GitHub repository may help you understand an approach to using Senzing, it's not considered to be "production ready" and is not considered to be part of the Senzing product. Heck, it may not even be appropriate for your application of Senzing!

Synopsis

Senzing Software Development Kit (SDK) for Python. This SDK provide python access to the senzingapi

Warning: Using pip install senzing-ce will install a version of the Senzing Python SDK that is not covered by Senzing's Service Level Agreement (SLA). To obtain a version of the Senzing Python SDK that is covered, see Install Senzing API.

More information at github.com/senzing-garage/g2-sdk-python

Overview

The git repository at github.com/senzing-garage/g2-sdk-python 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.

Install
Develop
References

Install

Use the pip install command to install the Senzing SDK for Python community edition. Example:
```
pip install senzing-ce
```
More information at github.com/senzing-garage/g2-sdk-python

Develop

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

Prerequisites for development

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

The following software programs need to be installed:
1. git
2. make
3. pip

✏️ Make a ~/.pypirc file. Example:

[pypi]
  username = __token__
  password = pypi-aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

[testpypi]
  username = __token__
  password = pypi-bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb

Clone repository

For more information on environment variables, see Environment Variables.

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}"

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

Install dependencies

Install python tools via Makefile. Example:

cd ${GIT_REPOSITORY_DIR}
make install-dependencies

Build python packages

Build pip package using python3 -m build via Makefile. Example:
```
cd ${GIT_REPOSITORY_DIR}
make package
```
Output will be in the dist directory.

Local test

Install from file

Install using pip via Makefile. Example:

cd ${GIT_REPOSITORY_DIR}
make install-file

Test local package

Run testcases found in tests directory. Example:
```
cd ${GIT_REPOSITORY_DIR}
make test
```

Uninstall local package

Remove senzing. Example:
```
cd ${GIT_REPOSITORY_DIR}
make uninstall
```

Publish

⚠️ On PyPi and test.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.

Publish to test.pypi.org

Publish to https://test.pypi.org. This is a test PyPi server. Example:
```
cd ${GIT_REPOSITORY_DIR}
make publish-test
```

Publish to pypi.org

Publish to https://pypi.org. :warning: This requires that the workstation has gpg enabled with the signing key for "Senzing, Inc." Example:
```
cd ${GIT_REPOSITORY_DIR}
make publish-signed
```

Test

Install from test.pypi.org