freefeed-client 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 51d600de0410a6c2e6341267d64986af26b39add
+  data.tar.gz: 2c3b31d286d4b5cb477d38389b00306cb973540e
+SHA512:
+  metadata.gz: a1aed947a23f1fcc9b9ae852841ecc72688455e0ae499cd504b05a510a823edf3cd0e0a762c8d5cad748673be74d0958824e5c0451628c5a6e4a2469eb81d174
+  data.tar.gz: 2f6299a90a0d4e7e783604d2c7d27f00fcc917ce9ac7f212c6303826231aa31727be25bcac965fe3bb4f134738a86bcd14d8f16a20deca7cd248c8a09a7a0e73

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.1
+before_install: gem install bundler -v 1.13.1

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in freefeed.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Ilia Zemskov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,94 @@
+# freefeed-client
+
+Ruby wrapper for [Freefeed API](https://fetsh.github.io/freefeed-api).
+
+[![Gem Version](https://badge.fury.io/rb/feefeed-client.svg)](http://badge.fury.io/rb/freefeed-client)
+
+## Installation
+
+Add following line to your Gemfile:
+
+```ruby
+gem 'freefeed-client'
+```
+
+And then execute:
+
+```shell
+$ bundle
+```
+
+Or install it system-wide:
+
+```shell
+$ gem install freefeed-client
+```
+
+## Usage
+
+First things first, you need to [obtain a token](https://fetsh.github.io/freefeed-api/#authentication) for your user. Then create your api client like this:
+
+```ruby
+require 'freefeed'
+
+client = Freefeed::Client.new('yourFreefeedAPIToken')
+
+post = Freefeed::Types::PostCreate.new(
+  {
+    post: { 
+      body: 'Hello World!'
+    },
+    meta: {
+      feeds: ['yourusername']
+    }
+  }
+)
+
+post_resource = Freefeed::Post.new(client: client)
+
+post_resource.create(post)
+```
+
+You can skip instantiating resource, but I'm not sure if this is a good practice:
+
+```ruby
+require 'freefeed'
+
+client = Freefeed::Client.new('yourFreefeedAPIToken')
+
+post = Freefeed::Types::PostCreate.new(
+  {
+    post: { 
+      body: 'Hello World!'
+    },
+    meta: {
+      feeds: ['yourusername']
+    }
+  }
+)
+
+client.posts.create(post)
+```
+
+You can even skip instantiating post type, but you will lose some validation:
+
+
+```ruby
+require 'freefeed'
+
+client = Freefeed::Client.new('yourFreefeedAPIToken')
+
+client.posts.create({post: {body: 'Hello World!'}, meta: {feeds: ['yourusername']}})
+```
+
+## Logging
+
+By default, `freefeed-client` logs everything to STDOUT. You can change this behavior and provide your own logger class with someo ptions. See example below:
+
+```ruby
+client = Freefeed::Client.new(
+  'yourFreefeedAPIToken',
+  logger: Logger.new('log.txt'),
+  logger_options: {bodies: false, headers: false}
+)
+```

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "freefeed"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/freefeed.gemspec

@@ -0,0 +1,34 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'freefeed/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'freefeed-client'
+  spec.version       = Freefeed::VERSION
+  spec.authors       = ['Ilia Zemskov']
+  spec.email         = ['me@fetsh.me']
+
+  spec.summary       = 'Ruby wrapper for FreeFeed API.'
+  spec.homepage      = 'https://github.com/fetsh/freefeed-client'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'bin'
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'faraday'
+  spec.add_dependency 'faraday_middleware'
+  spec.add_dependency 'multi_json'
+  spec.add_dependency 'dry-types'
+  spec.add_dependency 'dry-struct'
+  spec.add_dependency 'activesupport'
+
+
+  spec.add_development_dependency 'bundler', '~> 1.13'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+end

data/lib/freefeed/client.rb

@@ -0,0 +1,90 @@
+module Freefeed
+  class Client
+    HOST = 'freefeed.net'.freeze
+
+    attr_accessor :api_token, :faraday_options, :resources
+
+    def initialize(api_token = nil, faraday_options = {})
+      @api_token = api_token
+      @faraday_options = faraday_options
+    end
+
+    def authenticate(username:, password:)
+      Session.new(client: self)
+             .create(username: username, password: password).tap do |re|
+        @api_token = re.fetch('authToken')
+      end
+    end
+
+    def call(endpoint, params = {}, headers = {})
+      guard_wrong_endpoint(endpoint)
+      call!(
+        ENDPOINTS[endpoint][:method], path(endpoint),
+        build_options(endpoint, params), headers
+      )
+    end
+
+    def call!(verb, endpoint, params = {}, headers = {})
+      response = conn.send(
+        verb, endpoint, params, auth_header.merge(headers)
+      )
+      handle_erros(response)
+      prepare_response(response)
+    end
+
+    private
+
+    def conn
+      @conn ||= Faraday.new(url: "https://#{HOST}") do |faraday|
+        faraday.request :multipart
+        faraday.response(
+          :logger,
+          (faraday_options[:logger] || Logger.new(STDOUT)),
+          (faraday_options[:logger_options] || { bodies: true, headers: true })
+        )
+        faraday.request :json
+        faraday.adapter faraday_options[:adapter] || Faraday.default_adapter
+      end
+    end
+
+    def guard_wrong_endpoint(endpoint)
+      raise Exceptions::WrongEndpoint unless ENDPOINTS.keys.include?(endpoint)
+    end
+
+    def build_options(endpoint, params)
+      default_params(endpoint).merge(sanitize_params(endpoint, params))
+    end
+
+    def path(endpoint)
+      (endpoint.start_with?('/') ? '' : BASE_PATH) + endpoint.split('#').first
+    end
+
+    def default_params(endpoint)
+      {}.merge(ENDPOINTS[endpoint][:default_params] || {})
+    end
+
+    def sanitize_params(endpoint, params)
+      return {} unless ENDPOINTS[endpoint][:params]
+      params.delete_if do |key, _|
+        !ENDPOINTS[endpoint][:params].include?(key.to_s)
+      end
+    end
+
+    def handle_erros(response)
+      raise(
+        Exceptions::ResponseError.new(response),
+        'Freefeed API has returned the error'
+      ) unless response.status == 200
+    end
+
+    def prepare_response(response)
+      MultiJson.load(response.body.to_s)
+    rescue MultiJson::LoadError
+      response.body
+    end
+
+    def auth_header
+      api_token.nil? ? {} : { 'x-authentication-token': api_token }
+    end
+  end
+end

data/lib/freefeed/exceptions.rb

@@ -0,0 +1,27 @@
+module Freefeed
+  module Exceptions
+    class ResponseError < StandardError
+      attr_reader :response
+
+      def initialize(response)
+        @response = response
+      end
+
+      def to_s
+        super + format(' (%s)', data.map { |k, v| %(#{k}: "#{v}") }.join(', '))
+      end
+
+      private
+
+      def data
+        @data ||= begin
+          MultiJson.load(response.body)
+        rescue MultiJson::DecodeError
+          { uri: response.env.url.to_s, errors: response.body.to_s }
+        end.merge(code: response.status)
+      end
+    end
+    class WrongEndpoint < StandardError
+    end
+  end
+end

data/lib/freefeed/resources/archive.rb

@@ -0,0 +1,26 @@
+module Freefeed
+  class Archive < ResourceKitling::Resource
+    actions do
+      action :restoration do
+        verb :post
+        version :v2
+        path '/archives/restoration'
+      end
+      action :activities do
+        verb :put
+        version :v2
+        path '/archives/activities'
+      end
+      action :post_by_old_name do
+        verb :get
+        version :v2
+        path '/archives/post-by-old-name/:name'
+      end
+      action :stats do
+        verb :get
+        version :v2
+        path '/archives-stats'
+      end
+    end
+  end
+end

data/lib/freefeed/resources/attachment.rb

@@ -0,0 +1,11 @@
+module Freefeed
+  class Attachment < ResourceKitling::Resource
+    actions do
+      action :create do
+        verb :post
+        version :v1
+        path '/attachments'
+      end
+    end
+  end
+end

data/lib/freefeed/resources/bookmarklet.rb

@@ -0,0 +1,11 @@
+module Freefeed
+  class Bookmarklet < ResourceKitling::Resource
+    actions do
+      action :create do
+        verb :post
+        version :v1
+        path '/bookmarklet'
+      end
+    end
+  end
+end

data/lib/freefeed/resources/comment.rb

@@ -0,0 +1,36 @@
+module Freefeed
+  class Comment < ResourceKitling::Resource
+    actions do
+      action :create do
+        verb :post
+        version :v1
+        path '/comments'
+      end
+      action :update do
+        verb :put
+        version :v1
+        path '/comments/:id'
+      end
+      action :destroy do
+        verb :delete
+        version :v1
+        path '/comments/:id'
+      end
+      action :like do
+        verb :post
+        version :v2
+        path '/comments/:id/like'
+      end
+      action :unlike do
+        verb :post
+        version :v2
+        path '/comments/:id/unlike'
+      end
+      action :likes do
+        verb :get
+        version :v2
+        path '/comments/:id/likes'
+      end
+    end
+  end
+end

data/lib/freefeed/resources/group.rb

@@ -0,0 +1,61 @@
+module Freefeed
+  class Group < ResourceKitling::Resource
+    actions do
+      action :create do
+        verb :post
+        version :v1
+        path '/groups'
+      end
+      action :sudo_create do
+        verb :post
+        version :v1
+        path '/groups/sudo'
+      end
+      action :update_profile_picture do
+        verb :post
+        version :v1
+        path '/groups/:name/updateProfilePicture'
+      end
+      action :admin do
+        verb :post
+        version :v1
+        path '/groups/:name/subscribers/:username/admin'
+      end
+      action :unadmin do
+        verb :post
+        version :v1
+        path '/groups/:name/subscribers/:username/unadmin'
+      end
+      action :send_request do
+        verb :post
+        version :v1
+        path '/groups/:name/sendRequest'
+      end
+      action :accept_request do
+        verb :post
+        version :v1
+        path '/groups/:name/acceptRequest/:username'
+      end
+      action :reject_request do
+        verb :post
+        version :v1
+        path '/groups/:name/rejectRequest/:username'
+      end
+      action :unsubscribe_from_group do
+        verb :post
+        version :v1
+        path '/groups/:name/unsubscribeFromGroup/:username'
+      end
+      action :manage do
+        verb :get
+        version :v2
+        path '/managedGroups'
+      end
+      action :all do
+        verb :get
+        version :v2
+        path '/allGroups'
+      end
+    end
+  end
+end

data/lib/freefeed/resources/invitation.rb

@@ -0,0 +1,16 @@
+module Freefeed
+  class Invitation < ResourceKitling::Resource
+    actions do
+      action :create do
+        verb :post
+        version :v2
+        path '/invitations'
+      end
+      action :get do
+        verb :get
+        version :v2
+        path '/invitations/:id'
+      end
+    end
+  end
+end

data/lib/freefeed/resources/notification.rb

@@ -0,0 +1,11 @@
+module Freefeed
+  class Notification < ResourceKitling::Resource
+    actions do
+      action :all do
+        verb :get
+        version :v2
+        path '/notifications'
+      end
+    end
+  end
+end

data/lib/freefeed/resources/password.rb

@@ -0,0 +1,16 @@
+module Freefeed
+  class Password < ResourceKitling::Resource
+    actions do
+      action :create do
+        verb :post
+        version :v1
+        path '/passwords'
+      end
+      action :update do
+        verb :put
+        version :v1
+        path '/passwords/:token'
+      end
+    end
+  end
+end

data/lib/freefeed/resources/post.rb

@@ -0,0 +1,61 @@
+module Freefeed
+  class Post < ResourceKitling::Resource
+    actions do
+      action :create do
+        verb :post
+        version :v1
+        path '/posts'
+      end
+      action :get do
+        verb :get
+        version :v2
+        path '/posts/:id'
+      end
+      action :update do
+        verb :put
+        version :v1
+        path '/posts/:id'
+      end
+      action :destroy do
+        verb :delete
+        version :v1
+        path '/posts/:id'
+      end
+      action :like do
+        verb :post
+        version :v1
+        path '/posts/:id/like'
+      end
+      action :unlike do
+        verb :post
+        version :v1
+        path '/posts/:id/unlike'
+      end
+      action :hide do
+        verb :post
+        version :v1
+        path '/posts/:id/hide'
+      end
+      action :unhide do
+        verb :post
+        version :v1
+        path '/posts/:id/unhide'
+      end
+      action :disable_comments do
+        verb :post
+        version :v1
+        path '/posts/:id/disableComments'
+      end
+      action :enable_comments do
+        verb :post
+        version :v1
+        path '/posts/:id/enableComments'
+      end
+      action :opengraph do
+        verb :get
+        version :v2
+        path '/posts-opengraph/:id'
+      end
+    end
+  end
+end

data/lib/freefeed/resources/request.rb

@@ -0,0 +1,11 @@
+module Freefeed
+  class Request < ResourceKitling::Resource
+    actions do
+      action :revoke do
+        verb :post
+        version :v2
+        path '/requests/:username/revoke'
+      end
+    end
+  end
+end

data/lib/freefeed/resources/search.rb

@@ -0,0 +1,11 @@
+module Freefeed
+  class Search < ResourceKitling::Resource
+    actions do
+      action :search do
+        verb :get
+        version :v2
+        path '/search'
+      end
+    end
+  end
+end

data/lib/freefeed/resources/session.rb

@@ -0,0 +1,11 @@
+module Freefeed
+  class Session < ResourceKitling::Resource
+    actions do
+      action :create do
+        verb :post
+        version :v1
+        path '/session'
+      end
+    end
+  end
+end

data/lib/freefeed/resources/stat.rb

@@ -0,0 +1,11 @@
+module Freefeed
+  class Stat < ResourceKitling::Resource
+    actions do
+      action :stats do
+        verb :get
+        version :v2
+        path '/stats'
+      end
+    end
+  end
+end

data/lib/freefeed/resources/summary.rb

@@ -0,0 +1,16 @@
+module Freefeed
+  class Summary < ResourceKitling::Resource
+    actions do
+      action :general do
+        verb :get
+        version :v2
+        path '/summary/:days'
+      end
+      action :by_user do
+        verb :get
+        version :v2
+        path '/summary/:username/:days'
+      end
+    end
+  end
+end

data/lib/freefeed/resources/timeline.rb

@@ -0,0 +1,41 @@
+module Freefeed
+  class Timeline < ResourceKitling::Resource
+    actions do
+      action :bestof do
+        verb :get
+        version :v2
+        path '/bestof'
+      end
+      action :home do
+        verb :get
+        version :v2
+        path '/timelines/home'
+      end
+      action :discussions do
+        verb :get
+        version :v2
+        path '/timelines/filter/discussions'
+      end
+      action :directs do
+        verb :get
+        version :v2
+        path '/timelines/filter/directs'
+      end
+      action :posts do
+        verb :get
+        version :v2
+        path '/timelines/:username'
+      end
+      action :likes do
+        verb :get
+        version :v2
+        path '/timelines/:username/likes'
+      end
+      action :comments do
+        verb :get
+        version :v2
+        path '/timelines/:username/comments'
+      end
+    end
+  end
+end

data/lib/freefeed/resources/user.rb

@@ -0,0 +1,121 @@
+module Freefeed
+  class User < ResourceKitling::Resource
+    actions do
+      action :create do
+        verb :post
+        version :v1
+        path '/users'
+      end
+      action :sudo_create do
+        verb :post
+        version :v1
+        path '/users/sudo'
+      end
+      action :send_request do
+        verb :post
+        version :v1
+        path '/users/:username/sendRequest'
+      end
+      action :revoke_request do
+        verb :post
+        version :v2
+        path '/requests/:username/revoke'
+      end
+      action :accept_request do
+        verb :post
+        version :v1
+        path '/users/acceptRequest/:username'
+      end
+      action :reject_request do
+        verb :post
+        version :v1
+        path '/users/rejectRequest/:username'
+      end
+      action :unsubscribe_from_me do
+        verb :post
+        version :v1
+        path '/users/:username/unsubscribeFromMe'
+      end
+      action :show do
+        verb :get
+        version :v1
+        path '/users/:username'
+      end
+      action :update_password do
+        verb :put
+        version :v1
+        path '/users/updatePassword'
+      end
+      action :update_profile_picture do
+        verb :post
+        version :v1
+        path '/users/updateProfilePicture'
+      end
+      action :update do
+        verb :put
+        version :v1
+        path '/users/:id'
+      end
+      action :ban do
+        verb :post
+        version :v1
+        path '/users/:username/ban'
+      end
+      action :unban do
+        verb :post
+        version :v1
+        path '/users/:username/unban'
+      end
+      action :subscribe do
+        verb :post
+        version :v1
+        path '/users/:username/subscribe'
+      end
+      action :unsubscribe do
+        verb :post
+        version :v1
+        path '/users/:username/unsubscribe'
+      end
+      action :subscribers do
+        verb :get
+        version :v1
+        path '/users/:username/subscribers'
+      end
+      action :subscriptions do
+        verb :get
+        version :v1
+        path '/users/:username/subscriptions'
+      end
+      action :blocked do
+        verb :get
+        version :v2
+        path '/users/blockedByMe'
+      end
+      action :unread_directs_number do
+        verb :get
+        version :v2
+        path '/users/getUnreadDirectsNumber'
+      end
+      action :unread_notifications_number do
+        verb :get
+        version :v2
+        path '/users/getUnreadNotificationsNumber'
+      end
+      action :mark_all_directs_as_read do
+        verb :get
+        version :v2
+        path '/users/markAllDirectsAsRead'
+      end
+      action :mark_all_notifications_as_read do
+        verb :post
+        version :v2
+        path '/users/markAllNotificationsAsRead'
+      end
+      action :whoami do
+        verb :get
+        version :v2
+        path '/users/whoami'
+      end
+    end
+  end
+end

data/lib/freefeed/types/bookmarklet.rb

@@ -0,0 +1,17 @@
+require 'dry-types'
+require 'dry-struct'
+module Freefeed
+  module Types
+    class Bookmarklet < Dry::Struct
+      attribute :title, Types::Body
+      attribute :comment, Types::Strict::String.meta(omittable: true)
+      attribute :image, Types::Strict::String.meta(omittable: true)
+      attribute :images, Types::Strict::Array.of(
+        Types::Strict::String
+      ).meta(omittable: true)
+      attribute :meta, Types::Hash.schema(
+        feeds: Types::AccountName | Types::Feeds
+      ).meta(omittable: true)
+    end
+  end
+end

data/lib/freefeed/types/comment.rb

@@ -0,0 +1,16 @@
+require 'dry-types'
+require 'dry-struct'
+module Freefeed
+  module Types
+    class CommentCreate < Dry::Struct
+      attribute :comment, Types::Hash.schema(
+        body: Types::Body,
+        postId: Types::UID
+      )
+    end
+
+    class CommentUpdate < Dry::Struct
+      attribute :comment, Types::Hash.schema(body: Types::Body)
+    end
+  end
+end

data/lib/freefeed/types/post.rb

@@ -0,0 +1,24 @@
+require 'dry-types'
+require 'dry-struct'
+module Freefeed
+  module Types
+    class PostCreate < Dry::Struct
+      attribute :post, Types::Hash.schema(
+        body: Types::Body,
+        attachments: Types::Attachments.meta(omittable: true)
+      )
+      attribute :meta, Types::Hash.schema(
+        commentsDisabled: Types::Strict::Bool.default(false),
+        feeds: Types::AccountName | Types::Feeds
+      )
+    end
+
+    class PostUpdate < Dry::Struct
+      attribute :post, Types::Hash.schema(
+        body: Types::Body.meta(omittable: true),
+        attachments: Types::Attachments.meta(omittable: true),
+        feeds: Types::Feeds.meta(omittable: true)
+      )
+    end
+  end
+end

data/lib/freefeed/types.rb

@@ -0,0 +1,21 @@
+require 'dry-types'
+require 'dry-struct'
+module Freefeed
+  module Types
+    include Dry::Types.module
+
+    Body = Types::Strict::String.constrained(min_size: 1, format: %r{\S+})
+    UID = Types::Strict::String.constrained(
+      format: %r{^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$}
+    )
+    UserName = Types::Strict::String.constrained(
+      min_size: 3, max_size: 25, format: %r{^[A-Za-z0-9]+$}
+    )
+    GroupName = Types::Strict::String.constrained(
+      min_size: 3, max_size: 25, format: %r{^[A-Za-z0-9]+(-[a-zA-Z0-9]+)*$}
+    )
+    AccountName = UserName | GroupName
+    Attachments = Types::Strict::Array.of(UID)
+    Feeds = Types::Strict::Array.of(AccountName)
+  end
+end

data/lib/freefeed/version.rb

@@ -0,0 +1,3 @@
+module Freefeed
+  VERSION = '0.1.0'.freeze
+end

data/lib/freefeed.rb

@@ -0,0 +1,46 @@
+require 'faraday'
+require 'faraday_middleware'
+require 'logger'
+require 'multi_json'
+require 'resource_kitling'
+require 'freefeed/version'
+require 'freefeed/exceptions'
+require 'freefeed/client'
+require 'active_support/inflector'
+
+require 'freefeed/resources/archive'
+require 'freefeed/resources/attachment'
+require 'freefeed/resources/bookmarklet'
+require 'freefeed/resources/comment'
+require 'freefeed/resources/group'
+require 'freefeed/resources/invitation'
+require 'freefeed/resources/notification'
+require 'freefeed/resources/password'
+require 'freefeed/resources/post'
+require 'freefeed/resources/request'
+require 'freefeed/resources/search'
+require 'freefeed/resources/session'
+require 'freefeed/resources/stat'
+require 'freefeed/resources/summary'
+require 'freefeed/resources/timeline'
+require 'freefeed/resources/user'
+
+require 'freefeed/types'
+require 'freefeed/types/bookmarklet'
+require 'freefeed/types/comment'
+require 'freefeed/types/post'
+
+ResourceKitling::Resource.subclasses.each do |sc|
+  mn = sc.to_s.downcase.split('::').last.pluralize
+  if Freefeed::Client.method_defined?(mn)
+    raise(
+      ArgumentError,
+      "Method '#{mn}' is already defined on Freefeed::Client"
+    )
+  end
+  Freefeed::Client.send(:define_method, mn) do
+    instance_variable_get("@#{mn}") || instance_variable_set(
+      "@#{mn}", sc.new(client: self)
+    )
+  end
+end

data/lib/resource_kitling.rb

@@ -0,0 +1,101 @@
+module ResourceKitling
+  require 'forwardable'
+  class ActionCollection
+    extend Forwardable
+    def_delegators :@collection, :find, :<<, :each, :include?
+    def initialize
+      @collection = []
+    end
+
+    def action(name, &block)
+      action = Action.new(name)
+      action.instance_eval(&block) if block_given?
+      action.tap { |a| @collection << a }
+    end
+  end
+
+  class Action
+    attr_reader :name
+
+    def initialize(name)
+      @name = name
+      @verb = :get
+      @version = 'v1'
+      @path = path
+    end
+
+    def verb(v = nil)
+      @verb = v if v
+      @verb
+    end
+
+    def version(v = nil)
+      @version = v if v
+      @version
+    end
+
+    def path(path = nil, &block)
+      raise "You must pass either a block or a string for paths" if path and block_given?
+      @path = path if path
+      @path = block if block_given?
+      @path
+    end
+
+    def generated_path(values = {})
+      values.inject("/#{version}/#{path}") do |np, (key, value)|
+        np.gsub(":#{key}", value.to_s)
+      end
+    end
+  end
+  class Resource
+    class << self
+      attr_accessor :_actions
+      attr_reader :subclasses
+      def inherited(subclass)
+        superclass.inherited(subclass) if superclass.respond_to?(:inherited)
+        @subclasses ||= []
+        @subclasses << subclass
+      end
+    end
+
+    def self.actions(&block)
+      self._actions ||= ActionCollection.new
+      if block_given?
+        self._actions.instance_eval(&block)
+        # MethodFactory.construct(self, self._actions)
+        self._actions.each do |action|
+          if method_defined?(action.name)
+            raise(
+              ArgumentError,
+              "Action '#{action.name}' is already defined on `#{self}`"
+            )
+          end
+          method_block = method_for_action(action)
+          send(:define_method, action.name, &method_block)
+        end
+      end
+      self._actions
+    end
+
+    def self.method_for_action(action)
+      Proc.new do |*args|
+        pathopts = action.path.include?(':') ? args.shift : {}
+        payload = args.shift
+        payload = payload.to_h if payload.respond_to?(:to_h)
+        client.call!(
+          action.verb, action.generated_path(pathopts), payload, *args
+        )
+      end
+    end
+
+    def actions
+      self.class.actions
+    end
+
+    attr_reader :client
+
+    def initialize(client: nil)
+      @client = client
+    end
+  end
+end

metadata

@@ -0,0 +1,207 @@
+--- !ruby/object:Gem::Specification
+name: freefeed-client
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ilia Zemskov
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-10-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: dry-types
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: dry-struct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: 
+email:
+- me@fetsh.me
+executables:
+- console
+- setup
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- freefeed.gemspec
+- lib/freefeed.rb
+- lib/freefeed/client.rb
+- lib/freefeed/exceptions.rb
+- lib/freefeed/resources/archive.rb
+- lib/freefeed/resources/attachment.rb
+- lib/freefeed/resources/bookmarklet.rb
+- lib/freefeed/resources/comment.rb
+- lib/freefeed/resources/group.rb
+- lib/freefeed/resources/invitation.rb
+- lib/freefeed/resources/notification.rb
+- lib/freefeed/resources/password.rb
+- lib/freefeed/resources/post.rb
+- lib/freefeed/resources/request.rb
+- lib/freefeed/resources/search.rb
+- lib/freefeed/resources/session.rb
+- lib/freefeed/resources/stat.rb
+- lib/freefeed/resources/summary.rb
+- lib/freefeed/resources/timeline.rb
+- lib/freefeed/resources/user.rb
+- lib/freefeed/types.rb
+- lib/freefeed/types/bookmarklet.rb
+- lib/freefeed/types/comment.rb
+- lib/freefeed/types/post.rb
+- lib/freefeed/version.rb
+- lib/resource_kitling.rb
+homepage: https://github.com/fetsh/freefeed-client
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2.1
+signing_key: 
+specification_version: 4
+summary: Ruby wrapper for FreeFeed API.
+test_files: []