artifactory 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ab81695852a0f488f0a8c0aa5ec0c727a08c9e07
-  data.tar.gz: 77629846e4f5069fe9ed05645deff8fc6e94b0fd
+  metadata.gz: 6b8e07b7674ce29c0b313ce8d5be4a551fd007ac
+  data.tar.gz: 37eec0ba96fdb294d4e285977cc0b8d8aec7579a
 SHA512:
-  metadata.gz: 0f7ec99417175058028512e76512cb8ca8bdaf7812c3daef9445d62138f049d961840ab0a5e0aa4b1057e8646effd3d0996c43dd490add26a5e5b3dc979c0b04
-  data.tar.gz: 7ae2fedc3094519ccb94858527366980b34c04efa9cc1a99c5bb22285fef259f1b29d0ab23a523de912b7f39ce78bf75aa46002378d161c6df270c24e534e077
+  metadata.gz: e2b460025528de4d36e1addf26d2b32656c05bc68656143c06524afe0ac6bcde325ed85c3f1c63035cf76294d99fe41fe2e474e6a1460984e6885a099ee0218e
+  data.tar.gz: 6e00717ca7b4a2e90185adc6677eb10fa762c912f9406e5003a15c02be13b44146b901399d8fce08f8ec43a268cc8761fe53abe4bec6ca6f872957794adac792

data/.gitignore

@@ -22,5 +22,6 @@ Gemfile.lock
 bin/
 coverage/
 doc/
+pkg/
 tmp/
 vendor/

data/.travis.yml

@@ -1,4 +1,4 @@
-# Test on modern rubites
+# Test on modern rubies
 rvm:
   - 1.9.3
   - 2.0.0
@@ -6,3 +6,15 @@ rvm:
 
 # Setup parallel downloaders
 bundler_args: --jobs 7
+
+# Only test master (PRs are still tested)
+branches:
+  only:
+    - master
+
+# Notifications
+notifications:
+  hipchat:
+    rooms:
+      - secure: eUtMt0CeB2bbIcTeQA3rUJsTtBkq/Ng5AnM59NOCzutcPTnNDeM4kNQEfgJ5QEZZkx08IXyiPJ14gEQUaV0bF0s0FLyzFxjlX9p2jem99FmEA404KJ7axoUiGGxgATbq9V7tUOrp1zG+a8xVQTahZASKadPlC9TSRgKqjUL+Dvg= # Release Engineering
+      - secure: fQEeBZSIV9mKpM5XeKxmvcgUb19skv3+qW6TiyvuPReB4B/mc5vf3AABWhbdnnHzjsKnq2iQtcppXVG0eJwuRM5D1werMO91zwSRNBU/ClOLHaYBp5l4tVkuHzAd3eo/Z67vxE0BAV9lGWeWv7r3y/BLgJ265nQMyfgZSyz1i44= # Build Statuses

data/CHANGELOG.md

@@ -4,6 +4,11 @@ This file is used to document the changes between releases of the Artifactory
 Ruby client.
 
 
-v1.0.0
-------
+v1.1.0 (2014-02-11)
+-------------------
+- Add support for group resources
+- Add support for user resources
+
+v1.0.0 (2014-02-10)
+-------------------
 - Initial release

data/lib/artifactory.rb

@@ -16,6 +16,7 @@ module Artifactory
     autoload :Artifact,   'artifactory/resources/artifact'
     autoload :Base,       'artifactory/resources/base'
     autoload :Build,      'artifactory/resources/build'
+    autoload :Group,      'artifactory/resources/group'
     autoload :Plugin,     'artifactory/resources/plugin'
     autoload :Repository, 'artifactory/resources/repository'
     autoload :System,     'artifactory/resources/system'

data/lib/artifactory/client.rb

@@ -190,7 +190,7 @@ module Artifactory
         raise Error::NotFound.new(url: url)
       when 405
         raise Error::MethodNotAllowed.new(url: url)
-      when 500..600
+      else
         raise Error::ConnectionError.new(url: url, body: response.body)
       end
     rescue SocketError, Errno::ECONNREFUSED, EOFError
