artifactory 2.1.3 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9ccfaa5ca0cc4863850ec3838804360dbeab5680
-  data.tar.gz: f1a22d50c6a7ebecedb5f2f6bd1d2b73778b2a0a
+  metadata.gz: b89a0d205ba82632c1f9b538a50b84f69b67ac0f
+  data.tar.gz: 1484191f4caf8502ca9ec7519d97c67fe5cc51f7
 SHA512:
-  metadata.gz: 03c8645b02635c10d936e5b2f8b96dbd77355facda716164f1495efd3eb6955e3fd7f33338243518b4ac08ded41cc025cc0471ca0d54bfbcc392f8f9536b3c6f
-  data.tar.gz: f87b952b9e0f0e282d8bcf9fcef3888a0fecf7d7c21dd341deb864bbf60783f1f6d0f7bc84c1163ac81cdeedd0857072ea8d7f574ce292b5cb87659ef99851a1
+  metadata.gz: 9d374065d88be5dc94f46fa9c4cf90694e8eb270ef1c92c6036a1e7941274735ca89e9ecc326d3d2d25d4a9170dd89217b0d6ee39cb2b616810817d756734249
+  data.tar.gz: dbe9986454583e5977d555d466a9163a535ae1a623b1d7916f258c1016315db1c32e09355f8e48303793a2c3189a3c9f5044b168217ecac6ca02d031aecbd042

data/CHANGELOG.md

@@ -3,6 +3,12 @@ Artifactory Client CHANGELOG
 This file is used to document the changes between releases of the Artifactory
 Ruby client.
 
+v2.2.0 (11-20-2014)
+-------------------
+- Add artifact usage search
+- Add artifact creation search
+- Add support for configuring permission targets
+
 v2.1.3 (08-29-2014)
 -------------------
 - CGI escape matrix properties

data/README.md

@@ -31,14 +31,14 @@ This will given you "Rails-like" access to the top-level Artifactory resources l
 
 ```ruby
 System.info
-Respository.all
+Repository.all
 ```
 
 If you choose not to include the module (for namespacing reasons), you will need to specify the full module path to access resources:
 
 ```ruby
 Artifactory::Resource::System.info
-Artifactory::Resource::Respository.all
+Artifactory::Resource::Repository.all
 ```
 
 ### Create a connection

data/lib/artifactory.rb

@@ -30,19 +30,20 @@ module Artifactory
   end
 
   module Resource
-    autoload :Artifact,     'artifactory/resources/artifact'
-    autoload :Backup,       'artifactory/resources/backup'
-    autoload :Base,         'artifactory/resources/base'
-    autoload :Build,        'artifactory/resources/build'
-    autoload :Group,        'artifactory/resources/group'
-    autoload :Layout,       'artifactory/resources/layout'
-    autoload :LDAPSetting,  'artifactory/resources/ldap_setting'
-    autoload :MailServer,   'artifactory/resources/mail_server'
-    autoload :Plugin,       'artifactory/resources/plugin'
-    autoload :Repository,   'artifactory/resources/repository'
-    autoload :System,       'artifactory/resources/system'
-    autoload :URLBase,      'artifactory/resources/url_base'
-    autoload :User,         'artifactory/resources/user'
+    autoload :Artifact,         'artifactory/resources/artifact'
+    autoload :Backup,           'artifactory/resources/backup'
+    autoload :Base,             'artifactory/resources/base'
+    autoload :Build,            'artifactory/resources/build'
+    autoload :Group,            'artifactory/resources/group'
+    autoload :Layout,           'artifactory/resources/layout'
+    autoload :LDAPSetting,      'artifactory/resources/ldap_setting'
+    autoload :MailServer,       'artifactory/resources/mail_server'
+    autoload :PermissionTarget, 'artifactory/resources/permission_target'
+    autoload :Plugin,           'artifactory/resources/plugin'
+    autoload :Repository,       'artifactory/resources/repository'
+    autoload :System,           'artifactory/resources/system'
+    autoload :URLBase,          'artifactory/resources/url_base'
+    autoload :User,             'artifactory/resources/user'
   end
 
   class << self

data/lib/artifactory/client.rb

@@ -52,10 +52,11 @@ module Artifactory
     proxy Resource::Layout
     proxy Resource::LDAPSetting
     proxy Resource::MailServer
