nexus_api 1.4.1 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1524dfad12c5d501e3d8d6c90a7cd712c8ded00a526093239c04aff862323546
-  data.tar.gz: a1c22bcdd81c450a79cbabf5adeab806eef96f2ae0b70fbe8401f5042f23e0d0
+  metadata.gz: ae2066e62934bcfeed3480aa351da4ad8053d258c762b4ed8cfc006a64eae7c3
+  data.tar.gz: 597ba898fabbf3efcb1c2ab22f0557875d33cb6af24fd8a9338cf7be4c83b942
 SHA512:
-  metadata.gz: 52ee4482ce15c00b1eae0064c0445c6862cd4bc876e915335c923bc2f1f024bd0cb0cdee09ac41d917fe7d1abfe3a5f4dbcc717894e36e8e5a016eb54605b82e
-  data.tar.gz: ff03e64fdeb4e9c28ffcc94329ca79e2526411982ae36f40177dab99dbef6279810e5bebdfbae5fb50ec324f7f61fc64b6d8a3218b93e726ba44e44183fd3f5a
+  metadata.gz: 3015d930671ca0f18b89647f55a2fda2496c5ddd5c3df9540cd2d0012530a8ecf379f9aeaead6ab7a8a132e45c825cf89d25a78efb2b58b999343698a6d6531d
+  data.tar.gz: f217d6c26156c2dc7960ce5f393b211bdc560134ede1cb95658a7c0e4b54c4f6b02f8ff4e055f2d573c0082e487f223cd90018966ef97249d390e8d0c8ad386b

data/CHANGELOG.md

@@ -5,6 +5,14 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
+## [1.5.0](https://github.com/Cisco-AMP/nexus_api/compare/v1.4.1...v1.5.0) - 2020-06-10
+### Added
+- New methods around the `privileges` endpoint
+- New methods around the `roles` endpoint
+- New methods around the `users` endpoint
+- New `list_all_*` methods for endpoints that paginate so the user doesn't have to page through results themselves if they just want all the raw data
+
+
 ## [1.4.1](https://github.com/Cisco-AMP/nexus_api/compare/v1.4.0...v1.4.1) - 2020-05-08
 ### Changed
 - Error reporting to be more descriptive

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    nexus_api (1.4.1)
+    nexus_api (1.5.0)
       bundler (~> 2)
       docker-api (~> 1.34.2)
       dotenv (~> 2.7.5)
@@ -34,7 +34,7 @@ GEM
     method_source (0.9.2)
     mime-types (3.3.1)
       mime-types-data (~> 3.2015)
-    mime-types-data (3.2020.0425)
+    mime-types-data (3.2020.0512)
     multi_json (1.14.1)
     netrc (0.11.0)
     pry (0.12.2)
@@ -84,4 +84,4 @@ DEPENDENCIES
   webmock (~> 3.8)
 
 BUNDLED WITH
-   2.0.2
+   2.1.4

data/README.md

@@ -59,21 +59,24 @@ api = NexusAPI::API.new(
   username: NEXUS_USERNAME,
   password: NEXUS_PASSWORD,
   hostname: NEXUS_HOSTNAME,
-  docker_pull_hostname: DOCKER_PUSH_HOSTNAME,  # Optional
-  docker_push_hostname: DOCKER_PULL_HOSTNAME,  # Optional
+  docker_pull_hostname: DOCKER_PULL_HOSTNAME,  # Optional
+  docker_push_hostname: DOCKER_PUSH_HOSTNAME,  # Optional
   config: "team_configs/#{CONFIG_NAME}",       # Optional
 )
 # NOTE: All Docker commands will fail if the docker hostnames are not initialized
 
 # You can query information through the list methods
-api.list_repositories
-api.list_repository_names
 api.list_assets(repository: REPOSITORY_NAME)
 api.list_asset(id: ASSET_ID)
 api.list_components(repository: REPOSITORY_NAME)
 api.list_component(id: ASSET_ID)
+api.list_privileges
+api.list_repositories
+api.list_repository_names
+api.list_roles
 api.list_scripts
 api.list_tags
+api.list_users
 
 # You can search for an asset by its name
 # Optionally, you can pass in additional fields to filter the results
