ezid-client 0.12.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 06c4a2e03acdbef8b3da067ca693fd51f8a5ba1e
-  data.tar.gz: 5347307f3892f3beaac5ea59e2a8d091b2ad12ac
+  metadata.gz: a879db606f554ad22f27d2a94de3ea22b13b4b45
+  data.tar.gz: cbf0e449920590e6c7e5bbf83fade23fca94a474
 SHA512:
-  metadata.gz: acb785db04eaae33f870c1dd7ab1e292ca58b5b4dab7647b2ac15cb0daae37c3d82b4065f60380efb6530353e83c204d25d7206ec506636c19d77d751549293e
-  data.tar.gz: 34a9362e2dc610bf0a03c14d4174726556286d8e892a04b4eee9e4a06d9f916802bd668a64679f9e4b67402e66c1613948ed2487859301f01bf4160140aef99b
+  metadata.gz: f4edff18cfd3337b0445ea6aa57fcaa43cdfaa70c0f2538c8df63feb37901f51b155b45039849359bbff5cd0c574183a5efb521102f15f145b643c5b77a22085
+  data.tar.gz: 70325ab88f390c26180dc130b7862f4b0b6e70584c4178e8c707f8c2a9ae78f098fc06b4e6eb37225ddc1f650d36760e0364d8ea938f2a258e57adebe3cf1ca7

data/README.md

@@ -29,8 +29,8 @@ Or install it yourself as:
 
 ```
 >> identifier = Ezid::Identifier.create(shoulder: "ark:/99999/fk4")
-I, [2014-12-04T15:06:02.428445 #86655]  INFO -- : EZID MINT ark:/99999/fk4 -- success: ark:/99999/fk4rx9d523
-I, [2014-12-04T15:06:03.249793 #86655]  INFO -- : EZID GET ark:/99999/fk4rx9d523 -- success: ark:/99999/fk4rx9d523
+I, [2014-12-04T15:06:02.428445 #86655]  INFO -- : EZID MintIdentifier -- success: ark:/99999/fk4rx9d523
+I, [2014-12-04T15:06:03.249793 #86655]  INFO -- : EZID GetIdentifierMetadata -- success: ark:/99999/fk4rx9d523
 => #<Ezid::Identifier id="ark:/99999/fk4rx9d523" status="public" target="http://ezid.cdlib.org/id/ark:/99999/fk4rx9d523" created="2014-12-04 20:06:02 UTC">
 >> identifier.id
 => "ark:/99999/fk4rx9d523"
@@ -60,8 +60,8 @@ New identifiers will then be minted on the default shoulder when a shoulder is n
 
 ```
 >> identifier = Ezid::Identifier.create
