solis 0.103.0 → 0.104.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5a78201a61e91f4b29557e2877c935762b8ec97601fd4c9d9b34824d8ddb7030
-  data.tar.gz: ac10f1eb1d188eeca069ba3eb3cece17a7580832ffbbb18872531ccb4b74c5ba
+  metadata.gz: 77c7e9c049e1f92751d4b71ad2e8d1771c36c4921af365d3ff47f70b0b99f22f
+  data.tar.gz: ff9c184e4954b39b510a4893df7bee4079e8223baca6c5f5e27f2c758b025dfd
 SHA512:
-  metadata.gz: 6b03ac2067ca7f8afe515d61f6cfd26404cf99345d120b2a9ba15b7bc9ef92bce4b0853a3c89d216227c39db270b40002daab380061454ee031e980bfc279de7
-  data.tar.gz: 63b24bc564eeac3cf095e96c54f47b886c841511104d88650de88463842e7d8e7fe6c8c71b0de42ee1b459bdcca719fca6b334a15cd9024512b574599337716a
+  metadata.gz: 11e9f319e99271f7a7b737f721cba84ba64637e5a2aec72b9579a0b47bb9e02235c1901fc1f586270ad9d5fa2605a1fa141bf6a32e7dd58a9d65041f9c5be750
+  data.tar.gz: ef3424d4530d0e96aa307f2b6a707dce7e3febdfd578878ac34af315067f1cc6470d482408c09f5d0d8909a14543126543e8dd5e61a2db962a8a7164d7a34fbf

data/README.md

@@ -223,6 +223,199 @@ When query returns not found
 #### Solis::Shape::Reader::File
 #### Solis::Shape::Reader::Sheet
 
