Class: Wikipedia::Client

Inherits:
Object
  • Object
show all
Defined in:
lib/wikipedia/client.rb

Constant Summary collapse

BASE_URL_TEMPLATE =

see en.wikipedia.org/w/api.php

'%{protocol}://%{domain}/%{path}?action=%{action}&format=json'.freeze
BASE_URL_OPTIONS = 
Set.new([:protocol, :domain, :path, :action])

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Client

Returns a new instance of Client.



14
15
16
 
# File 'lib/wikipedia/client.rb', line 14

def initialize
  self.follow_redirects = true
end

Instance Attribute Details

#follow_redirects ⇒ Object

Returns the value of attribute follow_redirects.



12
13
14
 
# File 'lib/wikipedia/client.rb', line 12

def follow_redirects
  @follow_redirects
end

Instance Method Details

#find(title, options = {}) ⇒ Object 



18
19
20
21
22
23
24
25
 
# File 'lib/wikipedia/client.rb', line 18

def find( title, options = {} )
  title = Url.new(title).title rescue title
  page = Page.new( request_page( title, options ) )
  while follow_redirects && page.redirect?
    page = Page.new( request_page( page.redirect_title, options ) )
  end
  page
end

#find_image(title, options = {}) ⇒ Object 



27
28
29
30
 
# File 'lib/wikipedia/client.rb', line 27

def find_image( title, options = {} )
  title = Url.new(title).title rescue title
  Page.new( request_image( title, options ) )
end

#find_random(options = {}) ⇒ Object 



32
33
34
35
36
37
 
# File 'lib/wikipedia/client.rb', line 32

def find_random( options = {} )
  require 'json'
  data = JSON.parse( request_random( options ) )
  title = data['query']['pages'].values[0]['title']
  find( title, options )
end

#request(options) ⇒ Object 



74
75
76
 
# File 'lib/wikipedia/client.rb', line 74

def request( options )
  URI.parse( url_for( options ) ).read( 'User-Agent' => Configuration[:user_agent] )
end

#request_image(title, options = {}) ⇒ Object 



54
55
56
57
58
59
60
61
62
 
# File 'lib/wikipedia/client.rb', line 54

def request_image( title, options = {} )
  request( {
    action: 'query',
    prop: 'imageinfo',
    iiprop: 'url',
    iiurlwidth: options && options[:iiurlwidth] ? options[:iiurlwidth] : 200,
    titles: title
  }.merge( options ) )
end

#request_page(title, options = {}) ⇒ Object

en.wikipedia.org/w/api.php?action=query&format=json&prop=revisions%7Clinks%7Cimages%7Ccategories&rvprop=content&titles=Flower%20(video%20game)



40
41
42
43
44
45
46
47
48
49
50
51
 
# File 'lib/wikipedia/client.rb', line 40

def request_page( title, options = {} )
  request( {
    action: 'query',
    prop: %w[info revisions links extlinks images categories coordinates templates extracts pageimages langlinks],
    rvprop: 'content',
    inprop: 'url',
    pithumbsize: 200,
    explaintext: '',
    lllimit: 500,
    titles: title
  }.merge( options ) )
end

#request_random(options = {}) ⇒ Object

en.wikipedia.org/w/api.php?action=query&generator=random&grnnamespace=0&prop=info



65
66
67
68
69
70
71
72
 
# File 'lib/wikipedia/client.rb', line 65

def request_random( options = {} )
  request( {
    action: 'query',
    generator: 'random',
    grnnamespace: '0',
    prop: 'info'
  }.merge( options ) )
end