', texts.argPattern)\n .option('-c --coverage', texts.argCoverage)\n .option('-w --watch', texts.argWatch)\n .parse(process.argv);\n\nconst {pattern, watch} = program.opts();\nconst rootSuite = path.resolve(process.cwd(),\n 'node_modules', pkg.name, 'cli', 'rootsuite.js');\n\nconst proc = exec([\n\n // use nyc && mocha\n 'nyc mocha',\n\n // where to look for tests\n pattern ? pattern : './test/**/*.js',\n\n // setup test environment\n util.format('--file \"%s\"', rootSuite),\n\n // enable watch\n watch ? '--watch' : '',\n\n // babel\n '--require @babel/register',\n\n // output colors\n '--colors'\n\n].join(' '));\n\nproc.stdout.on('data', data => {\n process.stdout.write(data.toString());\n});\n\nproc.stderr.on('data', data => {\n process.stdout.write(data.toString());\n});\n\n// exit parent process with the unit test result code\nproc.on('exit', process.exit);\n"
},
{
"path": "config/actions.yml",
"content": "name: Build\n\non:\n push:\n branches: [ main ]\n\n## to run workflow on pull requests:\n#on:\n# pull_request:\n# branches: [ main ]\n\n## to run workflow on tagged commits\n#on:\n# push:\n# tags:\n# - '*'\n\n## to run workflow on schedule, e.g. nightly build\n#on:\n# schedule:\n# - cron: '0 0 * * *'\n\njobs:\n build:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v2\n\n # see https://github.com/marketplace/actions/setup-node-js-environment\n - uses: actions/setup-node@v2\n with:\n node-version: '14'\n\n # see https://github.com/marketplace/actions/cache\n - name: Cache dependecies\n uses: actions/cache@v2\n with:\n path: '**/node_modules'\n key: ${{ runner.os }}-modules-${{ hashFiles('**/package-lock.json') }}\n\n - name: Install dependencies\n run: npm install\n\n - name: Unit test\n run: npm run test\n\n - name: Build docs\n run: npm run docs\n\n - name: Build extension .zip file\n run: npm run build\n\n## Uncomment to deploy docs to GH pages\n## see: https://github.com/marketplace/actions/deploy-to-github-pages\n# - name: Deploy docs\n# uses: JamesIves/github-pages-deploy-action@4.1.3\n# with:\n# branch: gh-pages\n# folder: public/documentation\n\n## Uncomment to upload generated zip file to web store\n## see: https://github.com/MobileFirstLLC/cws-publish\n# - name: Upload to Chrome Web Store\n# run: >-\n# npx cws-upload\n# ${{ secrets.CLIENT }}\n# ${{ secrets.SECRET }}\n# ${{ secrets.TOKEN }}\n# \"release.zip\"\n# ${{ EXTENSION_ID }};\n\n## Uncomment to make a Github release\n## see: https://github.com/marketplace/actions/create-release\n# - uses: ncipollo/release-action@v1\n# with:\n# artifacts: \"release.zip\"\n# token: ${{ secrets.GITHUB_TOKEN }}\n"
},
{
"path": "config/build.json",
"content": "{\n \"dist\": \"./dist\",\n \"source\": \"./src\",\n \"releases\": \"./\",\n \"release_name\": \"release\",\n \"manifest\": \"./src/manifest.json\",\n \"js\": \"./src/**/*.js\",\n \"js_bundles\": [{\n \"src\":\"./src/**/*.js\",\n \"name\": \"script\"\n }],\n \"html\": \"./src/**/*.html\",\n \"scss\": \"./src/**/*.scss\",\n \"scss_bundles\": [{\n \"src\":\"./src/**/*.scss\",\n \"name\": \"styles\"\n }],\n \"assets\": [\n \"./assets/**/*\",\n \"!./assets/locales\",\n \"!./assets/locales/**/*\"\n ],\n \"copyAsIs\": [],\n \"locales_dir\": \"./assets/locales/\",\n \"locales_list\": [\n \"en\"\n ],\n \"commands\": null,\n \"commands_watch_path\": null\n}\n"
},
{
"path": "config/docs.json",
"content": "{\n \"tags\": {\n \"allowUnknownTags\": true,\n \"dictionaries\": [\n \"jsdoc\"\n ]\n },\n \"source\": {\n \"include\": [\n \"src\"\n ],\n \"includePattern\": \".js$\",\n \"excludePattern\": \"(node_modules/)\"\n },\n \"plugins\": [\n \"plugins/markdown\"\n ],\n \"templates\": {\n \"default\": {\n \"cleverLinks\": true,\n \"monospaceLinks\": false\n }\n },\n \"opts\": {\n \"destination\": \"./public/documentation\",\n \"encoding\": \"utf8\",\n \"private\": true,\n \"recurse\": true,\n \"template\": \"templates/default\"\n }\n}\n"
},
{
"path": "config/gitlab.yml",
"content": "image: node:latest\n\nstages:\n - install\n - pages\n - test\n - publish\n\ncache:\n key: ${CI_COMMIT_REF_SLUG}\n paths:\n - node_modules/\n\ninstall_dependencies:\n stage: install\n script: npm install\n artifacts:\n paths:\n - node_modules/\n\npages:\n stage: pages\n script:\n - npm run docs\n artifacts:\n paths:\n - public/\n only:\n - master\n\ntest:\n stage: test\n script:\n - npm run test\n\nstore_publish:\n stage: publish\n script:\n - npm run build\n ## see: https://github.com/MobileFirstLLC/cws-publish\n # - npx cws-upload $client_id $secret $token $zip_path $extension_id;\n artifacts:\n paths:\n - $zip\n only:\n - tags\n"
},
{
"path": "config/ignore",
"content": ".idea/\n.vscode/\nnode_modules/\n.nyc_output/\ncoverage/\ndist/\npublic/documentation/\nrelease.zip\nyarn-error.log\n"
},
{
"path": "config/init/background.js",
"content": "console.log('This is background service worker - edit me!');\n"
},
{
"path": "config/init/eslint.json",
"content": "{\n \"env\": {\n \"browser\": true,\n \"es2021\": true,\n \"node\": true\n },\n \"extends\": [\n \"eslint:recommended\"\n ],\n \"globals\": {\n \"document\": false,\n \"escape\": false,\n \"navigator\": false,\n \"unescape\": false,\n \"window\": false,\n \"describe\": true,\n \"before\": true,\n \"it\": true,\n \"expect\": true,\n \"sinon\": true,\n \"chrome\": true\n },\n \"plugins\": [],\n \"parserOptions\": {\n \"ecmaVersion\": 2020,\n \"sourceType\": \"module\"\n },\n \"rules\": {\n }\n}\n"
},
{
"path": "config/init/intro.md",
"content": "# ${name}\n\n${description}\n\n## Development \n\nThis extension was created with [Extension CLI](https://oss.mobilefirst.me/extension-cli/)!\n\nIf you find this software helpful [star](https://github.com/MobileFirstLLC/extension-cli/) or [sponsor](https://github.com/sponsors/MobileFirstLLC) this project.\n\n\n### Available Commands\n\n| Commands | Description |\n| --- | --- |\n| `npm run start` | build extension, watch file changes |\n| `npm run build` | generate release version |\n| `npm run docs` | generate source code docs |\n| `npm run clean` | remove temporary files |\n| `npm run test` | run unit tests |\n| `npm run sync` | update config files |\n\nFor CLI instructions see [User Guide →](https://oss.mobilefirst.me/extension-cli/)\n\n### Learn More\n\n**Extension Developer guides**\n\n- [Getting started with extension development](https://developer.chrome.com/extensions/getstarted)\n- Manifest configuration: [version 2](https://developer.chrome.com/extensions/manifest) - [version 3](https://developer.chrome.com/docs/extensions/mv3/intro/)\n- [Permissions reference](https://developer.chrome.com/extensions/declare_permissions)\n- [Chrome API reference](https://developer.chrome.com/docs/extensions/reference/)\n\n**Extension Publishing Guides**\n\n- [Publishing for Chrome](https://developer.chrome.com/webstore/publish)\n- [Publishing for Edge](https://docs.microsoft.com/en-us/microsoft-edge/extensions-chromium/publish/publish-extension)\n- [Publishing for Opera addons](https://dev.opera.com/extensions/publishing-guidelines/)\n- [Publishing for Firefox](https://extensionworkshop.com/documentation/publish/submitting-an-add-on/)\n"
},
{
"path": "config/init/manifest.json",
"content": "{\n \"name\": \"__MSG_appName__\",\n \"short_name\": \"__MSG_appShortName__\",\n \"description\": \"__MSG_appDescription__\",\n \"homepage_url\": \"${homepage}\",\n \"version\": \"${version}\",\n \"version_name\": \"${version}\",\n \"manifest_version\": 3,\n \"default_locale\": \"en\",\n \"minimum_chrome_version\": \"88\",\n \"permissions\": [],\n \"icons\": {\n \"128\": \"assets/img/128x128.png\"\n },\n \"background\": {\n \"service_worker\": \"background.js\"\n },\n \"action\": {\n \"default_icon\": {\n \"16\": \"assets/img/16x16.png\",\n \"24\": \"assets/img/24x24.png\",\n \"32\": \"assets/img/32x32.png\"\n },\n \"default_title\": \"__MSG_appName__\"\n }\n}\n"
},
{
"path": "config/init/messages.json",
"content": "{\n \"appName\": {\n \"message\": \"${name}\"\n },\n \"appShortName\": {\n \"message\": \"${name}\"\n },\n \"appDescription\": {\n \"message\": \"${description}\"\n }\n}\n"
},
{
"path": "config/init/package.json",
"content": "{\n \"name\": \"${safeName}\",\n \"description\": \"${description}\",\n \"version\": \"${version}\",\n \"homepage\": \"${homepage}\",\n \"author\": \"ENTER YOUR NAME HERE\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"ENTER GIT REPO URL\"\n },\n \"scripts\": {\n \"start\": \"xt-build -e dev -w\",\n \"start:firefox\": \"xt-build -e dev -p firefox -w\",\n \"build\": \"xt-build -e prod\",\n \"build:firefox\": \"xt-build -e prod -p firefox\",\n \"clean\": \"xt-clean\",\n \"docs\": \"xt-docs\",\n \"test\": \"xt-test\",\n \"coverage\": \"nyc --reporter=lcov npm run test\",\n \"sync\": \"xt-sync\"\n },\n \"babel\": {\n \"presets\": [\n \"@babel/preset-env\"\n ]\n },\n \"eslintIgnore\": [\n \"test/**/*\"\n ],\n \"devDependencies\": {\n \"extension-cli\": \"latest\"\n },\n \"xtdocs\": {\n \"source\": {\n \"include\": [\n \"README.md\",\n \"src\"\n ]\n }\n },\n \"xtbuild\": {\n \"js_bundles\": [\n {\n \"name\": \"background\",\n \"src\": \"./src/**/*.js\"\n }\n ]\n }\n}\n"
},
{
"path": "config/init/test.js",
"content": "describe('Test extension', () => {\n\n it('This is a dummy test', () => {\n expect(true).to.be.true;\n });\n});\n"
},
{
"path": "config/readme.md",
"content": "# CLI configuration files\n\nThis directory contains various files that are used by the available CLI commands. Below is a short summary of each to explain their purpose.\n\nPath | Description\n:--- | :---\n**actions.yml** | Github actions starter configuration\n**build.json** | default file paths used by the build script\n**docs.json** | JSDoc documentation template\n**eslint.json** | default eslint configuration\n**gitlab.yml** | Gitlab CI starter configuration\n**ignore** | gitignore starter\n**travis.yml** | Travis CI starter configuration\n**init/** | Files for bootstrapping a new extension project \n **āāā NNxNN.png** | extension icons\n **āāā background.js** | background script starter\n **āāā icon.svg** | vector icon\n **āāā intro.md** | new extension readme\n **āāā manifest.json** | manifest template\n **āāā messages.json** | message dictionary template\n **āāā package.json** | package.json template\n **āāā test.js** | unit test starter\n\n**Notes**\n\n- eslint, CI configuration files, (git)ignore can be pulled into a project through `xt-sync` command,\n or a project can specify these files independently.\n The idea is not having to start from scratch at project level unless it is by choice. \n- All files in `init` directory are included in a new extension project\n - files that should not be included in a newly generated project go in `/config` directory\n- keep `init` directory flat on purpose to keep things simple — create command will generate\n the necessary structure \n \n"
},
{
"path": "config/travis.yml",
"content": "language: node_js\n\nnode_js:\n - \"14.15.4\"\n\ncache:\n directories:\n - node_modules\n\nbefore_script:\n - npm run test || travis_terminate 1\n\nscript:\n - npm run docs\n - npm run build\n\ndeploy:\n - provider: pages\n skip_cleanup: true\n github_token: $github_token\n local_dir: public/documentation\n on:\n branch: master\n\n - provider: releases\n skip_cleanup: true\n api_key: $github_token\n file: $zip_path\n on:\n tags: true\n\n#after_deploy:\n## upload generated zip to chrome web store\n## see: https://github.com/MobileFirstLLC/cws-publish\n# - if [ ! -z \"$TRAVIS_TAG\" ]; then\n# npx cws-upload $client_id $secret $token $zip_path $extension_id;\n# fi\n"
},
{
"path": "guide/01-getting-started.md",
"content": "# Installation\n\n### Prerequisites\n\nBefore using extension CLI, you must have the following:\n\n- [Node.js](https://nodejs.org/en/download/)\n- JavaScript IDE\n- Terminal access\n- Browser for debugging extensions\n\n### Setup\n\nCreate a new extension project:\n\n```bash\nnpx extension-cli\n```\n\nAdd CLI to an existing project:\n\n```bash\nnpm install extension-cli\n```\n\n### Default Project Organization\n\nBefore you start using the CLI, inspect your project file structure. You can override most of \nthese paths in configurations, but this organization matches the CLI defaults.\n\nIf you created a new extension using the command above, your file structure already looks like this.\n\nPath | Description\n--- | ---\nā **assets** | static assets\n āā img | Extension icons\n āā locales | Localized string resources\n āā en/messages.json | English dictionary\nā **src** | Source code: put js, scss, html, json files here\n āā manifest.json | Extension manifest \nā **test** | Unit tests\nā package.json | Application root\n\n"
},
{
"path": "guide/02-configuration.md",
"content": "# Configuration for Existing Applications\n\n!!! info\n **If you created the extension with Extension CLI, this setup is already done for you, and you may skip this step.**\n \n\nBefore using Extension CLI with an existing application, add these configuration options to project's `package.json`:\n\n### Babel Presets\n\nThis is needed to compile projects written in modern JavaScript syntax.\n\n```json\n\"babel\": {\n \"presets\": [\n \"@babel/preset-env\"\n ]\n}\n```\n\n### ESLint Ignore\n\nExclude test files from being linted. If your project includes compiled 3rd party libraries, you should exclude them also.\n\n```json\n\"eslintIgnore\": [\n \"test/**/*\"\n]\n```\n\n### Add Scripts\n\nAdd these to `package.json` `scripts` section:\n\n```json\n\"scripts\": {\n \"start\": \"xt-build -e dev -w\",\n \"build\": \"xt-build -e prod\",\n \"clean\": \"xt-clean\",\n \"docs\": \"xt-docs\",\n \"test\": \"xt-test\",\n \"coverage\": \"nyc --reporter=lcov npm run test\"\n}\n```\n\n"
},
{
"path": "guide/03-xt-build-assets.md",
"content": "# Static assets\n\n* * *\n\nSpecify how static assets will be handled during builds.
\n\n* * *\n\nBy default, extension CLI will look for static assets matching this configuration:\n\n```json\n\"assets\": [\n \"./assets/**/*\",\n \"!./assets/locales\",\n \"!./assets/locales/**/*\"\n ],\n```\n\nYou may change this configuration if the project's static assets are located elsewhere or\nif you want to include or exclude additional files/directories.\n\nAfter the build step, all static assets will be located in the `/dist/assets` directory.\n\nFor example, to refer to images in extension manifest, would be as follows:\n\n```json\n\"browser_action\": {\n \"default_icon\": {\n \"16\": \"assets/img/16x16.png\",\n \"24\": \"assets/img/24x24.png\",\n \"32\": \"assets/img/32x32.png\"\n }\n}\n```\n"
},
{
"path": "guide/03-xt-build-cmds.md",
"content": "# Custom commands\n\n* * *\n\nCustom commands enables running any custom actions after build and before generating a release.
\n\n* * *\n\nCustom commands will be executed: \n\n- _after_ script, styles, HTML and other bundles have been built, and\n- _before_ a release `.zip` file is generated\n\nCustom commands are run for both `dev` and `prod` builds. \n\nTo configure custom commands specify `commands` build configuration key. For example:\n\n```json\n\"xtbuild\": {\n \"commands\": \"python do_something.py\",\n} \n```\n\nThis configuration would first build the extension, then run a custom Python script, \nthen for a production build, generate the extension zip file.\n\n\n"
},
{
"path": "guide/03-xt-build-copy.md",
"content": "# Copying Files\n\n* * *\n\nCopying enables including files in the output without modifying them during build.\nThis includes use case where you want to skip compilation and linting of scripts or stylesheets.
\n\n* * *\n\n!!! info \"Copying static assets\"\n By default, all static assets under `assets/` directory will be automatically\n copied to output directory during builds.\n \n\n`copyAsIs` allows you to specify an array of files and/or directories which should be included in build output\nwithout modification. Files to copy can be located anywhere in your project. The directories to copy are expected to be inside `/src` directory.\n \nThe build command will copy: \n\n- specified **files** without any modification and add them to the root of the output directory;\n directory path for files will be flattened.\n\n- specified **directories** and their contents without modification and without flattening the path\n\nIf the copy command fails to locate the specified file or directory, it will not\nraise an issue, the copy will simply not occur.\n\n## Example 1: File copy\n\nSample configuration for skipping compilation of pre-compiled files.\n\nThis configuration will copy material theme directly from `node_modules` \nand include it in the `dist` directory. It will also copy a project level `special.js` \nscript into the output directory. No modification will occur to these files during the build step. \n\nAfter the build `dist/` directory root will include `material.min.js` and `special.js`.\n\n```json\n\"xtbuild\": {\n \"copyAsIs\": [\n \"./node_modules/material-design-lite/material.min.js\",\n \"./some/path/special.js\"\n ]\n}\n```\n\n\n## Example 2: Directory copy\n\nWhen copying directories, directory will maintain its structure. Directory to copy must be \ninside `src` directory. When specifying a directory use a match pattern, either `*` or `**/*`:\n\nThis build configuration will perform following copy operations:\n\n- `/src/directory/*` copies all files under `/src/directory/` to `dist/` root (excludes nested directories).\n\n- `/src/nested/directory/**/*` recursively copies all files and nested directories to `dist/` root without flattening path.\n \n\n```json\n\"xtbuild\": {\n \"copyAsIs\": [\n \"/src/directory/*\",\n \"/src/nested/directory/**/*\"\n ]\n}\n```\n\n## Disable Linting\n\nWhen including precompiled javascript files to an extension project, you should also \ndisable linting for those files to avoid unnecessary warnings. In `package.json`, \nadd the file paths to the list of ignored files to prevent them from being linted:\n\n```json\n { \n \"eslintIgnore\": [\n \"test/**/*\",\n \"./some/path/special.js\"\n ]\n }\n```\n"
},
{
"path": "guide/03-xt-build-locales.md",
"content": "# Localization\n\n* * *\n\nLocalization enables translating extension to different languages.
\n\n* * *\n\nIf the extension supports multiple languages, you can customize \nextension localization by specifying two build keys: `locales_dir` and `locales_list`.\n\n## Locales directory\n\n`locales_dir` key specifies where in project directory to look for locales files.\nThe default `locales_dir` is `./assets/locales/`.\nIf you prefer a different directory structure, override this default value.\n\n\n## Locales list\n\n`locales_list` is an array that lists all supported languages, and such that\n the values of this array correspond to subdirectories under `locales_dir`. Only\n locales directories specified in this array will be included in the build, which\n allows excluding incomplete translations from build until they are ready to be\n included. \n \n The default value of `locales_list` is `[\"en\"]`. \n\n Refer [to this list of language codes](https://developers.google.com/admin-sdk/directory/v1/languages)\n when specifying value for this configuration.\n\nYou may split localization files into multiple `.json` files within the \nlanguage-specific directory to improve maintainability. During builds\nall files within a language directory will be automatically combined into a single \n`messages.json` which is expected from a browser extensions.\n\nRecommended reading: [learn how to internationalize extensions](https://developer.chrome.com/extensions/i18n).\n\n## Example\n\nThis configuration shows build configuration with custom path and multiple language\noutputs.\n\nBuild configuration\n\n```json\n\"xtbuild\": {\n \"locales_list\": [\"en\",\"fr\",\"pl\"],\n \"locales_dir\": \"./my/custom/locales/path/\"\n}\n```\n\nCorresponding project level file structure: \n\nFile Path | Description\n--- | ---\nā **`/my/custom/locales/path/`** | locales directory\n āā `en`/messages.json | English dictionary\n āā `fr`/myFile.json | French dictionary\n āā `pl/` | \n āā app.json | Polish dictionary, part 1\n āā options.json | Polish dictionary, part 2\n āā `de`/messages.json | German dictionary\n\nBuild behavior:\n\n- `myFile.json` will be renamed to `messages.json` \n- `app.json` and `options.json` will me concatenated and renamed to `messages.json`\n- extension will be available in 3 languages; `dist/` directory will contain:\n - `_locales/en/messages.json`\n - `_locales/fr/messages.json`\n - `_locales/pl/messages.json`\n- German dictionary is excluded from build output because it is not included in `locales_list`\n"
},
{
"path": "guide/03-xt-build-manifest.md",
"content": "# Manifest\n\n* * *\n\nCustomize build behavior for extension manifest.
\n\n* * *\n\nIn your build configuration specify path to the manifest file:\n\n```json\n\"xtbuild\": {\n \"manifest\": \"./src/manifest.json\",\n} \n```\n\nThe file will be renamed to `manifest.json` during build regardless of its original name.\n\n## Customizing manifests for different target browsers\n\nThere are two strategies for customizing the manifest contents per target browser:\n\n1. Specify browser-specific keys in single manifest file\n2. Specify multiple build configurations, each with different manifest file.\n\n### Browser specific keys in single manifest\n\nUsing this strategy, the project contains single manifest. In manifest.json:\n\n```json\n{\n \"name\": \"__MSG_appname__\",\n \"description\": \"__MSG_description__\",\n \"chrome\":{\n \n ... chrome-specific manifest keys here\n \n },\n \"firefox\":{\n\n ... firefox-specific manifest keys here\n\n }\n}\n```\n\nThen run the build command specifying the target platform:\n\n```\nxt-build --platform chrome \nxt-build --platform firefox\n```\n\nThe build will then combine all common manifest elements with those\nspecified for the target platform. \n\nWhen building cross-browser extensions, most browsers can reuse the \nsame manifest. Therefore, these two targets are typically sufficient to generate the desired\n manifests for multiple target browsers. However, if this strategy\nis insufficient, see the next option. \n\n\n### Multiple build configurations\n\nCreate multiple build configuration files:\n\nchrome-config.json:\n\n```json\n{\n \"manifest\": \"./manifests/chrome.json\"\n} \n```\n\nfirefox-config.json:\n\n```json\n{\n \"manifest\": \"./manifests/firefox.json\"\n} \n```\n\nUsing this strategy, run the build command specifying path to config file explicitly:\n\n```\nxt-build --config chrome-config.json \nxt-build --config firefox-config.json\n```\n"
},
{
"path": "guide/03-xt-build-scripts.md",
"content": "# Building Scripts\n\n* * *\n\nInstructions for configuring javascript build outputs.
\n\n* * *\n\n`js_bundles` key is used to configure build settings for javascript bundles. \n\nIt allows you to specify: \n\n1. name of each generated script file\n2. what to included in each script\n3. how many scripts will be generated by build command\n\nBy default `js_bundles` looks for .js files in source directory and generates\na single script.js as output.\n\n## Configuration options\n\n`js_bundles` value is an array of objects, where each object specifies the following keys:\n\n| Key | Value |\n--- | ---\n| **`name`** | Output filename without file extension |\n| **`src`** | Glob pattern for specifying which files to include in the bundle | \n| **`mode`** (optional) | webpack build mode; by default same as `--env` flag | \n\n!!! info\n Internally JavaScript bundles are built using webpack where mode is determined\n by build `--env` flag. If you want to override this behavior and always use a \n specific webpack mode configuration, explicitly specify `\"mode\"` in the build \n configuration. \n\n### Specifying source files\n\nFor specifying value of `src` you can use any valid glob pattern: \n\n- a string value for a single file, example: `\"src/index.js\"`\n- array of files, example: `[\"src/index.js\", \"src/popup.js\"]` \n- a path with wildcard, for example: `\"src/*.js\"`\n- You may also use `!` as a way to negate inclusion of file(s)\n\nSee [\"Explaining Globs\"](https://gulpjs.com/docs/en/getting-started/explaining-globs) for detailed reference. \n\n\n## Example\n\nBelow is a sample build configuration that will generate two JavaScript files: \n\n- First one contains exactly `src/background.js` \n- Second one contains all `.js` files under directories `scr/app/dir1` and `scr/app/dir2`\n\nAfter running build command `dist/` will contain `background.js` and `app.js`.\n\n```json\n\"xtbuild\": {\n \"js_bundles\": [\n {\n \"name\": \"background\",\n \"src\": \"./src/background.js\"\n },\n {\n \"name\": \"app\",\n \"src\": [\n \"./src/app/dir1/**/*.js\",\n \"./src/app/dir2/**/*.js\"\n ]\n }\n ]\n}\n```\n"
},
{
"path": "guide/03-xt-build-styles.md",
"content": "# Building Stylesheets\n\n* * *\n\nInstructions for configuring stylesheet build outputs.
\n\n* * *\n\n`scss_bundles` are used to configure build settings for CSS stylesheets. The expected value is an array with \nzero or more objects where.\n\n- `name` is the output bundle filename with file extension\n- `src` specifies which files to include in each bundle; you can use \n - a string value for a single file\n - array of files, or \n - a path with wildcard. \n - prefix `!` as a way to negate the inclusion of a file\n \nSee [globs syntax guide](https://gulpjs.com/docs/en/api/src) for more details.\n\nDev build does not minify style files. The production build will minify style files.\n\nBy default, the stylesheets are assumed to be written using [Sass](https://sass-lang.com/guide). When naming stylesheet files, use `.scss` file extension because default configuration looks for style files with this file extension. \n\nIf you are not a friend of Sass, you can write style sheets using CSS. In the build configuration override the default configuration: `\"scss\": \"./src/**/*.scss\"` to treat other file extensions as style files, and use `\"scss_bundles\"` key to specify how to generate stylesheets, as shown in the example below.\n\n**Example**\n\nSample project-level configuration with multiple style bundles. This configuration will generate two stylesheets in the output directory: styles.css and display.css.\n\n```json\n\"xtbuild\": {\n \"scss_bundles\": [\n {\n \"src\": [\n \"./src/**/*.scss\",\n \"!./src/app/styles/ui.scss\"\n ],\n \"name\": \"styles\"\n },\n {\n \"src\": [\n \"./src/app/styles/ui.scss\"\n ],\n \"name\": \"display\"\n }\n ]\n}\n```\n"
},
{
"path": "guide/03-xt-build.md",
"content": "# xt-build\n\n* * *\n\nxt-build command builds an extension project.
\n\n* * *\n\nBuild command can be used to create a debuggable version, or a production-ready .zip file that can be uploaded to an extension/add-on marketplace for distribution.\n\nSuccessful build command always generates an extension in build output directory that can be debugged in the browser. The underlying build system uses gulp, babel and webpack (among other plugins) to compile the extension project.\n\n### Dev Build Artifacts\n\nWhen specifying`dev` build flag, the build will complete using development settings. Successful dev build generates extension source code in the specified build output directory, which can be debugged in a browser.\n\n### Prod Build Artifacts\n\nWhen specifying `prod` build flag, the build will run a production build. Successful production build generates extension source code in build output directory, which can be debugged in a browser. It also generates a .zip file in the project root. This zip file can be uploaded to extension/add-on marketplace such as Chrome Web Store or Firefox add-ons. When running a production build, all code files (js, css, HTML, json) will be optimized.\n\n## Commands\n\nBraces `{ }` indicate that the user must choose one (and only one) of the items inside the braces.\n\n\n**Run build with default options**\n\nDefault option runs production build targeting Chrome browser. \n\n```bash\nxt-build\n```\n\n**Run build with explicit environment flag `-e` or `--env`**\n\n```bash\nxt-build {-e|--env} dev\n```\n\n```bash\nxt-build {-e|--env} prod\n```\n\n**Run build for specific target browser**\n\n```bash\nxt-build {-p|--platform} chrome \n```\n\n```bash\nxt-build {-p|--platform} firefox\n```\n\n**Run build using custom configuration file path**\n\n```bash\nxt-build {-c|--config} \"/path/to/config.json\"\n```\n\n**Run development build and keep watching changes**\n\n```bash\nxt-build {-e|--env} dev {-w|--watch}\n```\n\n**Get help using this command**\n\n```bash\nxt-build --help\n``` \n\n## Package.json scripts\n\nAfter adding Extension CLI to your project, you can run these commands from a \nterminal using syntax `npx xt-build`, or add the following to `packages.json` scripts section, \nthen execute the commands as `npm run start` or `npm run build`:\n \n```json\n\"scripts\":{\n \"start\": \"xt-build -e dev -w\",\n \"build\": \"xt-build -e prod\",\n}\n```\n\n## Default Configuration\n\nBy default the CLI will look for build configuration in two different\nplaces:\n\n- in `package.json` using key `xtbuild`\n\n- in a file named `.xtbuild.json` in project root\n\nAlternatively you can provide a path to configuration file with `-c` or \n`--config` flag, followed by a path to configuration file. \n\nThe CLI uses a default build configuration shown below. This tells \nextension CLI where to look for input files, how to process them, and where \nto output files. You can override any of these key-value pairs at project level. \n\nExplanations for each of these keys is given below.\n\n```json\n--8<--\n./config/build.json\n--8<--\n```\n\n### Configuration Keys\n\nKey | Description | Guide \n--- | --- | ---\n`\"dist\"` | Build output directory ||\n`\"source\"` | Source code directory ||\n`\"releases\"` | Directory for outputting release zip file ||\n`\"release_name\"` | name of release zip file ||\n`\"manifest\"` | extension manifest file path | [Guide](03-xt-build-manifest.md) |\n`\"js\"` | Watch pattern for script changes during dev builds ||\n`\"js_bundles\"` | Javascript bundles configuration | [Guide](03-xt-build-scripts.md)\n`\"html\"` | location and watch pattern of HTML files ||\n`\"scss\"` | Watch pattern for style changes during dev builds ||\n`\"scss_bundles\"` | Stylesheets bundles configuration | [Guide](03-xt-build-styles.md)\n`\"assets\"` | Static assets configuration match pattern | [Guide](03-xt-build-assets.md) \n`\"copyAsIs\"` | Files and directories to copy to output directory without modification | [Guide](03-xt-build-copy.md)\n`\"locales_dir\"` | Localizations directory | [Guide](03-xt-build-locales.md) \n`\"locales_list\"` | List of locales | [Guide](03-xt-build-locales.md)\n`\"commands\"` | Custom commands | [Guide](03-xt-build-cmds.md)\n\n"
},
{
"path": "guide/04-xt-clean.md",
"content": "# xt-clean\n\n\n* * *\n\nxt-clean command removes all automatically generated files from the project directories.
\n\n* * *\n\nClean operation iterates over files and directories listed in the project `.gitignore` file, and removes all ignored files and directories, except `node_modules/`, `.idea/`, and `.vscode/`. `.idea` is a collection of configuration files used by WebStorm IDE, and `.vscode` is the same for Visual Studio Code. The IDE will generate them automatically if they are absent. To remove these three directories, you must explicitly pass a flag to delete each directory respectively.\n\n\n## Commands\n\nBraces `{ }` indicate that the user must choose one (and only one) of the items inside the braces.\n\n**Remove ignored files (default)**\n\n```bash\nxt-clean\n```\n\n**Clear ignored files, including `node_modules`**\n\n```bash\nxt-clean {-m|--modules}\n```\n\n**Clear ignored files, including `.idea/` directory**\n\n```bash\nxt-clean {-i|--idea}\n```\n\n**Clear ignored files, including `.vscode/` directory**\n\n```bash\nxt-clean {-v|--vscode}\n```\n\n**Clear absolutely all ignored files**\n\n```bash\nxt-clean -v -i -m\n```\n\n**Get help using this command**\n\n```bash\nxt-clean --help\n``` \n\n## Package.json scripts\n\nAfter installing extension-cli, you can run these commands from a terminal using syntax `npx xt-clean`.\n \nOr you can add an option to `packages.json` scripts section and then execute the command as `npm run clean` See example below. \n \n```json\n\"scripts\":{\n \"clean\": \"xt-clean\"\n}\n```\n\n\n"
},
{
"path": "guide/05-xt-docs-templates.md",
"content": "# Documentation Templates\n\n* * *\n\nUse templates to customize the look and feel of \nsource code documentation.
\n\n* * *\n\nExtension CLI uses [JsDoc](https://jsdoc.app) to document extension projects.\nYou can then apply templates to customize the look and feel of these docs.\n\n## Customizing Default Template\n\nIf you are using the default template see: [Configuring JSDoc's default template](https://jsdoc.app/about-configuring-default-template.html).\n\n\n \n \n \n \n ![\"default](\"/extension-cli/assets/images/jsdoc-default.jpg\")
\n\n\n## Alternative Templates\n\nTo use an alternative template:\n\n1. Choose a suitable template and use npm to install it at project level\n2. In the [documentation configuration](https://oss.mobilefirst.me/extension-cli/05-xt-docs/#default-configuration):\n 1. Specify `\"opts.template\"` to indicate which template to use \n 2. Customize the template options under `\"templates\"` \n\n* * *\n\n### Braintree JSDoc Template\n\n[Source and configuration](https://github.com/braintree/jsdoc-template)\n\n\n\n\n \n \n \n \n ![\"braintree\"/](\"/extension-cli/assets/images/braintree.jpg\")
\n\n\n* * *\n\n### clean-jsdoc-theme\n\n[Source and configuration](https://github.com/ankitskvmdam/clean-jsdoc-theme)\n\n\n\n_Light mode_\n\n\n \n \n \n \n ![\"light](\"/extension-cli/assets/images/clean-jsdoc-light.jpg\")
\n\n\n_Dark mode_\n\n\n \n \n \n \n ![\"dark](\"/extension-cli/assets/images/clean-jsdoc-dark.jpg\")
\n\n\n* * *\n\n### Foodoc\n\n[Source and configuration](https://github.com/steveush/foodoc)\n\n\n\n\n\n \n \n \n \n ![\"foodoc\"/](\"/extension-cli/assets/images/foodoc.jpg\")
\n\n\n* * *\n\n### JsDoc Template\n\n[Source and configuration](https://github.com/AlexisPuga/jsdoc-template)\n\n\n\n\n \n \n \n \n ![\"JsDoc](\"/extension-cli/assets/images/jsdoc-template.jpg\")
\n\n\n* * *\n\n### Tidy JsDoc\n\n[Source and configuration](https://github.com/julie-ng/tidy-jsdoc)\n\n\n\n\n \n \n \n \n ![\"Tidy](\"/extension-cli/assets/images/tidy-jsdoc.jpg\")
\n\n\n* * *\n\n\n\n"
},
{
"path": "guide/05-xt-docs.md",
"content": "# xt-docs\n\n* * *\n\nxt-docs command generates source\n code documentation for an extension project.
\n\n* * *\n\nExtension CLI uses [JSDoc](https://jsdoc.app/index.html) specification to \ngenerate documentation for javascript files in an extension project. JSDoc is \na flexible documentation generator that converts javascript code comments to \nreadable HTML/CSS files which you can be hosted for example with github pages.\n\n## Commands\n\nBraces `{ }` indicate that the user must choose one (and only one) of the \nitems inside the braces.\n\n**Default command**\n\n```bash\nxt-docs\n```\n \n**Command using custom configuration file path**\n\n```bash\nxt-docs {-c|--config} \"/path/to/config.json\"\n```\n\n**Build docs and keep watching changes**\n\n```bash\nxt-docs {-w|--watch}\n```\n\n**Get help using this command**\n\n```bash\nxt-docs --help\n``` \n\n## Package.json scripts\n\nAfter installing extension-cli, you can run these commands from a terminal \nusing syntax `npx xt-docs`.\n \n Or you can add an option to `packages.json` scripts section and then execute \n the command as `npm run docs`. See example below.\n \n```json\n\"scripts\":{\n \"docs\": \"xt-docs\"\n}\n```\n \n## Configuration\n \nBy default the CLI will look for docs configuration in two different\nplaces:\n\n- in `package.json` using key `xtdocs`\n\n- in a file named `.xtdocs.json` in project root\n\nIf these two locations cause a conflict, alternatively you can provide a path \nto configuration file with `-c` (`--config`) flag, followed by path to file. \n[See commands for an example](#commands).\n\nYou can use any compatible template of choice to style your docs. You can find \nsome [templating options here](05-xt-docs-templates.md).\n\n### Default Configuration\n\nThe CLI uses a documentation configuration file shown below. You can override any of these key-value pairs at project level. You can also add key-value pairs that are not defined here so long as they follow to [JSDoc guidelines](https://jsdoc.app/about-configuring-jsdoc.html).\n\n```json\n--8<--\n./config/docs.json\n--8<--\n```\n\n\n"
},
{
"path": "guide/06-xt-sync.md",
"content": "# xt-sync\n\n\n* * *\n\nxt-sync command enables copying and updating \nconfiguration files.
\n\n* * *\n\nWhen adding more features to an extension project, it is helpful\nto \\*not\\* start from scratch. `xt-sync` command enables extension projects\nto pull in starter configuration files for the purposes of linting, \nsetting up automated CI builds, and for setting up git VCS.\n\nThe configuration files are intended as a starting point. If you\nend up modifying them heavily at a project level, you should continue\nto maintain them manually instead of using this command.\n\nIf you do not modify these configuration files, you can sync the \nlatest version periodically, to update to the latest version supplied\nby this CLI.\n\n## Commands\n\n**Sync configuration files**\n\nThis command will guide you through the available options. \n\n```bash\nxt-sync\n```\n\n\n## Package.json scripts\n\nAfter installing extension-cli, you can run these commands from a terminal by calling\n \n```bash\nnpx xt-sync\n```\n\nAlternatively you can add an option to `packages.json` scripts section as shown below\n \n```json\n\"scripts\" : {\n \"sync\": \"xt-sync\"\n}\n```\n\nand then execute the command by running \n\n```bash\nnpm run sync\n```\n"
},
{
"path": "guide/07-xt-test.md",
"content": "# xt-test\n\n\n* * *\n\nxt-test command runs unit tests.
\n\n* * *\n\nThis command will setup extension testing environment that is pre-initialized\nwith [mocha](https://mochajs.org/), [chai](https://www.chaijs.com/),\nand expect. [nyc](https://www.npmjs.com/package/nyc) is used for computing code coverage. \nThe following browser features are initialized for convenience: `window`, `chrome`, `document`. \nWindow is setup using [jsdom-global](https://www.npmjs.com/package/jsdom-global) and\nchrome using [sinon-chrome](https://www.npmjs.com/package/sinon-chrome).\n\nBy default this command looks for unit tests in `test/` directory, in any file ending with `.js`. \nMocha will execute with babel, meaning you can use this test environment with modern JavaScript\n syntax.\n\nYou may extend this unit testing environment within an extension project. \nThis is simply a base setup for running unit tests for web extensions. \nYou may also create your very own test environment if this setup is not suitable for your project.\n\n## Commands\n\nBraces `{ }` indicate that the user must choose one (and only one) of the items inside the braces.\n\n\n**Run unit tests (default)**\n\n```bash\nxt-test\n```\n\n**Configure custom test directory path or match pattern**\n\nDefaults to `./test/**/*.js` if not specified\n\n```bash\nxt-test {-p|--pattern} \"./test/**/*.js\"\n```\n\n**Execute tests and keep watching changes**\n\n```bash\nxt-test {-w|--watch}\n```\n\n**Get help using this command**\n\n```bash\nxt-test --help\n``` \n\n## Package.json scripts\n\nAfter installing extension-cli, you can run these commands from a terminal using syntax `npx xt-test`.\n \nYou may also add an option to `packages.json` scripts section as shown below, then\n\n- run unit tests from terminal: `npm run test` \n- run unit tests and save coverage to file: `npm run coverage`.\n\n \n```json\n\"scripts\":{\n \"test\": \"xt-test\",\n \"coverage\": \"nyc --reporter=lcov npm run test\"\n}\n```\n\n## Reporting Coverage\n\n### Coveralls\n\nThe general setup is:\n\n1. Install [coveralls](https://www.npmjs.com/package/coveralls) as a dev dependency at project level:\n\n ```\n npm install coveralls --save-dev\n ```\n\n2. Run unit tests with coverage report during CI/CD workflow, then pipe the result to coveralls:\n\n ``` \n nyc --reporter=lcov npm run test | coveralls\n ```\n\n\nIf using Github actions, use [Coveralls Github action](https://github.com/marketplace/actions/coveralls-github-action) to report results. Example:\n\n```yaml\n- name: Execute unit tests w/ coverage\n run: nyc --reporter=lcov npm run test # or: npm run coverage\n\n- name: Report coverage\n uses: coverallsapp/github-action@master\n with:\n github-token: ${{ secrets.GITHUB_TOKEN }}\n```\n\n\n\n"
},
{
"path": "guide/08-xt-create.md",
"content": "# extension-cli\n\n* * *\n\nextension-cli command creates a new web extension project.
\n\n* * *\n\n## Commands\n\n```bash\nnpx extension-cli\n```\n \nThis command will prompt with necessary questions and does not take any arguments. \n \nThis command will generate initial files and directories for a new project.\n\nRun it in the directory where you want to create the extension.\n\n"
},
{
"path": "guide/09-release-notes-0.md",
"content": "---\ndisqus: \"False\"\n---\n\n\n### 0.11.9 (2021-04-04)\n\n* **xt-build**: enable customizing release filename [PR #37](https://github.com/MobileFirstLLC/extension-cli/pull/37)\n* update dependencies [PR #39](https://github.com/MobileFirstLLC/extension-cli/pull/39)\n* improve user guide organization and UI [PR #38](https://github.com/MobileFirstLLC/extension-cli/pull/38), [PR #40](https://github.com/MobileFirstLLC/extension-cli/pull/40)\n\n### 0.11.8 (2021-03-12)\n\n* **xt-build**: support copying directories as-is [#32](https://github.com/MobileFirstLLC/extension-cli/issues/32)\n* **xt-build**: append '.css' at the end of name if not specified by the user [PR #36](https://github.com/MobileFirstLLC/extension-cli/pull/36)\n\n### 0.11.7 (2021-03-02)\n\n* **xt-docs**: make watch recursive on watched directories\n* **xt-docs**: add tutorials directory to watch list (if exists)\n* **xt-docs**: display error when docs command fails\n\n### 0.11.6 (2021-02-25)\n\n* **xt-docs:** add watch mode to docs command, see: [#23](https://github.com/mobilefirstllc/extension-cli/issues/23) \n\n### 0.11.5 (2021-02-24)\n\n* **xt-test:** unit code result reporting fix, see: [#26](https://github.com/mobilefirstllc/extension-cli/issues/26) \n\n### 0.11.3 (2021-01-27)\n\n* **xt-build:** file watch fix\n\n### 0.11.2 (2021-01-08)\n\n* **xt-build:** command path fix\n\n### 0.11.1 (2021-01-06)\n\n* **xt-build:** allow specifying custom build commands\n* **xt-create:** fix image generation issue\n* update packages\n\n\n### 0.10.1 (2020-12-15)\n\n* update test configs \n* check if gitignore exists before xt-clean\n* **xt-create:** change default icon to high contrast\n* update packages\n\n### 0.9.4 (2020-11-29)\n\n* extension-cli: fix typo\n* update packages\n\n### 0.9.3 (2020-10-31)\n\n* xt-clean: improve xt-clean command handling of files\n* change icon\n* update docs\n\n### 0.9.1 (2020-10-11)\n\n- fix: xt-docs config keys replace when value is an array\n\n### 0.9.0 (2020-10-05)\n\n- xt-test: add configurable test path\n- xt-create: sanitize package name\n- update packages\n- xt-clean: refactor command\n- xt-docs: refactor docs command\n- xt-sync: refactor sync command\n\n### 0.8.16 (2020-08-09)\n\n- update packages\n\n### 0.8.15 (2020-08-04)\n\n- update packages\n\n### 0.8.14 (2020-08-01)\n\n- update xt-create\n\n### 0.8.13 (2020-07-26)\n\n- updated packages\n\n### 0.8.12 (2020-05-26)\n\n- update build command\n\n### 0.8.11 (2020-05-25)\n\n- fix issue with create command docs configs\n- add new/missing docs dependency\n\n### 0.8.10 (2020-05-25)\n\n- `xt-build` bug fixes\n- Made webpack options configurable, to enable adding loaders etc.\n- Upgraded project dependencies\n\n### 0.8.9 (2020-04-10)\n\n- Implemented command to create new extension\n- Updated docs to reflect this new command\n\n### 0.8.8 (2020-04-08)\n\n- Upgraded project dependencies\n\n### 0.8.7 (2020-01-17)\n\n- Upgraded project dependencies\n- Fixed scripts build step (changed webpack options)\n\n### 0.8.6 (2019-12-21)\n\n- Initial release for this publisher\n- Migrated project from older source code\n- Upgraded all packages\n- Migrated build to use Gulp v4\n"
},
{
"path": "guide/09-release-notes.md",
"content": "---\ndisqus: \"False\"\n---\n\n### 1.2.5 (2021-03-16) (alpha)\n\n**Dependency upgrades**\n\n- @babel/preset-env: 7.16.11 ([066f782](https://github.com/MobileFirstLLC/extension-cli/commit/066f7820ce48e877cf5477ff77037c9d3a9d2fdd))\n- @babel/register: 7.17.7 ([2084d42](https://github.com/MobileFirstLLC/extension-cli/commit/2084d42255e811c9f142ca77983b02aaa7dd71f0))\n- chai: 4.3.6 ([2084d42](https://github.com/MobileFirstLLC/extension-cli/commit/2084d42255e811c9f142ca77983b02aaa7dd71f0))\n- commander: 9.0.0 ([2084d42](https://github.com/MobileFirstLLC/extension-cli/commit/2084d42255e811c9f142ca77983b02aaa7dd71f0))\n- eslint: 8.11.0 ([2084d42](https://github.com/MobileFirstLLC/extension-cli/commit/2084d42255e811c9f142ca77983b02aaa7dd71f0))\n- gulp-sass: 5.1.0 ([0ac28b2](https://github.com/MobileFirstLLC/extension-cli/commit/0ac28b2eb26c998e0958ed4f98691419323b1931))\n- jsdoc: 3.6.10 ([d0a09a3](https://github.com/MobileFirstLLC/extension-cli/commit/d0a09a3540580ef1d69edaaf9aa264a4674198b5))\n- jsdom: 19.0.0 ([b0f290f](https://github.com/MobileFirstLLC/extension-cli/commit/b0f290fa43f76fc4e67a95ae35ca4cefb7b9db6c))\n- mocha: 9.2.2 ([2084d42](https://github.com/MobileFirstLLC/extension-cli/commit/2084d42255e811c9f142ca77983b02aaa7dd71f0))\n- sass: 1.49.9 ([aef9fd6](https://github.com/MobileFirstLLC/extension-cli/commit/aef9fd6142879af3bf4610c80eaca1f97aff96a4))\n- sinon: 13.0.1 ([8282c0a](https://github.com/MobileFirstLLC/extension-cli/commit/8282c0a05d2702e6ec92155d8cfaba2de93c9c53))\n- yargs: 17.3.1 ([add18ee](https://github.com/MobileFirstLLC/extension-cli/commit/add18ee15196d4356a74d0f76ded23d1fef1d085))\n\n### 1.2.4 (2021-10-19)\n\n- Update devtools sourcemap config [PR #119](https://github.com/MobileFirstLLC/extension-cli/pull/119)\n- New extension now initialized with MV3 [#86](https://github.com/MobileFirstLLC/extension-cli/pull/111)\n\n**Dependency updates**\n\n- update @babel/preset-env to v7.15.8 ([a341965](https://github.com/mobilefirstllc/extension-cli/commit/a3419659b3ac2427f1134f8c6cfb2bb38c29f009))\n- update commander to v8.2.0 ([5226669](https://github.com/mobilefirstllc/extension-cli/commit/52266695f15cace4cc422e229afe5555d30ff0e4))\n- update eslint to v8 ([d5549a8](https://github.com/mobilefirstllc/extension-cli/commit/d5549a8730256f61edbd36ab7cabbac95db5000e))\n- update jsdom to v18 ([681db6b](https://github.com/mobilefirstllc/extension-cli/commit/681db6bafeedda989471235ff6f14ad9edff1885))\n- update mocha to v9.1.2 ([d7cecc6](https://github.com/mobilefirstllc/extension-cli/commit/d7cecc60a2aa918559bea17b2531b3e331500cce))\n- update prompts to v2.4.2 ([f99cb60](https://github.com/mobilefirstllc/extension-cli/commit/f99cb608f43414ecbb8f9309ce2d32453b11b0d5))\n- update sass to v1.43.2 ([32eb148](https://github.com/mobilefirstllc/extension-cli/commit/32eb148d81318f115942df2682270ded3c061652))\n- update webpack-stream to v7 ([#94](https://github.com/mobilefirstllc/extension-cli/issues/94)) ([a19b448](https://github.com/mobilefirstllc/extension-cli/commit/a19b4488cc7f9a31474904e58b2920bf67f0619a))\n- update yargs to v17.2.1 ([9a06f44](https://github.com/mobilefirstllc/extension-cli/commit/9a06f44b878d178dbd15fbae490470082b99221a))\n\n### 1.2.2 (2021-07-28)\n\n- update dependencies\n\n### 1.2.0 (2021-07-28)\n\n**Changes to build**\n\n- enable using custom filenames for manifests pre-build [PR #66](https://github.com/MobileFirstLLC/extension-cli/pull/66)\n- run build tasks in parallel [PR #70](https://github.com/MobileFirstLLC/extension-cli/pull/70)\n- make sourcemap basename match js file name [PR #70](https://github.com/MobileFirstLLC/extension-cli/pull/70)\n- dynamically determine project path; remove build config key [PR #71](https://github.com/MobileFirstLLC/extension-cli/pull/71)\n\n**Other changes**\n\n- docs: make JsDoc default template the default documentation template for CLI [#62](https://github.com/MobileFirstLLC/extension-cli/issues/62)\n- sync: add CI configuration starter for Github actions [#65](https://github.com/MobileFirstLLC/extension-cli/issues/65)\n- sync: eslint config file will now have file extension `.json` [PR #78](https://github.com/MobileFirstLLC/extension-cli/pull/78)\n- update dependencies\n\n### 1.1.0 (2021-06-12)\n\n- sync: changed command to prompt with options [PR #57](https://github.com/MobileFirstLLC/extension-cli/pull/57), [#59](https://github.com/MobileFirstLLC/extension-cli/pull/59)\n- updated dependencies\n\n### 1.0.3 (2021-04-27)\n\n**Changes to build**\n\n- Make webpack mode configurable [#51](https://github.com/MobileFirstLLC/extension-cli/issues/51), [PR #55](https://github.com/MobileFirstLLC/extension-cli/pull/55)\n- use `cheap-source-map` [PR #49](https://github.com/MobileFirstLLC/extension-cli/pull/49)\n- remove devtool in prod config [PR #50](https://github.com/MobileFirstLLC/extension-cli/pull/50)\n\n### 1.0.2 (2021-04-11)\n\n**Changes to build**\n\n- Custom folders for scss bundles and always minify css [PR #47](https://github.com/MobileFirstLLC/extension-cli/pull/47)\n- Default style bundle name without extension [PR #48](https://github.com/MobileFirstLLC/extension-cli/pull/48)\n\n### 1.0.0 (2021-04-11)\n\n**Changes to build**\n\n- automatically copy from `assets/` to output directory `assets/` [PR #43](https://github.com/MobileFirstLLC/extension-cli/pull/43)\n- add target platform for manifests: `chrome/firefox` [PR #43](https://github.com/MobileFirstLLC/extension-cli/pull/43)\n- improved build outputs [PR #42](https://github.com/MobileFirstLLC/extension-cli/pull/42)\n\n**Other changes**\n\n- Updated dependencies [PR #44](https://github.com/MobileFirstLLC/extension-cli/pull/44)\n"
},
{
"path": "guide/12-helpful.md",
"content": "# Helpful References\n\n* * *\n\nCollection of generally helpful links for extension development.
\n\n* * *\n\n**Getting started guides**
\n[Chrome](https://developer.chrome.com/extensions/getstarted) •\n[Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions#get_started) •\n[Safari](https://developer.apple.com/documentation/safariservices/safari_web_extensions) •\n[Edge](https://docs.microsoft.com/en-us/microsoft-edge/extensions-chromium/) •\n[Opera](https://dev.opera.com/extensions/getting-started/)\n\n**Extension manifest references**
\n[Chrome v3](https://developer.chrome.com/extensions/manifest) •\n[Chrome v2 ā ļø](https://developer.chrome.com/docs/extensions/mv2/manifest/) •\n[Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json) • \n[Edge](https://docs.microsoft.com/en-us/microsoft-edge/extensions-chromium/getting-started/manifest-format) •\n[Opera](https://dev.opera.com/extensions/manifest/)\n\n**Lists of browser APIs**
\n[Chrome](https://developer.chrome.com/extensions/api_index) •\n[Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API#javascript_api_listing) •\n[Opera](https://dev.opera.com/extensions/apis/)\n \n \n**Cross-browser compatibility charts**
\n[Manifest compatibility](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Browser_compatibility_for_manifest.json) •\n[JavaScript API support](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Browser_support_for_JavaScript_APIs)\n\n**Internationalization**
\n[Supporting multiple languages](https://developer.chrome.com/extensions/i18n) •\n[Language locales list](https://developer.chrome.com/docs/webstore/i18n/#choosing-locales-to-support)\n\n**Extension Publishing Guides**
\n[Chrome](https://developer.chrome.com/webstore/publish) •\n[Edge](https://docs.microsoft.com/en-us/microsoft-edge/extensions-chromium/publish/create-dev-account) •\n[Firefox](https://extensionworkshop.com/documentation/publish/submitting-an-add-on/) •\n[Opera](https://dev.opera.com/extensions/publishing-guidelines/) •\n[Safari](https://developer.apple.com/documentation/safariservices/safari_web_extensions/distributing_your_safari_web_extension)\n\n**Marketplace Image Guidelines**
\n[Chrome](https://developer.chrome.com/webstore/images) •\n[Edge](https://docs.microsoft.com/en-us/microsoft-edge/extensions-chromium/publish/publish-extension#step-5-add-store-listing-details-for-your-extension)\n \n**Marketplace APIs**
\n[Chrome Web Store](https://developer.chrome.com/webstore/api_index)\n\n\n**Other Resources**\n\n- [Chrome Extension Samples](https://github.com/GoogleChrome/chrome-extensions-samples) - examples of feature implementations\n- [Awesome WebExtensions](https://github.com/fregante/Awesome-WebExtensions) - curated list of resources and tools\n"
},
{
"path": "guide/13-cli-development.md",
"content": "---\ndisqus: \"False\"\n---\n\n# Extension CLI Development\n\n- This CLI is built with Node.Js, written in JavaScript, and uses numerous packages listed below. \n- The source code is available on [Github](https://github.com/MobileFirstLLC/extension-cli).\n- Releases are published on [NPM](https://www.npmjs.com/package/extension-cli).\n- This user guide is built with [MkDocs](https://www.mkdocs.org/) and [MkDocs material theme](https://squidfunk.github.io/mkdocs-material/).\n- CI/CD by [Travis CI](https://travis-ci.org/MobileFirstLLC/extension-cli) and documentation served by [Github Pages](https://pages.github.com/).\n\n\n## Project Organization\n\nPath | Description\n--- | ---\nā **.github** | Github config files and markdown\nā **cli** | all available commands are defined here\nā **config** | Resources and config files used by the commands in `cli`\nā **guide** | User guide\nā **test** | CLI unit tests\nā `/*` | Application root; various project config files\n\n* * *\n\nTo setup a local dev environment and develop the CLI application, see\n \n[Environment Setup →](13-dev-env.md)\n\n* * * \n\n## Dependencies\n\nExtension CLI is built with the following dependencies:\n\n| # | Package name | Purpose |\n| --- | --- | --- | \n| 1. | `@babel/preset-env` | for modern JavaScript syntax |\n| 2. | `@babel/register` | for unit testing |\n| 3. | `chai` | BDD/TDD assertion library for unit testing |\n| 4. | `chalk` | Add color to terminal output | \n| 5. | `cli-spinner` | Terminal spinner to indicated progress |\n| 6. | `commander` | handle CLI input arguments |\n| 7. | `del` | for clearing generated files |\n| 8. | `eslint` | for linting JavaScript |\n| 9. | `gulp` | for running build script |\n| 10. | `gulp-change` | JSON file content manipulations |\n| 11. | `gulp-clean-css` | Minify CSS |\n| 12. | `gulp-concat` | Concatenates files (used for CSS) |\n| 13. | `gulp-htmlmin` | Removes whitespace from HTML |\n| 14. | `gulp-jsonminify` | minify JSON files (manifest, locales) |\n| 15. | `gulp-load-plugins` | to load various gulp plugins |\n| 16. | `gulp-merge-json` | merge locales files |\n| 17. | `gulp-rename` | rename files during builds |\n| 18. | `gulp-sass` | process SASS files during builds |\n| 19. | `gulp-zip` | generate zip files |\n| 20. | `jsdoc` | generate docs |\n| 21. | `jsdom` | mock DOM in Node.js env |\n| 22. | `jsdom-global` | adds window, document to unit testing env |\n| 23. | `mocha` | unit testing framework |\n| 24. | `nyc` | unit testing code coverage tool |\n| 25. | `prompts` | create CLI prompts with interactive selectors |\n| 26. | `sass` | compile SASS files during builds |\n| 27. | `sinon` | JavaScript test spies, stubs and mocks |\n| 28. | `sinon-chrome` | unit testing for extensions |\n| 29. | `webpack-stream` | build javascript files |\n| 30. | `yargs` | parse keyword args |\n"
},
{
"path": "guide/13-dev-env.md",
"content": "# Environment Setup\n\n\nTo build extension CLI locally you will need [Node.js](https://nodejs.org/en/download/)\nand any web IDE of your choice.\n\nDeveloping the CLI requires two projects open at the same time:\n\n1. the CLI source code, which you are developing\n2. a driver project that is used to execute the CLI commands\n\nThe following instructions explain how to set up this environment.\n\n## Instructions\n\n### 1. Setup the CLI\n\n1. [Fork the extension-CLI repo](https://github.com/MobileFirstLLC/extension-cli/fork)\n\n2. Clone the forked repo and then open it in your favorite web IDE\n\n3. Run the following command in terminal: \n\n```bash\nnpm install \n```\n\n### 2. Setup driver project\n\nNext you will need a project to drive the CLI to be able to execute its commands.\nYou can use any existing extension project that is using extension-cli.\n\nIf you do not have an existing project, create a new project. In the directory where you want to create the driver project run:\n\n```bash\nnpx extension-cli\n```\n\nthen follow the on-screen instructions. Once you have the project ready, open it in a web IDE. \nAt this point you should have two IDE windows open. \n\n### 3. Link driver and CLI\n\n\n1. In **CLI project** terminal run this command (use `sudo npm link` if necessary):\n\n ```bash\n npm link \n ```\n \n
\n\n2. In the **driver project** terminal run this command: \n \n ```bash\n npm link extension-cli\n ``` \n \n* * * \n\n**Your dev environment should now be ready to use.**\n \n* * * \n\n## Clean up\n\nUnlink CLI and driver project to remove all local links.\n\nIn the **driver project** terminal run: \n \n```bash\nnpm unlink --no-save extension-cli\n``` \n\nto unlink project from the local CLI version. Note that this may remove\nextension-cli from the project completely, and you may need to run `install extension-cli`\nto add back the version from NPM registry. This is relevant only if you used\nan existing project as a driver.\n\nIn **CLI project** terminal run:\n\n```bash\nnpm r extension-cli -g\n```\n\nto remove the CLI symlink.\n"
},
{
"path": "guide/14-user-guide.md",
"content": "# Editing User Guide\n\n\n!!! info\n If you are interested in editing the content (and not layout) of this user guide, \n simply edit the markdown directly in any markdown editor or on Github.\n There is a pencil icon linking to the markdown source on each page of these docs,\n which takes you directly to the source document.\n\n## Developing User Guide\n\nWhen you want to edit the layout, organization and/or theme of these docs, you \nwill need to run these project docs locally. This user guide is built with Python. \nYou will need Python 3.x before proceeding.\n\n1. If you are not a maintainer, [fork the repo](https://github.com/MobileFirstLLC/extension-cli/fork)\n\n2. Clone the forked repo and launch your favorite markdown editor and terminal.\n\n3. Setup Python development env as follows: \n\n - Create virtual env for Python packages:\n \n ```\n python3 -m venv env \n ```\n \n - Activate virtual env:\n \n ``` \n source env/bin/activate # macOS/Linux\n env\\Scripts\\activate.bat # Windows\n ```\n \n - Install requirements:\n \n ```\n pip install -r requirements.txt\n ```\n \n - Run and debug the docs:\n \n ```\n mkdocs serve\n ```\n\n4. Relevant files:\n\n - all written documents are under `guide` directory\n - `mkdocs.yml` at project root is a configuration file for Mkdocs\n - `guide/assets` includes static assets for these docs\n - `guide/overrides` includes customized template files that override default mkdocs-material templates\n\n5. After editing the docs, commit your changes and open a PR as\n necessary. Travis CI is used to compile and publish the docs automatically\n after each merge to master branch.\n"
},
{
"path": "guide/assets/custom.css",
"content": "/* add custom css here */\n.md-main__inner{padding-bottom: 3em}\n.page-intro{font-size:1.3em;line-height:1.7;}\n.highlighttable td pre {line-height: 1.9;}\n.md-tabs__item{font-weight: bold}\n\ntable {padding: 0;}\ntable tr {margin: 0;padding: 0; }\ntable tr th {font-weight: bold;}\ntable tr th :first-child, table tr td :first-child {margin-top: 0; }\ntable tr th :last-child, table tr td :last-child {margin-bottom: 0; }\n\n.md-typeset table:not([class]){\n font-size: .68rem;\n box-shadow: none;\n background: var(--md-code-bg-color);\n}\ntable tr th,table tr td,\n.md-typeset table:not([class]) th,\n.md-typeset table:not([class]) td{\n margin: 0; padding: .65em .95em;\n}\n.md-typeset code{\n padding: 3px .35em;\n}\n.md-typeset table:not([class]) code {\n font-size: .65rem;\n white-space: nowrap;\n}\n.md-typeset table:not([class]) tr:hover{\n transition: none;\n background-color: transparent;\n box-shadow: none;\n}\n.admonition > p{\n font-size: 115%;\n}\n.admonition > p:not(first-child){\n line-height: 1.8;\n}\np code{\n white-space: nowrap;\n}\n"
},
{
"path": "guide/assets/custom.js",
"content": "window.dataLayer = window.dataLayer || [];\nfunction gtag() {\n window.dataLayer.push(arguments);\n}\ngtag('js', new Date());\ngtag('config', 'G-6XB4XDVPX3');\n"
},
{
"path": "guide/index.md",
"content": "---\ndisqus: \"False\"\n---\n\n# Extension CLI\n\nis a command-line build tool for developing \nchromium browser extensions fast and in a standardized way. It provides a systematic way \nto organize, build, test and document extension projects.
\n\n* * *\n\n## Features\n\nš„ļø **Javascript Bundling** \n
Compiles, bundles and minifies javascript files (supports ES6, ES2021 syntax)
\n\nšØ **CSS Bundling**\n
Compiles, bundles, and minifies CSS and [SASS](https://sass-lang.com/guide) files
\n\nš **Linting**\n
lint JavaScript using [ESLint](https://eslint.org/)
\n\nš¦ **ZIP Generation**\n
Generates a .zip file for uploading to extension marketplaces
\n\nš **Document Source Code**\n
Generates source code documentation using [JSDoc](https://jsdoc.app/about-getting-started.html)
\n\nāļø **Unit Testing** \n
Sets up a unit testing environment with [mocha](https://mochajs.org), [chai](https://www.chaijs.com/), [sinon-chrome](https://github.com/acvetkov/sinon-chrome) and [js-dom](https://github.com/rstacruz/jsdom-global)
\n\nāļø **Cross-Browser Compatibility**\n
develop extensions for Chrome, Edge, Firefox, Opera and Brave.
\n\n* * *\n\n\nExtension CLI is made and maintained free and voluntarily by\nopen source contributors \nbehind several popular extensions. If you find it helpful, please share, star, or contribute to its development.\n\n
\n\nStar Fork Issue Watch\n\n* * *\n\n## Getting Started\n\n**Note:** Using this CLI assumes you have Node.js installed (or [install it here](https://nodejs.org/en/download/)).\n\nCreate a new extension project:\n\n```bash\nnpx extension-cli\n```\n\nAdd CLI to an existing project:\n\n```bash\nnpm install extension-cli\n```\n\nMore detailed [getting started guide here →](https://oss.mobilefirst.me/extension-cli/01-getting-started/)\n \n\n## Command Reference\n\nCommand | Description\n--- | ---\n**`xt-build`** | Run builds; env flags: `-e prod` or `-e dev`\n**`xt-test`**| Run unit tests\n**`xt-docs`**| Generate docs\n**`xt-clean`** | Remove generated files\n**`xt-sync`**| Update project config files to latest versions supplied by this CLI\n\nMore detailed [command instructions and configuration options here →](https://oss.mobilefirst.me/extension-cli/03-xt-build/) \n\n"
},
{
"path": "guide/overrides/main.html",
"content": "{% extends \"base.html\" %}\n\n{% block disqus %}\n{% if not page.meta.disqus == \"False\" %}\n\n\n\n{% endif %}\n{% endblock %}\n"
},
{
"path": "mkdocs.yml",
"content": "site_name: Extension CLI ā¢ User Guide\nsite_description: Command-line build tools for chromium extension development.\nsite_author: '@mobilefirstllc'\ndocs_dir: ./guide\nsite_url: https://oss.mobilefirst.me/extension-cli/\nrepo_url: https://github.com/MobileFirstLLC/extension-cli\nrepo_name: \"extension-cli\"\nedit_uri: blob/master/guide/\nuse_directory_urls: true\n\nnav:\n - \"Getting Started\":\n - Intro: index.md\n - Installation: 01-getting-started.md\n - Configuration: 02-configuration.md\n - \"Commands\":\n - 'extension-cli': 08-xt-create.md\n - 'xt-build':\n - Overview: 03-xt-build.md\n - Manifest: 03-xt-build-manifest.md\n - Building scripts: 03-xt-build-scripts.md\n - Building styles: 03-xt-build-styles.md\n - Copying files: 03-xt-build-copy.md\n - Localization: 03-xt-build-locales.md\n - Static assets: 03-xt-build-assets.md\n - Commands: 03-xt-build-cmds.md\n - 'xt-clean': 04-xt-clean.md\n - 'xt-docs':\n - Configuration: 05-xt-docs.md\n - Templates: 05-xt-docs-templates.md\n - 'xt-sync': 06-xt-sync.md\n - 'xt-test': 07-xt-test.md\n - \"Releases\":\n - \"Version 1.x (latest)\": 09-release-notes.md\n - \"Version 0.x\": 09-release-notes-0.md\n - \"Developer Resources\":\n - Helpful References: 12-helpful.md\n - CLI Development:\n - Overview: 13-cli-development.md\n - Environment Setup: 13-dev-env.md\n - Editing User Guide: 14-user-guide.md\n - \"Source Code\":\n - Github: https://github.com/MobileFirstLLC/extension-cli\n\nextra_css:\n - assets/custom.css\nextra_javascript:\n - \"https://buttons.github.io/buttons.js\"\n - \"https://www.googletagmanager.com/gtag/js?id=G-6XB4XDVPX3\"\n - assets/custom.js\n\ntheme:\n name: material\n custom_dir: ./guide/overrides\n logo: '/extension-cli/assets/images/guide_icon.svg'\n favicon: '/extension-cli/assets/images/favicon.png'\n features:\n - navigation.tabs\n - navigation.tabs.sticky\n - navigation.expand\n palette:\n scheme: slate\n primary: amber\n accent: amber\n font:\n text: Inter\n extra:\n disqus: xyz # enable comments\n\nmarkdown_extensions:\n - admonition\n - pymdownx.inlinehilite\n - pymdownx.superfences\n - pymdownx.snippets\n - pymdownx.magiclink\n - pymdownx.snippets\n - pymdownx.highlight:\n use_pygments: true\n linenums: true\n linenums_style: pymdownx.inline\n - meta\n"
},
{
"path": "package.json",
"content": "{\n \"name\": \"extension-cli\",\n \"version\": \"1.2.5-alpha.0\",\n \"description\": \"CLI tool for building browser extensions\",\n \"homepage\": \"https://oss.mobilefirst.me/extension-cli\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/mobilefirstllc/extension-cli.git\"\n },\n \"bugs\": {\n \"url\": \"https://github.com/mobilefirstllc/extension-cli.git\"\n },\n \"author\": {\n \"name\": \"Mobile First\",\n \"email\": \"hello@mobilefirst.me\",\n \"url\": \"https://mobilefirst.me\"\n },\n \"funding\": [\n {\n \"type\": \"github\",\n \"url\": \"https://github.com/sponsors/MobileFirstLLC\"\n }\n ],\n \"engines\": {\n \"node\": \">=12.0.0\"\n },\n \"bin\": {\n \"extension-cli\": \"cli/xt-create.js\",\n \"xt-build\": \"cli/xt-build.js\",\n \"xt-docs\": \"cli/xt-docs.js\",\n \"xt-test\": \"cli/xt-test.js\",\n \"xt-clean\": \"cli/xt-clean.js\",\n \"xt-sync\": \"cli/xt-sync.js\"\n },\n \"keywords\": [\n \"chrome extensions\",\n \"web extensions\",\n \"browser extensions\",\n \"command line\",\n \"developer tools\",\n \"utility\",\n \"web\",\n \"extensions\",\n \"firefox\",\n \"mozilla\",\n \"add-ons\",\n \"google\",\n \"chrome\",\n \"opera\",\n \"edge\",\n \"brave\"\n ],\n \"scripts\": {\n \"test\": \"nyc mocha ./test/*.test.js --colors\",\n \"test:report\": \"npm run test -- nyc report\",\n \"test:travis\": \"npm run test && nyc report --reporter=text-lcov | coveralls\",\n \"alpha:test\": \"npx standard-version --dry-run --prerelease alpha\",\n \"patch:test\": \"npx standard-version --dry-run --release-as patch\",\n \"minor:test\": \"npx standard-version --dry-run --release-as minor\",\n \"minor:beta:test\": \"npx standard-version --dry-run --release-as minor --prerelease beta\",\n \"minor:alpha:test\": \"npx standard-version --dry-run --release-as minor --prerelease alpha\",\n \"major:alpha:test\": \"npx standard-version --dry-run --release-as major --prerelease alpha\",\n \"major:test\": \"npx standard-version --dry-run --release-as major\",\n \"alpha\": \"npx standard-version --prerelease alpha\",\n \"patch\": \"npx standard-version --release-as patch\",\n \"minor\": \"npx standard-version --release-as minor\",\n \"patch:alpha\": \"npx standard-version --release-as patch --prerelease alpha\",\n \"minor:alpha\": \"npx standard-version --release-as minor --prerelease alpha\",\n \"major:alpha\": \"npx standard-version --release-as major --prerelease alpha\",\n \"major\": \"npx standard-version --release-as major\"\n },\n \"license\": \"MIT\",\n \"standard-version\": {\n \"infile\": \".github/changelog.md\"\n },\n \"dependencies\": {\n \"@babel/preset-env\": \"7.16.11\",\n \"@babel/register\": \"7.17.7\",\n \"chai\": \"4.3.6\",\n \"chalk\": \"4.1.2\",\n \"cli-spinner\": \"0.2.10\",\n \"commander\": \"9.0.0\",\n \"del\": \"6.0.0\",\n \"eslint\": \"8.11.0\",\n \"gulp\": \"4.0.2\",\n \"gulp-change\": \"1.0.2\",\n \"gulp-clean-css\": \"4.3.0\",\n \"gulp-concat\": \"2.6.1\",\n \"gulp-htmlmin\": \"5.0.1\",\n \"gulp-jsonminify\": \"1.1.0\",\n \"gulp-load-plugins\": \"2.0.7\",\n \"gulp-merge-json\": \"2.1.1\",\n \"gulp-rename\": \"2.0.0\",\n \"gulp-sass\": \"5.1.0\",\n \"gulp-zip\": \"5.1.0\",\n \"jsdoc\": \"3.6.10\",\n \"jsdom\": \"19.0.0\",\n \"jsdom-global\": \"3.0.2\",\n \"mocha\": \"9.2.2\",\n \"nyc\": \"15.1.0\",\n \"prompts\": \"2.4.2\",\n \"sass\": \"1.49.9\",\n \"sinon\": \"13.0.1\",\n \"sinon-chrome\": \"3.0.1\",\n \"webpack-stream\": \"7.0.0\",\n \"yargs\": \"17.3.1\"\n },\n \"devDependencies\": {\n \"coveralls\": \"3.1.1\"\n }\n}\n"
},
{
"path": "renovate.json",
"content": "{\n \"labels\": [\"dependencies\"],\n \"extends\": [\"config:base\", \":disableDependencyDashboard\"]\n}\n"
},
{
"path": "requirements.txt",
"content": "mkdocs\nmkdocs-material\n"
},
{
"path": "test/README.md",
"content": "# CLI Unit Tests\n\nAll unit tests for extension-CLI are in this directory.\n"
},
{
"path": "test/cli-create.test.js",
"content": "// TODO: #21: how to require this without actually running the command?\n// const BuildScript = require('../cli/xt-build');\n\n// const expect = require('chai').expect;\n\ndescribe('create command', () => {\n\n // placeholder; replace this with actual test\n // it('...(dummy test)', async () => {\n // expect(true).to.equal(true);\n // });\n\n});\n"
},
{
"path": "test/cli-utilities.test.js",
"content": "const Utilities = require('../cli/utilities').Utilities;\nconst sinon = require('sinon');\nconst expect = require('chai').expect;\nconst fs = require('fs');\n\ndescribe('Test utility functions', () => {\n\n /**\n * Stub Node.js IO methods\n */\n // eslint-disable-next-line no-undef\n beforeEach(() => {\n sinon.stub(fs, 'readFileSync');\n sinon.stub(fs, 'existsSync');\n sinon.stub(fs, 'mkdirSync');\n sinon.stub(fs, 'readdirSync');\n sinon.stub(fs, 'writeFileSync');\n sinon.stub(fs, 'createReadStream');\n sinon.stub(fs, 'createWriteStream');\n sinon.stub(fs, 'lstatSync');\n sinon.stub(fs, 'copyFileSync');\n sinon.stub(fs, 'symlinkSync');\n sinon.stub(fs, 'readlinkSync');\n\n fs.createReadStream.returns({\n pipe: () => true\n });\n });\n\n /**\n * Restore stubbed IO methods\n */\n // eslint-disable-next-line no-undef\n afterEach(() => {\n fs.existsSync.restore();\n fs.mkdirSync.restore();\n fs.readdirSync.restore();\n fs.readFileSync.restore();\n fs.writeFileSync.restore();\n fs.createReadStream.restore();\n fs.createWriteStream.restore();\n fs.lstatSync.restore();\n fs.copyFileSync.restore();\n fs.symlinkSync.restore();\n fs.readlinkSync.restore();\n });\n\n describe('generateDirectoryName...', () => {\n\n it('...returns lowercase name', () => {\n expect(Utilities.generateDirectoryName('HELLO WORLD'))\n .to.equal('hello-world');\n expect(Utilities.generateDirectoryName('my app name'))\n .to.equal('my-app-name');\n expect(Utilities.generateDirectoryName('APP-APP'))\n .to.equal('app-app');\n expect(Utilities.generateDirectoryName('test789'))\n .to.equal('test789');\n });\n\n it('...replaces special characters with hyphen', () => {\n expect(Utilities.generateDirectoryName('MyAwesome#@Thing'))\n .to.equal('myawesome-thing');\n expect(Utilities.generateDirectoryName('````', 'xyz'))\n .to.equal('xyz');\n });\n\n it('...removes trailing hyphen', () => {\n expect(Utilities.generateDirectoryName('Hello World!!!'))\n .to.equal('hello-world');\n expect(Utilities.generateDirectoryName('awesom-o app#$%%'))\n .to.equal('awesom-o-app');\n });\n\n it('...returns default name instead of empty string', () => {\n expect(Utilities.generateDirectoryName('', 'foobar'))\n .to.equal('foobar');\n expect(Utilities.generateDirectoryName(null).length)\n .to.be.greaterThan(0);\n });\n });\n\n describe('replaceVars', () => {\n it('...replaces one variable', () => {\n expect(Utilities.replaceVars(\n 'your ${myVar}?', {myVar: 'name'}))\n .to.equal('your name?');\n });\n it('...replace two variables', () => {\n expect(Utilities.replaceVars(\n 'test ${x} ${y}', {x: '1', y: 'z'}))\n .to.equal('test 1 z');\n });\n it('...ignores non-matching keys', () => {\n expect(Utilities.replaceVars(\n 'no ${match} for this', {}))\n .to.equal('no ${match} for this');\n });\n it('...returns input if it contains no variables', () => {\n expect(Utilities.replaceVars(\n 'return me', {me: 'test'}))\n .to.equal('return me');\n });\n it('...interpolation syntax must match', () => {\n expect(Utilities.replaceVars(\n 'return {me}', {me: 'test'}))\n .to.equal('return {me}');\n expect(Utilities.replaceVars(\n 'return $me2', {me2: 'test'}))\n .to.equal('return $me2');\n });\n });\n\n describe('keyReplace', () => {\n it('...simple override', () => {\n let b = {x: 10};\n\n Utilities.keyReplace({x: 8}, b);\n expect(b.x).to.equal(8);\n });\n it('...performs union', () => {\n let b = {y: 10};\n\n Utilities.keyReplace({x: 8}, b);\n expect(b).to.have.keys(['x', 'y']);\n });\n it('...replaces array', () => {\n let b = {arr: [1, 2, 3]};\n\n Utilities.keyReplace({arr: [4, 5]}, b);\n expect(b.arr).to.have.length(2)\n .and.to.contain(4).and.to.contain(5);\n });\n it('...replaces nested properties', () => {\n let b = {c: {d: 8, e: 10}};\n\n Utilities.keyReplace({c: {e: 11}}, b);\n expect(b.c.d).to.equal(8);\n expect(b.c.e).to.equal(11);\n });\n\n it('...nested replace with addition', () => {\n let b = {b: 8, c: {y: 9}};\n\n Utilities.keyReplace({a: 1, b: 5, c: {x: 1}}, b);\n expect(b.a).to.equal(1);\n expect(b.b).to.equal(5);\n expect(b.c.x).to.equal(1);\n expect(b.c.y).to.equal(9);\n });\n });\n\n describe('iterateConfigs', () => {\n const defaultConfig = {name: 'my app', version: '0.0.1'};\n\n it('...returns default if project config is undefined', () => {\n const result = Utilities.iterateConfigs(defaultConfig, undefined);\n\n expect(result.name).to.equal(defaultConfig.name);\n expect(result.version).to.equal(defaultConfig.version);\n expect(Object.keys(result)).to.have.length(2);\n });\n\n it('...overrides defaults when override is specified', () => {\n let projectConfig = {name: 'my awesome app', version: '1.0.0'};\n const result = Utilities.iterateConfigs(defaultConfig, projectConfig);\n\n expect(result.name).to.equal(projectConfig.name);\n expect(result.version).to.equal(projectConfig.version);\n expect(Object.keys(result)).to.have.length(2);\n });\n\n it('...appends new keys when not specified in default', () => {\n let projectConfig = {special: {value: 5}};\n const result = Utilities.iterateConfigs(defaultConfig, projectConfig);\n\n expect(result.special.value).to.equal(projectConfig.special.value);\n expect(Object.keys(result)).to.have.length(3);\n });\n });\n\n describe('copyFolderSync', () => {\n\n it('...copies directory with files to new location', () => {\n fs.readdirSync.returns(['file1.txt', 'file2.txt']);\n fs.lstatSync.returns({isFile: () => true});\n Utilities.copyFolderSync('./test_dir', './test_dir_2');\n expect(fs.mkdirSync.calledOnce).to.equal(true);\n expect(fs.copyFileSync.calledTwice).to.equal(true);\n });\n\n it('...iterates nested directories recursively', () => {\n fs.readdirSync.returns(['test']);\n fs.lstatSync.onCall(0).returns({\n isFile: () => false,\n isSymbolicLink: () => false,\n isDirectory: () => true\n });\n fs.lstatSync.onCall(1).returns({\n isFile: () => false,\n isSymbolicLink: () => true\n });\n Utilities.copyFolderSync('./test_dir', './test_dir2');\n expect(fs.readdirSync.callCount).to.equal(2);\n });\n\n it('...does nothing when not file/dir/symlink', () => {\n sinon.spy(Utilities, 'copyFolderSync');\n fs.readdirSync.returns(['invalid']);\n fs.lstatSync.onCall(0).returns({\n isFile: () => false,\n isSymbolicLink: () => false,\n isDirectory: () => false\n });\n Utilities.copyFolderSync('a', 'b');\n expect(fs.copyFileSync.callCount).to.equal(0);\n expect(fs.symlinkSync.callCount).to.equal(0);\n expect(Utilities.copyFolderSync.callCount).to.equal(1);\n });\n\n });\n\n describe('copyFile', () => {\n\n it('...copies file from old location to new location', () => {\n Utilities.copyFile('./test1', './test2');\n expect(fs.createReadStream.calledOnce).to.equal(true);\n expect(fs.createWriteStream.calledOnce).to.equal(true);\n });\n\n });\n\n describe('readFile', () => {\n\n it('...calls read file', () => {\n Utilities.readFile('xyz');\n expect(fs.readFileSync.calledOnce).to.equal(true);\n });\n });\n\n describe('writeFile', () => {\n\n it('...calls write file', () => {\n Utilities.writeFile('xyz', 'text content...');\n expect(fs.writeFileSync.calledOnce).to.equal(true);\n });\n\n });\n\n describe('fileExists', () => {\n\n it('...returns true for existing file', () => {\n fs.existsSync.returns(true);\n expect(Utilities.fileExists('im_here')).to.equal(true);\n });\n\n it('...returns false when file does not exist', () => {\n fs.existsSync.returns(false);\n expect(Utilities.fileExists('nope')).to.equal(false);\n });\n\n });\n\n describe('createDir', () => {\n\n it('...will create a directory when it doesn\\'t exist', () => {\n fs.existsSync.returns(false);\n const result = Utilities.createDir('my_dir');\n\n expect(fs.mkdirSync.calledOnce).to.equal(true);\n expect(result).to.equal(true);\n });\n\n it('...returns true for empty folder', () => {\n fs.existsSync.returns(true);\n fs.readdirSync.returns({length: 0});\n const result = Utilities.createDir('empty_dir');\n\n expect(fs.mkdirSync.notCalled).to.equal(true);\n expect(result).to.equal(true);\n });\n\n it('...returns false for non-empty folder', () => {\n fs.existsSync.returns(true);\n fs.readdirSync.returns({length: 1});\n expect(Utilities.createDir('non_empty_dir')).to.equal(false);\n });\n\n });\n\n describe('readJSON', () => {\n\n it('...returns a parsed JSON object', () => {\n fs.readFileSync.returns('{ \"title\" : \"test\" }');\n const obj = Utilities.readJSON('xyz');\n\n expect(obj.title).to.equal('test');\n });\n\n it('...throws error for non-JSON format file content', () => {\n fs.readFileSync.returns('this is some plain text');\n expect(() => Utilities.readJSON('xyz')).to\n .throw('Unexpected token');\n });\n\n });\n\n describe('readAndReplaceTextFile', () => {\n\n it('...replaces single variable', () => {\n fs.readFileSync.returns('Text with ${variable} in the middle!');\n const variables = {variable: 'find me'};\n const result = Utilities.readAndReplaceTextFile('some_file', variables);\n\n expect(result).to.contain(variables.variable);\n });\n\n it('...replaces multiple variables', () => {\n fs.readFileSync.returns('Some math ${a} + ${b} = ${c}');\n const math = {a: 1, b: 2, c: 3};\n const result = Utilities.readAndReplaceTextFile('my_file', math);\n\n expect(result).to.contain('1 + 2 = 3');\n });\n\n });\n\n describe('readAndReplaceJSONFile', () => {\n\n it('...replaces variables in an object', () => {\n fs.readFileSync.returns('{ \"name\":\"${name}\", \"version\" : \"v-${version}\" }');\n const values = {name: 'my_app', version: '1.0.0'};\n const jsonString = Utilities.readAndReplaceJSONFile('manifest', values);\n const obj = JSON.parse(jsonString);\n\n expect(obj.name).to.equal(values.name);\n expect(obj.version).to.equal('v-1.0.0');\n });\n\n it('...replaces nested variables', () => {\n fs.readFileSync.returns('{ \"config\": { \"count\" : \"${n}\" }}');\n const values = {n: 10};\n const result = Utilities.readAndReplaceJSONFile('manifest', values);\n\n expect(result).to.contain('10');\n });\n\n });\n});\n"
}
]![\"\"](\"https://raw.githubusercontent.com/MobileFirstLLC/extension-cli/master/guide/assets/images/guide.svg\")
\n