Module: MediaWiktory::Wikipedia::Modules::GAlllinks

Defined in:
lib/mediawiktory/wikipedia/modules/g-alllinks.rb

Overview

Enumerate all links that point to a given namespace. Generator module: for fetching pages corresponding to request.

The "submodule" (MediaWiki API term) is included in action after setting some param, providing additional tweaking for this param. Example (for Actions::Query and its submodules):

api.query             # returns Actions::Query
   .prop(:revisions)  # adds prop=revisions to action URL, and includes Modules::Revisions into action
   .limit(10)         # method of Modules::Revisions, adds rvlimit=10 to URL

All submodule's parameters are documented as its public methods, see below.

Instance Method Summary collapse

Instance Method Details

#continue(value) ⇒ self

When more results are available, use this to continue.

Parameters:

  • value (String)

Returns:

  • (self) 


25
26
27
 
# File 'lib/mediawiktory/wikipedia/modules/g-alllinks.rb', line 25

def continue(value)
  merge(galcontinue: value.to_s)
end

#dir(value) ⇒ self

The direction in which to list.

Parameters:

  • value (String) —

    One of "ascending", "descending".

Returns:

  • (self) 


85
86
87
 
# File 'lib/mediawiktory/wikipedia/modules/g-alllinks.rb', line 85

def dir(value)
  _dir(value) or fail ArgumentError, "Unknown value for dir: #{value}"
end

#from(value) ⇒ self

The title of the link to start enumerating from.

Parameters:

  • value (String)

Returns:

  • (self) 


33
34
35
 
# File 'lib/mediawiktory/wikipedia/modules/g-alllinks.rb', line 33

def from(value)
  merge(galfrom: value.to_s)
end

#limit(value) ⇒ self

How many total items to return.

Parameters:

  • value (Integer, "max")

Returns:

  • (self) 


77
78
79
 
# File 'lib/mediawiktory/wikipedia/modules/g-alllinks.rb', line 77

def limit(value)
  merge(gallimit: value.to_s)
end

#namespace(value) ⇒ self

The namespace to enumerate.

Parameters:

  • value (String) —

    One of "-2", "-1", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "100", "101", "108", "109", "118", "119", "446", "447", "710", "711", "828", "829", "2300", "2301", "2302", "2303".

Returns:

  • (self) 


64
65
66
 
# File 'lib/mediawiktory/wikipedia/modules/g-alllinks.rb', line 64

def namespace(value)
  _namespace(value) or fail ArgumentError, "Unknown value for namespace: #{value}"
end

#prefix(value) ⇒ self

Search for all linked titles that begin with this value.

Parameters:

  • value (String)

Returns:

  • (self) 


49
50
51
 
# File 'lib/mediawiktory/wikipedia/modules/g-alllinks.rb', line 49

def prefix(value)
  merge(galprefix: value.to_s)
end

#to(value) ⇒ self

The title of the link to stop enumerating at.

Parameters:

  • value (String)

Returns:

  • (self) 


41
42
43
 
# File 'lib/mediawiktory/wikipedia/modules/g-alllinks.rb', line 41

def to(value)
  merge(galto: value.to_s)
end

#unique ⇒ self

Only show distinct linked titles. Cannot be used with alprop=ids. When used as a generator, yields target pages instead of source pages.

Returns:

  • (self) 


56
57
58
 
# File 'lib/mediawiktory/wikipedia/modules/g-alllinks.rb', line 56

def unique()
  merge(galunique: 'true')
end