@@ -90,7 +93,12 @@ api.search_asset(
 #  - list_components
 #  - list_tags
 #  - search_asset
-# You can use the following pattern to page through each method:
+# You can use the following methods to automatically gather data from all pages for you:
+#  - list_all_assets
+#  - list_all_components
+#  - list_all_tags
+#  - search_all_assets
+# Or you can use the following pattern to page through if additional processing is desired:
 set = Array.new.tap do |set|
   loop do
     set.concat(api.METHOD_YOU_WANT(ARGUMENTS, paginate: true))

data/lib/endpoints/assets.rb

@@ -6,6 +6,15 @@ module NexusAPI
       @connection.get_response(endpoint: "assets?repository=#{repository}", paginate: paginate)
     end
 
+    def list_all_assets(repository: nil)
+      assets = Array.new.tap do |assets|
+        loop do
+          assets.concat(list_assets(repository: repository, paginate: true))
+          break unless paginate?
+        end
+      end
+    end
+
     # GET /service/rest/v1/assets/{id}
     def list_asset(id:)
       @connection.get_response(endpoint: "assets/#{id}")

data/lib/endpoints/components.rb

@@ -6,6 +6,15 @@ module NexusAPI
       @connection.get_response(endpoint: "components?repository=#{repository}", paginate: paginate)
     end
 
+    def list_all_components(repository: nil)
+      components = Array.new.tap do |components|
+        loop do
+          components.concat(list_components(repository: repository, paginate: true))
+          break unless paginate?
+        end
+      end
+    end
+
     # POST /service/rest/v1/components
     def upload_maven_component(filename:, group_id:, artifact_id:, version:, repository: nil, tag: nil)
       repository ||= @team_config.maven_repository

data/lib/endpoints/privileges.rb

@@ -1,8 +1,20 @@
 module NexusAPI
   class API
     # GET /service/rest/beta/security/privileges
+    def list_privileges
+      @connection.get_response(endpoint: 'security/privileges', api_version: 'beta')
+    end
+
     # GET /service/rest/beta/security/privileges/{privilegeId}
+    def list_privilege(privilege_id:)
+      @connection.get_response(endpoint: "security/privileges/#{privilege_id}", api_version: 'beta')
+    end
+
     # DELETE /service/rest/beta/security/privileges/{privilegeId}
+    def delete_privilege(privilege_id:)
+      @connection.delete(endpoint: "security/privileges/#{privilege_id}", api_version: 'beta')
+    end
+
     # POST /service/rest/beta/security/privileges/application
     # PUT /service/rest/beta/security/privileges/application/{privilegeId}
     # POST /service/rest/beta/security/privileges/repository-admin
@@ -10,6 +22,21 @@ module NexusAPI
     # POST /service/rest/beta/security/privileges/repository-content-selector
     # PUT /service/rest/beta/security/privileges/repository-content-selector/{privilegeId}
     # POST /service/rest/beta/security/privileges/repository-view
+    def create_privilege_repository_view(name:, description: nil, actions: ['READ'], format: '*', repository: '*')
+      parameters = {
+        # The name is also used as the privilege_id
+        'name' => name,
+        'description' => description,
+        # READ, BROWSE, EDIT, ADD, DELETE, RUN, ASSOCIATE, DISASSOCIATE, ALL
+        'actions' => actions,
+        # The repository format (i.e 'nuget', 'npm') this privilege will grant access to (or * for all)
+        'format' => format,
+        # The name of the repository this privilege will grant access to (or * for all)
+        'repository' => repository
+      }
+      @connection.post(endpoint: 'security/privileges/repository-view', parameters: parameters, api_version: 'beta')
+    end
+
     # PUT /service/rest/beta/security/privileges/repository-view/{privilegeId}
     # POST /service/rest/beta/security/privileges/script
     # PUT /service/rest/beta/security/privileges/script/{privilegeId}

data/lib/endpoints/roles.rb

@@ -1,9 +1,31 @@
 module NexusAPI
   class API
     # GET /service/rest/beta/security/roles
+    def list_roles
+      @connection.get_response(endpoint: 'security/roles', api_version: 'beta')
+    end
+
     # POST /service/rest/beta/security/roles
+    def create_role(id:, name:, description: nil, privileges: [], roles: [])
+      parameters = {
+        'id' => id,
+        'name' => name,
+        'description' => description,
+        'privileges' => privileges,
+        'roles' => roles
+      }
+      @connection.post(endpoint: 'security/roles', parameters: parameters, api_version: 'beta')
+    end
+
     # GET /service/rest/beta/security/roles/{id}
+    def list_role(id:)
+      @connection.get_response(endpoint: "security/roles/#{id}?source=default", api_version: 'beta')
+    end
+
     # PUT /service/rest/beta/security/roles/{id}
     # DELETE /service/rest/beta/security/roles/{id}
+    def delete_role(id:)
+      @connection.delete(endpoint: "security/roles/#{id}", api_version: 'beta')
+    end
   end
 end

data/lib/endpoints/search.rb

@@ -13,6 +13,23 @@ module NexusAPI
       @connection.get_response(endpoint: endpoint, paginate: paginate)
     end
 
+    def search_all_assets(name:, format: nil, repository: nil, sha1: nil, version: nil)
+      results = Array.new.tap do |results|
+        loop do
+          results.concat(
+            search_asset(
+              name: name,
+              format: format,
+              repository: repository,
+              sha1: sha1,
+              version: version,
+              paginate: true
+            ))
+          break unless paginate?
+        end
+      end
+    end
+
     # GET /service/rest/v1/search/assets/download
   end
 end

data/lib/endpoints/tags.rb

@@ -5,6 +5,15 @@ module NexusAPI
       @connection.get_response(endpoint: 'tags', paginate: paginate)
     end
 
+    def list_all_tags
+      tags = Array.new.tap do |tags|
+        loop do
+          tags.concat(list_tags(paginate: true))
+          break unless paginate?
+        end
+      end
+    end
+
     # POST /service/rest/v1/tags
     def create_tag(name:)
       parameters = JSON.dump({

data/lib/endpoints/users.rb

@@ -1,9 +1,30 @@
 module NexusAPI
   class API
     # GET /service/rest/beta/security/users
+    def list_users
+      @connection.get_response(endpoint: 'security/users', api_version: 'beta')
+    end
+
     # POST /service/rest/beta/security/users
+    def create_user(user_id:, first_name:, last_name:, email:, password:, roles:)
+      parameters = {
+        'userId' => user_id,
+        'firstName' => first_name,
+        'lastName' => last_name,
+        'emailAddress' => email,
+        'password' => password,
+        'status' => 'active',
+        'roles' => roles,
+      }
+      @connection.post(endpoint: 'security/users', parameters: parameters, api_version: 'beta')
+    end
+
     # PUT /service/rest/beta/security/users/{userId}
     # DELETE /service/rest/beta/security/users/{userId}
+    def delete_user(user_id:)
+      @connection.delete(endpoint: "security/users/#{user_id}", api_version: 'beta')
+    end
+
     # PUT /service/rest/beta/security/users/{userId}/change-password
     # DELETE /service/rest/beta/security/users/{userId}/user-token
   end

data/lib/nexus_api/cli_commands/list.rb

@@ -51,16 +51,31 @@ module NexusAPI
       print_paginating_set(action: :list_components, params: {repository: options[:repository]}, filter: 'name', proc: proc)
     end
 
+    desc 'privileges', 'Prints out a list of all privileges'
+    def privileges
+      print_set(action: :list_privileges, filter: 'name')
+    end
+
     desc 'repositories', 'Prints out a list of all repositories'
     def repositories
       print_set(action: :list_repositories, filter: 'name')
     end
 
+    desc 'roles', 'Prints out a list of all roles'
+    def roles
+      print_set(action: :list_roles, filter: 'name')
+    end
+
     desc 'status', 'Prints out if the Nexus server can respond to read and write requests'
     def status
       setup
       puts "Nexus can respond to read requests:  #{@api.status}"
       puts "Nexus can respond to write requests: #{@api.status_writable}"
     end
+
+    desc 'users', 'Prints out a list of all users'
+    def users
+      print_set(action: :list_users, filter: 'emailAddress')
+    end
   end
 end

data/lib/nexus_api/nexus_connection.rb

@@ -116,6 +116,7 @@ module NexusAPI
     end
 
     def send_request(connection_method, endpoint, parameters: '', headers: {}, api_version: 'v1')
+      parameters = parameters.to_json if headers['Content-Type'] == 'application/json'
       url = "https://#{@hostname}/service/rest/#{api_version}/#{endpoint}"
       catch_connection_error do
         RestClient::Request.execute(

data/lib/nexus_api/version.rb

@@ -1,4 +1,4 @@
 module NexusAPI
-  VERSION = '1.4.1'
+  VERSION = '1.5.0'
 end
 

data/lib/utilities/parameter_builder.rb

@@ -30,7 +30,7 @@ module NexusAPI
           'forceBasicAuth' => true,
           'httpPort' => port
         }
-      }.to_json
+      }
     end
 
     def self.maven_hosted(name, write_policy: ALLOW_ONCE, version_policy: RELEASE, layout_policy: STRICT)
@@ -46,7 +46,7 @@ module NexusAPI
           'versionPolicy' => version_policy,
           'layoutPolicy' => layout_policy
         }
-      }.to_json
+      }
     end
 
     def self.npm_hosted(name, write_policy: ALLOW_ONCE)
@@ -58,7 +58,7 @@ module NexusAPI
           'strictContentTypeValidation' => true,
           'writePolicy' => write_policy
         }
-      }.to_json
+      }
     end
 
     def self.pypi_hosted(name, write_policy: ALLOW_ONCE)
@@ -70,7 +70,7 @@ module NexusAPI
           'strictContentTypeValidation' => true,
           'writePolicy' => write_policy
         }
-      }.to_json
+      }
     end
 
     def self.yum_hosted(name, depth, write_policy: ALLOW_ONCE, deploy_policy: STRICT)
@@ -86,7 +86,7 @@ module NexusAPI
           'repodataDepth' => depth,
           'deployPolicy' => deploy_policy
         }
-      }.to_json
+      }
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nexus_api
 version: !ruby/object:Gem::Version
-  version: 1.4.1
+  version: 1.5.0
 platform: ruby
 authors:
 - Francis Levesque