jira_client 1.0.0

data/spec/fixtures/issues.json

@@ -0,0 +1,28 @@
+{
+  "expand": "schema,names",
+  "startAt": 0,
+  "maxResults": 50,
+  "total": 2,
+  "issues": [
+    {
+      "expand": "editmeta,renderedFields,transitions,changelog,operations",
+      "id": "10100",
+      "self": "http://localhost:2990/jira/rest/api/2/issue/10100",
+      "key": "TEST-2",
+      "fields": {
+        "summary": "Something doesnt work",
+        "description": null
+      }
+    },
+    {
+      "expand": "editmeta,renderedFields,transitions,changelog,operations",
+      "id": "10000",
+      "self": "http://localhost:2990/jira/rest/api/2/issue/10000",
+      "key": "TEST-1",
+      "fields": {
+        "summary": "Testing new feature",
+        "description": null
+      }
+    }
+  ]
+}

data/spec/fixtures/my_certificate.pem

@@ -0,0 +1,52 @@
+-----BEGIN RSA PRIVATE KEY-----
+Proc-Type: 4,ENCRYPTED
+DEK-Info: DES-EDE3-CBC,39EDD4C0F9F5B97D
+
+ar3c/LrtleaNgO17p+SN3zH30VSCXm4Lg5CNBcnMceWjgVQo3zHnyyxvKZ+zRvT0
+wZPEpCOG4vZ0j8UUeNrPxZKX2uioNhPYEkhR0N+W57ukzJafQy3TptVmTHkk/t5Y
+9f88fMgyLoFh+xBuD0iYOv8wp/V9UEFuLTIXExVyGV5Rqv+maKpfYVgIx185qwDE
+S2gYNEaJBJKu0TOpwO2iLRq2xC2cULJAH5rBlAcVlcX+/MHOa86Yd5WM6/5NJxfG
+psx0dQj7nZBbjjfzKGUSN230qd3/jwsfuvekHtjvNzERBelqMrpqeLiTI4aCYdpz
+7vP066/CCLB6k4Zm5rQXID50arDQWfgCMSsBFPZfPHZhshCbHA/IRQg3HWBzSgzP
+zsIUoTw4carUnaT8KAiooqSY+6iaZFk0gacV6Ax0TRUXc9GtqQ1bRoi58lOkEWjm
+wyB4xRqSGC7k0wiFGZKSTQSHFkQpy5imSy8XV5yAWxgniFb5zsX0WWvg4FR+wR+h
+2cYPZuXX4qyFZ8YoeQM5aP0XtrXaSlpWLTrqwIJFQvI/w1MPOj+CI4vZP133UME9
+Wvog46Yyka4VCFEmvSQvz2OjbSehNrDFIlb2tNhA8VQZ/H3XCm/xmmSm+4ssy1hc
+ELoJXFickj+ILK9/Ppw7BhvE19N6ZxAAj7zH6PyEdAKtAHdWxOS2qe/+IpEyxTFr
+XWzhhFRuCixUThVWPwimW1lm5BZ9/IwyeLhbP8jtuwm6lC0DqP/ui4LLzMeinJIY
+uAzm5tO3ioAlijAUPwgLQuJmZt1hJ994uyAGt0IbdR75QKfFVk3KY07Fci/YV/VX
+tRlMPtsmVD2uJONpEPwsXZCoOFepU9nuL3woosOHkqbL/EYGbMfP1c8Z696662fS
+gbTiH5hqTeOsWGylN0+SM+mneRk+czJQd9JwIF6gn225nbV0ymrA9RKE5ISDKrGN
+7Yi6WefdDxV3GgO2buFiFEXZiLq7lsYHnOqGRH/aM8apkK8Lt9FfecUDewfpnM10
+pX04U2Kb8iYbY68DPUDlpEmwc1qDS9xyY3n5Z9UiYqRpqdBuIuGnLZenx0LRUX16
+8t/83vc0AKtMDIb35/PLUltDJzPDIEqF6xF1KE7IRRp9a2Pv+a+4l2wse0aPfes6
+niI0cEoQAcxyt638T3h6kaWlmXqbM4XhEmFTEXe+24Au9rq2mf41mW1G5KKLupBA
+OEiHe0OsHF5pUeliVpewyHOYfee9bO8thS9HhiuAahSjMVbOaSSzBxcr4hgHlL7v
+qwnlfYD0Hd6bhEthLMCnMmFk0A9Y/2Hx7NVhJ1fdvcP/zVmYiJTdSNIFd2izXVn8
+obu4eFtzj0+cgIER1OM0ln5o2s5GlYFnG11lw7qruSTb9UGZptTaR0zeoIiwBjEn
+7j3gI3h86DGOT33/J1MKeLZtnkcpD023y4EBtvX8oH4hM8n9oNK6FO87OPeUks6d
+xCb1riGDc41+gnbKtmxreChuP4CeAG6RpLUdVL6oasy+5gyonWgr1a8OLuCKnHsq
+fe91FE4hvlAIX7V+mbMf3d0U0N3Rx2Pa74LY2aU+6b6sNqaMMAKlgQ==
+-----END RSA PRIVATE KEY-----
+-----BEGIN CERTIFICATE-----
+MIIDtTCCAp2gAwIBAgIJAPHGRV8yrekRMA0GCSqGSIb3DQEBBQUAMEUxCzAJBgNV
+BAYTAlVLMRMwEQYDVQQIEwpTb21lLVN0YXRlMSEwHwYDVQQKExhJbnRlcm5ldCBX
+aWRnaXRzIFB0eSBMdGQwHhcNMTMwNTA3MDY0MDEzWhcNMTMwNjA2MDY0MDEzWjBF
+MQswCQYDVQQGEwJVSzETMBEGA1UECBMKU29tZS1TdGF0ZTEhMB8GA1UEChMYSW50
+ZXJuZXQgV2lkZ2l0cyBQdHkgTHRkMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB
+CgKCAQEAuGHmEDYI0bL3ctMjHPS99QMyE3h8luzcNEDvyLo/cIsYHscs4x10wTwC
+opzUWLEie0FNFNEPDIhZ1JqalbivTGJmynQ3bQK0RjL0zKeE6cY5z5ie7SmpLED/
+6ftvPq6HiJCt3X/dCpax+HUYyAIyEJWbxD2IM5ma53rUBXswyfc/bSmGswmIlv0U
+p5EY10YnQ4n9JUhztl9dP7ag5g3eaZ/1g79OtodUF6mz8TcgTh16Oi7XcNWbYS+T
+FPOyKKxMFc9HubFhQZ9IZIzIrIDunynre6gPjow+Zdq66NIXVjPtMhYDx50vnYGF
+4TOhlHGDXfDMaJsl3yKviJZNMz/p2QIDAQABo4GnMIGkMB0GA1UdDgQWBBSQeSrx
+MLciO7Uv9HLZfqORHEckezB1BgNVHSMEbjBsgBSQeSrxMLciO7Uv9HLZfqORHEck
+e6FJpEcwRTELMAkGA1UEBhMCVUsxEzARBgNVBAgTClNvbWUtU3RhdGUxITAfBgNV
+BAoTGEludGVybmV0IFdpZGdpdHMgUHR5IEx0ZIIJAPHGRV8yrekRMAwGA1UdEwQF
+MAMBAf8wDQYJKoZIhvcNAQEFBQADggEBAAf2SjiQXa+0xwdi1Tvr0/UqJevg4/aO
+lUBWE06DEB8K4QFQpVdRIA/V2kwN+pEJLloMfgmHpjNLIF22USKE3tfWOS1GfFnD
+ouonv+ULZBFBA3y3pCoRr8+MnJX+8DxxjzauD48EhfCABoaQ5et5QHQEbMXoyjUg
+1NXwnpT3onmH8M9sFa+uImzXDNxzBd/bD1qjRDLsfAsGixUhttiR+u2WOioiIhEL
+Nc5QwA7NGBhHVzFyULB5p+C1JoLdzCrE4VJjTnmgaPWM84VdiX8GLzv9SXsQBXwH
+lfyM/BGfrFznxRaJ4lYOeHbhk46VJqgPEyDHwHOJnI+B1aAs52Ia9tY=
+-----END CERTIFICATE-----