@@ -212,7 +212,9 @@ module Artifactory
     #   the parsed response, as an object
     #
     def parse_response(response)
-      if response.headers['Content-Type'].include?('json')
+      content_type = response.headers['Content-Type']
+
+      if content_type && content_type.include?('json')
         JSON.parse(response.body)
       else
         response.body

data/lib/artifactory/resources/base.rb

@@ -1,3 +1,5 @@
+require 'json'
+
 module Artifactory
   class Resource::Base
     class << self
@@ -23,8 +25,13 @@ module Artifactory
       #     @return [Boolean]
       #
       def attribute(key, default = nil)
+        key = key.to_sym unless key.is_a?(Symbol)
+
+        # Set the key on the top attributes, mostly for asthetic purposes
+        attributes[key] = nil
+
         define_method(key) do
-          value = instance_variable_get("@#{key}")
+          value = attributes[key]
           return value unless value.nil?
 
           if default.nil?
@@ -37,11 +44,11 @@ module Artifactory
         end
 
         define_method("#{key}?") do
-          !!send(key)
+          !!attributes[key]
         end
 
         define_method("#{key}=") do |value|
-          instance_variable_set("@#{key}", value)
+          set(key, value)
         end
       end
 
@@ -96,6 +103,10 @@ module Artifactory
       def url_safe(value)
         URI.escape(value.to_s)
       end
+
+      def attributes
+        @attributes ||= {}
+      end
     end
 
     attribute :client, ->{ Artifactory.client }
@@ -104,42 +115,68 @@ module Artifactory
     # Create a new instance
     #
     def initialize(attributes = {})
-      attributes.each { |key, value| send(:"#{key}=", value) }
+      attributes.each do |key, value|
+        set(key, value)
+      end
+    end
+
+    #
+    # The list of attributes for this resource.
+    #
+    # @return [hash]
+    #
+    def attributes
+      @attributes ||= self.class.attributes.dup
+    end
+
+    #
+    # Set a given attribute on this resource.
+    #
+    # @param [#to_sym] key
+    #   the attribute to set
+    # @param [Object] value
+    #   the value to set
+    #
+    # @return [Object]
+    #   the set value
+    #
+    def set(key, value)
+      attributes[key.to_sym] = value
     end
 
-    # @see {Resource::Base.extract_client!}
+    # @see Resource::Base.extract_client!
     def extract_client!(options)
       self.class.extract_client!(options)
     end
 
-    # @see {Resource::Base.format_repos!}
+    # @see Resource::Base.format_repos!
     def format_repos!(options)
       self.class.format_repos!(options)
     end
 
-    # @see {Resource::Base.url_safe}
+    # @see Resource::Base.url_safe
     def url_safe(value)
       self.class.url_safe(value)
     end
 
+    # @private
     def to_s
-      "#<#{self.class.name}>"
+      "#<#{short_classname}>"
     end
 
+    # @private
     def inspect
-      map = instance_variables.map do |k|
-        unless k == :@client
-          value = instance_variable_get(k)
-
-          if !value.nil?
-            "#{k.to_s.gsub(/^@/, '')}: #{value.inspect}"
-          else
-            nil
-          end
-        end
+      list = attributes.collect do |key, value|
+        "#{key}: #{value.inspect}" unless key == :client
       end.compact
 
-      "#<#{self.class.name} #{map.join(', ')}>"
+      "#<#{short_classname} #{list.join(', ')}>"
+    end
+
+    private
+
+    def short_classname
+      @short_classname ||= self.class.name.split('::').last
     end
   end
 end

data/lib/artifactory/resources/group.rb

