nexus_api 1.0.4 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 07dd575297d828538f762c39b116f348b220e4bce0472ab3a10950b801e4bf18
-  data.tar.gz: 0b33bb52c7f8775fe92d113cd4b38f3bd088e58f9a1883abeea47f1e23afac53
+  metadata.gz: 54540d2831ebe3afc8edbb9dbb5e32f68100d3f4618306d0818edb00ed74a3c8
+  data.tar.gz: d950c2e81a149d411b3d13fb6635488ff79f794d0d7a585069b8a2b39915ebc6
 SHA512:
-  metadata.gz: 5c254a794bb8edf24992eb4b8ca7dccd9d601a5c2451eabb4dd8a223dc74a5e90994a7a122fc68fb69e73fb75e15bb343a17d85c7b8fcc98b6391f976289d838
-  data.tar.gz: d21310b932b4fc7539c33fee22ff77c0bdee0f8fbd8a59d17e62f34eb19e87959689b0c4061a2676083b482119c3271ba31c5af736d91e19c27f5697158885d6
+  metadata.gz: 2a24f487215f4994725270ac80c522257622113f86019f0f99af7d02d8abad5564bfbb6a353ffb12b851b0b69f3af8b2571e31a313b13bdf7ea63fe3d5000953
+  data.tar.gz: 7e9a259841115128402c789caf2b72e84160c50949f08367c38acb9199c6136e8fe0f5620e0eda9fa2c33cb6b40fb1943a8bf8e14f559b4cd7a428837213a8a4

data/CHANGELOG.md

