moostodon 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 36477f3200abc7c0778ee098a84ec63f934918cc
+  data.tar.gz: 93f1c01eaf91c6fe442c6453facbcdf995bc5b81
+SHA512:
+  metadata.gz: d06ad7a87c7cfddb9d00ca7062ddcf74e377d29b10dc345be6a49ebf52559bac098e8da587b8e931839b0ac557e2b1c865bb38b16a4c1b5d95ed0c0f56ce046b
+  data.tar.gz: 4dc8a68a77d43f11739788db6bf8c47c0908f7b3f10a658ee3bb5fcfd8af1884e2537c297c5b56b4423cb88a54aec8488233419e4f2c49a523d51828ba864042

data/lib/mastodon.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'addressable/uri'
+require 'mastodon/base'
+require 'mastodon/collection'
+require 'mastodon/results'
+require 'mastodon/rest/client'
+require 'mastodon/streaming/client'

data/lib/mastodon/account.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Mastodon
+  class Account < Mastodon::Base
+    # @!attribute [r] id
+    #   @return [String]
+    # @!attribute [r] username
+    #   @return [String]
+    # @!attribute [r] acct
+    #   @return [String]
+    # @!attribute [r] display_name
+    #   @return [String]
+    # @!attribute [r] url
+    #   @return [String]
+    # @!attribute [r] avatar
+    #   @return [String]
+    # @!attribute [r] avatar_static
+    #   @return [String]
+    # @!attribute [r] header
+    #   @return [String]
+    # @!attribute [r] header_static
+    #   @return [String]
+    # @!attribute [r] note
+    #   @return [String]
+    # @!attribute [r] followers_count
+    #   @return [Integer]
+    # @!attribute [r] following_count
+    #   @return [Integer]
+    # @!attribute [r] statuses_count
+    #   @return [Integer]
+    # @!attribute [r] created_at
+    #   @return [String]
+    # @!attribute [r] locked?
+    #   @return [Boolean]
+    # @!attribute [r] moved
+    #   @return [Mastodon::Account]
+
+    normal_attr_reader :id,
+                       :username,
+                       :acct,
+                       :display_name,
+                       :created_at,
+                       :url,
+                       :avatar,
+                       :avatar_static,
+                       :header,
+                       :header_static,
+                       :note,
+                       :followers_count,
+                       :following_count,
+                       :statuses_count
+
+    predicate_attr_reader :locked
+
+    object_attr_reader :moved, Mastodon::Account
+
+    def initialize(attributes = {})
+      attributes.fetch('id')
+      super
+    end
+  end
+end

data/lib/mastodon/app.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Mastodon
+  class App < Mastodon::Base
+    # @!attribute [r] client_id
+    #   @return [String]
+    # @!attribute [r] client_secret
+    #   @return [String]
+    # @!attribute [r] name
+    #   @return [String]
+    # @!attribute [r] website
+    #   @return [String]
+
+    normal_attr_reader :client_id,
+                       :client_secret,
+                       :name,
+                       :website
+  end
+end

data/lib/mastodon/base.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Mastodon
+  class Base
+    attr_reader :attributes
+
+    alias to_h    attributes
+    alias to_hash attributes
+
+    def initialize(attributes = {})
+      @attributes = attributes
+    end
+
+    class << self
+      def normal_attr_reader(*attributes)
+        attributes.each do |attribute|
+          define_attribute_method(attribute)
+        end
+      end
+
+      def object_attr_reader(attribute, klass)
+        define_method(attribute) do
+          klass.new(@attributes[attribute.to_s])
+        end
+      end
+
+      def collection_attr_reader(attribute, klass)
+        define_method(attribute) do
+          Mastodon::Collection.new(@attributes[attribute.to_s], klass)
+        end
+      end
+
+      def predicate_attr_reader(*attributes)
+        attributes.each do |attribute|
+          define_predicate_method(attribute)
+        end
+      end
+
+      def define_predicate_method(key)
+        define_method("#{key}?") do
+          @attributes[key.to_s]
+        end
+      end
+
+      def define_attribute_method(key)
+        define_method(key) do
+          @attributes[key.to_s]
+        end
+      end
+    end
+  end
+end

data/lib/mastodon/card.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Mastodon
+  class Card < Mastodon::Base
+    # @!attribute [r] url
+    #   @return [String]
+    # @!attribute [r] title
+    #   @return [String]
+    # @!attribute [r] description
+    #   @return [String]
+    # @!attribute [r] image
+    #   @return [String]
+    # @!attribute [r] type
+    #   @return [String]
+    # @!attribute [r] author_name
+    #   @return [String]
+    # @!attribute [r] author_url
+    #   @return [String]
+    # @!attribute [r] provider_name
+    #   @return [String]
+    # @!attribute [r] provider_url
+    #   @return [String]
+    # @!attribute [r] html
+    #   @return [String]
+    # @!attribute [r] width
+    #   @return [String]
+    # @!attribute [r] height
+    #   @return [String]
+
+    normal_attr_reader :url,
+                       :title,
+                       :description,
+                       :image,
+                       :type,
+                       :author_name,
+                       :author_url,
+                       :provider_name,
+                       :provider_url,
+                       :html,
+                       :width,
+                       :height
+  end
+end

