reality 0.1.0.alpha → 0.1.0.alpha2

data/lib/reality/describers/wikidata/actions/feedwatchlist.rb

@@ -1,108 +0,0 @@
-# frozen_string_literal: true
-
-module Reality::Describers::Wikidata::Impl
-  module Actions
-    # Returns a watchlist feed.
-    #
-    # Usage:
-    #
-    # ```ruby
-    # api.feedwatchlist.feedformat(value).perform # returns string with raw output
-    # # or
-    # api.feedwatchlist.feedformat(value).response # returns output parsed and wrapped into Response object
-    # ```
-    #
-    # See {Base} for generic explanation of working with MediaWiki actions and
-    # {Reality::Describers::Wikidata::Impl::Response} for working with action responses.
-    #
-    # All action's parameters are documented as its public methods, see below.
-    #
-    class Feedwatchlist < Reality::Describers::Wikidata::Impl::Actions::Get
-
-      # The format of the feed.
-      #
-      # @param value [String] One of "rss", "atom".
-      # @return [self]
-      def feedformat(value)
-        _feedformat(value) or fail ArgumentError, "Unknown value for feedformat: #{value}"
-      end
-
-      # @private
-      def _feedformat(value)
-        defined?(super) && super || ["rss", "atom"].include?(value.to_s) && merge(feedformat: value.to_s)
-      end
-
-      # List pages modified within this many hours from now.
-      #
-      # @param value [Integer]
-      # @return [self]
-      def hours(value)
-        merge(hours: value.to_s)
-      end
-
-      # Link directly to changed sections if possible.
-      #
-      # @return [self]
-      def linktosections()
-        merge(linktosections: 'true')
-      end
-
-      # Include multiple revisions of the same page within given timeframe.
-      #
-      # @return [self]
-      def allrev()
-        merge(allrev: 'true')
-      end
-
-      # Used along with token to access a different user's watchlist.
-      #
-      # @param value [String]
-      # @return [self]
-      def wlowner(value)
-        merge(wlowner: value.to_s)
-      end
-
-      # A security token (available in the user's preferences) to allow access to another user's watchlist.
-      #
-      # @param value [String]
-      # @return [self]
-      def wltoken(value)
-        merge(wltoken: value.to_s)
-      end
-
-      # Show only items that meet these criteria. For example, to see only minor edits done by logged-in users, set show=minor|!anon.
-      #
-      # @param values [Array<String>] Allowed values: "minor", "!minor", "bot", "!bot", "anon", "!anon", "patrolled", "!patrolled", "unread", "!unread".
-      # @return [self]
-      def wlshow(*values)
-        values.inject(self) { |res, val| res._wlshow(val) or fail ArgumentError, "Unknown value for wlshow: #{val}" }
-      end
-
-      # @private
-      def _wlshow(value)
-        defined?(super) && super || ["minor", "!minor", "bot", "!bot", "anon", "!anon", "patrolled", "!patrolled", "unread", "!unread"].include?(value.to_s) && merge(wlshow: value.to_s, replace: false)
-      end
-
-      # Which types of changes to show:
-      #
-      # @param values [Array<String>] Allowed values: "edit" (Regular page edits), "new" (Page creations), "log" (Log entries), "external" (External changes), "categorize" (Category membership changes).
-      # @return [self]
-      def wltype(*values)
-        values.inject(self) { |res, val| res._wltype(val) or fail ArgumentError, "Unknown value for wltype: #{val}" }
-      end
-
-      # @private
-      def _wltype(value)
-        defined?(super) && super || ["edit", "new", "log", "external", "categorize"].include?(value.to_s) && merge(wltype: value.to_s, replace: false)
-      end
-
-      # Don't list changes by this user.
-      #
-      # @param value [String]
-      # @return [self]
-      def wlexcludeuser(value)
-        merge(wlexcludeuser: value.to_s)
-      end
-    end
-  end
-end

data/lib/reality/describers/wikidata/actions/filerevert.rb