@@ -0,0 +1,171 @@
+module Artifactory
+  class Resource::Group < Resource::Base
+    class << self
+      #
+      # Get a list of all groups in the system.
+      #
+      # @param [Hash] options
+      #   the list of options
+      #
+      # @option options [Artifactory::Client] :client
+      #   the client object to make the request with
+      #
+      # @return [Array<Resource::Group>]
+      #   the list of groups
+      #
+      def all(options = {})
+        client = extract_client!(options)
+        client.get('/api/security/groups').map do |hash|
+          from_url(hash['uri'], client: client)
+        end
+      end
+
+      #
+      # Find (fetch) a group by its name.
+      #
+      # @example Find a group by its name
+      #   Group.find('readers') #=> #<Group name: 'readers' ...>
+      #
+      # @param [String] name
+      #   the name of the group to find
+      # @param [Hash] options
+      #   the list of options
+      #
+      # @option options [Artifactory::Client] :client
+      #   the client object to make the request with
+      #
+      # @return [Resource::Group, nil]
+      #   an instance of the group that matches the given name, or +nil+
+      #   if one does not exist
+      #
+      def find(name, options = {})
+        client = extract_client!(options)
+
+        response = client.get("/api/security/groups/#{url_safe(name)}")
+        from_hash(response, client: client)
+      rescue Error::NotFound
+        nil
+      end
+
+      #
+      # Construct a group from the given URL.
+      #
+      # @example Create an group object from the given URL
+      #   Group.from_url('/security/groups/readers') #=> #<Resource::Group>
+      #
+      # @param [Artifactory::Client] client
+      #   the client object to make the request with
+      # @param [String] url
+      #   the URL to find the group from
+      #
+      # @return [Resource::Group]
+      #
+      def from_url(url, options = {})
+        client = extract_client!(options)
+        from_hash(client.get(url), client: client)
+      end
+
+      #
+      # Create a instance from the given Hash. This method extracts the "safe"
+      # information from the hash and adds them to the instance.
+      #
+      # @example Create a new group from a hash
+      #   Group.from_hash('realmAttributes' => '...', 'name' => '...')
+      #
+      # @param [Artifactory::Client] client
+      #   the client object to make the request with
+      # @param [Hash] hash
+      #   the hash to create the instance from
+      #
+      # @return [Resource::Group]
+      #
+      def from_hash(hash, options = {})
+        client = extract_client!(options)
+
+        new.tap do |instance|
+          instance.auto_join        = hash['autoJoin']
+          instance.client           = client
+          instance.description      = hash['description']
+          instance.name             = hash['name']
+          instance.realm            = hash['realm']
+          instance.realm_attributes = hash['realmAttributes']
+        end
+      end
+    end
+
+    attribute :auto_join
+    attribute :description
+    attribute :name, ->{ raise 'Name missing!' }
+    attribute :realm
+    attribute :realm_attributes
+
+    #
+    # Delete this group from artifactory, suppressing any +ResourceNotFound+
+    # exceptions might occur.
+    #
+    # @return [Boolean]
+    #   true if the object was deleted successfully, false otherwise
+    #
+    def delete
+      !!client.delete(api_path)
+    rescue Error::NotFound
+      false
+    end
+
+    #
+    # Save the group to the artifactory server.
+    #
+    # @return [Boolean]
+    #
+    def save
+      client.put(api_path, to_json, headers)
+      true
+    end
+
+    #
+    # The hash format for this group.
+    #
+    # @return [Hash]
+    #
+    def to_hash
+      {
+        'autoJoin'        => auto_join,
+        'description'     => description,
+        'name'            => name,
+        'realm'           => realm,
+        'realmAttributes' => realm_attributes,
+      }
+    end
+
+    #
+    # The JSON representation of this resource.
+    #
+    # @return [String]
+    #
+    def to_json
+      JSON.fast_generate(to_hash)
+    end
+
+    private
+
+    #
+    # The path to this group on the server.
+    #
+    # @return [String]
+    #
+    def api_path
+      @api_path ||= "/api/security/groups/#{url_safe(name)}"
+    end
+
+    #
+    # The default headers for this object. This includes the +Content-Type+.
+    #
+    # @return [Hash]
+    #
+    def headers
+      @headers ||= {
+        'Content-Type' => 'application/vnd.org.jfrog.artifactory.security.Group+json'
+      }
+    end
+  end
+end

data/lib/artifactory/resources/user.rb

@@ -2,7 +2,16 @@ module Artifactory
   class Resource::User < Resource::Base
     class << self
       #
+      # Get a list of all users in the system.
       #
+      # @param [Hash] options
+      #   the list of options
+      #
+      # @option options [Artifactory::Client] :client
+      #   the client object to make the request with
+      #
+      # @return [Array<Resource::User>]
+      #   the list of users
       #
       def all(options = {})
         client = extract_client!(options)
