module MediaWiktory::Wikipedia::Modules::Allrevisions

List all revisions.

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

“`ruby 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.

Public Instance Methods

_contentformat(value) click to toggle source

@private

Calls superclass method
# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 103
def _contentformat(value)
  defined?(super) && super || ["application/json", "text/x-wiki", "text/javascript", "text/css", "text/plain"].include?(value.to_s) && merge(arvcontentformat: value.to_s)
end
_dir(value) click to toggle source

@private

Calls superclass method
# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 153
def _dir(value)
  defined?(super) && super || ["newer", "older"].include?(value.to_s) && merge(arvdir: value.to_s)
end
_namespace(value) click to toggle source

@private

Calls superclass method
# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 124
def _namespace(value)
  defined?(super) && super || ["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"].include?(value.to_s) && merge(arvnamespace: value.to_s, replace: false)
end
_prop(value) click to toggle source

@private

Calls superclass method
# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 30
def _prop(value)
  defined?(super) && super || ["ids", "flags", "timestamp", "user", "userid", "size", "sha1", "contentmodel", "comment", "parsedcomment", "content", "tags", "parsetree"].include?(value.to_s) && merge(arvprop: value.to_s, replace: false)
end
contentformat(value) click to toggle source

Serialization format used for arvdifftotext and expected for output of content.

@param value [String] One of “application/json”, “text/x-wiki”, “text/javascript”, “text/css”, “text/plain”. @return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 98
def contentformat(value)
  _contentformat(value) or fail ArgumentError, "Unknown value for contentformat: #{value}"
end
continue(value) click to toggle source

When more results are available, use this to continue.

@param value [String] @return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 169
def continue(value)
  merge(arvcontinue: value.to_s)
end
diffto(value) click to toggle source

Revision ID to diff each revision to. Use prev, next and cur for the previous, next and current revision respectively.

@param value [String] @return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 75
def diffto(value)
  merge(arvdiffto: value.to_s)
end
difftotext(value) click to toggle source

Text to diff each revision to. Only diffs a limited number of revisions. Overrides arvdiffto. If arvsection is set, only that section will be diffed against this text.

@param value [String] @return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 83
def difftotext(value)
  merge(arvdifftotext: value.to_s)
end
difftotextpst() click to toggle source

Perform a pre-save transform on the text before diffing it. Only valid when used with arvdifftotext.

@return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 90
def difftotextpst()
  merge(arvdifftotextpst: 'true')
end
dir(value) click to toggle source

In which direction to enumerate:

@param value [String] One of “newer” (List oldest first. Note: arvstart has to be before arvend), “older” (List newest first (default). Note: arvstart has to be later than arvend). @return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 148
def dir(value)
  _dir(value) or fail ArgumentError, "Unknown value for dir: #{value}"
end
end(value) click to toggle source

The timestamp to stop enumerating at.

@param value [Time] @return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 140
def end(value)
  merge(arvend: value.iso8601)
end
excludeuser(value) click to toggle source

Don't list revisions by this user.

@param value [String] @return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 161
def excludeuser(value)
  merge(arvexcludeuser: value.to_s)
end
expandtemplates() click to toggle source

Expand templates in revision content (requires arvprop=content).

@return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 45
def expandtemplates()
  merge(arvexpandtemplates: 'true')
end
generatetitles() click to toggle source

When being used as a generator, generate titles rather than revision IDs.

@return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 176
def generatetitles()
  merge(arvgeneratetitles: 'true')
end
generatexml() click to toggle source

Generate XML parse tree for revision content (requires arvprop=content; replaced by arvprop=parsetree).

@return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 52
def generatexml()
  merge(arvgeneratexml: 'true')
end
limit(value) click to toggle source

Limit how many revisions will be returned.

@param value [Integer, “max”] @return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 38
def limit(value)
  merge(arvlimit: value.to_s)
end
namespace(*values) click to toggle source

Only list pages in this namespace.

@param values [Array<String>] Allowed values: “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”. @return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 119
def namespace(*values)
  values.inject(self) { |res, val| res._namespace(val) or fail ArgumentError, "Unknown value for namespace: #{val}" }
end
parse() click to toggle source

Parse revision content (requires arvprop=content). For performance reasons, if this option is used, arvlimit is enforced to 1.

@return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 59
def parse()
  merge(arvparse: 'true')
end
prop(*values) click to toggle source

Which properties to get for each revision:

@param values [Array<String>] Allowed values: “ids” (The ID of the revision), “flags” (Revision flags (minor)), “timestamp” (The timestamp of the revision), “user” (User that made the revision), “userid” (User ID of the revision creator), “size” (Length (bytes) of the revision), “sha1” (SHA-1 (base 16) of the revision), “contentmodel” (Content model ID of the revision), “comment” (Comment by the user for the revision), “parsedcomment” (Parsed comment by the user for the revision), “content” (Text of the revision), “tags” (Tags for the revision), “parsetree” (The XML parse tree of revision content (requires content model wikitext)). @return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 25
def prop(*values)
  values.inject(self) { |res, val| res._prop(val) or fail ArgumentError, "Unknown value for prop: #{val}" }
end
section(value) click to toggle source

Only retrieve the content of this section number.

@param value [String] @return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 67
def section(value)
  merge(arvsection: value.to_s)
end
start(value) click to toggle source

The timestamp to start enumerating from.

@param value [Time] @return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 132
def start(value)
  merge(arvstart: value.iso8601)
end
user(value) click to toggle source

Only list revisions by this user.

@param value [String] @return [self]

# File lib/mediawiktory/wikipedia/modules/allrevisions.rb, line 111
def user(value)
  merge(arvuser: value.to_s)
end