brut 0.17.0 → 0.18.0

data/bin/ci

@@ -1,40 +0,0 @@
-#!/usr/bin/env ruby
-
-require "optparse"
-require "pathname"
-require "fileutils"
-require_relative "bin_kit"
-
-OptionParser.new do |opts|
-  opts.banner = "Usage: ci [options]\n\n    Runs all tests/QA in all repos\n\nOPTIONS\n\n"
-
-  opts.on("-h", "--help", "Display this help message") do
-    puts opts
-    puts
-    exit
-  end
-end.parse!
-
-brutjs_dir  = (Pathname(__FILE__).dirname / ".." / "brut-js" ).expand_path.to_s
-brutcss_dir = (Pathname(__FILE__).dirname / ".." / "brut-css" ).expand_path.to_s
-mkbrut_dir  = (Pathname(__FILE__).dirname / ".." / "mkbrut" ).expand_path.to_s
-
-log "Running BrutRB tests"
-system!("bin/test")
-
-log "Running mkbrut tests"
-FileUtils.chdir mkbrut_dir do
-  system!("bin/ci")
-end
-
-log "Running Rubcop"
-system!("bin/generate-and-run-rubocop")
-
-log "Running brut-js tests"
-FileUtils.chdir brutjs_dir do
-  system!("bin/ci")
-end
-log "Running brut-css tests"
-FileUtils.chdir brutcss_dir do
-  system!("bin/ci")
-end

data/bin/dev

@@ -1,20 +0,0 @@
-#!/usr/bin/env ruby
-
-require "optparse"
-require "pathname"
-require "fileutils"
-
-options = {}
-OptionParser.new do |opts|
-  opts.banner = "Usage: docs [options]"
-
-  opts.on("-h", "--help", "Display this help message") do
-    puts opts
-    exit
-  end
-end.parse!
-
-dot_com_dir = (Pathname(__FILE__).dirname / ".." / "brutrb.com" ).expand_path.to_s
-FileUtils.chdir dot_com_dir do
-  system "bin/dev"
-end

data/bin/docs

