clubhouse_ruby 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 99130661e8bef360cc89dc809b212764a013ed45
-  data.tar.gz: 398600d53686e920fb38f95cd54955b000af0006
+  metadata.gz: fd8a31fc213799a4c32148450916cff148edac46
+  data.tar.gz: 2371dce1a6e09504a6880b6fb41f1f87825c28fc
 SHA512:
-  metadata.gz: 2dcdc681c343e90ecebc0def690f3307d607ecf1ca38806aa696b2e4882a6801e869021682fde9ce656bacec5097dda58069ec63ef803c659a642751508afb0d
-  data.tar.gz: 5502abcfcd208946601679d9125e2789b0645b22c104c688936d90aacb3a00cabb7c1558a82207a335cd38debcf048bf5330b22ac6ec82694f76add07d4e5eff
+  metadata.gz: dfbd67e65e330094531a4c7652e42e774557126b7bf486de3e37d285d4d75d6147c88ea725736030dd7cc8c73a2caa4ee23cd036022a3fcd6e3453ea426acd6e
+  data.tar.gz: 6666f1370c5b9491a172cf60fd8760dbd53658e7f4613b7fd2b6309a7b6f5809235a489c94f10161342f0f40f204d9f5d202b2ce596986aa566701463f5d586c

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2016 Philip Castiglione
+Copyright (c) 2017 Philip Castiglione
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,7 +1,7 @@
 # ClubhouseRuby
 
 ClubhouseRuby is a lightweight Ruby wrapper of the
