nucleus 0.1.0 → 0.2.0

data/config/nucleus_config.rb

@@ -6,10 +6,6 @@
 # Defaults to: File.expand_path(File.join(File.dirname(__FILE__), '..', 'log'))
 # nucleus_config.logging.path = File.expand_path(File.join(File.dirname(__FILE__), '..', 'log'))
 
-# [optional] Database backend to use. Choose one of: [:Daybreak, :LMDB]
-# Defaults to: :Daybreak on Unix, :LMDB on windows systems.
-# nucleus_config.db.backend = :Daybreak
-
 # [optional] Options to start the backend.
 # See http://www.rubydoc.info/gems/moneta/Moneta/Adapters for valid options on the chosen adapter.
 # Defaults to: {}

data/lib/nucleus/adapter_resolver.rb

@@ -1,115 +1,115 @@
-module Nucleus
-  # The {AdapterResolver} can be used within Ruby applications to retrieve a Nucleus adapter.
-  # Returned adapters are patched so that each call enforces authentication and retries a call when a token was expired.
-  class AdapterResolver
-    include Nucleus::UrlConverter
-
-    def initialize(requested_version)
-      fail 'No such version supported' unless Nucleus::VersionDetector.api_versions.include?(requested_version)
-      @api_version = requested_version
-    end
-
-    # Get a list of all adapters that are currently supported.
-    # @return [Hash<String, Hash<String, Nucleus::Adapters::BaseAdapter>>] currently supported adapters
-    def adapters
-      setup
-      @adapters
-    end
-
-    # Load the adapter to interact with the platform of the vendor that is offered at the endpoint_url.
-    # @param [String] vendor The vendor / adapter name that shall be used to communicate with the endpoint.
-    #   Must be supported, otherwise a +StandardError+ will be thrown.
-    # @param [String] username The username that shall be used for authentication
-    # @param [String] password The password that shall be used for authentication
-    # @param [Hash<Symbol,?>] options Further options to apply when creating the adapter instance.
-    #   If available, the default configuration of the vendor configuration is applied as default.
-    # @option options [String] :app_domain The domain where applications of the platform will be made available at.
-    #   This option must be set for custom deployments of platforms like Cloud Foundry or Openshift.
-    #   For IBM Bluemix this value would be: +eu-gb.mybluemix.net+ or +ng.mybluemix.net+, depending on the endpoint.
-    # @option options [String] :check_ssl Set to false if SSL certificates shall not be verified (trust self-signed)
-    # @option options [String] :api_url URL of the endpoint's API that shall be used.
-    #   Must be specified if there are multiple endpoints available and will be forced to https://
-    # @raise [StandardError] if the vendor is unknown / not supported or no unique API endpoint could be identified
-    # @return [Nucleus::Adapters::BaseAdapter] loaded adapter implementation
-    def load(vendor, username, password, options = {})
-      setup
-      fail StandardError, "Could not find adapter for vendor '#{vendor}'" unless @adapters.key?(vendor)
-
-      # load the endpoint's HTTPS enabled API URL
-      endpoint_url = load_endpoint(vendor, options)
-
-      # load default configuration if available
-      if @configurations[vendor].key?(endpoint_url)
-        default_configuration = @configurations[vendor][endpoint_url]
-        options = default_configuration.merge(options)
-      end
-
-      check_ssl = options.key?(:check_ssl) ? options[:check_ssl] : true
-      adapter = @adapters[vendor].new(endpoint_url, options[:app_domain], check_ssl)
-
-      fake_env = { 'HTTP_AUTHORIZATION' => 'Basic ' + ["#{username}:#{password}"].pack('m*').gsub(/\n/, '') }
-      # patch the adapter so that calls are wrapped and expect valid authentication
-      AdapterAuthenticationInductor.patch(adapter, fake_env)
-
-      cache_key = adapter.cache_key(username, password)
-      # no auth object available, perform authentication first
-      auth_object = adapter.auth_client
-      # throws an error if the authentication failed
-      auth_object.authenticate(username, password)
-      # cache the auth object so it does not have to be retrieved per request
-      adapter.cache(cache_key, auth_object)
-
-      # return patched and initially authenticated adapter
-      adapter
-    end
-
-    private
-
-    def load_endpoint(vendor, options)
-      if options.key?(:api_url)
-        # use chosen url endpoint
-        endpoint_url = options[:api_url]
-      elsif @configurations[vendor].length == 1
-        # use default endpoint
-        endpoint_url = @configurations[vendor].keys.first
-      else
-        fail StandardError, "Could not identify an API endpoint for the vendor '#{vendor}'. "\
-          "Please specify the API URL to use with the ':api_url' option."
-      end
-
-      # make sure url uses https
-      secure_url(endpoint_url)
-    end
-
-    def setup
-      # perform the setup only once
-      return if @adapters
-
-      # Initialize the application (import adapters, load DAOs, ...)
-      require 'nucleus/scripts/initialize'
-      # load the configuration values
-      require 'nucleus/scripts/initialize_config_defaults'
-      # Once invoked the configuration is locked
-      require 'nucleus/scripts/finalize'
-
-      @adapters = {}
-      @configurations = {}
-      Nucleus::Adapters.configuration_files.each do |adapter_config|
-        vendor = Nucleus::VendorParser.parse(adapter_config)
-        next unless vendor
-        adapter_clazz = Nucleus::Adapters.adapter_clazz(adapter_config, @api_version)
-        next unless adapter_clazz
-        @adapters[vendor.id] = adapter_clazz
-        @configurations[vendor.id] = {}
-
-        # now load the default configurations for this vendor
-        vendor.providers.each do |provider|
-          provider.endpoints.each do |endpoint|
-            @configurations[vendor.id][secure_url(endpoint.url)] = { check_ssl: !endpoint.trust,
-                                                                     app_domain: endpoint.app_domain }
-          end
-        end
-      end
-    end
-  end
-end
+module Nucleus
+  # The {AdapterResolver} can be used within Ruby applications to retrieve a Nucleus adapter.
+  # Returned adapters are patched so that each call enforces authentication and retries a call when a token was expired.
+  class AdapterResolver
+    include Nucleus::UrlConverter
+
+    def initialize(requested_version)
+      fail 'No such version supported' unless Nucleus::VersionDetector.api_versions.include?(requested_version)
+      @api_version = requested_version
+    end
+
+    # Get a list of all adapters that are currently supported.
+    # @return [Hash<String, Hash<String, Nucleus::Adapters::BaseAdapter>>] currently supported adapters
+    def adapters
+      setup
+      @adapters
+    end
+
+    # Load the adapter to interact with the platform of the vendor that is offered at the endpoint_url.
+    # @param [String] vendor The vendor / adapter name that shall be used to communicate with the endpoint.
+    #   Must be provided, otherwise a +StandardError+ will be thrown.
+    # @param [String] username The username that shall be used for authentication
+    # @param [String] password The password that shall be used for authentication
+    # @param [Hash<Symbol,?>] options Further options to apply when creating the adapter instance.
+    #   If available, the default configuration of the vendor configuration is applied as default.
+    # @option options [String] :app_domain The domain where applications of the platform will be made available at.
+    #   This option must be set for custom deployments of platforms like Cloud Foundry or Openshift.
+    #   For IBM Bluemix this value would be: +eu-gb.mybluemix.net+ or +ng.mybluemix.net+, depending on the endpoint.
+    # @option options [String] :check_ssl Set to false if SSL certificates shall not be verified (trust self-signed)
+    # @option options [String] :api_url URL of the endpoint's API that shall be used.
+    #   Must be specified if there are multiple endpoints available and will be forced to https://
+    # @raise [StandardError] if the vendor is unknown / not supported or no unique API endpoint could be identified
+    # @return [Nucleus::Adapters::BaseAdapter] loaded adapter implementation
+    def load(vendor, username, password, options = {})
+      setup
+      fail StandardError, "Could not find adapter for vendor '#{vendor}'" unless @adapters.key?(vendor)
+
+      # load the endpoint's HTTPS enabled API URL
+      endpoint_url = load_endpoint(vendor, options)
+
+      # load default configuration if available
+      if @configurations[vendor].key?(endpoint_url)
+        default_configuration = @configurations[vendor][endpoint_url]
+        options = default_configuration.merge(options)
+      end
+
+      check_ssl = options.key?(:check_ssl) ? options[:check_ssl] : true
+      adapter = @adapters[vendor].new(endpoint_url, options[:app_domain], check_ssl)
+
+      fake_env = { 'HTTP_AUTHORIZATION' => 'Basic ' + ["#{username}:#{password}"].pack('m*').delete("\n") }
+      # patch the adapter so that calls are wrapped and expect valid authentication
+      AdapterAuthenticationInductor.patch(adapter, fake_env)
+
+      cache_key = adapter.cache_key(username, password)
+      # no auth object available, perform authentication first
+      auth_object = adapter.auth_client
+      # throws an error if the authentication failed
+      auth_object.authenticate(username, password)
+      # cache the auth object so it does not have to be retrieved per request
+      adapter.cache(cache_key, auth_object)
+
+      # return patched and initially authenticated adapter
+      adapter
+    end
+
+    private
+
+    def load_endpoint(vendor, options)
+      if options.key?(:api_url)
+        # use chosen url endpoint
+        endpoint_url = options[:api_url]
+      elsif @configurations[vendor].length == 1
+        # use default endpoint
+        endpoint_url = @configurations[vendor].keys.first
+      else
+        fail StandardError, "Could not identify an API endpoint for the vendor '#{vendor}'. "\
+          "Please specify the API URL to use with the ':api_url' option."
+      end
+
+      # make sure url uses https
+      secure_url(endpoint_url)
+    end
+
+    def setup
+      # perform the setup only once
+      return if @adapters
+
+      # Initialize the application (import adapters, load DAOs, ...)
+      require 'nucleus/scripts/initialize'
+      # load the configuration values
+      require 'nucleus/scripts/initialize_config_defaults'
+      # Once invoked the configuration is locked
+      require 'nucleus/scripts/finalize'
+
+      @adapters = {}
+      @configurations = {}
+      Nucleus::Adapters.configuration_files.each do |adapter_config|
+        vendor = Nucleus::VendorParser.parse(adapter_config)
+        next unless vendor
+        adapter_clazz = Nucleus::Adapters.adapter_clazz(adapter_config, @api_version)
+        next unless adapter_clazz
+        @adapters[vendor.id] = adapter_clazz
+        @configurations[vendor.id] = {}
+
+        # now load the default configurations for this vendor
+        vendor.providers.each do |provider|
+          provider.endpoints.each do |endpoint|
+            @configurations[vendor.id][secure_url(endpoint.url)] = { check_ssl: !endpoint.trust,
+                                                                     app_domain: endpoint.app_domain }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/nucleus/adapters/buildpack_translator.rb