@@ -1,55 +0,0 @@
-# frozen_string_literal: true
-
-module Reality::Describers::Wikidata::Impl
-  module Actions
-    # Revert a file to an old version.
-    #
-    # Usage:
-    #
-    # ```ruby
-    # api.filerevert.filename(value).perform # returns string with raw output
-    # # or
-    # api.filerevert.filename(value).response # returns output parsed and wrapped into Response object
-    # ```
-    #
-    # See {Base} for generic explanation of working with MediaWiki actions and
-    # {Reality::Describers::Wikidata::Impl::Response} for working with action responses.
-    #
-    # All action's parameters are documented as its public methods, see below.
-    #
-    class Filerevert < Reality::Describers::Wikidata::Impl::Actions::Post
-
-      # Target filename, without the File: prefix.
-      #
-      # @param value [String]
-      # @return [self]
-      def filename(value)
-        merge(filename: value.to_s)
-      end
-
-      # Upload comment.
-      #
-      # @param value [String]
-      # @return [self]
-      def comment(value)
-        merge(comment: value.to_s)
-      end
-
-      # Archive name of the revision to revert to.
-      #
-      # @param value [String]
-      # @return [self]
-      def archivename(value)
-        merge(archivename: value.to_s)
-      end
-
-      # A "csrf" token retrieved from action=query&meta=tokens
-      #
-      # @param value [String]
-      # @return [self]
-      def token(value)
-        merge(token: value.to_s)
-      end
-    end
-  end
-end

data/lib/reality/describers/wikidata/actions/flow-parsoid-utils.rb

@@ -1,73 +0,0 @@
-# frozen_string_literal: true
-
-module Reality::Describers::Wikidata::Impl
-  module Actions
-    # Convert text between wikitext and HTML.
-    #
-    # Usage:
-    #
-    # ```ruby
-    # api.flow-parsoid-utils.from(value).perform # returns string with raw output
-    # # or
-    # api.flow-parsoid-utils.from(value).response # returns output parsed and wrapped into Response object
-    # ```
-    #
-    # See {Base} for generic explanation of working with MediaWiki actions and
-    # {Reality::Describers::Wikidata::Impl::Response} for working with action responses.
-    #
-    # All action's parameters are documented as its public methods, see below.
-    #
-    class FlowParsoidUtils < Reality::Describers::Wikidata::Impl::Actions::Get
-
-      # Format to convert content from.
-      #
-      # @param value [String] One of "html", "wikitext".
-      # @return [self]
-      def from(value)
-        _from(value) or fail ArgumentError, "Unknown value for from: #{value}"
-      end
-
-      # @private
-      def _from(value)
-        defined?(super) && super || ["html", "wikitext"].include?(value.to_s) && merge(from: value.to_s)
-      end
-
-      # Format to convert content to.
-      #
-      # @param value [String] One of "html", "wikitext".
-      # @return [self]
-      def to(value)
-        _to(value) or fail ArgumentError, "Unknown value for to: #{value}"
-      end
-
-      # @private
-      def _to(value)
-        defined?(super) && super || ["html", "wikitext"].include?(value.to_s) && merge(to: value.to_s)
-      end
-
-      # Content to be converted.
-      #
-      # @param value [String]
-      # @return [self]
-      def content(value)
-        merge(content: value.to_s)
-      end
-
-      # Title of the page. Cannot be used together with pageid.
-      #
-      # @param value [String]
-      # @return [self]
-      def title(value)
-        merge(title: value.to_s)
-      end
-
-      # ID of the page. Cannot be used together with title.
-      #
-      # @param value [Integer]
-      # @return [self]
-      def pageid(value)
-        merge(pageid: value.to_s)
-      end
-    end
-  end
-end

data/lib/reality/describers/wikidata/actions/flow.rb