+    proxy Resource::PermissionTarget
     proxy Resource::Repository
+    proxy Resource::System
     proxy Resource::URLBase
     proxy Resource::User
-    proxy Resource::System
 
     #
     # Create a new Artifactory Client with the given options. Any options

data/lib/artifactory/resources/artifact.rb

@@ -185,6 +185,88 @@ module Artifactory
         end
       end
 
+      #
+      # Search for an artifact by its usage
+      #
+      # @example Search for all repositories with the given usage statistics
+      #   Artifact.usage_search(
+      #     notUsedSince: 1388534400000,
+      #     createdBefore: 1388534400000,
+      #   )
+      #
+      # @example Search for all artifacts with the given usage statistics in a repo
+      #   Artifact.usage_search(
+      #     notUsedSince: 1388534400000,
+      #     createdBefore: 1388534400000,
+      #     repos: 'libs-release-local',
+      #   )
+      #
+      # @param [Hash] options
+      #   the list of options to search with
+      #
+      # @option options [Artifactory::Client] :client
+      #   the client object to make the request with
+      # @option options [Long] :notUsedSince
+      #   the last downloaded cutoff date of the artifact to search for (millis since epoch)
+      # @option options [Long] :createdBefore
+      #   the creation cutoff date of the artifact to search for (millis since epoch)
+      # @option options [String, Array<String>] :repos
+      #   the list of repos to search
+      #
+      # @return [Array<Resource::Artifact>]
+      #   a list of artifacts that match the query
+      #
+      def usage_search(options = {})
+        client = extract_client!(options)
+        params = Util.slice(options, :notUsedSince, :createdBefore, :repos)
+        format_repos!(params)
+
+        client.get('/api/search/usage', params)['results'].map do |artifact|
+          from_url(artifact['uri'], client: client)
+        end
+      end
+
+      #
+      # Search for an artifact by its creation date
+      #
+      # @example Search for all repositories with the given creation date range
+      #   Artifact.usage_search(
+      #     from : 1414800000000,
+      #     to   : 1414871200000,
+      #   )
+      #
+      # @example Search for all artifacts with the given creation date range in a repo
+      #   Artifact.usage_search(
+      #     from : 1414800000000,
+      #     to   : 1414871200000,
+      #     repos: 'libs-release-local',
+      #   )
+      #
+      # @param [Hash] options
+      #   the list of options to search with
+      #
+      # @option options [Artifactory::Client] :client
+      #   the client object to make the request with
+      # @option options [Long] :from
+      #   the creation start date of the artifact to search for (millis since epoch)
+      # @option options [Long] :to
+      #   the creation end date of the artifact to search for (millis since epoch)
+      # @option options [String, Array<String>] :repos
+      #   the list of repos to search
+      #
+      # @return [Array<Resource::Artifact>]
+      #   a list of artifacts that match the query
+      #
+      def creation_search(options = {})
+        client = extract_client!(options)
+        params = Util.slice(options, :from, :to, :repos)
+        format_repos!(params)
+
+        client.get('/api/search/creation', params)['results'].map do |artifact|
+          from_url(artifact['uri'], client: client)
+        end
+      end
+
       #
       # Get all versions of an artifact.
       #

data/lib/artifactory/resources/permission_target.rb