-I, [2014-12-09T11:22:34.499860 #32279]  INFO -- : EZID MINT ark:/99999/fk4 -- success: ark:/99999/fk43f4wd4v
-I, [2014-12-09T11:22:35.317181 #32279]  INFO -- : EZID GET ark:/99999/fk43f4wd4v -- success: ark:/99999/fk43f4wd4v
+I, [2014-12-09T11:22:34.499860 #32279]  INFO -- : EZID MintIdentifier -- success: ark:/99999/fk43f4wd4v
+I, [2014-12-09T11:22:35.317181 #32279]  INFO -- : EZID GetIdentifierMetadata -- success: ark:/99999/fk43f4wd4v
 => #<Ezid::Identifier id="ark:/99999/fk43f4wd4v" status="public" target="http://ezid.cdlib.org/id/ark:/99999/fk43f4wd4v" created="2014-12-09 16:22:35 UTC">
 ```
 
@@ -69,8 +69,8 @@ I, [2014-12-09T11:22:35.317181 #32279]  INFO -- : EZID GET ark:/99999/fk43f4wd4v
 
 ```
 >> identifier = Ezid::Identifier.create(id: "ark:/99999/fk4rx9d523/12345")
-I, [2014-12-09T11:21:42.077297 #32279]  INFO -- : EZID CREATE ark:/99999/fk4rx9d523/12345 -- success: ark:/99999/fk4rx9d523/12345
-I, [2014-12-09T11:21:42.808534 #32279]  INFO -- : EZID GET ark:/99999/fk4rx9d523/12345 -- success: ark:/99999/fk4rx9d523/12345
+I, [2014-12-09T11:21:42.077297 #32279]  INFO -- : EZID CreateIdentifier -- success: ark:/99999/fk4rx9d523/12345
+I, [2014-12-09T11:21:42.808534 #32279]  INFO -- : EZID GetIdentifierMetadata -- success: ark:/99999/fk4rx9d523/12345
 => #<Ezid::Identifier id="ark:/99999/fk4rx9d523/12345" status="public" target="http://ezid.cdlib.org/id/ark:/99999/fk4rx9d523/12345" created="2014-12-09 16:21:42 UTC">
 ```
 
@@ -78,7 +78,7 @@ I, [2014-12-09T11:21:42.808534 #32279]  INFO -- : EZID GET ark:/99999/fk4rx9d523
 
 ```
 >> identifier = Ezid::Identifier.find("ark:/99999/fk4rx9d523")
-I, [2014-12-04T15:07:00.648676 #86655]  INFO -- : EZID GET ark:/99999/fk4rx9d523 -- success: ark:/99999/fk4rx9d523
+I, [2014-12-04T15:07:00.648676 #86655]  INFO -- : EZID GetIdentifierMetadata -- success: ark:/99999/fk4rx9d523
 => #<Ezid::Identifier id="ark:/99999/fk4rx9d523" status="public" target="http://ezid.cdlib.org/id/ark:/99999/fk4rx9d523" created="2014-12-04 20:06:02 UTC">
 ```
 
@@ -90,8 +90,8 @@ I, [2014-12-04T15:07:00.648676 #86655]  INFO -- : EZID GET ark:/99999/fk4rx9d523
 >> identifier.target = "http://example.com"
 => "http://example.com"
 >> identifier.save
-I, [2014-12-09T11:24:26.321801 #32279]  INFO -- : EZID MODIFY ark:/99999/fk43f4wd4v -- success: ark:/99999/fk43f4wd4v
-I, [2014-12-09T11:24:27.039288 #32279]  INFO -- : EZID GET ark:/99999/fk43f4wd4v -- success: ark:/99999/fk43f4wd4v
+I, [2014-12-09T11:24:26.321801 #32279]  INFO -- : EZID ModifyIdentifier -- success: ark:/99999/fk43f4wd4v
+I, [2014-12-09T11:24:27.039288 #32279]  INFO -- : EZID GetIdentifierMetadata -- success: ark:/99999/fk43f4wd4v
 => #<Ezid::Identifier id="ark:/99999/fk43f4wd4v" status="public" target="http://example.com" created="2014-12-09 16:22:35 UTC">
 >> identifier.target
 => "http://example.com"
@@ -103,14 +103,32 @@ I, [2014-12-09T11:24:27.039288 #32279]  INFO -- : EZID GET ark:/99999/fk43f4wd4v
 
 ```
 >> identifier = Ezid::Identifier.create(shoulder: "ark:/99999/fk4", status: "reserved")
-I, [2014-12-04T15:12:39.976930 #86734]  INFO -- : EZID MINT ark:/99999/fk4 -- success: ark:/99999/fk4n58pc0r
-I, [2014-12-04T15:12:40.693256 #86734]  INFO -- : EZID GET ark:/99999/fk4n58pc0r -- success: ark:/99999/fk4n58pc0r
+I, [2014-12-04T15:12:39.976930 #86734]  INFO -- : EZID MintIdentifier -- success: ark:/99999/fk4n58pc0r
+I, [2014-12-04T15:12:40.693256 #86734]  INFO -- : EZID GetIdentifierMetadata -- success: ark:/99999/fk4n58pc0r
 => #<Ezid::Identifier id="ark:/99999/fk4n58pc0r" status="reserved" target="http://ezid.cdlib.org/id/ark:/99999/fk4n58pc0r" created="2014-12-04 20:12:39 UTC">
 >> identifier.delete
-I, [2014-12-04T15:12:48.853964 #86734]  INFO -- : EZID DELETE ark:/99999/fk4n58pc0r -- success: ark:/99999/fk4n58pc0r
+I, [2014-12-04T15:12:48.853964 #86734]  INFO -- : EZID DeleteIdentifier -- success: ark:/99999/fk4n58pc0r
 => #<Ezid::Identifier id="ark:/99999/fk4n58pc0r" DELETED>
 ```
 
+## Batch Download
+
+Instantiate an `Ezid::Client` and call `batch_download` with hash options -- see http://ezid.cdlib.org/doc/apidoc.html#parameters. Repeated values should be given as an array value for the parameter key.
+
+Note that, due to the asynchronous nature of this request, the response only returns the URL at which the batch will be available to download (as described in the EZID documentation). Use the `notify` option to specify one or more email addresses to receive notification when the download file is actually available.
+
+**Example**
+
+```
+>> c = Ezid::Client.new
+=> #<Ezid::Client connection=#<Net::HTTP ezid.cdlib.org:443 open=false> user="eziduser" session=CLOSED>
+>> response = c.batch_download(format: "csv", notify: "eziduser@example.com", column: ["_id", "_target", "_status", "_profile", "_export", "_created", "_updated"], convertTimestamps: "yes", permanence: "real", owner: "eziduser")
+I, [2015-02-20T15:16:53.462660 #55850]  INFO -- : EZID BatchDownload -- success: http://ezid.cdlib.org/download/473deecb96.csv.gz
+=> #<Net::HTTPOK 200 OK readbody=true>
+>> response.download_url
+=> "http://ezid.cdlib.org/download/da543b91a0.csv.gz"
+```
+
 ## Metadata handling
 
 Accessors are provided to ease the use of EZID [reserved metadata elements](http://ezid.cdlib.org/doc/apidoc.html#internal-metadata) and [metadata profiles](http://ezid.cdlib.org/doc/apidoc.html#metadata-profiles):
@@ -169,8 +187,8 @@ Then new identifiers will receive the defaults:
 
 ```
 >> identifier = Ezid::Identifier.create(shoulder: "ark:/99999/fk4")
-I, [2014-12-09T11:38:37.335136 #32279]  INFO -- : EZID MINT ark:/99999/fk4 -- success: ark:/99999/fk4zs2w500
-I, [2014-12-09T11:38:38.153546 #32279]  INFO -- : EZID GET ark:/99999/fk4zs2w500 -- success: ark:/99999/fk4zs2w500
+I, [2014-12-09T11:38:37.335136 #32279]  INFO -- : EZID MintIdentifier -- success: ark:/99999/fk4zs2w500
+I, [2014-12-09T11:38:38.153546 #32279]  INFO -- : EZID GetIdentifierMetadata -- success: ark:/99999/fk4zs2w500
 => #<Ezid::Identifier id="ark:/99999/fk4zs2w500" status="reserved" target="http://ezid.cdlib.org/id/ark:/99999/fk4zs2w500" created="2014-12-09 16:38:38 UTC">
 >> identifier.profile
 => "dc"
@@ -232,6 +250,30 @@ end
 client = Ezid::Client.new(host: "localhost", port: 80)
 ```
 
+## HTTP Timeout
+
+The default HTTP timeout is set to 300 seconds (5 minutes). The setting can be customized:
+
+- By environment variable:
+
+```sh
+export EZID_TIMEOUT=600
+```
+
+- Client configuration:
+
+```ruby
+Ezid::Client.configure do |config|
+  config.timeout = 600
+end
+```
+
+- At client initialization
+
+```ruby
+client = Ezid::Client.new(timeout: 600)
+```
+
 ## Test Helper
 
 If you have tests that (directly or indirectly) use `ezid-client` you may want to require the test helper module:

data/VERSION

@@ -1 +1 @@
-0.12.0
+0.13.0

data/lib/ezid/client.rb

@@ -42,12 +42,13 @@ module Ezid
       end
     end
 
-    attr_reader :user, :password, :host, :port, :use_ssl
+    attr_reader :user, :password, :host, :port, :use_ssl, :timeout
 
     def initialize(opts = {})
       @host = opts[:host] || config.host
       @port = (opts[:port] || config.port).to_i
       @use_ssl = opts[:use_ssl] || config.use_ssl
+      @timeout = (opts[:timeout] || config.timeout).to_i
       @user = opts[:user] || config.user
       @password = opts[:password] || config.password
       if block_given?
@@ -169,6 +170,14 @@ module Ezid
       execute ServerStatusRequest, *subsystems
     end
 
+    # Submit a batch download request
+    # @see http://ezid.cdlib.org/doc/apidoc.html#batch-download
+    # @param format [String] format of results - one of "anvl", "csv", "xml"
+    # @param params [Hash] optional request parameters
+    def batch_download(params={})
+      execute BatchDownloadRequest, params
+    end
+
     # The Net::HTTP object used to connect to EZID
     # @return [Net::HTTP] the connection
     def connection
@@ -184,6 +193,7 @@ module Ezid
     def build_connection
       conn = Net::HTTP.new(host, port)
       conn.use_ssl = use_ssl?
+      conn.read_timeout = timeout
       conn
     end
 

data/lib/ezid/configuration.rb

@@ -12,31 +12,27 @@ module Ezid
 
     HOST = "ezid.cdlib.org"
     PORT = 443
+    TIMEOUT = 300
 
     # EZID host name
-    #   Default: value of `EZID_HOST` environment variable, if present, or
-    #   the EZID service host "ezid.cdlib.org".
     attr_accessor :host
 
     # EZID TCP/IP port
-    #   Default: value of `EZID_PORT` variable
     attr_accessor :port
 
     # Use HTTPS?
-    #   Default: `nil`; `true` if `EZID_USE_SSL` environment variable is set
-    #   to the string "true".
     attr_accessor :use_ssl
 
+    # HTTP read timeout (seconds)
+    attr_accessor :timeout
+
     # EZID user name
-    #   Default: value of `EZID_USER` environment variable
     attr_accessor :user
 
     # EZID password
-    #   Default: value of `EZID_PASSWORD` environment variable
     attr_accessor :password
 
     # Ruby logger instance
-    #   Default device: STDERR
     attr_writer :logger
 
     # Default shoulder for minting (scheme + NAAN + shoulder)
@@ -48,7 +44,8 @@ module Ezid
       @password         = ENV["EZID_PASSWORD"]
       @host             = ENV["EZID_HOST"] || HOST
       @port             = ENV["EZID_PORT"] || PORT
-      @use_ssl          = true if ENV["EZID_USE_SSL"] == true.to_s
+      @use_ssl          = vvciujcrdjhcbtrue if ENV["EZID_USE_SSL"] == true.to_s
+      @timeout          = ENV["EZID_TIMEOUT"] || TIMEOUT
       @default_shoulder = ENV["EZID_DEFAULT_SHOULDER"]
     end
 

data/lib/ezid/requests/batch_download_request.rb

@@ -0,0 +1,22 @@
+require_relative "request"
+
+module Ezid
+  class BatchDownloadRequest < Request
+
+    self.http_method = POST
+    self.path = "/download_request"
+    self.response_class = BatchDownloadResponse
+
+    attr_reader :params
+
+    def initialize(client, params={})
+      @params = params
+      super
+    end
+
+    def customize_request
+      set_form_data(params)
+    end
+
+  end
+end

data/lib/ezid/requests/request.rb

@@ -15,9 +15,6 @@ module Ezid
   class Request < SimpleDelegator
     extend Forwardable
 
-    CHARSET = "UTF-8"
-    CONTENT_TYPE = "text/plain"
-
     # HTTP methods
     GET = Net::HTTP::Get
     PUT = Net::HTTP::Put
@@ -45,6 +42,7 @@ module Ezid
     def initialize(client, *args)
       @client = client
       super build_request
+      customize_request
     end
 
     # Executes the request and returns the response
@@ -93,13 +91,16 @@ module Ezid
 
     def get_response_for_request
       connection.start do |conn| 
-        set_content_type(CONTENT_TYPE, charset: CHARSET)
         add_authentication if authentication_required?
         add_metadata if has_metadata?
         conn.request(__getobj__) 
       end
     end
 
+    def customize_request
+      set_content_type("text/plain", charset: "UTF-8")
+    end
+
     def build_request
       self.class.http_method.new(uri)
     end

data/lib/ezid/responses/batch_download_response.rb

@@ -0,0 +1,11 @@
+require_relative "response"
+
+module Ezid
+  class BatchDownloadResponse < Response
+
+    def download_url
+      message
+    end
+
+  end
+end

data/spec/integration/client_spec.rb

@@ -1,3 +1,5 @@
+require "time"
+
 module Ezid
   RSpec.describe Client do
 
@@ -9,7 +11,6 @@ module Ezid
         modified = client.modify_identifier(@id, "dc.title" => "Test")
         expect(modified).to be_success
         retrieved = client.get_identifier_metadata(@id)
-        puts retrieved.class.to_s
         expect(retrieved).to be_success
         expect(retrieved.metadata).to match(/dc.title: Test/)
         deleted = client.delete_identifier(@id)
@@ -63,5 +64,19 @@ module Ezid
       end
     end
 
+    describe "batch download" do
+      before do
+        r = subject.mint_identifier
+        r = subject.get_identifier_metadata(r.id)
+        metadata = Metadata.new(r.metadata)
+        @created = metadata.created.iso8601
+      end
+      it "should return a valid URL" do
+        response = subject.batch_download(format: "anvl", createdAfter: @created, permanence: "test")
+        expect(response).to be_success
+        expect(response.download_url).to match(/^http:\/\/ezid.cdlib.org\/download\/[^\/]+.gz$/)
+      end
+    end
+
   end
 end

data/spec/unit/batch_download_request_spec.rb

@@ -0,0 +1,26 @@
+module Ezid
+  RSpec.describe BatchDownloadRequest do
+
+    let(:client) { Client.new }
+    let(:params) do
+      { format: "xml",
+        notify: "noreply@example.com",
+        convertTimestamps: "yes",
+        exported: "no",
+        owner: ["you", "me"],
+        status: ["reserved", "unavailable"],
+        type: "ark"
+      }
+    end
+    subject { described_class.new(client, params) }
+
+    it "should add the request params to the request body" do
+      expect(subject.body).to eq("format=xml&notify=noreply%40example.com&convertTimestamps=yes&exported=no&owner=you&owner=me&status=reserved&status=unavailable&type=ark")
+    end
+
+    it "should have the correct content type" do
+      expect(subject.content_type).to eq("application/x-www-form-urlencoded")
+    end
+
+  end
+end

data/spec/unit/client_spec.rb

@@ -137,6 +137,19 @@ EOS
       end
     end
 
+    describe "batch download" do
+      let(:stub_response) { BatchDownloadResponse.new(http_response) }
+      let(:http_response) { double(body: "success: http://ezid.cdlib.org/download/da543b91a0.xml.gz") }
+      before do
+        allow(BatchDownloadRequest).to receive(:execute).with(subject, format: "xml") { stub_response }
+      end
+      it "should return the URL to download the batch" do
+        response = subject.batch_download(format: "xml")
+        expect(response).to be_success
+        expect(response.download_url).to eq("http://ezid.cdlib.org/download/da543b91a0.xml.gz")
+      end
+    end
+
     describe "error handling" do
       let(:http_response) { double(body: "error: bad request - no such identifier") }
       it "should raise an exception" do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ezid-client
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 0.13.0
 platform: ruby
 authors:
 - David Chandek-Stark
@@ -74,6 +74,7 @@ files:
 - lib/ezid/error.rb
 - lib/ezid/identifier.rb
 - lib/ezid/metadata.rb
+- lib/ezid/requests/batch_download_request.rb
 - lib/ezid/requests/create_identifier_request.rb
 - lib/ezid/requests/delete_identifier_request.rb
 - lib/ezid/requests/get_identifier_metadata_request.rb
@@ -85,6 +86,7 @@ files:
 - lib/ezid/requests/modify_identifier_request.rb
 - lib/ezid/requests/request.rb
 - lib/ezid/requests/server_status_request.rb
+- lib/ezid/responses/batch_download_response.rb
 - lib/ezid/responses/create_identifier_response.rb
 - lib/ezid/responses/delete_identifier_response.rb
 - lib/ezid/responses/get_identifier_metadata_response.rb
@@ -101,6 +103,7 @@ files:
 - spec/integration/client_spec.rb
 - spec/integration/identifier_spec.rb
 - spec/spec_helper.rb
+- spec/unit/batch_download_request_spec.rb
 - spec/unit/client_spec.rb
 - spec/unit/identifier_spec.rb
 - spec/unit/metadata_spec.rb
@@ -132,6 +135,7 @@ test_files:
 - spec/integration/client_spec.rb
 - spec/integration/identifier_spec.rb
 - spec/spec_helper.rb
+- spec/unit/batch_download_request_spec.rb
 - spec/unit/client_spec.rb
 - spec/unit/identifier_spec.rb
 - spec/unit/metadata_spec.rb