cocina-models 0.75.0 → 0.78.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5ec67ece77b9025a117182d0213342e180e7b87dcd003a44e3d9dffeb03d08e1
-  data.tar.gz: 3ee4eee501728b92c356760c660514789082da70c41c990fc3822f5833a7f47d
+  metadata.gz: '09a3e28b24593aeb0e75c0318067e72fc8e10bb98e189d00b3f166357b198cab'
+  data.tar.gz: 688dbfe3ef449fe8caccd5c3518a6cd059cff2920ad9af3d9fb11553516b520e
 SHA512:
-  metadata.gz: 4b0b94409167d640cfd84c7202468664ec32887405b17973e05ebdd77a55f608e53ad2c2956aabc85ac09dd9edecb6281eaafea7822d77bdea1075301e04aae6
-  data.tar.gz: 821ba48bca0b9c92031eb6ba2dbde666f2116c6c7f9076663730636f1c61f11e098551f2e81b975dea06289bd9ba09aa4f498ef67b36dbfa76d6581f29c515c4
+  metadata.gz: 3bc1bce3e8624fa829ce0f41b69362d723e77549d102d561b41245c462c178cbcac5733fcd0816fd7750fa7bf736611e46de503e1e6b93dfce009ae6bd33eea4
+  data.tar.gz: 5cb526603a08485e0c04abccfa962b92b890fbf9d966d5dc00cb5ddd9aec64b24ebb4aa555397d769d5814edb914960d7d83a1b7f5c23be6752252f34b64a033

data/.rubocop.yml

@@ -11,15 +11,13 @@ AllCops:
 
 # ----- Layout ------
 
-Layout/LineLength:
-  Max: 114
-  Exclude:
-    - lib/cocina/models/*
-
 Layout/BeginEndAlignment: # (new in 0.91)
   Enabled: true
 Layout/EmptyLinesAroundAttributeAccessor:
   Enabled: true
+Layout/LineLength:
+  Exclude:
+    - lib/cocina/models/*
 Layout/SpaceAroundMethodCallOperator:
   Enabled: true
 
@@ -79,12 +77,36 @@ Metrics/BlockLength:
     - cocina-models.gemspec
     - spec/cocina/**/*
     - lib/cocina/rspec/matchers.rb
+    - 'spec/support/mods_mapping_spec_helper.rb'
+
+# Offense count: 16
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ClassLength:
+  Max: 100
+  Exclude:
+    - 'lib/cocina/rspec/factories.rb'
 
 Metrics/MethodLength:
   Max: 14
   Exclude:
     - 'spec/cocina/models/file_access_spec.rb'
     - 'spec/cocina/models/dro_access_spec.rb'
+    - 'lib/cocina/rspec/factories.rb'
+    - 'lib/cocina/models/mapping/to_mods/*'
+    - 'lib/cocina/models/mapping/from_mods/*'
+    - 'lib/cocina/models/mapping/normalizers/mods/origin_info_normalizer.rb'
+    - 'lib/cocina/models/mapping/normalizers/mods/subject_normalizer.rb'
+    - 'lib/cocina/models/mapping/normalizers/mods_normalizer.rb'
+
+
+# Offense count: 37
+# Configuration parameters: IgnoredMethods.
+Metrics/PerceivedComplexity:
+  # Max: 20
+  Exclude:
+    - 'lib/cocina/models/mapping/from_mods/*'
+    - 'lib/cocina/models/mapping/to_mods/*'
+    - 'lib/cocina/models/mapping/normalizers/**/*'
 
 # ----- RSpec ------
 
@@ -94,13 +116,6 @@ RSpec/BeEq: # new in 2.9.0
 RSpec/BeNil: # new in 2.9.0
   Enabled: true
 
-RSpec/ExampleLength:
-  Max: 18
-  Exclude:
-    - spec/cocina/models/description_spec.rb
-    - spec/cocina/models/dro_shared_examples.rb
-    - spec/cocina/models/builders/name_title_group_builder_spec.rb
-
 RSpec/MultipleExpectations:
   Enabled: false
 
@@ -283,3 +298,16 @@ RSpec/Rails/AvoidSetupHook: # new in 2.4
   Enabled: true
 Style/NestedFileDirname: # new in 1.26
   Enabled: true
