tdiary 5.0.14 → 5.1.0

data/vendor/bundle/gems/octokit-4.14.0/lib/octokit/client/authorizations.rb

@@ -0,0 +1,250 @@
+module Octokit
+  class Client
+
+    # Methods for the Authorizations API
+    #
+    # @see https://developer.github.com/v3/oauth_authorizations/#oauth-authorizations-api
+    module Authorizations
+
+      # List the authenticated user's authorizations
+      #
+      # API for users to manage their own tokens.
+      # You can only access your own tokens, and only through
+      # Basic Authentication.
+      #
+      # @return [Array<Sawyer::Resource>] A list of authorizations for the authenticated user
+      # @see https://developer.github.com/v3/oauth_authorizations/#list-your-authorizations
+      # @example List authorizations for user ctshryock
+      #  client = Octokit::Client.new(:login => 'ctshryock', :password => 'secret')
+      #  client.authorizations
+      def authorizations(options = {})
+        paginate 'authorizations', options
+      end
+
+      # Get a single authorization for the authenticated user.
+      #
+      # You can only access your own tokens, and only through
+      # Basic Authentication.
+      #
+      # @return [Sawyer::Resource] A single authorization for the authenticated user
+      # @see https://developer.github.com/v3/oauth_authorizations/#get-a-single-authorization
+      # @example Show authorization for user ctshryock's Travis auth
+      #  client = Octokit::Client.new(:login => 'ctshryock', :password => 'secret')
+      #  client.authorization(999999)
+      def authorization(number, options = {})
+        get "authorizations/#{number}", options
+      end
+
+      # Create an authorization for the authenticated user.
+      #
+      # You can create your own tokens, and only through
+      # Basic Authentication.
+      #
+      # @param options [Hash] A customizable set of options.
+      # @option options [Array] :scopes A list of scopes that this authorization is in.
+      # @option options [String] :note A note to remind you what the OAuth token is for.
+      # @option options [String] :note_url A URL to remind you what app the OAuth token is for.
+      # @option options [Boolean] :idempotent If true, will return an existing authorization if one has already been created.
+      # @option options [String] :client_id  Client Id we received when our application was registered with GitHub.
+      # @option options [String] :client_secret  Client Secret we received when our application was registered with GitHub.
+      #
+      # @return [Sawyer::Resource] A single authorization for the authenticated user
+      # @see https://developer.github.com/v3/oauth/#scopes Available scopes
+      # @see https://developer.github.com/v3/oauth_authorizations/#create-a-new-authorization
+      # @see https://developer.github.com/v3/oauth_authorizations/#get-or-create-an-authorization-for-a-specific-app
+      # @example Create a new authorization for user ctshryock's project Zoidberg
+      #  client = Octokit::Client.new(:login => 'ctshryock', :password => 'secret')
+      #  client.create_authorization({:scopes => ["public_repo", "gist"], :note => "Why not Zoidberg?", :note_url=> "https://en.wikipedia.org/wiki/Zoidberg"})
+      # @example Create a new OR return an existing authorization to be used by a specific client for user ctshryock's project Zoidberg
+      #  client = Octokit::Client.new(:login => 'ctshryock', :password => 'secret')
+      #  client.create_authorization({:idempotent => true, :client_id => 'xxxx', :client_secret => 'yyyy', :scopes => ["user"]})
+      def create_authorization(options = {})
+        # Techincally we can omit scopes as GitHub has a default, however the
+        # API will reject us if we send a POST request with an empty body.
+        options = options.dup
+        if options.delete :idempotent
+          client_id, client_secret = fetch_client_id_and_secret(options)
+          raise ArgumentError.new("Client ID and Secret required for idempotent authorizations") unless client_id && client_secret
+
+          # Remove the client_id from the body otherwise
+          # this will result in a 422.
+          options.delete(:client_id)
+
+          if (fingerprint = options.delete(:fingerprint))
+            put "authorizations/clients/#{client_id}/#{fingerprint}", options.merge(:client_secret => client_secret)
+          else
+            put "authorizations/clients/#{client_id}", options.merge(:client_secret => client_secret)
+          end
+
+        else
+          post 'authorizations', options
+        end
+      end
+
+      # Update an authorization for the authenticated user.
+      #
+      # You can update your own tokens, but only through
+      # Basic Authentication.
+      #
+      # @param options [Hash] A customizable set of options.
+      # @option options [Array] :scopes Replace the authorization scopes with these.
+      # @option options [Array] :add_scopes A list of scopes to add to this authorization.
+      # @option options [Array] :remove_scopes A list of scopes to remove from this authorization.
+      # @option options [String] :note A note to remind you what the OAuth token is for.
+      # @option options [String] :note_url A URL to remind you what app the OAuth token is for.
+      #
+      # @return [Sawyer::Resource] A single (updated) authorization for the authenticated user
+      # @see https://developer.github.com/v3/oauth_authorizations/#update-an-existing-authorization
+      # @see https://developer.github.com/v3/oauth/#scopes for available scopes
+      # @example Update the authorization for user ctshryock's project Zoidberg
+      #  client = Octokit::Client.new(:login => 'ctshryock', :password => 'secret')
+      #  client.update_authorization(999999, {:add_scopes => ["gist", "repo"], :note => "Why not Zoidberg possibly?"})
+      def update_authorization(number, options = {})
+        patch "authorizations/#{number}", options
+      end
+
+      # Delete an authorization for the authenticated user.
+      #
+      # You can delete your own tokens, and only through
+      # Basic Authentication.
+      #
+      # @param number [Number] An existing Authorization ID
+      #
+      # @return [Boolean] Success
+      # @see https://developer.github.com/v3/oauth_authorizations/#delete-an-authorization
+      # @example Delete an authorization
+      #  client = Octokit::Client.new(:login => 'ctshryock', :password => 'secret')
+      #  client.delete_authorization(999999)
+      def delete_authorization(number, options = {})
+        boolean_from_response :delete, "authorizations/#{number}", options
+      end
+
+      # Check scopes for a token
+      #
+      # @param token [String] GitHub OAuth token
+      # @param options [Hash] Header params for request
+      # @return [Array<String>] OAuth scopes
+      # @see https://developer.github.com/v3/oauth/#scopes
+      def scopes(token = @access_token, options = {})
+        options= options.dup
+        raise ArgumentError.new("Access token required") if token.nil?
+
+        auth = { "Authorization" => "token #{token}" }
+        headers = (options.delete(:headers) || {}).merge(auth)
+
+        agent.call(:get, "user", :headers => headers).
+          headers['X-OAuth-Scopes'].
+          to_s.
+          split(',').
+          map(&:strip).
+          sort
+      end
+
+      # Check if a token is valid.
+      #
+      # Applications can check if a token is valid without rate limits.
+      #
+      # @param token [String] 40 character GitHub OAuth access token
+      #
+      # @return [Sawyer::Resource] A single authorization for the authenticated user
+      # @see https://developer.github.com/v3/oauth_authorizations/#check-an-authorization
+      # @example
+      #  client = Octokit::Client.new(:client_id => 'abcdefg12345', :client_secret => 'secret')
+      #  client.check_application_authorization('deadbeef1234567890deadbeef987654321')
+      def check_application_authorization(token, options = {})
+        opts = options.dup
+        key    = opts.delete(:client_id)     || client_id
+        secret = opts.delete(:client_secret) || client_secret
+
+        as_app(key, secret) do |app_client|
+          app_client.get "applications/#{client_id}/tokens/#{token}", opts
+        end
+      end
+
+      # Reset a token
+      #
+      # Applications can reset a token without requiring a user to re-authorize.
+      #
+      # @param token [String] 40 character GitHub OAuth access token
+      #
+      # @return [Sawyer::Resource] A single authorization for the authenticated user
+      # @see https://developer.github.com/v3/oauth_authorizations/#reset-an-authorization
+      # @example
+      #  client = Octokit::Client.new(:client_id => 'abcdefg12345', :client_secret => 'secret')
+      #  client.reset_application_authorization('deadbeef1234567890deadbeef987654321')
+      def reset_application_authorization(token, options = {})
+        opts = options.dup
+        key    = opts.delete(:client_id)     || client_id
+        secret = opts.delete(:client_secret) || client_secret
+
+        as_app(key, secret) do |app_client|
+          app_client.post "applications/#{client_id}/tokens/#{token}", opts
+        end
+      end
+
+      # Revoke a token
+      #
+      # Applications can revoke (delete) a token
+      #
+      # @param token [String] 40 character GitHub OAuth access token
+      #
+      # @return [Boolean] Result
+      # @see https://developer.github.com/v3/oauth_authorizations/#revoke-an-authorization-for-an-application
+      # @example
+      #  client = Octokit::Client.new(:client_id => 'abcdefg12345', :client_secret => 'secret')
+      #  client.revoke_application_authorization('deadbeef1234567890deadbeef987654321')
+      def revoke_application_authorization(token, options = {})
+        opts = options.dup
+        key    = opts.delete(:client_id)     || client_id
+        secret = opts.delete(:client_secret) || client_secret
+
+        as_app(key, secret) do |app_client|
+          app_client.delete "applications/#{client_id}/tokens/#{token}", opts
+
+          app_client.last_response.status == 204
+        end
+      rescue Octokit::NotFound
+        false
+      end
+      alias :delete_application_authorization :revoke_application_authorization
+
+      # Revoke all tokens for an app
+      #
+      # Applications can revoke all of their tokens in a single request
+      #
+      # @deprecated As of January 25th, 2016: https://developer.github.com/changes/2014-04-08-reset-api-tokens/
+      # @return [Boolean] false
+      def revoke_all_application_authorizations(options = {})
+        octokit_warn("Deprecated: If you need to revoke all tokens for your application, you can do so via the settings page for your application.")
+        false
+      end
+
+      # Get the URL to authorize a user for an application via the web flow
+      #
+      # @param app_id [String] Client Id we received when our application was registered with GitHub.
+      # @option options [String] :redirect_uri The url to redirect to after authorizing.
+      # @option options [String] :scope The scopes to request from the user.
+      # @option options [String] :state A random string to protect against CSRF.
+      # @return [String] The url to redirect the user to authorize.
+      # @see Octokit::Client
+      # @see https://developer.github.com/v3/oauth/#web-application-flow
+      # @example
+      #   @client.authorize_url('xxxx')
+      def authorize_url(app_id = client_id, options = {})
+        opts = options.dup
+        if app_id.to_s.empty?
+          raise Octokit::ApplicationCredentialsRequired.new "client_id required"
+        end
+        authorize_url = opts.delete(:endpoint) || Octokit.web_endpoint
+        authorize_url << "login/oauth/authorize?client_id=#{app_id}"
+
+        require 'cgi'
+        opts.each do |key, value|
+          authorize_url << "&#{key}=#{CGI.escape value}"
+        end
+
+        authorize_url
+      end
+    end
+  end
+end

