atlas_rb 0.0.83 → 0.0.85

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a7a8531fb28a840a529a888d8d5b789ea9ba69aed95fa59d5899f4aea42afd8
-  data.tar.gz: 2f545fdddc0d22cdb3def311ed73abcb946524bffb0a3d55952e1cee9226eb10
+  metadata.gz: a85ca8a2fc7cb44ff2d348c03e2a1d8a0b5c01a35ddeccd823445071290d4ea0
+  data.tar.gz: 1dbf5a8aeb3052c5841003951710320d23559133f00a2a24ed57bc7631472c79
 SHA512:
-  metadata.gz: 5fbc732c7f405ffe14c22169a38e8037eec302a4572f691ca41e2ebd8f5450aad5c33eab8d0b712dacf9295b62d364178ace4caa9af5d932c65f6f2ca04e9044
-  data.tar.gz: 4454c5562263f3401d9cf10764594b7acaf8d978f6264d6738d8f9324abe8b1e9542ce009559c59e3ee31ac36e2fee4a32222912efd43c6fdc06c798d8105a0e
+  metadata.gz: 86d853b18df5e0f278de6e4c58bf8df6705fc88d495c72ebd44c7e2075357e486e3c7c5702bb40ae7cdd211576a374f2bda920fc2aba3f1f0be3a7f8999388f0
+  data.tar.gz: 255bfa1ce0f3edf9268dd58b86093d429e2fac74d118a72a68e02106d9bc5779978c874b6d6ded9ffe68798949c2ffef90bd845aa66d34a93c23fab48962b16f

data/.version

@@ -1 +1 @@
-0.0.83
+0.0.85

data/Gemfile.lock

@@ -1,10 +1,11 @@
 PATH
   remote: .
   specs:
-    atlas_rb (0.0.83)
+    atlas_rb (0.0.85)
       faraday (~> 2.7)
       faraday-follow_redirects (~> 0.3.0)
       faraday-multipart (~> 1)
+      hashie (~> 5.0)
 
 GEM
   remote: https://rubygems.org/
@@ -20,6 +21,8 @@ GEM
       multipart-post (~> 2.0)
     faraday-net_http (3.4.2)
       net-http (~> 0.5)
+    hashie (5.1.0)
+      logger
     json (2.19.4)
     logger (1.7.0)
     multipart-post (2.4.1)

data/README.md

@@ -75,6 +75,11 @@ AtlasRb::Blob.create("w-789", path, name)  # blob under work w-789 with original
 
 ## End-to-end example
 
