#329 Savepoint

Author: docktermj

docs/development.md

@@ -36,6 +36,7 @@ Since the Senzing library is a prerequisite, it must be installed first.
     export GIT_REPOSITORY=serve-grpc
     export GIT_ACCOUNT_DIR=~/${GIT_ACCOUNT}.git
     export GIT_REPOSITORY_DIR="${GIT_ACCOUNT_DIR}/${GIT_REPOSITORY}"
+
     ```
 
 1. Using the environment variables values just set, follow
@@ -49,6 +50,7 @@ Since the Senzing library is a prerequisite, it must be installed first.
     ```console
     cd ${GIT_REPOSITORY_DIR}
     make dependencies-for-development
+
     ```
 
 1. Install dependencies needed for [Go] code.
@@ -57,6 +59,7 @@ Since the Senzing library is a prerequisite, it must be installed first.
     ```console
     cd ${GIT_REPOSITORY_DIR}
     make dependencies
+
     ```
 
 ## Lint
@@ -67,6 +70,7 @@ Since the Senzing library is a prerequisite, it must be installed first.
     ```console
     cd ${GIT_REPOSITORY_DIR}
     make lint
+
     ```
 
 ## Build
@@ -77,13 +81,15 @@ Since the Senzing library is a prerequisite, it must be installed first.
     ```console
     cd ${GIT_REPOSITORY_DIR}
     make clean build
+
     ```
 
 1. The binaries will be found in the `${GIT_REPOSITORY_DIR}/target` directory.
    Example:
 
     ```console
     tree ${GIT_REPOSITORY_DIR}/target
+
     ```
 
 ## Run
@@ -98,6 +104,7 @@ Since the Senzing library is a prerequisite, it must be installed first.
 
             ```console
             export SENZING_TOOLS_DATABASE_FILE=/tmp/sqlite/G2C.db
+
             ```
 
         1. Copy template database and run command.
@@ -108,18 +115,21 @@ Since the Senzing library is a prerequisite, it must be installed first.
             cp ${GIT_REPOSITORY_DIR}/testdata/sqlite/G2C.db ${SENZING_TOOLS_DATABASE_FILE}
             export SENZING_TOOLS_DATABASE_URL=sqlite3://na:na@nowhere${SENZING_TOOLS_DATABASE_FILE}
             ${GIT_REPOSITORY_DIR}/target/linux-amd64/serve-grpc
+
             ```
 
     1. macOS
 
         ```console
         ${GIT_REPOSITORY_DIR}/target/darwin-amd64/serve-grpc
+
         ```
 
     1. Windows
 
         ```console
         ${GIT_REPOSITORY_DIR}/target/windows-amd64/serve-grpc
+
         ```
 
 1. Clean up.
@@ -128,6 +138,7 @@ Since the Senzing library is a prerequisite, it must be installed first.
     ```console
     cd ${GIT_REPOSITORY_DIR}
     make clean
+
     ```
 
 ## Test
@@ -138,6 +149,7 @@ Since the Senzing library is a prerequisite, it must be installed first.
     ```console
     cd ${GIT_REPOSITORY_DIR}
     make clean setup test
+
     ```
 
 1. **Optional:** View the SQLite database.
@@ -152,6 +164,7 @@ Since the Senzing library is a prerequisite, it must be installed first.
         --tty \
         --volume /tmp/sqlite:/data \
         coleifer/sqlite-web
+
     ```
 
    Visit [localhost:9174].
@@ -166,6 +179,7 @@ Create a code coverage map.
     ```console
     cd ${GIT_REPOSITORY_DIR}
     make clean setup coverage
+
     ```
 
    A web-browser will show the results of the coverage.
@@ -180,6 +194,7 @@ Create a code coverage map.
     ```console
     cd ${GIT_REPOSITORY_DIR}
     make clean documentation
+
     ```
 
 1. If a web page doesn't appear, visit [localhost:6060].
@@ -197,6 +212,7 @@ Example:
     ```console
     cd ${GIT_REPOSITORY_DIR}
     make clean
