https://github.com/sirap-group/generate-swap-generator
Generate Your Own ESNext+StandardJS+Mocha Ready NodeJS Generators In Seconds!
https://github.com/sirap-group/generate-swap-generator
babel esnext generate generategenerator generator javascript nodejs standard swap swap-project
Last synced: about 1 month ago
JSON representation
Generate Your Own ESNext+StandardJS+Mocha Ready NodeJS Generators In Seconds!
- Host: GitHub
- URL: https://github.com/sirap-group/generate-swap-generator
- Owner: sirap-group
- License: mit
- Created: 2018-01-11T13:51:26.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2018-01-18T11:26:18.000Z (over 8 years ago)
- Last Synced: 2025-10-18T22:51:05.935Z (8 months ago)
- Topics: babel, esnext, generate, generategenerator, generator, javascript, nodejs, standard, swap, swap-project
- Language: JavaScript
- Homepage: https://sirap-group.github.io/generate-swap-generator
- Size: 6.26 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
−− generate-swap-generator −−
−− Generate your own ESNext/StandardJS/UnitTest Ready Generators −−
## Demo example
Check out the following repository to see what a project generated with `generate-swap-generator` looks like out the box:
> [https://github.com/sirap-group/generate-swap-generator-example](https://github.com/sirap-group/generate-swap-generator-example)
## Installation
### Global install to use the generator as a standarlone CLI (recommanded)
```sh
$ yarn gobal add generate-swap-generator
```
or
```sh
$ npm install --global generate-swap-generator
```
### Local install to use as a `generate` plugin or sub-generator
> You should first visit the generator framework, [generate](https://github.com/generate/generate) to understand how generators, subgenerators and plugins work.
```sh
$ yarn add generate-swap-generator
```
or
```sh
$ npm install --save generate-swap-generator
```
## Usage
### As a standalone generator (recommanded)
```sh
$ generate-swap-generator
```
Should scaffold the project in the destination path you choose when asked.
### Generated files
```
.
├─┬ src/
| ├─┬ tests/
| | ├─ generator.test.js
| | └─ plugin.test.js
| ├─┬ assets/
| | ├─┬ img/
| | | └── ...
| | └─┬ templates/
| | └── example.txt
| └─┬ lib/
| └─ generator.js
├── contributing.md
├── .editorconfig
├── .git
├── .gitattributes
├── .gitignore
├── .gitlab-ci.yml
├── index.js
├── generator.js
├── LICENSE
├── node_modules
├── .npmrc
├── package.json
├── README.md
└── .travis.yml
```
### As a generate plugin (if you know what you are doing)
> You should first visit the generator framework, [generate](https://github.com/generate/generate) to understand how generators, subgenerators and plugins work.
```js
import generateSwapGenerator from 'generate-swap-generator'
import isValid from 'is-valid-app'
export default function (app) {
if (!isValid(app, 'generate-my-generator')) return
app.use(generateSwapGenerator)
// ... your generator's stuff
}
```
Then you can use directly any `generate-swap-generator` tasks as a `generate-my-generator` task.
```
$ gen my-generator:keywords
```
Should run `generate-swap-generator:keywords` on your own generator instance.
### As a generate sub-generator (if you know what you are doing)
> You should first visit the generator framework, [generate](https://github.com/generate/generate) to understand how generators, subgenerators and plugins work.
```js
import generateSwapGenerator from 'generate-swap-generator'
import isValid from 'is-valid-app'
export default function (app) {
if (!isValid(app, 'generate-my-generator')) return
app.register('swap-generator', generateSwapGenerator)
// ... your generator's stuff
}
```
Then you can acces easily any `generate-swap-generator` tasks as a `generate-my-generator` sub-generator task.
```
$ gen my-generator.swap-generator:keywords
```
Should run `generate-swap-generator:keywords` on your own generator instance.
## API
**@TODO: document the API here**
## Contributing
### Codebase
The codebase is written using the [ESNext Specification](https://github.com/hemanth/es-next) (ECMAScript Stage 0), following the [StandardJS Code Style](https://standardjs.com/)
[](https://github.com/hemanth/es-next)
[](https://github.com/standard/standard)
[](https://eslint.org)
[](https://babeljs.io)
[](https://yarnpkg.com/en/)
We use:
- [Yarn](https://yarnpkg.com/fr/) to handle npm dependencies,
- [ESNext CLI](https://github.com/esnext/esnext) to transform ESx code to ESNext,
- [Babel CLI](https://babeljs.io/) to transpile ESNext code to node/browser compatible javascript,
- And [Standard CLI](https://www.npmjs.com/package/standard) + [ESLint](https://eslint.org) to lint or format ESNext codebase.
### Contribution guide
> See the [contribution guide](CONTRIBUTING.md) in a separated document.
### Development
#### Global dependencies
Get the latest node engine (example with `nvm`):
```sh
$ nvm install lts/carbon
```
Install yarn from npm (for development only):
```sh
$ npm install --global yarn
```
All the rest of the development dependencies are local.
#### Clone and install
Clone the repo and install dependencies:
```sh
$ git clone git@github.com:sirap-group/generate-swap-generator.git
$ cd generate-swap-generator
$ yarn install
```
#### Running test
Finally, run the test pipeline:
```sh
$ yarn pipeline:test
```
#### Available yarn scripts
| Task Command | Task description |
|---|---|
| `yarn clear` | Delete the `./build/` and `./dist` repositories |
| `yarn lint` | Lint source files |
| `yarn lint:esnext` | Lint ESNext source files |
| `yarn build` | Build the whole distribution |
| `yarn build:assets` | Build all the assets |
| `yarn build:assets:img` | Build the images assets |
| `yarn build:assets:templates` | Build the generator's templates |
| `yarn build:lib` | Build only the lib |
| `yarn build:tests` | Build only the tests |
| `yarn build:docs` | **[TODO]** Build only the docs |
| `yarn test` | Run the tests in `./dist/tests/` |
| `yarn tests` | An alias for `yarn test` |
| `yarn travis` | Run the travis script |
| `yarn docs` | **[TODO]** Serve the docs |
| `yarn pipeline` | Run the complete pipeline |
| `yarn pipeline:test` | Run the required jobs to run the tests, then run the tests |
| `yarn pipeline:build` | Run the required jobs to build the dist, then build the dist |
| `yarn pipeline:docs` | **[TODO]** Run the required jobs to serve the docs, then serve the docs |
| `yarn pipeline:build:tests` | Run the required jobs to build the tests, then build the tests |
| `yarn pipeline:build:lib` | Run the required jobs to build the lib, then build the lib |
| `yarn pipeline:build:docs` | **[TODO]** Run the required jobs to build the docs, then build the docs |
| `yarn release` | An alias to `yarn release:patch` |
| `yarn release:prerelease` | Release and publish a new semver version (x.y.z-rc+1)|
| `yarn release:patch` | Release and publish a new patch semver version (`x.y.z+1`)|
| `yarn release:minor` | Release and publish a new minor semver version (`x.y+1.z=0`)|
| `yarn release:major` | Release and publish a new major semver version (`x+1.y=0.z=0`)|
#### Develop in BDD mode
> **B.D.D.** means **Behavior-Driven-Development**
The project is ready to code in BDD mode. Just run the `bdd` yarn command:
```
$ yarn bdd
```
The project will be lint, built, the BDD unit tests will be run, and the process will watch for any file changes to loop over the previous tasks (`lint`, `build`, `test`, `watch`).
#### Releasing a new version
The task `yarn pipeline:build` generate a `./dist` folder in the repository's root directory but this folder is not part of the git repository (there is an entry in the `.gitignore` file). However the dist folder is included in the `package.json#files` field.
Thus to release a new, lets say, "patch" version, just run:
```sh
$ yarn release:patch
```
The whole build pipeline is run locally (lint, transpile, test) and then a new git tag and a new npm tag are pushed up.
## Related projects
### SWAP Generators
* [generate-swap-generator-example](https://npmjs.com/generate-swap-generator-example) An example repository to illustrate to result of generating a custom generator with generate-swap-generator [github](https://github.com/sirap-group/generate-swap-generator-example) | [homepage](https://sirap-group.github.io/generate-swap-generator-example/)
* [generate-swap-project](https://npmjs.com/generate-swap-project) Generate An ES.Next/StandardJS/UnitTest Ready, Github or Gitlab Project in Seconds! − A generator for SWAP projects [github](https://github.com/sirap-group/generate-swap-project) | [homepage](https://sirap-group.github.io/generate-swap-project/)
### Generator library stack
* [generate](https://npmjs.com/generate) A new command line tool and developer framework for scaffolding out GitHub projects. Generate offers the robustness and configurability of Yeoman, the expressiveness and simplicity of Slush, and more powerful flow control and composability than either [github](https://github.com/generate/generate) | [homepage](https://generate.github.io/generate/)
* [base](https://www.npmjs.com/package/base): Framework for rapidly creating high quality node.js applications, using plugins like building blocks | [homepage](https://github.com/node-base/base "Framework for rapidly creating high quality node.js applications, using plugins like building blocks")
* [update](https://www.npmjs.com/package/update): Be scalable! Update is a new, open source developer framework and CLI for automating updates… [more](https://github.com/update/update) | [homepage](https://github.com/update/update "Be scalable! Update is a new, open source developer framework and CLI for automating updates of any kind in code projects.")
* [verb](https://www.npmjs.com/package/verb): Documentation generator for GitHub projects. Verb is extremely powerful, easy to use, and is used… [more](https://github.com/verbose/verb) | [homepage](https://github.com/verbose/verb "Documentation generator for GitHub projects. Verb is extremely powerful, easy to use, and is used on hundreds of projects of all sizes to generate everything from API docs to readmes.")
* [composer](https://www.npmjs.com/package/composer): API-first task runner with three methods: task, run and watch. | [homepage](https://github.com/jonschlinkert/composer)
* [engine](https://www.npmjs.com/package/engine): Template engine based on Lo-Dash template, but adds features like the ability to register helpers… [more](https://www.npmjs.com/package/engine) | [homepage](https://github.com/jonschlinkert/engine)
* [template](https://www.npmjs.com/package/template): Render templates using any engine. Supports, layouts, pages, partials and custom template types. Use template… [more](https://www.npmjs.com/package/template) | [homepage](https://github.com/jonschlinkert/template)
## Author
**Rémi Becheras**
* [github.com/rbecheras](https://github.com/rbecheras)
* [twitter/rbecheras](https://twitter.com/rbecheras)
## License
Copyright © 2018 [Groupe SIRAP](https://github.com/sirap-group)
This software is open source software under the terms of the MIT license.
See [LICENSE](LICENSE)
---
This project was generated by
generate-swap-project, a project by
SIRAP Group