PolymerLabs/webmat

Name: webmat

Owner: PolymerLabs

Description: Web + format = webmat

Created: 2018-04-06 05:19:17.0

Updated: 2018-04-18 21:14:34.0

Pushed: 2018-04-10 00:36:32.0

Homepage: null

Size: 69

Language: TypeScript

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

?? webmat ??

web + format = webmat. It formats your web projects!

?? Warning: Still under early development ??

Webmat is still under development and you may run into issues. Issues may range from a lot of memory usage to ruining your project. Use at your own risk for now.

? Highlights

webmat is a formatter will run mulitple files in your project through a formatter (currently only clang-format). It will gather all the js, ts, and html files and format them in place. The trick of this pony is that it will format your HTML files by gathering their script tags, formatting them, and replacing only your script tags without touching the rest of your DOM.

Usage

Install webmat from npm:

install -g webmat
Simple usage

webmat will select files to format based off of a default set of globs defined in default_config.json. If those defaults are fine, then you can simply run:

at
File Selection

If you would like to include or exclude files not included by the default config, then you can specify a set of globs in a formatconfig.json file in the directory that you are running webmat. An example:


nclude": [ "protos/*.proto", "wasm/**/*.cpp" ],
xclude": [ "generated_files/**/*", "formatter-mangles-my-code.html" ]

webmat will simply append your custom config to the default config and then select files using fast-glob's set of selection rules. fast-glob's reading algorithm will run the excludes first, so if you want to format a file that is in the default config's exclude list, then you will have to add the ignoreDefaultGlobs flag to completely ignore the default include / exclude configurations.

API

I haven't totally made this user friendly yet, please come back later!

Options

There are currently no command-line flags only formatconfig.json.

formatconfig.json

Types:


clude: string[],
clude: string[],
noreDefaultGlobs: boolean

Descriptions:

| property | description | | ——– | ———– | | include | List of globs to include in format selection | | exclude | List of globs to exclude from format selection | | ignoreDefaultGlobs | Completely ignores default include / exclude globs |


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.