+
     ```
 
 ## Docker
@@ -207,6 +223,7 @@ Example:
     ```console
     cd ${GIT_REPOSITORY_DIR}
     make docker-build
+
     ```
 
 1. Run docker container.
@@ -219,6 +236,7 @@ Example:
         --rm \
         --tty \
         senzing/serve-grpc
+
     ```
 
 1. **Optional:** Test using `docker-compose`.
@@ -227,13 +245,15 @@ Example:
     ```console
     cd ${GIT_REPOSITORY_DIR}
     make clean docker-test
+
     ```
 
    To bring the `docker-compose` formation, run
 
     ```console
     cd ${GIT_REPOSITORY_DIR}
     make clean
+
     ```
 
 ## Package
@@ -250,13 +270,15 @@ The actual packaging is done in the [senzing-tools] repository.
     ```console
     cd ${GIT_REPOSITORY_DIR}
     make package
+
     ```
 
 1. The results will be in the `${GIT_REPOSITORY_DIR}/target` directory.
    Example:
 
     ```console
     tree ${GIT_REPOSITORY_DIR}/target
+
     ```
 
 ### Test DEB package on Ubuntu
@@ -266,6 +288,7 @@ The actual packaging is done in the [senzing-tools] repository.
 
     ```console
     apt list --installed | grep serve-grpc
+
     ```
 
 1. :pencil2: Install `serve-grpc`.
@@ -275,13 +298,15 @@ The actual packaging is done in the [senzing-tools] repository.
     ```console
     cd ${GIT_REPOSITORY_DIR}/target
     sudo apt install ./serve-grpc-0.0.0.deb
+
     ```
 
 1. :pencil2: Identify a location for database.
     Example:
 
     ```console
     export SENZING_TOOLS_DATABASE_FILE=/tmp/sqlite/G2C.db
+
     ```
 
 1. Copy template database and run command.
