brut 0.5.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ddbdd2db5bb6ea9013486bc8ad279affec3d3a824d05ebbd8c4b4933a1c5468
-  data.tar.gz: 823232c021e8c3d5477bc5655fefe6b51c54efcfcc73ca2ad0cab535964a23f1
+  metadata.gz: 1b2e311013cbdc55775be537b348e78a8c94d12842bff7fcdc09973f88be7eb9
+  data.tar.gz: 648599f601bbf5fa34ed21f7223b4cf82dcf1f12f58b7b60bdf28d5d56c191b2
 SHA512:
-  metadata.gz: 152283ed984e5c7c8cd8faebdc5efbb24867efbe9a18a02a6896ab28654cc9b2b5fa39fe1ac9a13a6d477bd34ec3cb42a96034492d317f5355eb9e4434825395
-  data.tar.gz: 52b69e78ad33ceb908bb6617960a33022f36df621b5d9f3da327a167600cd0c9dbc1902d90d86ec0bdfbef400fa3fded9261b4980feb2dd4264d5c87afb7535f
+  metadata.gz: 913cb4f1328ce98454004702f7e8ded76fcc18d44e090b6b96a50840b54519dcc1cde3f3746d9a772c2e33da8554d8485c28ccc35fd65ca98c154b6693c4ac07
+  data.tar.gz: c4ae0693b14b42f3ba58b10b83f6e98f6e300ddeafd40f89028f42eb1b2c534857d69de5917ff7a4234380fb2123815242ac7a2c805f1939f2f1cee033fa2744

data/.gitignore

@@ -6,11 +6,17 @@
 # should never be checked in
 /dx/credentials
 
+# This is per-developer configuration, generated by dx/build
+/dx/build.args
+
 # Holds metadata during YARD builds. Don't need this checked in
 /.yardoc
 # Location of YARD templates, this is temporary
 /.yard
 
+# This is generated, so no need to check in
+/.rubocop.yml
+
 # This is where generated API docs go
 /brutrb.com/public/api
 /brutrb.com/public/brut-js/api
@@ -38,3 +44,10 @@
 
 # Gems are installed here for LSP convienience
 /local-gems
+
+# All I want in life is for every single instance of this file
+# to be placed in hell, and waiting for Alan Dye when he arrives.
+.DS_Store
+
+# Don't want tmp checked in, but want to dump stuff there for sure
+/tmp

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Brut CHANGELOG
 
+## v0.9.0 - Aug 7, 2025
+
+* Added `Brut::FrontEnd::CsrfProtector` and the `csrf_protector` configuration option to allow some customization
+  over how CSRF protection works app-wide, namely to allow a POST to a webhook to not have to have an authenticity token.
+  I don't super love this solution, but it's unblocking me for now.
+
+## v0.8.0 - July 23, 2025
+
+* Moved `mkbrut` into this repo
+* Fixed issue where generated `dx/build` script would mess up `build.args`. See https://github.com/thirdtank/brut/issues/45
+* Unify versioning for Brut, `mkbrut`, BrutJS, and BrutCSS
+* Unify all workspace workflow scripts (see README.md)
+* Minor doc updates to remove references to non-existent `form_tag`
+
 ## v0.5.0 - July 21, 2025
 
 * **New helper** `entity` for creating HTML entities without needing `raw(safe(...))`

data/Dockerfile.dx

@@ -4,6 +4,25 @@ SHELL [ "/bin/bash", "-o", "pipefail", "-c" ]
 
 ENV DEBIAN_FRONTEND=noninteractive
 
+# Install Docker itself. Note that this is installed only what is needed to run
+# the Docker CLI - the docker-compose.dx.yml will connect this docker's socket
+# to the one on the host. This is only to run stuff like docker build and docker push.
+# It's NOT intended to run docker containers inside this one.
+RUN install -m 0755 -d /etc/apt/keyrings && \
+    curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg && \
+    chmod a+r /etc/apt/keyrings/docker.gpg  && \
+    echo \
+      "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
+      "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
+      tee /etc/apt/sources.list.d/docker.list > /dev/null && \
+    apt-get update --quiet --yes && \
+    apt-get install --quiet --yes docker-ce \
+                       docker-ce-cli \
+                       containerd.io \
+                       docker-buildx-plugin \
+                       docker-compose-plugin
+
+
 # These packages are needed to set up other repos to install other
 # packages and/or are useful in installing other software
 RUN apt-get -y clean && \
@@ -25,12 +44,19 @@ RUN apt-get install -y vim && \
 ARG user_uid=10001
 # Their group id, which ideally matches their group id on the host
 ARG user_gid=10002
