adn-reborn 0.4.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1a025eabc1c99ec543b87c5883fde1e1bdc98c2b
+  data.tar.gz: 537db2d68599e08bfa4eab2a9909a94b6d86d974
+SHA512:
+  metadata.gz: 31e1091b7d4a11341c199dc091afea9a37c873d90b2bcd1f8335be7028469ac0c8caf8eaf4e7ac48593daafa735f04da946c87908f862c7927031d3e74b7e2a3
+  data.tar.gz: 93f102ff170e04c03f09c2697c6ed9b483afed152484af519d62f5c80bd6600cfc8b81617cf1406fdbb28c13f677ecd8ebf10bcd2e6fbfb42b211546d99a59a7

data/.gitignore

@@ -0,0 +1,20 @@
+*.gem
+*.rbc
+.bundle
+.config
+.DS_Store
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+vendor/local
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+bundler_args: --without documentation
+rvm:
+  - 1.9.3
+  - 2.0.0
+branches:
+  only:
+    - master

data/CHANGELOG.md

@@ -0,0 +1,34 @@
+### Changelog
+
+### ADN Reborn
+* **Version 0.4.1** (13 February 2016)
+  * Fixed naming of module in spec directory
+* **Version 0.4** (13 February 2016)
+  * Forked from adn-rb/adn
+
+### ADN
+* **Version 0.3.10** (25 October 2014)
+  * Bugfix: Construct user object using data property
+* **Version 0.3.9** (25 October 2014)
+  * Bugfix: Use of ADN.post/delete changed to ADN::API.post/delete
+* **Version 0.3.8** (31 December 2013)
+  * Removed all style violations (cane --no-doc)
+  * Added files to broadcast builder
+* **Version 0.3.7** (15 December 2013)
+  * Recipes now use the builder pattern
+  * Basic file functionality
+* **Version 0.3.6** (11 December 2013)
+  * Added recipe for easy broadcast creation
+* **Version 0.3.5** (23 October 2012)
+  * Added the unified stream
+* **Version 0.3.1** (28 August 2012)
+  * Fixed naming conflict.
+* **Version 0.3** (28 August 2012)
+  * Now includes a Post class that describes each post along with a bunch of new methods of accessing a post's replies and the post's original post.
+  * Users methods that return user details (follow, unfollow, following, followers, mute, unmute, mute_list) will now return either a User object back, or an array of User objects.
+  * Similarly, User methods that return post details (posts, mentions, stream) will return a Post object, or an array of Post objects.
+  * To accomplish all this, I've had to change the module structure which will break existing code if you've relied on the modules to access any data. Basically, all modules begin with ADN::API:: now (eg. ADN::API::Post, ADN::API::User).
+* **Version 0.2** (27 August 2012)
+  * Changed all existing classes to modules and introduced the User class for easily accessing user details.
+* **Version 0.1** (26 August 2012)
+  * Really basic functionality for all existing App.new API methods as per the spec.

data/Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+gemspec
+
+group :test do
+  gem 'rake'
+  gem 'minitest', '~> 5.1'
+end

data/Gemfile.lock