@@ -12,19 +21,44 @@ module Artifactory
       end
 
       #
+      # Find (fetch) a user by its name.
+      #
+      # @example Find a user by its name
+      #   User.find('readers') #=> #<User name: 'readers' ...>
       #
+      # @param [String] name
+      #   the name of the user to find
+      # @param [Hash] options
+      #   the list of options
       #
-      def find(options = {})
-        client   = extract_client!(options)
-        username = URI.escape(options[:username])
-        response = client.get("/api/security/users/#{username}")
+      # @option options [Artifactory::Client] :client
+      #   the client object to make the request with
+      #
+      # @return [Resource::User, nil]
+      #   an instance of the user that matches the given name, or +nil+
+      #   if one does not exist
+      #
+      def find(name, options = {})
+        client = extract_client!(options)
+
+        response = client.get("/api/security/users/#{url_safe(name)}")
         from_hash(response, client: client)
       rescue Error::NotFound
         nil
       end
 
       #
+      # Construct a user from the given URL.
+      #
+      # @example Create an user object from the given URL
+      #   User.from_url('/security/users/readers') #=> #<Resource::User>
+      #
+      # @param [Artifactory::Client] client
+      #   the client object to make the request with
+      # @param [String] url
+      #   the URL to find the user from
       #
+      # @return [Resource::User]
       #
       def from_url(url, options = {})
         client = extract_client!(options)
@@ -32,26 +66,117 @@ module Artifactory
       end
 
       #
+      # Create a instance from the given Hash. This method extracts the "safe"
+      # information from the hash and adds them to the instance.
       #
+      # @example Create a new user from a hash
+      #   User.from_hash('realmAttributes' => '...', 'name' => '...')
+      #
+      # @param [Artifactory::Client] client
+      #   the client object to make the request with
+      # @param [Hash] hash
+      #   the hash to create the instance from
+      #
+      # @return [Resource::User]
       #
       def from_hash(hash, options = {})
         client = extract_client!(options)
 
-        new(client).tap do |instance|
-          instance.admin      = hash['admin']
-          instance.email      = hash['email']
-          instance.last_login = Time.parse(hash['lastLoggedIn']) rescue nil
-          instance.name       = hash['name']
-          instance.realm      = hash['realm']
+        new.tap do |instance|
+          instance.admin                      = !!hash['admin']
+          instance.email                      = hash['email']
+          instance.groups                     = Array(hash['groups'])
+          instance.internal_password_disabled = hash['internalPasswordDisabled']
+          instance.last_logged_in             = hash['lastLoggedIn']
+          instance.name                       = hash['name']
+          instance.password                   = hash['password']
+          instance.profile_updatable          = !!hash['profileUpdatable']
+          instance.realm                      = hash['realm']
         end
       end
     end
 
     attribute :admin, false
     attribute :email
-    attribute :last_login
-    attribute :name, ->{ raise 'Name missing!' }
-    attribute :password
+    attribute :groups, []
+    attribute :internal_password_disabled, false
+    attribute :last_logged_in
+    attribute :name, -> { raise 'Name missing' }
+    attribute :password # write only, never returned
+    attribute :profile_updatable, true
     attribute :realm
+
+    #
+    # Delete this user from artifactory, suppressing any +ResourceNotFound+
+    # exceptions might occur.
+    #
+    # @return [Boolean]
+    #   true if the object was deleted successfully, false otherwise
+    #
+    def delete
+      !!client.delete(api_path)
+    rescue Error::NotFound
+      false
+    end
+
+    #
+    # Save the user to the artifactory server.
+    #
+    # @return [Boolean]
+    #
+    def save
+      client.put(api_path, to_json, headers)
+      true
+    end
+
+    #
+    # The hash format for this user.
+    #
+    # @return [Hash]
+    #
+    def to_hash
+      {
+        'admin'                    => admin,
+        'email'                    => email,
+        'groups'                   => groups,
+        'internalPasswordDisabled' => internal_password_disabled,
+        'lastLoggedIn'             => last_logged_in,
+        'name'                     => name,
+        'password'                 => password,
+        'profileUpdatable'         => profile_updatable,
+        'realm'                    => realm,
+      }
+    end
+
+    #
+    # The JSON representation of this resource.
+    #
+    # @return [String]
+    #
+    def to_json
+      JSON.fast_generate(to_hash)
+    end
+
+    private
+
+    #
+    # The path to this user on the server.
+    #
+    # @return [String]
+    #
+    def api_path
+      @api_path ||= "/api/security/users/#{url_safe(name)}"
+    end
+
+    #
+    # The default headers for this object. This includes the +Content-Type+.
+    #
+    # @return [Hash]
+    #
+    def headers
+      @headers ||= {
+        'Content-Type' => 'application/vnd.org.jfrog.artifactory.security.User+json'
+      }
+    end
   end
 end

