discourse_theme 2.0.0 → 2.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 418652d7c45d966814257d956464454ae771dba99d94156a322ad38c76200580
-  data.tar.gz: 31ae03c9cc2ad4c858a2666bf59da8a38102078c77cb631fa612de8ef405dfe4
+  metadata.gz: fd374430e4fb62d3c7ee98ebdc23af4709f699dc5b2580c216a12dd0d52fd6fb
+  data.tar.gz: db348e6b482980219f236b1fbbdf9a6a2d1d8e72fe46fce6386fcad35358878a
 SHA512:
-  metadata.gz: baeefaa0afe4afd2b880a2f01235f004e4921185854d5bd35d92b032c2a69c680967a91fdd97164078cfff2ead4ad88caa55ed0ed23f547883b544c55839e876
-  data.tar.gz: f731b2771c1e225291dab344601e3aa5724094d3370e3600fd81cfb4df2f93cdf2775892008438b6edd609b1b9e080f5becbc98438f9c729101cef781e2ee0d9
+  metadata.gz: 79bf80af701810f3f9e35c0b17a1c2d8d854222a09ae9451eecd1796776cb2f0f6d4f5a931a529236f7eebc23c687eb040bce941c8df581b08b633b24dea1f7b
+  data.tar.gz: 77f09a916e25c7bd87407bd6f5c466bd75709a941c2930543977079f175916193d209db336886107dd650dd4a3be128d4c0524784d915fafee048549e3364fa2

data/.github/workflows/ci.yml

@@ -7,7 +7,27 @@ on:
       - main
 
 jobs:
-  build:
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+
+      - name: Lint
+        run: bundle exec rubocop
+
+      - name: syntax_tree
+        if: ${{ !cancelled() }}
+        run: |
+          bundle exec stree check Gemfile $(git ls-files '*.rb') $(git ls-files '*.rake') $(git ls-files '*.thor')
+
+  test:
     runs-on: ubuntu-latest
 
     strategy:
@@ -20,25 +40,23 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
+      - name: Setup Git
+        run: |
+          git config --global user.email "ci@ci.invalid"
+          git config --global user.name "Discourse CI"
+
       - name: Setup ruby
         uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}
           bundler-cache: true
 
-      - name: Lint
-        run: bundle exec rubocop
-
-      - name: syntax_tree
-        run: |
-          bundle exec stree check Gemfile $(git ls-files '*.rb') $(git ls-files '*.rake') $(git ls-files '*.thor')
-
       - name: Tests
         run: bundle exec rake test
 
   publish:
     if: github.event_name == 'push' && github.ref == 'refs/heads/main'
-    needs: build
+    needs: [lint, test]
     runs-on: ubuntu-latest
 
     steps:

data/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.1.1] - 2024-03-25
+
+### Added
+
+- `--version` to CLI (#46)
+
+## [2.1.0] - 2024-02-28
+
+### Changed
+
+- `new` command now uses discourse-theme-skeleton repo (#44)
+
 ## [2.0.0] - 2024-01-31
 
 ### Added

data/discourse_theme.gemspec

@@ -27,7 +27,7 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency "listen", "~> 3.1"
   spec.add_runtime_dependency "multipart-post", "~> 2.0"
   spec.add_runtime_dependency "tty-prompt", "~> 0.18"
-  spec.add_runtime_dependency "rubyzip", "~> 1.2"
+  spec.add_runtime_dependency "rubyzip", "~> 2.3"
   spec.add_runtime_dependency "selenium-webdriver", "> 4.11"
 
   spec.add_development_dependency "bundler"

data/lib/discourse_theme/cli.rb

@@ -37,6 +37,11 @@ module DiscourseTheme
     end
 
     def run(args)
+      if args.delete("--version")
+        puts VERSION
+        return
+      end
+
       usage unless args[1]
 
       reset = !!args.delete("--reset")
@@ -57,7 +62,7 @@ module DiscourseTheme
         raise DiscourseTheme::ThemeError.new "git is not installed" if !command?("git")
         raise DiscourseTheme::ThemeError.new "yarn is not installed" if !command?("yarn")
 
-        DiscourseTheme::Scaffold.generate(dir)
+        DiscourseTheme::Scaffold.generate(dir, name: args[1])
         watch_theme?(args)
       elsif command == "watch"
         raise DiscourseTheme::ThemeError.new "'#{dir} does not exist" unless Dir.exist?(dir)

data/lib/discourse_theme/scaffold.rb

@@ -2,159 +2,111 @@
 
 require "date"
 require "json"
+require "yaml"
+require "resolv"
 
 module DiscourseTheme
   class Scaffold
-    ABOUT_JSON = {
-      about_url: "TODO: Put your theme's public repo or Meta topic URL here",
-      license_url: "TODO: Put your theme's LICENSE URL here",
-      assets: {
-      },
-    }
-
-    HELP = <<~STR
-      Are you a bit lost? Be sure to read https://meta.discourse.org/t/how-to-develop-custom-themes/60848
-    STR
-
-    LICENSE = <<~STR
-      Copyright #YEAR #AUTHOR
-
-      Permission is hereby granted, free of charge, to any person obtaining a copy
-      of this software and associated documentation files (the "Software"), to deal
-      in the Software without restriction, including without limitation the rights
-      to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-      copies of the Software, and to permit persons to whom the Software is
-      furnished to do so, subject to the following conditions:
-
-      The above copyright notice and this permission notice shall be included in all
-      copies or substantial portions of the Software.
-
-      THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-      IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-      FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-      AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-      LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-      OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-      SOFTWARE.
-    STR
-
-    GIT_IGNORE = <<~STR
-      .discourse-site
-      node_modules
-      HELP
-    STR
-
-    API_INITIALIZER = <<~STR
-      import { apiInitializer } from "discourse/lib/api";
-
-      export default apiInitializer("1.8.0", (api) => {
-        console.log("hello world from api initializer!");
-      });
-    STR
-
-    PACKAGE_JSON = <<~STR
-      {
-        "author": "#AUTHOR",
-        "license": "MIT",
-        "devDependencies": {
-          "eslint-config-discourse": "latest"
-        }
-      }
-    STR
-
-    ESLINT_RC = <<~STR
-      {
-        "extends": "eslint-config-discourse",
-        "globals": {
-          "settings": "readonly",
-          "themePrefix": "readonly"
-        }
-      }
-    STR
-
-    TEMPLATE_LINT_RC = <<~STR
-      module.exports = {
-        plugins: ["ember-template-lint-plugin-discourse"],
-        extends: "discourse:recommended",
-      };
-    STR
-
-    EN_YML = <<~YAML
-      en:
-        theme_metadata:
-          description: "#DESCRIPTION"
-    YAML
-
-    SETTINGS_YML = <<~YAML
-      todo_rename_and_use_setting:
-        default: ""
-    YAML
-
-    def self.generate(dir)
+    def self.generate(dir, name:)
       UI.progress "Generating a scaffold theme at #{dir}"
 
-      name =
-        loop do
-          input = UI.ask("What would you like to call your theme?").to_s.strip
-          if input.empty?
-            UI.error("Theme name cannot be empty")
-          else
-            break input
-          end
-        end
-
+      name = UI.ask("What would you like to call your theme?", default: name).to_s.strip
       is_component = UI.yes?("Is this a component?")
 
-      FileUtils.mkdir_p dir
-      Dir.chdir dir do
-        author =
-          loop do
-            input = UI.ask("Who is authoring the theme?", default: ENV["USER"]).to_s.strip
-            if input.empty?
-              UI.error("Author cannot be empty")
-            else
-              break input
-            end
-          end
+      get_theme_skeleton(dir)
 
+      Dir.chdir dir do
+        author = UI.ask("Who is authoring the theme?", default: "Discourse").to_s.strip
         description = UI.ask("How would you describe this theme?").to_s.strip
 
-        about_template = ABOUT_JSON.dup
-        about_template[:name] = name
-        if is_component
-          about_template[:component] = true
-        else
-          about_template[:color_schemes] = {}
+        about = JSON.parse(File.read("about.json"))
+        about["name"] = name
+        about["authors"] = author
+        if !is_component
+          about.delete("component")
+          about["color_schemes"] = {}
         end
+        File.write("about.json", JSON.pretty_generate(about))
+
+        if author != "Discourse"
+          license = File.read("LICENSE")
+          license.sub!(/^(Copyright\s\(c\))\s(.+)/, "\\1 #{author}")
+          File.write("LICENSE", license)
+        end
+
+        readme = File.read("README.md")
+        readme.sub!("**Theme Name**", name)
+        File.write("README.md", readme)
 
-        encoded_name = name.downcase.gsub(/[^a-zA-Z0-9_-]+/, "_")
+        encoded_name = name.downcase.gsub(/[^a-zA-Z0-9_-]+/, "-")
+        FileUtils.mv(
+          "javascripts/discourse/api-initializers/todo.js",
+          "javascripts/discourse/api-initializers/#{encoded_name}.js",
+        )
 
-        write("about.json", JSON.pretty_generate(about_template))
-        write("HELP", HELP)
-        write("LICENSE", LICENSE.sub("#YEAR", "#{Date.today.year}").sub("#AUTHOR", author))
-        write(".eslintrc", ESLINT_RC)
-        write(".gitignore", GIT_IGNORE)
-        write(".template-lintrc.js", TEMPLATE_LINT_RC)
-        write("package.json", PACKAGE_JSON.sub("#AUTHOR", author))
-        write("settings.yml", SETTINGS_YML)
-        write("common/common.scss", "")
-        write("javascripts/discourse/api-initializers/#{encoded_name}.js", API_INITIALIZER)
-        write("locales/en.yml", EN_YML.sub("#DESCRIPTION", description))
+        i18n = YAML.safe_load(File.read("locales/en.yml"))
+        i18n["en"]["theme_metadata"]["description"] = description
+        File.write("locales/en.yml", YAML.safe_dump(i18n).sub(/\A---\n/, ""))
 
         UI.info "Initializing git repo"
-        puts `git init && git symbolic-ref HEAD refs/heads/main`
+        FileUtils.rm_rf(".git")
+        FileUtils.rm_rf("**/.gitkeep")
+        system "git", "init", exception: true
+        system "git", "symbolic-ref", "HEAD", "refs/heads/main", exception: true
+        root_files = Dir.glob("*").select { |f| File.file?(f) }
+        system "git", "add", *root_files, exception: true
+        system "git", "add", ".*", exception: true
+        system "git", "add", "locales", exception: true
+        system "git",
+               "commit",
+               "-m",
+               "Initial commit by `discourse_theme` CLI",
+               "--quiet",
+               exception: true
 
         UI.info "Installing dependencies"
-        puts `yarn`
+        system "yarn", exception: true
       end
+
+      puts "✅ Done!"
+      puts "See https://meta.discourse.org/t/how-to-develop-custom-themes/60848 for more information!"
     end
 
     private
 
-    def self.write(filename, contents)
-      UI.info "Creating #{filename}"
-      FileUtils.mkdir_p(File.dirname(filename))
-      File.write(filename, contents)
+    def self.get_theme_skeleton(dir)
+      if online?
+        puts "Downloading discourse-theme-skeleton"
+        tmp = Dir.mktmpdir
+        system "git",
+               "clone",
+               "https://github.com/discourse/discourse-theme-skeleton",
+               tmp,
+               "--depth",
+               "1",
+               "--quiet",
+               exception: true
+        FileUtils.rm_rf(skeleton_dir)
+        # Store the local copy for offline use
+        FileUtils.cp_r(tmp, skeleton_dir)
+
+        FileUtils.cp_r(skeleton_dir, dir)
+      elsif Dir.exist?(skeleton_dir)
+        puts "⚠️ No internet connection detected, using the local copy of discourse-theme-skeleton"
+        FileUtils.cp_r(skeleton_dir, dir)
+      else
+        raise "🛑 Couldn't download discourse-theme-skeleton"
+      end
+    end
+
+    def self.online?
+      !!Resolv::DNS.new.getaddress("github.com")
+    rescue Resolv::ResolvError => e
+      false
+    end
+
+    def self.skeleton_dir
+      File.expand_path("~/.discourse_theme_skeleton")
     end
   end
 end

data/lib/discourse_theme/version.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module DiscourseTheme
-  VERSION = "2.0.0"
+  VERSION = "2.1.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: discourse_theme
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.1
 platform: ruby
 authors:
 - Sam Saffron
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-31 00:00:00.000000000 Z
+date: 2024-03-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitar
@@ -72,14 +72,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '2.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '2.3'
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
   requirement: !ruby/object:Gem::Requirement