@@ -1,72 +0,0 @@
-# frozen_string_literal: true
-
-module Reality::Describers::Wikidata::Impl
-  module Actions
-    # Allows actions to be taken on Flow pages.
-    #
-    # Usage:
-    #
-    # ```ruby
-    # api.flow.submodule(value).perform # returns string with raw output
-    # # or
-    # api.flow.submodule(value).response # returns output parsed and wrapped into Response object
-    # ```
-    #
-    # See {Base} for generic explanation of working with MediaWiki actions and
-    # {Reality::Describers::Wikidata::Impl::Response} for working with action responses.
-    #
-    # All action's parameters are documented as its public methods, see below.
-    #
-    class Flow < Reality::Describers::Wikidata::Impl::Actions::Get
-
-      # The Flow submodule to invoke.
-      #
-      # @param value [Symbol] Selecting an option includes tweaking methods from corresponding module:
-      #   * `:close-open-topic` - {Reality::Describers::Wikidata::Impl::Modules::CloseOpenTopic} Deprecated in favor of action=flow&submodule=lock-topic.
-      #   * `:edit-header` - {Reality::Describers::Wikidata::Impl::Modules::EditHeader} Edits a board description.
-      #   * `:edit-post` - {Reality::Describers::Wikidata::Impl::Modules::EditPost} Edits a post's content.
-      #   * `:edit-title` - {Reality::Describers::Wikidata::Impl::Modules::EditTitle} Edits a topic's title.
-      #   * `:edit-topic-summary` - {Reality::Describers::Wikidata::Impl::Modules::EditTopicSummary} Edits a topic summary's content.
-      #   * `:lock-topic` - {Reality::Describers::Wikidata::Impl::Modules::LockTopic} Lock or unlock a Flow topic.
-      #   * `:moderate-post` - {Reality::Describers::Wikidata::Impl::Modules::ModeratePost} Moderates a Flow post.
-      #   * `:moderate-topic` - {Reality::Describers::Wikidata::Impl::Modules::ModerateTopic} Moderates a Flow topic.
-      #   * `:new-topic` - {Reality::Describers::Wikidata::Impl::Modules::NewTopic} Creates a new Flow topic on the given workflow.
-      #   * `:reply` - {Reality::Describers::Wikidata::Impl::Modules::Reply} Replies to a post.
-      #   * `:undo-edit-header` - {Reality::Describers::Wikidata::Impl::Modules::UndoEditHeader} Retrieve information necessary to undo description edits.
-      #   * `:undo-edit-post` - {Reality::Describers::Wikidata::Impl::Modules::UndoEditPost} Retrieve information necesary to undo post edit.
-      #   * `:undo-edit-topic-summary` - {Reality::Describers::Wikidata::Impl::Modules::UndoEditTopicSummary} Retrieve information necessary to undo topic summary edits.
-      #   * `:view-header` - {Reality::Describers::Wikidata::Impl::Modules::ViewHeader} View a board description.
-      #   * `:view-post` - {Reality::Describers::Wikidata::Impl::Modules::ViewPost} View a post.
-      #   * `:view-post-history` - {Reality::Describers::Wikidata::Impl::Modules::ViewPostHistory} View the revision history of a post.
-      #   * `:view-topic` - {Reality::Describers::Wikidata::Impl::Modules::ViewTopic} View a topic.
-      #   * `:view-topic-history` - {Reality::Describers::Wikidata::Impl::Modules::ViewTopicHistory} View the revision history of a topic.
-      #   * `:view-topic-summary` - {Reality::Describers::Wikidata::Impl::Modules::ViewTopicSummary} View a topic summary.
-      #   * `:view-topiclist` - {Reality::Describers::Wikidata::Impl::Modules::ViewTopiclist} View a list of topics.
-      # @return [self]
-      def submodule(value)
-        _submodule(value) or fail ArgumentError, "Unknown value for submodule: #{value}"
-      end
-
-      # @private
-      def _submodule(value)
-        defined?(super) && super || [:"close-open-topic", :"edit-header", :"edit-post", :"edit-title", :"edit-topic-summary", :"lock-topic", :"moderate-post", :"moderate-topic", :"new-topic", :reply, :"undo-edit-header", :"undo-edit-post", :"undo-edit-topic-summary", :"view-header", :"view-post", :"view-post-history", :"view-topic", :"view-topic-history", :"view-topic-summary", :"view-topiclist"].include?(value.to_sym) && merge(submodule: value.to_s).submodule({close_open_topic: Modules::CloseOpenTopic, edit_header: Modules::EditHeader, edit_post: Modules::EditPost, edit_title: Modules::EditTitle, edit_topic_summary: Modules::EditTopicSummary, lock_topic: Modules::LockTopic, moderate_post: Modules::ModeratePost, moderate_topic: Modules::ModerateTopic, new_topic: Modules::NewTopic, reply: Modules::Reply, undo_edit_header: Modules::UndoEditHeader, undo_edit_post: Modules::UndoEditPost, undo_edit_topic_summary: Modules::UndoEditTopicSummary, view_header: Modules::ViewHeader, view_post: Modules::ViewPost, view_post_history: Modules::ViewPostHistory, view_topic: Modules::ViewTopic, view_topic_history: Modules::ViewTopicHistory, view_topic_summary: Modules::ViewTopicSummary, view_topiclist: Modules::ViewTopiclist}[value.to_sym])
-      end
-
-      # The page to take the action on.
-      #
-      # @param value [String]
-      # @return [self]
-      def page(value)
-        merge(page: value.to_s)
-      end
-
-      # A token retrieved from action=query&meta=tokens
-      #
-      # @param value [String]
-      # @return [self]
-      def token(value)
-        merge(token: value.to_s)
-      end
-    end
-  end
-end