@@ -0,0 +1,206 @@
+module Artifactory
+  class Resource::PermissionTarget < Resource::Base
+    VERBOSE_PERMS = {
+      'd' => 'delete',
+      'm' => 'admin',
+      'n' => 'annotate',
+      'r' => 'read',
+      'w' => 'deploy',
+    }
+    class << self
+      #
+      # Get a list of all PermissionTargets 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::PermissionTarget>]
+      #   the list of PermissionTargets
+      #
+      def all(options = {})
+        client = extract_client!(options)
+        client.get('/api/security/permissions').map do |hash|
+          from_url(hash['uri'], client: client)
+        end
+      end
+
+      #
+      # Find (fetch) a permission target by its name.
+      #
+      # @example Find a permission target by its name
+      #   PermissionTarget.find('readers') #=> #<PermissionTarget name: 'readers' ...>
+      #
+      # @param [String] name
+      #   the name of the permission target to find
+      # @param [Hash] options
+      #   the list of options
+      #
+      # @option options [Artifactory::Client] :client
+      #   the client object to make the request with
+      #
+      # @return [Resource::PermissionTarget, nil]
+      #   an instance of the permission target 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/permissions/#{url_safe(name)}")
+        from_hash(response, client: client)
+      rescue Error::HTTPError => e
+        raise unless e.code == 404
+        nil
+      end
+
+      #
+      # @see Resource::Base.from_hash
+      # Additionally use verbose names for permissions (e.g. 'read' for 'r')
+      #
+      def from_hash(hash, options = {})
+        super.tap do |instance|
+          %w(users groups).each do |key|
+            if instance.principals[key] && !instance.principals[key].nil?
+              instance.principals[key] = Hash[instance.principals[key].map { |k, v| [k, verbose(v)] } ]
+            end
+          end
+        end
+      end
+
+      private
+
+      #
+      # Replace an array of permissions with one using verbose permission names
+      #
+      def verbose(array)
+        array.map { |elt| VERBOSE_PERMS[elt] }.sort
+      end
+    end
+
+    class Principal
+      attr_accessor :users, :groups
+
+      def initialize(users = {}, groups = {})
+        @users = users
+        @groups = groups
+      end
+
+      #
+      # Converts the user-friendly form of the principals hash to one suitable
+      # for posting to Artifactory.
+      # @return [Hash]
+      #
+      def to_abbreviated
+        { 'users' => abbreviate_principal(@users), 'groups' => abbreviate_principal(@groups) }
+      end
+
+      private
+
+      #
+      # Replace an array of verbose permission names with an equivalent array of abbreviated permission names.
+      #
+      def abbreviate_permissions(array)
+        inverse = VERBOSE_PERMS.invert
+        if (inverse.keys & array).sort != array.sort then
+          raise "One of your principals contains an invalid permission.  Valid permissions are #{inverse.keys.join(', ')}"
+        end
+        array.map { |elt| inverse[elt] }.sort
+      end
+
+      #
+      # Replace a principal with verbose permissions with an equivalent one with abbreviated permissions.
+      #
+      def abbreviate_principal(principal_hash)
+        Hash[principal_hash.map { |k, v| [k, abbreviate_permissions(v)] } ]
+      end
+    end
+
+    attribute :name, ->{ raise 'Name missing!' }
+    attribute :includes_pattern, '**'
+    attribute :excludes_pattern, ''
+    attribute :repositories
+    attribute :principals, { 'users' => {}, 'groups' => {} }
+
+    def client_principal
+      @client_principal ||= Principal.new(principals['users'], principals['groups'])
+    end
+
+    #
+    # Delete this PermissionTarget 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)
+        true
+      rescue Error::HTTPError
+        false
+    end
+
+    #
+    # Save the PermissionTarget to the artifactory server.
+    # See http://bit.ly/1qMOw0L
+    #
+    # @return [Boolean]
+    #
+    def save
+      send("#{:principals}=", client_principal.to_abbreviated)
+      client.put(api_path, to_json, headers)
+      true
+    end
+
+    #
+    # Getter for groups
+    #
+    def groups
+      client_principal.groups
+    end
+
+    #
+    # Setter for groups (groups_hash expected to be friendly)
+    #
+    def groups=(groups_hash)
+      client_principal.groups = Hash[groups_hash.map { |k, v| [k, v.sort] } ]
+    end
+
+    #
+    # Getter for users
+    #
+    def users
+      client_principal.users
+    end
+
+    #
+    # Setter for users (expecting users_hash to be friendly)
+    #
+    def users=(users_hash)
+      client_principal.users = Hash[users_hash.map { |k, v| [k, v.sort] } ]
+    end
+
+    private
+
+    #
+    # The path to this PermissionTarget on the server.
+    #
+    # @return [String]
+    #
+    def api_path
+      @api_path ||= "/api/security/permissions/#{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.PermissionTarget+json'
+      }
+    end
+  end
+end

data/lib/artifactory/resources/repository.rb

@@ -39,7 +39,7 @@ module Artifactory
       #
       # Find (fetch) a repository by name.
       #
-      # @example Find a respository by named key
+      # @example Find a repository by named key
       #   Repository.find(name: 'libs-release-local') #=> #<Resource::Artifact>
       #
       # @param [Hash] options

data/lib/artifactory/version.rb