data/spec/fixtures/no_issues_found.json

@@ -0,0 +1,6 @@
+{
+  "startAt": 0,
+  "maxResults": 50,
+  "total": 0,
+  "issues": []
+}

data/spec/fixtures/project.json

@@ -0,0 +1,10 @@
+{
+    "self": "http://www.example.com/jira/rest/api/2/project/ABC",
+    "id": "10001",
+    "key": "ABC",
+    "name": "Alphabetical",
+    "avatarUrls": {
+        "16x16": "http://www.example.com/jira/secure/projectavatar?size=small&pid=10001",
+        "48x48": "http://www.example.com/jira/secure/projectavatar?size=large&pid=10001"
+    }
+}

data/spec/fixtures/projects.json

@@ -0,0 +1,22 @@
+[
+    {
+        "self": "http://www.example.com/jira/rest/api/2/project/EX",
+        "id": "10000",
+        "key": "EX",
+        "name": "Example",
+        "avatarUrls": {
+            "16x16": "http://www.example.com/jira/secure/projectavatar?size=small&pid=10000",
+            "48x48": "http://www.example.com/jira/secure/projectavatar?size=large&pid=10000"
+        }
+    },
+    {
+        "self": "http://www.example.com/jira/rest/api/2/project/ABC",
+        "id": "10001",
+        "key": "ABC",
+        "name": "Alphabetical",
+        "avatarUrls": {
+            "16x16": "http://www.example.com/jira/secure/projectavatar?size=small&pid=10001",
+            "48x48": "http://www.example.com/jira/secure/projectavatar?size=large&pid=10001"
+        }
+    }
+]