@@ -1,86 +0,0 @@
-#!/usr/bin/env ruby
-
-require "optparse"
-require "pathname"
-require "fileutils"
-require_relative "bin_kit"
-
-options = {
-  dotcom: true,
-}
-
-OptionParser.new do |opts|
-  opts.banner = "Usage: docs [options]\n\n    Generates all documentation for the project\n\nOPTIONS\n\n"
-
-  opts.on("-h", "--help", "Display this help message") do
-    puts opts
-    puts
-    exit
-  end
-  opts.on("--rdoc", "If set, only generate the RDoc") do
-    options[:rdoc_only] = true
-  end
-  opts.on("--[no-]dotcom", "Deploy (or not), brutrb.com to the docs/ directory (default #{options[:dotcom]})") do |value|
-    options[:dotcom] = value
-  end
-end.parse!
-
-dotcom_dir  = (Pathname(__FILE__).dirname / ".." / "brutrb.com" ).expand_path
-public_dir  = (dotcom_dir / "public" ).expand_path
-docs_dir    =  public_dir / "api"
-brutjs_dir  = (Pathname(__FILE__).dirname / ".." / "brut-js" ).expand_path.to_s
-brutcss_dir = (Pathname(__FILE__).dirname / ".." / "brut-css" ).expand_path.to_s
-mkbrut_dir  = (Pathname(__FILE__).dirname / ".." / "mkbrut" ).expand_path.to_s
-
-system!(
-  "bundle exec yard doc -o '#{docs_dir}' --no-progress -m markdown -M rdiscount --backtrace",
-)
-
-log "Hacking CSS"
-
-[
-  docs_dir /  "css" / "style.css",
-  docs_dir /  "css" / "full_list.css",
-].each do |css_file_to_hack|
-  lines = File.read(css_file_to_hack).split(/\n/)
-  File.open(css_file_to_hack, "w") do |f|
-    lines.each do |line|
-      if line =~ /\"Lucida Sans"/
-        f.puts line.gsub(/\"Lucida Sans\"/, '"Helvetica Neue", "Lucida Sans"')
-      elsif line =~ / Monaco,/
-        f.puts line.gsub(/ Monaco,/, '"Courier New", Monaco,')
-      elsif line =~ /font-family: monospace;/
-        f.puts line.gsub(/font-family: monospace;/, 'font-family: "Courier New", monospace;')
-      else
-        f.puts line
-      end
-    end
-    f.puts "code { font-family: 'Courier New', monospace; font-weight: 600; }"
-  end
-end
-
-if options[:rdoc_only]
-  exit 0
-end
-
-log "Generating brut-js docs"
-FileUtils.chdir brutjs_dir do
-  system!("bin/docs")
-end
-log "Generating brut-css docs"
-FileUtils.chdir brutcss_dir do
-  system!("bin/docs")
-end
-log "Generating mkbrut docs"
-FileUtils.chdir mkbrut_dir do
-  system!("bin/docs")
-end
-
-if options[:dotcom]
-  log "Deploying brutrb.com to docs/"
-  FileUtils.chdir dotcom_dir do
-    system!("bin/deploy")
-  end
-else
-  log "Skipping brutrb.com deployment"
-end

data/bin/generate-and-run-rubocop

@@ -1,52 +0,0 @@
-#!/bin/bash
-
-set -e
-
-SCRIPT_DIR=$( cd -- "$( dirname -- "${0}" )" > /dev/null 2>&1 && pwd )
-ROOT_DIR=$(realpath "$SCRIPT_DIR/..")
-
-usage() {
-  echo "Usage: $0 [-R]"
-  echo
-  echo "    Generates .rubocop.yml and runs rubocop"
-  echo
-  echo "OPTIONS"
-  echo
-  echo "    -R - Do not run rubocop, just generate the configuration"
-  echo
-}
-
-for arg in "$@"; do
-  if [ "${arg}" = "-h" ] || [ "${arg}" = "--help" ] || [ "${arg}" = "help" ]; then
-    usage
-    exit 0
-  fi
-done
-
-RUN_RUBOCOP=true
-while getopts "R" opt "${@}"; do
-  case ${opt} in
-    R )
-      RUN_RUBOCOP=false
-      ;;
-    \? )
-      log "🛑" "Unknown option: ${opt}"
-      usage
-      ;;
-    : )
-      log "🛑" "Invalid option: ${opt} requires an argument"
-      usage
-      ;;
-  esac
-done
-shift $((OPTIND -1))
-
-cd $ROOT_DIR
-echo "[ "$0" ] Generating .rubocop.yml"
-ruby -I "lib" -r brut/rubocop_config -e "Brut::RubocopConfig.new.create_ridiculous_yaml" .rubocop.yml
-if [ "$RUN_RUBOCOP" = true ]; then
-  echo "[ "$0" ] Running rubocop"
-  bin/rubocop
-else
-  echo "[ "$0" ] Not Running rubocop"
-fi

data/bin/new-version

@@ -1,8 +0,0 @@
-set -e
-
-VIM=nvim
-if [ -f /.dockerenv ]; then
-  VIM=vim
-fi
-
-$VIM -o lib/brut/version.rb mkbrut/lib/mkbrut/version.rb brut-js/package.json brut-css/package.json CHANGELOG.md

data/bin/publish

@@ -1,61 +0,0 @@
-#!/usr/bin/env ruby
-
-require "optparse"
-require "pathname"
-require "fileutils"
-require "json"
-require_relative "bin_kit"
-
-def main
-
-  log "Building artifacts"
-  system!("bin/build")
-
-  brutjs_dir  = (Pathname(__FILE__).dirname / ".." / "brut-js" ).expand_path.to_s
-  brutcss_dir = (Pathname(__FILE__).dirname / ".." / "brut-css" ).expand_path.to_s
-  mkbrut_dir  = (Pathname(__FILE__).dirname / ".." / "mkbrut" ).expand_path.to_s
-
-  log "Pushing brut"
-  system!("bin/rake release")
-
-  log "Pushing brujt-js"
-  FileUtils.chdir brutjs_dir do
-    system!("bin/publish")
-  end
-
-  log "Pushing brut-css"
-  FileUtils.chdir brutcss_dir do
-    system!("bin/publish")
-  end
-
-  log "Building mkbrut"
-  FileUtils.chdir mkbrut_dir do
-    system!("bin/publish")
-  end
-end
-
-options = {
-  repo_check: true,
-}
-OptionParser.new do |opts|
-  opts.banner = "Usage: publish [options]\n\n    Builds and publishes all artifacts\n\nOPTIONS"
-
-  opts.on("-h", "--help", "Display this help message") do
-    puts opts
-    exit
-  end
-end.parse!
-
-def require_clean_repo!
-  out, err = capture!("git status --porcelain")
-  if out.to_s.strip != ""
-    log out
-    log err
-    log "Your git repository is not clean. Please commit or stash your changes before running this script."
-    exit 1
-  end
-end
-
-require_clean_repo!
-main
-