data/vendor/bundle/gems/octokit-4.14.0/lib/octokit/client/checks.rb

@@ -0,0 +1,211 @@
+module Octokit
+  class Client
+
+    # Methods for the Checks API
+    #
+    # @see https://developer.github.com/v3/checks/
+    module Checks
+
+      # Methods for Check Runs
+      #
+      # @see https://developer.github.com/v3/checks/runs/
+
+      # Create a check run
+      #
+      # @param repo [Integer, String, Hash, Repository] A GitHub repository
+      # @param name [String] The name of the check
+      # @param head_sha [String] The SHA of the commit to check
+      # @return [Sawyer::Resource] A hash representing the new check run
+      # @see https://developer.github.com/v3/checks/runs/#create-a-check-run
+      # @example Create a check run
+      #   check_run = @client.create_check_run("octocat/Hello-World", "my-check", "7638417db6d59f3c431d3e1f261cc637155684cd")
+      #   check_run.name # => "my-check"
+      #   check_run.head_sha # => "7638417db6d59f3c431d3e1f261cc637155684cd"
+      #   check_run.status # => "queued"
+      def create_check_run(repo, name, head_sha, options = {})
+        ensure_api_media_type(:checks, options)
+        options[:name] = name
+        options[:head_sha] = head_sha
+
+        post "#{Repository.path repo}/check-runs", options
+      end
+
+      # Update a check run
+      #
+      # @param repo [Integer, String, Hash, Repository] A GitHub repository
+      # @param id [Integer] The ID of the check run
+      # @return [Sawyer::Resource] A hash representing the updated check run
+      # @see https://developer.github.com/v3/checks/runs/#update-a-check-run
+      # @example Update a check run
+      #   check_run = @client.update_check_run("octocat/Hello-World", 51295429, status: "in_progress")
+      #   check_run.id # => 51295429
+      #   check_run.status # => "in_progress"
+      def update_check_run(repo, id, options = {})
+        ensure_api_media_type(:checks, options)
+
+        patch "#{Repository.path repo}/check-runs/#{id}", options
+      end
+
+      # List check runs for a specific ref
+      #
+      # @param repo [Integer, String, Hash, Repository] A GitHub repository
+      # @param ref [String] A SHA, branch name, or tag name
+      # @param options [Hash] A set of optional filters
+      # @option options [String] :check_name Returns check runs with the specified <tt>name</tt>
+      # @option options [String] :status Returns check runs with the specified <tt>status</tt>
+      # @option options [String] :filter Filters check runs by their <tt>completed_at</tt> timestamp
+      # @return [Sawyer::Resource] A hash representing a collection of check runs
+      # @see https://developer.github.com/v3/checks/runs/#list-check-runs-for-a-specific-ref
+      # @example List check runs for a specific ref
+      #   result = @client.check_runs_for_ref("octocat/Hello-World", "7638417db6d59f3c431d3e1f261cc637155684cd", status: "in_progress")
+      #   result.total_count # => 1
+      #   result.check_runs.count # => 1
+      #   result.check_runs[0].id # => 51295429
+      #   result.check_runs[0].status # => "in_progress"
+      def check_runs_for_ref(repo, ref, options = {})
+        ensure_api_media_type(:checks, options)
+
+        get "#{Repository.path repo}/commits/#{ref}/check-runs", options
+      end
+      alias :list_check_runs_for_ref :check_runs_for_ref
+
+      # List check runs in a check suite
+      #
+      # @param repo [Integer, String, Hash, Repository] A GitHub repository
+      # @param id [Integer] The ID of the check suite
+      # @param options [Hash] A set of optional filters
+      # @option options [String] :check_name Returns check runs with the specified <tt>name</tt>
+      # @option options [String] :status Returns check runs with the specified <tt>status</tt>
+      # @option options [String] :filter Filters check runs by their <tt>completed_at</tt> timestamp
+      # @return [Sawyer::Resource] A hash representing a collection of check runs
+      # @see https://developer.github.com/v3/checks/runs/#list-check-runs-in-a-check-suite
+      # @example List check runs in a check suite
+      #   result = @client.check_runs_for_check_suite("octocat/Hello-World", 50440400, status: "in_progress")
+      #   result.total_count # => 1
+      #   result.check_runs.count # => 1
+      #   result.check_runs[0].check_suite.id # => 50440400
+      #   result.check_runs[0].status # => "in_progress"
+      def check_runs_for_check_suite(repo, id, options = {})
+        ensure_api_media_type(:checks, options)
+
+        get "#{Repository.path repo}/check-suites/#{id}/check-runs", options
+      end
+      alias :list_check_runs_for_check_suite :check_runs_for_check_suite
+
+      # Get a single check run
+      #
+      # @param repo [Integer, String, Hash, Repository] A GitHub repository
+      # @param id [Integer] The ID of the check run
+      # @return [Sawyer::Resource] A hash representing the check run
+      # @see https://developer.github.com/v3/checks/runs/#get-a-single-check-run
+      def check_run(repo, id, options = {})
+        ensure_api_media_type(:checks, options)
+
+        get "#{Repository.path repo}/check-runs/#{id}", options
+      end
+
+      # List annotations for a check run
+      #
+      # @param repo [Integer, String, Hash, Repository] A GitHub repository
+      # @param id [Integer] The ID of the check run
+      # @return [Array<Sawyer::Resource>] An array of hashes representing check run annotations
+      # @see https://developer.github.com/v3/checks/runs/#list-annotations-for-a-check-run
+      # @example List annotations for a check run
+      #   annotations = @client.check_run_annotations("octocat/Hello-World", 51295429)
+      #   annotations.count # => 1
+      #   annotations[0].path # => "README.md"
+      #   annotations[0].message # => "Looks good!"
+      def check_run_annotations(repo, id, options = {})
+        ensure_api_media_type(:checks, options)
+
+        get "#{Repository.path repo}/check-runs/#{id}/annotations", options
+      end
+
+      # Methods for Check Suites
+      #
+      # @see https://developer.github.com/v3/checks/suites/
+
+      # Get a single check suite
+      #
+      # @param repo [Integer, String, Hash, Repository] A GitHub repository
+      # @param id [Integer] The ID of the check suite
+      # @return [Sawyer::Resource] A hash representing the check suite
+      # @see https://developer.github.com/v3/checks/suites/#get-a-single-check-suite
+      def check_suite(repo, id, options = {})
+        ensure_api_media_type(:checks, options)
+
+        get "#{Repository.path repo}/check-suites/#{id}", options
+      end
+
+      # List check suites for a specific ref
+      #
+      # @param repo [Integer, String, Hash, Repository] A GitHub repository
+      # @param ref [String] A SHA, branch name, or tag name
+      # @param options [Hash] A set of optional filters
+      # @option options [Integer] :app_id Filters check suites by GitHub App <tt>id</tt>
+      # @option options [String] :check_name Filters checks suites by the <tt>name</tt> of the check run
+      # @return [Sawyer::Resource] A hash representing a collection of check suites
+      # @see https://developer.github.com/v3/checks/suites/#list-check-suites-for-a-specific-ref
+      # @example List check suites for a specific ref
+      #   result = @client.check_suites_for_ref("octocat/Hello-World", "7638417db6d59f3c431d3e1f261cc637155684cd", app_id: 76765)
+      #   result.total_count # => 1
+      #   result.check_suites.count # => 1
+      #   result.check_suites[0].id # => 50440400
+      #   result.check_suites[0].app.id # => 76765
+      def check_suites_for_ref(repo, ref, options = {})
+        ensure_api_media_type(:checks, options)
+
+        get "#{Repository.path repo}/commits/#{ref}/check-suites", options
+      end
+      alias :list_check_suites_for_ref :check_suites_for_ref
+
+      # Set preferences for check suites on a repository
+      #
+      # @param repo [Integer, String, Hash, Repository] A GitHub repository
+      # @param options [Hash] Preferences to set
+      # @return [Sawyer::Resource] A hash representing the repository's check suite preferences
+      # @see https://developer.github.com/v3/checks/suites/#set-preferences-for-check-suites-on-a-repository
+      # @example Set preferences for check suites on a repository
+      #   result = @client.set_check_suite_preferences("octocat/Hello-World", auto_trigger_checks: [{ app_id: 76765, setting: false }])
+      #   result.preferences.auto_trigger_checks.count # => 1
+      #   result.preferences.auto_trigger_checks[0].app_id # => 76765
+      #   result.preferences.auto_trigger_checks[0].setting # => false
+      #   result.repository.full_name # => "octocat/Hello-World"
+      def set_check_suite_preferences(repo, options = {})
+        ensure_api_media_type(:checks, options)
+
+        patch "#{Repository.path repo}/check-suites/preferences", options
+      end
+
+      # Create a check suite
+      #
+      # @param repo [Integer, String, Hash, Repository] A GitHub repository
+      # @param head_sha [String] The SHA of the commit to check
+      # @return [Sawyer::Resource] A hash representing the new check suite
+      # @see https://developer.github.com/v3/checks/suites/#create-a-check-suite
+      # @example Create a check suite
+      #   check_suite = @client.create_check_suite("octocat/Hello-World", "7638417db6d59f3c431d3e1f261cc637155684cd")
+      #   check_suite.head_sha # => "7638417db6d59f3c431d3e1f261cc637155684cd"
+      #   check_suite.status # => "queued"
+      def create_check_suite(repo, head_sha, options = {})
+        ensure_api_media_type(:checks, options)
+        options[:head_sha] = head_sha
+
+        post "#{Repository.path repo}/check-suites", options
+      end
+
+      # Rerequest check suite
+      #
+      # @param repo [Integer, String, Hash, Repository] A GitHub repository
+      # @param id [Integer] The ID of the check suite
+      # @return [Boolean] True if successful, raises an error otherwise
+      # @see https://developer.github.com/v3/checks/suites/#rerequest-check-suite
+      def rerequest_check_suite(repo, id, options = {})
+        ensure_api_media_type(:checks, options)
+
+        post "#{Repository.path repo}/check-suites/#{id}/rerequest", options
+        true
+      end
+    end
+  end
+end