strata-cli 0.1.13 → 0.1.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 61be99c9ce107eae809e67fa23dd4108a471dcc90b6adb039a298b5d59005106
-  data.tar.gz: '080076fa7d113e1e066caca27a3e33e3c438a0bb8d2e53a602ed75cf7a5b5ec5'
+  metadata.gz: 7b0fdc6cf6a28080152c9b0237d54e206740477d196178a2e6d5aa5642720135
+  data.tar.gz: d049c71dd05982f8a52b786ae59ffdf590056dc3bdb5cadd7045227dbe9de867
 SHA512:
-  metadata.gz: eaac835415776492c4858204340238a71fc9a8e45ad61183d46f532a22723774d39a16e9dfb30db5841bc897a12547a9a8fe93c1543e3b7e1975daecdf5b2d82
-  data.tar.gz: d443533139c4aea533e2bf0fd2d3f14e7de3bf7f1bb87e004e174a7232802b8c9086c7e470bb1640c697522fad07445db6bbfa60185e1a667fbe0f7c838ede58
+  metadata.gz: f7c7aa4945d149bff16578ca52f99a005b3c9d4c3b5897b52929bf9bfffb140883457f60d52552fa551faee5ef6d0472069c368125653bf784078378a7065dbe
+  data.tar.gz: 48a81467d16e8b489bdce4f177dd1b158ac09344c07d1944d804a679afc0ed47e52047b6a478781ba245c291a4d9bb8512f8159b1d09ecf41e1f537b5873e52b

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 ## [Unreleased]
 
+## [0.1.14] - 2026-07-17
+
+### Added
+
+- **Tutorial command**: `strata tutorial` walks new users through a guided setup — initializes a project, configures a datasource, and deploys to a local Strata server running on port 8080.
+
+### Changed
+
+- **Tutorial deployment**: Completion message now includes `--skip-audit` flag in the deployment instructions.
+- **Tutorial server config**: Default server port set to 8080 (was 3000).
+
 ## [0.1.13] - 2026-06-20
 
 ### Changed

data/lib/strata/cli/configuration.rb

@@ -72,6 +72,8 @@ module Strata
 
       def reload!
         @data.clear
+        @config_file_path = nil
+        @project_config_file_path = nil
         load_config
       end
 

data/lib/strata/cli/descriptions/tutorial.txt

@@ -0,0 +1,13 @@
+Sets up the Strata tutorial project locally by cloning the tutorial repo,
+wiring it to your Strata instance, and preparing it for `strata deploy`.
+
+The --api-key value is shown on the tutorial setup page
+in your Strata instance. Copy-paste them directly from there.
+
+After running this command, `cd` into the project directory and run
+`strata deploy` to deploy the tutorial to your Strata instance.
+
+Example:
+  strata tutorial -a your_api_key
+  cd tutorial
+  strata deploy

data/lib/strata/cli/generators/tutorial.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require_relative "group"
+require_relative "../helpers/project_helper"
+require_relative "../output"
+require "yaml"
+require "fileutils"
+
+module Strata
+  module CLI
+    module Generators
+      class Tutorial < Group
+        TUTORIAL_REPO = "https://github.com/stratasite/strata-tutorial-project"
+        DEFAULT_SERVER = "http://localhost:8080"
+        TUTORIAL_PROJECT = "strata-tutorial-project"
+
+        class_option :api_key, aliases: ["a"], type: :string, desc: "Strata API key"
+
+        desc "Sets up the Strata tutorial project locally."
+
+        def validate_options
+          raise Strata::CommandError, "--api-key (-a) is required." unless options[:api_key]
+          @uid = TUTORIAL_PROJECT
+          @project_id = 1
+        end
+
+        def clone_tutorial_repo
+          if File.directory?(@uid)
+            Output.print_status(:skip, "Directory '#{@uid}' already exists — re-using it", type: :info, context: self)
+            return
+          end
+          Output.print_status(:clone, "Cloning tutorial from #{TUTORIAL_REPO}", type: :success, context: self)
+          run "git clone #{TUTORIAL_REPO} #{@uid}", verbose: false, capture: true
+          raise Strata::CommandError, "Failed to clone tutorial repo." unless File.directory?(@uid)
+        end
+
+        def reinitialize_git
+          inside @uid do
+            FileUtils.rm_rf(".git")
+            run "git init -b main", verbose: false, capture: true
+            create_file ".gitignore", ".strata\n.strata_cli/\n", force: true
+          end
+        end
+
+        def write_strata_config
+          strata_path = File.join(@uid, ".strata")
+          File.write(strata_path, "api_key: #{options[:api_key]}\nserver: #{DEFAULT_SERVER}\n")
+          File.chmod(0o600, strata_path)
+        end
+
+        def update_project_yml
+          project_yml = File.join(@uid, "project.yml")
+          return unless File.exist?(project_yml)
+
+          Helpers::ProjectHelper.persist_project_id_to_yml(@project_id, project_yml_path: project_yml)
+        end
+
+        def initial_commit
+          inside @uid do
+            run "git add -A", verbose: false, capture: true
+            run 'git commit -m "Initial tutorial project setup"', verbose: false, capture: true
+          end
+        end
+
+        def completion_message
+          Output.print_success("\n✔ Tutorial project '#{@uid}' is ready!\n", context: self)
+          Output.print_info("  Next: cd #{@uid} && strata deploy --skip-audit\n", context: self)
+        end
+      end
+    end
+  end
+end

data/lib/strata/cli/guard.rb

@@ -8,6 +8,7 @@ module Strata
     module Guard
       ALLOWED_COMMANDS = %w[
         init
+        tutorial
         help
         adapters
         version

data/lib/strata/cli/main.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "generators/project"
+require_relative "generators/tutorial"
 require_relative "sub_commands/datasource"
 require_relative "sub_commands/deploy"
 require_relative "sub_commands/branch"
@@ -47,6 +48,13 @@ module Strata
         invoke Generators::Project, [project_name], options
       end
 
+      desc "tutorial", "Set up the Strata TPC-DS tutorial project"
+      long_desc_from_file "tutorial"
+      option :api_key, aliases: ["a"], type: :string, desc: "Strata API key"
+      def tutorial
+        invoke Generators::Tutorial, [], options
+      end
+
       desc "adapters", "Lists supported data warehouse adapters"
       def adapters
         out = " SUPPORTED ADAPTERS: \n\t#{DWH.adapters.keys.join("\n\t")}"

data/lib/strata/cli/version.rb

@@ -2,6 +2,6 @@
 
 module Strata
   module CLI
-    VERSION = "0.1.13"
+    VERSION = "0.1.14"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: strata-cli
 version: !ruby/object:Gem::Version
-  version: 0.1.13
+  version: 0.1.14
 platform: ruby
 authors:
 - Ajo Abraham
@@ -264,6 +264,7 @@ files:
 - lib/strata/cli/descriptions/deploy/deploy.txt
 - lib/strata/cli/descriptions/deploy/status.txt
 - lib/strata/cli/descriptions/init.txt
+- lib/strata/cli/descriptions/tutorial.txt
 - lib/strata/cli/error_reporter.rb
 - lib/strata/cli/generators/datasource.rb
 - lib/strata/cli/generators/group.rb
@@ -292,6 +293,7 @@ files:
 - lib/strata/cli/generators/templates/table.table_name.yml
 - lib/strata/cli/generators/templates/test.yml
 - lib/strata/cli/generators/test.rb
+- lib/strata/cli/generators/tutorial.rb
 - lib/strata/cli/guard.rb
 - lib/strata/cli/helpers/command_context.rb
 - lib/strata/cli/helpers/datasource_helper.rb