data/lib/reality/describers/wikidata/actions/flowthank.rb

@@ -1,39 +0,0 @@
-# frozen_string_literal: true
-
-module Reality::Describers::Wikidata::Impl
-  module Actions
-    # Send a public thank-you notification for a Flow comment.
-    #
-    # Usage:
-    #
-    # ```ruby
-    # api.flowthank.postid(value).perform # returns string with raw output
-    # # or
-    # api.flowthank.postid(value).response # returns output parsed and wrapped into Response object
-    # ```
-    #
-    # See {Base} for generic explanation of working with MediaWiki actions and
-    # {Reality::Describers::Wikidata::Impl::Response} for working with action responses.
-    #
-    # All action's parameters are documented as its public methods, see below.
-    #
-    class Flowthank < Reality::Describers::Wikidata::Impl::Actions::Post
-
-      # The UUID of the post to thank for.
-      #
-      # @param value [String]
-      # @return [self]
-      def postid(value)
-        merge(postid: value.to_s)
-      end
-
-      # A "csrf" token retrieved from action=query&meta=tokens
-      #
-      # @param value [String]
-      # @return [self]
-      def token(value)
-        merge(token: value.to_s)
-      end
-    end
-  end
-end

data/lib/reality/describers/wikidata/actions/globalblock.rb

@@ -1,76 +0,0 @@
-# frozen_string_literal: true
-
-module Reality::Describers::Wikidata::Impl
-  module Actions
-    # Globally block or unblock a user.
-    #
-    # Usage:
-    #
-    # ```ruby
-    # api.globalblock.target(value).perform # returns string with raw output
-    # # or
-    # api.globalblock.target(value).response # returns output parsed and wrapped into Response object
-    # ```
-    #
-    # See {Base} for generic explanation of working with MediaWiki actions and
-    # {Reality::Describers::Wikidata::Impl::Response} for working with action responses.
-    #
-    # All action's parameters are documented as its public methods, see below.
-    #
-    class Globalblock < Reality::Describers::Wikidata::Impl::Actions::Post
-
-      # The target IP address.
-      #
-      # @param value [String]
-      # @return [self]
-      def target(value)
-        merge(target: value.to_s)
-      end
-
-      # If specified, will block or reblock the user. Determines how long the block will last for, e.g. "5 months" or "2 weeks". If set to "infinite" or "indefinite" the block will never expire.
-      #
-      # @param value [String]
-      # @return [self]
-      def expiry(value)
-        merge(expiry: value.to_s)
-      end
-
-      # If specified, will unblock the user.
-      #
-      # @return [self]
-      def unblock()
-        merge(unblock: 'true')
-      end
-
-      # The reason for blocking/unblocking.
-      #
-      # @param value [String]
-      # @return [self]
-      def reason(value)
-        merge(reason: value.to_s)
-      end
-
-      # Specify this if the block should only affect logged-out users.
-      #
-      # @return [self]
-      def anononly()
-        merge(anononly: 'true')
-      end
-
-      # Specify this if the existing block on the target should be modified
-      #
-      # @return [self]
-      def modify()
-        merge(modify: 'true')
-      end
-
-      # A "csrf" token retrieved from action=query&meta=tokens
-      #
-      # @param value [String]
-      # @return [self]
-      def token(value)
-        merge(token: value.to_s)
-      end
-    end
-  end
-end

data/lib/reality/describers/wikidata/actions/globaluserrights.rb