data/spec/fixtures/server_info.json

@@ -0,0 +1,14 @@
+{
+  "baseUrl": "https://example.jira.com",
+  "version": "5.1.8",
+  "versionNumbers": [
+    5,
+    1,
+    8
+  ],
+  "buildNumber": 787,
+  "buildDate": "2012-10-29T00:00:00.000+0000",
+  "serverTime": "2013-04-24T22:01:45.802+0100",
+  "scmInfo": "823790ce17da57e7ed0220e49723c7b00a6d54dc",
+  "serverTitle": "Example JIRA"
+}

data/spec/fixtures/status.json

@@ -0,0 +1,7 @@
+{
+    "self": "http://localhost:8090/jira/rest/api/2.0/status/10000",
+    "description": "The issue is currently being worked on.",
+    "iconUrl": "http://localhost:8090/jira/images/icons/progress.gif",
+    "name": "In Progress",
+    "id": "10000"
+}

data/spec/fixtures/statuses.json

@@ -0,0 +1,16 @@
+[
+    {
+        "self": "http://localhost:8090/jira/rest/api/2.0/status/10000",
+        "description": "The issue is currently being worked on.",
+        "iconUrl": "http://localhost:8090/jira/images/icons/progress.gif",
+        "name": "In Progress",
+        "id": "10000"
+    },
+    {
+        "self": "http://localhost:8090/jira/rest/api/2.0/status/5",
+        "description": "The issue is closed.",
+        "iconUrl": "http://localhost:8090/jira/images/icons/closed.gif",
+        "name": "Closed",
+        "id": "5"
+    }
+]

data/spec/fixtures/user_doesnt_exist.json

@@ -0,0 +1,6 @@
+{
+  "errorMessages": [
+    "The user named 'doesnt_exist' does not exist"
+  ],
+  "errors": {}
+}

data/spec/fixtures/users.json

@@ -0,0 +1,22 @@
+[
+    {
+        "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
+        "name": "fred",
+        "avatarUrls": {
+            "16x16": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
+            "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred"
+        },
+        "displayName": "Fred F. User",
+        "active": false
+    },
+    {
+        "self": "http://www.example.com/jira/rest/api/2/user?username=andrew",
+        "name": "andrew",
+        "avatarUrls": {
+            "16x16": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=andrew",
+            "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=andrew"
+        },
+        "displayName": "Andrew Anderson",
+        "active": false
+    }
+]

data/spec/fixtures/worklog.json

@@ -0,0 +1,31 @@
+{
+    "startAt": 0,
+    "maxResults": 1,
+    "total": 1,
+    "worklogs": [
+        {
+            "self": "http://www.example.com/jira/rest/api/2.0/issue/10010/worklog/10000",
+            "author": {
+                "self": "http://www.example.com/jira/rest/api/2.0/user?username=fred",
+                "name": "fred",
+                "displayName": "Fred F. User",
+                "active": false
+            },
+            "updateAuthor": {
+                "self": "http://www.example.com/jira/rest/api/2.0/user?username=fred",
+                "name": "fred",
+                "displayName": "Fred F. User",
+                "active": false
+            },
+            "comment": "I did some work here.",
+            "started": "2012-02-15T17:34:37.937-0600",
+            "timeSpent": "3h 20m",
+            "timeSpentSeconds": 12000,
+            "id": "100028",
+            "visibility": {
+                "type": "group",
+                "value": "jira-developers"
+            }
+        }
+    ]
+}

data/spec/jira_client/api/comments_spec.rb

@@ -0,0 +1,59 @@
+require "spec_helper"
+
+describe JiraClient::API::Comments do
+
+  describe "#find_issue_comments" do
+
+    before do
+      stub_get("/issue/PROJECT-1234/comment").to_return(:body => fixture("comments.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      @comments = JiraClient.find_issue_comments "PROJECT-1234"
+    end
+
+    it "requests the correct resource" do
+      expect(a_get("/issue/PROJECT-1234/comment")).to have_been_made
+    end
+    it "returns an array of JiraClient::Comment objects" do
+      @comments.should be_a_kind_of Array
+      @comments.each do |comment|
+        comment.should be_a_kind_of JiraClient::Comment
+      end
+    end
+    it "assigns the correct information" do
+      comment = @comments.first
+      comment.body.should == "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper."
+      comment.author.should be_a_kind_of JiraClient::User
+      comment.update_author.should be_a_kind_of JiraClient::User
+      comment.created.should be_a_kind_of DateTime
+      comment.updated.should be_a_kind_of DateTime
+    end
+  end
+
+  describe "#comment_on_issue" do
+
+    before do
+      stub_post("/issue/PROJECT-1234/comment").with(:body => {"body" => "This is a comment"}).to_return(:status => 201, :body => fixture("comment.json"))
+      @comment = JiraClient.comment_on_issue("PROJECT-1234", "This is a comment")
+    end
+
+    it "requests the correct resource" do
+      expect(a_post("/issue/PROJECT-1234/comment").with(:body => {:body => "This is a comment"})).to have_been_made
+    end
+    it "returns the comment object" do
+      @comment.should be_a_kind_of JiraClient::Comment
+    end
+    it "with the comment text set on the comment object" do
+      @comment.body.should == "This is a comment"
+    end
+    context "without a comment body" do
+
+      before do
+        stub_post("/issue/PROJECT-1234/comment").to_return(:status => 400, :body => fixture("invalid_comment.json"))
+      end
+
+      it "raises a JiraClient::Error::BadRequest" do
+        expect { JiraClient.comment_on_issue("PROJECT-1234", "") }.to raise_error(JiraClient::Error::BadRequest)
+      end
+    end
+  end
+
+end

data/spec/jira_client/api/issues_spec.rb

@@ -0,0 +1,314 @@
+require "spec_helper"
+
+describe JiraClient::API::Issues do
+
+  describe "#find_issue_by_key" do
+    context "with no extra data" do
+
+      before do
+        stub_get("/issue/PROJECT-1234").to_return(:body => fixture('basic_issue.json'), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+
+      it "requests the correct resource" do
+        JiraClient.find_issue_by_key("PROJECT-1234")
+        expect(a_get("/issue/PROJECT-1234")).to have_been_made
+      end
+      it "returns a JiraClient::Issue object" do
+        issue = JiraClient.find_issue_by_key("PROJECT-1234")
+        expect(issue).to be_a_kind_of JiraClient::Issue
+      end
+      it "sets the correct attributes" do
+        issue = JiraClient.find_issue_by_key("PROJECT-1234")
+        expect(issue.key).to eq("PROJECT-1234")
+      end
+    end
+    context "with summary and description" do
+
+      before do
+        stub_get("/issue/PROJECT-1235").with(:query => {:fields => "summary,description"}).to_return(:body => fixture('issue_with_description.json'), :headers => {:content_type => "application/json; charset=utf-8"})
+        @issue = JiraClient.find_issue_by_key("PROJECT-1235", :fields => [:summary, :description])
+      end
+
+      it "requests the correct resource" do
+        expect(a_get("/issue/PROJECT-1235?fields=summary,description")).to have_been_made
+      end
+      it "sets the correct attributes" do
+        expect(@issue.key).to eq("PROJECT-1235")
+        expect(@issue.summary?).to be_true
+        expect(@issue.description?).to be_true
+        expect(@issue.summary).to eq("This is an issue summary")
+        expect(@issue.description).to eq("This is a description")
+      end
+    end
+    context "with a status" do
+
+      before do
+        stub_get("/issue/PROJECT-1236").with(:query => {:fields => "status"}).to_return(:body => fixture("issue_with_status.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        @issue = JiraClient.find_issue_by_key("PROJECT-1236", :fields => [:status])
+      end
+
+      it "requests the correct resource" do
+        expect(a_get("/issue/PROJECT-1236?fields=status")).to have_been_made
+      end
+      it "sets the correct attributes" do
+        expect(@issue.key).to eq("PROJECT-1236")
+        expect(@issue.status?).to be_true
+        expect(@issue.status).to be_a_kind_of JiraClient::Status
+      end
+    end
+    context "with timetracking" do
+
+      before do
+        stub_get("/issue/PROJECT-1234").with(:query => {:fields => "timetracking"}).to_return(:body => fixture("issue_with_timetracking.json"))
+        @issue = JiraClient.find_issue_by_key("PROJECT-1234", :fields => [:timetracking])
+      end
+
+      it "requests the correct resource" do
+        expect(a_get("/issue/PROJECT-1234?fields=timetracking")).to have_been_made
+      end
+      it "returns a timetracking object" do
+        expect(@issue.timetracking).to be_a_kind_of JiraClient::Timetracking
+      end
+    end
+    context "with worklogs" do
+
+      before do
+        stub_get("/issue/PROJECT-1234").with(:query => {:fields => "worklog"}).to_return(:body => fixture("issue_with_worklogs.json"))
+        @issue = JiraClient.find_issue_by_key("PROJECT-1234", :fields => [:worklog])
+      end
+
+      it "requests the correct resource" do
+        expect(a_get("/issue/PROJECT-1234?fields=worklog")).to have_been_made
+      end
+      it "returns an array of worklog items" do
+        @issue.worklog.should be_a_kind_of Array
+        @issue.worklog.each do |worklog|
+          worklog.should be_a_kind_of JiraClient::Worklog
+          worklog.author.should be_a_kind_of JiraClient::User
+        end
+      end
+    end
+    context "with comments" do
+
+      before do
+        stub_get("/issue/PROJECT-1234").with(:query => {:fields => "comment"}).to_return(:body => fixture("issue_with_comments.json"))
+        @issue = JiraClient.find_issue_by_key("PROJECT-1234", :fields => [:comment])
+      end
+
+      it "requests the correct resource" do
+        expect(a_get("/issue/PROJECT-1234?fields=comment")).to have_been_made
+      end
+      it "returns an array of comment objects" do
+        @issue.comment.should be_a_kind_of Array
+        @issue.comment.each do |comment|
+          comment.should be_a_kind_of JiraClient::Comment
+        end
+      end
+    end
+  end
+
+  describe "#assign_issue" do
+
+    before do
+      stub_put("/issue/PROJECT-1234/assignee").with(:body => {"name" => "testuser"}).to_return(:status => 204)
+      JiraClient.assign_issue("PROJECT-1234", "testuser")
+    end
+
+    it "requests the correct resource" do
+      expect(a_put("/issue/PROJECT-1234/assignee")).to have_been_made
+    end
+    context "with invalid username" do
+
+      before do
+        stub_put("/issue/PROJECT-1234/assignee").with(:body => {"name" => "invalid_user"}).to_return(:status => 400, :body => fixture("invalid_assignee.json"))
+      end
+
+      it "raises a JiraClient::Error::BadRequest error" do
+        expect { JiraClient.assign_issue("PROJECT-1234", "invalid_user") }.to raise_error(JiraClient::Error::BadRequest)
+      end
+    end
+    context "with invalid permissions" do
+
+      before do
+        stub_put("/issue/PROJECT-1234/assignee").with(:body => {"name" => "insufficient_permission_user"}).to_return(:status => 401, :body => fixture("invalid_assignee.json"))
+      end
+
+      it "raises JiraClient::Error::Unauthorized" do
+        expect { JiraClient.assign_issue("PROJECT-1234", "insufficient_permission_user") }.to raise_error(JiraClient::Error::Unauthorized)
+      end
+    end
+    context "with an issue that doesnt exist" do
+
+      before do
+        stub_put("/issue/NOEXIST/assignee").with(:body => {"name" => "admin"}).to_return(:status => 404, :body => fixture("invalid_assignee.json"))
+      end
+
+      it "raises JiraClient::Error::ResourceNotFound" do
+        expect { JiraClient.assign_issue("NOEXIST", "admin") }.to raise_error(JiraClient::Error::ResourceNotFound)
+      end
+    end
+    context "with a user that doesnt exist" do
+
+      before do
+        stub_put("/issue/PROJECT-1234/assignee").with(:body => {"name" => "no_exist_user"}).to_return(:status => 404, :body => fixture("invalid_assignee.json"))
+      end
+
+      it "raises JiraClient::Error::ResourceNotFound" do
+        expect { JiraClient.assign_issue("PROJECT-1234", "no_exist_user") }.to raise_error(JiraClient::Error::ResourceNotFound)
+      end
+    end
+  end
+
+  describe "#resolve_issue" do
+
+    before do
+      stub_post("/issue/PROJECT-1234/transitions").to_return(:status => 204)
+    end
+
+    it "sends data to the correct resource" do
+      JiraClient.resolve_issue "PROJECT-1234"
+      expect(a_post('/issue/PROJECT-1234/transitions')).to have_been_made
+    end
+    it "sends the correct transition ID" do
+      JiraClient.resolve_issue "PROJECT-1234"
+      expect(a_post('/issue/PROJECT-1234/transitions').with(:body => transition_to(JiraClient::Status::RESOLVE))).to have_been_made
+    end
+    it "sends the resolution if provided" do
+      JiraClient.resolve_issue "PROJECT-1234", :as => "Won't Fix"
+      expect(a_post('/issue/PROJECT-1234/transitions').with(:body => transition_to(JiraClient::Status::RESOLVE, :resolution => "Won't Fix"))).to have_been_made
+    end
+    it "sends a comment if provided" do
+      JiraClient.resolve_issue "PROJECT-1234", :comment => "This is a comment"
+      expect(a_post('/issue/PROJECT-1234/transitions').with(:body => transition_to(JiraClient::Status::RESOLVE, :comment => "This is a comment"))).to have_been_made
+    end
+    it "sends both a comment and a resolution if provided" do
+      JiraClient.resolve_issue "PROJECT-1234", :as => "Can't Reproduce", :comment => "This is a comment"
+      expect(a_post('/issue/PROJECT-1234/transitions').with(:body => transition_to(JiraClient::Status::RESOLVE, :comment => "This is a comment", :resolution => "Can't Reproduce"))).to have_been_made
+    end
+  end
+
+  describe "#close_issue" do
+
+    before do
+      stub_post("/issue/PROJECT-1234/transitions").to_return(:status => 204)
+    end
+
+    it "sends data to the correct resource" do
+      JiraClient.close_issue "PROJECT-1234"
+      expect(a_post('/issue/PROJECT-1234/transitions')).to have_been_made
+    end
+    it "sends the correct transition ID" do
+      JiraClient.close_issue "PROJECT-1234"
+      expect(a_post('/issue/PROJECT-1234/transitions').with(:body => transition_to(JiraClient::Status::CLOSE))).to have_been_made
+    end
+    it "sends a comment if provided" do
+      JiraClient.close_issue "PROJECT-1234", :comment => "This is a comment"
+      expect(a_post('/issue/PROJECT-1234/transitions').with(:body => transition_to(JiraClient::Status::CLOSE, :comment => "This is a comment"))).to have_been_made
+    end
+  end
+
+  describe "#reopen_issue" do
+
+    before do
+      stub_post("/issue/PROJECT-1234/transitions").to_return(:status => 204)
+    end
+
+    it "sends data to the correct resource" do
+      JiraClient.reopen_issue "PROJECT-1234"
+      expect(a_post('/issue/PROJECT-1234/transitions')).to have_been_made
+    end
+    it "sends the correct transition ID" do
+      JiraClient.reopen_issue "PROJECT-1234"
+      expect(a_post('/issue/PROJECT-1234/transitions').with(:body => transition_to(JiraClient::Status::REOPEN))).to have_been_made
+    end
+    it "sends a comment if provided" do
+      JiraClient.reopen_issue "PROJECT-1234", :comment => "This is a comment"
+      expect(a_post('/issue/PROJECT-1234/transitions').with(:body => transition_to(JiraClient::Status::REOPEN, :comment => "This is a comment"))).to have_been_made
+    end
+  end
+
+  describe "#start_progress_on_issue" do
+
+    before do
+      stub_post("/issue/PROJECT-1234/transitions").to_return(:status => 204)
+    end
+
+    it "sends data to the correct resource" do
+      JiraClient.start_progress_on_issue "PROJECT-1234"
+      expect(a_post('/issue/PROJECT-1234/transitions')).to have_been_made
+    end
+    it "sends the correct transition ID (6)" do
+      JiraClient.start_progress_on_issue "PROJECT-1234"
+      expect(a_post('/issue/PROJECT-1234/transitions').with(:body => transition_to(JiraClient::Status::START_PROGRESS))).to have_been_made
+    end
+    it "sends a comment if provided" do
+      JiraClient.start_progress_on_issue "PROJECT-1234", :comment => "This is a comment"
+      expect(a_post('/issue/PROJECT-1234/transitions').with(:body => transition_to(JiraClient::Status::START_PROGRESS, :comment => "This is a comment"))).to have_been_made
+    end
+  end
+
+  describe "#find_issues" do
+
+    before do
+      stub_post("/search").with(:body => {:jql => "project = TEST"}).to_return(:status => 200, :body => fixture("issues.json"))
+      @issues = JiraClient.find_issues(:jql => "project = TEST")
+    end
+
+    it "requests the correct resource" do
+      expect(a_post("/search").with(:body => {"jql" => "project = TEST"})).to have_been_made
+    end
+    it "accepts an array of fields to be returned" do
+      stub_post("/search").with(:body => {:fields => ["summary", "description"]}).to_return(:status => 200, :body => fixture("issues.json"))
+      @issues = JiraClient.find_issues(:fields => [:summary, :description])
+      expect(a_post("/search").with(:body => {:fields => ["summary", "description"]})).to have_been_made
+    end
+    it "returns an array of issue objects" do
+      @issues.should be_a_kind_of Array
+      @issues.each do |issue|
+        issue.should be_a_kind_of JiraClient::Issue
+      end
+    end
+    context "when there are no results" do
+
+      before do
+        stub_post("/search").with(:body => {:jql => "project = TEST and status = 'In Progress'"}).to_return(:status => 200, :body => fixture("no_issues_found.json"))
+      end
+
+      it "returns an empty array" do
+        @issues = JiraClient.find_issues(:jql => "project = TEST and status = 'In Progress'")
+        @issues.should be_a_kind_of Array
+        @issues.should be_empty
+      end
+    end
+    context "when there is a problem with the JQL" do
+
+      before do
+        stub_post("/search").with(:body => {:jql => "project = DOESNT_EXIST"}).to_return(:status => 400, :body => fixture("invalid_jql.json"))
+      end
+
+      it "raises a bad request error" do
+        expect { JiraClient.find_issues(:jql => "project = DOESNT_EXIST") }.to raise_error(JiraClient::Error::BadRequest)
+      end
+      it "hints at the problem with the jql" do
+        begin
+          JiraClient.find_issues(:jql => "project = DOESNT_EXIST")
+        rescue JiraClient::Error::BadRequest => e
+          e.message.should include "project"
+          e.message.should include "DOESNT_EXIST"
+          e.message.should include "does not exist"
+        end
+      end
+    end
+
+  end
+
+private
+
+  def transition_to(id, opts = {})
+    body = {"transition" => {"id" => id}}
+    body["update"] = {"comment" => [{"add" => {"body" => opts[:comment]}}]} if opts.has_key? :comment
+    body["fields"] = {"resolution" => {"name" => opts[:resolution]}} if opts.has_key? :resolution
+    body
+  end
+
+end