scratch-blocks 2.0.0-beta.1 → 2.0.0-spork.1

package/blockly-rc/package.json

@@ -1,149 +0,0 @@
-{
-  "name": "blockly",
-  "version": "12.0.0",
-  "description": "Blockly is a library for building visual programming editors.",
-  "keywords": [
-    "blockly"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/google/blockly.git"
-  },
-  "bugs": {
-    "url": "https://github.com/google/blockly/issues"
-  },
-  "homepage": "https://developers.google.com/blockly/",
-  "author": {
-    "name": "Neil Fraser"
-  },
-  "scripts": {
-    "build": "gulp build",
-    "build-debug": "gulp build --verbose --debug",
-    "build-debug-log": "npm run build:debug > build-debug.log 2>&1 && tail -3 build-debug.log",
-    "build-strict": "gulp build --verbose --strict",
-    "build-strict-log": "npm run build:strict > build-debug.log 2>&1 && tail -3 build-debug.log",
-    "clean": "gulp clean",
-    "deployDemos": "npm ci && gulp deployDemos",
-    "deployDemos:beta": "npm ci && gulp deployDemosBeta",
-    "docs": "gulp docs",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "messages": "gulp messages",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "langfiles": "gulp langfiles",
-    "minify": "gulp minify",
-    "package": "gulp package",
-    "postinstall": "patch-package",
-    "prepareDemos": "gulp prepareDemos",
-    "publish": "npm ci && gulp publish",
-    "publish:beta": "npm ci && gulp publishBeta",
-    "recompile": "gulp recompile",
-    "release": "gulp gitCreateRC",
-    "start": "npm run build && concurrently -n tsc,server \"tsc --watch --preserveWatchOutput --outDir \"build/src\" --declarationDir \"build/declarations\"\" \"http-server ./ -s -o /tests/playground.html -c-1\"",
-    "tsc": "gulp tsc",
-    "test": "gulp test",
-    "test:browser": "cd tests/browser && npx mocha",
-    "test:generators": "gulp testGenerators",
-    "test:mocha:interactive": "npm run build && concurrently -n tsc,server \"tsc --watch --preserveWatchOutput --outDir \"build/src\" --declarationDir \"build/declarations\"\" \"http-server ./ -o /tests/mocha/index.html -c-1\"",
-    "test:compile:advanced": "gulp buildAdvancedCompilationTest --debug",
-    "updateGithubPages": "npm ci && gulp gitUpdateGithubPages"
-  },
-  "exports": {
-    ".": {
-      "types": "./index.d.ts",
-      "import": "./index.mjs",
-      "umd": "./blockly.min.js",
-      "default": "./index.js"
-    },
-    "./core": {
-      "types": "./core.d.ts",
-      "node": "./core-node.js",
-      "import": "./blockly.mjs",
-      "default": "./blockly_compressed.js"
-    },
-    "./blocks": {
-      "types": "./blocks.d.ts",
-      "import": "./blocks.mjs",
-      "default": "./blocks_compressed.js"
-    },
-    "./dart": {
-      "types": "./dart.d.ts",
-      "import": "./dart.mjs",
-      "default": "./dart_compressed.js"
-    },
-    "./lua": {
-      "types": "./lua.d.ts",
-      "import": "./lua.mjs",
-      "default": "./lua_compressed.js"
-    },
-    "./javascript": {
-      "types": "./javascript.d.ts",
-      "import": "./javascript.mjs",
-      "default": "./javascript_compressed.js"
-    },
-    "./php": {
-      "types": "./php.d.ts",
-      "import": "./php.mjs",
-      "default": "./php_compressed.js"
-    },
-    "./python": {
-      "types": "./python.d.ts",
-      "import": "./python.mjs",
-      "default": "./python_compressed.js"
-    },
-    "./msg/*": {
-      "types": "./msg/*.d.ts",
-      "import": "./msg/*.mjs",
-      "default": "./msg/*.js"
-    }
-  },
-  "license": "Apache-2.0",
-  "devDependencies": {
-    "@blockly/block-test": "^6.0.4",
-    "@blockly/dev-tools": "^8.0.4",
-    "@blockly/theme-modern": "^6.0.3",
-    "@hyperjump/json-schema": "^1.5.0",
-    "@microsoft/api-documenter": "^7.22.4",
-    "@microsoft/api-extractor": "^7.29.5",
-    "@typescript-eslint/eslint-plugin": "^7.3.1",
-    "@typescript-eslint/parser": "^7.16.1",
-    "async-done": "^2.0.0",
-    "chai": "^5.1.1",
-    "concurrently": "^8.0.1",
-    "eslint": "^8.4.1",
-    "eslint-config-google": "^0.14.0",
-    "eslint-config-prettier": "^9.0.0",
-    "eslint-plugin-jsdoc": "^48.0.2",
-    "glob": "^10.3.4",
-    "google-closure-compiler": "^20240317.0.0",
-    "gulp": "^4.0.2",
-    "gulp-concat": "^2.6.1",
-    "gulp-gzip": "^1.4.2",
-    "gulp-header": "^2.0.9",
-    "gulp-insert": "^0.5.0",
-    "gulp-rename": "^2.0.0",
-    "gulp-replace": "^1.0.0",
-    "gulp-series": "^1.0.2",
-    "gulp-shell": "^0.8.0",
-    "gulp-sourcemaps": "^3.0.0",
-    "gulp-umd": "^2.0.0",
-    "http-server": "^14.0.0",
-    "json5": "^2.2.0",
-    "markdown-tables-to-json": "^0.1.7",
-    "mocha": "^10.0.0",
-    "patch-package": "^8.0.0",
-    "prettier": "3.3.2",
-    "readline-sync": "^1.4.10",
-    "rimraf": "^5.0.0",
-    "typescript": "^5.3.3",
-    "webdriverio": "^8.32.2",
-    "yargs": "^17.2.1"
-  },
-  "dependencies": {
-    "jsdom": "24.1.0"
-  },
-  "engines": {
-    "node": ">=18"
-  }
-}

