Create a repository project

Sam Davies · Sam Davies · commit 03f8d5097182 · 2017-04-05T11:10:38.000+01:00
diff --git a/lib/github_api/client/orgs/projects.rb b/lib/github_api/client/orgs/projects.rb
@@ -22,9 +22,11 @@ class Client::Orgs::Projects < API
     #
     # @api public
     def list(*args)
-      arguments(args, required: [:org_name])
-
+      arguments(args, required: [:org_name]) do
+        permit %w[ state ]
+      end
       params = arguments.params
+
       params['options'] = OPTIONS
 
       response = get_request("/orgs/#{arguments.org_name}/projects", params)
diff --git a/lib/github_api/client/repos/projects.rb b/lib/github_api/client/repos/projects.rb
@@ -25,15 +25,40 @@ class Client::Repos::Projects < API
     #
     # @api public
     def list(*args)
-      arguments(args, required: [:owner, :repo])
-
+      arguments(args, required: [:owner, :repo]) do
+        permit %w[ state ]
+      end
       params = arguments.params
+
       params['options'] = OPTIONS
 
       response = get_request("/repos/#{arguments.owner}/#{arguments.repo}/projects", params)
       return response unless block_given?
       response.each { |el| yield el }
     end
     alias :all :list
+
+    # Create a new project for the specified repo
+    #
+    # @param [Hash] params
+    # @option params [String] :name
+    #   Required string - The name of the project.
+    # @option params [String] :body
+    #   Optional string - The body of the project.
+    #
+    # @example
+    #  github = Github.new
+    #  github.repos.create 'owner-name', 'repo-name', name: 'project-name'
+    #  github.repos.create name: 'project-name', body: 'project-body', owner: 'owner-name', repo: 'repo-name'
+    def create(*args)
+      arguments(args, required: [:owner, :repo]) do
+        permit %w[ body name ]
+        assert_required %w[ name ]
+      end
+      params = arguments.params
+      params['options'] = OPTIONS
+
+      post_request("/repos/#{arguments.owner}/#{arguments.repo}/projects", params)
+    end
   end # Projects
 end # Github
diff --git a/spec/github/client/repos/projects/create_spec.rb b/spec/github/client/repos/projects/create_spec.rb
@@ -0,0 +1,48 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Github::Client::Repos::Projects, '#create' do
+  let(:owner) { 'octocat' }
+  let(:repo) { 'api-playground' }
+  let(:inputs) do
+    {
+      :name => 'Projects Documentation',
+      :body => 'Developer documentation project for the developer site.'
+    }
+  end
+
+  before {
+    stub_post(request_path).with(body: inputs).
+      to_return(:body => body, :status => status,
+        :headers => {:content_type => "application/json; charset=utf-8"} )
+  }
+
+  context "resource created successfully" do
+    let(:body)   { fixture('repos/repo.json') }
+    let(:status) { 201 }
+
+    let(:request_path) { "/repos/#{owner}/#{repo}/projects" }
+
+    it "should fail to create resource if 'name' inputs is missing" do
+      expect {
+        subject.create owner, repo, inputs.except(:name)
+      }.to raise_error(Github::Error::RequiredParams)
+    end
+
+    it "should create resource" do
+      subject.create owner, repo, inputs
+      a_post(request_path).with(body: inputs).should have_been_made
+    end
+
+    it "should return the resource" do
+      repository = subject.create owner, repo, inputs
+      repository.name.should == 'Hello-World'
+    end
+
+    it "should return mash type" do
+      repository = subject.create owner, repo, inputs
+      repository.should be_a Github::ResponseWrapper
+    end
+  end
+end # create
