Module: MediaWiktory::Wikipedia::Modules::Alldeletedrevisions

Defined in:
lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb

Overview

List all deleted revisions by a user or in a namespace.

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

#contentformat(value) ⇒ self

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

Parameters:

  • value (String) —

    One of "application/json", "text/x-wiki", "text/javascript", "text/css", "text/plain".

Returns:

  • (self) 


98
99
100
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 98

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

#continue(value) ⇒ self

When more results are available, use this to continue.

Parameters:

  • value (String)

Returns:

  • (self) 


201
202
203
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 201

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

#diffto(value) ⇒ self

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

Parameters:

  • value (String)

Returns:

  • (self) 


75
76
77
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 75

def diffto(value)
  merge(adrdiffto: value.to_s)
end

#difftotext(value) ⇒ self

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

Parameters:

  • value (String)

Returns:

  • (self) 


83
84
85
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 83

def difftotext(value)
  merge(adrdifftotext: value.to_s)
end

#difftotextpst ⇒ self

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

Returns:

  • (self) 


90
91
92
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 90

def difftotextpst()
  merge(adrdifftotextpst: 'true')
end

#dir(value) ⇒ self

In which direction to enumerate:

Parameters:

  • value (String) —

    One of "newer" (List oldest first. Note: adrstart has to be before adrend), "older" (List newest first (default). Note: adrstart has to be later than adrend).

Returns:

  • (self) 


148
149
150
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 148

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

#end(value) ⇒ self

The timestamp to stop enumerating at.

Parameters:

  • value (Time)

Returns:

  • (self) 


140
141
142
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 140

def end(value)
  merge(adrend: value.iso8601)
end

#excludeuser(value) ⇒ self

Don't list revisions by this user.

Parameters:

  • value (String)

Returns:

  • (self) 


185
186
187
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 185

def excludeuser(value)
  merge(adrexcludeuser: value.to_s)
end

#expandtemplates ⇒ self

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

Returns:

  • (self) 


45
46
47
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 45

def expandtemplates()
  merge(adrexpandtemplates: 'true')
end

#from(value) ⇒ self

Start listing at this title.

Parameters:

  • value (String)

Returns:

  • (self) 


161
162
163
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 161

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

#generatetitles ⇒ self

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

Returns:

  • (self) 


208
209
210
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 208

def generatetitles()
  merge(adrgeneratetitles: 'true')
end

#generatexml ⇒ self

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

Returns:

  • (self) 


52
53
54
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 52

def generatexml()
  merge(adrgeneratexml: 'true')
end

#limit(value) ⇒ self

Limit how many revisions will be returned.

Parameters:

  • value (Integer, "max")

Returns:

  • (self) 


38
39
40
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 38

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

#namespace(*values) ⇒ self

Only list pages in this namespace.

Parameters:

  • 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".

Returns:

  • (self) 


119
120
121
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 119

def namespace(*values)
  values.inject(self) { |res, val| res._namespace(val) or fail ArgumentError, "Unknown value for namespace: #{val}" }
end

#parse ⇒ self

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

Returns:

  • (self) 


59
60
61
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 59

def parse()
  merge(adrparse: 'true')
end

#prefix(value) ⇒ self

Search for all page titles that begin with this value.

Parameters:

  • value (String)

Returns:

  • (self) 


177
178
179
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 177

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

#prop(*values) ⇒ self

Which properties to get for each revision:

Parameters:

  • 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)).

Returns:

  • (self) 


25
26
27
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.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) ⇒ self

Only retrieve the content of this section number.

Parameters:

  • value (String)

Returns:

  • (self) 


67
68
69
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 67

def section(value)
  merge(adrsection: value.to_s)
end

#start(value) ⇒ self

The timestamp to start enumerating from.

Parameters:

  • value (Time)

Returns:

  • (self) 


132
133
134
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 132

def start(value)
  merge(adrstart: value.iso8601)
end

#tag(value) ⇒ self

Only list revisions tagged with this tag.

Parameters:

  • value (String)

Returns:

  • (self) 


193
194
195
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 193

def tag(value)
  merge(adrtag: value.to_s)
end

#to(value) ⇒ self

Stop listing at this title.

Parameters:

  • value (String)

Returns:

  • (self) 


169
170
171
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 169

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

#user(value) ⇒ self

Only list revisions by this user.

Parameters:

  • value (String)

Returns:

  • (self) 


111
112
113
 
# File 'lib/mediawiktory/wikipedia/modules/alldeletedrevisions.rb', line 111

def user(value)
  merge(adruser: value.to_s)
end