@@ -15,5 +15,5 @@
 #
 
 module Artifactory
-  VERSION = '2.1.3'
+  VERSION = '2.2.0'
 end

data/spec/integration/resources/artifact_spec.rb

@@ -52,6 +52,14 @@ module Artifactory
       it_behaves_like 'an artifact search endpoint', :checksum_search, md5: 'abcd1234'
     end
 
+    describe '.usage_search' do
+      it_behaves_like 'an artifact search endpoint', :usage_search, notUsedSince: '1414800000'
+    end
+
+    describe '.creation_search' do
+      it_behaves_like 'an artifact search endpoint', :creation_search, from: '1414800000'
+    end
+
     describe '.versions' do
       it 'returns an array of versions' do
         response = described_class.versions

data/spec/integration/resources/permission_target_spec.rb

@@ -0,0 +1,75 @@
+require 'spec_helper'
+
+module Artifactory
+  describe Resource::PermissionTarget, :integration do
+    describe '.all' do
+      it 'returns an array of PermissionTarget 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
+        anything = results[0]
+        any_remote   = results[1]
+
+        expect(anything.name).to eq('Anything')
+        expect(any_remote.name).to eq('Any Remote')
+      end
+    end
+
+    describe '.find' do
+      it 'finds a permission target by name' do
+        readers = described_class.find('Anything')
+
+        expect(readers).to be_a(described_class)
+        expect(readers.name).to eq('Anything')
+      end
+    end
+
+    describe '#delete' do
+      it 'deletes the permission target from the server' do
+        readers = described_class.find('Anything')
+        expect(readers.delete).to be_truthy
+      end
+    end
+
+    describe '#save' do
+      it 'saves the permission target to the server' do
+        target = described_class.new(name: 'testing')
+        expect(target.save).to be_truthy
+      end
+    end
+
+    describe '#users' do
+      it 'displays the users hash with sorted verbose permissions' do
+        target = described_class.find('Any Remote')
+        expect(target.users).to eq( { 'anonymous' => ['deploy', 'read'] } )
+      end
+    end
+
+    describe '#groups' do
+      it 'displays the groups hash with sorted verbose permissions' do
+        target = described_class.find('Anything')
+        expect(target.groups).to eq( { 'readers' => ['admin', 'read'] } )
+      end
+    end
+
+    describe '#users=' do
+      it 'sets the users hash' do
+        target = described_class.find('Any Remote')
+        target.users = { 'admins' => ['admin'] }
+        expect(target.users).to eq( { 'admins' => ['admin'] })
+      end
+    end
+
+    describe '#groups=' do
+      it 'sets the groups hash' do
+        target = described_class.find('Anything')
+        target.groups = { 'deployers' => ['deploy'] }
+        expect(target.groups).to eq( { 'deployers' => ['deploy'] })
+      end
+    end
+  end
+end

data/spec/support/api_server.rb

@@ -10,6 +10,7 @@ module Artifactory
     require_relative 'api_server/build_endpoints'
     require_relative 'api_server/group_endpoints'
     require_relative 'api_server/repository_endpoints'
+    require_relative 'api_server/permission_target_endpoints'
     require_relative 'api_server/status_endpoints'
     require_relative 'api_server/system_endpoints'
     require_relative 'api_server/user_endpoints'
@@ -17,6 +18,7 @@ module Artifactory
     register APIServer::ArtifactEndpoints
     register APIServer::BuildEndpoints
     register APIServer::GroupEndpoints
+    register APIServer::PermissionTargetEndpoints
     register APIServer::RepositoryEndpoints
     register APIServer::StatusEndpoints
     register APIServer::SystemEndpoints

data/spec/support/api_server/artifact_endpoints.rb

@@ -32,6 +32,20 @@ module Artifactory
         end
       end
 
+      app.get('/api/search/usage') do
+        content_type 'application/vnd.org.jfrog.artifactory.search.ArtifactUsageResult+json'
+        artifacts_for_conditions do
+          params['notUsedSince'] == '1414800000'
+        end
+      end
+
+      app.get('/api/search/creation') do
+        content_type 'application/vnd.org.jfrog.artifactory.search.ArtifactCreationResult+json'
+        artifacts_for_conditions do
+          params['from'] == '1414800000'
+        end
+      end
+
       app.get('/api/search/versions') do
         content_type 'application/vnd.org.jfrog.artifactory.search.ArtifactVersionsResult+json'
         JSON.fast_generate(

data/spec/support/api_server/permission_target_endpoints.rb

@@ -0,0 +1,53 @@
+module Artifactory
+  module APIServer::PermissionTargetEndpoints
+    def self.registered(app)
+      app.get('/api/security/permissions') do
+        content_type 'application/vnd.org.jfrog.artifactory.security.PermissionTargets+json'
+        JSON.fast_generate([
+          {
+            'name' => 'Anything',
+            'uri'  => server_url.join('/api/security/permissions/Anything'),
+          },
+          {
+            'name' => 'Any Remote',
+            'uri'  => server_url.join('/api/security/permissions/Any%20Remote')
+          }
+        ])
+      end
+
+      app.get('/api/security/permissions/Any%20Remote') do
+        content_type 'application/vnd.org.jfrog.artifactory.security.PermissionTargets+json'
+        JSON.fast_generate(
+          'name'             => 'Any Remote',
+          'includes_pattern'  => nil,
+          'excludes_pattern' => '',
+          'repositories'     => ["ANY REMOTE"],
+          'principals'       => { 'users' => { 'anonymous' => ['w', 'r'] }, 'groups' => nil }
+        )
+      end
+
+      app.get('/api/security/permissions/Anything') do
+        content_type 'application/vnd.org.jfrog.artifactory.security.PermissionTargets+json'
+        JSON.fast_generate(
+          'name'             => 'Anything',
+          'includes_pattern'  => nil,
+          'excludes_pattern' => '',
+          'repositories'     => ["ANY"],
+          'principals'       =>  { 'users' => { 'anonymous' => ['r'] }, 'groups' => { 'readers' => ['r', 'm'] } }
+        )
+      end
+
+      app.put('/api/security/permissions/:name') do
+        return 415 unless request.content_type == 'application/vnd.org.jfrog.artifactory.security.PermissionTarget+json'
+
+        # Attempt to parse the response; if this succeeds, all is well...
+        JSON.parse(request.body.read)
+        nil
+      end
+
+      app.delete('/api/security/permissions/:name') do
+        nil
+      end
+    end
+  end
+end

data/spec/unit/resources/artifact_spec.rb

@@ -207,6 +207,56 @@ module Artifactory
       end
     end
 
+    describe '.usage_search' do
+      let(:response) { { 'results' => [] } }
+
+      it 'calls /api/search/usage' do
+        expect(client).to receive(:get).with('/api/search/usage', {}).once
+        described_class.usage_search
+      end
+
+      it 'slices the correct parameters' do
+        expect(client).to receive(:get).with('/api/search/usage',
+          notUsedSince:  1414800000000,
+          createdBefore: 1414871200000,
+        ).once
+        described_class.usage_search(
+          notUsedSince:  1414800000000,
+          createdBefore: 1414871200000,
+          fizz: 'foo',
+        )
+      end
+
+      it 'returns an array of objects' do
+        expect(described_class.usage_search).to be_a(Array)
+      end
+    end
+
+    describe '.creation_search' do
+      let(:response) { { 'results' => [] } }
+
+      it 'calls /api/search/creation' do
+        expect(client).to receive(:get).with('/api/search/creation', {}).once
+        described_class.creation_search
+      end
+
+      it 'slices the correct parameters' do
+        expect(client).to receive(:get).with('/api/search/creation',
+          from:  1414800000000,
+          to: 1414871200000,
+        ).once
+        described_class.creation_search(
+          from:  1414800000000,
+          to: 1414871200000,
+          fizz: 'foo',
+        )
+      end
+
+      it 'returns an array of objects' do
+        expect(described_class.creation_search).to be_a(Array)
+      end
+    end
+
     describe '.versions' do
       let(:response) { { 'results' => [] } }
 

data/spec/unit/resources/permission_target_spec.rb

@@ -0,0 +1,186 @@
+require 'spec_helper'
+
+module Artifactory
+  describe Resource::PermissionTarget do
+    let(:client) { double(:client) }
+
+    before(:each) do
+      allow(Artifactory).to receive(:client).and_return(client)
+      allow(client).to receive(:get).and_return(response) if defined?(response)
+    end
+
+    describe '.all' do
+      let(:response) do
+        [
+          { 'uri' => 'a' },
+          { 'uri' => 'b' },
+          { 'uri' => 'c' },
+        ]
+      end
+      before do
+        allow(described_class).to receive(:from_url).with('a', client: client).and_return('a')
+        allow(described_class).to receive(:from_url).with('b', client: client).and_return('b')
+        allow(described_class).to receive(:from_url).with('c', client: client).and_return('c')
+      end
+
+      it 'gets /api/security/permissions' do
+        expect(client).to receive(:get).with('/api/security/permissions').once
+        described_class.all
+      end
+
+      it 'returns the permissions' do
+        expect(described_class.all).to eq(['a', 'b', 'c'])
+      end
+    end
+
+    describe '.find' do
+      let(:response) { {} }
+
+      it 'gets /api/security/permissions/#{name}' do
+        expect(client).to receive(:get).with('/api/security/permissions/Any%20Remote').once
+        described_class.find('Any Remote')
+      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/permissions/Any Remote')
+      end
+    end
+
+    describe '.from_hash' do
+      let(:hash) do
+        {
+          'name'             => 'Test Remote',
+          'includes_pattern'  => '**',
+          'excludes_pattern' => '',
+          'repositories'     => ['ANY REMOTE'],
+          'principals'       => { 'users' => { 'anonymous' => ['w', 'r'] }, 'groups'  => {} }
+        }
+      end
+
+      it 'creates a new instance' do
+        instance = described_class.from_hash(hash)
+        expect(instance.name).to eq('Test Remote')
+        expect(instance.includes_pattern).to eq('**')
+        expect(instance.excludes_pattern).to eq('')
+        expect(instance.repositories).to eq(['ANY REMOTE'])
+        expect(instance.principals).to eq({ 'users' => { 'anonymous' => ['deploy', 'read'] }, 'groups' => {} })
+      end
+    end
+
+    describe Artifactory::Resource::PermissionTarget::Principal do
+      context 'principal object' do
+        users = { 'anonymous_users' => ['admin', 'deploy', 'read'] }
+        groups = { 'anonymous_groups' => ['delete', 'read'] }
+        instance = described_class.new(users, groups)
+
+        it 'has unabbreviated users' do
+          expect(instance.users).to eq( { 'anonymous_users' => ['admin', 'deploy', 'read'] } )
+        end
+
+        it 'has unabbreviated groups' do
+          expect(instance.groups).to eq( { 'anonymous_groups' => ['delete', 'read'] } )
+        end
+
+        it 'abbreviates' do
+          expect(instance.to_abbreviated).to eq( { 'users' => { 'anonymous_users' => ['m', 'r', 'w'] }, 'groups' => { 'anonymous_groups' => ['d', 'r'] } } )
+        end
+      end
+    end
+
+    describe '#save' do
+      let(:client) { double }
+      before do
+        subject.client = client
+        subject.name = 'TestRemote'
+        subject.includes_pattern = nil
+        subject.excludes_pattern = ''
+        subject.repositories = ['ANY']
+        subject.principals = {
+          'users' => {
+            'anonymous_users' => ['read']
+          },
+          'groups' => {
+            'anonymous_readers' => ['read']
+          }
+        }
+        allow(described_class).to receive(:find).with(subject.name, client: client).and_return(nil)
+      end
+
+      it 'PUTS the permission target to the server' do
+        expect(client).to receive(:put).with("/api/security/permissions/TestRemote",
+          "{\"name\":\"TestRemote\",\"includesPattern\":null,\"excludesPattern\":\"\",\"repositories\":[\"ANY\"],\"principals\":{\"users\":{\"anonymous_users\":[\"r\"]},\"groups\":{\"anonymous_readers\":[\"r\"]}}}",
+          { "Content-Type" => "application/vnd.org.jfrog.artifactory.security.PermissionTarget+json"})
+        subject.save
+      end
+    end
+
+    describe '#delete' do
+      let(:client) { double }
+
+      it 'sends DELETE to the client' do
+        subject.client = client
+        subject.name = 'My Permissions'
+
+        expect(client).to receive(:delete).with('/api/security/permissions/My%20Permissions')
+        subject.delete
+      end
+    end
+
+    describe 'getters' do
+      let(:client) { double }
+      before do
+        subject.client = client
+        subject.name = 'TestGetters'
+        subject.principals = {
+          'users' => {
+            'anonymous' => ['read']
+          },
+          'groups' => {
+            'readers' => ['read']
+          }
+        }
+        allow(described_class).to receive(:find).with(subject.name, client: client).and_return(nil)
+      end
+
+      it '#users returns the users hash' do
+        expect(subject.users).to eq({ 'anonymous' => ['read'] })
+      end
+
+      it '#groups returns the groups hash' do
+        expect(subject.groups).to eq({ 'readers' => ['read'] })
+      end
+    end
+
+    describe 'setters' do
+      let(:client) { double }
+      before do
+        subject.client = client
+        subject.name = 'TestSetters'
+        subject.principals = {
+          'users' => {
+            'anonymous' => ['read']
+          },
+          'groups' => {
+            'readers' => ['read']
+          }
+        }
+        allow(described_class).to receive(:find).with(subject.name, client: client).and_return(nil)
+      end
+
+      it '#users= sets the users hash' do
+        subject.users = { 'spiders' => [ 'read', 'admin'] }
+        expect(subject.users).to eq({ 'spiders' => ['admin', 'read'] })
+      end
+
+      it '#groups= sets the groups hash' do
+        subject.groups = { 'beatles' => [ 'deploy', 'delete'] }
+        expect(subject.groups).to eq({ 'beatles' => ['delete', 'deploy'] })
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: artifactory
 version: !ruby/object:Gem::Version
-  version: 2.1.3
+  version: 2.2.0
 platform: ruby
 authors:
 - Seth Vargo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-29 00:00:00.000000000 Z
+date: 2014-11-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -67,6 +67,7 @@ files:
 - lib/artifactory/resources/layout.rb
 - lib/artifactory/resources/ldap_setting.rb
 - lib/artifactory/resources/mail_server.rb
+- lib/artifactory/resources/permission_target.rb
 - lib/artifactory/resources/plugin.rb
 - lib/artifactory/resources/repository.rb
 - lib/artifactory/resources/system.rb
@@ -81,6 +82,7 @@ files:
 - spec/integration/resources/layout_spec.rb
 - spec/integration/resources/ldap_setting_spec.rb
 - spec/integration/resources/mail_server_spec.rb
+- spec/integration/resources/permission_target_spec.rb
 - spec/integration/resources/repository_spec.rb
 - spec/integration/resources/system_spec.rb
 - spec/integration/resources/url_base_spec.rb
@@ -90,6 +92,7 @@ files:
 - 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/permission_target_endpoints.rb
 - spec/support/api_server/repository_endpoints.rb
 - spec/support/api_server/status_endpoints.rb
 - spec/support/api_server/system_endpoints.rb
@@ -104,6 +107,7 @@ files:
 - spec/unit/resources/layout_spec.rb
 - spec/unit/resources/ldap_setting_spec.rb
 - spec/unit/resources/mail_server_spec.rb
+- spec/unit/resources/permission_target_spec.rb
 - spec/unit/resources/plugin_spec.rb
 - spec/unit/resources/repository_spec.rb
 - spec/unit/resources/system_spec.rb
@@ -142,6 +146,7 @@ test_files:
 - spec/integration/resources/layout_spec.rb
 - spec/integration/resources/ldap_setting_spec.rb
 - spec/integration/resources/mail_server_spec.rb
+- spec/integration/resources/permission_target_spec.rb
 - spec/integration/resources/repository_spec.rb
 - spec/integration/resources/system_spec.rb
 - spec/integration/resources/url_base_spec.rb
@@ -151,6 +156,7 @@ test_files:
 - 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/permission_target_endpoints.rb
 - spec/support/api_server/repository_endpoints.rb
 - spec/support/api_server/status_endpoints.rb
 - spec/support/api_server/system_endpoints.rb
@@ -165,6 +171,7 @@ test_files:
 - spec/unit/resources/layout_spec.rb
 - spec/unit/resources/ldap_setting_spec.rb
 - spec/unit/resources/mail_server_spec.rb
+- spec/unit/resources/permission_target_spec.rb
 - spec/unit/resources/plugin_spec.rb
 - spec/unit/resources/repository_spec.rb
 - spec/unit/resources/system_spec.rb