data/lib/mastodon/client.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'mastodon/version'
+
+module Mastodon
+  class Client
+    DEFAULT_TIMEOUT = {
+      connect: 2,
+      read: 5,
+      write: 20
+    }.freeze
+
+    attr_reader :base_url, :bearer_token, :timeout
+
+    # @param options [Hash]
+    # @option options :base_url [String] URL of the instance you want to
+    #   connect to
+    # @option options :bearer_token [String] OAuth access token for your
+    #   authenticated user
+    def initialize(options = {})
+      @base_url     = options[:base_url]
+      @bearer_token = options[:bearer_token]
+      @timeout      = DEFAULT_TIMEOUT.merge(options[:timeout] || {})
+    end
+
+    # User agent of the client
+    # @return [String]
+    def user_agent
+      @user_agent ||= "MastodonRubyGem/#{Mastodon::Version}"
+    end
+  end
+end

data/lib/mastodon/collection.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Mastodon
+  # Mastodon collections. Used in place of arrays.
+  class Collection
+    include ::Enumerable
+
+    def initialize(items, klass)
+      @collection = items.map { |attributes| klass.new(attributes) }
+    end
+
+    def each(start = 0)
+      return to_enum(:each, start) unless block_given?
+
+      Array(@collection[start..-1]).each do |element|
+        yield(element)
+      end
+
+      self
+    end
+
+    def size
+      @collection.size
+    end
+
+    def last
+      @collection.last
+    end
+  end
+end

data/lib/mastodon/emoji.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Mastodon
+  class Emoji < Mastodon::Base
+    # @!attribute [r] shortcode
+    #   @return [String]
+    # @!attribute [r] static_url
+    #   @return [String]
+    # @!attribute [r] url
+    #   @return [String]
+
+    normal_attr_reader :shortcode, :static_url, :url
+  end
+end

data/lib/mastodon/entities/app.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Mastodon
+  module Entities
+    # The application a toot was sent by.
+    class App < Mastodon::Base
+      # @!attribute [r] name
+      #   @return [String]
+      # @!attribute [r] website
+      #   @return [String]
+
+      normal_attr_reader :name, :website
+    end
+  end
+end

data/lib/mastodon/entities/hashtag.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Mastodon
+  module Entities
+    # Hashtags are the only searchable item inside toots.
+    class Hashtag < Mastodon::Base
+      # @!attribute [r] name
+      #   @return [String]
+      # @!attribute [r] url
+      #   @return [String]
+
+      normal_attr_reader :name, :url
+    end
+  end
+end

data/lib/mastodon/entities/media.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Mastodon
+  module Entities
+    # Media parts of a toot, like pictures or videos.
+    class Media < Mastodon::Base
+      # @!attribute [r] id
+      #   @return [Integer]
+      # @!attribute [r] url
+      #   @return [String]
+      # @!attribute [r] remote_url
+      #   @return [String]
+      # @!attribute [r] preview_url
+      #   @return [String]
+      # @!attribute [r] type
+      #   @return [String]
+      # @!attribute [r] meta
+      #   @return [Hash]
+      # @!attribute [r] description
+      #   @return [String]
+
+      normal_attr_reader :id,
+                         :url,
+                         :remote_url,
+                         :preview_url,
+                         :type,
+                         :meta,
+                         :description
+    end
+  end
+end

data/lib/mastodon/entities/mention.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Mastodon
+  module Entities
+    # When talking about another user.
+    class Mention < Mastodon::Base
+      # @!attribute [r] id
+      #   @return [String] Account ID
+      # @!attribute [r] acct
+      #   @return [String]
+      # @!attribute [r] url
+      #   @return [String]
+
+      normal_attr_reader :id, :acct, :url
+    end
+  end
+end

data/lib/mastodon/error.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Mastodon
+  # General error class for Mastodon.
+  class Error < StandardError
+    ClientError         = Class.new(self)
+    BadRequest          = Class.new(ClientError)
+    Unauthorized        = Class.new(ClientError)
+    Forbidden           = Class.new(ClientError)
+    UnprocessableEntity = Class.new(ClientError)
+    TooManyRequests     = Class.new(ClientError)
+
+    ServerError         = Class.new(self)
+    InternalServerError = Class.new(ServerError)
+    BadGateway          = Class.new(ServerError)
+    ServiceUnavailable  = Class.new(ServerError)
+    GatewayTimeout      = Class.new(ServerError)
+
+    ERRORS = {
+      400 => Mastodon::Error::BadRequest,
+      401 => Mastodon::Error::Unauthorized,
+      403 => Mastodon::Error::Forbidden,
+      422 => Mastodon::Error::UnprocessableEntity,
+      429 => Mastodon::Error::TooManyRequests,
+      500 => Mastodon::Error::InternalServerError,
+      502 => Mastodon::Error::BadGateway,
+      503 => Mastodon::Error::ServiceUnavailable,
+      504 => Mastodon::Error::GatewayTimeout
+    }.freeze
+
+    class << self
+      def from_response(body)
+        new(body['error'])
+      end
+    end
+  end
+end

data/lib/mastodon/headers.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Mastodon
+  # Class to handle headers. Important for OAuth2 to work properly.
+  class Headers
+    # @param client [Mastodon::Client]
+    def initialize(client)
+      @client = client
+    end
+
+    # @return [Hash]
+    def request_headers
+      {
+        user_agent: @client.user_agent,
+        accept: '*/*',
+        authorization: "Bearer #{@client.bearer_token}"
+      }
+    end
+  end
+end

data/lib/mastodon/instance.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Mastodon
+  class Instance < Mastodon::Base
+    # @!attribute [r] uri
+    #   @return [String]
+    # @!attribute [r] title
+    #   @return [String]
+    # @!attribute [r] description
+    #   @return [String]
+    # @!attribute [r] email
+    #   @return [String]
+    # @!attribute [r] version
+    #   @return [String]
+    # @!attribute [r] urls
+    #   @return [Hash]
+
+    normal_attr_reader :uri,
+                       :title,
+                       :description,
+                       :email,
+                       :version,
+                       :urls
+  end
+end