data/lib/artifactory/version.rb

@@ -1,3 +1,3 @@
 module Artifactory
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 end

data/spec/integration/resources/group_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+
+module Artifactory
+  describe Resource::Group, :integration do
+    describe '.all' do
+      it 'returns an array of group objects' do
+        results = described_class.all
+        expect(results).to be_a(Array)
+        expect(results.first).to be_a(described_class)
+      end
+
+      it 'includes the information from the server' do
+        results = described_class.all
+        readers = results[0]
+        leads   = results[1]
+
+        expect(readers.name).to eq('readers')
+        expect(leads.name).to eq('tech-leads')
+      end
+    end
+
+    describe '.find' do
+      it 'finds a group by name' do
+        readers = described_class.find('readers')
+
+        expect(readers).to be_a(described_class)
+        expect(readers.name).to eq('readers')
+      end
+    end
+
+    describe '#delete' do
+      it 'deletes the group from the server' do
+        readers = described_class.find('readers')
+        expect(readers.delete).to be_true
+      end
+    end
+
+    describe '#save' do
+      it 'saves the group to the server' do
+        group = described_class.new(name: 'testing')
+        expect(group.save).to be_true
+      end
+    end
+  end
+end

data/spec/integration/resources/user_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+
+module Artifactory
+  describe Resource::User, :integration do
+    describe '.all' do
+      it 'returns an array of user objects' do
+        results = described_class.all
+        expect(results).to be_a(Array)
+        expect(results.first).to be_a(described_class)
+      end
+
+      it 'includes the information from the server' do
+        results = described_class.all
+        seth    = results[0]
+        yvonne  = results[1]
+
+        expect(seth.name).to eq('sethvargo')
+        expect(yvonne.name).to eq('yzl')
+      end
+    end
+
+    describe '.find' do
+      it 'finds a user by name' do
+        seth = described_class.find('sethvargo')
+
+        expect(seth).to be_a(described_class)
+        expect(seth.name).to eq('sethvargo')
+      end
+    end
+
+    describe '#delete' do
+      it 'deletes the user from the server' do
+        sethvargo = described_class.find('sethvargo')
+        expect(sethvargo.delete).to be_true
+      end
+    end
+
+    describe '#save' do
+      it 'saves the user to the server' do
+        user = described_class.new(name: 'schisamo')
+        expect(user.save).to be_true
+      end
+    end
+  end
+end

data/spec/support/api_server.rb

@@ -8,15 +8,19 @@ module Artifactory
   class APIServer < Sinatra::Base
     require_relative 'api_server/artifact_endpoints'
     require_relative 'api_server/build_endpoints'
+    require_relative 'api_server/group_endpoints'
     require_relative 'api_server/repository_endpoints'
     require_relative 'api_server/status_endpoints'
     require_relative 'api_server/system_endpoints'
+    require_relative 'api_server/user_endpoints'
 
     register APIServer::ArtifactEndpoints
     register APIServer::BuildEndpoints
+    register APIServer::GroupEndpoints
     register APIServer::RepositoryEndpoints
     register APIServer::StatusEndpoints
     register APIServer::SystemEndpoints
+    register APIServer::UserEndpoints
 
     private
 

data/spec/support/api_server/group_endpoints.rb

