wikipedia-client 1.15.0 → 1.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: af50d4fda3d70e5bd837bde17b2ca86ec4c653c92891a5088246772da4ca45b5
-  data.tar.gz: 6366ad0bf999ed51533fd49963b4fa6d36e7181d49fc9bab227407cc3f76300f
+  metadata.gz: 6bd75b9c5cb006f00a42ee85054e1cce3d61d942c6c2c8d55f01d46ce594ad0e
+  data.tar.gz: 594bdcb73afa6d02d3a6761bad0180df3b19896f1474bdfbcfed04382318afb4
 SHA512:
-  metadata.gz: d0f6e70ee49591fb4fb1238cd35ede198ff14e6efd89ddfbc972e4c7b03ff3aeabc2770c80f7981af5ec30d820ffbd5ca4a4870da944686d612134d34dacde87
-  data.tar.gz: 701089ac1c06f95ea5b67afba9b7d6754c967d0d4411f7b95b3f8a8f456b9adabc4ab67036be5024c70a1d21022144a5e88d4693c76d719ab3ad4bff0cd01e9d
+  metadata.gz: a9dd0e851b81c6f59769eae01e7439c11efba75684c321eb26589b572ead963235b2b8a322169b7171908ef930a4fddcb61766e605acee5ae1d4fa3e08bea6d4
+  data.tar.gz: b54cd43b57dafc5409a3e4524623bebbc3c275c26c97c6aeed7ccb821a075025d3dd93f41e557155e219e7346b4138c72c012f1bd175c34b49679c0d8334a4ee

data/README.md

@@ -124,6 +124,29 @@ page.raw_data
 "lastrevid"=>348481810, "counter"=>0, "length"=>7891}}}}
 ```
 
+### Additional HTTP headers
+
+Some API features require tweaking HTTP headers. You can add additional headers via configuration.
+
+For example, to retrieve the same page in different language variants:
+
+```ruby
+Wikipedia.configure do
+   domain 'zh.wikipedia.org'
+   headers({ 'Accept-Language' => 'zh-tw' })
+end
+
+Wikipedia.find('牛肉').summary #=> "牛肉是指從牛身上得出的肉，為常見的肉品之一。肌肉部分可以切成牛排、牛肉塊或牛仔骨，也可以與其他的肉混合做成香腸或血腸。"
+
+Wikipedia.configure do
+   domain 'zh.wikipedia.org'
+   headers({ 'Accept-Language' => 'zh-cn' })
+end
+
+Wikipedia.find('牛肉').summary #=> "牛肉是指从牛身上得出的肉，为常见的肉品之一。肌肉部分可以切成牛排、牛肉块或牛仔骨，也可以与其他的肉混合做成香肠或血肠。"
+```
+
+
 ## Contributing
 
 ### Getting the code, and running the tests

data/lib/wikipedia/client.rb

@@ -73,7 +73,7 @@ module Wikipedia
     end
 
     def request( options )
-      URI.parse( url_for( options ) ).read( 'User-Agent' => @configuration[:user_agent] )
+      URI.parse( url_for( options ) ).read( headers )
     end
 
     protected
@@ -114,5 +114,11 @@ module Wikipedia
       end
       [h1, h2]
     end
+
+    def headers
+      {
+        'User-Agent' => @configuration[:user_agent]
+      }.merge( @configuration[:headers] )
+    end
   end
 end

data/lib/wikipedia/configuration.rb

@@ -4,7 +4,8 @@ module Wikipedia
       protocol: 'https',
       domain: 'en.wikipedia.org',
       path: 'w/api.php',
-      user_agent: 'wikipedia-client/1.7 (https://github.com/kenpratt/wikipedia-client)'
+      user_agent: 'wikipedia-client/1.7 (https://github.com/kenpratt/wikipedia-client)',
+      headers: {}
     }.freeze
 
     def initialize(configuration = DEFAULT)
@@ -25,6 +26,6 @@ module Wikipedia
       end
     end
 
-    directives :protocol, :domain, :path, :user_agent
+    directives :protocol, :domain, :path, :user_agent, :headers
   end
 end

data/lib/wikipedia/url.rb

@@ -11,7 +11,12 @@ module Wikipedia
       return @title if @title
 
       uri     = URI.parse( @wiki_url )
-      @title  = Addressable::URI.unencode( uri.path.sub(/\/wiki\//, '') )
+      @title  =
+        if uri.path.empty?
+          @wiki_url
+        else
+          Addressable::URI.unencode( uri.path.sub(/\/wiki\//, '') )
+        end
     end
   end
 end

data/lib/wikipedia/version.rb

@@ -1,3 +1,3 @@
 module Wikipedia
-  VERSION = '1.15.0'.freeze
+  VERSION = '1.16.0'.freeze
 end

data/lib/wikipedia-client.rb

@@ -0,0 +1,2 @@
+# rubocop:disable Style/FileName
+require 'wikipedia'

data/lib/wikipedia.rb

@@ -24,7 +24,7 @@ module Wikipedia
   end
 
   def self.configure(&block)
-    @configuration.instance_eval(&block)
+    configuration.instance_eval(&block)
   end
 
   # rubocop:disable Style/MethodName
@@ -35,9 +35,12 @@ module Wikipedia
   class << self
     private
 
-    def client
+    def configuration
       @configuration ||= Wikipedia::Configuration.new
-      @client ||= Wikipedia::Client.new @configuration
+    end
+
+    def client
+      @client ||= Wikipedia::Client.new configuration
     end
   end
 end

data/spec/lib/url_spec.rb

@@ -6,3 +6,10 @@ describe Wikipedia::Url, 'like http://en.wikipedia.org/wiki/Getting_Things_Done'
     expect(url.title).to eq('Getting_Things_Done')
   end
 end
+
+describe Wikipedia::Url, 'like "? (Lost)"' do
+  it 'should return input as title' do
+    url = Wikipedia::Url.new('? (Lost)')
+    expect(url.title).to eq('? (Lost)')
+  end
+end

data/spec/lib/wikipedia_spec.rb

@@ -18,3 +18,15 @@ describe Wikipedia, '.find' do
     expect(page1.title).to eq(page2.title)
   end
 end
+
+describe Wikipedia, '.configure' do
+  it 'should set configuration' do
+    Wikipedia.configure do
+      protocol 'https'
+      domain 'zh.wikipedia.org'
+    end
+
+    page = Wikipedia.find('Getting_Things_Done')
+    expect(page.fullurl).to start_with('https://zh.wikipedia.org')
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wikipedia-client
 version: !ruby/object:Gem::Version
-  version: 1.15.0
+  version: 1.16.0
 platform: ruby
 authors:
 - Cyril David
@@ -13,7 +13,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-07-06 00:00:00.000000000 Z
+date: 2021-09-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -46,6 +46,7 @@ files:
 - Rakefile
 - init.rb
 - install.rb
+- lib/wikipedia-client.rb
 - lib/wikipedia.rb
 - lib/wikipedia/client.rb
 - lib/wikipedia/configuration.rb