+## Supported Data Types
+
+### Extended Date/Time Format (EDTF)
+
+Solis supports the [Extended Date/Time Format (EDTF)](https://www.loc.gov/standards/datetime/) specification from the Library of Congress. EDTF extends ISO 8601 to represent uncertain, approximate, and imprecise dates commonly found in cultural heritage and archival materials.
+
+#### Using EDTF in SHACL
+
+Define EDTF fields in your SHACL shapes using the Library of Congress namespace:
+
+```turtle
+@prefix sh: <http://www.w3.org/ns/shacl#> .
+@prefix edtf: <http://id.loc.gov/datatypes/edtf> .
+@prefix ex: <http://example.org/> .
+
+ex:ArtworkShape
+    a sh:NodeShape ;
+    sh:targetClass ex:Artwork ;
+    sh:property [
+        sh:path ex:creationDate ;
+        sh:name "creationDate" ;
+        sh:description "Date or date range when artwork was created" ;
+        sh:datatype edtf: ;
+        sh:minCount 0 ;
+        sh:maxCount 1 ;
+    ] .
+```
+
+#### EDTF Features Supported
+
+**Basic Dates (Level 0):**
+```ruby
+# Year precision
+artwork.creation_date = "1984"
+
+# Month precision
+artwork.creation_date = "1984-05"
+
+# Day precision
+artwork.creation_date = "1984-05-26"
+```
+
+**Uncertainty and Approximation (Level 1):**
+```ruby
+# Uncertain date (?)
+artwork.creation_date = "1984?"           # Possibly 1984
+
+# Approximate date (~)
+artwork.creation_date = "1984~"           # Approximately 1984
+
+# Both uncertain and approximate
+artwork.creation_date = "1984?~"          # Possibly around 1984
+
+# Uncertain at different precisions
+artwork.creation_date = "1984-05?"        # Possibly May 1984
+artwork.creation_date = "1984-05-26?"     # Possibly May 26, 1984
+```
+
+**Date Intervals (Level 1):**
+```ruby
+# Date range
+artwork.creation_date = "1984/2004"       # Between 1984 and 2004
+
+# Uncertain intervals
+artwork.creation_date = "1984-06?/2004-08?"  # Between possibly June 1984 and possibly August 2004
+```
+
+**Seasons (Level 1):**
+```ruby
+artwork.creation_date = "2001-21"         # Spring 2001
+artwork.creation_date = "2001-22"         # Summer 2001
+artwork.creation_date = "2001-23"         # Autumn 2001
+artwork.creation_date = "2001-24"         # Winter 2001
+```
+
+**Extended Features (Level 2):**
+```ruby
+# Masked precision (decades/centuries)
+artwork.creation_date = "198X"            # Some year in the 1980s
+artwork.creation_date = "19XX"            # Some year in the 1900s
+
+# Sets of dates
+artwork.creation_date = "[1667,1668,1670..1672]"  # Multiple possible dates
+```
+
+#### Working with EDTF Values
+
+**Creating records with EDTF:**
+```ruby
+# Using EDTF strings
+artwork = Artwork.new({
+  id: '1',
+  title: 'Unknown Masterpiece',
+  creation_date: '1984?'  # Uncertain year
+})
+artwork.save
+```
+
+**Querying EDTF fields:**
+```ruby
+# Retrieve records
+result = ArtworkResource.all({filter: {id: '1'}})
+artwork = result.data.first
+
+# EDTF values are returned as strings
+puts artwork.creation_date  # => "1984?"
+```
+
+**Working with EDTF objects directly:**
+```ruby
+# Parse EDTF string
+date = Date.edtf('1984?')
+
+# Check properties
+date.uncertain?      # => true
+date.approximate?    # => false
+date.edtf           # => "1984?"
+
+# Intervals
+interval = Date.edtf('1984/2004')
+interval.length     # => Duration in days
+interval.from       # => Start date
+interval.to         # => End date
+
+# Seasons
+season = Date.edtf('2001-21')
+season.spring?      # => true
+season.year         # => 2001
+```
+
+**RDF Storage:**
+
+EDTF values are stored in RDF as typed literals with the correct datatype URI:
+
+```turtle
+<http://example.org/artworks/1>
+    <http://example.org/creationDate>
+    "1984?"^^<http://id.loc.gov/datatypes/edtf> .
+```
+
+#### Common Use Cases
+
+**Archival Records:**
+```ruby
+# Uncertain historical date
+document.date = "1776-07-04?"
+
+# Approximate date range
+manuscript.date = "1450~/1475~"
+```
+
+**Museum Collections:**
+```ruby
+# Decade precision for artwork
+painting.creation_date = "186X"
+
+# Season when photograph was taken
+photo.date = "1965-22"  # Summer 1965
+```
+
+**Publication Dates:**
+```ruby
+# Uncertain publication year
+book.publication_date = "1923?"
+
+# Date range for serial publications
+journal.coverage = "1990/1995"
+```
+
+#### Additional Resources
+
+- [EDTF Specification](https://www.loc.gov/standards/datetime/)
+- [Library of Congress EDTF Datatypes](https://id.loc.gov/datatypes/edtf.html)
+- [EDTF Ruby Gem Documentation](https://github.com/inukshuk/edtf-ruby)
+
+### Other Supported Datatypes
+
+Solis also supports standard XSD and RDF datatypes:
+
+- **xsd:string** - Text strings
+- **xsd:integer** - Whole numbers
+- **xsd:boolean** - True/false values
+- **xsd:date** - Standard dates (YYYY-MM-DD)
+- **xsd:dateTime** - Date with time
+- **xsd:float**, **xsd:double** - Decimal numbers
+- **xsd:gYear** - Year only
+- **xsd:duration** - ISO 8601 durations
+- **xsd:anyURI** - URI/URL values
+- **rdf:langString** - Language-tagged strings
+- **rdf:JSON** - JSON objects
+- **time:DateTimeInterval** - Time intervals
+- **schema:temporalCoverage** - Temporal coverage periods
+
 ### Setup Solis
 ``` ruby
 Solis::ConfigFile.path = './'

data/lib/solis/model.rb

@@ -663,6 +663,13 @@ values ?s {<#{self.graph_id}>}
                 end
               elsif metadata[:datatype_rdf].eql?('http://www.w3.org/2001/XMLSchema#anyURI') || metadata[:node].is_a?(RDF::URI)
                 RDF::URI(d)
+              elsif metadata[:datatype_rdf] =~ /datatypes\/edtf/ || metadata[:datatype_rdf] =~ /edtf$/i
+                # Handle EDTF dates
+                begin
+                  RDF::Literal::EDTF.new(d)
+                rescue StandardError => e
+                  raise Solis::Error::InvalidDatatypeError, "#{hierarchy.join('.')}.#{attribute}: #{e.message}"
+                end
               elsif metadata[:datatype_rdf].eql?('http://www.w3.org/2006/time#DateTimeInterval')
                 begin
                   datatype = metadata[:datatype_rdf]