atlas_rb 1.8.10 → 1.8.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2a1ca62f7d0e0d49e63754618a22967d8a89a4496c05c894bbbff7f13903e94d
-  data.tar.gz: 5645596297711e7cc464645d249b91b4b62108eaf71978f9d07ffed9590043cd
+  metadata.gz: f6edbe1b05256eaab4d296a11f358bb7c7c3f9eaf439be4d48c41e75cfea4951
+  data.tar.gz: 8e042786b3c7636f7ad3676b9086a7db4ecfa8efed7ed1e91ac8ec4153dbb320
 SHA512:
-  metadata.gz: acd99d449e3dd94bb23cfdeabfc1190d2a074e5bfe07a2a4a8e54723fad47680f525d52e761f5ccee50ac1b464a39b889331e6468fe63bb9a0b06f8d17526262
-  data.tar.gz: c2d0db210a2a66cb41bc68baec3b6158916a86866c9a20182efc1bc2240f26e0c00357e340d08b4313312e239fabc9338bbca3f6face3c9d0576ef13d9f1f74d
+  metadata.gz: 44832489abc704196a42b92d85304e886cc3951e711ea33980c9357cb515a4f3e674d7c75db989b7de5c7fbdc9ed36dcfc51a5eceb1d697371d3971227a7e5fa
+  data.tar.gz: 45d0ed33989b889a4a2f3ae3c9932b73f85daa3bc7f5ce9e859f7ea304bf97c71195694322e4e78cdcb537e8f50f37cd1b1d1fe6f7c76bc8458f780688e5c143

data/.version

@@ -1 +1 @@
-1.8.10
+1.8.11

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    atlas_rb (1.8.10)
+    atlas_rb (1.8.11)
       faraday (~> 2.7)
       faraday-follow_redirects (~> 0.3.0)
       faraday-multipart (~> 1)

data/lib/atlas_rb/collection.rb

@@ -1,11 +1,14 @@
 # frozen_string_literal: true
 
 module AtlasRb
-  # A grouping of {Work}s within a {Community}.
+  # A grouping of {Work}s and nested {Collection}s, parented by a {Community}
+  # or another Collection.
   #
-  # Collections are the leaf containers in the organizational tree — they hold
-  # Works directly. Every Collection has
-  # exactly one parent Community.
+  # Collections nest, exactly as they did in DRS v1: a Collection holds Works
+  # and/or child Collections, and its own parent may be a Community or a
+  # Collection (Community → Community|Collection, Collection → Collection|Work,
+  # Work → leaf). A consumer that flattens a subtree must recurse into
+  # descendant Collections rather than stopping at direct children.
   #
   # See also: {Community}, {Work}.
   class Collection < Resource
@@ -35,13 +38,13 @@ module AtlasRb
       body && AtlasRb::Mash.new(body)["collection"]
     end
 
-    # Create a new Collection under an existing Community.
+    # Create a new Collection under an existing Community or parent Collection.
     #
-    # **Note**: unlike {Community.create}, the `id` parameter here is the
-    # parent **Community** ID (not a parent Collection ID — Collections do
-    # not nest).
+    # The `id` parameter is the parent's ID — a **Community or a Collection**,
+    # since Collections nest (a Collection may hold child Collections as well as
+    # Works).
     #
-    # @param id [String] the parent Community ID.
+    # @param id [String] the parent Community or Collection ID.
     # @param xml_path [String, nil] optional path to a MODS XML file used to
     #   seed metadata. When given, the Collection is created and immediately
     #   patched with the metadata in the file.
@@ -63,7 +66,7 @@ module AtlasRb
       result = AtlasRb::Mash.new(JSON.parse(
         connection({ parent_id: id, featured: featured }, nuid, on_behalf_of: on_behalf_of).post(ROUTE)&.body
       ))["collection"]
-      return result unless xml_path.present?
+      return result if xml_path.to_s.empty?
 
       update(result["id"], xml_path, nuid: nuid, on_behalf_of: on_behalf_of)
       find(result["id"], nuid: nuid, on_behalf_of: on_behalf_of)
@@ -90,10 +93,10 @@ module AtlasRb
       ))["collection"]
     end
 
-    # Move a Collection to a different parent Community.
+    # Move a Collection to a different parent (Community or Collection).
     #
     # Wraps `PATCH /collections/<id>/parent` with a `parent_id` of the new
-    # Community. Atlas re-parents the Collection and synchronously cascades
+    # parent. Atlas re-parents the Collection and synchronously cascades
     # the ancestry index over its Works; the structural rules (type, cycle,
     # tombstone guards) are enforced server-side and surface as a `422`.
     #