package/blockly-rc/patches/@microsoft+api-documenter+7.22.4.patch

@@ -1,81 +0,0 @@
-diff --git a/node_modules/@microsoft/api-documenter/lib/documenters/MarkdownDocumenter.js b/node_modules/@microsoft/api-documenter/lib/documenters/MarkdownDocumenter.js
-index 5284d10..f2f9d14 100644
---- a/node_modules/@microsoft/api-documenter/lib/documenters/MarkdownDocumenter.js
-+++ b/node_modules/@microsoft/api-documenter/lib/documenters/MarkdownDocumenter.js
-@@ -877,12 +877,15 @@ class MarkdownDocumenter {
-     }
-     _writeBreadcrumb(output, apiItem) {
-         const configuration = this._tsdocConfiguration;
--        output.appendNodeInParagraph(new tsdoc_1.DocLinkTag({
--            configuration,
--            tagName: '@link',
--            linkText: 'Home',
--            urlDestination: this._getLinkFilenameForApiItem(this._apiModel)
--        }));
-+        // Don't print the first breadcrumb, because there's only one package, so we don't need the Home link.
-+        // output.appendNodeInParagraph(new tsdoc_1.DocLinkTag({
-+        //     configuration,
-+        //     tagName: '@link',
-+        //     linkText: 'Home',
-+        //     urlDestination: this._getLinkFilenameForApiItem(this._apiModel)
-+        // }));
-+
-+        let first = true;
-         for (const hierarchyItem of apiItem.getHierarchy()) {
-             switch (hierarchyItem.kind) {
-                 case api_extractor_model_1.ApiItemKind.Model:
-@@ -892,18 +895,24 @@ class MarkdownDocumenter {
-                     // this may change in the future.
-                     break;
-                 default:
--                    output.appendNodesInParagraph([
--                        new tsdoc_1.DocPlainText({
--                            configuration,
--                            text: ' > '
--                        }),
-+                    if (!first) {
-+                        // Only print the breadcrumb separator if it's not the first item we're printing.
-+                        output.appendNodeInParagraph(
-+                            new tsdoc_1.DocPlainText({
-+                                configuration,
-+                                text: ' > '
-+                            })
-+                        );
-+                    }
-+                    first = false;
-+                    output.appendNodeInParagraph(
-                         new tsdoc_1.DocLinkTag({
-                             configuration,
-                             tagName: '@link',
-                             linkText: hierarchyItem.displayName,
-                             urlDestination: this._getLinkFilenameForApiItem(hierarchyItem)
-                         })
--                    ]);
-+                    );
-             }
-         }
-     }
-@@ -968,11 +977,8 @@ class MarkdownDocumenter {
-             // For overloaded methods, add a suffix such as "MyClass.myMethod_2".
-             let qualifiedName = Utilities_1.Utilities.getSafeFilenameForName(hierarchyItem.displayName);
-             if (api_extractor_model_1.ApiParameterListMixin.isBaseClassOf(hierarchyItem)) {
--                if (hierarchyItem.overloadIndex > 1) {
--                    // Subtract one for compatibility with earlier releases of API Documenter.
--                    // (This will get revamped when we fix GitHub issue #1308)
--                    qualifiedName += `_${hierarchyItem.overloadIndex - 1}`;
--                }
-+                // https://github.com/microsoft/rushstack/issues/1921
-+                qualifiedName += `_${hierarchyItem.overloadIndex}`;
-             }
-             switch (hierarchyItem.kind) {
-                 case api_extractor_model_1.ApiItemKind.Model:
-@@ -983,7 +989,8 @@ class MarkdownDocumenter {
-                     baseName = Utilities_1.Utilities.getSafeFilenameForName(node_core_library_1.PackageName.getUnscopedName(hierarchyItem.displayName));
-                     break;
-                 default:
--                    baseName += '.' + qualifiedName;
-+                    // https://github.com/microsoft/rushstack/issues/1921
-+                    baseName += '.' + qualifiedName + '_' + hierarchyItem.kind.toLowerCase();
-             }
-         }
-         return baseName + '.md';

package/blockly-rc/scripts/goog_module/convert-file.sh

@@ -1,406 +0,0 @@
-#!/bin/bash
-
-# This file makes extensive use of perl for the purpose of extracting and
-# replacing string (regex) patterns in a way that is both GNU and macOS
-# compatible.
-#
-# Common perl flags used (also described at https://perldoc.perl.org/perlrun):
-#   -e : Used to execute perl programs on the command line
-#   -p : Assumes an input loop around script. Prints every processed line.
-#   -n : Assumes an input loop around script. Does not print every line.
-#   -i : Used for in-place editing. Used in commands for find/replace.
-#   -l[octnum] : Assigns the output record separator "$/" as an octal number. If
-#        octnum is not present, sets output record separator to the current
-#        value of the input record separator "$\".
-#
-# Common perl commands found:
-# 1.  perl -pi -e 's/regex/replacement/modifiers'
-#   This command does an in-place search-and-replace. The global ("/g") modifier
-#   causes it to replace all occurrences, rather than only the first match.
-# 2.  perl -ne 'print m/regex/modifiers'
-#   This command returns a string containing the regex match (designated by the
-#   capture group "()" in the regex). This will return the first match, unless
-#   the global modifier is specified, in which case, it will return all matches.
-#   If this command is used without a capture group it returns true or false (in
-#   the form a truthy or falsy value).
-# 3.  perl -nle 'print $& while m{regex}modifiers'
-#   Similar to (2), but returns regex matches separated by newlines.
-#   The "m{regex}modifiers" is equivalent to "m/regex/modifiers" syntax.
-#
-# Additional information on regex:
-# This script makes use of some advanced regex syntax such as "capture groups"
-# and "lookaround assertions".
-# Additionally, characters are escaped from regex with a backslash "\".
-# Single quotes need to be escaped in both regex and the string, resulting in
-# '\'' being used to represent a single quote character.
-# For a reference to syntax of regular expressions in Perl, see:
-# https://perldoc.perl.org/perlre
-
-#######################################
-# Logging functions.
-#######################################
-COLOR_NONE="\033[0m"
-GREEN="\033[0;32m"
-BLUE="\033[0;34m"
-ORANGE="\033[0;33m"
-RED="\033[0;31m"
-success() {
-  echo -e  "${GREEN}[SUCCESS]:${COLOR_NONE} $*" >&2
-}
-inf() {
-  echo -e  "${BLUE}[INFO]:${COLOR_NONE} $*" >&2
-}
-warn() {
-  echo -e  "${ORANGE}[WARN]:${COLOR_NONE} $*" >&2
-}
-err() {
-  echo -e  "${RED}[ERROR]:${COLOR_NONE} $*" >&2
-}
-reenter_instructions() {
-  echo -e  "${ORANGE}$*${COLOR_NONE}" >&2
-}
-
-#######################################
-# Checks whether the provided filepath exists.
-# Arguments:
-#   The filepath to check for existence.
-#   Optional: Whether to log an error.
-#######################################
-verify-filepath() {
-  local filepath="$1"
-  local no_log="$2"
-  if [[ ! -f "${filepath}" ]]; then
-    if [[ -z "${no_log}" || "${no_log}" == 'true' ]]; then
-      err "File ${filepath} does not exist"
-    fi
-    return 1
-  fi
-}
-
-#######################################
-# Creates a commit with a message based on the specified step and file.
-# Arguments:
-#   Which conversion step this message is for.
-#   The filepath of the file being converted.
-#######################################
-commit-step() {
-  local step="$1"
-  local filepath="$2"
-  if [[ -z "${step}" ]]; then
-    err "Missing argument (1-4)"
-    return 1
-  fi
-  if [[ -z "${filepath}" ]]; then
-    err "Missing argument filepath"
-    return 1
-  fi
-  verify-filepath "${filepath}"
-  if [[ $? -eq 1 ]]; then return 1; fi
-
-  local message=''
-  case $1 in
-    1)
-      message="Migrate ${filepath} to ES6 const/let"
-      ;;
-    2)
-      message="Migrate ${filepath} to goog.module"
-      ;;
-    3)
-      message="Migrate ${filepath} named requires"
-      ;;
-    4)
-      message="clang-format ${filepath}"
-      ;;
-    *)
-      err 'INVALID ARGUMENT'
-      return 1
-      ;;
-  esac
-  git add .
-  if [[ -z $(git status --porcelain) ]]; then
-    success "Nothing to commit"
-    return 0
-  fi
-  git commit -m "${message}"
-  success "created commit with message: \"${message}\""
-}
-
-#######################################
-# Extracts a list of properties that are accessed on the specified module name.
-# Excludes any matches
-# Arguments:
-#   The module name to find properties accessed for.
-#   The modules required by the specified module as a single string.
-#   The filepath to extract requires from.
-#   Optional: The top-level module.
-# Outputs:
-#   Writes list of properties to stdout as items separated by spaces.
-#######################################
-getPropertiesAccessed() {
-  local module_name="$1"
-  local requires="$2"
-  local filepath="$3"
-  local top_module_name="$4"
-  # Get any strings that follow "$module_name.", excluding matches for
-  # "$module_name.prototype" and remove list item duplicates (sort -u).
-  local properties_accessed=$(perl -nle 'print $& while m{(?<='"${module_name}"'\.)(?!prototype)\w+}g' "${filepath}" | sort -u)
-
-  # Get a list of any requires that are a child of $module_name.
-  # Ex: Blockly.utils.dom is a child of Blockly.utils, this would return "dom"
-  local requires_overlap=$(echo "${requires}" | perl -nle 'print $& while m{(?<='"${module_name}"'\.)\w+}g')
-  # Detect if there was any overlap.
-  if [[ -n "${requires_overlap}" ]]; then
-    while read -r requires_overlap_prop; do
-      # Removes any instances of $requires_overlap_prop. Includes regex
-      # lookarounds so that it does not simply match string contains.
-      # Ex: if $requires_overlap is "Svg", then it would update the list
-      # "isTargetInput mouseToSvg noEvent Svg" to
-      # "isTargetInput mouseToSvg noEvent " (note that mouseToSvg is unchanged).
-      properties_accessed=$(echo "${properties_accessed}" | perl -pe 's/(?<!\w)'"${requires_overlap_prop}"'(?!\w)//g')
-    done <<<"${requires_overlap}"
-  fi
-
-  # Fix formatting (remove extra whitespace) and delimit the list with spaces.
-  properties_accessed=$(echo "${properties_accessed}" | perl -pe 's/\s+/ /g' | xargs)
-
-  echo "${properties_accessed}"
-}
-
-#######################################
-# Extracts a list of requires defined in the file in the form of a single string
-# of items separated by newlines.
-# Arguments:
-#   The filepath to extract requires from.
-# Outputs:
-#   Writes list of requires to stdout as items separated by newlines.
-#######################################
-getRequires() {
-  local filepath="$1"
-  # Extracts all strings that start with goog.require(' or goog.requireType('
-  # up until the ending single quote.
-  # Ex: "goog.require('Blockly.utils')" would extract "Blockly.utils"
-  local requires=$(perl -nle 'print $& while m{(?:(?<=^goog.require\('\'')|(?<=^goog.requireType\('\''))[^'\'']+}g' "${filepath}")
-  echo "${requires}"
-}
-
-#######################################
-# Runs step 2 of the automated conversion.
-# Arguments:
-#   The filepath of the file being converted.
-#######################################
-step2 () {
-  local filepath="$1"
-
-  inf "Updating goog.provide declaration..."
-  perl -pi -e 's/^goog\.provide(\([^\)]+\)\;)/goog\.module\1\ngoog.module.declareLegacyNamespace\(\)\;/' "${filepath}"
-
-  inf "Extracting module name..."
-  local module_name=$(perl -ne 'print m/(?<=^goog\.module\('\'')([^'\'']+)/' "${filepath}")
-  if [[ -z "${module_name}" ]]; then
-    err "Could not extract module name"
-    return 1
-  fi
-  inf "Extracted module name \"${module_name}\""
-
-  if [[ $(grep "${module_name} = " "${filepath}") ]]; then
-    local class_name=$(echo "${module_name}" | perl -ne 'print m/(\w+)$/')
-    inf "Found class \"${class_name}\" in file."
-    inf "Updating class declaration..."
-    perl -pi -e 's/^('"${module_name}"') =/const '"${class_name}"' =/g' "${filepath}"
-
-    inf "Updating local references to class..."
-    perl -pi -e 's/'"${module_name}"'(?!['\''\w])/'"${class_name}"'/g' "${filepath}"
-
-    inf "Appending class export to end of file..."
-    echo "" >> "${filepath}"
-    echo "exports = ${class_name};" >> "${filepath}"
-
-    npm run build:deps
-
-    success "Completed automated conversion to goog.module. Please manually review before committing."
-    return 0
-  fi
-
-  # No top level class.
-  inf 'Updating top-level property declarations...'
-  perl -pi -e 's/^'"${module_name}"'\.([^ ]+) =/const \1 =/g' "${filepath}"
-
-  # Extract specific properties accessed so that properties from requires that
-  # are children of the module aren't changed.
-  # Ex: The module Blockly.utils shouldn't update Blockly.utils.dom (since it is
-  # a require from another module.
-  local requires=$(getRequires "${filepath}")
-  local properties_accessed=$(getPropertiesAccessed "${module_name}" "${requires}" "${filepath}")
-  inf "Updating local references to module..."
-  for property in $(echo "${properties_accessed}"); do
-    inf "Updating references of ${module_name}.${property} to ${property}..."
-    perl -pi -e 's/'"${module_name}"'\.'"${property}"'(?!\w)/'"${property}"'/g' "${filepath}"
-  done
-
-  npm run build:deps
-  success "Completed automation for step 2. Please manually review and add exports for non-private top-level functions."
-}
-
-#######################################
-# Runs step 3 of the automated conversion.
-# Arguments:
-#   The filepath of the file being converted.
-#######################################
-step3() {
-  inf "Extracting module name..."
-  local module_name=$(perl -ne 'print m/(?<=^goog\.module\('\'')([^'\'']+)/' "${filepath}")
-  if [[ -z "${module_name}" ]]; then
-    err "Could not extract module name"
-    return 1
-  fi
-  inf "Extracted module name \"${module_name}\""
-
-  local requires=$(getRequires "${filepath}")
-
-  # Process each require
-  echo "${requires}" | while read -r require; do
-    inf "Processing require \"${require}\""
-    local usages=$(perl -nle 'print $& while m{'"${require}"'(?!'\'')}g' "${filepath}" | wc -l)
-
-    if [[ "${usages}" -eq "0" ]]; then
-      warn "Unused require \"${require}\""
-      continue
-    fi
-
-    local require_name=$(echo "${require}" | perl -pe 's/(\w+\.)+(\w+)/\2/g')
-    inf "Updating require declaration for ${require}..."
-    perl -pi -e 's/^(goog\.(require|requireType)\('\'"${require}"\''\);)/const '"${require_name}"' = \1/' "${filepath}"
-
-    # Parse property access of module
-    local direct_access_count=$(perl -nle 'print $& while m{'"${require}"'[^\.'\'']}g' "${filepath}" | wc -l)
-    local properties_accessed=$(getPropertiesAccessed "${require}" "${requires}" "${filepath}")
-
-    # Remove $module_name in case it is a child of $require.
-    # Ex: Blockly.utils.dom would be a child of Blockly, module_overlap would be
-    # "utils"
-    local module_overlap=$(echo "${module_name}" | perl -nle 'print $& while m{(?<='"${require}"'\.)\w+}g')
-    if [[ -n "${module_overlap}" ]]; then
-      properties_accessed=$(echo "${properties_accessed}" | perl -pe 's/'"${module_overlap}"'//g')
-      # Trim any extra whitespace created.
-      properties_accessed=$(echo "${properties_accessed}" | xargs)
-    fi
-
-    if [[ -n "${properties_accessed}" ]]; then
-      local comma_properties=$(echo "${properties_accessed}" | perl -pe 's/\s+/, /g' | perl -pe 's/, $//')
-      inf "Detected references of ${require}: ${comma_properties}"
-
-      for require_prop in $(echo "${properties_accessed}"); do
-        inf "Updating references of ${require}.${require_prop} to ${require_name}.${require_prop}..."
-        perl -pi -e 's/'"${require}"'\.'"${require_prop}"'(?!\w)/'"${require_name}"'\.'"${require_prop}"'/g' "${filepath}"
-      done
-    fi
-
-    inf "Updating direct references of ${require} to ${require_name}..."
-    perl -pi -e 's/'"${require}"'(?!['\''\w\.])/'"${require_name}"'/g' "${filepath}"
-  done
-
-  local missing_requires=$(perl -nle'print $& while m{(?<!'\'')Blockly(\.\w+)+}g' "${filepath}")
-  missing_requires=$(echo "${missing_requires}" | tr ' ' '\n' | sort -u)
-  if [[ -n "${missing_requires}" ]]; then
-    # Search for the string goog.require('Blockly') or goog.requireType('Blockly')
-    local has_blockly_require=$(perl -ne 'print m/goog\.(?:require|requireType)\('\''Blockly'\''\)/' "${filepath}")
-    if [[ -n "${has_blockly_require}" ]]; then
-      warn 'Blockly detected as a require.'
-      warn "Potentially missing requires for:\n${missing_requires}\nPlease manually review."
-    else
-      err "Missing requires for:\n${missing_requires}\nPlease manually fix."
-    fi
-  fi
-
-  success "Completed automation for step 3. Please manually review and reorder requires."
-}
-
-#######################################
-# Runs step 4 of the automated conversion.
-# Arguments:
-#   The filepath of the file being converted.
-#######################################
-step4() {
-  inf "Running clang-format"
-  npx clang-format -i "${filepath}"
-}
-
-#######################################
-# Runs the specified step.
-# Arguments:
-#   Which step to run.
-#   The filepath of the file being converted.
-#######################################
-run-step() {
-  local step="$1"
-  local filepath="$2"
-  if [[ -z "${step}" ]]; then
-    err "Missing argument (1-4)"
-    return 1
-  fi
-  if [[ -z "${filepath}" ]]; then
-    err "Missing argument filepath"
-    return 1
-  fi
-  verify-filepath "${filepath}"
-  if [[ $? -eq 1 ]]; then return 1; fi
-
-  case "${step}" in
-    2)
-      step2 "${filepath}"
-      ;;
-    3)
-      step3 "${filepath}"
-      ;;
-    4)
-      step4 "${filepath}"
-      ;;
-    *)
-      err "INVALID ARGUMENT ${step}"
-      return 1
-      ;;
-  esac
-}
-
-#######################################
-# Prints usage information.
-#######################################
-help() {
-  echo "Conversion steps:"
-  echo " 1. Use IDE to convert var to let/const"
-  echo " 2. Rewrite the goog.provide statement as goog.module and explicitly enumerate exports"
-  echo " 3. Rewrite goog.requires statements and add missing requires (often skipped for simple files)"
-  echo " 4. Run clang-format on the whole file"
-  echo ""
-  echo "Usage: $0 [-h] [-c <step> <filepath>|-s <step> <filepath>]"
-  echo "  -h                    Display help and exit"
-  echo "  -c <step> <filepath>  Create a commit for the specified step [1-4]"
-  echo "  -s <step> <filepath>  Run the specified step [2-4]"
-}
-
-#######################################
-# Main entry point.
-#######################################
-main() {
-  if [ "$1" = "" ]; then
-    help
-  else
-    local filepath=""
-    # Support filepath as first argument.
-    verify-filepath "$1" "false"
-    if [[ $? -eq 0 ]]; then
-      filepath="$1"
-      shift
-    fi
-
-    local command="$1"
-    shift
-    case $command in
-      -c) commit-step "$@" "${filepath}" ;;
-      -s) run-step "$@" "${filepath}" ;;
-      *) err "INVALID ARGUMENT ${command}";;
-    esac
-  fi
-}
-
-main "$@"