Add api for creating/listing/viewing groups

lib/api.rb

@@ -11,7 +11,8 @@ module Gitlab
     format :json
     error_format :json
     helpers APIHelpers
-
+    
+    mount Groups
     mount Users
     mount Projects
     mount Issues

lib/api/entities.rb

@@ -32,6 +32,16 @@ module Gitlab
       end
     end
 
+    class Group < Grape::Entity
+      expose :id, :name, :path, :name, :owner_id, :type
+    end
+    
+    class GroupDetail < Grape::Entity
+      expose :id, :name, :path, :name, :owner_id, :type
+      expose :projects, using: Entities::Project
+    end
+
+    
     class RepoObject < Grape::Entity
       expose :name, :commit
       expose :protected do |repo, options|

lib/api/groups.rb

@@ -0,0 +1,50 @@
+module Gitlab
+  # groups API
+  class Groups < Grape::API
+    before { authenticate! }
+   
+       resource :groups do
+         # Get a groups list
+         #
+         # Example Request:
+         #  GET /groups
+         get do
+           @groups = paginate Group
+           present @groups, with: Entities::Group
+
+         end
+         
+         # Create group. Available only for admin
+         #
+         # Parameters:
+         #   name (required)                   - Name
+         #   path (required)                   - Path
+         # Example Request:
+         #   POST /groups
+         post do
+           authenticated_as_admin!
+           attrs = attributes_for_keys [:name, :path]
+           @group = Group.new(attrs)
+           @group.owner = current_user
+           
+           if @group.save
+             present @group, with: Entities::Group
+           else
+             not_found!
+           end
+         end
+         
+         # Get a single group, with containing projects
+         #
+         # Parameters:
+         #   id (required) - The ID of a group
+         # Example Request:
+         #   GET /groups/:id
+         get ":id" do
+           @group = Group.find(params[:id])
+           present @group, with: Entities::GroupDetail
+         end
+         
+       end
+  end
+end