kozo 0.1.0

data/README.md

@@ -0,0 +1,27 @@
+# Kozo
+
+![Continuous Integration](https://github.com/floriandejonckheere/kozo/workflows/Continuous%20Integration/badge.svg)
+![Release](https://img.shields.io/github/v/release/floriandejonckheere/kozo?label=Latest%20release)
+
+_Kōzō_ (構造) is an open-source tool to manage your cloud resources based on the [infrastructure as code](https://en.wikipedia.org/wiki/Infrastructure_as_code) principle.
+It leverages the power of [Ruby](https://www.ruby-lang.org/en/) to allow you to declare your infrastructure in your favourite language.
+
+## Release
+
+Update the changelog and bump the version using the `bin/version` tool.
+Run `bin/version --help` to see all parameters.
+Create a git tag for the version and push it to Github.
+A Ruby gem will automatically be built and pushed to the [RubyGems](https://www.rubygems.org/).
+
+```sh
+bin/version version 1.0.0
+git add lib/kozo/version.rb
+git commit -m "Bump version to v1.0.0"
+git tag v1.0.0
+git push origin master
+git push origin v1.0.0
+```
+
+## License
+
+See [LICENSE.md](LICENSE.md).

data/Rakefile

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+begin
+  require "rspec/core/rake_task"
+
+  RSpec::Core::RakeTask.new(:spec)
+
+  task default: :spec
+rescue LoadError
+  puts "RSpec not available."
+end

data/bin/bundle

@@ -0,0 +1,118 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'bundle' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "rubygems"
+
+m = Module.new do
+  module_function
+
+  def invoked_as_script?
+    File.expand_path($PROGRAM_NAME) == File.expand_path(__FILE__)
+  end
+
+  def env_var_version
+    ENV["BUNDLER_VERSION"]
+  end
+
+  def cli_arg_version
+    return unless invoked_as_script? # don't want to hijack other binstubs
+    return unless "update".start_with?(ARGV.first || " ") # must be running `bundle update`
+
+    bundler_version = nil
+    update_index = nil
+    ARGV.each_with_index do |a, i|
+      bundler_version = a if update_index && update_index.succ == i && a =~ Gem::Version::ANCHORED_VERSION_PATTERN
+      next unless a =~ /\A--bundler(?:[= ](#{Gem::Version::VERSION_PATTERN}))?\z/o
+
+      bundler_version = Regexp.last_match(1)
+      update_index = i
+    end
+    bundler_version
+  end
+
+  def gemfile
+    gemfile = ENV["BUNDLE_GEMFILE"]
+    return gemfile if gemfile && !gemfile.empty?
+
+    File.expand_path("../Gemfile", __dir__)
+  end
+
+  def lockfile
+    lockfile =
+      case File.basename(gemfile)
+      when "gems.rb" then gemfile.sub(/\.rb$/, gemfile)
+      else "#{gemfile}.lock"
+      end
+    File.expand_path(lockfile)
+  end
+
+  def lockfile_version
+    return unless File.file?(lockfile)
+
+    lockfile_contents = File.read(lockfile)
+    return unless lockfile_contents =~ /\n\nBUNDLED WITH\n\s{2,}(#{Gem::Version::VERSION_PATTERN})\n/o
+
+    Regexp.last_match(1)
+  end
+
+  def bundler_version
+    @bundler_version ||=
+      env_var_version || cli_arg_version ||
+      lockfile_version
+  end
+
+  def bundler_requirement
+    return "#{Gem::Requirement.default}.a" unless bundler_version
+
+    bundler_gem_version = Gem::Version.new(bundler_version)
+
+    requirement = bundler_gem_version.approximate_recommendation
+
+    return requirement unless Gem::Version.new(Gem::VERSION) < Gem::Version.new("2.7.0")
+
+    requirement += ".a" if bundler_gem_version.prerelease?
+
+    requirement
+  end
+
+  def load_bundler!
+    ENV["BUNDLE_GEMFILE"] ||= gemfile
+
+    activate_bundler
+  end
+
+  def activate_bundler
+    gem_error = activation_error_handling do
+      gem "bundler", bundler_requirement
+    end
+    return if gem_error.nil?
+
+    require_error = activation_error_handling do
+      require "bundler/version"
+    end
+    if require_error.nil? && Gem::Requirement.new(bundler_requirement).satisfied_by?(Gem::Version.new(Bundler::VERSION))
+      return
+    end
+
+    warn "Activating bundler (#{bundler_requirement}) failed:\n#{gem_error.message}\n\nTo install the version of bundler this project requires, run `gem install bundler -v '#{bundler_requirement}'`"
+    exit 42
+  end
+
+  def activation_error_handling
+    yield
+    nil
+  rescue StandardError, LoadError => e
+    e
+  end
+end
+
+m.load_bundler!
+
+load Gem.bin_path("bundler", "bundle") if m.invoked_as_script?

data/bin/console

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../config/application"
+
+require "irb"
+IRB.start(__FILE__)

data/bin/kozo

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../config/application"
+
+require "kozo"
+require "byebug"
+
+Kozo::CLI.new(ARGV).start

data/bin/rspec

@@ -0,0 +1,28 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile", Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if /This file was generated by Bundler/.match?(File.read(bundle_binstub, 300))
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rspec-core", "rspec")

data/bin/version

@@ -0,0 +1,62 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../config/application"
+
+FILE = Kozo.root.join("lib/kozo/version.rb")
+
+def usage(error: false)
+  puts "Usage: #{$PROGRAM_NAME} [major [VERSION] | minor [VERSION] | patch [VERSION] | pre VERSION]"
+  puts "  #{$PROGRAM_NAME} major\t\tIncrement major version number"
+  puts "  #{$PROGRAM_NAME} major VERSION\tSet major version number"
+  puts "  #{$PROGRAM_NAME} minor\t\tIncrement minor version number"
+  puts "  #{$PROGRAM_NAME} minor VERSION\tSet minor version number"
+  puts "  #{$PROGRAM_NAME} patch\t\tIncrement patch version number"
+  puts "  #{$PROGRAM_NAME} patch VERSION\tSet patch version number"
+  puts "  #{$PROGRAM_NAME} pre\t\tClear pre version number"
+  puts "  #{$PROGRAM_NAME} pre VERSION\tSet pre version number"
+  puts "  #{$PROGRAM_NAME} version VERSION\tSet entire version number"
+
+  exit 1 if error
+end
+
+def bump(hash)
+  hash.each do |level, version|
+    File.write FILE, File.read(FILE).gsub(/#{level}( +)= [^\n]*/) { "#{level}#{$LAST_MATCH_INFO[1]}= #{version}" }
+  end
+
+  silence_warnings { load FILE }
+
+  File.write FILE_JS, File.read(FILE_JS).gsub(/"version": "[^"]*"/) { "\"version\": \"#{Kozo::VERSION}\"" }
+end
+
+case ARGV.shift&.to_sym
+when nil
+  # Print version
+  puts "v#{Kozo::VERSION}"
+when :version
+  usage(error: true) unless ARGV.any?
+
+  version, pre = ARGV.shift.split("-")
+  major, minor, patch = version.split(".")
+
+  bump MAJOR: major, MINOR: minor, PATCH: patch, PRE: (pre ? "\"#{pre}\"" : "nil")
+  puts "Setting version to #{Kozo::VERSION}"
+when :major
+  # Bump major version
+  bump MAJOR: (ARGV.pop || Kozo::Version::MAJOR + 1), MINOR: 0, PATCH: 0, PRE: "nil"
+  puts "Bumping version to #{Kozo::VERSION}"
+when :minor
+  # Bump minor version
+  bump MINOR: (ARGV.pop || Kozo::Version::MINOR + 1), PATCH: 0, PRE: "nil"
+  puts "Bumping version to #{Kozo::VERSION}"
+when :patch
+  # Bump patch version
+  bump PATCH: (ARGV.pop || Kozo::Version::PATCH + 1), PRE: "nil"
+  puts "Bumping version to #{Kozo::VERSION}"
+when :pre
+  # Set or clear patch version
+  bump PRE: (ARGV.any? ? "\"#{ARGV.shift}\"" : "nil")
+else
+  usage
+end

data/config/application.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift File.expand_path(File.join(__dir__, "..", "lib"))
+
+require "bundler/setup"
+require "kozo"

data/config/dependencies.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+##
+# Backends
+#
+register("backend.local") do |directory|
+  Kozo::Backends::Local.new(directory)
+end
+
+##
+# Null provider
+#
+register("provider.null") do
+  Kozo::Providers::Null::Provider.new
+end
+
+register("resource.null") do
+  Kozo::Providers::Null::Resources::Null.new
+end
+
+##
+# HCloud
+#
+register("provider.hcloud") do
+  Kozo::Providers::HCloud::Provider.new
+end
+
+register("resource.hcloud_ssh_key") do
+  Kozo::Providers::HCloud::Resources::SSHKey.new
+end

data/config/inflections.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+loader.inflector.inflect(
+  "cli" => "CLI",
+  "dsl" => "DSL",
+  "hcloud" => "HCloud",
+  "ssh_key" => "SSHKey",
+)

data/kozo.gemspec

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require_relative "lib/kozo/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "kozo"
+  spec.version       = Kozo::VERSION
+  spec.authors       = ["Florian Dejonckheere"]
+  spec.email         = ["florian@floriandejonckheere.be"]
+
+  spec.summary       = "Declarative cloud infrastructure"
+  spec.description   = "Declaratively create, modify and destroy cloud infrastructure in your favourite language"
+  spec.homepage      = "http://github.com/floriandejonckheere/kozo"
+  spec.license       = "MIT"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.7.2")
+
+  spec.metadata["source_code_uri"] = "https://github.com/floriandejonckheere/kozo"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "bin"
+  spec.executables   = spec.files.grep(%r(^bin/)) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "activesupport"
+  spec.add_runtime_dependency "zeitwerk"
+
+  spec.add_development_dependency "rubocop"
+  spec.add_development_dependency "rubocop-performance"
+  spec.add_development_dependency "rubocop-rspec"
+
+  spec.add_development_dependency "climate_control"
+  spec.add_development_dependency "factory_bot"
+  spec.add_development_dependency "ffaker"
+  spec.add_development_dependency "overcommit"
+  spec.add_development_dependency "pry-byebug"
+  spec.add_development_dependency "rspec", "~> 3.10"
+  spec.add_development_dependency "shoulda-matchers"
+  spec.add_development_dependency "super_diff"
+  spec.add_development_dependency "timecop"
+  spec.add_development_dependency "webmock"
+end

data/lib/kozo.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require "zeitwerk"
+require "active_support/all"
+
+module Kozo
+  class << self
+    attr_reader :loader
+
+    def root
+      @root ||= Pathname.new(File.expand_path(File.join("..", ".."), __FILE__))
+    end
+
+    def options
+      @options ||= Options.new
+    end
+
+    def container
+      @container ||= Container.new
+    end
+
+    def env
+      @env ||= Environment.new
+    end
+
+    def logger
+      @logger ||= Logger.new
+    end
+
+    def setup
+      @loader = Zeitwerk::Loader.for_gem
+
+      instance_eval(File.read(root.join("config/inflections.rb")))
+
+      loader.enable_reloading
+      loader.setup
+      loader.eager_load
+
+      container.instance_eval(File.read(root.join("config/dependencies.rb")))
+    end
+  end
+end
+
+def reload!
+  Kozo.loader.reload
+end
+
+Kozo.setup

data/lib/kozo/backends/base.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Kozo
+  module Backends
+    class Base
+      attr_accessor :directory
+
+      def initialize(directory)
+        @directory = directory
+      end
+
+      def providers
+        state.fetch(:providers)
+      end
+
+      def resources
+        state.fetch(:resources)
+      end
+
+      protected
+
+      def state
+        raise NotImplementedError
+      end
+
+      def state=(_value)
+        raise NotImplementedError
+      end
+    end
+  end
+end