terraspace 0.0.0 → 0.1.0

data/lib/terraspace/cli/bundle.rb

@@ -0,0 +1,28 @@
+require "terraspace-bundler"
+TerraspaceBundler.logger = Terraspace.logger
+
+class Terraspace::CLI
+  class Bundle
+    def initialize(options={})
+      @options = options
+    end
+
+    def run
+      TerraspaceBundler::CLI.start(args)
+    end
+
+    # Allows bundle to be called without install. So both work:
+    #
+    #    terraspace bundle
+    #    terraspace bundle install
+    #
+    def args
+      args = @options[:args]
+      if args.empty? or args.first.include?('--')
+        args.unshift("install")
+      end
+      args = ["bundle"] + args
+      args
+    end
+  end
+end

data/lib/terraspace/cli/check_setup.rb

@@ -0,0 +1,73 @@
+class Terraspace::CLI
+  class CheckSetup
+    extend Memoist
+
+    # Terraspace requires at least this version of terraform
+    REQUIRED_TERRAFORM_VERSION = "0.12"
+
+    def initialize(options={})
+      @options = options
+    end
+
+    # Used for the CLI
+    def run
+      puts "Detected Terrspace version: #{Terraspace::VERSION}"
+      if terraform_bin
+        puts "Detected Terraform bin: #{terraform_bin}"
+        puts "Detected #{terraform_version_message}"
+        check_required_version!
+      else
+        puts "Terraform not installed. Unable to detect a terraform command. Please double check that terraform is installed."
+        exit 1
+      end
+    end
+
+    def check_required_version!
+      puts "Terraspace requires Terraform v#{REQUIRED_TERRAFORM_VERSION}.x"
+      if ok?
+        puts "You're all set!"
+      else
+        puts "The installed version of terraform may not work with terraspace. Recommend using terraform v#{REQUIRED_TERRAFORM_VERSION}.x"
+        exit 1
+      end
+    end
+
+    def ok?
+      version = terraform_version_message.sub(/.*v/,'') # => 0.12.24
+      major, minor, _ = version.split('.')
+      required_major, required_minor = REQUIRED_TERRAFORM_VERSION.split('.')
+      x = major.to_i >= required_major.to_i
+      y = minor.to_i >= required_minor.to_i
+      x && y
+    end
+
+    def terraform_bin
+      bin_path = `which terraform 2>&1`.strip
+      bin_path if $?.success?
+    end
+    memoize :terraform_bin
+
+    # First line contains the Terraform version info:
+    #
+    #     $ terraform --version
+    #     Terraform v0.12.24
+    #
+    #     Your version of Terraform is out of date! The latest version
+    #     is 0.12.26. You can update by downloading from https://www.terraform.io/downloads.html
+    #
+    def terraform_version_message
+      `terraform --version`.split("\n").first.strip
+    end
+    memoize :terraform_version_message
+
+    class << self
+      # Used as library call
+      def check!
+        setup = new
+        return if setup.ok?
+        # run meth designed for CLI and will puts out informative messages about installed version and exit 1 when version is not ok
+        setup.run
+      end
+    end
+  end
+end

data/lib/terraspace/cli/clean.rb

@@ -0,0 +1,12 @@
+class Terraspace::CLI
+  class Clean
+    def initialize(options={})
+      @options = options
+    end
+
+    def run
+      FileUtils.rm_rf(Terraspace.cache_root)
+      puts "Removed #{Terraspace::Util.pretty_path(Terraspace.cache_root)}"
+    end
+  end
+end

data/lib/terraspace/cli/commander.rb

@@ -0,0 +1,14 @@
+class Terraspace::CLI
+  class Commander < Base
+    def initialize(name, options={})
+      @name = name
+      super(options)
+    end
+
+    # Commander always runs Build#run
+    def run
+      Build.new(@options).run # generate and init
+      Terraspace::Terraform::Runner.new(@name, @options).run
+    end
+  end
+end

data/lib/terraspace/cli/help.rb

@@ -0,0 +1,11 @@
+class Terraspace::CLI
+  class Help
+    class << self
+      def text(namespaced_command)
+        path = namespaced_command.to_s.gsub(':','/')
+        path = File.expand_path("../help/#{path}.md", __FILE__)
+        IO.read(path) if File.exist?(path)
+      end
+    end
+  end
+end

data/lib/terraspace/cli/help/bundle.md

@@ -0,0 +1,14 @@
+## Example
+
+    terraspace bundle
+
+## More commands
+
+    terraspace bundle install # same as bundle
+    terraspace bundle update  # Updates Terrafile.lock
+    terraspace bundle clean   # removes /tmp terraspace bundler folder
+
+## Update a single module
+
+    terraspace bundle update MOD_NAME
+    terraspace bundle update demo

