active_fedora-noid 2.0.0.beta4 → 2.0.0.beta5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 709c8e18225adbbd00041373fc45c436166ffa50
-  data.tar.gz: 4b4a569df3483bf994dc154ed986fc4bf700561c
+  metadata.gz: 46a4ec828c77c893dd8fade4ab2cc8bf69c1a5d2
+  data.tar.gz: d711fda28782d2a779cd3cc0a50e1b8d42aae48f
 SHA512:
-  metadata.gz: 8ad9a677d42550c1fa40545ab19b5f872da006971a73cdbe9cf8788667316da5fee10541779f155d156ba772eca59f79d0a9c7db5262c07bb97e0f0320b506d1
-  data.tar.gz: db77507d045c565b2c7aa1ea351f4112405f0dcbaef0f47081f5589e6a56c2099cb1639dd6fda906ac621ec9a30a4229c3607db728a676674f01fa770159477d
+  metadata.gz: 5306a476358ae3063a3b5bac116c4c33fdf242638837dcd571558f7b72d28ada8511ba5bbbe97d263a5e4c2b14ed727ac810ab63ffd85da90ffb52cce2114f74
+  data.tar.gz: a048a5717613df9efafc4f525d6ce5693ce52c2b9e087fe0602eab09d45d6521ab74f1a69655fe36322f5e2b85355698497215b35f1ef96866a951a328e1c9ac

data/README.md

@@ -97,22 +97,23 @@ This will make sure your objects have Noid-like identifiers (e.g. `bb22bb22b`) t
 
 ## Overriding default behavior
 
-The default minter in ActiveFedora::Noid 2.x is the database-backed minter to better support multi-host production installations that expect a shared database but not necessarily a shared filesystem (e.g., between load-balanced Rails applications).
+The default minter in ActiveFedora::Noid 2.x is the file-backed minter to preserve default behavior.
 
-### Use file-based minter state (for replayability)
+To better support multi-host production installations that expect a shared database but not necessarily a shared filesystem (e.g., between load-balanced Rails applications), we highly recommend swapping in the database-backed minter.
 
-The file-based minter -- which was the default and only minter in 1.x -- creates a Noid and dumps it to a statefile in the /tmp directory. You can override the location or name of this statefile as follows in e.g. `config/initializers/active_fedora-noid.rb`:
+### Use database-based minter state
+
+The database-based minter stores minter state information in your application's relational database. To use it, override the AF::Noid configuration in e.g. `config/initializers/active_fedora-noid.rb`:
 
 ```ruby
 require 'active_fedora/noid'
 
 ActiveFedora::Noid.configure do |config|
-  config.minter_class = ActiveFedora::Noid::Minter::File
-  config.statefile = '/var/foo/bar'
+  config.minter_class = ActiveFedora::Noid::Minter::Db
 end
 ```
 
-**NOTE**: If you switch to a new minter, it will not automatically start with the same state as the old minter. AF::Noid does include a couple of rake tasks for copying state from database-backed minters to file-backed ones and vice versa:
+**NOTE 1**: If you switch to a new minter, it will not automatically start with the same state as the old minter. AF::Noid does include a couple of rake tasks for copying state from database-backed minters to file-backed ones and vice versa:
 
 ``` bash
 # For migrating minter state from a file to a database
@@ -121,6 +122,12 @@ $ rake active_fedora:noid:migrate:file_to_database
 $ rake active_fedora:noid:migrate:database_to_file
 ```
 
+**NOTE 2**: If you decide to use the database-backed minter, you may notice that your test suite now fails miserably if it is configured to clear out the application database between tests. If so, you may add the following to e.g. `spec/spec_helper.rb` to set the default minter in the test suite as the file-backed one:
+
+``` ruby
+require 'active_fedora/noid/rspec'
+```
+
 ### Identifier template
 
 To override the default identifier pattern -- a nine-character string consisting of two alphanumeric digits, two numeric digits, two alphanumeric digits, two numeric digits, and a check digit -- put the following code in e.g. `config/initializers/active_fedora-noid.rb`:

data/lib/active_fedora/noid/config.rb

@@ -17,7 +17,7 @@ module ActiveFedora
       end
 
       def minter_class
-        @minter_class ||= Minter::Db
+        @minter_class ||= Minter::File
       end
 
       def translate_uri_to_id

data/lib/active_fedora/noid/rspec.rb

@@ -0,0 +1,7 @@
+RSpec.configure do |config|
+  config.before(:suite) do
+    ActiveFedora::Noid.configure do |noid_config|
+      noid_config.minter_class = ActiveFedora::Noid::Minter::File
+    end
+  end
+end

data/lib/active_fedora/noid/version.rb

@@ -1,5 +1,5 @@
 module ActiveFedora
   module Noid
-    VERSION = '2.0.0.beta4'.freeze
+    VERSION = '2.0.0.beta5'.freeze
   end
 end

data/spec/unit/config_spec.rb

@@ -27,7 +27,7 @@ describe ActiveFedora::Noid::Config do
   end
 
   describe '#minter_class' do
-    let(:default) { ActiveFedora::Noid::Minter::Db }
+    let(:default) { ActiveFedora::Noid::Minter::File }
 
     it 'has a default' do
       expect(subject.minter_class).to eq default

data/spec/unit/service_spec.rb

@@ -5,7 +5,7 @@ describe ActiveFedora::Noid::Service do
   end
 
   it 'has a default minter' do
-    expect(subject.minter).to be_instance_of ActiveFedora::Noid::Minter::Db
+    expect(subject.minter).to be_instance_of ActiveFedora::Noid::Minter::File
   end
 
   context 'with a custom minter' do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: active_fedora-noid
 version: !ruby/object:Gem::Version
-  version: 2.0.0.beta4
+  version: 2.0.0.beta5
 platform: ruby
 authors:
 - Michael J. Giarlo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-10-21 00:00:00.000000000 Z
+date: 2016-10-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: active-fedora
@@ -160,6 +160,7 @@ files:
 - lib/active_fedora/noid/minter/base.rb
 - lib/active_fedora/noid/minter/db.rb
 - lib/active_fedora/noid/minter/file.rb
+- lib/active_fedora/noid/rspec.rb
 - lib/active_fedora/noid/service.rb
 - lib/active_fedora/noid/version.rb
 - lib/generators/active_fedora/noid/install_generator.rb