data/bin/rake

@@ -1,27 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-#
-# This file was generated by Bundler.
-#
-# The application 'rake' is installed as part of a gem, and
-# this file is here to facilitate running it.
-#
-
-ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
-
-bundle_binstub = File.expand_path("bundle", __dir__)
-
-if File.file?(bundle_binstub)
-  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
-    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("rake", "rake")

data/bin/rspec

@@ -1,27 +0,0 @@
-#!/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.
-#
-
-ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
-
-bundle_binstub = File.expand_path("bundle", __dir__)
-
-if File.file?(bundle_binstub)
-  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
-    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/rubocop

@@ -1,27 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-#
-# This file was generated by Bundler.
-#
-# The application 'rubocop' is installed as part of a gem, and
-# this file is here to facilitate running it.
-#
-
-ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
-
-bundle_binstub = File.expand_path("bundle", __dir__)
-
-if File.file?(bundle_binstub)
-  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
-    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("rubocop", "rubocop")

data/bin/setup

@@ -1,252 +0,0 @@
-#!/usr/bin/env ruby
-
-require_relative "bin_kit"
-require "optparse"
-require "pathname"
-require "fileutils"
-
-def setup(update_gems:,setup_credentials:)
-  if update_gems
-    log "Updating gems"
-    system! "bundle update"
-  else
-    log "Installing gems"
-    # Only do bundle install if the much-faster
-    # bundle check indicates we need to
-    system! "bundle check --no-color || bundle install --no-color --quiet"
-  end
-
-  log "Creating Rubocop configuration"
-  system! "bin/generate-and-run-rubocop -R"
-
-  log "Installing Ruby LSP"
-  system! "gem install ruby-lsp"
-
-  log "Installing rubocop-disable_syntax because I have not set up RubyLSP for bundler yet"
-  system! "gem install rubocop-disable_syntax"
-
-  log "Installing JS/TS and CSS LSPs"
-  system! "npm install -g typescript typescript-language-server vscode-langservers-extracted"
-
-  project_root = Pathname($0).dirname / ".."
-  if setup_credentials
-    credentials_dir = project_root / "dx" / "credentials"
-    if credentials_dir.exist?
-      if credentials_dir.directory?
-        log "#{credentials_dir} exists"
-      else
-        log "#{credentials_dir} is not a directory - please delete it or move it elsewhere and re-run this script"
-        exit 1
-      end
-    else
-      log "#{credentials_dir} doesn't exist - creating"
-      FileUtils.mkdir_p credentials_dir
-    end
-
-    # https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent?platform=linux
-    key_file = credentials_dir / "id_ed25519"
-
-    if key_file.exist?
-      log "#{key_file} exists already"
-    else
-      git_config_command = "git config --get user.email"
-      email = `#{git_config_command}`.chomp
-      if !$?.success?
-        log "Could not determine your email via #{git_config_command} - is your git set up properly?"
-        exit 1
-      end
-      log "Creating your key in #{key_file} using email #{email}."
-      log "You will be prompted for a passphrase, which you are encouraged to provide"
-      system! "ssh-keygen -t ed25519 -C #{email} -f \"#{key_file}\""
-      log ""
-      log "You must now add this to your GitHub profile in order to perform Git commands"
-      log ""
-      log "The key you just generated has a public key that should be available on your computer at"
-      log ""
-      log "   #{key_file.relative_path_from(project_root)}.pub"
-      log ""
-      log "Copy its contents and head to:"
-      log ""
-      log "   https://github.com/settings/keys"
-      log ""
-      log "Click 'New SSH key' and paste your key in, giving it a name like 'Brut Dev Env'"
-      log ""
-      log "(if this doesn't look right, check https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)"
-      log ""
-      log "Hit return when done"
-      x = gets
-    end
-
-    log "Checking if ssh-agent has your SSH key"
-    out,_err = capture!("ssh-keygen -lf #{key_file}")
-    sha256 = out.split(/SHA256:/)[1].split(/\s+/)[0]
-    command = "ssh-add -l | grep #{sha256} > /dev/null"
-    log "Running '#{command}' to check"
-    if system(command)
-      log "SSH Key is in ssh agent"
-    else
-      log "Adding your SSH key to ssh-agent - you must provide your passphrase"
-      system! "ssh-add #{key_file}"
-    end
-
-    known_hosts_dest = Pathname("/") / "home" / "appuser" / ".ssh" / "known_hosts"
-    if known_hosts_dest.exist?
-      log "#{known_hosts_dest} exists, your ssh key should work with GitHub"
-    else
-      log "#{known_hosts_dest} does not exist"
-      known_hosts_source = credentials_dir / "known_hosts"
-      if known_hosts_source.exist?
-        log "#{known_hosts_source} exists - copying it to #{known_hosts_dest}"
-        FileUtils.mkdir_p known_hosts_dest.dirname
-        FileUtils.chmod(0700,known_hosts_dest.dirname)
-        FileUtils.cp known_hosts_source, known_hosts_dest
-        FileUtils.chmod(0600,known_hosts_dest)
-      else
-        log "#{known_hosts_source} also does not exist. To create it, we'll connect to github.com"
-        log "NOTE: it will show you a fingerprint to verify authenticity. You should check it against:"
-        log ""
-        log "    https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/githubs-ssh-key-fingerprints"
-        log ""
-        log "       and proceed ONLY if the values match"
-        log ""
-        system("ssh -T git@github.com") # NOT system! because this may exit nonzero but still have succeeded
-        if $?.exitstatus == 255
-          log "SOMETHING MAY HAVE GONE WRONG!"
-        end
-        if known_hosts_dest.exist?
-          log "Copying #{known_hosts_dest} back to #{known_hosts_source} to use in the future"
-          FileUtils.cp known_hosts_dest,known_hosts_source
-        else
-          log "For some reason #{known_hosts_dest} was not created.  Future ssh commands may ask you to verify GitHub's fingerprint"
-        end
-      end
-    end
-    log "Your ssh key looks good"
-
-    gem_credentials_dest = Pathname("/") / "home" / "appuser" / ".gem" / "credentials"
-    if gem_credentials_dest.exist?
-      log "Gem credentials look good"
-    else
-      log "#{gem_credentials_dest} doesn't exist - creating"
-      FileUtils.mkdir_p gem_credentials_dest.dirname
-      gem_credentials_source = credentials_dir / "rubygems.credentials"
-      if gem_credentials_source.exist?
-        log "#{gem_credentials_source} exists - copying it to #{gem_credentials_dest}"
-        FileUtils.cp gem_credentials_source,gem_credentials_dest
-      else
-        log "#{gem_credentials_source} must contain a RubyGems credentials file"
-        log ""
-        log "Follow the instructions here:"
-        log ""
-        log "   https://guides.rubygems.org/api-key-scopes/#creating-from-gem-cli"
-        log ""
-        log "Then copy ~/.gem/credentials into #{gem_credentials_source} and re-run this script"
-        exit 1
-      end
-    end
-
-    npm_credentials_dest = Pathname("/") / "home" / "appuser" / ".npmrc"
-    if npm_credentials_dest.exist?
-      log "NPM credentials look good"
-    else
-      log "#{npm_credentials_dest} doesn't exist - creating"
-      FileUtils.mkdir_p npm_credentials_dest.dirname
-      npm_credentials_source = credentials_dir / "npmrc"
-      if npm_credentials_source.exist?
-        log "#{npm_credentials_source} exists - copying it to #{npm_credentials_dest}"
-        FileUtils.cp npm_credentials_source,npm_credentials_dest
-      else
-        log "#{npm_credentials_source} must contain an NPM credentials file"
-        log ""
-        log "If you don't have a ~/.npmrc file on your computer, create one:"
-        log "  1. On your computer (not inside Docker), run this:"
-        log ""
-        log "     npm adduser"
-        log ""
-        log "  2. Then follow the instructions.  When it's done ~/.npmrc will have been created"
-        log ""
-        log "Copy ~/.npmrc into #{npm_credentials_source} and re-run this script"
-        exit 1
-      end
-    end
-
-    docker_credentials_source = credentials_dir / "dockerhub.credentials"
-    docker_credentials_preamble = [
-      "# Username and PAT for Docker commands",
-      "# The file format is for bin/setup and bin/deploy",
-      "# to coordinate. This file format should be able to be",
-      "# sourced into a bash script via .",
-    ]
-    if !docker_credentials_source.exist?
-      log "#{docker_credentials_source} doesn't exist - creating"
-      File.open(docker_credentials_source,"w") do |file|
-        docker_credentials_preamble.each { |line| file.puts line }
-      end
-    end
-    existing_file = File.read(docker_credentials_source).split(/\n/).reject { 
-      it =~ /^\s*#/
-    }.map { |line|
-      line.split(/=/,2).map(&:strip)
-    }.to_h
-    changed = false
-    if !existing_file.key?("DOCKERHUB_USERNAME")
-      log "What is the username for DockerHub you will use to push mkbrut images?"
-      existing_file["DOCKERHUB_USERNAME"] = gets.chomp
-      changed = true
-    end
-    if !existing_file.key?("DOCKERHUB_PAT")
-      log "What is the Personal Access Token (PAT) for DockerHub you will use to push mkbrut images?"
-      existing_file["DOCKERHUB_PAT"] = gets.chomp
-      changed = true
-    end
-    if changed
-      File.open(docker_credentials_source,"w") do |file|
-        docker_credentials_preamble.each { |line| file.puts line }
-        existing_file.each do |key,value|
-          file.puts "#{key}=#{value}"
-        end
-      end
-    else
-      log "#{docker_credentials_source} exists and looks good"
-    end
-
-    log "Setting up BrutJS"
-    FileUtils.chdir project_root / "brut-js" do
-      system! "bin/setup"
-    end
-
-    log "Setting up BrutCSS"
-    FileUtils.chdir project_root / "brut-css" do
-      system! "bin/setup"
-    end
-
-    log "Setting up mkbrut"
-    FileUtils.chdir project_root / "mkbrut" do
-      system! "bin/setup"
-    end
-
-    log "Setting up brutrb.com"
-    FileUtils.chdir project_root / "brutrb.com" do
-      system! "bin/setup"
-    end
-
-  else
-    log "Not setting up GitHub or RubyGems credentials. You won't be able to push the gem"
-  end
-end
-
-
-options = {
-  update_gems: false,
-  setup_credentials: true,
-}
-OptionParser.new do |opts|
-  opts.on("--update-gems","Update gems get the latest versions consistent with Gemfile / gemspec.") do
-    options[:update_gems] = true
-  end
-  opts.on("--no-credentials","If set, no GitHub or RubyGems credentials are required, but you can't push gems") do
-    options[:setup_credentials] = false
-  end
-end.parse!
-
-setup(**options)