@@ -0,0 +1,53 @@
+module Artifactory
+  module APIServer::GroupEndpoints
+    def self.registered(app)
+      app.get('/api/security/groups') do
+        content_type 'application/vnd.org.jfrog.artifactory.security.Groups+json'
+        JSON.fast_generate([
+          {
+            'name' => 'readers',
+            'uri'  => server_url.join('/api/security/groups/readers'),
+          },
+          {
+            'name' => 'tech-leads',
+            'uri'  => server_url.join('/api/security/groups/tech-leads')
+          }
+        ])
+      end
+
+      app.get('/api/security/groups/readers') do
+        content_type 'application/vnd.org.jfrog.artifactory.security.Group+json'
+        JSON.fast_generate(
+          'name'            => 'readers',
+          'description'     => 'This list of read-only users',
+          'autoJoin'        => true,
+          'realm'           => 'artifactory',
+          'realmAttributes' => nil,
+        )
+      end
+
+      app.get('/api/security/groups/tech-leads') do
+        content_type 'application/vnd.org.jfrog.artifactory.security.Group+json'
+        JSON.fast_generate(
+          'name'            => 'tech-leads',
+          'description'     => 'This development leads group',
+          'autoJoin'        => false,
+          'realm'           => 'artifactory',
+          'realmAttributes' => nil,
+        )
+      end
+
+      app.put('/api/security/groups/:name') do
+        return 415 unless request.content_type == 'application/vnd.org.jfrog.artifactory.security.Group+json'
+
+        # Attempt to parse the response; if this succeeds, all is well...
+        JSON.parse(request.body.read)
+        nil
+      end
+
+      app.delete('/api/security/groups/:name') do
+        nil
+      end
+    end
+  end
+end

data/spec/support/api_server/user_endpoints.rb

@@ -0,0 +1,59 @@
+module Artifactory
+  module APIServer::UserEndpoints
+    def self.registered(app)
+      app.get('/api/security/users') do
+        content_type 'application/vnd.org.jfrog.artifactory.security.Users+json'
+        JSON.fast_generate([
+          {
+            'name' => 'sethvargo',
+            'uri'  => server_url.join('/api/security/users/sethvargo'),
+          },
+          {
+            'name' => 'yzl',
+            'uri'  => server_url.join('/api/security/users/yzl')
+          }
+        ])
+      end
+
+      app.get('/api/security/users/sethvargo') do
+        content_type 'application/vnd.org.jfrog.artifactory.security.User+json'
+        JSON.fast_generate(
+          'admin'                    => false,
+          'email'                    => 'sethvargo@gmail.com',
+          'groups'                   => ['admin'],
+          'internalPasswordDisabled' => true,
+          'lastLoggedIn'             => nil,
+          'name'                     => 'sethvargo',
+          'profileUpdatable'         => true,
+          'realm'                    => 'artifactory',
+        )
+      end
+
+      app.get('/api/security/users/yzl') do
+        content_type 'application/vnd.org.jfrog.artifactory.security.User+json'
+        JSON.fast_generate(
+          'admin'                    => true,
+          'email'                    => 'yvonne@getchef.com',
+          'groups'                   => ['admin'],
+          'internalPasswordDisabled' => true,
+          'lastLoggedIn'             => nil,
+          'name'                     => 'yzl',
+          'profileUpdatable'         => true,
+          'realm'                    => 'crowd',
+        )
+      end
+
+      app.put('/api/security/users/:name') do
+        return 415 unless request.content_type == 'application/vnd.org.jfrog.artifactory.security.User+json'
+
+        # Attempt to parse the response; if this succeeds, all is well...
+        JSON.parse(request.body.read)
+        nil
+      end
+
+      app.delete('/api/security/users/:name') do
+        nil
+      end
+    end
+  end
+end

data/spec/unit/resources/base_spec.rb

@@ -126,14 +126,17 @@ module Artifactory
 
     describe '#to_s' do
       it 'returns the name of the class' do
-        expect(subject.to_s).to eq('#<Artifactory::Resource::Base>')
+        expect(subject.to_s).to eq('#<Base>')
       end
     end
 
     describe '#inspect' do