@@ -5,6 +5,15 @@ 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.1.0](https://github.com/Cisco-AMP/nexus_api/compare/v1.0.4...v1.1.0) - 2020-04-20
+### Changed
+- `list_repositories` to use the new `beta` API version which returns richer content than the old `v1` version
+
+### Added
+- create methods for hosted `docker`, `maven`, `npm`, `pypi`, and `yum` repository types (`raw` and `rubygems` aren't supported yet)
+- delete method for any repository type
+
+
 ## [1.0.4](https://github.com/Cisco-AMP/nexus_api/compare/v1.0.3...v1.0.4) - 2020-03-23
 ### Added
 - URL escaping

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    nexus_api (1.0.4)
+    nexus_api (1.1.0)
       bundler (~> 2)
       docker-api (~> 1.34.2)
       dotenv (~> 2.7.5)
@@ -13,7 +13,11 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
+    addressable (2.7.0)
+      public_suffix (>= 2.0.2, < 5.0)
     coderay (1.1.2)
+    crack (0.4.3)
+      safe_yaml (~> 1.0.0)
     diff-lcs (1.3)
     docile (1.3.2)
     docker-api (1.34.2)
@@ -22,12 +26,13 @@ GEM
     domain_name (0.5.20190701)
       unf (>= 0.0.5, < 1.0.0)
     dotenv (2.7.5)
-    excon (0.72.0)
+    excon (0.73.0)
+    hashdiff (1.0.1)
     http-accept (1.7.0)
     http-cookie (1.0.3)
       domain_name (~> 0.5)
     method_source (0.9.2)
-    mime-types (3.3)
+    mime-types (3.3.1)
       mime-types-data (~> 3.2015)
     mime-types-data (3.2019.1009)
     multi_json (1.14.1)
@@ -35,6 +40,7 @@ GEM
     pry (0.12.2)
       coderay (~> 1.1.0)
       method_source (~> 0.9.0)
+    public_suffix (4.0.4)
     rake (10.5.0)
     rest-client (2.1.0)
       http-accept (>= 1.7.0, < 2.0)
@@ -54,6 +60,7 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
     rspec-support (3.9.0)
+    safe_yaml (1.0.5)
     simplecov (0.18.5)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
@@ -61,7 +68,11 @@ GEM
     thor (0.20.3)
     unf (0.1.4)
       unf_ext
-    unf_ext (0.0.7.6)
+    unf_ext (0.0.7.7)
+    webmock (3.8.3)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
 
 PLATFORMS
   ruby
@@ -69,7 +80,8 @@ PLATFORMS
 DEPENDENCIES
   nexus_api!
   rspec (~> 3.0)
-  simplecov (~> 0.18.5)
+  simplecov (~> 0.18)
+  webmock (~> 3.8)
 
 BUNDLED WITH
    2.0.2

data/lib/endpoints/assets.rb

@@ -0,0 +1,16 @@
+module NexusAPI
+  class API
+    # GET /service/rest/v1/assets
+    def list_assets(repository: nil, paginate: false)
+      repository ||= @team_config.assets_repository
+      @connection.get_response(endpoint: "assets?repository=#{repository}", paginate: paginate)
+    end
+
+    # GET /service/rest/v1/assets/{id}
+    def list_asset(id:)
+      @connection.get_response(endpoint: "assets/#{id}")
+    end
+
+    # DELETE /service/rest/v1/assets/{id}
+  end
+end

data/lib/endpoints/blobstore.rb

@@ -0,0 +1,17 @@
+module NexusAPI
+  class API
+    # GET /service/rest/beta/blobstores
+    # DELETE /service/rest/beta/blobstores/{name}
+    # POST /service/rest/beta/blobstores/file
+    # GET /service/rest/beta/blobstores/file/{name}
+    # PUT /service/rest/beta/blobstores/file/{name}
+    # POST /service/rest/beta/blobstores/group
+    # GET /service/rest/beta/blobstores/group/{name}
+    # PUT /service/rest/beta/blobstores/group/{name}
+    # POST /service/rest/beta/blobstores/group/promote/{name}
+    # POST /service/rest/beta/blobstores/s3
+    # GET /service/rest/beta/blobstores/s3/{name}
+    # PUT /service/rest/beta/blobstores/s3/{name}
+    # GET /service/rest/v1/blobstores/{id}/quota-status
+  end
+end

data/lib/endpoints/components.rb

@@ -0,0 +1,79 @@
+module NexusAPI
+  class API
+    # GET /service/rest/v1/components
+    def list_components(repository: nil, paginate: false)
+      repository ||= @team_config.components_repository
+      @connection.get_response(endpoint: "components?repository=#{repository}", paginate: paginate)
+    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
+      parameters = {
+        'maven2.groupId' => group_id,
+        'maven2.artifactId' => artifact_id,
+        'maven2.version' => version,
+        'maven2.asset1' => File.open(filename, 'r'),
+        'maven2.asset1.extension' => filename.split('.').last,
+      }
+      parameters['maven2.tag'] = tag if tag
+      @connection.post(endpoint: "components?repository=#{repository}", parameters: parameters, headers: {})
+    end
+
+    def upload_npm_component(filename:, repository: nil, tag: nil)
+      repository ||= @team_config.npm_repository
+      parameters = {
+        'npm.asset' => File.open(filename, 'r'),
+      }
+      parameters['npm.tag'] = tag if tag
+      @connection.post(endpoint: "components?repository=#{repository}", parameters: parameters, headers: {})
+    end
+
+    def upload_pypi_component(filename:, repository: nil, tag: nil)
+      repository ||= @team_config.pypi_repository
+      parameters = {
+        'pypi.asset' => File.open(filename, 'r'),
+      }
+      parameters['pypi.tag'] = tag if tag
+      @connection.post(endpoint: "components?repository=#{repository}", parameters: parameters, headers: {})
+    end
+
+    def upload_raw_component(filename:, directory:, repository: nil, tag: nil)
+      repository ||= @team_config.raw_repository
+      parameters = {
+        'raw.directory' => directory,
+        'raw.asset1' => File.open(filename, 'r'),
+        'raw.asset1.filename' => filename.split('/').last,
+      }
+      parameters['raw.tag'] = tag if tag
+      @connection.post(endpoint: "components?repository=#{repository}", parameters: parameters, headers: {})
+    end
+
+    def upload_rubygems_component(filename:, repository: nil, tag: nil)
+      repository ||= @team_config.rubygems_repository
+      parameters = {
+        'rubygems.asset' => File.open(filename, 'r'),
+      }
+      parameters['rubygems.tag'] = tag if tag
+      @connection.post(endpoint: "components?repository=#{repository}", parameters: parameters, headers: {})
+    end
+
+    def upload_yum_component(filename:, directory:, repository: nil, tag: nil)
+      repository ||= @team_config.yum_repository
+      parameters = {
+        'yum.directory' => directory,
+        'yum.asset' => File.open(filename, 'r'),
+        'yum.asset.filename' => filename.split('/').last,
+      }
+      parameters['yum.tag'] = tag if tag
+      @connection.post(endpoint: "components?repository=#{repository}", parameters: parameters, headers: {})
+    end
+
+    # GET /service/rest/v1/components/{id}
+    def list_component(id:)
+      @connection.get_response(endpoint: "components/#{id}")
+    end
+
+    # DELETE /service/rest/v1/components/{id}
+  end
+end

data/lib/endpoints/content-selectors.rb

@@ -0,0 +1,9 @@
+module NexusAPI
+  class API
+    # GET /service/rest/beta/security/content-selectors
+    # POST /service/rest/beta/security/content-selectors
+    # GET /service/rest/beta/security/content-selectors/{name}
+    # PUT /service/rest/beta/security/content-selectors/{name}
+    # DELETE /service/rest/beta/security/content-selectors/{name}
+  end
+end

data/lib/endpoints/email.rb

@@ -0,0 +1,8 @@
+module NexusAPI
+  class API
+    # GET /service/rest/beta/email
+    # PUT /service/rest/beta/email
+    # DELETE /service/rest/beta/email
+    # POST /service/rest/beta/email/verify
+  end
+end

data/lib/endpoints/formats.rb

@@ -0,0 +1,6 @@
+module NexusAPI
+  class API
+    # GET /service/rest/v1/formats/{format}/upload-specs
+    # GET /service/rest/v1/formats/upload-specs
+  end
+end

data/lib/endpoints/iq.rb

@@ -0,0 +1,9 @@
+module NexusAPI
+  class API
+    # GET /service/rest/beta/iq
+    # PUT /service/rest/beta/iq
+    # POST /service/rest/beta/iq/disable
+    # POST /service/rest/beta/iq/enable
+    # POST /service/rest/beta/iq/verify-connection
+  end
+end

data/lib/endpoints/ldap.rb

@@ -0,0 +1,10 @@
+module NexusAPI
+  class API
+    # GET /service/rest/beta/security/ldap
+    # POST /service/rest/beta/security/ldap
+    # GET /service/rest/beta/security/ldap/{name}
+    # PUT /service/rest/beta/security/ldap/{name}
+    # DELETE /service/rest/beta/security/ldap/{name}
+    # POST /service/rest/beta/security/ldap/change-order
+  end
+end

data/lib/endpoints/license.rb

@@ -0,0 +1,7 @@
+module NexusAPI
+  class API
+    # GET /service/rest/beta/system/license
+    # POST /service/rest/beta/system/license
+    # DELETE /service/rest/beta/system/license
+  end
+end

data/lib/endpoints/lifecycle.rb

@@ -0,0 +1,7 @@
+module NexusAPI
+  class API
+    # PUT /service/rest/v1/lifecycle/bounce
+    # GET /service/rest/v1/lifecycle/phase
+    # PUT /service/rest/v1/lifecycle/phase
+  end
+end

data/lib/endpoints/privileges.rb

@@ -0,0 +1,19 @@
+module NexusAPI
+  class API
+    # GET /service/rest/beta/security/privileges
+    # GET /service/rest/beta/security/privileges/{privilegeId}
+    # DELETE /service/rest/beta/security/privileges/{privilegeId}
+    # POST /service/rest/beta/security/privileges/application
+    # PUT /service/rest/beta/security/privileges/application/{privilegeId}
+    # POST /service/rest/beta/security/privileges/repository-admin
+    # PUT /service/rest/beta/security/privileges/repository-admin/{privilegeId}
+    # 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
+    # PUT /service/rest/beta/security/privileges/repository-view/{privilegeId}
+    # POST /service/rest/beta/security/privileges/script
+    # PUT /service/rest/beta/security/privileges/script/{privilegeId}
+    # POST /service/rest/beta/security/privileges/wildcard
+    # PUT /service/rest/beta/security/privileges/wildcard/{privilegeId}
+  end
+end

data/lib/endpoints/read-only.rb

@@ -0,0 +1,8 @@
+module NexusAPI
+  class API
+    # GET /service/rest/v1/read-only
+    # POST /service/rest/v1/read-only/force-release
+    # POST /service/rest/v1/read-only/freeze
+    # POST /service/rest/v1/read-only/release
+  end
+end

data/lib/endpoints/realms.rb

@@ -0,0 +1,7 @@
+module NexusAPI
+  class API
+    # GET /service/rest/beta/security/realms/active
+    # PUT /service/rest/beta/security/realms/active
+    # GET /service/rest/beta/security/realms/available
+  end
+end

data/lib/endpoints/repositories.rb

@@ -0,0 +1,104 @@
+require 'utilities/parameter_builder'
+
+module NexusAPI
+  class API
+    # GET /service/rest/v1/repositories (This endpoint does not paginate)
+    # GET /service/rest/beta/repositories
+    def list_repositories
+      @connection.get_response(endpoint: 'repositories', api_version: 'beta')
+    end
+
+    def list_repository_names
+      list_repositories.map { |repo| repo['name'] }
+    end
+
+    # DELETE /service/rest/beta/repositories/{repositoryName}
+    def delete_repository(name:)
+      @connection.delete(endpoint: "repositories/#{name}", api_version: 'beta')
+    end
+
+    # POST /service/rest/beta/repositories/{repositoryName}/health-check
+    # DELETE /service/rest/beta/repositories/{repositoryName}/health-check
+    # POST /service/rest/beta/repositories/{repositoryName}/invalidate-cache
+    # POST /service/rest/beta/repositories/{repositoryName}/rebuild-index
+    # POST /service/rest/beta/repositories/apt/hosted
+    # PUT /service/rest/beta/repositories/apt/hosted/{repositoryName}
+    # POST /service/rest/beta/repositories/apt/proxy
+    # PUT /service/rest/beta/repositories/apt/proxy/{repositoryName}
+    # POST /service/rest/beta/repositories/bower/group
+    # PUT /service/rest/beta/repositories/bower/group/{repositoryName}
+    # POST /service/rest/beta/repositories/bower/hosted
+    # PUT /service/rest/beta/repositories/bower/hosted/{repositoryName}
+    # POST /service/rest/beta/repositories/bower/proxy
+    # PUT /service/rest/beta/repositories/bower/proxy/{repositoryName}
+    # POST /service/rest/beta/repositories/conan/proxy
+    # PUT /service/rest/beta/repositories/conan/proxy/{repositoryName}
+    # POST /service/rest/beta/repositories/docker/group
+    # PUT /service/rest/beta/repositories/docker/group/{repositoryName}
+    # POST /service/rest/beta/repositories/docker/hosted
+    def create_repository_docker_hosted(name:, port:)
+      parameters = ParameterBuilder.docker_hosted(name, port)
+      @connection.post(endpoint: 'repositories/docker/hosted', parameters: parameters, api_version: 'beta')
+    end
+
+    # PUT /service/rest/beta/repositories/docker/hosted/{repositoryName}
+    # POST /service/rest/beta/repositories/docker/proxy
+    # PUT /service/rest/beta/repositories/docker/proxy/{repositoryName}
+    # POST /service/rest/beta/repositories/gitlfs/hosted
+    # PUT /service/rest/beta/repositories/gitlfs/hosted/{repositoryName}
+    # POST /service/rest/beta/repositories/go/group
+    # PUT /service/rest/beta/repositories/go/group/{repositoryName}
+    # POST /service/rest/beta/repositories/go/proxy
+    # PUT /service/rest/beta/repositories/go/proxy/{repositoryName}
+    # POST /service/rest/beta/repositories/helm/hosted
+    # PUT /service/rest/beta/repositories/helm/hosted/{repositoryName}
+    # POST /service/rest/beta/repositories/helm/proxy
+    # PUT /service/rest/beta/repositories/helm/proxy/{repositoryName}
+    # POST /service/rest/beta/repositories/maven/hosted
+    def create_repository_maven_hosted(name:)
+      parameters = ParameterBuilder.maven_hosted(name)
+      @connection.post(endpoint: 'repositories/maven/hosted', parameters: parameters, api_version: 'beta')
+    end
+
+    # PUT /service/rest/beta/repositories/maven/hosted/{repositoryName}
+    # POST /service/rest/beta/repositories/maven/proxy
+    # PUT /service/rest/beta/repositories/maven/proxy/{repositoryName}
+    # POST /service/rest/beta/repositories/npm/group
+    # PUT /service/rest/beta/repositories/npm/group/{repositoryName}
+    # POST /service/rest/beta/repositories/npm/hosted
+    def create_repository_npm_hosted(name:)
+      parameters = ParameterBuilder.npm_hosted(name)
+      @connection.post(endpoint: 'repositories/npm/hosted', parameters: parameters, api_version: 'beta')
+    end
+
+    # PUT /service/rest/beta/repositories/npm/hosted/{repositoryName}
+    # POST /service/rest/beta/repositories/npm/proxy
+    # PUT /service/rest/beta/repositories/npm/proxy/{repositoryName}
+    # POST /service/rest/beta/repositories/nuget/group
+    # PUT /service/rest/beta/repositories/nuget/group/{repositoryName}
+    # POST /service/rest/beta/repositories/nuget/hosted
+    # PUT /service/rest/beta/repositories/nuget/hosted/{repositoryName}
+    # POST /service/rest/beta/repositories/nuget/proxy
+    # PUT /service/rest/beta/repositories/nuget/proxy/{repositoryName}
+    # POST /service/rest/beta/repositories/p2/proxy
+    # PUT /service/rest/beta/repositories/p2/proxy/{repositoryName}
+    # POST /service/rest/beta/repositories/pypi/group
+    # PUT /service/rest/beta/repositories/pypi/group/{repositoryName}
+    # POST /service/rest/beta/repositories/pypi/hosted
+    def create_repository_pypi_hosted(name:)
+      parameters = ParameterBuilder.pypi_hosted(name)
+      @connection.post(endpoint: 'repositories/pypi/hosted', parameters: parameters, api_version: 'beta')
+    end
+
+    # PUT /service/rest/beta/repositories/pypi/hosted/{repositoryName}
+    # POST /service/rest/beta/repositories/pypi/proxy
+    # PUT /service/rest/beta/repositories/pypi/proxy/{repositoryName}
+    # POST /service/rest/beta/repositories/yum/hosted
+    def create_repository_yum_hosted(name:, depth:)
+      parameters = ParameterBuilder.yum_hosted(name, depth)
+      @connection.post(endpoint: 'repositories/yum/hosted', parameters: parameters, api_version: 'beta')
+    end
+
+    # PUT /service/rest/beta/repositories/yum/hosted/{repositoryName}
+  end
+end

data/lib/endpoints/roles.rb

@@ -0,0 +1,9 @@
+module NexusAPI
+  class API
+    # GET /service/rest/beta/security/roles
+    # POST /service/rest/beta/security/roles
+    # GET /service/rest/beta/security/roles/{id}
+    # PUT /service/rest/beta/security/roles/{id}
+    # DELETE /service/rest/beta/security/roles/{id}
+  end
+end

data/lib/endpoints/routing-rules.rb

@@ -0,0 +1,9 @@
+module NexusAPI
+  class API
+    # GET /service/rest/beta/routing-rules
+    # POST /service/rest/beta/routing-rules
+    # GET /service/rest/beta/routing-rules/{name}
+    # PUT /service/rest/beta/routing-rules/{name}
+    # DELETE /service/rest/beta/routing-rules/{name}
+  end
+end

data/lib/endpoints/saml.rb

@@ -0,0 +1,9 @@
+module NexusAPI
+  class API
+    # GET /service/rest/v1/security/saml
+    # PUT /service/rest/v1/security/saml
+    # DELETE /service/rest/v1/security/saml
+    # GET /service/rest/v1/security/saml/metadata
+    # GET /service/rest/v1/security/saml/pem
+  end
+end

data/lib/endpoints/script.rb

@@ -0,0 +1,37 @@
+module NexusAPI
+  class API
+    # GET /service/rest/v1/script
+    def list_scripts
+      @connection.get_response(endpoint: "script")
+    end
+
+    # POST /service/rest/v1/script
+    def upload_script(filename:)
+      puts_deprecated_notice
+      file = File.read(filename)
+      @connection.post(endpoint: "script", parameters: file)
+    end
+
+    # GET /service/rest/v1/script/{name}
+    # PUT /service/rest/v1/script/{name}
+    # DELETE /service/rest/v1/script/{name}
+    def delete_script(name:)
+      @connection.delete(endpoint: "script/#{name}")
+    end
+
+    # POST /service/rest/v1/script/{name}/run
+    def run_script(name:)
+      puts_deprecated_notice
+      @connection.post(endpoint: "script/#{name}/run", headers: {'Content-Type' => 'text/plain'})
+    end
+
+
+    private
+
+    def puts_deprecated_notice
+      puts 'WARNING: This endpoint has been disabled in Nexus due to a vulnerability'
+      puts '         and may not work as intended. An HTTP 410 is an indication of this'
+      puts '         See https://issues.sonatype.org/browse/NEXUS-23205 for details'
+    end
+  end
+end

data/lib/endpoints/search.rb

@@ -0,0 +1,18 @@
+module NexusAPI
+  class API
+    # GET /service/rest/v1/search
+
+    # GET /service/rest/v1/search/assets
+    def search_asset(name:, format: nil, repository: nil, sha1: nil, version: nil, paginate: false)
+      repository ||= @team_config.search_repository
+      endpoint = "search/assets?q=#{name}"
+      endpoint += "&format=#{format}" unless format.nil?
+      endpoint += "&repository=#{repository}" unless repository.nil?
+      endpoint += "&sha1=#{sha1}" unless sha1.nil?
+      endpoint += "&version=#{version}" unless version.nil?
+      @connection.get_response(endpoint: endpoint, paginate: paginate)
+    end
+
+    # GET /service/rest/v1/search/assets/download
+  end
+end

data/lib/endpoints/ssl.rb

@@ -0,0 +1,8 @@
+module NexusAPI
+  class API
+    # GET /service/rest/beta/security/ssl
+    # GET /service/rest/beta/security/ssl/truststore
+    # POST /service/rest/beta/security/ssl/truststore
+    # DELETE /service/rest/beta/security/ssl/truststore/{id}
+  end
+end

data/lib/endpoints/staging.rb

@@ -0,0 +1,6 @@
+module NexusAPI
+  class API
+    # POST /service/rest/v1/staging/delete
+    # POST /service/rest/v1/staging/move/{destination}
+  end
+end

data/lib/endpoints/status.rb

@@ -0,0 +1,15 @@
+module NexusAPI
+  class API
+    # GET /service/rest/v1/status
+    def status
+      @connection.get(endpoint: 'status')
+    end
+
+    # GET /service/rest/v1/status/check
+
+    # GET /service/rest/v1/status/writable
+    def status_writable
+      @connection.get(endpoint: 'status/writable')
+    end
+  end
+end

data/lib/endpoints/support.rb

@@ -0,0 +1,5 @@
+module NexusAPI
+  class API
+    # POST /service/rest/v1/support/supportzip
+  end
+end

data/lib/endpoints/tags.rb

@@ -0,0 +1,44 @@
+module NexusAPI
+  class API
+    # GET /service/rest/v1/tags
+    def list_tags(paginate: false)
+      @connection.get_response(endpoint: 'tags', paginate: paginate)
+    end
+
+    # POST /service/rest/v1/tags
+    def create_tag(name:)
+      parameters = JSON.dump({
+        'name' => name,
+      })
+      @connection.post(endpoint: 'tags', parameters: parameters)
+    end
+
+    # GET /service/rest/v1/tags/{name}
+    # PUT /service/rest/v1/tags/{name}
+    # DELETE /service/rest/v1/tags/{name}
+    def delete_tag(name:)
+      @connection.delete(endpoint: "tags/#{name}")
+    end
+
+    # POST /service/rest/v1/tags/associate/{tagName}
+    def associate_tag(name:, sha1:, repository: nil)
+      repository ||= @team_config.tag_repository
+      search_query =
+        "?"\
+        "wait=true&"\
+        "repository=#{repository}&"\
+        "sha1=#{sha1}"
+      @connection.post(endpoint: "tags/associate/#{name}" + search_query)
+    end
+
+    # DELETE /service/rest/v1/tags/associate/{tagName}
+    def delete_associated_tag(name:, sha1:, repository: nil)
+      repository ||= @team_config.tag_repository
+      search_query =
+        "?"\
+        "repository=#{repository}&"\
+        "sha1=#{sha1}"
+      @connection.delete(endpoint: "tags/associate/#{name}" + search_query)
+    end
+  end
+end

data/lib/endpoints/tasks.rb

@@ -0,0 +1,8 @@
+module NexusAPI
+  class API
+    # GET /service/rest/v1/tasks
+    # GET /service/rest/v1/tasks/{id}
+    # POST /service/rest/v1/tasks/{id}/run
+    # POST /service/rest/v1/tasks/{id}/stop
+  end
+end

data/lib/endpoints/user-sources.rb

@@ -0,0 +1,5 @@
+module NexusAPI
+  class API
+    # GET /service/rest/beta/security/user-sources
+  end
+end

data/lib/endpoints/user-tokens.rb

@@ -0,0 +1,5 @@
+module NexusAPI
+  class API
+    # DELETE /service/rest/beta/security/user-tokens
+  end
+end

data/lib/endpoints/users.rb

@@ -0,0 +1,10 @@
+module NexusAPI
+  class API
+    # GET /service/rest/beta/security/users
+    # POST /service/rest/beta/security/users
+    # PUT /service/rest/beta/security/users/{userId}
+    # DELETE /service/rest/beta/security/users/{userId}
+    # PUT /service/rest/beta/security/users/{userId}/change-password
+    # DELETE /service/rest/beta/security/users/{userId}/user-token
+  end
+end

data/lib/endpoints.rb

@@ -0,0 +1,28 @@
+require 'endpoints/assets'
+require 'endpoints/blobstore'
+require 'endpoints/components'
+require 'endpoints/content-selectors'
+require 'endpoints/email'
+require 'endpoints/formats'
+require 'endpoints/iq'
+require 'endpoints/ldap'
+require 'endpoints/license'
+require 'endpoints/lifecycle'
+require 'endpoints/privileges'
+require 'endpoints/read-only'
+require 'endpoints/realms'
+require 'endpoints/repositories'
+require 'endpoints/roles'
+require 'endpoints/routing-rules'
+require 'endpoints/saml'
+require 'endpoints/script'
+require 'endpoints/search'
+require 'endpoints/ssl'
+require 'endpoints/staging'
+require 'endpoints/status'
+require 'endpoints/support'
+require 'endpoints/tags'
+require 'endpoints/tasks'
+require 'endpoints/user-sources'
+require 'endpoints/user-tokens'
+require 'endpoints/users'

data/lib/nexus_api/nexus_connection.rb

@@ -1,10 +1,11 @@
 require 'base64'
+require 'json'
 require 'rest-client'
 require 'uri'
 
 module NexusAPI
   class NexusConnection
-    VALID_RESPONSE_CODES = [200, 204].freeze
+    VALID_RESPONSE_CODES = [200, 201, 204].freeze
     
     attr_accessor :continuation_token
 
@@ -14,40 +15,43 @@ module NexusAPI
       @hostname = hostname
     end
 
-    def get_response(endpoint:, paginate: false, headers: {'Content-Type' => 'application/json'})
-      response = send_get(endpoint, paginate, headers)
+    def get_response(endpoint:, paginate: false, headers: {'Content-Type' => 'application/json'}, api_version: 'v1')
+      response = send_get(endpoint, paginate, headers, api_version)
       response.nil? ? Hash.new : jsonize(response)
     end
 
-    def get(endpoint:, paginate: false, headers: {'Content-Type' => 'application/json'})
-      valid?(send_get(endpoint, paginate, headers))
+    def get(endpoint:, paginate: false, headers: {'Content-Type' => 'application/json'}, api_version: 'v1')
+      valid?(send_get(endpoint, paginate, headers, api_version))
     end
 
-    def post(endpoint:, parameters: '', headers: {'Content-Type' => 'application/json'})
+    def post(endpoint:, parameters: '', headers: {'Content-Type' => 'application/json'}, api_version: 'v1')
       response = send_request(
         :post, 
         endpoint,
         parameters: parameters,
-        headers: headers
+        headers: headers,
+        api_version: api_version
       )
       valid?(response)
     end
 
-    def put(endpoint:, parameters: '', headers: {'Content-Type' => 'application/json'})
+    def put(endpoint:, parameters: '', headers: {'Content-Type' => 'application/json'}, api_version: 'v1')
       response = send_request(
         :put,
         endpoint,
         parameters: parameters,
-        headers: headers
+        headers: headers,
+        api_version: api_version
       )
       valid?(response)
     end
 
-    def delete(endpoint:, headers: {'Content-Type' => 'application/json'})
+    def delete(endpoint:, headers: {'Content-Type' => 'application/json'}, api_version: 'v1')
       response = send_request(
         :delete,
         endpoint,
-        headers: headers
+        headers: headers,
+        api_version: api_version
       )
       valid?(response)
     end
@@ -103,8 +107,8 @@ module NexusAPI
       { :Authorization => 'Basic ' + Base64.strict_encode64( "#{@username}:#{@password}" ) }
     end
 
-    def send_request(connection_method, endpoint, parameters: '', headers: {})
-      url = "https://#{@hostname}/service/rest/v1/#{endpoint}"
+    def send_request(connection_method, endpoint, parameters: '', headers: {}, api_version: 'v1')
+      url = "https://#{@hostname}/service/rest/#{api_version}/#{endpoint}"
       catch_connection_error do
         RestClient::Request.execute(
           method:  connection_method,
@@ -115,14 +119,15 @@ module NexusAPI
       end
     end
 
-    def send_get(endpoint, paginate, headers)
+    def send_get(endpoint, paginate, headers, api_version)
       # paginate answers is the user requesting pagination, paginate? answers does a continuation token exist
       # if an empty continuation token is included in the request we'll get an ArrayIndexOutOfBoundsException
       endpoint += "&continuationToken=#{@continuation_token}" if paginate && paginate?
       response = send_request(
         :get,
         endpoint,
-        headers: headers
+        headers: headers,
+        api_version: api_version
       )
     end
 

data/lib/nexus_api/version.rb

@@ -1,4 +1,4 @@
 module NexusAPI
-  VERSION = '1.0.4'
+  VERSION = '1.1.0'
 end
 

data/lib/nexus_api.rb

@@ -1,9 +1,9 @@
+require 'endpoints'
 require 'nexus_api/version'
 require 'nexus_api/docker_shell'
 require 'nexus_api/docker_manager'
 require 'nexus_api/nexus_connection'
 require 'nexus_api/config_manager'
-require 'json'
 require 'pry'
 
 # Nexus API docs: 
@@ -40,289 +40,6 @@ module NexusAPI
       @team_config = NexusAPI::ConfigManager.new(config_path: team_config)
     end
 
-
-    # ---ASSETS---
-    # GET /service/rest/v1/assets
-    def list_assets(repository: nil, paginate: false)
-      repository ||= @team_config.assets_repository
-      @connection.get_response(endpoint: "assets?repository=#{repository}", paginate: paginate)
-    end
-
-    # GET /service/rest/v1/assets/{id}
-    def list_asset(id:)
-      @connection.get_response(endpoint: "assets/#{id}")
-    end
-
-    # DELETE /service/rest/v1/assets/{id}
-
-
-    # ---BLOB STORE---
-    # GET /service/rest/v1/blobstores/{id}/quota-status
-
-
-    # ---COMPONENTS---
-    # GET /service/rest/v1/components
-    def list_components(repository: nil, paginate: false)
-      repository ||= @team_config.components_repository
-      @connection.get_response(endpoint: "components?repository=#{repository}", paginate: paginate)
-    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
-      parameters = {
-        'maven2.groupId' => group_id,
-        'maven2.artifactId' => artifact_id,
-        'maven2.version' => version,
-        'maven2.asset1' => File.open(filename, 'r'),
-        'maven2.asset1.extension' => filename.split('.').last,
-      }
-      parameters['maven2.tag'] = tag if tag
-      @connection.post(endpoint: "components?repository=#{repository}", parameters: parameters, headers: {})
-    end
-
-    def upload_npm_component(filename:, repository: nil, tag: nil)
-      repository ||= @team_config.npm_repository
-      parameters = {
-        'npm.asset' => File.open(filename, 'r'),
-      }
-      parameters['npm.tag'] = tag if tag
-      @connection.post(endpoint: "components?repository=#{repository}", parameters: parameters, headers: {})
-    end
-
-    def upload_pypi_component(filename:, repository: nil, tag: nil)
-      repository ||= @team_config.pypi_repository
-      parameters = {
-        'pypi.asset' => File.open(filename, 'r'),
-      }
-      parameters['pypi.tag'] = tag if tag
-      @connection.post(endpoint: "components?repository=#{repository}", parameters: parameters, headers: {})
-    end
-
-    def upload_raw_component(filename:, directory:, repository: nil, tag: nil)
-      repository ||= @team_config.raw_repository
-      parameters = {
-        'raw.directory' => directory,
-        'raw.asset1' => File.open(filename, 'r'),
-        'raw.asset1.filename' => filename.split('/').last,
-      }
-      parameters['raw.tag'] = tag if tag
-      @connection.post(endpoint: "components?repository=#{repository}", parameters: parameters, headers: {})
-    end
-
-    def upload_rubygems_component(filename:, repository: nil, tag: nil)
-      repository ||= @team_config.rubygems_repository
-      parameters = {
-        'rubygems.asset' => File.open(filename, 'r'),
-      }
-      parameters['rubygems.tag'] = tag if tag
-      @connection.post(endpoint: "components?repository=#{repository}", parameters: parameters, headers: {})
-    end
-
-    def upload_yum_component(filename:, directory:, repository: nil, tag: nil)
-      repository ||= @team_config.yum_repository
-      parameters = {
-        'yum.directory' => directory,
-        'yum.asset' => File.open(filename, 'r'),
-        'yum.asset.filename' => filename.split('/').last,
-      }
-      parameters['yum.tag'] = tag if tag
-      @connection.post(endpoint: "components?repository=#{repository}", parameters: parameters, headers: {})
-    end
-
-    # GET /service/rest/v1/components/{id}
-    def list_component(id:)
-      @connection.get_response(endpoint: "components/#{id}")
-    end
-
-    # DELETE /service/rest/v1/components/{id}
-
-
-    # ---FORMATS---
-    # GET /service/rest/v1/formats/{format}/upload-specs
-    # GET /service/rest/v1/formats/upload-specs
-
-
-    # ---LIFECYCLE---
-    # PUT /service/rest/v1/lifecycle/bounce
-    # GET /service/rest/v1/lifecycle/phase
-    # PUT /service/rest/v1/lifecycle/phase
-
-
-    # ---MAINTENANCE---
-    # PUT /service/rest/v1/maintenance/{databaseName}/check
-    # PUT /service/rest/v1/maintenance/{databaseName}/reinstall
-    # PUT /service/rest/v1/maintenance/{databaseName}/repair
-    # GET /service/rest/v1/maintenance/{databaseName}/role
-    # PUT /service/rest/v1/maintenance/{databaseName}/role
-    # GET /service/rest/v1/maintenance/{databaseName}/status
-    # PUT /service/rest/v1/maintenance/{databaseName}/status
-
-
-    # ---NODES---
-    # GET /service/rest/v1/nodes
-    # PUT /service/rest/v1/nodes
-    # GET /service/rest/v1/nodes/supportzipdownload
-    # POST /service/rest/v1/nodes/supportzips
-
-    
-    # ---READ-ONLY---
-    # GET /service/rest/v1/read-only
-    # POST /service/rest/v1/read-only/force-release
-    # POST /service/rest/v1/read-only/freeze
-    # POST /service/rest/v1/read-only/release
-
-
-    # ---REPOSITORIES--- (This endpoint does not paginate)
-    # GET /service/rest/v1/repositories
-    def list_repositories
-      @connection.get_response(endpoint: 'repositories')
-    end
-
-    def list_repository_names
-      list_repositories.map { |repo| repo['name'] }
-    end
-
-
-    # ---ROUTING-RULES--- 
-    # GET /service/rest/v1/beta/routing-rules
-    # POST /service/rest/v1/beta/routing-rules
-    # GET /service/rest/v1/beta/routing-rules/{name}
-    # PUT /service/rest/v1/beta/routing-rules/{name}
-    # DELETE /service/rest/v1/beta/routing-rules/{name}
-
-
-    # ---SCRIPT---
-    # GET /service/rest/v1/script
-    def list_scripts
-      @connection.get_response(endpoint: "script")
-    end
-
-    # POST /service/rest/v1/script
-    def upload_script(filename:)
-      file = File.read(filename)
-      @connection.post(endpoint: "script", parameters: file)
-    end
-
-    # GET /service/rest/v1/script/{name}
-    # PUT /service/rest/v1/script/{name}
-    # DELETE /service/rest/v1/script/{name}
-    def delete_script(name:)
-      @connection.delete(endpoint: "script/#{name}")
-    end
-
-    # POST /service/rest/v1/script/{name}/run
-    def run_script(name:)
-      @connection.post(endpoint: "script/#{name}/run", headers: {'Content-Type' => 'text/plain'})
-    end
-
-
-    # ---SEARCH---
-    # GET /service/rest/v1/search
-
-    # GET /service/rest/v1/search/assets
-    def search_asset(name:, format: nil, repository: nil, sha1: nil, version: nil, paginate: false)
-      repository ||= @team_config.search_repository
-      endpoint = "search/assets?q=#{name}"
-      endpoint += "&format=#{format}" unless format.nil?
-      endpoint += "&repository=#{repository}" unless repository.nil?
-      endpoint += "&sha1=#{sha1}" unless sha1.nil?
-      endpoint += "&version=#{version}" unless version.nil?
-      @connection.get_response(endpoint: endpoint, paginate: paginate)
-    end
-
-    # GET /service/rest/v1/search/assets/download
-
-
-    # ---SECURITY MANAGEMENT---
-    # GET /service/rest/v1/beta/security/user-sources
-
-
-    # ---SECURITY MANAGEMENT: USER TOKENS---
-    # DELETE /service/rest/v1/beta/security/user-tokens
-
-
-    # ---SECURITY MANAGEMENT: USERS---
-    # GET /service/rest/v1/beta/security/users
-    # POST /service/rest/v1/beta/security/users
-    # PUT /service/rest/v1/beta/security/users/{userId}
-    # DELETE /service/rest/v1/beta/security/users/{userId}
-    # PUT /service/rest/v1/beta/security/users/{userId}/change-password
-    # DELETE /service/rest/v1/beta/security/users/{userId}/user-token
-
-
-    # ---STAGING---
-    # POST /service/rest/v1/staging/delete
-    # POST /service/rest/v1/staging/move/{destination}
-
-
-    # ---STATUS---
-    # GET /service/rest/v1/status
-    def status
-      @connection.get(endpoint: 'status')
-    end
-
-    # GET /service/rest/v1/status/writable
-    def status_writable
-      @connection.get(endpoint: 'status/writable')
-    end
-
-
-    # ---SUPPORT---
-    # POST /service/rest/v1/support/supportzip
-
-
-    # ---TAGS---
-    # GET /service/rest/v1/tags
-    def list_tags(paginate: false)
-      @connection.get_response(endpoint: 'tags', paginate: paginate)
-    end
-
-    # POST /service/rest/v1/tags
-    def create_tag(name:)
-      parameters = JSON.dump({
-        'name' => name,
-      })
-      @connection.post(endpoint: 'tags', parameters: parameters)
-    end
-    
-    # GET /service/rest/v1/tags/{name}
-    # PUT /service/rest/v1/tags/{name}
-    # DELETE /service/rest/v1/tags/{name}
-    def delete_tag(name:)
-      @connection.delete(endpoint: "tags/#{name}")
-    end
-
-    # POST /service/rest/v1/tags/associate/{tagName}
-    def associate_tag(name:, sha1:, repository: nil)
-      repository ||= @team_config.tag_repository
-      search_query = 
-        "?"\
-        "wait=true&"\
-        "repository=#{repository}&"\
-        "sha1=#{sha1}"
-      @connection.post(endpoint: "tags/associate/#{name}" + search_query)
-    end
-
-    # DELETE /service/rest/v1/tags/associate/{tagName}
-    def delete_associated_tag(name:, sha1:, repository: nil)
-      repository ||= @team_config.tag_repository
-      search_query =
-        "?"\
-        "repository=#{repository}&"\
-        "sha1=#{sha1}"
-      @connection.delete(endpoint: "tags/associate/#{name}" + search_query)
-    end
-
-
-    # ---TASKS---
-    # GET /service/rest/v1/tasks
-    # GET /service/rest/v1/tasks/{id}
-    # POST /service/rest/v1/tasks/{id}/run
-    # POST /service/rest/v1/tasks/{id}/stop
-
-
-    # ---CUSTOM FUNCTIONS---
     def get_asset_size(asset_url:)
       @connection.content_length(asset_url: asset_url)
     end

data/lib/utilities/parameter_builder.rb

@@ -0,0 +1,92 @@
+require 'json'
+
+module NexusAPI
+  class ParameterBuilder
+    # Write Policies
+    ALLOW = 'ALLOW'
+    ALLOW_ONCE = 'ALLOW_ONCE'
+    DENY = 'DENY'
+
+    # Version Policy
+    RELEASE = 'RELEASE'
+    SNAPSHOT = 'SNAPSHOT'
+    MIXED = 'MIXED'
+
+    # Layout or Deploy Policy
+    STRICT = 'STRICT'
+    PERMISSIVE = 'PERMISSIVE'
+
+    def self.docker_hosted(name, port, write_policy: ALLOW_ONCE)
+      {
+        'name' => name,
+        'online' => true,
+        'storage' => {
+          'blobStoreName' => 'default',
+          'strictContentTypeValidation' => true,
+          'writePolicy' => write_policy
+        },
+        'docker' => {
+          'v1Enabled' => false,
+          'forceBasicAuth' => true,
+          'httpPort' => port
+        }
+      }.to_json
+    end
+
+    def self.maven_hosted(name, write_policy: ALLOW_ONCE, version_policy: RELEASE, layout_policy: STRICT)
+      {
+        'name' => name,
+        'online' => true,
+        'storage' => {
+          'blobStoreName' => 'default',
+          'strictContentTypeValidation' => true,
+          'writePolicy' => write_policy
+        },
+        'maven' => {
+          'versionPolicy' => version_policy,
+          'layoutPolicy' => layout_policy
+        }
+      }.to_json
+    end
+
+    def self.npm_hosted(name, write_policy: ALLOW_ONCE)
+      {
+        'name' => name,
+        'online' => true,
+        'storage' => {
+          'blobStoreName' => 'default',
+          'strictContentTypeValidation' => true,
+          'writePolicy' => write_policy
+        }
+      }.to_json
+    end
+
+    def self.pypi_hosted(name, write_policy: ALLOW_ONCE)
+      {
+        'name' => name,
+        'online' => true,
+        'storage' => {
+          'blobStoreName' => 'default',
+          'strictContentTypeValidation' => true,
+          'writePolicy' => write_policy
+        }
+      }.to_json
+    end
+
+    def self.yum_hosted(name, depth, write_policy: ALLOW_ONCE, deploy_policy: STRICT)
+      {
+        'name' => name,
+        'online' => true,
+        'storage' => {
+          'blobStoreName' => 'default',
+          'strictContentTypeValidation' => true,
+          'writePolicy' => write_policy
+        },
+        'yum' => {
+          'repodataDepth' => depth,
+          'deployPolicy' => deploy_policy
+        }
+      }.to_json
+    end
+  end
+end

data/nexus_api.gemspec

@@ -32,5 +32,6 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency 'thor', "~> 0.20.3"
 
   spec.add_development_dependency 'rspec', "~> 3.0"
-  spec.add_development_dependency 'simplecov', "~> 0.18.5"
+  spec.add_development_dependency 'simplecov', "~> 0.18"
+  spec.add_development_dependency 'webmock', "~> 3.8"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nexus_api
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.1.0
 platform: ruby
 authors:
 - Francis Levesque
@@ -129,14 +129,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.18.5
+        version: '0.18'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.18.5
+        version: '0.18'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.8'
 description: 
 email:
 - francis.d.levesque@gmail.com
@@ -163,6 +177,35 @@ files:
 - bin/release
 - bin/setup
 - bin/test
+- lib/endpoints.rb
+- lib/endpoints/assets.rb
+- lib/endpoints/blobstore.rb
+- lib/endpoints/components.rb
+- lib/endpoints/content-selectors.rb
+- lib/endpoints/email.rb
+- lib/endpoints/formats.rb
+- lib/endpoints/iq.rb
+- lib/endpoints/ldap.rb
+- lib/endpoints/license.rb
+- lib/endpoints/lifecycle.rb
+- lib/endpoints/privileges.rb
+- lib/endpoints/read-only.rb
+- lib/endpoints/realms.rb
+- lib/endpoints/repositories.rb
+- lib/endpoints/roles.rb
+- lib/endpoints/routing-rules.rb
+- lib/endpoints/saml.rb
+- lib/endpoints/script.rb
+- lib/endpoints/search.rb
+- lib/endpoints/ssl.rb
+- lib/endpoints/staging.rb
+- lib/endpoints/status.rb
+- lib/endpoints/support.rb
+- lib/endpoints/tags.rb
+- lib/endpoints/tasks.rb
+- lib/endpoints/user-sources.rb
+- lib/endpoints/user-tokens.rb
+- lib/endpoints/users.rb
 - lib/nexus_api.rb
 - lib/nexus_api/cli.rb
 - lib/nexus_api/cli_commands/commands.rb
@@ -178,6 +221,7 @@ files:
 - lib/nexus_api/docker_shell.rb
 - lib/nexus_api/nexus_connection.rb
 - lib/nexus_api/version.rb
+- lib/utilities/parameter_builder.rb
 - nexus_api.gemspec
 - team_configs/default.yaml
 - team_configs/template.yaml