@@ -1,79 +1,79 @@
-module Nucleus
-  module Adapters
-    # The {BuildpackTranslator} provides convenience methods for the user to handle the installation
-    # of application runtimes. Common runtime names can be applied and are automatically translated to a
-    # platform native runtime name / url (if applicable).
-    module BuildpackTranslator
-      # List of common buildpacks that are available GitHub.
-      # However, they are not guaranteed to work with every platform that utilized buildpacks.
-      PUBLIC_BUILDPACKS = {
-        'c' => 'https://github.com/atris/heroku-buildpack-c',
-        'common_lisp' => 'https://github.com/mtravers/heroku-buildpack-cl',
-        'core_data' => 'https://github.com/heroku/heroku-buildpack-core-data',
-        'dart' => 'https://github.com/igrigorik/heroku-buildpack-dart',
-        'eiffel' => 'https://github.com/mbustosorg/heroku-buildpack-eiffel',
-        'elixir' => 'https://github.com/hashnuke/heroku-buildpack-elixir',
-        'emacs' => 'https://github.com/technomancy/heroku-buildpack-emacs',
-        'embedded_proxy' => 'https://github.com/ryanbrainard/heroku-buildpack-embedded-proxy',
-        'erlang' => 'https://github.com/archaelus/heroku-buildpack-erlang',
-        'factor' => 'https://github.com/ryanbrainard/heroku-buildpack-factor',
-        'fakesu' => 'https://github.com/fabiokung/heroku-buildpack-fakesu',
-        'geodjango' => 'https://github.com/cirlabs/heroku-buildpack-geodjango',
-        'go' => 'https://github.com/kr/heroku-buildpack-go',
-        'haskell' => 'https://github.com/mietek/haskell-on-heroku',
-        'inline' => 'https://github.com/kr/heroku-buildpack-inline',
-        'java_ant' => 'https://github.com/dennisg/heroku-buildpack-ant',
-        # introduced by IBM Bluemix, shall also work in Heroku
-        'java_liberty' => 'https://github.com/cloudfoundry/ibm-websphere-liberty-buildpack',
-        'jekyll' => 'https://github.com/mattmanning/heroku-buildpack-ruby-jekyll',
-        'lua' => 'https://github.com/leafo/heroku-buildpack-lua',
-        'luvit' => 'https://github.com/skomski/heroku-buildpack-luvit',
-        'meteor' => 'https://github.com/jordansissel/heroku-buildpack-meteor',
-        'middleman' => 'https://github.com/hashicorp/heroku-buildpack-middleman',
-        'monit' => 'https://github.com/k33l0r/monit-buildpack',
-        'multi' => 'https://github.com/heroku/heroku-buildpack-multi',
-        'nanoc' => 'https://github.com/bobthecow/heroku-buildpack-nanoc',
-        'dot_net' => 'https://github.com/friism/heroku-buildpack-mono',
-        'null' => 'https://github.com/ryandotsmith/null-buildpack',
-        'opa' => 'https://github.com/tsloughter/heroku-buildpack-opa',
-        'perl' => 'https://github.com/miyagawa/heroku-buildpack-perl',
-        'phantomjs' => 'https://github.com/stomita/heroku-buildpack-phantomjs',
-        'phing' => 'https://github.com/ryanbrainard/heroku-buildpack-phing',
-        'r' => 'https://github.com/virtualstaticvoid/heroku-buildpack-r',
-        'rust' => 'https://github.com/emk/heroku-buildpack-rust',
-        'redline' => 'https://github.com/will/heroku-buildpack-redline',
-        'silex' => 'https://github.com/klaussilveira/heroku-buildpack-silex',
-        'sphinx' => 'https://github.com/kennethreitz/sphinx-buildpack',
-        'test' => 'https://github.com/ddollar/buildpack-test',
-        'testing' => 'https://github.com/ryanbrainard/heroku-buildpack-testrunner'
-      }
-
-      # Search the list of known buildpacks, both vendor specific and public, to match the desires runtime name.
-      # @param [String] name of the runtime to look out for
-      # @return [Boolean] returns true if a vendor specific or public buildpack was found for the runtime
-      def find_runtime(name)
-        if respond_to? :vendor_specific_runtimes
-          runtime = vendor_specific_runtimes[name.downcase.underscore]
-          return runtime unless runtime.nil?
-        end
-
-        # if no vendor specific runtime was found, use the general definitions
-        PUBLIC_BUILDPACKS[name.downcase.underscore]
-      end
-
-      # Checks if the name of the runtime is matching a vendor specific runtime / buildpack.
-      # @param [String] name of the runtime for which to check if it matches a vendor specific runtime
-      # @return [Boolean] returns true if the name matches a vendor specific runtime, false otherwise
-      def native_runtime?(name)
-        if respond_to? :vendor_specific_runtimes
-          # case A: name is a key
-          return true if vendor_specific_runtimes.keys.include? name
-          # case B: name is a specific runtime name or a URL and one of the values
-          return vendor_specific_runtimes.values.include? name
-        end
-        # cant be native if there are no vendor specific runtimes
-        false
-      end
-    end
-  end
-end
+module Nucleus
+  module Adapters
+    # The {BuildpackTranslator} provides convenience methods for the user to handle the installation
+    # of application runtimes. Common runtime names can be applied and are automatically translated to a
+    # platform native runtime name / url (if applicable).
+    module BuildpackTranslator
+      # List of common buildpacks that are available GitHub.
+      # However, they are not guaranteed to work with every platform that utilized buildpacks.
+      PUBLIC_BUILDPACKS = {
+        'c' => 'https://github.com/atris/heroku-buildpack-c',
+        'common_lisp' => 'https://github.com/mtravers/heroku-buildpack-cl',
+        'core_data' => 'https://github.com/heroku/heroku-buildpack-core-data',
+        'dart' => 'https://github.com/igrigorik/heroku-buildpack-dart',
+        'eiffel' => 'https://github.com/mbustosorg/heroku-buildpack-eiffel',
+        'elixir' => 'https://github.com/hashnuke/heroku-buildpack-elixir',
+        'emacs' => 'https://github.com/technomancy/heroku-buildpack-emacs',
+        'embedded_proxy' => 'https://github.com/ryanbrainard/heroku-buildpack-embedded-proxy',
+        'erlang' => 'https://github.com/archaelus/heroku-buildpack-erlang',
+        'factor' => 'https://github.com/ryanbrainard/heroku-buildpack-factor',
+        'fakesu' => 'https://github.com/fabiokung/heroku-buildpack-fakesu',
+        'geodjango' => 'https://github.com/cirlabs/heroku-buildpack-geodjango',
+        'go' => 'https://github.com/kr/heroku-buildpack-go',
+        'haskell' => 'https://github.com/mietek/haskell-on-heroku',
+        'inline' => 'https://github.com/kr/heroku-buildpack-inline',
+        'java_ant' => 'https://github.com/dennisg/heroku-buildpack-ant',
+        # introduced by IBM Bluemix, shall also work in Heroku
+        'java_liberty' => 'https://github.com/cloudfoundry/ibm-websphere-liberty-buildpack',
+        'jekyll' => 'https://github.com/mattmanning/heroku-buildpack-ruby-jekyll',
+        'lua' => 'https://github.com/leafo/heroku-buildpack-lua',
+        'luvit' => 'https://github.com/skomski/heroku-buildpack-luvit',
+        'meteor' => 'https://github.com/jordansissel/heroku-buildpack-meteor',
+        'middleman' => 'https://github.com/hashicorp/heroku-buildpack-middleman',
+        'monit' => 'https://github.com/k33l0r/monit-buildpack',
+        'multi' => 'https://github.com/heroku/heroku-buildpack-multi',
+        'nanoc' => 'https://github.com/bobthecow/heroku-buildpack-nanoc',
+        'dot_net' => 'https://github.com/friism/heroku-buildpack-mono',
+        'null' => 'https://github.com/ryandotsmith/null-buildpack',
+        'opa' => 'https://github.com/tsloughter/heroku-buildpack-opa',
+        'perl' => 'https://github.com/miyagawa/heroku-buildpack-perl',
+        'phantomjs' => 'https://github.com/stomita/heroku-buildpack-phantomjs',
+        'phing' => 'https://github.com/ryanbrainard/heroku-buildpack-phing',
+        'r' => 'https://github.com/virtualstaticvoid/heroku-buildpack-r',
+        'rust' => 'https://github.com/emk/heroku-buildpack-rust',
+        'redline' => 'https://github.com/will/heroku-buildpack-redline',
+        'silex' => 'https://github.com/klaussilveira/heroku-buildpack-silex',
+        'sphinx' => 'https://github.com/kennethreitz/sphinx-buildpack',
+        'test' => 'https://github.com/ddollar/buildpack-test',
+        'testing' => 'https://github.com/ryanbrainard/heroku-buildpack-testrunner'
+      }.freeze
+
+      # Search the list of known buildpacks, both vendor specific and public, to match the desires runtime name.
+      # @param [String] name of the runtime to look out for
+      # @return [Boolean] returns true if a vendor specific or public buildpack was found for the runtime
+      def find_runtime(name)
+        if respond_to? :vendor_specific_runtimes
+          runtime = vendor_specific_runtimes[name.downcase.underscore]
+          return runtime unless runtime.nil?
+        end
+
+        # if no vendor specific runtime was found, use the general definitions
+        PUBLIC_BUILDPACKS[name.downcase.underscore]
+      end
+
+      # Checks if the name of the runtime is matching a vendor specific runtime / buildpack.
+      # @param [String] name of the runtime for which to check if it matches a vendor specific runtime
+      # @return [Boolean] returns true if the name matches a vendor specific runtime, false otherwise
+      def native_runtime?(name)
+        if respond_to? :vendor_specific_runtimes
+          # case A: name is a key
+          return true if vendor_specific_runtimes.keys.include? name
+          # case B: name is a specific runtime name or a URL and one of the values
+          return vendor_specific_runtimes.values.include? name
+        end
+        # cant be native if there are no vendor specific runtimes
+        false
+      end
+    end
+  end
+end