@@ -291,6 +316,7 @@ The actual packaging is done in the [senzing-tools] repository.
     mkdir --parents ${SENZING_TOOLS_DATABASE_FILE%/*}
     cp ${GIT_REPOSITORY_DIR}/testdata/sqlite/G2C.db ${SENZING_TOOLS_DATABASE_FILE}
     export SENZING_TOOLS_DATABASE_URL=sqlite3://na:na@nowhere${SENZING_TOOLS_DATABASE_FILE}
+
     ```
 
 1. :pencil2: Run command.
@@ -299,13 +325,15 @@ The actual packaging is done in the [senzing-tools] repository.
     ```console
     export LD_LIBRARY_PATH=/opt/senzing/er/lib/
     serve-grpc
+
     ```
 
 1. Remove `serve-grpc` from system.
    Example:
 
     ```console
     sudo apt-get remove serve-grpc
+
     ```
 
 ### Test RPM package on Centos
@@ -315,6 +343,7 @@ The actual packaging is done in the [senzing-tools] repository.
 
     ```console
     yum list installed | grep serve-grpc
+
     ```
 
 1. :pencil2: Install `serve-grpc`.
@@ -324,6 +353,7 @@ The actual packaging is done in the [senzing-tools] repository.
     ```console
     cd ${GIT_REPOSITORY_DIR}/target
     sudo yum install ./serve-grpc-0.0.0.rpm
+
     ```
 
 1. :pencil2: Identify database.
@@ -332,6 +362,7 @@ The actual packaging is done in the [senzing-tools] repository.
 
     ```console
     export SENZING_TOOLS_DATABASE_URL=sqlite3://na:na@nowhere/tmp/sqlite/G2C.db
+
     ```
 
 1. Run command.
@@ -340,13 +371,15 @@ The actual packaging is done in the [senzing-tools] repository.
     ```console
     export LD_LIBRARY_PATH=/opt/senzing/er/lib/
     serve-grpc
+
     ```
 
 1. Remove `serve-grpc` from system.
    Example:
 
     ```console
     sudo yum remove serve-grpc
+
     ```
 
 ## Specialty
@@ -362,6 +395,7 @@ in testing the `sz-sdk-go-core` packages.
 
     ```console
     export SENZING_DEMO_DIR=~/my-senzing-demo
+
     ```
 
 1. Bring up the docker-compose stack.
@@ -390,6 +424,7 @@ in testing the `sz-sdk-go-core` packages.
 
     cd ${SENZING_DEMO_DIR}
     sudo --preserve-env docker-compose up
+
     ```
 
 1. In a separate terminal window, set environment variables.
@@ -399,13 +434,15 @@ in testing the `sz-sdk-go-core` packages.
     ```console
     export LOCAL_IP_ADDRESS=$(curl --silent https://raw.githubusercontent.com/senzing-garage/knowledge-base/main/gists/find-local-ip-address/find-local-ip-address.py | python3 -)
     export SENZING_TOOLS_DATABASE_URL=postgresql://postgres:postgres@${LOCAL_IP_ADDRESS}:5432/er/?sslmode=disable
+
     ```
 
 1. Run tests.
 
     ```console
     cd ${GIT_REPOSITORY_DIR}
     make clean test
+
     ```
 
 1. **Optional:** View the PostgreSQL database.
@@ -423,6 +460,7 @@ in testing the `sz-sdk-go-core` packages.
 
     cd ${GIT_REPOSITORY_DIR}
     make clean
+
     ```
 
 ### Test using bloomrpc
@@ -441,6 +479,7 @@ For other gRPC tools, visit [Awesome gRPC].
            ```console
            wget https://github.com/bloomrpc/bloomrpc/releases/download/1.5.3/bloomrpc_1.5.3_amd64.deb
            sudo apt install ./bloomrpc_1.5.3_amd64.deb
+
            ```
 
 1. Start the test server.
@@ -449,13 +488,15 @@ For other gRPC tools, visit [Awesome gRPC].
     ```console
     cd ${GIT_REPOSITORY_DIR}
     make clean run-serve-grpc
+
     ```
 
 1. In a separate terminal, start the gRPC test client.
    Example:
 
     ```console
     bloomrpc
+
     ```
 
 1. In `bloomrpc`:
@@ -474,6 +515,7 @@ For other gRPC tools, visit [Awesome gRPC].
               "iniParams": "{\"PIPELINE\":{\"CONFIGPATH\":\"/etc/opt/senzing\",\"RESOURCEPATH\":\"/opt/senzing/er/resources\",\"SUPPORTPATH\":\"/opt/senzing/data\"},\"SQL\":{\"CONNECTION\":\"sqlite3://na:na@nowhere/tmp/sqlite/G2C.db\"}}",
               "verboseLogging": 0
             }
+
             ```
 
         1. Near the center, click the green "play" button.

go.mod

@@ -12,7 +12,7 @@ require (
 	github.com/senzing-garage/go-observing v0.3.3
 	github.com/senzing-garage/sz-sdk-go v0.14.2
 	github.com/senzing-garage/sz-sdk-go-core v0.8.3
-	github.com/senzing-garage/sz-sdk-proto v0.7.9
+	github.com/senzing-garage/sz-sdk-proto v0.7.10-0.20241009171550-675844cbe133
 	github.com/spf13/cobra v1.8.1
 	github.com/spf13/viper v1.19.0
 	github.com/stretchr/testify v1.9.0
@@ -39,7 +39,7 @@ require (
 	github.com/spf13/pflag v1.0.5 // indirect
 	github.com/subosito/gotenv v1.6.0 // indirect
 	go.uber.org/multierr v1.11.0 // indirect
-	golang.org/x/exp v0.0.0-20241004190924-225e2abe05e6 // indirect
+	golang.org/x/exp v0.0.0-20241009180824-f66d83c29e7c // indirect
 	golang.org/x/net v0.30.0 // indirect
 	golang.org/x/sys v0.26.0 // indirect
 	golang.org/x/text v0.19.0 // indirect

go.sum

@@ -50,8 +50,8 @@ github.com/senzing-garage/sz-sdk-go v0.14.2 h1:1LksQW0+epSY0DhlxThxrnfeDwgyLPvyq
 github.com/senzing-garage/sz-sdk-go v0.14.2/go.mod h1:rj9HH6qo+kW5PsFSRnEIUQqDZBE34gZjQGsDvAxw6dI=
 github.com/senzing-garage/sz-sdk-go-core v0.8.3 h1:FlBRkqQd9QKPmr9KVVtG+FsoczqO+fXhRoZ9DnnvP0Y=
 github.com/senzing-garage/sz-sdk-go-core v0.8.3/go.mod h1:uwAgQ/Ai8gKhJL/5TYMWYoDte7wnDqJXPWRD5A/Ushg=
-github.com/senzing-garage/sz-sdk-proto v0.7.9 h1:B8X8Y+D9a/s6Alo35XX0QpTZMCmEMNOPDDCN+pqwpLU=
-github.com/senzing-garage/sz-sdk-proto v0.7.9/go.mod h1:pvaLa5AR36n5T59Perh/zulKKPe6EB1HTWGhSP4smb4=
+github.com/senzing-garage/sz-sdk-proto v0.7.10-0.20241009171550-675844cbe133 h1:IxmpWHlSGbq05FurNpGlUyVbCgi8sRpLesAbOOS3SYY=
+github.com/senzing-garage/sz-sdk-proto v0.7.10-0.20241009171550-675844cbe133/go.mod h1:pvaLa5AR36n5T59Perh/zulKKPe6EB1HTWGhSP4smb4=
 github.com/sourcegraph/conc v0.3.0 h1:OQTbbt6P72L20UqAkXXuLOj79LfEanQ+YQFNpLA9ySo=
 github.com/sourcegraph/conc v0.3.0/go.mod h1:Sdozi7LEKbFPqYX2/J+iBAM6HpqSLTASQIKqDmF7Mt0=
 github.com/spf13/afero v1.11.0 h1:WJQKhtpdm3v2IzqG8VMqrr6Rf3UYpEF239Jy9wNepM8=
@@ -70,8 +70,8 @@ github.com/subosito/gotenv v1.6.0 h1:9NlTDc1FTs4qu0DDq7AEtTPNw6SVm7uBMsUCUjABIf8
 github.com/subosito/gotenv v1.6.0/go.mod h1:Dk4QP5c2W3ibzajGcXpNraDfq2IrhjMIvMSWPKKo0FU=
 go.uber.org/multierr v1.11.0 h1:blXXJkSxSSfBVBlC76pxqeO+LN3aDfLQo+309xJstO0=
 go.uber.org/multierr v1.11.0/go.mod h1:20+QtiLqy0Nd6FdQB9TLXag12DsQkrbs3htMFfDN80Y=
-golang.org/x/exp v0.0.0-20241004190924-225e2abe05e6 h1:1wqE9dj9NpSm04INVsJhhEUzhuDVjbcyKH91sVyPATw=
-golang.org/x/exp v0.0.0-20241004190924-225e2abe05e6/go.mod h1:NQtJDoLvd6faHhE7m4T/1IY708gDefGGjR/iUW8yQQ8=
+golang.org/x/exp v0.0.0-20241009180824-f66d83c29e7c h1:7dEasQXItcW1xKJ2+gg5VOiBnqWrJc+rq0DPKyvvdbY=
+golang.org/x/exp v0.0.0-20241009180824-f66d83c29e7c/go.mod h1:NQtJDoLvd6faHhE7m4T/1IY708gDefGGjR/iUW8yQQ8=
 golang.org/x/net v0.30.0 h1:AcW1SDZMkb8IpzCdQUaIq2sP4sZ4zw+55h6ynffypl4=
 golang.org/x/net v0.30.0/go.mod h1:2wGyMJ5iFasEhkwi13ChkO/t1ECNC4X4eBKkVFyYFlU=
 golang.org/x/sys v0.26.0 h1:KHjCJyddX0LoSTb3J+vWpupP9p0oznkqVk/IfjymZbo=