kloudless 0.1.0

data/lib/kloudless/event.rb

@@ -0,0 +1,16 @@
+module Kloudless
+  # https://developers.kloudless.com/docs#events
+  class Event < Model
+    # https://developers.kloudless.com/docs#events-list-file/folder-events
+    def self.list(account_id:, **params)
+      path = "/accounts/#{account_id}/events"
+      Kloudless::Collection.new(self, http.get(path, params: params))
+    end
+
+    # https://developers.kloudless.com/docs#events-retrieve-latest-cursor
+    def self.cursor(account_id:)
+      path = "/accounts/#{account_id}/events/latest"
+      new(http.get(path))
+    end
+  end
+end

data/lib/kloudless/file.rb

@@ -0,0 +1,50 @@
+module Kloudless
+  # https://developers.kloudless.com/docs#files
+  class File < Model
+    def self.upload(account_id:, **params)
+      path = "/accounts/#{account_id}/files"
+      new(http.post(path, params: params))
+    end
+
+    def self.metadata(account_id:, file_id:)
+      path = "/accounts/#{account_id}/files/#{file_id}"
+      new(http.get(path))
+    end
+
+    def self.rename(account_id:, file_id:, **params)
+      path = "/accounts/#{account_id}/files/#{file_id}"
+      new(http.patch(path, params: params))
+    end
+
+    # TODO: unclear how to post binary data over net-http
+    def self.update
+      raise NotImplementedError
+    end
+
+    def self.download(account_id:, file_id:)
+      path = "/accounts/#{account_id}/files/#{file_id}/contents"
+      http.get_raw(path)
+    end
+
+    def self.copy(account_id:, file_id:, parent_id:, **params)
+      path = "/accounts/#{account_id}/files/#{file_id}/copy"
+      params[:parent_id] = parent_id
+      new(http.post(path, params: params))
+    end
+
+    def self.delete(account_id:, file_id:, **params)
+      path = "/accounts/#{account_id}/files/#{file_id}"
+      new(http.delete(path, params: params))
+    end
+
+    def self.recent(account_ids:, **params)
+      path = "/accounts/#{account_ids.join(',')}/recent"
+      Kloudless::Collection.new(self, http.get(path, params: params))
+    end
+
+    def self.search(account_ids:, **params)
+      path = "/accounts/#{account_ids.join(',')}/search"
+      Kloudless::Collection.new(self, http.get(path, params: params))
+    end
+  end
+end

data/lib/kloudless/folder.rb

@@ -0,0 +1,41 @@
+module Kloudless
+  # https://developers.kloudless.com/docs#folders
+  class Folder < Model
+    # https://developers.kloudless.com/docs#folders-create-a-folder
+    def self.create(account_id:, **params)
+      path = "/accounts/#{account_id}/folders"
+      new(http.post(path, params: params))
+    end
+
+    # https://developers.kloudless.com/docs#folders-retrieve-folder-metadata
+    def self.metadata(account_id:, folder_id:)
+      path = "/accounts/#{account_id}/folders/#{folder_id}"
+      new(http.get(path))
+    end
+
+    # https://developers.kloudless.com/docs#folders-retrieve-folder-contents
+    def self.retrieve(account_id:, folder_id:, **params)
+      path = "/accounts/#{account_id}/folders/#{folder_id}/contents"
+      Kloudless::Collection.new(self, http.get(path, params: params))
+    end
+
+    # https://developers.kloudless.com/docs#folders-rename/move-a-folder
+    def self.rename(account_id:, folder_id:, **params)
+      path = "/accounts/#{account_id}/folders/#{folder_id}"
+      new(http.patch(path, params: params))
+    end
+
+    # https://developers.kloudless.com/docs#folders-copy-a-folder
+    def self.copy(account_id:, folder_id:, parent_id:, **params)
+      params[:parent_id] = parent_id
+      path = "/accounts/#{account_id}/folders/#{folder_id}/copy"
+      new(http.post(path, params: params))
+    end
+
+    # https://developers.kloudless.com/docs#folders-delete-a-folder
+    def self.delete(account_id:, folder_id:, **params)
+      path = "/accounts/#{account_id}/folders/#{folder_id}"
+      new(http.delete(path, params: params))
+    end
+  end
+end

data/lib/kloudless/http.rb

