@addepar/ember-toolbox

Shared styles and helper for ICE components

Usage no npm install needed!

<script type="module">
  import addeparEmberToolbox from 'https://cdn.skypack.dev/@addepar/ember-toolbox';
</script>

README

Build Status

@addepar/ember-toolbox

Addepar Ember Toolbox provides a number of commands for linting and ensuring consistent style of Ember projects.

  • ember adde-lint --javascript --sass --file-names: Runs our linting checks against the specified files. If no files are specified, runs them against the entire repo. Using adde-lint to line filenames is deprecated, use adde-lint-file-names instead.
  • ember adde-format: Formats the files specified, or if none are specified formats the entire repo.
  • ember adde-pre-commit: Deprecated, use adde-pre-commit bin script instead.
  • adde-pre-commit: bin script that Runs our formatting and linting checks against staged changes
  • adde-lint-file-names: bin script provided by this package that lints the passed (via command line) filepaths

Installing this addon will also add styleguides as dependencies, set up a pre-commit hook to format/lint changed files before commits using Husky, and automatically format the repo its installed in.

Installation

ember install @addepar/ember-toolbox

Running

Running Tests

  • npm test (Runs ember try:each to test your addon against multiple Ember versions)
  • ember test
  • ember test --server

Building

  • ember build

For more information on using ember-cli, visit https://ember-cli.com/.

Linting File Names

adde-lint-file-names lints the file names that are passed on the command line. File names must be passed as absolute paths.

The file name linting:

  • first strips off the process.cwd(), which is assumed to be the ember app root directory
  • excludes files that are not in typical Ember-app directory-layout spots (see below)
  • Checks each remaining filepath against a regex

Lint Filename Regex

See the lib/lint-file-names.js file for full details. The rules regarding filename linting are:

  • directories must start with lowercase alphanumeric (with optional starting "@"),
  • filenames must start with either lowercase alphanumeric or "_","-" or "."
  • filenames cannot include "_" except for the first character
Bad examples:
_badDir/xyz.js (dir doesn't start with alphanumeric)
BadDir/xyz.js (dir starts with capital)
okDir/Bad.js (file starts with capital)
okDir/Bad.js (file starts with capital)
okDir/bad_file.js (file includes _ after first character)
Good examples:
ok/.file.js
ok/-file.js
ok/ok-file.js
ok/\_file.js
ok/file.js
@ok/file.js

To try the regex interactively, visit https://regexr.com/5tn2c.