data/lib/nucleus/adapters/v1/cloud_control/application.rb

@@ -1,108 +1,108 @@
-module Nucleus
-  module Adapters
-    module V1
-      class CloudControl < Stub
-        # cloud control, CRUD operations for the application object
-        module Application
-          # @see Stub#applications
-          def applications
-            response = get('/app')
-            apps = []
-            response.body.each do |application|
-              apps << to_nucleus_app(application, default_deployment(application[:name]))
-            end
-            apps
-          end
-
-          # @see Stub#application
-          def application(application_id)
-            response = get("/app/#{application_id}").body
-            to_nucleus_app(response, default_deployment(response[:name]))
-          end
-
-          # @see Stub#create_application
-          def create_application(application)
-            if application.key? :region
-              unless application[:region].casecmp('default') == 0
-                fail Errors::SemanticAdapterRequestError,
-                     "Region '#{application[:region]}' does not exist at the endpoint. "\
-                     'Please check which regions are actually available on this endpoint.'
-              end
-              # there is no region in cloudControl --> remove from request
-              application.delete :region
-            end
-
-            apply_buildpack(application)
-
-            # force the use of repository type 'git', unless overridden by the params
-            default_params = { repository_type: 'git' }
-            cc_application = default_params.merge(application)
-
-            create_app_response = post('/app', body: cc_application).body
-
-            # create the default deployment, name will automatically become 'default'
-            created_deployment = post("/app/#{create_app_response[:name]}/deployment", body: { name: 'nucleus' }).body
-
-            # activate the variables addon. However, the activation explicitly requires an initial key value pair...
-            post("/app/#{create_app_response[:name]}/deployment/#{NUCLEUS_DEPLOYMENT}/addon",
-                 body: { addon: 'config.free', options: "{\"nucleus-initialized\": \"true\"}" }).body
-            # ...now delete the initial key value pair to have the desired clean setup
-            delete_env_var(create_app_response[:name], 'nucleus-initialized')
-
-            to_nucleus_app(create_app_response, created_deployment)
-          end
-
-          # @see Stub#delete_application
-          def delete_application(application_id)
-            # delete all deployments first
-            deployments = get("/app/#{application_id}/deployment").body
-            deployments.each do |deployment|
-              deployment_name = %r{(\w+)\/(\w+)}.match(deployment[:name])[2]
-              delete("/app/#{application_id}/deployment/#{deployment_name}")
-            end
-            delete("/app/#{application_id}")
-          end
-
-          private
-
-          def apply_buildpack(application)
-            runtimes = application.delete(:runtimes)
-            return unless runtimes
-            fail_with(:only_one_runtime) if runtimes.length > 1
-            buildpack = find_runtime(runtimes[0])
-            if native_runtime?(buildpack)
-              application[:type] = buildpack
-            elsif buildpack
-              application[:type] = 'custom'
-              application[:buildpack_url] = buildpack
-            else
-              # 3rd party buildpack must be a valid URL
-              unless Regexp::PERFECT_URL_PATTERN =~ runtimes[0]
-                fail Errors::SemanticAdapterRequestError,
-                     "Invalid buildpack: '#{runtimes[0]}'. Please provide a valid buildpack URL for all "\
-                      'custom buildpacks that are not provided by cloud control.'
-              end
-              application[:type] = 'custom'
-              application[:buildpack_url] = runtimes[0]
-            end
-          end
-
-          def to_nucleus_app(app, deployment)
-            app[:id] = app[:name]
-            app[:created_at] = app.delete :date_created
-            app[:updated_at] = app.delete :date_modified
-            app[:state] = application_state(deployment)
-            app[:web_url] = "http://#{deployment[:default_subdomain]}"
-            app[:autoscaled] = false
-            app[:region] = 'default'
-            app[:instances] = deployment[:min_boxes]
-            app[:active_runtime] = app[:type][:name] == 'custom' ? app[:buildpack_url] : app[:type][:name]
-            app[:runtimes] = [app[:active_runtime]]
-            app[:release_version] = deployment[:version] != '-1' ? deployment[:version] : nil
-            app
-          end
-        end
-      end
-    end
-  end
-end
+module Nucleus
+  module Adapters
+    module V1
+      class CloudControl < Stub
+        # cloud control, CRUD operations for the application object
+        module Application
+          # @see Stub#applications
+          def applications
+            response = get('/app')
+            apps = []
+            response.body.each do |application|
+              apps << to_nucleus_app(application, default_deployment(application[:name]))
+            end
+            apps
+          end
+
+          # @see Stub#application
+          def application(application_id)
+            response = get("/app/#{application_id}").body
+            to_nucleus_app(response, default_deployment(response[:name]))
+          end
+
+          # @see Stub#create_application
+          def create_application(application)
+            if application.key? :region
+              unless application[:region].casecmp('default') == 0
+                fail Errors::SemanticAdapterRequestError,
+                     "Region '#{application[:region]}' does not exist at the endpoint. "\
+                     'Please check which regions are actually available on this endpoint.'
+              end
+              # there is no region in cloudControl --> remove from request
+              application.delete :region
+            end
+
+            apply_buildpack(application)
+
+            # force the use of repository type 'git', unless overridden by the params
+            default_params = { repository_type: 'git' }
+            cc_application = default_params.merge(application)
+
+            create_app_response = post('/app', body: cc_application).body
+
+            # create the default deployment, name will automatically become 'default'
+            created_deployment = post("/app/#{create_app_response[:name]}/deployment", body: { name: 'nucleus' }).body
+
+            # activate the variables addon. However, the activation explicitly requires an initial key value pair...
+            post("/app/#{create_app_response[:name]}/deployment/#{NUCLEUS_DEPLOYMENT}/addon",
+                 body: { addon: 'config.free', options: '{"nucleus-initialized": "true"}' }).body
+            # ...now delete the initial key value pair to have the desired clean setup
+            delete_env_var(create_app_response[:name], 'nucleus-initialized')
+
+            to_nucleus_app(create_app_response, created_deployment)
+          end
+
+          # @see Stub#delete_application
+          def delete_application(application_id)
+            # delete all deployments first
+            deployments = get("/app/#{application_id}/deployment").body
+            deployments.each do |deployment|
+              deployment_name = %r{(\w+)\/(\w+)}.match(deployment[:name])[2]
+              delete("/app/#{application_id}/deployment/#{deployment_name}")
+            end
+            delete("/app/#{application_id}")
+          end
+
+          private
+
+          def apply_buildpack(application)
+            runtimes = application.delete(:runtimes)
+            return unless runtimes
+            fail_with(:only_one_runtime) if runtimes.length > 1
+            buildpack = find_runtime(runtimes[0])
+            if native_runtime?(buildpack)
+              application[:type] = buildpack
+            elsif buildpack
+              application[:type] = 'custom'
+              application[:buildpack_url] = buildpack
+            else
+              # 3rd party buildpack must be a valid URL
+              unless Regexp::PERFECT_URL_PATTERN =~ runtimes[0]
+                fail Errors::SemanticAdapterRequestError,
+                     "Invalid buildpack: '#{runtimes[0]}'. Please provide a valid buildpack URL for all "\
+                      'custom buildpacks that are not provided by cloud control.'
+              end
+              application[:type] = 'custom'
+              application[:buildpack_url] = runtimes[0]
+            end
+          end
+
+          def to_nucleus_app(app, deployment)
+            app[:id] = app[:name]
+            app[:created_at] = app.delete :date_created
+            app[:updated_at] = app.delete :date_modified
+            app[:state] = application_state(deployment)
+            app[:web_url] = "http://#{deployment[:default_subdomain]}"
+            app[:autoscaled] = false
+            app[:region] = 'default'
+            app[:instances] = deployment[:min_boxes]
+            app[:active_runtime] = app[:type][:name] == 'custom' ? app[:buildpack_url] : app[:type][:name]
+            app[:runtimes] = [app[:active_runtime]]
+            app[:release_version] = deployment[:version] != '-1' ? deployment[:version] : nil
+            app
+          end
+        end
+      end
+    end
+  end
+end