Added dictionary entry retrieval

Author: Richard Degenne

README.md

@@ -101,6 +101,14 @@ client.create_dictionary('my-dictionary', case_insensitive: true)
 client.create_dictionary_entries('my-dictionary', [{id: 'my-entry', text: 'Text to be matched'}])
 ```
 
+#### Getting entries from a dictionary
+
+```
+client.get_dictionary_entries('my-dictionary')
+
+# Using pagination
+client.get_dictionary_entries('my-dictionary', limit: 20, offset: 0)
+```
 
 #### Deleting a dictionary entry
 

lib/textrazor/client.rb

@@ -42,6 +42,14 @@ def create_dictionary(id, **options)
       Request.create_dictionary(api_key, dictionary)
     end
 
+    def get_dictionary_entries(dictionary_id, limit: 0, offset: 0)
+      response = ApiResponse.new(
+        Request.get_dictionary_entries(api_key, dictionary_id, limit: limit, offset: offset)
+      )
+      return [] unless response.raw_response.key?(:entries)
+      response.raw_response[:entries].map { |hash| DictionaryEntry.create_from_hash(hash) }
+    end
+
     def delete_dictionary(dictionary_id)
       Request.delete_dictionary(api_key, dictionary_id)
     end

lib/textrazor/request.rb

@@ -35,6 +35,13 @@ def self.create_dictionary(api_key, dictionary, **options)
       dictionary
     end
 
+    def self.get_dictionary_entries(api_key, dictionary_id, limit:, offset:)
+      ::RestClient.get(
+        url("entities/#{dictionary_id}/_all?limit=#{limit}&offset=#{offset}"),
+        build_headers(api_key)
+      )
+    end
+
     def self.delete_dictionary(api_key, dictionary_id)
       ::RestClient.delete(
         url("entities/#{dictionary_id}"),

spec/lib/textrazor/request_spec.rb

@@ -96,6 +96,17 @@ module TextRazor
       end
     end
 
+    context ".get_dictionary_entries" do
+
+      it "should make correct calls" do
+        expect(::RestClient).to receive(:get).
+          with("https://api.textrazor.com/entities/id/_all?limit=10&offset=20",
+               accept_encoding: 'gzip', x_textrazor_key: 'api_key')
+
+        Request.get_dictionary_entries(api_key, 'id', limit: 10, offset: 20)
+      end
+    end
+
     context ".delete_dictionary" do
 
       it "should make correct calls" do