data/lib/terraspace/cli/help/completion.md

@@ -0,0 +1,20 @@
+## Examples
+
+    terraspace completion
+
+Prints words for TAB auto-completion.
+
+    terraspace completion
+    terraspace completion up
+    terraspace completion up name
+
+To enable, TAB auto-completion add the following to your profile:
+
+    eval $(terraspace completion_script)
+
+Auto-completion example usage:
+
+    terraspace [TAB]
+    terraspace up [TAB]
+    terraspace up name [TAB]
+    terraspace up name --[TAB]

data/lib/terraspace/cli/help/completion_script.md

@@ -0,0 +1,3 @@
+To use, add the following to your `~/.bashrc` or `~/.profile`
+
+    eval $(terraspace completion_script)

data/lib/terraspace/cli/help/update.md

@@ -0,0 +1,5 @@
+## Examples
+
+    terraspace update MODULE
+    terraspace update instance
+    terraspace up instance

data/lib/terraspace/cli/info.rb

@@ -0,0 +1,30 @@
+class Terraspace::CLI
+  class Info < Base
+    extend Memoist
+
+    def run
+      format = @options[:format] || "text"
+      send("#{format}_output")
+    end
+
+    def json_output
+      puts JSON.pretty_generate(info)
+    end
+
+    def text_output
+      info.each do |k,v|
+        k = "%-#{rpad}s" % k
+        puts "#{k} #{v}"
+      end
+    end
+
+    def rpad
+      info.keys.map(&:size).max
+    end
+    memoize :rpad
+
+    def info
+      @mod.to_info
+    end
+  end
+end

data/lib/terraspace/cli/new.rb

@@ -0,0 +1,32 @@
+class Terraspace::CLI
+  class New < Terraspace::Command
+    long_desc Help.text(:module)
+    Module.base_options.each { |args| option(*args) }
+    Module.component_options.each { |args| option(*args) }
+    register(Module, "module", "module NAME", "Generates new module")
+
+    long_desc Help.text(:stack)
+    Stack.base_options.each { |args| option(*args) }
+    Stack.component_options.each { |args| option(*args) }
+    register(Stack, "stack", "stack NAME", "Generates new stack")
+
+    long_desc Help.text(:project)
+    Project.base_options.each { |args| option(*args) }
+    Project.project_options.each { |args| option(*args) }
+    register(Project, "project", "project NAME", "Generates new project")
+
+    long_desc Help.text(:project_test)
+    register(Test::Project, "project_test", "project_test NAME", "Generates new project test")
+
+    long_desc Help.text(:module_test)
+    register(Test::Module, "module_test", "module_test NAME", "Generates new module test")
+
+    long_desc Help.text(:bootstrap_test)
+    Test::Bootstrap.options.each { |args| option(*args) }
+    register(Test::Bootstrap, "bootstrap_test", "bootstrap_test", "Generates bootstrap test setup")
+
+    long_desc Help.text(:plugin)
+    Plugin.options.each { |args| option(*args) }
+    register(Plugin, "plugin", "plugin", "Generates plugin")
+  end
+end

data/lib/terraspace/cli/new/helper.rb

@@ -0,0 +1,15 @@
+class Terraspace::CLI::New
+  module Helper
+    include Helper::PluginGem
+
+  private
+    def build_gemfile(*list)
+      lines = []
+      list.each do |name|
+        line =  %Q|gem "#{name}"|
+        lines << line
+      end
+      lines.join("\n")
+    end
+  end
+end

data/lib/terraspace/cli/new/helper/plugin_gem.rb

@@ -0,0 +1,12 @@
+module Terraspace::CLI::New::Helper
+  module PluginGem
+  private
+    def plugin_gem_name
+      if @options[:plugin_gem]
+        @options[:plugin_gem]
+      else
+        "terraspace_plugin_#{@options[:plugin]}"
+      end
+    end
+  end
+end

data/lib/terraspace/cli/new/module.rb

@@ -0,0 +1,26 @@
+class Terraspace::CLI::New
+  class Module < Sequence
+    component_options.each { |args| class_option(*args) }
+
+    argument :name
+
+    def create_module
+      puts "=> Creating test for new module: #{name}"
+      plugin_template_source(@options[:lang], "module") # IE: plugin_template_source("hcl", "module")
+      dest = "app/modules/#{name}"
+      dest = "#{@options[:project_name]}/#{dest}" if @options[:project_name]
+      directory ".", dest
+    end
+
+    def create_test
+      args = component_args(name, @options[:project_name])
+      Test::Module.start(args)
+    end
+
+    def run_generator_hook_script
+      script = ENV['TS_GENERATOR_MODULE']
+      return unless script
+      run_script(script, "app/modules/#{name}")
+    end
+  end
+end