-      it 'includes all the instance variables' do
-        subject.instance_variable_set(:@foo, 'bar')
-        expect(subject.inspect).to eq(%q|#<Artifactory::Resource::Base foo: "bar">|)
+      it 'includes all the attributes' do
+        subject.stub(:attributes) do
+          { foo: 'bar' }
+        end
+
+        expect(subject.inspect).to eq(%q|#<Base foo: "bar">|)
       end
     end
   end

data/spec/unit/resources/group_spec.rb

@@ -0,0 +1,75 @@
+require 'spec_helper'
+
+module Artifactory
+  describe Resource::Group do
+    let(:client) { double(:client) }
+
+    before(:each) do
+      Artifactory.stub(:client).and_return(client)
+      client.stub(:get).and_return(response) if defined?(response)
+    end
+
+    describe '.all' do
+      let(:response) do
+        [
+          { 'uri' => 'a' },
+          { 'uri' => 'b' },
+          { 'uri' => 'c' },
+        ]
+      end
+      before do
+        described_class.stub(:from_url).with('a', client: client).and_return('a')
+        described_class.stub(:from_url).with('b', client: client).and_return('b')
+        described_class.stub(:from_url).with('c', client: client).and_return('c')
+      end
+
+      it 'gets /api/security/groups' do
+        expect(client).to receive(:get).with('/api/security/groups').once
+        described_class.all
+      end
+
+      it 'returns the groups' do
+        expect(described_class.all).to eq(['a', 'b', 'c'])
+      end
+    end
+
+    describe '.find' do
+      let(:response) { {} }
+
+      it 'gets /api/repositories/#{name}' do
+        expect(client).to receive(:get).with('/api/security/groups/readers').once
+        described_class.find('readers')
+      end
+    end
+
+    describe '.from_url' do
+      let(:response) { {} }
+
+      it 'constructs a new instance from the result' do
+        expect(described_class).to receive(:from_hash).once
+        described_class.from_url('/api/security/groups/readers')
+      end
+    end
+
+    describe '.from_hash' do
+      let(:hash) do
+        {
+          'name'            => 'readers',
+          'description'     => 'This list of read-only users',
+          'autoJoin'        => true,
+          'realm'           => 'artifactory',
+          'realmAttributes' => nil,
+        }
+      end
+
+      it 'creates a new instnace' do
+        instance = described_class.from_hash(hash)
+        expect(instance.name).to eq('readers')
+        expect(instance.description).to eq('This list of read-only users')
+        expect(instance.auto_join).to be_true
+        expect(instance.realm).to eq('artifactory')
+        expect(instance.realm_attributes).to be_nil
+      end
+    end
+  end
+end

data/spec/unit/resources/user_spec.rb

@@ -0,0 +1,82 @@
+require 'spec_helper'
+
+module Artifactory
+  describe Resource::User do
+    let(:client) { double(:client) }
+
+    before(:each) do
+      Artifactory.stub(:client).and_return(client)
+      client.stub(:get).and_return(response) if defined?(response)
+    end
+
+    describe '.all' do
+      let(:response) do
+        [
+          { 'uri' => 'a' },
+          { 'uri' => 'b' },
+          { 'uri' => 'c' },
+        ]
+      end
+      before do
+        described_class.stub(:from_url).with('a', client: client).and_return('a')
+        described_class.stub(:from_url).with('b', client: client).and_return('b')
+        described_class.stub(:from_url).with('c', client: client).and_return('c')
+      end
+
+      it 'gets /api/security/users' do
+        expect(client).to receive(:get).with('/api/security/users').once
+        described_class.all
+      end
+
+      it 'returns the users' do
+        expect(described_class.all).to eq(['a', 'b', 'c'])
+      end
+    end
+
+    describe '.find' do
+      let(:response) { {} }
+
+      it 'gets /api/repositories/#{name}' do
+        expect(client).to receive(:get).with('/api/security/users/readers').once
+        described_class.find('readers')
+      end
+    end
+
+    describe '.from_url' do
+      let(:response) { {} }
+
+      it 'constructs a new instance from the result' do
+        expect(described_class).to receive(:from_hash).once
+        described_class.from_url('/api/security/users/readers')
+      end
+    end
+
+    describe '.from_hash' do
+      let(:hash) do
+        {
+          'admin'                    => false,
+          'email'                    => 'admin@example.com',
+          'groups'                   => ['admin'],
+          'internalPasswordDisabled' => true,
+          'lastLoggedIn'             => nil,
+          'name'                     => 'admin',
+          'profileUpdatable'         => true,
+          'realm'                    => 'artifactory',
+        }
+      end
+
+      it 'creates a new instnace' do
+        instance = described_class.from_hash(hash)
+        expect(instance.admin).to be_false
+        expect(instance.email).to eq('admin@example.com')
+        expect(instance.groups).to eq(['admin'])
+        expect(instance.internal_password_disabled).to be_true
+        expect(instance.last_logged_in).to be_nil
+        expect(instance.name).to eq('admin')
+        expect(instance.password).to be_nil
+        expect(instance.profile_updatable).to be_true
+        expect(instance.realm).to eq('artifactory')
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: artifactory
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Seth Vargo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-02-10 00:00:00.000000000 Z
+date: 2014-02-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httpclient
@@ -90,6 +90,7 @@ files:
 - lib/artifactory/resources/artifact.rb
 - lib/artifactory/resources/base.rb
 - lib/artifactory/resources/build.rb
+- lib/artifactory/resources/group.rb
 - lib/artifactory/resources/plugin.rb
 - lib/artifactory/resources/repository.rb
 - lib/artifactory/resources/system.rb
@@ -99,23 +100,29 @@ files:
 - locales/en.yml
 - spec/integration/resources/artifact_spec.rb
 - spec/integration/resources/build_spec.rb
+- spec/integration/resources/group_spec.rb
 - spec/integration/resources/repository_spec.rb
 - spec/integration/resources/system_spec.rb
+- spec/integration/resources/user_spec.rb
 - spec/spec_helper.rb
 - spec/support/api_server.rb
 - spec/support/api_server/artifact_endpoints.rb
 - spec/support/api_server/build_endpoints.rb
+- spec/support/api_server/group_endpoints.rb
 - spec/support/api_server/repository_endpoints.rb
 - spec/support/api_server/status_endpoints.rb
 - spec/support/api_server/system_endpoints.rb
+- spec/support/api_server/user_endpoints.rb
 - spec/unit/artifactory_spec.rb
 - spec/unit/client_spec.rb
 - spec/unit/resources/artifact_spec.rb
 - spec/unit/resources/base_spec.rb
 - spec/unit/resources/build_spec.rb
+- spec/unit/resources/group_spec.rb
 - spec/unit/resources/plugin_spec.rb
 - spec/unit/resources/repository_spec.rb
 - spec/unit/resources/system_spec.rb
+- spec/unit/resources/user_spec.rb
 homepage: https://github.com/opscode/artifactory-client
 licenses:
 - Apache 2.0
@@ -144,21 +151,27 @@ summary: Artifactory is a simple, lightweight Ruby client for interacting with t
 test_files:
 - spec/integration/resources/artifact_spec.rb
 - spec/integration/resources/build_spec.rb
+- spec/integration/resources/group_spec.rb
 - spec/integration/resources/repository_spec.rb
 - spec/integration/resources/system_spec.rb
+- spec/integration/resources/user_spec.rb
 - spec/spec_helper.rb
 - spec/support/api_server.rb
 - spec/support/api_server/artifact_endpoints.rb
 - spec/support/api_server/build_endpoints.rb
+- spec/support/api_server/group_endpoints.rb
 - spec/support/api_server/repository_endpoints.rb
 - spec/support/api_server/status_endpoints.rb
 - spec/support/api_server/system_endpoints.rb
+- spec/support/api_server/user_endpoints.rb
 - spec/unit/artifactory_spec.rb
 - spec/unit/client_spec.rb
 - spec/unit/resources/artifact_spec.rb
 - spec/unit/resources/base_spec.rb
 - spec/unit/resources/build_spec.rb
+- spec/unit/resources/group_spec.rb
 - spec/unit/resources/plugin_spec.rb
 - spec/unit/resources/repository_spec.rb
 - spec/unit/resources/system_spec.rb
+- spec/unit/resources/user_spec.rb
 has_rdoc: