assembla_api 0.1.2

data/lib/assembla_api/client/spaces/space_tools/merge_requests.rb

@@ -0,0 +1,105 @@
+module Assembla
+  class Client::Spaces::SpaceTools::MergeRequests < API
+    require_all 'assembla_api/client/spaces/space_tools/merge_requests',
+      'versions'
+
+    namespace :versions
+    namespace :votes
+
+    VALID_PARAMS_NAMES = %w{
+      description
+      source_cleanup
+      source_symbol
+      target_space_tool_id
+      target_symbol
+      title
+    }
+
+    VALID_REQUEST_PARAM_VALUES = {
+      'source_cleanup' => [0, 1]
+    }
+
+    # @example
+    # api.spaces.space_tools.merge_requests.create 'project1', 'git',
+    #   merge_request: { title: 'Mobile App V2' }
+    def create(*args)
+      arguments(args, required: [:space, :space_tool]) do
+        permit VALID_PARAMS_NAMES, recursive: true
+        assert_required %w[ title source_symbol target_symbol ]
+        assert_values VALID_REQUEST_PARAM_VALUES
+      end
+
+      post_request api_uri(arguments), arguments.params
+    end
+
+    # @example
+    # api.spaces.space_tools.merge_requests.get 'project1', 'git', 7
+    def get(*args)
+      arguments(args, required: [:space, :space_tool, :id])
+      get_request api_uri(arguments), arguments.params
+    end
+
+    # @example
+    # api.spaces.space_tools.merge_requests.edit 'project1', 'git', 7,
+    #   merge_request: { description: 'in-production #tickets' }
+    def edit(*args)
+      arguments(args, required: [:space, :space_tool, :id]) do
+        permit VALID_PARAMS_NAMES , recursive: true
+        assert_values VALID_REQUEST_PARAM_VALUES
+      end
+
+      put_request api_uri(arguments), arguments.params
+    end
+
+    # Ignore merge request by ID
+    # @example
+    # api.spaces.space_tools.merge_requests.ignore 'project1', 'git', 7
+    def ignore(*args)
+      arguments(args, required: [:space, :space_tool, :id])
+      put_request api_uri(arguments, :ignore), arguments.params
+    end
+
+    # Merge MR by ID
+    # @example
+    # api.spaces.space_tools.merge_requests.merge 'project1', 'git', 7
+    def merge(*args)
+      arguments(args, required: [:space, :space_tool, :id])
+      put_request api_uri(arguments, :merge_and_close), arguments.params
+    end
+
+    # @example
+    # api.spaces.space_tools.space_tools.merge_requests.list 'project1', 'git'
+    def list(*args)
+      arguments(args, required: [:space, :space_tool])
+      response = get_request api_uri(arguments), arguments.params
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+
+    # @example
+    # api.spaces.space_tools.space_tools.merge_requests.tickets 'project1', 'git', 7
+    def tickets(*args)
+      arguments(args, required: [:space, :space_tool, :id])
+      response = get_request api_uri(arguments, :tickets), arguments.params
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+
+    # @example
+    # api.spaces.space_tools.space_tools.merge_requests.comments 'project1', 'git', 7
+    def comments(*args)
+      arguments(args, required: [:space, :space_tool, :id])
+      response = get_request api_uri(arguments, :comments), arguments.params
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+
+    private
+    def api_uri(arguments, method = nil)
+      uri = "/spaces/#{arguments.space}/space_tools/#{arguments.space_tool}/merge_requests"
+      uri += "/" + arguments['id'].to_s if arguments['id']
+      uri += "/" + method.to_s if method
+      uri
+    end
+  end
+end

data/lib/assembla_api/client/spaces/space_tools/merge_requests/versions.rb

@@ -0,0 +1,41 @@
+module Assembla
+  class Client::Spaces::SpaceTools::MergeRequests::Versions < API
+    require_all 'assembla_api/client/spaces/space_tools/merge_requests/versions',
+      'votes',
+      'comments'
+
+    namespace :comments
+
+    # @example
+    # api.spaces.space_tools.merge_requests.versions.create 'project1', 'git', 7
+    def create(*args)
+      arguments(args, required: [:space, :space_tool, :mr_id])
+
+      post_request api_uri(arguments), arguments.params
+    end
+
+    # @example
+    # api.spaces.space_tools.merge_requests.versions.get 'project1', 'git', 7, 571
+    def get(*args)
+      arguments(args, required: [:space, :space_tool, :mr_id, :id])
+      get_request api_uri(arguments), arguments.params
+    end
+
+    # @example
+    # api.spaces.space_tools.space_tools.merge_requests.versions.list 'project1', 'git', 571
+    def list(*args)
+      arguments(args, required: [:space, :space_tool, :mr_id])
+      response = get_request api_uri(arguments), arguments.params
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+
+    private
+    def api_uri(arguments, method = nil)
+      uri = "/spaces/#{arguments.space}/space_tools/#{arguments.space_tool}/merge_requests/#{arguments.mr_id}/versions"
+      uri += "/" + arguments['id'].to_s if arguments['id']
+      uri += "/" + method.to_s if method
+      uri
+    end
+  end
+end

data/lib/assembla_api/client/spaces/space_tools/merge_requests/versions/comments.rb

@@ -0,0 +1,34 @@
+module Assembla
+  class Client::Spaces::SpaceTools::MergeRequests::Versions::Comments < API
+
+    # @example
+    # api.spaces.space_tools.merge_requests.versions.comments.create 'project1', 'git', 571, 1,
+    #    content: 'Looks good to me'
+    def create(*args)
+      fields = %w[ content ]
+      arguments(args, required: [:space, :space_tool, :mr_id, :version]) do
+        permit fields
+        assert_required fields
+      end
+
+      post_request api_uri(arguments), arguments.params
+    end
+
+    # @example
+    # api.spaces.space_tools.space_tools.merge_requests.versions.list 'project1', 'git', 571, 1
+    def list(*args)
+      arguments(args, required: [:space, :space_tool, :mr_id, :version])
+      response = get_request api_uri(arguments), arguments.params
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+
+    private
+    def api_uri(arguments, method = nil)
+      uri = "/spaces/#{arguments.space}/space_tools/#{arguments.space_tool}/merge_requests/#{arguments.mr_id}/versions/#{arguments.version}/comments"
+      uri += "/" + arguments['id'].to_s if arguments['id']
+      uri += "/" + method.to_s if method
+      uri
+    end
+  end
+end

data/lib/assembla_api/client/spaces/space_tools/merge_requests/versions/votes.rb

@@ -0,0 +1,46 @@
+module Assembla
+  class Client::Spaces::SpaceTools::MergeRequests::Versions::Votes < API
+
+    # @example
+    # api.spaces.space_tools.merge_requests.versions.votes.up 'project1', 'git', 571, 1
+    def up(*args)
+      arguments(args, required: [:space, :space_tool, :mr_id, :version])
+      post_request api_uri(arguments, :upvote), arguments.params
+    end
+
+    # @example
+    # api.spaces.space_tools.merge_requests.versions.votes.down 'project1', 'git', 571, 1
+    def down(*args)
+      arguments(args, required: [:space, :space_tool, :mr_id, :version])
+      post_request api_uri(arguments, :downvote), arguments.params
+    end
+
+    # Deletes vote from MR version
+    #
+    # @example
+    # api.spaces.space_tools.merge_requests.versions.votes.delete 'project1', 'git', 571, 1
+    def delete(*args)
+      arguments(args, required: [:space, :space_tool, :mr_id, :version])
+      delete_request api_uri(arguments, :delete), arguments.params
+    end
+
+    alias :remove :delete
+
+    # @example
+    # api.spaces.space_tools.space_tools.merge_requests.versions.list 'project1', 'git', 571, 1
+    def list(*args)
+      arguments(args, required: [:space, :space_tool, :mr_id, :version])
+      response = get_request api_uri(arguments), arguments.params
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+
+    private
+    def api_uri(arguments, method = nil)
+      uri = "/spaces/#{arguments.space}/space_tools/#{arguments.space_tool}/merge_requests/#{arguments.mr_id}/versions/#{arguments.version}/votes"
+      uri += "/" + arguments['id'].to_s if arguments['id']
+      uri += "/" + method.to_s if method
+      uri
+    end
+  end
+end

data/lib/assembla_api/client/spaces/ssh.rb

@@ -0,0 +1,14 @@
+module Assembla
+  class Client::Spaces::Ssh < API
+    require_all 'assembla_api/client/spaces/ssh',
+      'keys',
+      'servers',
+      'actions',
+      'launches'
+
+    namespace :keys
+    namespace :servers
+    namespace :actions
+    namespace :launches
+  end
+end

data/lib/assembla_api/client/spaces/ssh/actions.rb

@@ -0,0 +1,76 @@
+module Assembla
+  class Client::Spaces::Ssh::Actions < API
+    require_all 'assembla_api/client/spaces/ssh/actions',
+      'launches'
+    namespace :launches
+
+    VALID_PARAMS_NAMES = %w[
+      name
+      command
+      description
+      frequency
+      username
+      position
+      ssh_tool_server_id
+    ].freeze
+
+    VALID_REQUEST_PARAM_VALUES = {
+      'frequency' => [ 0, 1, 2, 10, 11, 12 ],
+      'name' => /^[a-zA-Z0-9 _]+$/
+    }
+
+    # @example
+    # api.spaces.ssh.actions.create 'project1', ssh_action: { name: 'Stage' }
+    def create(*args)
+      arguments(args, required: [:space]) do
+        permit VALID_PARAMS_NAMES, recursive: true
+        assert_required %w[ name command username ]
+        assert_values VALID_REQUEST_PARAM_VALUES
+      end
+
+      post_request("/spaces/#{arguments.space}/ssh/actions", arguments.params)
+    end
+
+    # @example
+    # api.spaces.ssh.actions.get 'project1', 7
+    def get(*args)
+      arguments(args, required: [:space, :id])
+      get_request("/spaces/#{arguments.space}/ssh/actions/#{arguments.id}", arguments.params)
+    end
+
+    # @example
+    # api.spaces.ssh.actions.run 'project1', 7
+    def run(*args)
+      arguments(args, required: [:space, :id])
+      get_request("/spaces/#{arguments.space}/ssh/actions/#{arguments.id}/run", arguments.params)
+    end
+
+    # @example
+    # api.spaces.ssh.actions.edit 'project1', 7, ssh_action: { description: 'Do not deploy!' }
+    def edit(*args)
+      arguments(args, required: [:space, :id]) do
+        permit VALID_PARAMS_NAMES , recursive: true
+        assert_values VALID_REQUEST_PARAM_VALUES
+      end
+
+      put_request("/spaces/#{arguments.space}/ssh/actions/#{arguments.id}", arguments.params)
+    end
+
+    # Delete ssh action by ID
+    # @example
+    # api.spaces.ssh.actions.delete 'project1', 7
+    def delete(*args)
+      arguments(args, required: [:space, :id])
+      delete_request("/spaces/#{arguments.space}/ssh/actions/#{arguments.id}", arguments.params)
+    end
+
+    # @example
+    # api.spaces.ssh.actions.list 'project1'
+    def list(*args)
+      arguments(args, required: [:space])
+      response = get_request("/spaces/#{arguments.space}/ssh/actions", arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+  end
+end

data/lib/assembla_api/client/spaces/ssh/actions/launches.rb

@@ -0,0 +1,14 @@
+module Assembla
+  class Client::Spaces::Ssh::Actions::Launches < API
+
+    # @example
+    # api.spaces.ssh.actions.launches.list 'project1', 'action-id'
+    def list(*args)
+      arguments(args, required: [:space, :id])
+
+      response = get_request("/spaces/#{arguments.space}/ssh/actions/#{arguments.id}/launches", arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+  end
+end

data/lib/assembla_api/client/spaces/ssh/keys.rb

@@ -0,0 +1,18 @@
+module Assembla
+  class Client::Spaces::Ssh::Keys < API
+
+    # @example
+    # api.spaces.ssh.keys.generate 'project1'
+    def generate(*args)
+      arguments(args, required: [:space])
+      post_request("/spaces/#{arguments.space}/ssh/generate_key", arguments.params)
+    end
+
+    # @example
+    # api.spaces.ssh.keys.get 'project1'
+    def get(*args)
+      arguments(args, required: [:space])
+      get_request("/spaces/#{arguments.space}/ssh/key", arguments.params)
+    end
+  end
+end

data/lib/assembla_api/client/spaces/ssh/launches.rb

@@ -0,0 +1,29 @@
+module Assembla
+  class Client::Spaces::Ssh::Launches < API
+
+    # @example
+    # api.spaces.ssh.launches.list 'project1'
+    def list(*args)
+      arguments(args, required: [:space])
+
+      response = get_request("/spaces/#{arguments.space}/ssh/launches", arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+
+    # @example
+    # api.spaces.ssh.launches.get 'project1', 142
+    def get(*args)
+      arguments(args, required: [:space, :id])
+      get_request("/spaces/#{arguments.space}/ssh/launches/#{arguments.id}", arguments.params)
+    end
+
+    # Get full output of the command
+    # @example
+    # api.spaces.ssh.launches.output 'project1', 142
+    def output(*args)
+      arguments(args, required: [:space, :id])
+      get_request("/spaces/#{arguments.space}/ssh/launches/#{arguments.id}/output", arguments.params)
+    end
+  end
+end

data/lib/assembla_api/client/spaces/ssh/servers.rb

@@ -0,0 +1,63 @@
+module Assembla
+  class Client::Spaces::Ssh::Servers < API
+    VALID_PARAMS_NAMES = %w[
+      name
+      remote_port
+      remote_host
+      description
+    ].freeze
+
+    VALID_REQUEST_PARAM_VALUES = {
+      'name' => /^[a-zA-Z0-9 _]+$/
+    }
+
+    # @example
+    # api.spaces.ssh.servers.create 'project1', ssh_server: { name: 'Stage' }
+    def create(*args)
+      arguments(args, required: [:space]) do
+        permit VALID_PARAMS_NAMES, recursive: true
+        assert_required %w[ remote_host name ]
+        assert_values VALID_REQUEST_PARAM_VALUES
+      end
+
+      arguments.params['ssh_server']['remote_port'] ||= 22
+
+      post_request("/spaces/#{arguments.space}/ssh/servers", arguments.params)
+    end
+
+    # @example
+    # api.spaces.ssh.servers.get 'project1', 7
+    def get(*args)
+      arguments(args, required: [:space, :id])
+      get_request("/spaces/#{arguments.space}/ssh/servers/#{arguments.id}", arguments.params)
+    end
+
+    # @example
+    # api.spaces.ssh.servers.edit 'project1', 7, ssh_server: { description: 'Do not deploy!' }
+    def edit(*args)
+      arguments(args, required: [:space, :id]) do
+        permit VALID_PARAMS_NAMES , recursive: true
+        assert_values VALID_REQUEST_PARAM_VALUES
+      end
+
+      put_request("/spaces/#{arguments.space}/ssh/servers/#{arguments.id}", arguments.params)
+    end
+
+    # Delete ssh server by ID
+    # @example
+    # api.spaces.ssh.servers.delete 'project1', 7
+    def delete(*args)
+      arguments(args, required: [:space, :id])
+      delete_request("/spaces/#{arguments.space}/ssh/servers/#{arguments.id}", arguments.params)
+    end
+
+    # @example
+    # api.spaces.ssh.servers.list 'project1'
+    def list(*args)
+      arguments(args, required: [:space])
+      response = get_request("/spaces/#{arguments.space}/ssh/servers", arguments.params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+  end
+end