NARKOZ · StingRayZA · Jun 22, 2023 · Jun 23, 2023
diff --git a/lib/gitlab/client/users.rb b/lib/gitlab/client/users.rb
@@ -298,7 +298,7 @@ def delete_email(id, user_id = nil)
       delete(url)
     end
 
-    # Search for groups by name
+    # Search for users by name
     #
     # @example
     #   Gitlab.user_search('gitlab')
@@ -313,6 +313,19 @@ def user_search(search, options = {})
       get('/users', query: options)
     end
 
+    # Get user by username
+    #
+    # @example
+    #   Gitlab.user_by_username('gitlab')
+    #
+    # @param  [String] username A username to get.
+    # @param  [Hash] options A customizable set of options.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def user_by_username(username, options = {})
+      options[:username] = username
+      get('/users', query: options)
+    end
+
     # Gets user custom_attributes.
     #
     # @example

diff --git a/spec/fixtures/empty_array.json b/spec/fixtures/empty_array.json
@@ -0,0 +1 @@
+[]
diff --git a/spec/fixtures/user_by_username.json b/spec/fixtures/user_by_username.json
@@ -0,0 +1 @@
+[{"id":1,"email":"[email protected]","name":"John Smith","username":"john.smith","bio":null,"skype":"","linkedin":"","twitter":"john","dark_scheme":false,"theme_id":1,"blocked":false,"created_at":"2012-09-17T09:41:56Z"}]
diff --git a/spec/gitlab/client/users_spec.rb b/spec/gitlab/client/users_spec.rb
@@ -524,6 +524,34 @@
     end
   end
 
+  describe '.user_by_username' do
+    context 'with a valid username' do
+      before do
+        stub_get('/users?username=User', 'user_by_username')
+        @user = Gitlab.user_by_username('User')
+      end
+
+      it 'gets the correct resource' do
+        expect(a_get('/users?username=User')).to have_been_made
+      end
+
+      it 'returns information about a user' do
+        expect(@user.first.email).to eq('[email protected]')
+      end
+    end
+
+    context 'with an invalid username' do
+      before do
+        stub_get('/users?username=InvalidUser', 'empty_array')
+        @user = Gitlab.user_by_username('InvalidUser')
+      end
+
+      it 'returns an empty array' do
+        expect(@user).to eq([])
+      end
+    end
+  end
+
   describe '.user_custom_attributes' do
     before do
       stub_get('/users/2/custom_attributes', 'user_custom_attributes')
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		[{"id":1,"email":"[email protected]","name":"John Smith","username":"john.smith","bio":null,"skype":"","linkedin":"","twitter":"john","dark_scheme":false,"theme_id":1,"blocked":false,"created_at":"2012-09-17T09:41:56Z"}]