+# The group id that can access /var/run/docker.sock on the host.
+# If this isn't mapped properly, no docker-out-of-docker commands will work
+ARG docker_gid=10003
+# Can be set to ',0' in order to add the user to roo's group
+ARG sadly_user_must_be_added_to_root=
 
 # Create the user's group ID if it does not exist
 RUN getent group ${user_gid} || groupadd --gid ${user_gid} appgroup
+# Create the docker group id if it does not exist
+RUN getent group ${docker_gid} || groupadd --gid ${docker_gid} hostdocker
 # Create the user. Note that we put bash_customizations in both .profile and .bashrc
 # to increase the chances they are used when running bash in various configurations
-RUN useradd --uid ${user_uid} --gid ${user_gid} --create-home --home-dir /home/appuser appuser && \
+RUN useradd --uid ${user_uid} --gid ${user_gid} --groups ${sadly_user_must_be_added_to_root}${docker_gid} --create-home --home-dir /home/appuser appuser && \
     echo ". ~/.bash_customizations" >> /home/appuser/.profile && \
     echo ". ~/.bash_customizations.local" >> /home/appuser/.profile && \
     echo ". ~/.bash_customizations" >> /home/appuser/.bashrc && \

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    brut (0.5.0)
+    brut (0.9.0)
       concurrent-ruby
       i18n
       irb
@@ -36,6 +36,7 @@ GEM
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
       uri (>= 0.13.1)
+    ast (2.4.3)
     base64 (0.2.0)
     benchmark (0.4.0)
     bigdecimal (3.1.8)
@@ -76,6 +77,9 @@ GEM
       pp (>= 0.6.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
+    json (2.13.0)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
     logger (1.6.1)
     mini_portile2 (2.8.9)
     minitest (5.25.1)
@@ -114,6 +118,10 @@ GEM
     opentelemetry-semantic_conventions (1.10.1)
       opentelemetry-api (~> 1.0)
     ostruct (0.6.1)
+    parallel (1.27.0)
+    parser (3.3.8.0)
+      ast (~> 2.4.1)
+      racc
     phlex (2.2.1)
       zeitwerk (~> 2.7)
     pp (0.6.2)
@@ -132,10 +140,12 @@ GEM
       rack (>= 3.0.0)
     rackup (2.2.1)
       rack (>= 3)
+    rainbow (3.1.1)
     rake (13.2.1)
     rdiscount (2.2.7.3)
     rdoc (6.12.0)
       psych (>= 4.0.0)
+    regexp_parser (2.10.0)
     reline (0.6.0)
       io-console (~> 0.5)
     rspec (3.13.0)
@@ -151,6 +161,23 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.1)
+    rubocop (1.74.0)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.42.0)
+      parser (>= 3.3.7.2)
+    rubocop-disable_syntax (0.2.0)
+      lint_roller
+      rubocop (>= 1.72.0)
+    ruby-progressbar (1.13.0)
     ruby2_keywords (0.0.5)
     securerandom (0.3.2)
     semantic_logger (4.16.1)
@@ -169,6 +196,9 @@ GEM
       concurrent-ruby (~> 1.0)
     tzinfo-data (1.2024.2)
       tzinfo (>= 1.0.0)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
     uri (1.0.2)
     yard (0.9.37)
     zeitwerk (2.7.1)
@@ -192,6 +222,8 @@ DEPENDENCIES
   rdiscount
   rdoc
   rspec (~> 3.0)
+  rubocop
+  rubocop-disable_syntax
   yard
 
 BUNDLED WITH

data/README.md

@@ -69,3 +69,22 @@ with your editor, but all commands are run inside Docker, which should be more c
 
    The `--no-credentials` means that you will not be able to push to GitHub or RubyGems from within the Docker container. This ability is only needed by maintainers to push new versions of the gem. You can push to GitHub from your computer.
 
+### Conventions in MonoRepo
+
+This repo contains all five main parts of Brut:
+
+* BrutRB, the Ruby web framework (in this directory, code in `lib`)
+* BrutJS, the JS library with custom elements (in `brut-js/`)
+* BrutCSS, the CSS library (in `brut-css/`)
+* `mkbrut`, the CLI to create new Brut apps (in `mkbrut/`)
+* `brutrb.com`, the website, powered by VitePress (in `brutrb.com`)
+
+Each repo must conform to the *Workspace Protocol*, which are scripts in `bin/` that perform certain tasks:
+
+* `bin/setup` - performs any setup
+* `bin/docs` - builds all documentation, placing it where `brutrb.com` can find it.
+* `bin/build` - builds deployable artifacts, if needed
+* `bin/ci` - runs all tests, if applicable
+
+The primary `bin` scripts at the root work for both BrutRB, the web framework, and recurse into the other directories to perform their
+actions as well.