@@ -0,0 +1,114 @@
+require "net/http"
+
+module Kloudless
+  # Net::HTTP wrapper
+  class HTTP
+    # Public: Headers global to all requests
+    def self.headers
+      @headers ||= {}
+    end
+
+    def self.get(path, params: {}, headers: {})
+      uri = URI.parse(Kloudless::API_URL + path)
+      uri.query = URI.encode_www_form(params) if !params.empty?
+
+      request = Net::HTTP::Get.new(uri)
+      request.initialize_http_header(headers)
+
+      execute(request)
+    end
+
+    # TODO: decouple Kloudless::HTTP methods from #execute. Have methods return
+    # request object, defaults to json parsing, but allow the option for raw
+    def self.get_raw(path)
+      uri = URI.parse(Kloudless::API_URL + path)
+      request = Net::HTTP::Get.new(uri)
+      request.initialize_http_header(headers)
+
+      execute(request, parse_json: false)
+    end
+
+
+    def self.post(path, params: {}, headers: {})
+      uri = URI.parse(Kloudless::API_URL + path)
+      headers["Content-Type"] = "application/json"
+
+      request = Net::HTTP::Post.new(uri)
+      request.initialize_http_header(headers)
+      request.set_form_data(params) if !params.empty?
+
+      execute(request)
+    end
+
+    def self.patch(path, params: {}, headers: {})
+      uri = URI.parse(Kloudless::API_URL + path)
+      headers["Content-Type"] = "application/json"
+
+      request = Net::HTTP::Post.new(uri)
+      request.initialize_http_header(headers)
+      request.set_form_data(params) if !params.empty?
+
+      execute(request)
+    end
+
+    def self.delete(path, params: {}, headers: {})
+      uri = URI.parse(Kloudless::API_URL + path)
+      uri.query = URI.encode_www_form(params) if !params.empty?
+
+      request = Net::HTTP::Delete.new(uri)
+      request.initialize_http_header(headers)
+
+      execute(request)
+    end
+
+    def self.execute(request, parse_json: true)
+      uri = request.uri
+      @last_request = request
+      headers.each {|k,v| request[k] = v}
+
+      response = @mock_response || Net::HTTP.start(uri.hostname, uri.port, use_ssl: (uri.scheme == "https")) {|http|
+        http.request(request)
+      }
+
+      if parse_json
+        json = JSON.parse(response.body)
+        raise Kloudless::Error.from_json(json) if json["error_code"]
+        json
+      else
+        response
+      end
+    end
+
+    # Internal: Returns `response` the next time #execute is invoked for the
+    # duration of `blk`. Used for testing.
+    #
+    #  mock = Struct.new(:body).new("{}")
+    #  Kloudless::HTTP.mock_response(mock) do
+    #    Kloudless::HTTP.get "/foo"  # returns {}
+    #  end
+    def self.mock_response(response = nil, &blk)
+      @mock_response = response || Struct.new(:body).new("{}")
+      blk.call
+    ensure
+      @mock_response = nil
+    end
+
+    require 'minitest/mock'
+    def self.expect(method, returns: nil, args: [], &blk)
+      begin
+        mock = MiniTest::Mock.new
+        Kloudless.http = mock
+        mock.expect(method, returns, args)
+        blk.call
+        mock.verify
+      ensure
+        Kloudless.http = Kloudless::HTTP
+      end
+    end
+
+    # Internal: Returns the last Net::HTTP request sent by #execute.
+    def self.last_request
+      @last_request
+    end
+  end
+end

data/lib/kloudless/link.rb

@@ -0,0 +1,34 @@
+module Kloudless
+  # https://developers.kloudless.com/docs#links
+  class Link < Model
+    def self.list(account_ids:, **params)
+      path = "/accounts/#{account_ids.join(',')}/links"
+      Kloudless::Collection.new(self, http.get(path, params: params))
+    end
+
+    # https://developers.kloudless.com/docs#links-create-a-link
+    def self.create(account_id:, file_id:, **params)
+      params[:file_id] = file_id
+      path = "/accounts/#{account_id}/links"
+      new(http.post(path, params: params))
+    end
+
+    # https://developers.kloudless.com/docs#links-retrieve-a-link
+    def self.retrieve(account_id:, link_id:, **params)
+      path = "/accounts/#{account_id}/links/#{link_id}"
+      new(http.get(path, params: params))
+    end
+
+    # https://developers.kloudless.com/docs#links-update-a-link
+    def self.update(account_id:, link_id:, **params)
+      path = "/accounts/#{account_id}/links/#{link_id}"
+      new(http.patch(path, params: params))
+    end
+
+    # https://developers.kloudless.com/docs#links-delete-a-link
+    def self.delete(account_id:, link_id:)
+      path = "/accounts/#{account_id}/links/#{link_id}"
+      new(http.delete(path))
+    end
+  end
+end