+
+Lint/RefinementImportMethods: # new in 1.27
+  Enabled: true
+Security/CompoundHash: # new in 1.28
+  Enabled: true
+Style/FetchEnvVar: # new in 1.28
+  Enabled: true
+Style/ObjectThen: # new in 1.28
+  Enabled: true
+Style/RedundantInitialize: # new in 1.27
+  Enabled: true
+RSpec/VerifiedDoubleReference: # new in 2.10.0
+  Enabled: true

data/.rubocop_todo.yml

@@ -1,11 +1,16 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config --auto-gen-only-exclude`
-# on 2022-01-14 00:32:36 UTC using RuboCop version 1.24.1.
+# on 2022-04-27 19:20:35 UTC using RuboCop version 1.28.2.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
+# Offense count: 1
+Lint/NoReturnInBeginEndBlocks:
+  Exclude:
+    - 'lib/cocina/models/mapping/to_mods/description.rb'
+
 # Offense count: 1
 # Configuration parameters: AllowedMethods.
 # AllowedMethods: present?, blank?, presence, try, try!, in?
@@ -13,14 +18,78 @@ Lint/SafeNavigationChain:
   Exclude:
     - 'lib/cocina/generator/schema_base.rb'
 
+# Offense count: 13
+# This cop supports safe auto-correction (--auto-correct).
+# Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods.
+Lint/UnusedMethodArgument:
+  Exclude:
+    - 'lib/cocina/models/mapping/from_mods/admin_metadata.rb'
+    - 'lib/cocina/models/mapping/from_mods/contributor.rb'
+    - 'lib/cocina/models/mapping/from_mods/event.rb'
+    - 'lib/cocina/models/mapping/from_mods/form.rb'
+    - 'lib/cocina/models/mapping/from_mods/geographic.rb'
+    - 'lib/cocina/models/mapping/from_mods/hydrus_default_title_builder.rb'
+    - 'lib/cocina/models/mapping/from_mods/identifier.rb'
+    - 'lib/cocina/models/mapping/from_mods/language.rb'
+    - 'lib/cocina/models/mapping/from_mods/note.rb'
+    - 'lib/cocina/models/mapping/from_mods/subject.rb'
+    - 'lib/cocina/models/mapping/to_mods/event.rb'
+
+# Offense count: 95
+# Configuration parameters: IgnoredMethods, CountRepeatedAttributes.
+Metrics/AbcSize:
+  Max: 40
+
+# Offense count: 42
+# Configuration parameters: IgnoredMethods.
+Metrics/CyclomaticComplexity:
+  Max: 12
+
 # Offense count: 1
 # Configuration parameters: Max, CountKeywordArgs, MaxOptionalParameters.
 Metrics/ParameterLists:
   Exclude:
     - 'lib/cocina/generator/schema_base.rb'
 
+# Offense count: 41
+# Configuration parameters: IgnoredMetadata.
+RSpec/DescribeClass:
+  Enabled: false
+
+# Offense count: 89
+# Configuration parameters: CountAsOne.
+RSpec/ExampleLength:
+  Max: 128
+
+# Offense count: 9
+# Configuration parameters: Max.
+RSpec/NestedGroups:
+  Exclude:
+    - 'spec/cocina/models/mapping/normalizers/mods/origin_info_normalizer_spec.rb'
+
 # Offense count: 1
-# Configuration parameters: MinBodyLength.
+# Configuration parameters: MinBodyLength, AllowConsecutiveConditionals.
 Style/GuardClause:
   Exclude:
     - 'lib/cocina/generator/schema_base.rb'
+
+# Offense count: 1
+# This cop supports safe auto-correction (--auto-correct).
+Style/IfUnlessModifier:
+  Exclude:
+    - 'lib/cocina/models/validators/open_api_validator.rb'
+
+# Offense count: 9
+Style/MultilineBlockChain:
+  Exclude:
+    - 'lib/cocina/models/mapping/to_mods/access.rb'
+    - 'lib/cocina/models/mapping/to_mods/contributor.rb'
+    - 'lib/cocina/models/mapping/to_mods/form.rb'
+    - 'lib/cocina/models/mapping/to_mods/subject.rb'
+
+# Offense count: 206
+# This cop supports safe auto-correction (--auto-correct).
+# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns, IgnoredPatterns.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 187

data/README.md

@@ -6,11 +6,18 @@
 
 # Cocina::Models
 
-This is a Ruby implementation of the SDR data model (named "COCINA"). The data being modeled includes digital repository objects.
+The cocina-models gem is a Ruby implementation of the Stanford Digital Repository (SDR) data model, which we named "Cocina." The data being modeled is oriented around digital repository objects.
 
-Validation is performed by openapi (using OpenAPIParser). Modeling is provided by dry-struct and dry-types. Together, these provide a way for consumers to validate objects against models and to manipulate those objects.
+The data model is expressed in an OpenAPI specification that lives in this codebase. Expressing the model in such a spec allows for rich validation (using gems such as `OpenAPIParser` and `committee`). The gem provides a set of generators (see below) to generate Ruby classes from the specification, with modeling provided by dry-struct / dry-types. Together, these provide a way for consumers to validate objects against models and to manipulate those objects.
 
-This is a work in progress that will ultimately implement the full [COCINA data model](http://sul-dlss.github.io/cocina-models/). See also [architecture documentation](https://sul-dlss.github.io/taco-truck/COCINA.html#cocina-data-models--shapes).
+Note that the data model encodes properties as camelCase, which the team believes to be consistent with other HTTP APIs and the original design of the Cocina data model. While using camelCase in Ruby code may look and feel wrong, we did explore automagic conversion between camelCase in the model and snake_case in the Ruby context. We ultimately concluded that we have enough representations of the data model in enough codebases to reasonably worry about data inconsistency problems, none of which we need in our work on SDR.
+
+## Configuration
+
+Set the PURL url base:
+```ruby
+Cocina::Models::Mapping::Purl.base_url = Settings.release.purl_base_url
+```
 
 ## Generate models from openapi.yml
 
@@ -48,8 +55,37 @@ If there is a possibility that a model or validation change will conflict with s
 
 1. Create a cocina-models branch containing the proposed change and push to Github.
 2. On sdr-deploy, check out `main`, update the `Gemfile` so that cocina-models references the branch, and `bundle install`.
-3. Run `bin/validate-cocina`.
-4. Check `validate-cocina.csv` for validation errors.
+3. Select the appropriate database.
+For QA:
+```
+export DATABASE_NAME="dor_services"
+export DATABASE_USERNAME=$DOR_SERVICES_DB_USER
+export DATABASE_HOSTNAME=$DOR_SERVICES_DB_QA_HOST
+export DATABASE_PASSWORD=$DOR_SERVICES_DB_QA_PWD
+```
+
+For stage:
+```
+export DATABASE_NAME="dor_services"
+export DATABASE_USERNAME=$DOR_SERVICES_DB_USER
+export DATABASE_HOSTNAME=$DOR_SERVICES_DB_STAGE_HOST
+export DATABASE_PASSWORD=$DOR_SERVICES_DB_STAGE_PWD
+```
+
+For production:
+```
+export DATABASE_NAME="dor_services"
+export DATABASE_USERNAME=$DOR_SERVICES_DB_USER
+export DATABASE_HOSTNAME=$DOR_SERVICES_DB_PROD_HOST
+export DATABASE_PASSWORD=$DOR_SERVICES_DB_PROD_PWD
+```
+
+4. Run `bin/validate-cocina`:
+```
+export RUBYOPT='-W:no-deprecated -W:no-experimental'
+RAILS_ENV=production bin/validate-cocina -p 8
+```
+5. Check `validate-cocina.csv` for validation errors.
 
 ## Releasing
 

data/cocina-models.gemspec

@@ -28,6 +28,8 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'deprecation'
   spec.add_dependency 'dry-struct', '~> 1.0'
   spec.add_dependency 'dry-types', '~> 1.1'
+  spec.add_dependency 'equivalent-xml' # for diffing MODS
+  spec.add_dependency 'nokogiri'
   spec.add_dependency 'openapi3_parser' # Parsing openapi doc
   # Match these version requirements to what committee wants,
   # so that our client (non-committee) users have the same dependencies.