Merge branch 'make-namespaces-api-available-to-all-users' into 'master'

Make namespace API available to all users

### What does this MR do?

This MR makes it possible for a user to query namespaces to which he/she has access. Also, it adds documentation for the existing API.

### Why was this MR needed?

Even though the `groups` API exists, it might still be useful to have an endpoint that tells the namespace type (e.g. `user` vs. `group`), especially if a user has access to a number of different projects.

### What are the relevant issue numbers?

Closes https://github.com/gitlabhq/gitlabhq/issues/9328

See merge request !708

2 files changed, 30 insertions, 1 deletions

diff --git a/spec/models/user_spec.rb b/spec/models/user_spec.rb
index 49c7b7d99ce..be0b70395d6 100644
--- a/spec/models/user_spec.rb
+++ b/spec/models/user_spec.rb
@@ -248,6 +248,7 @@ describe User do
     it { expect(@user.several_namespaces?).to be_truthy }
     it { expect(@user.authorized_groups).to eq([@group]) }
     it { expect(@user.owned_groups).to eq([@group]) }
+    it { expect(@user.namespaces).to match_array([@user.namespace, @group]) }
   end
 
   describe 'group multiple owners' do
@@ -270,6 +271,7 @@ describe User do
     end
 
     it { expect(@user.several_namespaces?).to be_falsey }
+    it { expect(@user.namespaces).to eq([@user.namespace]) }
   end
 
   describe 'blocking user' do
diff --git a/spec/requests/api/namespaces_spec.rb b/spec/requests/api/namespaces_spec.rb
index 6ddaaa0a6dd..21787fdd895 100644
--- a/spec/requests/api/namespaces_spec.rb
+++ b/spec/requests/api/namespaces_spec.rb
@@ -3,6 +3,7 @@ require 'spec_helper'
 describe API::API, api: true  do
   include ApiHelpers
   let(:admin) { create(:admin) }
+  let(:user) { create(:user) }
   let!(:group1) { create(:group) }
   let!(:group2) { create(:group) }
 
@@ -14,7 +15,7 @@ describe API::API, api: true  do
       end
     end
 
-    context "when authenticated as  admin" do
+    context "when authenticated as admin" do
       it "admin: should return an array of all namespaces" do
         get api("/namespaces", admin)
         expect(response.status).to eq(200)
@@ -22,6 +23,32 @@ describe API::API, api: true  do
 
         expect(json_response.length).to eq(Namespace.count)
       end
+
+      it "admin: should return an array of matched namespaces" do
+        get api("/namespaces?search=#{group1.name}", admin)
+        expect(response.status).to eq(200)
+        expect(json_response).to be_an Array
+
+        expect(json_response.length).to eq(1)
+      end
+    end
+
+    context "when authenticated as a regular user" do
+      it "user: should return an array of namespaces" do
+        get api("/namespaces", user)
+        expect(response.status).to eq(200)
+        expect(json_response).to be_an Array
+
+        expect(json_response.length).to eq(1)
+      end
+
+      it "admin: should return an array of matched namespaces" do
+        get api("/namespaces?search=#{user.username}", user)
+        expect(response.status).to eq(200)
+        expect(json_response).to be_an Array
+
+        expect(json_response.length).to eq(1)
+      end
     end
   end
 end