-[Clubhouse API](https://clubhouse.io/api/v1/).
+[Clubhouse REST API](https://clubhouse.io/api/rest/v2/).
 
 [Clubhouse](https://clubhouse.io) is a radical project management tool
 particularly well suited to software development. If you're not familiar with
@@ -30,7 +30,7 @@ And then execute:
 
     $ bundle
 
-Or install it yourself as:
+Or install it globally:
 
     $ gem install clubhouse_ruby
 
@@ -41,7 +41,7 @@ operates as an effective turing machine when lubricated with oil.
 ## Usage
 
 This gem is a lightweight API wrapper. That means you'll need to refer to the
-[API documentation](https://clubhouse.io/api/v1/) to figure out what resources
+[API documentation](https://clubhouse.io/api/rest/v2/) to figure out what resources
  and actions exist.
 
 On the plus side, once you know what you want to do, using this gem should be 
@@ -70,21 +70,33 @@ clubhouse.epics.list
 #   code: "200",
 #   status: "OK",
 #   content: [
-#     {
-#       "id" => 1,
-#       "name" => "An Odyssian Epic",
-#       "description" => "Outrageously epic.",
-#       "created_at" => "...",
-#       "updated_at" => "...",
-#       "deadline "=> nil,
-#       "state" => "to do",
-#       "position" => 1,
-#       "archived" => false,
-#       "follower_ids" => [...],
-#       "owner_ids" => [...],
-#       "comments" => [...]
-#      }
-#    ]
+#    {
+#      "entity_type" => "epic",
+#      "id" => 1,
+#      "external_id" => nil,
+#      "name" => "An Odyssian Epic",
+#      "description" => "Outrageously epic.",
+#      "created_at" => "...",
+#      "updated_at" => "...",
+#      "deadline "=> nil,
+#      "state" => "to do",
+#      "position" => 1,
+#      "started" => false,
+#      "started_at" => nil,
+#      "started_at_override" => nil,
+#      "completed" => false,
+#      "completed_at" => nil,
+#      "completed_at_override" => nil,
+#      "archived" => false,
+#      "labels" => [...],
+#      "milestone_id" => nil,
+#      "follower_ids" => [...],
+#      "owner_ids" => [...],
+#      "project_ids" => [...],
+#      "comments" => [...],
+#      "stats" => {...},
+#     }, ...
+#   ]
 # }
 ```
 
@@ -97,18 +109,12 @@ clubhouse.epics.create(name: "My New Epic", state: "to do")
 #   code: "201",
 #   status: "Created",
 #   content: {
+#     "entity_type" => "epic",
 #     "id" => 2,
+#     "extenal_id" => nil,
 #     "name" => "My New Epic",
 #     "description" => "",
-#     "created_at" => "...",
-#     "updated_at" => "...",
-#     "deadline" => nil,
-#     "state" => "to do",
-#     "position" => 2,
-#     "archived" => false,
-#     "follower_ids" => [],
-#     "owner_ids" => [],
-#     "comments" => []
+#     ...
 #   }
 # }
 ```
@@ -125,38 +131,18 @@ clubhouse.projects(<project_id>).stories.list
 #   status: "OK",
 #   content: [
 #     {
+#       "entity_type" => "story",
 #       "archived" => false,
 #       "created_at" => "...",
+#       "updated_at" => "...",
 #       "id" => 1,
+#       "external_id" => nil,
 #       "name" => "Rescue Prince",
 #       "story_type" => "feature",
 #       "description" => "The prince is trapped in a tower and needs freeing.",
 #       "position" => 1,
-#       "workflow_state_id" => "...",
-#       "estimate" => 0,
-#       "updated_at" => "...",
-#       "deadline" => nil,
-#       "project_id" => <project_id>,
-#       "labels" => [
-#         {
-#           "id" => "...",
-#           "name" => "Urgent",
-#           "created_at" => "...",
-#           "updated_at" => "..."
-#         }
-#       ],
-#       "requested_by_id" => "...",
-#       "owner_ids" => [...],
-#       "follower_ids" => [...],
-#       "epic_id" => "...",
-#       "file_ids" => [...],
-#       "linked_file_ids" => [...],
-#       "comments" => [...],
-#       "tasks" => [...],
-#       "story_links" => [...]
-#     },
-#     {...},
-#     {...}
+#       ...
+#     }, ...
 #   ]
 # }
 ```
@@ -209,21 +195,21 @@ clubhouse.epics.list
 ```
 
 Arbitrary combinations of resources not building a path that matches a url the
-API knows about will fail. Note the clubhouse API gives little away, returning
-forbidden:
+API knows about will fail.
 
 ```ruby
 clubhouse.epics(epic_id).stories.list
 # => {
-#   code: "403",
-#   status: "Forbidden",
+#   code: "404",
+#   status: "Not Found",
 #   content: {
-#     "message" => "Sorry, you do not have access to this resource.",
-#     "tag" => "user_denied_access"
+#     "message" => "Page not Found"
 #   }
 # }
 ```
 
+Note: the v1 API returns forbidden rather than not found.
+
 Attempting to access a nested resource without providing the parent id as an
 argument is a bad request:
 
@@ -246,6 +232,12 @@ clubhouse.projects.stories.list
 # }
 ```
 
+## Version
+
+The currenet version of the clubhouse_ruby gem supports the current version of
+the API, version 2. If you want something that definitely works with v1, use
+version 0.2.0 of clubhouse_ruby.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies and

data/clubhouse_ruby.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |spec|
   spec.authors       = ["Philip Castiglione"]
   spec.email         = ["philipcastiglione@gmail.com"]
 
-  spec.summary       = %q{A lightweight ruby wrapper for the Clubhouse API: https://clubhouse.io/api/v1}
+  spec.summary       = %q{A lightweight Ruby wrapper for the Clubhouse REST API.}
   spec.homepage      = "https://github.com/PhilipCastiglione/clubhouse_ruby"
   spec.license       = "MIT"
 

data/lib/clubhouse_ruby/constants.rb

@@ -2,7 +2,7 @@ require 'json'
 require 'csv'
 
 module ClubhouseRuby
-  API_URL = "https://api.clubhouse.io/api/v1/".freeze
+  API_URL = "https://api.clubhouse.io/api/v2/".freeze
 
   # Response formats the clubhouse api knows about
   FORMATS = {
@@ -27,25 +27,23 @@ module ClubhouseRuby
 
   # These are the resource for the clubhouse api and can form part of the path
   RESOURCES = [
+    :categories,
     :epics,
     :files,
     :labels,
     :linked_files,
+    :members,
+    :milestones,
     :projects,
-    :story_links,
+    :repositories,
     :stories,
-    :tasks,
-    :comments,
-    :users,
+    :story_links,
+    :teams,
     :workflows
   ].freeze
 
   # These are the annoying edge cases in the clubhouse api that are don't fit
   EXCEPTIONS = {
-    search: {
-      path: :search,
-      action: :Post
-    },
     bulk_create: {
       path: :bulk,
       action: :Post

data/lib/clubhouse_ruby/path_builder.rb

@@ -16,7 +16,7 @@ module ClubhouseRuby
     #
     # This example will execute a call to:
     #
-    # `https://api.clubhouse.io/api/v1/stories/{story-id}/comments/{comment-id}`
+    # `https://api.clubhouse.io/api/v2/stories/{story-id}/comments/{comment-id}`
     #
     # with arguments:
     #
@@ -50,9 +50,9 @@ module ClubhouseRuby
     # We'd better not lie when asked.
     #
     def respond_to_missing?(name, include_private = false)
-      ACTIONS.keys.include?(name) ||
-        RESOURCES.include?(name) ||
-        EXCEPTIONS.keys.include?(name) ||
+      known_action?(name) ||
+        known_resource?(name) ||
+        known_exception?(name) ||
         super
     end
 

data/lib/clubhouse_ruby/version.rb

@@ -1,3 +1,3 @@
 module ClubhouseRuby
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: clubhouse_ruby
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Philip Castiglione
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-10-25 00:00:00.000000000 Z
+date: 2017-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -136,8 +136,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.4
+rubygems_version: 2.6.8
 signing_key: 
 specification_version: 4
-summary: 'A lightweight ruby wrapper for the Clubhouse API: https://clubhouse.io/api/v1'
+summary: A lightweight Ruby wrapper for the Clubhouse REST API.
 test_files: []