dropmark 0.1.5

data/.gitignore

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

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Oak Studios LLC
+
+MIT License
+
+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,139 @@
+Dropmark Gem
+============
+
+- [Installation](#installation)
+- [Using this gem in your application](#using-this-gem-in-your-application)
+- [Using the API](#using-the-api)
+- [Contributing](#contributing)
+
+Installation
+------------
+
+The Dropmark gem is available for installation on [Rubygems](https://rubygems.org/gems/dropmark). To install run:
+
+    gem install dropmark # todo
+
+
+Using this gem in your application
+----------------------------------
+    
+To use this gem in your application, add the following to your Gemfile:
+
+    gem 'dropmark', :git => 'git://github.com/dropmark/dropmark-gem.git'
+
+
+Using the API
+-------------
+
+This gem allows you to interact with the Dropmark API.
+
+```ruby
+require 'dropmark'
+
+# authenticate application
+Dropmark.configure do |config|
+  config.api_key    = 'API_KEY'
+  config.api_base   = 'https://api.dropmark.com/v1'  # optional
+  config.user_id    = 'USER_ID'                      # optional, see below to retrieve
+  config.user_token = 'USER_TOKEN'                   # optional, see below to retrieve
+end
+
+# retreive user token if needed
+user = Dropmark::User.auth(email: 'EMAIL', password: 'PASSWORD')
+# note: store user.id and user.token for future use, never store password
+
+# get authenticated user
+user = Dropmark::User.find('me')
+
+# get first 20 collections for authenticated user
+collections = Dropmark::Collection.all(page: 1, count: 20)
+
+# get collection by id
+collection = Dropmark::Collection.find(133727)
+
+# create new collection for authenticated user
+collection = Dropmark::Collection.create(
+  name:          'New collection',
+  type:          'private',          # optional ('private', 'public', 'global')
+  sort_by:       'created_at',       # optional ('name', 'created_at', 'updated_at')
+  sort_order:    'desc',             # optional ('asc', 'desc')
+  thumbnails:    'square',           # optional ('square', 'full')
+  labels:        'true',             # optional ('true', 'false')
+)
+
+# delete collection
+collection.destroy
+# or delete collection by id
+Dropmark::Collection.destroy_existing(133727)
+
+# sort collections by ids
+collections = Dropmark::Collection.sort([101, 102, 103])
+
+# get items in collection
+items = collection.items
+# or get items without fetching collection
+items = Dropmark::Item.where(collection_id: 133727)
+
+# get item by id
+item = Dropmark::Item.find(2139403)
+
+# sort items in collection by item ids
+items = collection.sort_items([101, 102, 103])
+# or sort items without fetching collection
+items = Dropmark::Item.sort(collection_id, [101, 102, 103])
+
+# create new item
+item = collection.items.create(content: 'http://dropmark.com')
+# or
+item = Dropmark::Item.create(
+  collection_id: 133727,
+  name:          'Logo',                                         # optional
+  content:       'http://dropmark.com/assets/images/logo.png',   # required (URL, file, or text)
+  description:   'Dropmark logo',                                # optional
+  link:          'http://dropmark.com',                          # optional
+  thumbnail:     'http://dropmark.com/assets/images/logo.png',   # optional
+  shareable:     'true'                                          # optional
+)
+
+# upload file item
+item = Dropmark::Item.create(
+  collection_id: 133727,
+  content:       Dropmark::File.new('~/photo.jpg')
+)
+
+# update item
+item.name = 'My Photo'
+item.save
+# or update by id
+item = Dropmark::Item.save_existing(2316519, name: 'My Photo')
+
+# delete item
+item.destroy
+# or delete by id
+Dropmark::Item.destroy_existing(2139403)
+
+# get item comments
+comments = item.comments.all
+
+# add comment
+comment = item.comments.create(body: 'My comment')
+# or comment by item id
+comment = Dropmark::Comment.create(item_id: 2316545, body: 'My comment')
+
+# delete comment
+comment.destroy
+# or comment by id
+Dropmark::Comment.destroy_existing(2139403)
+```
+
+
+Contributing
+------------
+
+Help us improve this gem:
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/dropmark.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'dropmark/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "dropmark"
+  gem.version       = Dropmark::VERSION
+  gem.authors       = ["dropmark"]
+  gem.email         = ["api@dropmark.com"]
+  gem.description   = %q{A Ruby interface and command line utility for the Dropmark API.}
+  gem.summary       = "Dropmark Ruby interface"
+  gem.homepage      = "http://dropmark.com"
+  
+  gem.required_ruby_version = '>= 1.8'
+  
+  gem.add_runtime_dependency 'her'
+  gem.add_runtime_dependency 'mime-types'
+
+  gem.files         = `git ls-files`.split($/)
+  gem.files         += Dir.glob("lib/**/*.rb")
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+end

data/lib/dropmark.rb

@@ -0,0 +1,48 @@
+libdir = File.dirname(__FILE__)
+$LOAD_PATH.unshift(libdir) unless $LOAD_PATH.include?(libdir)
+
+require 'her'
+require 'ostruct'
+require 'rbconfig'
+require 'dropmark/version'
+require 'dropmark/authentication'
+require 'dropmark/error'
+require 'dropmark/file'
+
+module Dropmark
+
+  class << self
+    attr_accessor :api_key, :api_base, :user_id, :user_token
+  end
+
+  def self.api
+    @api
+  end
+
+  def self.configure(&blk)
+    options = OpenStruct.new
+    yield(options)
+    
+    @api_key = options.try(:api_key)
+    @api_base = options.try(:api_base) || 'https://api.dropmark.com/v1'
+    @user_id = options.try(:user_id)
+    @user_token = options.try(:user_token)
+    
+    @api = Her::API.new
+    @api.setup :url => @api_base do |c|
+      c.use Faraday::Response::Logger
+      c.use Dropmark::Authentication
+      c.use Faraday::Request::Multipart
+      c.use Faraday::Request::UrlEncoded
+      c.use Her::Middleware::DefaultParseJSON
+      c.use Faraday::Adapter::NetHttp
+      c.use Dropmark::Error::RaiseError
+    end
+    require 'dropmark/collection'
+    require 'dropmark/comment'
+    require 'dropmark/item'
+    require 'dropmark/user'
+  end
+
+end
+

data/lib/dropmark/authentication.rb

@@ -0,0 +1,21 @@
+require 'base64'
+
+module Dropmark
+  class Authentication < Faraday::Middleware
+  
+    def initialize(app, options={})
+      @app = app
+      @options = options
+    end
+    
+    def call(env)
+      if Dropmark.user_id
+        basic_auth = Base64.encode64([Dropmark.user_id, Dropmark.user_token].join(':')).to_s.gsub!("\n", '')
+        env[:request_headers]["Authorization"] = "Basic #{basic_auth}"
+      end
+      env[:request_headers]["X-API-Key"] = Dropmark.api_key
+      @app.call(env)
+    end
+    
+  end
+end

data/lib/dropmark/collection.rb

@@ -0,0 +1,27 @@
+module Dropmark
+  class Collection
+    include Her::Model
+    uses_api Dropmark.api
+    
+    has_many :users
+    has_many :items
+    custom_get :count
+    
+    after_find do |i|
+      begin
+        i.created_at = Time.parse(i.created_at)
+        i.updated_at = Time.parse(i.updated_at)
+        i.last_accessed_at = Time.parse(i.last_accessed_at)
+      rescue
+      end
+    end
+    
+    def self.sort(order)
+      items = put("collections", :order => order)
+    end
+    
+    def sort_items(order)
+      items = Dropmark::Item.put("collections/#{id}/items", :order => order)
+    end
+  end
+end

data/lib/dropmark/comment.rb

@@ -0,0 +1,19 @@
+module Dropmark
+  class Comment
+    include Her::Model
+    uses_api Dropmark.api
+    
+    collection_path "items/:item_id/comments"
+    resource_path "comments/:id"
+    
+    belongs_to :item
+    
+    after_find do |i|
+      begin
+        i.created_at = Time.parse(i.created_at)
+        i.updated_at = Time.parse(i.updated_at)
+      rescue
+      end
+    end
+  end
+end

data/lib/dropmark/error.rb

@@ -0,0 +1,32 @@
+module Dropmark
+  module Error
+    class BadRequest < StandardError; end
+    class Forbidden < StandardError; end
+    class NotFound < StandardError; end
+    class ServerError < StandardError; end
+
+    class RaiseError < Faraday::Response::Middleware
+      def parse(body)
+        if body = MultiJson.load(body, :symbolize_keys => true)
+          body[:message] if body.has_key?(:message)
+        end
+      end
+      
+      def on_complete(env)
+        return if (status = env[:status]) < 400 # Ignore any non-error response codes
+        
+        message = parse(env[:body])
+        case status
+        when 400
+          raise Dropmark::Error::BadRequest, message
+        when 403
+          raise Dropmark::Error::Forbidden, message
+        when 404
+          raise Dropmark::Error::NotFound, message
+        else
+          raise Dropmark::Error::ServerError, message # Treat any other errors as 500
+        end
+      end
+    end
+  end
+end

data/lib/dropmark/file.rb

@@ -0,0 +1,12 @@
+require 'mime/types'
+
+module Dropmark
+  class File < Faraday::UploadIO
+    def initialize(file, mime = nil, filename = nil)
+      if mime.nil? and detected_mimes = MIME::Types.type_for(file)
+        mime = detected_mimes.first
+      end
+      super(file, mime.to_s, filename)
+    end
+  end
+end

data/lib/dropmark/item.rb

@@ -0,0 +1,30 @@
+module Dropmark
+  class Item
+    include Her::Model
+    uses_api Dropmark.api
+    
+    collection_path "collections/:collection_id/items"
+    resource_path "items/:id"
+    
+    belongs_to :collection
+    has_many :comments
+    custom_get :count
+    
+    method_for :update, :post
+    
+    store_metadata :_metadata # conflicted with actual item metadata
+    
+    after_initialize do |i|
+      i.metadata = i._metadata unless i.has_attribute?('metadata')
+      begin
+        i.created_at = Time.parse(i.created_at)
+        i.updated_at = Time.parse(i.updated_at)
+      rescue
+      end
+    end
+    
+    def self.sort(id, order)
+      items = Dropmark::Collection.new(:id => id).sort_items(order)
+    end
+  end
+end

data/lib/dropmark/user.rb

@@ -0,0 +1,39 @@
+module Dropmark
+  class User
+    include Her::Model
+    uses_api Dropmark.api
+    
+    attributes :name, :email, :password, :username
+    validates :name, presence: true
+    validates :email, format: { with: /\A([a-z0-9\+_\-]+)(\.[a-z0-9\+_\-]+)*@([a-z0-9\-]+\.)+[a-z]{2,6}\z/ix }
+    validates :password, length: { minimum: 6 }
+    validates :username, format: { with: /\A(?!-)([a-z0-9-]{0,49}[a-z0-9])\z/i }
+    
+    has_many :collections
+    custom_get :contacts
+    
+    after_find do |i|
+      begin
+        i.created_at = Time.parse(i.created_at)
+        i.updated_at = Time.parse(i.updated_at)
+      rescue
+      end
+    end
+    
+    def request_path
+      if !Dropmark.user_id.nil? and self.try(:id) == Dropmark.user_id
+        "users/me"
+      else
+        super
+      end
+    end
+    
+    def self.auth(params)
+      if response = self.post('auth', params)
+        Dropmark.user_id = response.try(:id)
+        Dropmark.user_token = response.try(:token)
+      end
+      response
+    end
+  end
+end

data/lib/dropmark/version.rb

@@ -0,0 +1,3 @@
+module Dropmark
+  VERSION = "0.1.5"
+end

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification
+name: dropmark
+version: !ruby/object:Gem::Version
+  version: 0.1.5
+  prerelease: 
+platform: ruby
+authors:
+- dropmark
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-07-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: her
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mime-types
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Ruby interface and command line utility for the Dropmark API.
+email:
+- api@dropmark.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- dropmark.gemspec
+- lib/dropmark.rb
+- lib/dropmark/authentication.rb
+- lib/dropmark/collection.rb
+- lib/dropmark/comment.rb
+- lib/dropmark/error.rb
+- lib/dropmark/file.rb
+- lib/dropmark/item.rb
+- lib/dropmark/user.rb
+- lib/dropmark/version.rb
+homepage: http://dropmark.com
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '1.8'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Dropmark Ruby interface
+test_files: []