data/bin/build

@@ -0,0 +1,86 @@
+#!/usr/bin/env ruby
+
+require "optparse"
+require "pathname"
+require "fileutils"
+require "json"
+require_relative "bin_kit"
+
+def main
+
+  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
+
+  require_relative "../lib/brut/version"
+  require_relative "#{mkbrut_dir}/lib/mkbrut/version"
+
+  brut_js_package_json  = JSON.parse(File.read("#{brutjs_dir}/package.json"))
+  brut_css_package_json = JSON.parse(File.read("#{brutcss_dir}/package.json"))
+
+  brut_version     = Brut::VERSION.strip
+  brut_js_version  = brut_js_package_json["version"].strip
+  brut_css_version = brut_css_package_json["version"].strip
+  mkbrut_version   = MKBrut::VERSION.strip
+
+  if [ brut_version, brut_js_version, brut_css_version, mkbrut_version ].uniq.size != 1
+    log "Some versions are mismatched!  All versions should be the same to build and release"
+    puts
+    log sprintf("BrutRb:  %10s from lib/brut/version.rb", brut_version)
+    log sprintf("BrutJS:  %10s from brut-js/package.json", brut_js_version)
+    log sprintf("BrutCSS: %10s from brut-css/package.json", brut_css_version)
+    log sprintf("mkbrut:  %10s from mkbrut/lib/mkbrut/version.rb", mkbrut_version)
+    exit 1
+  else
+    log "Building v#{brut_version} of all artifacts"
+  end
+
+  log "Building brut gem"
+  system!("bin/rake build")
+
+  log "Building brut-js"
+  FileUtils.chdir brutjs_dir do
+    system!("bin/build")
+  end
+
+  log "Building brut-css"
+  FileUtils.chdir brutcss_dir do
+    system!("bin/build")
+  end
+
+  log "Building mkbrut"
+  FileUtils.chdir mkbrut_dir do
+    system!("bin/build")
+  end
+end
+
+options = {
+  repo_check: true,
+}
+OptionParser.new do |opts|
+  opts.banner = "Usage: build [options]\n\n    Builds deployable artifacts\n\nOPTIONS"
+
+  opts.on("-h", "--help", "Display this help message") do
+    puts opts
+    exit
+  end
+  opts.on("--skip-repo-check", "If set, allows you to proceed without a clean Git repo. Note that this may cause gems not to build properly") do
+    options[:repo_check] = false
+  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
+
+if options[:repo_check]
+  require_clean_repo!
+end
+main
+

data/bin/ci

@@ -0,0 +1,40 @@
+#!/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/docs

@@ -3,29 +3,41 @@
 require "optparse"
 require "pathname"
 require "fileutils"
+require_relative "bin_kit"
+
+options = {
+  dotcom: true,
+}
 
-options = {}
 OptionParser.new do |opts|
-  opts.banner = "Usage: docs [options]"
+  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("--[no-]dotcom", "Deploy (or not), brutrb.com to the docs/ directory (default #{options[:dotcom]})") do |value|
+    options[:dotcom] = value
+  end
 end.parse!
 
-public_dir = (Pathname(__FILE__).dirname / ".." / "brutrb.com" / "public" ).expand_path
-docs_dir   =  public_dir / "api"
-brutjs_dir = (Pathname(__FILE__).dirname / ".." / "brut-js" ).expand_path.to_s
+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}' -m markdown -M rdiscount --backtrace"
+system!(
+  "bundle exec yard doc -o '#{docs_dir}' --no-progress -m markdown -M rdiscount --backtrace",
 )
 
-puts "Hacking CSS"
+log "Hacking CSS"
+
 [
   docs_dir /  "css" / "style.css",
-  docs_dir /  "css" / "full_list.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|
@@ -44,6 +56,24 @@ puts "Hacking CSS"
   end
 end
 
+log "Generating brut-js docs"
 FileUtils.chdir brutjs_dir do
-  system("bin/build")
+  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

@@ -0,0 +1,52 @@
+#!/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/publish

@@ -0,0 +1,61 @@
+#!/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/rubocop

@@ -0,0 +1,27 @@
+#!/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

@@ -16,9 +16,15 @@ def setup(update_gems:,setup_credentials:)
     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"
 
@@ -164,6 +170,46 @@ def setup(update_gems:,setup_credentials:)
       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"
@@ -174,10 +220,16 @@ def setup(update_gems:,setup_credentials:)
       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

data/bin/test

@@ -0,0 +1,18 @@
+#!/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\"")
+