@@ -101,7 +104,7 @@ module AtlasRb
     # the only difference is the verb and that the Collection already exists.
     #
     # @param id [String] the Collection ID to move.
-    # @param new_parent_id [String] the destination Community ID.
+    # @param new_parent_id [String] the destination Community or Collection ID.
     # @param nuid [String, nil] optional acting user's NUID. On the relay-signing
     #   path it is signed into the assertion `sub`; on the BYO-JWT (`ATLAS_JWT`)
     #   path it is ignored (identity lives in the token).
@@ -274,7 +277,7 @@ module AtlasRb
     def self.mods(id, kind = nil, nuid: nil, on_behalf_of: nil)
       # json default, html, xml
       connection({}, nuid, on_behalf_of: on_behalf_of).get(
-        ROUTE + id + '/mods' + (kind.present? ? ".#{kind}" : '')
+        ROUTE + id + '/mods' + (kind.to_s.empty? ? '' : ".#{kind}")
         )&.body
     end
   end

data/lib/atlas_rb/community.rb

@@ -64,7 +64,7 @@ module AtlasRb
       result = AtlasRb::Mash.new(JSON.parse(
         connection({ parent_id: id }, nuid, on_behalf_of: on_behalf_of).post(ROUTE)&.body
       ))["community"]
-      return result unless xml_path.present?
+      return result if xml_path.to_s.empty?
 
       update(result["id"], xml_path, nuid: nuid, on_behalf_of: on_behalf_of)
       find(result["id"], nuid: nuid, on_behalf_of: on_behalf_of)
@@ -263,7 +263,7 @@ module AtlasRb
     def self.mods(id, kind = nil, nuid: nil, on_behalf_of: nil)
       # json default, html, xml
       connection({}, nuid, on_behalf_of: on_behalf_of).get(
-        ROUTE + id + '/mods' + (kind.present? ? ".#{kind}" : '')
+        ROUTE + id + '/mods' + (kind.to_s.empty? ? '' : ".#{kind}")
         )&.body
     end
   end

data/lib/atlas_rb/resource.rb

@@ -244,7 +244,7 @@ module AtlasRb
     #   end
     def self.mods(id, kind = nil, nuid: nil, on_behalf_of: nil)
       connection({}, nuid, on_behalf_of: on_behalf_of).get(
-        '/resources/' + id + '/mods' + (kind.present? ? ".#{kind}" : '')
+        '/resources/' + id + '/mods' + (kind.to_s.empty? ? '' : ".#{kind}")
       )&.body
     end
 
@@ -320,7 +320,7 @@ module AtlasRb
     def self.mods_version(id, version_id, kind: nil, nuid: nil, on_behalf_of: nil)
       connection({}, nuid, on_behalf_of: on_behalf_of).get(
         '/resources/' + id + '/mods/versions/' + version_id +
-          (kind.present? ? ".#{kind}" : '')
+          (kind.to_s.empty? ? '' : ".#{kind}")
       )&.body
     end
 

data/lib/atlas_rb/version.rb

@@ -1,6 +1,9 @@
 # frozen_string_literal: true
 
 module AtlasRb
-  # Current gem version, read from the `.version` file at the repo root at load time.
-  VERSION = File.read(".version").strip
+  # Current gem version, read from the `.version` file at the gem root at load
+  # time. Resolved relative to this file (not the process CWD) so a standalone
+  # consumer — a headless BYO-JWT script run from anywhere — loads the gem's own
+  # version rather than raising ENOENT (or reading some unrelated `.version`).
+  VERSION = File.read(File.expand_path("../../.version", __dir__)).strip
 end

data/lib/atlas_rb/work.rb

@@ -124,7 +124,7 @@ module AtlasRb
         connection(params, nuid,
                    on_behalf_of: on_behalf_of, idempotency_key: idempotency_key).post(ROUTE)&.body
       ))["work"]
-      return result unless xml_path.present?
+      return result if xml_path.to_s.empty?
 
       update(result["id"], xml_path, nuid: nuid, on_behalf_of: on_behalf_of)
       find(result["id"], nuid: nuid, on_behalf_of: on_behalf_of)
@@ -559,7 +559,7 @@ module AtlasRb
     def self.mods(id, kind = nil, nuid: nil, on_behalf_of: nil)
       # json default, html, xml
       connection({}, nuid, on_behalf_of: on_behalf_of).get(
-        ROUTE + id + '/mods' + (kind.present? ? ".#{kind}" : '')
+        ROUTE + id + '/mods' + (kind.to_s.empty? ? '' : ".#{kind}")
         )&.body
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: atlas_rb
 version: !ruby/object:Gem::Version
-  version: 1.8.10
+  version: 1.8.11
 platform: ruby
 authors:
 - David Cliff