+JSON responses come back as `AtlasRb::Mash` (a `Hashie::Mash` subclass), so
+you can use dot access — `community.id` — or string-keyed access —
+`community["id"]` — interchangeably. Both return the same value, so existing
+string-keyed callers keep working.
+
 ```ruby
 require "atlas_rb"
 
@@ -82,19 +87,19 @@ ENV["ATLAS_URL"]   = "https://atlas.example.edu"
 ENV["ATLAS_TOKEN"] = "..."
 
 # 1. Build the org structure (each create can optionally seed MODS metadata).
-community  = AtlasRb::Community.create(nil,             "/tmp/community-mods.xml")
-collection = AtlasRb::Collection.create(community["id"], "/tmp/coll-mods.xml")
-work       = AtlasRb::Work.create(collection["id"],      "/tmp/work-mods.xml")
+community  = AtlasRb::Community.create(nil,           "/tmp/community-mods.xml")
+collection = AtlasRb::Collection.create(community.id, "/tmp/coll-mods.xml")
+work       = AtlasRb::Work.create(collection.id,      "/tmp/work-mods.xml")
 
 # 2. Upload a binary attached to the work, preserving the user-facing filename.
-blob = AtlasRb::Blob.create(work["id"], "/tmp/upload.tmp", "thesis.pdf")
+blob = AtlasRb::Blob.create(work.id, "/tmp/upload.tmp", "thesis.pdf")
 
 # 3. List everything attached to the work.
-AtlasRb::Work.files(work["id"])
+AtlasRb::Work.files(work.id)
 
 # 4. Stream the binary back without buffering it in memory.
 File.open("out.pdf", "wb") do |f|
-  headers = AtlasRb::Blob.content(blob["id"]) { |chunk| f.write(chunk) }
+  headers = AtlasRb::Blob.content(blob.id) { |chunk| f.write(chunk) }
   puts headers["content-type"]
 end
 

data/lib/atlas_rb/authentication.rb

@@ -29,7 +29,7 @@ module AtlasRb
     def self.login(nuid)
       # JSON.parse(connection({ nuid: nuid }).post('/token')&.body)["token"]
       # need hash - id, name, token => ...
-      JSON.parse(connection({}, nuid).get('/user')&.body)
+      AtlasRb::Mash.new(JSON.parse(connection({}, nuid).get('/user')&.body))
     end
 
     # Fetch only the group memberships for an NUID.
@@ -49,7 +49,7 @@ module AtlasRb
       # token = user_details[:token] ...
       # TODO - need to update atlas login to give back name, id, and token upon logging in
       # result = JSON.parse(connection({ token: token }).post('/users/2/groups')&.body)["user"]["groups"]
-      JSON.parse(connection({}, nuid).get('/user')&.body)["groups"]
+      AtlasRb::Mash.new(JSON.parse(connection({}, nuid).get('/user')&.body))["groups"]
     end
   end
 end

data/lib/atlas_rb/blob.rb

@@ -24,7 +24,7 @@ module AtlasRb
     #   AtlasRb::Blob.find("b-321")
     #   # => { "id" => "b-321", "original_filename" => "scan.pdf", ... }
     def self.find(id)
-      JSON.parse(connection({}).get(ROUTE + id)&.body)['blob']
+      AtlasRb::Mash.new(JSON.parse(connection({}).get(ROUTE + id)&.body))['blob']
     end
 
     # Stream the Blob's binary content through a caller-supplied block.
@@ -77,7 +77,7 @@ module AtlasRb
                                                           "application/octet-stream",
                                                           File.basename(blob_path)) }
 
-      JSON.parse(multipart({}).post(ROUTE, payload)&.body)['blob']
+      AtlasRb::Mash.new(JSON.parse(multipart({}).post(ROUTE, payload)&.body))['blob']
     end
 
     # Delete a Blob (the bytes *and* the metadata record).
@@ -107,7 +107,7 @@ module AtlasRb
       payload = { binary: Faraday::Multipart::FilePart.new(File.open(blob_path),
                                                           "application/octet-stream",
                                                           File.basename(blob_path)) }
-      JSON.parse(multipart({}).patch(ROUTE + id, payload)&.body)
+      AtlasRb::Mash.new(JSON.parse(multipart({}).patch(ROUTE + id, payload)&.body))
     end
   end
 end

data/lib/atlas_rb/collection.rb

@@ -4,7 +4,7 @@ module AtlasRb
   # A grouping of {Work}s within a {Community}.
   #
   # Collections are the leaf containers in the organizational tree — they hold
-  # Works directly and cannot contain other Collections. Every Collection has
+  # Works directly. Every Collection has
   # exactly one parent Community.
   #
   # See also: {Community}, {Work}.
@@ -23,7 +23,7 @@ module AtlasRb
     #   AtlasRb::Collection.find("col-456")
     #   # => { "id" => "col-456", "title" => "Faculty Publications", ... }
     def self.find(id)
-      JSON.parse(connection({}).get(ROUTE + id)&.body)["collection"]
+      AtlasRb::Mash.new(JSON.parse(connection({}).get(ROUTE + id)&.body))["collection"]
     end
 
     # Create a new Collection under an existing Community.
@@ -42,7 +42,7 @@ module AtlasRb
     # @example
     #   AtlasRb::Collection.create("c-123", "/tmp/collection-mods.xml")
     def self.create(id, xml_path = nil)
-      result = JSON.parse(connection({ parent_id: id }).post(ROUTE)&.body)["collection"]
+      result = AtlasRb::Mash.new(JSON.parse(connection({ parent_id: id }).post(ROUTE)&.body))["collection"]
       return result unless xml_path.present?
 
       update(result["id"], xml_path)
@@ -68,7 +68,7 @@ module AtlasRb
     # @example
     #   AtlasRb::Collection.children("col-456")
     def self.children(id)
-      JSON.parse(connection({}).get(ROUTE + id + '/children')&.body)
+      AtlasRb::Mash.new(JSON.parse(connection({}).get(ROUTE + id + '/children')&.body))
     end
 
     # Replace a Collection's metadata by uploading a MODS XML document.
@@ -83,7 +83,7 @@ module AtlasRb
       payload = { binary: Faraday::Multipart::FilePart.new(File.open(xml_path),
                                                            "application/xml",
                                                            File.basename(xml_path)) }
-      JSON.parse(multipart({}).patch(ROUTE + id, payload)&.body)
+      AtlasRb::Mash.new(JSON.parse(multipart({}).patch(ROUTE + id, payload)&.body))
     end
 
     # Patch individual metadata fields without uploading a full MODS document.
@@ -95,7 +95,7 @@ module AtlasRb
     # @example
     #   AtlasRb::Collection.metadata("col-456", title: "Renamed Collection")
     def self.metadata(id, values)
-      JSON.parse(connection({ metadata: values }).patch(ROUTE + id)&.body)
+      AtlasRb::Mash.new(JSON.parse(connection({ metadata: values }).patch(ROUTE + id)&.body))
     end
 
     # Fetch the Collection's MODS representation in the requested format.

data/lib/atlas_rb/community.rb

@@ -24,7 +24,7 @@ module AtlasRb
     #   AtlasRb::Community.find("c-123")
     #   # => { "id" => "c-123", "title" => "College of Engineering", ... }
     def self.find(id)
-      JSON.parse(connection({}).get(ROUTE + id)&.body)["community"]
+      AtlasRb::Mash.new(JSON.parse(connection({}).get(ROUTE + id)&.body))["community"]
     end
 
     # Create a new Community, optionally seeded with MODS metadata.
@@ -46,7 +46,7 @@ module AtlasRb
     # @example Sub-community seeded from MODS
     #   AtlasRb::Community.create("c-parent", "/tmp/dept-mods.xml")
     def self.create(id = nil, xml_path = nil)
-      result = JSON.parse(connection({ parent_id: id }).post(ROUTE)&.body)["community"]
+      result = AtlasRb::Mash.new(JSON.parse(connection({ parent_id: id }).post(ROUTE)&.body))["community"]
       return result unless xml_path.present?
 
       update(result["id"], xml_path)
@@ -72,7 +72,7 @@ module AtlasRb
     # @example
     #   AtlasRb::Community.children("c-123")
     def self.children(id)
-      JSON.parse(connection({}).get(ROUTE + id + '/children')&.body)
+      AtlasRb::Mash.new(JSON.parse(connection({}).get(ROUTE + id + '/children')&.body))
     end
 
     # Replace a Community's metadata by uploading a MODS XML document.
@@ -87,7 +87,7 @@ module AtlasRb
       payload = { binary: Faraday::Multipart::FilePart.new(File.open(xml_path),
                                                            "application/xml",
                                                            File.basename(xml_path)) }
-      JSON.parse(multipart({}).patch(ROUTE + id, payload)&.body)
+      AtlasRb::Mash.new(JSON.parse(multipart({}).patch(ROUTE + id, payload)&.body))
     end
 
     # Patch individual metadata fields without uploading a full MODS document.
@@ -100,7 +100,7 @@ module AtlasRb
     # @example
     #   AtlasRb::Community.metadata("c-123", title: "New Name")
     def self.metadata(id, values)
-      JSON.parse(connection({ metadata: values }).patch(ROUTE + id)&.body)
+      AtlasRb::Mash.new(JSON.parse(connection({ metadata: values }).patch(ROUTE + id)&.body))
     end
 
     # Fetch the Community's MODS representation in the requested format.

data/lib/atlas_rb/file_set.rb

@@ -22,7 +22,7 @@ module AtlasRb
     # @example
     #   AtlasRb::FileSet.find("fs-001")
     def self.find(id)
-      JSON.parse(connection({}).get(ROUTE + id)&.body)["file_set"]
+      AtlasRb::Mash.new(JSON.parse(connection({}).get(ROUTE + id)&.body))["file_set"]
     end
 
     # Create a new FileSet under a Work.
@@ -38,7 +38,7 @@ module AtlasRb
     #   fs = AtlasRb::FileSet.create("w-789", "primary")
     #   AtlasRb::FileSet.update(fs["id"], "/tmp/article.pdf")
     def self.create(id, classification)
-      JSON.parse(connection({ work_id: id, classification: classification }).post(ROUTE)&.body)["file_set"]
+      AtlasRb::Mash.new(JSON.parse(connection({ work_id: id, classification: classification }).post(ROUTE)&.body))["file_set"]
     end
 
     # Delete a FileSet.
@@ -70,7 +70,7 @@ module AtlasRb
       payload = { binary: Faraday::Multipart::FilePart.new(File.open(blob_path),
                                                           "application/octet-stream",
                                                           File.basename(blob_path)) }
-      JSON.parse(multipart({}).patch(ROUTE + id, payload)&.body)
+      AtlasRb::Mash.new(JSON.parse(multipart({}).patch(ROUTE + id, payload)&.body))
     end
   end
 end

data/lib/atlas_rb/mash.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "hashie"
+
+module AtlasRb
+  # Shared `Hashie::Mash` subclass used to wrap parsed JSON responses so
+  # callers can use dot access (`work.id`) alongside string-keyed access
+  # (`work["id"]`).
+  #
+  # `disable_warnings` silences Hashie's stderr noise when an Atlas
+  # response key collides with an existing `Hash` method (e.g. `class`,
+  # `type`, `id`).
+  class Mash < Hashie::Mash
+    disable_warnings
+  end
+end

data/lib/atlas_rb/resource.rb

@@ -35,8 +35,8 @@ module AtlasRb
     #   # => { "klass" => "Work", "resource" => { "id" => "abc123", "title" => "..." } }
     def self.find(id)
       result = JSON.parse(connection({}).get('/resources/' + id)&.body)
-      { "klass" => result.first[0].capitalize,
-        "resource" => result.first[1] }
+      AtlasRb::Mash.new("klass" => result.first[0].capitalize,
+                        "resource" => result.first[1])
     end
 
     # Validate a MODS XML document against Atlas's schema *without* persisting it.
@@ -66,7 +66,7 @@ module AtlasRb
     #   AtlasRb::Resource.permissions("abc123")
     #   # => { "id" => "abc123", "read" => [...], "write" => [...] }
     def self.permissions(id)
-      result = JSON.parse(connection({}).get('/resources/' + id + '/permissions')&.body)["resource"]
+      AtlasRb::Mash.new(JSON.parse(connection({}).get('/resources/' + id + '/permissions')&.body))["resource"]
     end
   end
 end

data/lib/atlas_rb/work.rb

@@ -23,7 +23,7 @@ module AtlasRb
     #   AtlasRb::Work.find("w-789")
     #   # => { "id" => "w-789", "title" => "An Article", ... }
     def self.find(id)
-      JSON.parse(connection({}).get(ROUTE + id)&.body)["work"]
+      AtlasRb::Mash.new(JSON.parse(connection({}).get(ROUTE + id)&.body))["work"]
     end
 
     # Create a new Work in an existing Collection.
@@ -45,7 +45,7 @@ module AtlasRb
     # @example Work seeded from MODS
     #   AtlasRb::Work.create("col-456", "/tmp/work-mods.xml")
     def self.create(id, xml_path = nil)
-      result = JSON.parse(connection({ collection_id: id }).post(ROUTE)&.body)["work"]
+      result = AtlasRb::Mash.new(JSON.parse(connection({ collection_id: id }).post(ROUTE)&.body))["work"]
       return result unless xml_path.present?
 
       update(result["id"], xml_path)
@@ -75,7 +75,7 @@ module AtlasRb
       payload = { binary: Faraday::Multipart::FilePart.new(File.open(xml_path),
                                                            "application/xml",
                                                            File.basename(xml_path)) }
-      JSON.parse(multipart({}).patch(ROUTE + id, payload)&.body)
+      AtlasRb::Mash.new(JSON.parse(multipart({}).patch(ROUTE + id, payload)&.body))
     end
 
     # Patch individual metadata fields without uploading a full MODS document.
@@ -87,7 +87,7 @@ module AtlasRb
     # @example
     #   AtlasRb::Work.metadata("w-789", title: "Revised Title")
     def self.metadata(id, values)
-      JSON.parse(connection({ metadata: values }).patch(ROUTE + id)&.body)
+      AtlasRb::Mash.new(JSON.parse(connection({ metadata: values }).patch(ROUTE + id)&.body))
     end
 
     # List the {FileSet}s and {Blob}s attached to a Work.
@@ -101,7 +101,7 @@ module AtlasRb
     # @example
     #   AtlasRb::Work.files("w-789")
     def self.files(id)
-      JSON.parse(connection({}).get(ROUTE + id + '/files')&.body)
+      AtlasRb::Mash.new(JSON.parse(connection({}).get(ROUTE + id + '/files')&.body))
     end
 
     # Fetch the Work's MODS representation in the requested format.

data/lib/atlas_rb.rb

@@ -5,6 +5,7 @@ require "faraday/multipart"
 require "faraday/follow_redirects"
 require_relative "atlas_rb/version"
 require_relative "atlas_rb/faraday_helper"
+require_relative "atlas_rb/mash"
 require_relative "atlas_rb/authentication"
 require_relative "atlas_rb/resource"
 require_relative "atlas_rb/community"
@@ -14,7 +15,7 @@ require_relative "atlas_rb/file_set"
 require_relative "atlas_rb/blob"
 
 # Ruby client for the Atlas API — Northeastern University's institutional
-# digital repository (the successor to Cerberus).
+# digital repository.
 #
 # ## Configuration
 #

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: atlas_rb
 version: !ruby/object:Gem::Version
-  version: 0.0.83
+  version: 0.0.85
 platform: ruby
 authors:
 - David Cliff
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-26 00:00:00.000000000 Z
+date: 2026-04-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -52,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.3.0
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -106,6 +120,7 @@ files:
 - lib/atlas_rb/community.rb
 - lib/atlas_rb/faraday_helper.rb
 - lib/atlas_rb/file_set.rb
+- lib/atlas_rb/mash.rb
 - lib/atlas_rb/resource.rb
 - lib/atlas_rb/version.rb
 - lib/atlas_rb/work.rb