Release 0.10.0

.github/workflows/cicd.yml

@@ -23,6 +23,8 @@ on:
   release:
     types:
       - published
+  schedule:
+    - cron: '15 5 * * TUE'
 
 jobs:
   build:
@@ -31,7 +33,7 @@ jobs:
     strategy:
       matrix:
         python-version: 
-          - '3.7'
+          - '3.8'
           - '3.11'
 
     steps:

.pre-commit-config.yaml

@@ -1,14 +1,14 @@
 repos:
   - repo: https://github.com/psf/black
-    rev: 22.10.0
+    rev: 23.1.0
     hooks:
       - id: black
   - repo: https://github.com/pycqa/flake8
-    rev: 5.0.4
+    rev: 6.0.0
     hooks:
       - id: flake8
   - repo: https://github.com/pycqa/isort
-    rev: 5.10.1
+    rev: 5.12.0
     hooks:
       - id: isort
         name: isort (python)

case_utils/__init__.py

@@ -11,6 +11,6 @@
 #
 # We would appreciate acknowledgement if the software is used.
 
-__version__ = "0.9.0"
+__version__ = "0.10.0"
 
 from . import local_uuid  # noqa: F401

case_utils/case_file/__init__.py

@@ -39,6 +39,7 @@
 
 DEFAULT_PREFIX = "http://example.org/kb/"
 
+
 # Shortcut syntax for defining an immutable named tuple is noted here:
 # https://docs.python.org/3/library/typing.html#typing.NamedTuple
 # via the "See also" box here: https://docs.python.org/3/library/collections.html#collections.namedtuple

case_utils/case_sparql_construct/__init__.py

@@ -15,7 +15,7 @@
 This script executes a SPARQL CONSTRUCT query, returning a graph of the generated triples.
 """
 
-__version__ = "0.2.4"
+__version__ = "0.2.5"
 
 import argparse
 import logging
@@ -98,10 +98,11 @@ def main() -> None:
     construct_query_result = in_graph.query(construct_query_object)
     _logger.debug("type(construct_query_result) = %r." % type(construct_query_result))
     _logger.debug("len(construct_query_result) = %d." % len(construct_query_result))
-    for (row_no, row) in enumerate(construct_query_result):
+    for row_no, row in enumerate(construct_query_result):
+        assert isinstance(row, tuple)
         if row_no == 0:
             _logger.debug("row[0] = %r." % (row,))
-        out_graph.add(row)
+        out_graph.add((row[0], row[1], row[2]))
 
     output_format = None
     if args.output_format is None:

case_utils/case_sparql_select/__init__.py

@@ -26,7 +26,7 @@
 Should a more complex query be necessary, an outer, wrapping SELECT query would let this script continue to function.
 """
 
-__version__ = "0.5.0"
+__version__ = "0.5.1"
 
 import argparse
 import binascii
@@ -86,26 +86,27 @@ def graph_and_query_to_data_frame(
     select_query_object = rdflib.plugins.sparql.processor.prepareQuery(
         select_query_text, initNs=nsdict
     )
-    for (row_no, row) in enumerate(_graph.query(select_query_object)):
+    for row_no, row in enumerate(_graph.query(select_query_object)):
+        assert isinstance(row, rdflib.query.ResultRow)
         tally = row_no + 1
         record = []
-        for (column_no, column) in enumerate(row):
+        for column_no, column in enumerate(row):
             if column is None:
                 column_value = ""
-            elif (
-                isinstance(column, rdflib.term.Literal)
-                and column.datatype == NS_XSD.hexBinary
-            ):
-                # Use hexlify to convert xsd:hexBinary to ASCII.
-                # The render to ASCII is in support of this script rendering results for website viewing.
-                # .decode() is because hexlify returns bytes.
-                column_value = binascii.hexlify(column.toPython()).decode()
+            elif isinstance(column, rdflib.term.Literal):
+                if column.datatype == NS_XSD.hexBinary:
+                    # Use hexlify to convert xsd:hexBinary to ASCII.
+                    # The render to ASCII is in support of this script rendering results for website viewing.
+                    # .decode() is because hexlify returns bytes.
+                    column_value = binascii.hexlify(column.toPython()).decode()
+                else:
+                    column_value = column.toPython()
             elif isinstance(column, rdflib.URIRef):
                 if use_prefixes:
                     column_value = graph.namespace_manager.qname(column.toPython())
                 else:
                     column_value = column.toPython()
-            else:
+            elif isinstance(column, rdflib.BNode):
                 column_value = column.toPython()
             if row_no == 0:
                 _logger.debug("row[0]column[%d] = %r." % (column_no, column_value))

case_utils/local_uuid.py

@@ -15,7 +15,7 @@
 This library is a wrapper for uuid, provided to generate repeatable UUIDs if requested.
 """
 
-__version__ = "0.3.1"
+__version__ = "0.3.2"
 
 import logging
 import os
@@ -33,6 +33,9 @@
 
 
 def configure() -> None:
+    """
+    This function is part of setting up demo_uuid() to generate non-random UUIDs.  See demo_uuid() documentation for further setup notes.
+    """
     global DEMO_UUID_BASE
 
     if os.getenv("DEMO_UUID_REQUESTING_NONRANDOM") == "NONRANDOM_REQUESTED":
@@ -112,7 +115,10 @@ def demo_uuid() -> str:
 
     WARNING: This function was developed for use ONLY for reducing (but not eliminating) version-control edits to identifiers when generating sample data.  It creates UUIDs that are decidedly NOT random, and should remain consistent on repeated calls to the importing script.
 
-    To prevent accidental non-random UUID usage, an environment variable, CASE_DEMO_NONRANDOM_UUID_BASE, must be set to a string provided by the caller.  The variable's required value is the path to some directory.  The variable's recommended value is the equivalent of the Make variable "top_srcdir" - that is, the root directory of the containing Git repository, some parent of the current process's current working directory.
+    To prevent accidental non-random UUID usage, two setup steps need to be done before calling this function:
+
+    * An environment variable, CASE_DEMO_NONRANDOM_UUID_BASE, must be set to a string provided by the caller.  The variable's required value is the path to some directory.  The variable's recommended value is the equivalent of the Make variable "top_srcdir" - that is, the root directory of the containing Git repository, some parent of the current process's current working directory.
+    * The configure() function in this module must be called.
     """
     global DEMO_UUID_BASE
     global DEMO_UUID_COUNTER

case_utils/ontology/Makefile

@@ -29,8 +29,16 @@ all: \
 .PRECIOUS: \
   case-$(case_version).ttl
 
+$(case_srcdir)/.venv.done.log: \
+  $(top_srcdir)/.git_submodule_init.done.log
+	$(MAKE) \
+	  --directory $(case_srcdir) \
+	    .venv.done.log
+	touch -c $@
+	test -r $@
+
 case-$(case_version).ttl: \
-  $(top_srcdir)/.git_submodule_init.done.log \
+  $(case_srcdir)/.venv.done.log \
   $(RDF_TOOLKIT_JAR)
 	$(MAKE) \
 	  --directory $(case_srcdir)/tests \
@@ -47,10 +55,7 @@ case-$(case_version)-subclasses.ttl: \
 	# release is being made, that step will have been skipped.
 	# This recursive Make call guarantees the virtual environment is
 	# set up.
-	$(MAKE) \
-	  --directory $(case_srcdir)/tests \
-	    .venv.done.log
-	source $(case_srcdir)/tests/venv/bin/activate \
+	source $(case_srcdir)/venv/bin/activate \
 	  && python3 src/subclasses_ttl.py \
 	  __$@ \
 	 $<
@@ -70,11 +75,7 @@ clean:
 ontology_and_version_iris.txt: \
   src/ontology_and_version_iris.py \
   case-$(case_version)-subclasses.ttl
-	# Guarantee venv is built.  (Same rationale as in the subclasses.ttl recipe.)
-	$(MAKE) \
-	  --directory $(case_srcdir)/tests \
-	    .venv.done.log
-	source $(case_srcdir)/tests/venv/bin/activate \
+	source $(case_srcdir)/venv/bin/activate \
 	  && python3 src/ontology_and_version_iris.py \
 	    _$@ \
 	    case-*.ttl