nucleus 0.1.0

data/wiki/adapter_tests.md

@@ -0,0 +1,99 @@
+# Adapter Tests
+
+* [Recording](#recording)
+  * [Missing or invalid VCR recording](#missing-or-invalid-vcr-recording)
+  * [Sensitive data](#sensitive-data)
+
+The adapter tests rely on previously recorded interactions with the provider's endpoints.
+They do not invoke external HTTP requests.
+When code changes result in different requests, the interactions have to be re-recorded.
+
+```
+bundle exec rake spec:suite:adapters
+```
+
+Each interaction of the adapter tests shall be made only once.
+If there are further tests that all rely on the same request, the described spec shall be marked with `:as_cassette`.
+All subsequent tests in this group now use the initial recording.
+
+```ruby
+describe 'application services list empty', :as_cassette, cassette_group: 'application-services;list' do
+  before { get "/endpoints/#{@endpoint}/applications/#{@app_all[:updated_name]}/services", request_headers }
+  include_examples 'a valid GET request'
+  include_examples 'installed service list schema'
+  it 'does not contain any services' do
+    expect(json_body[:services]).to eql([])
+  end
+end
+```
+
+The `cassette_group: 'application-services;list'` marker in this example forces the `VCR` cassettes to be placed into a
+directory structure of `application-services/list/{testname}.rec`.
+With this structure we can automatically evaluate request differences for a specific operation.
+
+## Recording
+
+Recording new VCR cassettes requires a valid user account at the platform that shall be recorded.
+The `endpoint-id` that will be used during the recording is hard-coded as `@endpoint` variable inside the main adapter test file, e.g. `spec/adapter/v1/heroku/heroku_spec.rb`.
+The credentials must be specified in the `config/.credentials` file.
+
+The file is ignored by git and must _never_ be committed. It must use the following syntax:
+
+```
+endpoint-id:
+  user:     'my_username'
+  password: 'my_usernames_password'
+```
+
+Additional attributes can be used to filter out personal data from the recordings that may be included in the HTTP interactions (see [Sensitive data](#sensitive-data)).
+A complete .credentials file could then look like:
+
+```yaml
+heroku:
+  id:       'my_heroku_user_id'
+  user:     'my_heroku_username'
+  password: 'my_heroku_usernames_password'
+
+bluemix-eu-gb:
+  user:     'my_bluemix_username'
+  password: 'my_bluemix_usernames_password'
+  username: 'my_bluemix_username_with_encoded_umlauts'
+
+cloudcontrol:
+  user:     'my_cc_email'
+  password: 'my_cc_usernames_password'
+  username: 'my_cc_username'
+
+openshift-online:
+  user:     'my_os_email'
+  password: 'my_os_usernames_password'
+  id:       'my_os_user_id'
+```
+
+To record the interactions, you only have to call the Rake `record` task:
+
+```
+bundle exec rake record
+```
+
+To only record interactions for a specific adapter, simply append the adapter name to the record namespace:
+
+```
+bundle exec rake record:heroku
+```
+
+**Notes:**
+* You must be allowed to create at least 3 additional applications with your account, otherwise the quota restrictions will invalidate the test results.
+* A complete recording of a single vendor usually takes 5 up to 15 minutes. Openshift currently takes more than 30 minutes.
+If you only require a certain functionality to be tested (during development), make sure to comment out irrelevant sections in the `spec/adapter/support/shared_example_adapters_valid.rb` file.
+* cloudControl requires you to change the application names if the previous recording was made within the last 2 days, otherwise if fails because the name is still locked.
+Change the name in the `spec/adapter/v1/cloud_control_spec.rb`.
+
+### Missing or invalid VCR recording
+
+If the recorded cassette is invalid due to a recent change, tests that use this cassette are going to fail.
+
+### Sensitive data
+
+Most of the requests contain sensitive data that we do not want to be included in the recorded cassettes.
+By implementation, the API tokens and **all** data that is specified in the `config/.credentials` file are filtered.

data/wiki/implement_new_adapter.md

@@ -0,0 +1,155 @@
+# How to implement a new adapter
+
+In total, the process can be grouped into X steps.
+To prevent errors, they should be executed in the following order:
+
+* [Add the vendor to the configuration](#add-the-vendor-to-the-configuration)
+* [Create the adapter implementation files](#create-the-adapter-implementation-files)
+* [Implementation](#implementation)
+
+## Add the vendor to the configuration
+
+Open the directory `config/adapters` and create a new `.yml` configuration file for your platform:
+
+```yaml
+  ---
+  name: "Openshift 2"
+  id: "openshift_v2"
+  providers:
+    -
+      name: "Openshift Online"
+      id: "openshift-online"
+      endpoints:
+        -
+          name: "Openshift Online"
+          id: "openshift-online"
+          url: "openshift.redhat.com/broker/rest"
+```
+
+The first level entry describes the vendor (here: Openshift 2).
+**name:** The actual name of the vendor or his platform. Serves as description.
+**id:** The ID under which the vendor will be available for use in the API. Should be URI compatible!
+Different platform versions shall be distinguished by appending `_v{version}` to the *ID*.
+
+The second level are the providers that shall be known to serve a PaaS running the vendors platform.
+**name:** The actual name of the provider, which often equals to the vendor. Serves as description.
+**id:** The ID under which the provider will be available for use in the API. Should be URI compatible!
+
+The third level describes all API endpoints.
+**name:** The actual name of the endpoint, which often equals to the provider. Serves as description.
+**id:** The ID under which the endpoint will be available for use in the API. Should be URI compatible!
+
+**NOTE:** Providers and Endpoints are optional as they could be added during runtime.
+
+## Create the adapter implementation files
+
+Start by selecting the API version you want to implement the adapter for.
+Next, create a copy of the `app/adapters/{API_VERSION}/stub_adapter.rb` matching the API version.
+The pasted file must (!) be copied to `app/adapters/{API_VERSION}/{vendor_id}/{vendor_id}.rb`.
+Please make sure that the `{vendor_id}` actually is equal to the **ID** that was assigned to the vendor in the `.yml` configuration file.
+
+Open the new adapter file and change the namespace so that it matches the chosen naming and inherits from the `Stub`.
+
+```ruby
+module Nucleus
+  module Adapters
+    module {API_VERSION}
+      class {VENDOR_ID} < Stub
+```
+
+Now the adapter should already be available in the API, but all calls would fail and return `501 Not implemented`.
+
+## Tests
+
+To include your adapter in the automatic adapter tests, we must create:
+
+```
+spec/adapter/v1/{VENDOR_ID}/{VENDOR_ID}_spec.rb
+```
+
+In this test file, you can use this basic template:
+
+```ruby
+require 'spec/adapter/adapter_spec_helper'
+
+describe Nucleus::Adapters::{API_VERSION}::{VENDOR_CLASS} do
+  before :all do
+    # skip these example groups / tests for this adapter. E.g.:
+    # @unsupported = ['with valid credentials is compliant and application update']
+    @unsupported = []
+    @endpoint = '{ENDPOINT_ID}'
+    @api_version = '{API_VERSION}'
+    @app_min = { original_name: 'nucleustestappminproperties',
+                         updated_name: 'nucleustestappminproperties',
+                         region: 'default' }
+    @app_all = { original_name: 'nucleustestappallupdated',
+                         updated_name: 'nucleustestappallupdated',
+                         region: 'default' }
+  end
+  before do |example|
+    if skip_example?(described_class, example.metadata[:full_description], @unsupported)
+      skip('This feature is currently not supported by CloudControl - 501')
+    end
+    # reload adapter for each test
+    @adapter = load_adapter(@endpoint, @api_version)
+  end
+
+  context 'with invalid credentials' do
+    let!(:request_headers) { credentials(@endpoint, false) }
+    include_examples 'compliant adapter with invalid credentials'
+  end
+
+  describe 'with missing credentials' do
+    let!(:request_headers) { {} }
+    include_examples 'compliant adapter with invalid credentials'
+  end
+
+  context 'with valid credentials' do
+    let!(:request_headers) { credentials(@endpoint) }
+    include_examples 'compliant adapter with valid credentials'
+
+    describe 'native adapter call' do
+      describe 'against endpoint' do
+        describe 'does fetch all available addons' do
+          before do
+            get "/endpoints/#{@endpoint}/call/addon", request_headers
+          end
+          include_examples 'a valid GET request'
+          it 'with the specified structure' do
+            # assumes there is at least one addon
+            expect(json_body[0].keys).to include(:name, :stage, :options)
+          end
+          it 'with the matching content declaration' do
+            expect_json_types(:array)
+          end
+        end
+      end
+    end
+  end
+end
+```
+
+## Implementation
+
+Now we can start with the actual implementation. But how do you know what the adapter shall invoke and return?
+
+The expected behaviour of the adapter methods was described in the copied `stub_adapter.rb` and should therefore be in your adapter, too.
+Within the adapter tests most of the behaviour will also be tested so that you receive feedback and get to known which parts are still not properly implemented.
+
+### Structure
+
+In the already implemented adapters, we did split the logic into multiple modules.
+With this approach, we could separate different parts of the application that are not actually related and also comply with the style guidelines that are monitored by Rubocop.
+
+### Authentication
+
+Nucleus already offers quite some authentication approaches that could fit your needs.
+You can find the authentication clients at `app/core/auth`.
+
+### What if the platform does not support action X?
+
+Well, it depends ;-)
+
+For most problems, there always is a workaround that involves some effort implement.
+If the action should actually not be supported on the platform, for instance as *cloud Control* does not support to *start* or *stop* applications,
+the method shall not be present in your adapter so that the `Stub` can provide a common error response.

metadata

@@ -0,0 +1,836 @@
+--- !ruby/object:Gem::Specification
+name: nucleus
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Stefan Kolb
+- Cedric Röck
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-10-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: configatron
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.5'
+- !ruby/object:Gem::Dependency
+  name: daybreak
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: em-http-request
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: excon
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.44'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.44'
+- !ruby/object:Gem::Dependency
+  name: faye-websocket
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: git
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: grape
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+- !ruby/object:Gem::Dependency
+  name: grape-entity
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.5
+- !ruby/object:Gem::Dependency
+  name: grape-swagger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.10.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.10.1
+- !ruby/object:Gem::Dependency
+  name: kwalify
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: lmdb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: mime-types
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: moneta
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: net-ssh
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: oj
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
+- !ruby/object:Gem::Dependency
+  name: protobuf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+- !ruby/object:Gem::Dependency
+  name: rack-ssl-enforcer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.8
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: rack-stream
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.5
+- !ruby/object:Gem::Dependency
+  name: request_store
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: require_all
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: sshkey
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: thin
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: inch
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.34'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.34'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.20'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+description: Nucleus is a unified API for deployment and management of Platform-as-a-Service
+  (PaaS) systems.
+email:
+- stefan.kolb@uni-bamberg.de
+executables:
+- nucleus
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitattributes"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- CHANGELOG.md
+- CONTRIBUTING.md
+- Gemfile
+- Guardfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/nucleus
+- bin/nucleus.bat
+- config.ru
+- config/adapters/cloud_control.yml
+- config/adapters/cloud_foundry_v2.yml
+- config/adapters/heroku.yml
+- config/adapters/openshift_v2.yml
+- config/nucleus_config.rb
+- lib/nucleus.rb
+- lib/nucleus/adapter_resolver.rb
+- lib/nucleus/adapters/base_adapter.rb
+- lib/nucleus/adapters/buildpack_translator.rb
+- lib/nucleus/adapters/v1/cloud_control/application.rb
+- lib/nucleus/adapters/v1/cloud_control/authentication.rb
+- lib/nucleus/adapters/v1/cloud_control/buildpacks.rb
+- lib/nucleus/adapters/v1/cloud_control/cloud_control.rb
+- lib/nucleus/adapters/v1/cloud_control/data.rb
+- lib/nucleus/adapters/v1/cloud_control/domains.rb
+- lib/nucleus/adapters/v1/cloud_control/lifecycle.rb
+- lib/nucleus/adapters/v1/cloud_control/log_poller.rb
+- lib/nucleus/adapters/v1/cloud_control/logs.rb
+- lib/nucleus/adapters/v1/cloud_control/regions.rb
+- lib/nucleus/adapters/v1/cloud_control/scaling.rb
+- lib/nucleus/adapters/v1/cloud_control/semantic_errors.rb
+- lib/nucleus/adapters/v1/cloud_control/services.rb
+- lib/nucleus/adapters/v1/cloud_control/token.rb
+- lib/nucleus/adapters/v1/cloud_control/vars.rb
+- lib/nucleus/adapters/v1/cloud_foundry_v2/app_states.rb
+- lib/nucleus/adapters/v1/cloud_foundry_v2/application.rb
+- lib/nucleus/adapters/v1/cloud_foundry_v2/authentication.rb
+- lib/nucleus/adapters/v1/cloud_foundry_v2/buildpacks.rb
+- lib/nucleus/adapters/v1/cloud_foundry_v2/cloud_foundry_v2.rb
+- lib/nucleus/adapters/v1/cloud_foundry_v2/data.rb
+- lib/nucleus/adapters/v1/cloud_foundry_v2/domains.rb
+- lib/nucleus/adapters/v1/cloud_foundry_v2/lifecycle.rb
+- lib/nucleus/adapters/v1/cloud_foundry_v2/logs.rb
+- lib/nucleus/adapters/v1/cloud_foundry_v2/regions.rb
+- lib/nucleus/adapters/v1/cloud_foundry_v2/scaling.rb
+- lib/nucleus/adapters/v1/cloud_foundry_v2/semantic_errors.rb
+- lib/nucleus/adapters/v1/cloud_foundry_v2/services.rb
+- lib/nucleus/adapters/v1/cloud_foundry_v2/vars.rb
+- lib/nucleus/adapters/v1/heroku/app_states.rb
+- lib/nucleus/adapters/v1/heroku/application.rb
+- lib/nucleus/adapters/v1/heroku/authentication.rb
+- lib/nucleus/adapters/v1/heroku/buildpacks.rb
+- lib/nucleus/adapters/v1/heroku/data.rb
+- lib/nucleus/adapters/v1/heroku/domains.rb
+- lib/nucleus/adapters/v1/heroku/heroku.rb
+- lib/nucleus/adapters/v1/heroku/lifecycle.rb
+- lib/nucleus/adapters/v1/heroku/logs.rb
+- lib/nucleus/adapters/v1/heroku/regions.rb
+- lib/nucleus/adapters/v1/heroku/scaling.rb
+- lib/nucleus/adapters/v1/heroku/semantic_errors.rb
+- lib/nucleus/adapters/v1/heroku/services.rb
+- lib/nucleus/adapters/v1/heroku/vars.rb
+- lib/nucleus/adapters/v1/openshift_v2/app_states.rb
+- lib/nucleus/adapters/v1/openshift_v2/application.rb
+- lib/nucleus/adapters/v1/openshift_v2/authentication.rb
+- lib/nucleus/adapters/v1/openshift_v2/data.rb
+- lib/nucleus/adapters/v1/openshift_v2/domains.rb
+- lib/nucleus/adapters/v1/openshift_v2/lifecycle.rb
+- lib/nucleus/adapters/v1/openshift_v2/logs.rb
+- lib/nucleus/adapters/v1/openshift_v2/openshift_v2.rb
+- lib/nucleus/adapters/v1/openshift_v2/regions.rb
+- lib/nucleus/adapters/v1/openshift_v2/scaling.rb
+- lib/nucleus/adapters/v1/openshift_v2/semantic_errors.rb
+- lib/nucleus/adapters/v1/openshift_v2/services.rb
+- lib/nucleus/adapters/v1/openshift_v2/vars.rb
+- lib/nucleus/adapters/v1/stub_adapter.rb
+- lib/nucleus/core/adapter_authentication_inductor.rb
+- lib/nucleus/core/adapter_extensions/auth/auth_client.rb
+- lib/nucleus/core/adapter_extensions/auth/authentication_retry_wrapper.rb
+- lib/nucleus/core/adapter_extensions/auth/expiring_token_auth_client.rb
+- lib/nucleus/core/adapter_extensions/auth/http_basic_auth_client.rb
+- lib/nucleus/core/adapter_extensions/auth/o_auth2_auth_client.rb
+- lib/nucleus/core/adapter_extensions/auth/token_auth_client.rb
+- lib/nucleus/core/adapter_extensions/http_client.rb
+- lib/nucleus/core/adapter_extensions/http_tail_client.rb
+- lib/nucleus/core/adapter_extensions/tail_stopper.rb
+- lib/nucleus/core/common/errors/ambiguous_adapter_error.rb
+- lib/nucleus/core/common/errors/file_existence_error.rb
+- lib/nucleus/core/common/errors/startup_error.rb
+- lib/nucleus/core/common/exit_codes.rb
+- lib/nucleus/core/common/files/application_repo_sanitizer.rb
+- lib/nucleus/core/common/files/archive_extractor.rb
+- lib/nucleus/core/common/files/archiver.rb
+- lib/nucleus/core/common/link_generator.rb
+- lib/nucleus/core/common/logging/logging.rb
+- lib/nucleus/core/common/logging/multi_logger.rb
+- lib/nucleus/core/common/logging/request_log_formatter.rb
+- lib/nucleus/core/common/ssh_handler.rb
+- lib/nucleus/core/common/stream_callback.rb
+- lib/nucleus/core/common/thread_config_accessor.rb
+- lib/nucleus/core/common/url_converter.rb
+- lib/nucleus/core/enums/application_states.rb
+- lib/nucleus/core/enums/logfile_types.rb
+- lib/nucleus/core/error_messages.rb
+- lib/nucleus/core/errors/adapter_error.rb
+- lib/nucleus/core/errors/adapter_missing_implementation_error.rb
+- lib/nucleus/core/errors/adapter_request_error.rb
+- lib/nucleus/core/errors/adapter_resource_not_found_error.rb
+- lib/nucleus/core/errors/endpoint_authentication_error.rb
+- lib/nucleus/core/errors/platform_specific_semantic_error.rb
+- lib/nucleus/core/errors/platform_timeout_error.rb
+- lib/nucleus/core/errors/platform_unavailable_error.rb
+- lib/nucleus/core/errors/semantic_adapter_request_error.rb
+- lib/nucleus/core/errors/unknown_adapter_call_error.rb
+- lib/nucleus/core/file_handling/archive_converter.rb
+- lib/nucleus/core/file_handling/file_manager.rb
+- lib/nucleus/core/file_handling/git_deployer.rb
+- lib/nucleus/core/file_handling/git_repo_analyzer.rb
+- lib/nucleus/core/import/adapter_configuration.rb
+- lib/nucleus/core/import/vendor_parser.rb
+- lib/nucleus/core/import/version_detector.rb
+- lib/nucleus/core/models/abstract_model.rb
+- lib/nucleus/core/models/endpoint.rb
+- lib/nucleus/core/models/provider.rb
+- lib/nucleus/core/models/vendor.rb
+- lib/nucleus/ext/kernel.rb
+- lib/nucleus/ext/regexp.rb
+- lib/nucleus/os.rb
+- lib/nucleus/root_dir.rb
+- lib/nucleus/scripts/finalize.rb
+- lib/nucleus/scripts/initialize.rb
+- lib/nucleus/scripts/initialize_config_defaults.rb
+- lib/nucleus/scripts/load.rb
+- lib/nucleus/scripts/load_dependencies.rb
+- lib/nucleus/scripts/setup_config.rb
+- lib/nucleus/scripts/shutdown.rb
+- lib/nucleus/version.rb
+- nucleus.gemspec
+- public/robots.txt
+- public/swagger-ui/css/reset.css
+- public/swagger-ui/css/screen.css
+- public/swagger-ui/images/apple-touch-icon-114x114.png
+- public/swagger-ui/images/apple-touch-icon-120x120.png
+- public/swagger-ui/images/apple-touch-icon-144x144.png
+- public/swagger-ui/images/apple-touch-icon-152x152.png
+- public/swagger-ui/images/apple-touch-icon-57x57.png
+- public/swagger-ui/images/apple-touch-icon-60x60.png
+- public/swagger-ui/images/apple-touch-icon-72x72.png
+- public/swagger-ui/images/apple-touch-icon-76x76.png
+- public/swagger-ui/images/explorer_icons.png
+- public/swagger-ui/images/favicon-128.png
+- public/swagger-ui/images/favicon-16x16.png
+- public/swagger-ui/images/favicon-196x196.png
+- public/swagger-ui/images/favicon-32x32.png
+- public/swagger-ui/images/favicon-96x96.png
+- public/swagger-ui/images/favicon.ico
+- public/swagger-ui/images/logo_small.png
+- public/swagger-ui/images/mstile-144x144.png
+- public/swagger-ui/images/mstile-150x150.png
+- public/swagger-ui/images/mstile-310x150.png
+- public/swagger-ui/images/mstile-310x310.png
+- public/swagger-ui/images/mstile-70x70.png
+- public/swagger-ui/images/pet_store_api.png
+- public/swagger-ui/images/throbber.gif
+- public/swagger-ui/images/wordnik_api.png
+- public/swagger-ui/index.html
+- public/swagger-ui/lib/backbone-min.js
+- public/swagger-ui/lib/handlebars-1.0.0.js
+- public/swagger-ui/lib/highlight.7.3.pack.js
+- public/swagger-ui/lib/jquery-1.8.0.min.js
+- public/swagger-ui/lib/jquery.ba-bbq.min.js
+- public/swagger-ui/lib/jquery.slideto.min.js
+- public/swagger-ui/lib/jquery.wiggle.min.js
+- public/swagger-ui/lib/shred.bundle.js
+- public/swagger-ui/lib/shred/content.js
+- public/swagger-ui/lib/swagger-oauth.js
+- public/swagger-ui/lib/swagger.js
+- public/swagger-ui/lib/underscore-min.js
+- public/swagger-ui/o2c.html
+- public/swagger-ui/redirect.html
+- public/swagger-ui/swagger-ui.js
+- public/swagger-ui/swagger-ui.min.js
+- schemas/api.adapter.schema.yml
+- schemas/api.requirements.schema.yml
+- spec/factories/models.rb
+- spec/integration/api/auth_spec.rb
+- spec/integration/api/endpoints_spec.rb
+- spec/integration/api/errors_spec.rb
+- spec/integration/api/providers_spec.rb
+- spec/integration/api/swagger_schema_spec.rb
+- spec/integration/api/vendors_spec.rb
+- spec/integration/integration_spec_helper.rb
+- spec/integration/test_data_generator.rb
+- spec/nucleus_git_key.pem
+- spec/spec_helper.rb
+- spec/support/shared_example_request_types.rb
+- spec/test_suites.rake
+- spec/unit/adapters/archive_converter_spec.rb
+- spec/unit/adapters/file_manager_spec.rb
+- spec/unit/adapters/git_deployer_spec.rb
+- spec/unit/adapters/v1/stub_spec.rb
+- spec/unit/common/helpers/auth_helper_spec.rb
+- spec/unit/common/oauth2_auth_client_spec.rb
+- spec/unit/common/regexp_spec.rb
+- spec/unit/common/request_log_formatter_spec.rb
+- spec/unit/common/thread_config_accessor_spec.rb
+- spec/unit/models/endpoint_spec.rb
+- spec/unit/models/provider_spec.rb
+- spec/unit/models/vendor_spec.rb
+- spec/unit/schemas/adapter_schema_spec.rb
+- spec/unit/schemas/adapter_validation_spec.rb
+- spec/unit/schemas/requirements_schema_spec.rb
+- spec/unit/unit_spec_helper.rb
+- tasks/compatibility.rake
+- tasks/evaluation.rake
+- wiki/adapter_tests.md
+- wiki/implement_new_adapter.md
+homepage: https://github.com/stefan-kolb/nucleus
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Nucleus unifies core management functions of Platform-as-a-Service (PaaS)
+  systems.
+test_files:
+- spec/factories/models.rb
+- spec/integration/api/auth_spec.rb
+- spec/integration/api/endpoints_spec.rb
+- spec/integration/api/errors_spec.rb
+- spec/integration/api/providers_spec.rb
+- spec/integration/api/swagger_schema_spec.rb
+- spec/integration/api/vendors_spec.rb
+- spec/integration/integration_spec_helper.rb
+- spec/integration/test_data_generator.rb
+- spec/nucleus_git_key.pem
+- spec/spec_helper.rb
+- spec/support/shared_example_request_types.rb
+- spec/test_suites.rake
+- spec/unit/adapters/archive_converter_spec.rb
+- spec/unit/adapters/file_manager_spec.rb
+- spec/unit/adapters/git_deployer_spec.rb
+- spec/unit/adapters/v1/stub_spec.rb
+- spec/unit/common/helpers/auth_helper_spec.rb
+- spec/unit/common/oauth2_auth_client_spec.rb
+- spec/unit/common/regexp_spec.rb
+- spec/unit/common/request_log_formatter_spec.rb
+- spec/unit/common/thread_config_accessor_spec.rb
+- spec/unit/models/endpoint_spec.rb
+- spec/unit/models/provider_spec.rb
+- spec/unit/models/vendor_spec.rb
+- spec/unit/schemas/adapter_schema_spec.rb
+- spec/unit/schemas/adapter_validation_spec.rb
+- spec/unit/schemas/requirements_schema_spec.rb
+- spec/unit/unit_spec_helper.rb
+has_rdoc: