#52 - Additional Python snippets (#64)

Author: antaenc

CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog], [markdownlint],
 and this project adheres to [Semantic Versioning].
 
+## [0.0.10] - 2025-08-11
+
+### Added in 0.0.10
+
+- New Python snippets
+
 ## [0.0.9] - 2025-07-23
 
 ### Changed in 0.0.9

python/deleting/delete_futures.py

@@ -64,7 +64,7 @@ def futures_del(engine, input_file):
 
                         del futures[f]
 
-            print(f"\nSuccessfully deleted {success_recs:,} records, with" f" {error_recs:,} errors")
+            print(f"\nSuccessfully deleted {success_recs:,} records, with {error_recs:,} errors")
 
 
 try:

python/deleting/delete_with_info_futures.py

@@ -74,7 +74,7 @@ def futures_del(engine, input_file, output_file):
 
                             del futures[f]
 
-                print(f"\nSuccessfully deleted {success_recs:,} records, with" f" {error_recs:,} errors")
+                print(f"\nSuccessfully deleted {success_recs:,} records, with {error_recs:,} errors")
                 print(f"\nWith info responses written to {output_file}")
 
 

python/information/get_stats.py

@@ -77,7 +77,7 @@ def futures_add(engine, input_file):
 
                         del futures[f]
 
-            print(f"\nSuccessfully loaded {success_recs:,} records, with" f" {error_recs:,} errors")
+            print(f"\nSuccessfully loaded {success_recs:,} records, with {error_recs:,} errors")
 
 
 try:

python/initialization/README.md

@@ -18,12 +18,17 @@
   - Priming the Senzing engine before use loads resource intensive assets upfront. 
   - Without priming the first SDK call to the engine will appear slower than usual as it causes these assets to be loaded.
 - **factory_destroy.py**
-  - Calls `destroy` on the abstract factory destroying the abstract factory and any Senzing objects it has created.
+  - Calls `destroy()` on the abstract factory destroying the abstract factory and any Senzing objects it has created.
   - The abstract factory must exist for the life of Senzing objects it has created.
-  - If the abstract factory goes out of scope `destroy` is automatically called
+  - If the abstract factory goes out of scope `destroy()` is automatically called
 - **purge_repository.py**
   - **WARNING** This script will remove all data from a Senzing repository, use with caution! **WARNING**.
   - It will prompt first, still use with caution!.
+  **signal_handler.py**
+  - Catches signal.SIGINT (ctrl + c) and exits cleanly
+  - Exiting cleanly on a signal ensures resource cleanup for the abstract factory is automatically called
+  - If sz_abstract_factory goes out of scope 'destroy()` is automatically called, if signals are not caught and handled automatic resource cleanup does not happen
+  - `destroy()` could also be called directly on the abstract factory by the signal handler
 - **sz_engine_config_ini_to_json.py**
   - The snippets herein utilize the `SENZING_ENGINE_CONFIGURATION_JSON` environment variable for Senzing abstract factory creation.
   - If you are familiar with working with a Senzing project you may be aware the same configuration data is held in the sz_engine_config.ini file.

python/initialization/signal_handler.py

@@ -0,0 +1,29 @@
+#! /usr/bin/env python3
+
+import os
+import signal
+import sys
+from pathlib import Path
+
+from senzing import SzError
+from senzing_core import SzAbstractFactoryCore
+
+INSTANCE_NAME = Path(__file__).stem
+SETTINGS = os.getenv("SENZING_ENGINE_CONFIGURATION_JSON", "{}")
+
+
+def handler(signum, frame):
+    print("\nCaught ctrl-c, exiting")
+    sys.exit(0)
+
+
+signal.signal(signal.SIGINT, handler)
+
+try:
+    sz_abstract_factory = SzAbstractFactoryCore(INSTANCE_NAME, SETTINGS)
+    sz_engine = sz_abstract_factory.create_engine()
+    # Do work...
+    print("\nSimulating work, press ctrl-c to exit...")
+    signal.pause()
+except SzError as err:
+    print(f"\n{err.__class__.__name__} - {err}")

python/loading/add_futures.py

@@ -64,7 +64,7 @@ def futures_add(engine, input_file):
 
                         del futures[f]
 
-            print(f"\nSuccessfully loaded {success_recs:,} records, with" f" {error_recs:,} errors")
+            print(f"\nSuccessfully loaded {success_recs:,} records, with {error_recs:,} errors")
 
 
 try:

python/loading/add_with_info_futures.py

@@ -87,7 +87,7 @@ def futures_add(engine, input_file, output_file):
 
                             del futures[f]
 
-                print(f"\nSuccessfully loaded {success_recs:,} records, with" f" {error_recs:,} errors")
+                print(f"\nSuccessfully loaded {success_recs:,} records, with {error_recs:,} errors")
                 print(f"\nWith info responses written to {output_file}")
 
 

python/redo/add_with_redo.py

@@ -66,7 +66,7 @@ def process_redo(engine):
 
             success_recs += 1
             if success_recs % 1 == 0:
-                print(f"Processed {success_recs:,} redo records, with" f" {error_recs:,} errors")
+                print(f"Processed {success_recs:,} redo records, with {error_recs:,} errors")
         except SzBadInputError as err:
             mock_logger("ERROR", err)
             error_recs += 1
@@ -77,7 +77,7 @@ def process_redo(engine):
             mock_logger("CRITICAL", err)
             raise err
 
-    print(f"\nSuccessfully processed {success_recs:,} redo records, with" f" {error_recs:,} errors")
+    print(f"\nSuccessfully processed {success_recs:,} redo records, with {error_recs:,} errors")
 
 
 try:

python/redo/redo_continuous.py

@@ -1,6 +1,7 @@
 #! /usr/bin/env python3
 
 import os
+import signal
 import sys
 import time
 from pathlib import Path
@@ -12,6 +13,11 @@
 SETTINGS = os.getenv("SENZING_ENGINE_CONFIGURATION_JSON", "{}")
 
 
+def handler(signum, frame):
+    print("\nCaught ctrl-c, exiting")
+    sys.exit(0)
+
+
 def mock_logger(level, error, error_record=None):
     print(f"\n{level}: {error.__class__.__name__} - {error}", file=sys.stderr)
     if error_record:
@@ -27,7 +33,7 @@ def process_redo(engine):
             if not (response := engine.get_redo_record()):
                 print(
                     "No redo records to process, pausing for 30 seconds. Total"
-                    f" processed {success_recs:,} . (CTRL-C to exit)..."
+                    f" processed: {success_recs:,} (ctrl-c to exit)..."
                 )
                 time.sleep(30)
                 continue
@@ -36,7 +42,7 @@ def process_redo(engine):
 
             success_recs += 1
             if success_recs % 100 == 0:
-                print(f"Processed {success_recs:,} redo records, with" f" {error_recs:,} errors")
+                print(f"Processed {success_recs:,} redo records, with {error_recs:,} errors")
         except SzBadInputError as err:
             mock_logger("ERROR", err)
             error_recs += 1
@@ -47,6 +53,8 @@ def process_redo(engine):
             raise err
 
 
+signal.signal(signal.SIGINT, handler)
+
 try:
     sz_factory = SzAbstractFactoryCore(INSTANCE_NAME, SETTINGS, verbose_logging=False)
     sz_engine = sz_factory.create_engine()