data/bin/test

@@ -1,18 +0,0 @@
-#!/usr/bin/env ruby
-
-require "optparse"
-require_relative "bin_kit"
-
-OptionParser.new do |opts|
-  opts.banner = "Usage: test [options]\n\n    Runs Brut tests only\n\nOPTIONS\n\n"
-
-  opts.on("-h", "--help", "Display this help message") do
-    puts opts
-    puts
-    exit
-  end
-end.parse!
-
-log "Running BrutRB tests"
-system!("bin/rspec -I specs --require spec_helper -P \"specs/**/*.spec.rb\"")
-

data/brut-css/.nvim.lua

@@ -1 +0,0 @@
-useLSP = true

data/brut-css/README.md

@@ -1,28 +0,0 @@
-# Brut CSS - A simple utility CSS library get you started
-
-This is a utility CSS library that provides single-purpose classes you can use together to prototpye and
-design directly in your HTML or HTML-generation code.  But it is minimal.
-
-It mostly exists to be included with BrutRB to allow developers to immediately start creating usable UI or
-HTML without having to install and setup something else.  It can also be the basis of a real CSS solution
-for a real app.
-
-## Install
-
-```
-npm install brut-css
-```
-
-Then, in your CSS
-
-```css
-@import "brut-css/dist/brut.css";
-```
-
-## Usage
-
-See [the docs](https://brutrb.com/brut-css).
-
-## Development
-
-This is done as part of the main Brut dev environment.