@@ -0,0 +1,25 @@
+PATH
+  remote: .
+  specs:
+    adn-reborn (0.4.1)
+      mime-types (~> 2.0)
+      multipart-post (~> 1.2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    mime-types (2.99)
+    minitest (5.1.0)
+    multipart-post (1.2.0)
+    rake (10.1.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  adn-reborn!
+  minitest (~> 5.1)
+  rake
+
+BUNDLED WITH
+   1.11.2

data/LICENSE

@@ -0,0 +1,16 @@
+Copyright (c) 2016 trorornmn
+
+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.
+
+
+Copyright (c) 2013 Kishyr Ramdial.
+
+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,19 @@
+ADN Reborn
+==========
+
+A Ruby library for App.net by [@trorornmn](https://alpha.app.net/trorornmn).
+
+ADN Reborn is a fork of adn-rb/adn
+
+### Contributors
+
+ADN Reborn is brought to you by these very handsome gentlemen:
+
+* trorornmn ([@trorornmn](https://alpha.app.net/trorornmn))
+* Kishyr Ramdial ([@kishyr](https://alpha.app.net/kishyr))
+* Dave Goodchild ([@buddhamagnet](https://alpha.app.net/buddhamagnet))
+* Peter Hellberg ([@peterhellberg](https://alpha.app.net/peterhellberg))
+
+### License
+
+This software is released under the MIT License, see LICENSE.

data/Rakefile

@@ -0,0 +1,17 @@
+#!/usr/bin/env rake
+require 'find'
+require 'rake/testtask'
+require 'bundler/gem_tasks'
+
+task :default => :spec
+
+Rake::TestTask.new(:spec) do |t|
+  t.test_files = FileList['spec/**/*_spec.rb']
+end
+
+desc "Run cane to check quality metrics"
+task :quality do
+  Bundler.with_clean_env do
+    exec 'cane'
+  end
+end

data/adn-reborn.gemspec

@@ -0,0 +1,19 @@
+# encoding: UTF-8
+
+require File.expand_path('../lib/adn-reborn/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = 'adn-reborn'
+  s.version     = ADNReborn::VERSION
+  s.authors     = ["trorornmn", "Kishyr Ramdial", "Dave Goodchild", "Peter Hellberg"]
+  s.email       = ["trorornmn.develop@gmail.com", "kishyr@gmail.com", "buddhamagnet@gmail.com", "peter@c7.se"]
+  s.description = "A simple and easy to use library to interact with App.net's API"
+  s.summary     = "A Ruby library for App.net"
+  s.homepage    = "https://github.com/trorornmn/adn-reborn"
+  s.files       = `git ls-files`.split($\)
+  s.test_files  = s.files.grep(%r{^(spec)/})
+
+  s.add_runtime_dependency "multipart-post", ["~> 1.2.0"]
+  s.add_runtime_dependency "mime-types", ["~> 2.0"]
+  s.required_ruby_version = '>= 1.9.3'
+end

data/lib/adn-reborn/api/file.rb

@@ -0,0 +1,36 @@
+# encoding: UTF-8
+require 'mime/types'
+require 'net/http/post/multipart'
+
+module ADNReborn
+  module API
+    module File
+      def self.create(filename, params)
+        string_io = StringIO.new(params.to_json)
+
+        content   = UploadIO.new(filename, MIME::Types.type_for(filename)[0])
+        metadata  = UploadIO.new(string_io, "application/json", "data")
+
+        http_params = {
+          "content" => content,
+          # make a fake file so we can still pass json
+          "metadata" => metadata
+        }
+
+        ADNReborn::API.post_multipart("#{ADNReborn::API_ENDPOINT_FILES}", http_params)
+      end
+
+      def self.retrieve(file_id)
+        ADNReborn::API.get("#{ADNReborn::API_ENDPOINT_FILES}/#{file_id}")
+      end
+
+      def self.by_id(file_id)
+        self.retrieve(file_id)
+      end
+
+      def self.delete(file_id)
+        ADNReborn::API.delete("#{ADNReborn::API_ENDPOINT_FILES}/#{file_id}")
+      end
+    end
+  end
+end

data/lib/adn-reborn/api/filter.rb

@@ -0,0 +1,10 @@
+# encoding: UTF-8
+
+module ADNReborn
+  module API
+    module Filter
+      # Not Yet Implemented
+      # https://github.com/appdotnet/api-spec/blob/master/resources/filters.md
+    end
+  end
+end

data/lib/adn-reborn/api/message.rb

@@ -0,0 +1,29 @@
+# encoding: UTF-8
+
+module ADNReborn
+  module API
+    module Message
+      def self.create(channel_id, params)
+        path = "/#{channel_id}/messages"
+
+        ADNReborn::API.post(ADNReborn::API_ENDPOINT_CHANNELS + path, params)
+      end
+
+      def self.retrieve(channel_id, message_id)
+        path = "/#{channel_id}/messages/#{message_id}"
+
+        ADNReborn::API.get(ADNReborn::API_ENDPOINT_CHANNELS + path)
+      end
+
+      def self.by_id(channel_id, message_id)
+        self.retrieve(channel_id, message_id)
+      end
+
+      def self.delete(channel_id, message_id)
+        path = "/#{channel_id}/messages/#{message_id}"
+
+        ADNReborn::API.delete(ADNReborn::API_ENDPOINT_CHANNELS + path)
+      end
+    end
+  end
+end

data/lib/adn-reborn/api/post.rb

@@ -0,0 +1,51 @@
+# encoding: UTF-8
+
+module ADNReborn
+  module API
+    module Post
+      def self.create(params)
+        ADNReborn::API.post("#{ADNReborn::API_ENDPOINT_POSTS}", params)
+      end
+
+      def self.retrieve(post_id)
+        ADNReborn::API.get("#{ADNReborn::API_ENDPOINT_POSTS}/#{post_id}")
+      end
+
+      def self.by_id(post_id)
+        self.retrieve(post_id)
+      end
+
+      def self.delete(post_id)
+        ADNReborn::API.delete("#{ADNReborn::API_ENDPOINT_POSTS}/#{post_id}")
+      end
+
+      def self.replies(post_id, params = nil)
+        ADNReborn::API.get("#{ADNReborn::API_ENDPOINT_POSTS}/#{post_id}/replies", params)
+      end
+
+      def self.by_user(user_id, params = nil)
+        ADNReborn::API.get("#{ADNReborn::API_ENDPOINT_USERS}/#{user_id}/posts", params)
+      end
+
+      def self.mentioning_user(user_id, params = nil)
+        ADNReborn::API.get("#{ADNReborn::API_ENDPOINT_USERS}/#{user_id}/mentions", params)
+      end
+
+      def self.stream(params = nil)
+        ADNReborn::API.get("#{ADNReborn::API_ENDPOINT_POSTS}/stream", params)
+      end
+
+      def self.global_stream(params = nil)
+        ADNReborn::API.get("#{ADNReborn::API_ENDPOINT_POSTS}/stream/global", params)
+      end
+
+      def self.unified_stream(params = nil)
+        ADNReborn::API.get("#{ADNReborn::API_ENDPOINT_POSTS}/stream/unified", params)
+      end
+
+      def self.by_hashtag(hashtag, params = nil)
+        ADNReborn::API.get("#{ADNReborn::API_ENDPOINT_POSTS}/tag/#{hashtag}", params)
+      end
+    end
+  end
+end

data/lib/adn-reborn/api/response.rb

@@ -0,0 +1,19 @@
+# encoding: UTF-8
+
+require 'delegate'
+
+module ADNReborn
+  module API
+    class Response < SimpleDelegator
+      def has_error?
+        self['meta'].nil? ||
+        self['meta']['code'].nil? ||
+        self['meta']['code'] >= HTTP_ERROR
+      end
+
+      def error_message
+        self.fetch('meta').fetch('error_message')
+      end
+    end
+  end
+end

data/lib/adn-reborn/api/stream.rb

@@ -0,0 +1,10 @@
+# encoding: UTF-8
+
+module ADNReborn
+  module API
+    module Stream
+      # Not Yet Implemented
+      # https://github.com/appdotnet/api-spec/blob/master/resources/streams.md
+    end
+  end
+end

data/lib/adn-reborn/api/subscription.rb

@@ -0,0 +1,11 @@
+# encoding: UTF-8
+
+module ADNReborn
+  module API
+    module Subscription
+      # Not Yet Implemented
+      # https://github.com/appdotnet/api-spec/
+      # blob/master/resources/subscriptions.md
+    end
+  end
+end

data/lib/adn-reborn/api/token.rb

@@ -0,0 +1,12 @@
+# encoding: UTF-8
+
+module ADNReborn
+  module API
+    module Token
+      def self.current
+        result = ADNReborn::API.get(ADNReborn::API_ENDPOINT_TOKEN)
+        result["data"]
+      end
+    end
+  end
+end

data/lib/adn-reborn/api/user.rb

@@ -0,0 +1,19 @@
+# encoding: UTF-8
+
+module ADNReborn
+  module API
+    module User
+      def self.retrieve(user_id)
+        ADNReborn::API.get("#{ADNReborn::API_ENDPOINT_USERS}/#{user_id}")
+      end
+
+      def self.following(user_id)
+        ADNReborn::API.get("#{ADNReborn::API_ENDPOINT_USERS}/#{user_id}/following")
+      end
+
+      def self.followers(user_id)
+        ADNReborn::API.get("#{ADNReborn::API_ENDPOINT_USERS}/#{user_id}/followers")
+      end
+    end
+  end
+end

data/lib/adn-reborn/api.rb

@@ -0,0 +1,62 @@
+# encoding: UTF-8
+
+%w{response filter post stream subscription token user message file}.each do |f|
+  require_relative "api/#{f}"
+end
+
+module ADNReborn
+  module API
+    Error = Class.new StandardError
+
+    class << self
+      def perform(request)
+        request.add_field("Authorization", "Bearer #{ADNReborn.token}")
+        response = JSON.parse ADNReborn::HTTP.request(request).body
+
+        Response.new(response).tap { |r|
+          raise ADNReborn::API::Error, r.error_message if r.has_error?
+        }
+      end
+
+      def construct_request(verb, url)
+        http_method = case verb
+          when :post then Net::HTTP::Post
+          when :put then Net::HTTP::Put
+          when :delete then Net::HTTP::Delete
+          else Net::HTTP::Get
+        end
+        http_method.new(url)
+      end
+
+      def get(url, params = nil)
+        url = params.nil? ? url : [url, URI.encode_www_form(params)].join("?")
+        request = construct_request(:get, url)
+        perform(request)
+      end
+
+      def post(url, params = nil)
+        request = construct_request(:post, url)
+        request.add_field('Content-Type', 'application/json')
+        request.body = params.to_json if params
+        perform(request)
+      end
+
+      def post_multipart(url, *http_args)
+        request = Net::HTTP::Post::Multipart.new(url, *http_args)
+        perform(request)
+      end
+
+      def put(url, params = nil)
+        request = construct_request(:put, url)
+        request.add_field('Content-Type', 'application/json')
+        request.body = params.to_json if params
+        perform(request)
+      end
+
+      def delete(url)
+        request = construct_request(:delete, url)
+        perform(request)
+      end
+    end
+  end
+end

data/lib/adn-reborn/constants.rb

@@ -0,0 +1,18 @@
+# encoding: UTF-8
+
+require 'net/https'
+
+module ADNReborn
+  API_HOST = "api.app.net"
+  API_ENDPOINT = "/stream/0"
+  API_ENDPOINT_POSTS = "#{API_ENDPOINT}/posts"
+  API_ENDPOINT_USERS = "#{API_ENDPOINT}/users"
+  API_ENDPOINT_TOKEN = "#{API_ENDPOINT}/token"
+  API_ENDPOINT_CHANNELS = "#{API_ENDPOINT}/channels"
+  API_ENDPOINT_FILES = "#{API_ENDPOINT}/files"
+  HTTP = Net::HTTP.new(API_HOST, 443)
+
+  HTTP_ERROR = 400
+
+  HTTP.use_ssl = true
+end

data/lib/adn-reborn/file.rb

@@ -0,0 +1,62 @@
+# encoding: UTF-8
+
+module ADNReborn
+  class File
+    attr_accessor :id, :file_id, :file_token, :sha1, :name, :source,
+                  :url, :kind, :total_size, :url_expires, :size,
+                  :type, :public, :mime_type, :complete
+
+    attr_writer :user, :created_at
+
+    def self.upload_file(filename, params)
+      result = ADNReborn::API::File.create(filename, params)
+      File.new(result["data"])
+    end
+
+    def self.by_id(id)
+      result = ADNReborn::API::File.by_id(id)
+      File.new(result["data"])
+    end
+
+    def initialize(raw_file)
+      if raw_file.respond_to?(:each_pair)
+        set_values(raw_file)
+        file_id = id
+      else
+        file_id = raw_file
+        file_details = details
+        if file_details.has_key? "data"
+          set_values(file_details["data"])
+        end
+      end
+    end
+
+    def details
+      if id
+        value = self.instance_variables.map do |i|
+          [i.to_s.slice(1..-1), self.instance_variable_get(i)]
+        end
+        Hash[value]
+      else
+        ADNReborn::API::File.by_id(file_id)
+      end
+    end
+
+    def created_at
+      DateTime.parse(@created_at)
+    end
+
+    def user
+      ADNReborn::User.new(@user)
+    end
+
+    def delete
+      result = ADNReborn::API::File.delete(id)
+      ADNReborn.create_instance(result["data"], File)
+    end
+
+    def set_values(values)
+      values.each_pair { |k, v| send("#{k}=", v) if respond_to?("#{k}=") }
+    end
+  end
+end

data/lib/adn-reborn/message.rb

@@ -0,0 +1,76 @@
+# encoding: UTF-8
+
+module ADNReborn
+  class Message
+    attr_accessor(
+      :id, :message_id, :channel_id, :text,
+      :html, :source, :machine_only,
+      :reply_to, :thread_id,
+      :num_replies, :annotations, :entities,
+    )
+
+    attr_writer :user, :created_at
+
+    def self.send_message(params)
+      channel_id = params.delete('channel_id')
+      result = ADNReborn::API::Message.create(channel_id, params)
+      Message.new(result["data"])
+    end
+
+    def self.by_id(channel_id, id)
+      result = ADNReborn::API::Message.by_id(channel_id, id)
+      Message.new(result["data"])
+    end
+
+    def initialize(raw_message)
+      set_values(raw_message)
+      message_id = id
+
+      if raw_message.length == 2 and
+        raw_message.key? :id     and
+        raw_message.key? :channel_id
+
+        # If we only have the bare minimum data,
+        # assume we want to get values from the server
+        message_details = details
+
+        if message_details.has_key? "data"
+          set_values(message_details["data"])
+        end
+      end
+    end
+
+    def details
+      # if we have a source, then we've loaded
+      # stuff from the server
+      if source
+        value = self.instance_variables.map do |i|
+          [i.to_s.slice(1..-1), self.instance_variable_get(i)]
+        end
+
+        Hash[value]
+      else
+        ADNReborn::API::Message.by_id(channel_id, message_id)
+      end
+    end
+
+    def created_at
+      DateTime.parse(@created_at)
+    end
+
+    def user
+      ADNReborn::User.new(@user)
+    end
+
+    def delete
+      result = ADNReborn::API::Message.delete(channel_id, id)
+      ADNReborn.create_instance(result["data"], Message)
+    end
+
+    def set_values(values)
+      values.each_pair do |k, v|
+        send("#{k}=", v) if respond_to?("#{k}=")
+      end
+    end
+  end
+end