data/lib/kloudless/model.rb

@@ -0,0 +1,20 @@
+module Kloudless
+  # Public: Base class for different API resources. e.g. Account, Team, Files.
+  class Model
+    def self.http
+      Kloudless.http
+    end
+
+    def http
+      self.class.http
+    end
+
+    def initialize(attributes = {})
+      @attributes = attributes
+    end
+
+    def method_missing(name, *args, &blk)
+      @attributes[name.to_s] || super
+    end
+  end
+end

data/lib/kloudless/multipart_upload.rb

@@ -0,0 +1,37 @@
+module Kloudless
+  # https://developers.kloudless.com/docs#multipart-upload
+  class MultipartUpload < Model
+    def self.init(account_id:, **params)
+      path = "/accounts/#{account_id}/multipart"
+      new(http.post(path, params: params))
+    end
+
+    def self.retrieve(account_id:, multipart_id:)
+      path = "/accounts/#{account_id}/multipart/#{multipart_id}"
+      new(http.get(path))
+    end
+
+    # https://developers.kloudless.com/docs#multipart-upload-upload-part
+    def self.upload(account_id:, multipart_id:, part_number:, **params)
+      path = "/accounts/#{account_id}/multipart/#{multipart_id}"
+      params[:part_number] = part_number
+      new(http.put(path, params: params))
+    end
+
+    # https://developers.kloudless.com/docs#multipart-upload-finalize-multipart-session
+    def self.finalize(account_id:, multipart_id:)
+      path = "/accounts/#{account_id}/multipart/#{multipart_id}/complete"
+      new(http.post(path))
+    end
+
+    # https://developers.kloudless.com/docs#multipart-upload-abort-multipart-session
+    def self.abort(account_id:, multipart_id:)
+      path = "/accounts/#{account_id}/multipart/#{multipart_id}"
+      new(http.delete(path))
+    end
+
+    class << self
+      alias_method :delete, :abort
+    end
+  end
+end

data/lib/kloudless/team.rb

@@ -0,0 +1,9 @@
+module Kloudless
+  # https://developers.kloudless.com/docs#team
+  class Team < Model
+    def self.list(account_id:, **params)
+      path = "/accounts/#{account_id}/team"
+      Kloudless::Collection.new(self, http.get(path, params: params))
+    end
+  end
+end

data/lib/kloudless/version.rb

@@ -0,0 +1,3 @@
+module Kloudless
+  VERSION = "0.1.0"
+end

data/script/changelog