data/lib/terraspace/cli/new/plugin.rb

@@ -0,0 +1,20 @@
+class Terraspace::CLI::New
+  class Plugin < Sequence
+    include Helper
+
+    def self.options
+      [
+        [:force, type: :boolean, desc: "Bypass overwrite are you sure prompt for existing files"],
+      ]
+    end
+    options.each { |args| class_option(*args) }
+
+    argument :name
+
+    def create_plugin
+      puts "=> Creating new plugin: #{name}"
+      core_template_source("plugin")
+      directory ".", "terraspace_plugin_#{name}"
+    end
+  end
+end

data/lib/terraspace/cli/new/plugin/helper.rb

@@ -0,0 +1,15 @@
+class Terraspace::CLI::New::Plugin
+  module Helper
+  private
+    # helper
+    def camel_name
+      name.camelize
+    end
+
+    # friendly method
+    def core_template_source(template)
+      source = Terraspace::CLI::New::Source::Core.new(self, @options)
+      source.set_core_source(template)
+    end
+  end
+end

data/lib/terraspace/cli/new/project.rb

@@ -0,0 +1,110 @@
+class Terraspace::CLI::New
+  class Project < Sequence
+    def self.project_options
+      [
+        [:bundle, type: :boolean, default: true, desc: "Runs bundle install on the project"],
+        [:config, type: :boolean, default: true, desc: "Whether or not to generate config files."],
+        [:force, type: :boolean, desc: "Bypass overwrite are you sure prompt for existing files."],
+        [:test_structure, type: :boolean, desc: "Create project bootstrap test structure."]
+      ]
+    end
+
+    base_options.each { |args| class_option(*args) }
+    project_options.each { |args| class_option(*args) }
+
+    def creating_messaging
+      puts "=> Creating new project called #{name}."
+    end
+
+    def create_base
+      plugin_template_source("base", "project")
+      directory ".", "#{name}"
+    end
+
+    # Will generate config folder from
+    #
+    #     1. terraspace code lang templates or
+    #     2. example lang templates from provider gems
+    #
+    def create_project
+      plugin_template_source(@options[:lang], "project") # IE: plugin_template_source("hcl", "project")
+
+      options = @options[:config] == false ? {exclude_pattern: "config" } : {}
+      directory ".", "#{name}", options
+
+      if @options[:config] == false
+        empty_directory("#{name}/config")
+      end
+    end
+
+    def empty_dirs
+      return if @options[:examples]
+      empty_directory("#{name}/app/modules")
+      empty_directory("#{name}/app/stacks")
+    end
+
+    def create_starter_module
+      return unless @options[:examples]
+      Module.start(component_args("example", name))
+    end
+
+    def create_starter_stack
+      return unless @options[:examples]
+      Stack.start(component_args("demo", name))
+    end
+
+    def create_test
+      return if @options[:test_structure] == false
+      Test::Bootstrap.start(["--dir", name])
+    end
+
+    def bundle_install
+      return if @options[:bundle] == false
+      puts "=> Installing dependencies with: bundle install"
+      Bundler.with_unbundled_env do
+        system("BUNDLE_IGNORE_CONFIG=1 bundle install", chdir: name)
+      end
+    end
+
+    def welcome_message_examples
+      return unless options[:examples]
+      puts <<~EOL
+        #{"="*64}
+        Congrats! You have successfully created a terraspace project.
+        Check out the created files. Adjust to the examples and then deploy with:
+
+            cd #{name}
+            terraspace up demo -y   # to deploy
+            terraspace down demo -y # to destroy
+
+        More info: https://terraspace.cloud/
+      EOL
+    end
+
+    def welcome_message_no_examples
+      return if options[:examples]
+      puts <<~EOL
+        #{"="*64}
+        Congrats! You have successfully created a terraspace project.
+        Check out the created files.
+
+            cd #{name}
+
+        You can create starter modules and stacks with their generators:
+
+            terraspace new module example
+            terraspace new stack demo
+
+        Add your code to them, and deploy when you are ready:
+
+            terraspace up demo -y   # to deploy
+
+        Destroy with:
+
+            terraspace down demo -y # to destroy
+
+        More info: https://terraspace.cloud/
+      EOL
+    end
+  end
+end