Merge pull request #46 from casework/release-0.3.0

Release 0.3.0

.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+# This software was developed at the National Institute of Standards
+# and Technology by employees of the Federal Government in the course
+# of their official duties. Pursuant to title 17 Section 105 of the
+# United States Code this software is not subject to copyright
+# protection and is in the public domain. NIST assumes no
+# responsibility whatsoever for its use by other parties, and makes
+# no guarantees, expressed or implied, about its quality,
+# reliability, or any other characteristic.
+#
+# We would appreciate acknowledgement if the software is used.
+
+# This workflow uses Make to confirm ontology files have been
+# normalized according to the procedures in NORMALIZE.md.
+
+name: Continuous Integration
+
+on:
+  push:
+    branches: [ master, develop ]
+  pull_request:
+    branches: [ master, develop ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Start from clean state
+      run: make clean
+    - name: Run tests
+      run: make check

.gitignore

@@ -1,10 +1,13 @@
 *.pyc
 *.pyo
 
+# Unit testing files
+.lib.done.log
+.*.ttl
 
 # Pycharm files
 .idea
 
 # Protege files
 catalog-v001.xml
-.project
+.project

ChangeLog

@@ -1,28 +1,56 @@
+2021-03-18
+	* ONT-362: Release CASE 0.3.0, with release notes at https://caseontology.org/releases/0.3.0/
+
+2021-03-18
+	* (22b313d) ONT-413, CP-25: Defined and used prefixes for imported concepts (new feature)
+	* CP-25: https://drive.google.com/file/d/1HUeY8AHxsnukP0sFOvsPQZRuyNbqcf6n/view
+
+2021-03-17
+	* (f754fd4) ONT-379, CP-18: Updated and improve Investigation namespace class definition comments for clarity and consistency (new feature)
+	* CP-18: https://drive.google.com/file/d/1AmVX6x2ZORr2-h2OIXug2PiptYaHcvuh/view
+
+2021-03-16
+	* (a8209d7) ONT-363, CP-15: Removed intermediate role classes (breaking change)
+	* CP-15: https://drive.google.com/file/d/1PLcPA3TSDqt7wX84SYlezC1thK_Sznrc/view
+	* (b515a81) ONT-251, CP-16: Established unit tests and Continuous Integration for ontology repository (new feature)
+	* CP-16: https://drive.google.com/file/d/1622v5k7fXo2fjDs_EzfhbTyvWIjDBZv-/view
+
 2020-08-19
 	* ONT-293: Release CASE 0.2.0, with release notes at https://caseontology.org/releases/0.2.0/
 
 2020-08-13
-	* (19b698a) ONT-314: Removed documentation generated for CASE 0.1.0 (breaking change)
-	* (1d9b468) ONT-140: Linked Style Guidance as development practice (new feature)
-	* (965f5e4) ONT-231: Resolved naming inconsistency and associated equivalent class complexity (breaking change)
+	* (19b698a) ONT-314, CP-12: Removed documentation generated for CASE 0.1.0 (breaking change)
+	* CP-12: https://drive.google.com/file/d/1LE2P12w66TjIFVah567gyKbYWYkZziP5/view
+	* (1d9b468) ONT-140, CP-6: Linked Style Guidance as development practice (new feature)
+	* CP-6: https://drive.google.com/file/d/1jlCFCuL4BDojJOsIzR8asJjf-lAp8uLd/view
+	* (965f5e4) ONT-231, CP-10: Resolved naming inconsistency and associated equivalent class complexity (breaking change)
+	* CP-10: https://drive.google.com/file/d/1lut9Km0rYp2Iaftz7m0f4u50R4YD60F6/view
 
 2020-08-12
-	* (12a081a) ONT-318: Updated ontology README to reflect website and Jira (bugfix)
-	* (cd8b27f) ONT-281: Moved investigation.ttl and related vocabulary into CASE from UCO (new feature)
-	* (fe7f069) ONT-288: ChangeLog format selected (new feature)
+	* (12a081a) ONT-318, CP-13: Updated ontology README to reflect website and Jira (bugfix)
+	* CP-13: https://drive.google.com/file/d/1fJoDjMjfbaXw0BWKKZ_9mK-gZzoJpgFS/view
+	* (cd8b27f) ONT-281, CP-9: Moved investigation.ttl and related vocabulary into CASE from UCO (new feature)
+	* CP-9: https://drive.google.com/file/d/1TNL7NtkSy4Veo1eObJGCmMGvmmxqeCJB/view
+	* (fe7f069) ONT-288, CP-11: ChangeLog format selected (new feature)
+	* CP-11: https://drive.google.com/file/d/1zWjQ_uhhVxEjkqS2mrcabT4tNh8s0JQx/view
 
 2020-07-29
-	* (07e6c12) ONT-144: Moved examples directory to own repository, CASE-Examples (new feature, breaking change)
+	* (07e6c12) ONT-144, CP-7: Moved examples directory to own repository, CASE-Examples (new feature, breaking change)
+	* CP-7: https://drive.google.com/file/d/1DiLxBTQYt0FQSdjn3mX6RabhqK9QbiDo/view
 
 2020-06-16
-	* (2fed9a5) ONT-5: Established ontology normalization procedure (new feature)
+	* (2fed9a5) ONT-5, CP-3: Established ontology normalization procedure (new feature)
+	* CP-3: https://caseontology.org/resources/references/CASE%20Change%20Proposal%203.zip
 
 2020-04-01
-	* (5c2a19b) ONT-201: Renamed "propertyBundle" to "hasPropertyBundle", per CASE Style Guide
+	* (5c2a19b) ONT-201, CP-8: Renamed "propertyBundle" to "hasPropertyBundle", per CASE Style Guide
+	* CP-8: https://caseontology.org/resources/references/CASE%20Change%20Proposal%208.zip
 
 2019-08-06
-	* (ca5ca15) ONT-51: Separated CASE ontology files by namespace (breaking change)
+	* (ca5ca15) ONT-51, CP-4: Separated CASE ontology files by namespace (breaking change)
 
 2019-07-13
-	* (93b40ac) ONT-51: Removed prototype contents of case.ttl file (breaking change)
-	* (93b40ac) ONT-53: Changed namespace to caseontology.org (new feature, breaking change)
+	* (93b40ac) ONT-51, CP-4: Removed prototype contents of case.ttl file (breaking change)
+	* CP-4: https://drive.google.com/file/d/1CE9sfrc-czegRX15Q5xeqaffAfAH06ov/view
+	* (93b40ac) ONT-53, CP-2: Changed namespace to caseontology.org (new feature, breaking change)
+	* CP-2: https://drive.google.com/file/d/1_J3994JiPA5PMIHfno9x-NeXKaHFVCrJ/view

Makefile

@@ -0,0 +1,31 @@
+#!/usr/bin/make -f
+
+# This software was developed at the National Institute of Standards
+# and Technology by employees of the Federal Government in the course
+# of their official duties. Pursuant to title 17 Section 105 of the
+# United States Code this software is not subject to copyright
+# protection and is in the public domain. NIST assumes no
+# responsibility whatsoever for its use by other parties, and makes
+# no guarantees, expressed or implied, about its quality,
+# reliability, or any other characteristic.
+#
+# We would appreciate acknowledgement if the software is used.
+
+all:
+
+.lib.done.log:
+	$(MAKE) \
+	  --directory lib
+	touch $@
+
+check: \
+  .lib.done.log
+	$(MAKE) \
+	  --directory ontology \
+	  check
+
+clean:
+	@rm -f .lib.done.log
+	@$(MAKE) \
+	  --directory ontology \
+	  clean

lib/.gitignore

@@ -0,0 +1 @@
+*.jar

lib/Makefile

@@ -0,0 +1,46 @@
+#!/usr/bin/make -f
+
+# This software was developed at the National Institute of Standards
+# and Technology by employees of the Federal Government in the course
+# of their official duties. Pursuant to title 17 Section 105 of the
+# United States Code this software is not subject to copyright
+# protection and is in the public domain. NIST assumes no
+# responsibility whatsoever for its use by other parties, and makes
+# no guarantees, expressed or implied, about its quality,
+# reliability, or any other characteristic.
+#
+# We would appreciate acknowledgement if the software is used.
+
+SHELL := /bin/bash
+
+all: \
+  rdf-toolkit.jar
+
+# Downloading rdf-toolkit was previously done following the directions
+# at:
+#   https://github.com/edmcouncil/rdf-toolkit
+# However, on the file becoming temporarily unavailable, CASE has placed
+# a verified copy at a custom location, as a fallback for an alternative
+# retrieval from an EDM Council member's repository.
+# The checksum of the original file from EDM Council's build server is
+# confirmed before moving file into position.  (This practice will
+# probably require frequent updates, unless a signed checksum for the
+# jar can be retrieved somehow.)
+# In case there are concerns on potentially multiple writes to the same
+# file, the documentation for wget's "--output-document file" flag notes
+# that "... file will be truncated immediately, and all downloaded
+# content will be written there."
+rdf-toolkit.jar:
+	test -r rdf-toolkit.jar.sha512
+	# Try retrieval from Github, then from files.caseontology.org.
+	wget \
+	  --output-document $@_ \
+	  https://github.com/trypuz/openfibo/blob/1f9ab415e8ebd131eadcc9b0fc46241adeeb0384/etc/serialization/rdf-toolkit.jar?raw=true \
+	  || wget \
+	    --output-document $@_ \
+	    http://files.caseontology.org/rdf-toolkit.jar
+	test \
+	  "x$$(openssl dgst -sha512 $@_ | awk '{print($$NF)}')" \
+	  == \
+	  "x$$(head -n1 rdf-toolkit.jar.sha512)"
+	mv $@_ $@

lib/rdf-toolkit.jar.sha512

@@ -0,0 +1 @@
+24890b4aa484a46803841fbe5938daf60bf2d0889c0e231102c033d71cb84a2bfa8b44419df3ad896d833609afddd4b3910d2ce28660b3350cca22bea0770dad

ontology/Makefile

@@ -0,0 +1,67 @@
+#!/usr/bin/make -f
+
+# This software was developed at the National Institute of Standards
+# and Technology by employees of the Federal Government in the course
+# of their official duties. Pursuant to title 17 Section 105 of the
+# United States Code this software is not subject to copyright
+# protection and is in the public domain. NIST assumes no
+# responsibility whatsoever for its use by other parties, and makes
+# no guarantees, expressed or implied, about its quality,
+# reliability, or any other characteristic.
+#
+# We would appreciate acknowledgement if the software is used.
+
+all:
+
+top_srcdir := ..
+
+.PHONY: \
+  check-investigation \
+  check-master \
+  check-vocabulary \
+  clean-investigation \
+  clean-master \
+  clean-vocabulary
+
+check: \
+  check-master \
+  check-investigation \
+  check-vocabulary
+
+check-investigation: \
+  $(top_srcdir)/.lib.done.log
+	$(MAKE) \
+	  --directory investigation \
+	  check
+
+check-master: \
+  $(top_srcdir)/.lib.done.log
+	$(MAKE) \
+	  --directory master \
+	  check
+
+check-vocabulary: \
+  $(top_srcdir)/.lib.done.log
+	$(MAKE) \
+	  --directory vocabulary \
+	  check
+
+clean: \
+  clean-investigation \
+  clean-master \
+  clean-vocabulary
+
+clean-investigation:
+	@$(MAKE) \
+	  --directory investigation \
+	  clean
+
+clean-master:
+	@$(MAKE) \
+	  --directory master \
+	  clean
+
+clean-vocabulary:
+	@$(MAKE) \
+	  --directory vocabulary \
+	  clean

ontology/investigation/Makefile

@@ -0,0 +1,51 @@
+#!/usr/bin/make -f
+
+# This software was developed at the National Institute of Standards
+# and Technology by employees of the Federal Government in the course
+# of their official duties. Pursuant to title 17 Section 105 of the
+# United States Code this software is not subject to copyright
+# protection and is in the public domain. NIST assumes no
+# responsibility whatsoever for its use by other parties, and makes
+# no guarantees, expressed or implied, about its quality,
+# reliability, or any other characteristic.
+#
+# We would appreciate acknowledgement if the software is used.
+
+top_srcdir := ../..
+
+all:
+
+.check-investigation.ttl: \
+  $(top_srcdir)/.lib.done.log \
+  investigation.ttl
+	java -jar $(top_srcdir)/lib/rdf-toolkit.jar \
+	  --infer-base-iri \
+	  --inline-blank-nodes \
+	  --source investigation.ttl \
+	  --source-format turtle \
+	  --target _$@ \
+	  --target-format turtle
+	mv _$@ $@
+
+.check-investigation-da.ttl: \
+  $(top_srcdir)/.lib.done.log \
+  investigation-da.ttl
+	java -jar $(top_srcdir)/lib/rdf-toolkit.jar \
+	  --infer-base-iri \
+	  --inline-blank-nodes \
+	  --source investigation-da.ttl \
+	  --source-format turtle \
+	  --target _$@ \
+	  --target-format turtle
+	mv _$@ $@
+
+check: \
+  .check-investigation.ttl \
+  .check-investigation-da.ttl
+	diff investigation.ttl .check-investigation.ttl
+	diff investigation-da.ttl .check-investigation-da.ttl
+
+clean:
+	@rm -f \
+	  .check-*.ttl \
+	  _*