@@ -1,94 +0,0 @@
-# frozen_string_literal: true
-
-module Reality::Describers::Wikidata::Impl
-  module Actions
-    # Add/remove a user to/from global groups.
-    #
-    # Usage:
-    #
-    # ```ruby
-    # api.globaluserrights.user(value).perform # returns string with raw output
-    # # or
-    # api.globaluserrights.user(value).response # returns output parsed and wrapped into Response object
-    # ```
-    #
-    # See {Base} for generic explanation of working with MediaWiki actions and
-    # {Reality::Describers::Wikidata::Impl::Response} for working with action responses.
-    #
-    # All action's parameters are documented as its public methods, see below.
-    #
-    class Globaluserrights < Reality::Describers::Wikidata::Impl::Actions::Post
-
-      # Global user name.
-      #
-      # @param value [String]
-      # @return [self]
-      def user(value)
-        merge(user: value.to_s)
-      end
-
-      # Global user ID.
-      #
-      # @param value [Integer]
-      # @return [self]
-      def userid(value)
-        merge(userid: value.to_s)
-      end
-
-      # Add the user to these global groups.
-      #
-      # @param values [Array<String>] Allowed values: "OTRS-member", "abusefilter-helper", "apihighlimits-requestor", "captcha-exempt", "delete-global", "founder", "global-bot", "global-flow-create", "global-interface-editor", "global-ipblock-exempt", "global-rollbacker", "global-sysop", "new-wikis-importer", "oathauth-tester", "ombudsman", "recursive-export", "staff", "steward", "sysadmin", "wmf-ops-monitoring", "wmf-researcher".
-      # @return [self]
-      def add(*values)
-        values.inject(self) { |res, val| res._add(val) or fail ArgumentError, "Unknown value for add: #{val}" }
-      end
-
-      # @private
-      def _add(value)
-        defined?(super) && super || ["OTRS-member", "abusefilter-helper", "apihighlimits-requestor", "captcha-exempt", "delete-global", "founder", "global-bot", "global-flow-create", "global-interface-editor", "global-ipblock-exempt", "global-rollbacker", "global-sysop", "new-wikis-importer", "oathauth-tester", "ombudsman", "recursive-export", "staff", "steward", "sysadmin", "wmf-ops-monitoring", "wmf-researcher"].include?(value.to_s) && merge(add: value.to_s, replace: false)
-      end
-
-      # Remove the user from these global groups.
-      #
-      # @param values [Array<String>] Allowed values: "OTRS-member", "abusefilter-helper", "apihighlimits-requestor", "captcha-exempt", "delete-global", "founder", "global-bot", "global-flow-create", "global-interface-editor", "global-ipblock-exempt", "global-rollbacker", "global-sysop", "new-wikis-importer", "oathauth-tester", "ombudsman", "recursive-export", "staff", "steward", "sysadmin", "wmf-ops-monitoring", "wmf-researcher".
-      # @return [self]
-      def remove(*values)
-        values.inject(self) { |res, val| res._remove(val) or fail ArgumentError, "Unknown value for remove: #{val}" }
-      end
-
-      # @private
-      def _remove(value)
-        defined?(super) && super || ["OTRS-member", "abusefilter-helper", "apihighlimits-requestor", "captcha-exempt", "delete-global", "founder", "global-bot", "global-flow-create", "global-interface-editor", "global-ipblock-exempt", "global-rollbacker", "global-sysop", "new-wikis-importer", "oathauth-tester", "ombudsman", "recursive-export", "staff", "steward", "sysadmin", "wmf-ops-monitoring", "wmf-researcher"].include?(value.to_s) && merge(remove: value.to_s, replace: false)
-      end
-
-      # Reason for the change.
-      #
-      # @param value [String]
-      # @return [self]
-      def reason(value)
-        merge(reason: value.to_s)
-      end
-
-      # A "userrights" token retrieved from action=query&meta=tokens
-      #
-      # @param value [String]
-      # @return [self]
-      def token(value)
-        merge(token: value.to_s)
-      end
-
-      # This parameter is currently unused.
-      #
-      # @param values [Array<String>] Allowed values: "InfoboxExport gadget", "WE-Framework gadget".
-      # @return [self]
-      def tags(*values)
-        values.inject(self) { |res, val| res._tags(val) or fail ArgumentError, "Unknown value for tags: #{val}" }
-      end
-
-      # @private
-      def _tags(value)
-        defined?(super) && super || ["InfoboxExport gadget", "WE-Framework gadget"].include?(value.to_s) && merge(tags: value.to_s, replace: false)
-      end
-    end
-  end
-end