@@ -0,0 +1,29 @@
+#!/usr/bin/env sh
+# Usage: script/changelog [-r <repo>] [-b <base>] [-h <head>]
+#
+#  repo: base string of GitHub repository url. e.g. "user_or_org/repository". Defaults to git remote url.
+#  base: git ref to compare from. e.g. "v1.3.1". Defaults to latest git tag.
+#  head: git ref to compare to. Defaults to "HEAD".
+#
+# Generate a changelog preview from pull requests merged between `base` and
+# `head`.
+#
+set -e
+
+[ $# -eq 0 ] && set -- --help
+
+# parse args
+repo=$(git remote -v | grep push | awk '{print $2}' | cut -d'/' -f4- | sed 's/\.git//')
+base=$(git tag -l | sort -n | tail -n 1)
+head="HEAD"
+api_url="https://api.github.com"
+
+echo "# $repo $base..$head"
+echo
+
+# get merged PR's. Better way is to query the API for these, but this is easier
+for pr in $(git log --oneline $base..$head | grep "Merge pull request" | awk '{gsub("#",""); print $5}')
+do
+  # frustrated with trying to pull out the right values, fell back to ruby
+  curl -s "$api_url/repos/$repo/pulls/$pr" | ruby -rjson -e 'pr=JSON.parse(STDIN.read); puts "* #{pr[%q(title)]} [##{pr[%q(number)]}](#{pr[%q(html_url)]})"'
+done

data/script/package

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+# Usage: script/package
+# Updates the gemspec and builds a new gem in the pkg directory.
+
+mkdir -p pkg
+gem build *.gemspec
+mv *.gem pkg

data/script/release

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+# Usage: script/release
+# Build the package, tag a commit, push it to origin, and then release the
+# package publicly.
+
+set -e
+
+version="$(script/package | grep Version: | awk '{print $2}')"
+[ -n "$version" ] || exit 1
+
+echo $version
+git commit --allow-empty -a -m "Release $version"
+git tag "v$version"
+git push origin
+git push origin "v$version"
+gem push pkg/*-${version}.gem

data/test/kloudless/account_key_test.rb

@@ -0,0 +1,26 @@
+require_relative "../test_helper"
+require 'minitest'
+
+class Kloudless::AccountKeyTest < Minitest::Test
+  def test_list_account_keys
+    Kloudless.http.expect(:get, returns: {"objects" => [{}]}, args: ["/accounts/1,2/keys", params: {}]) do
+      account_keys = Kloudless::AccountKey.list(account_ids: [1,2])
+      assert_kind_of Kloudless::Collection, account_keys
+      assert_kind_of Kloudless::AccountKey, account_keys.first
+    end
+  end
+
+  def test_retrieve_account_key
+    Kloudless.http.expect(:get, args: ["/accounts/1/keys/2", params: {}]) do
+      account_key = Kloudless::AccountKey.retrieve(account_id: 1, key_id: 2)
+      assert_kind_of Kloudless::AccountKey, account_key
+    end
+  end
+
+  def test_delete_account_key
+    Kloudless.http.expect(:delete, args: ["/accounts/1/keys/2"]) do
+      account_key = Kloudless::AccountKey.delete(account_id: 1, key_id: 2)
+      assert_kind_of Kloudless::AccountKey, account_key
+    end
+  end
+end

data/test/kloudless/account_test.rb

@@ -0,0 +1,78 @@
+require_relative "../test_helper"
+
+class Kloudless::AccountTest < Minitest::Test
+  def test_list_accounts
+    json = JSON.parse <<-JSON
+    {
+      "total": 2,
+      "count": 2,
+      "page": 1,
+      "objects": [
+        {
+            "id": 90817234,
+            "account": "someone@gmail.com",
+            "service": "box",
+            "service_name": "Box",
+            "admin": false,
+            "active": true,
+            "created": "2015-03-17T20:42:17.954885Z",
+            "modified": "2015-03-17T20:42:17.954885Z",
+            "token_expiry": "2015-04-17T20:42:17.954885Z",
+            "refresh_token_expiry": null
+        },
+        {
+            "id": 6535892,
+            "account": "someone-else@gmail.com",
+            "service": "egnyte",
+            "service_name": "Egnyte",
+            "admin": false,
+            "active": true,
+            "created": "2015-03-17T20:42:18.627533Z",
+            "modified": "2015-03-17T20:42:18.627533Z",
+            "token_expiry": "2015-04-17T20:42:18.627533Z",
+            "refresh_token_expiry": null
+        }
+      ]
+    }
+    JSON
+
+    Kloudless.http.expect(:get, returns: json, args: ["/accounts", {params: {}}]) do
+      accounts = Kloudless::Account.list
+      assert_kind_of Kloudless::Collection, accounts
+      assert_kind_of Kloudless::Account, accounts.first
+    end
+  end
+
+  def test_import_account
+    attributes = {
+      account: "someone@gmail.com",
+      service: "copy",
+      token: "foo",
+      token_secret: "bar"
+    }
+    Kloudless.http.expect(:post, args: ["/accounts", {params: attributes}]) do
+      Kloudless::Account.import(attributes)
+    end
+  end
+
+  def test_retrieve_account
+    Kloudless.http.expect(:get, args: ["/accounts/1", {params: {active: false}}]) do
+      account = Kloudless::Account.retrieve(account_id: 1, active: false)
+      assert_kind_of Kloudless::Account, account
+    end
+  end
+
+  def test_update_account
+    Kloudless.http.expect(:patch, args: ["/accounts/1", {params: {active: true}}]) do
+      account = Kloudless::Account.update(account_id: 1, active: true)
+      assert_kind_of Kloudless::Account, account
+    end
+  end
+
+  def test_delete_account
+    Kloudless.http.expect(:delete, args: ["/accounts/1"]) do
+      account = Kloudless::Account.delete(account_id: 1)
+      assert_kind_of Kloudless::Account, account
+    end
+  end
+end