# @jib/codegen

> Include yeoman generators with @jib/cli projects

Latest version **0.2.5** (published 2021-07-19) · MIT license · 0 weekly downloads

## Install

```sh
npm install @jib/codegen
pnpm add @jib/codegen
yarn add @jib/codegen
bun add @jib/codegen
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.2.5 |
| Published | 2021-07-19 |
| First published | 2018-10-04 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 4 |
| Unpacked size | 31.8 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Matt Vander Vliet |
| Maintainers | mvandervliet |
| Keywords | cli, typescript, command, generator, yeoman |

## Links

- npm: https://www.npmjs.com/package/@jib/codegen
- Repository: https://github.com/jibcli/codegen
- Issues: https://github.com/jibcli/codegen/issues
- npm.io page: https://npm.io/package/@jib/codegen

## Dependencies (4)

- [yeoman-generator](https://npm.io/package/yeoman-generator.md) ^5.4.0
- [yeoman-environment](https://npm.io/package/yeoman-environment.md) ^3.5.1
- [@types/yeoman-generator](https://npm.io/package/@types/yeoman-generator.md) ^5.2.1
- [@types/yeoman-environment](https://npm.io/package/@types/yeoman-environment.md) ^2.10.4

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 0.2.5 (latest) — 2021-07-19
- 0.2.4 — 2020-07-28
- 0.2.1 — 2020-04-29
- 0.2.0 — 2020-04-29
- 0.1.4 — 2019-04-17
- 0.1.2 — 2019-01-18
- 0.1.1 — 2018-12-14
- 0.1.0 — 2018-11-30
- 0.0.2 — 2018-10-08
- 0.0.1 — 2018-10-04

## README

# The jib CodeGen Plugin

Adds flexible, simplified support for [`yeoman`](http://yeoman.io) (source code)
generators within a [`@jib/cli`](https://github.com/jibcli/cli) project.


[![npm version](https://badge.fury.io/js/%40jib%codegen.svg)](https://badge.fury.io/js/%40jib%codegen)
[![wercker status](https://app.wercker.com/status/2e560723c44622e5b42623fc55c613f9/s/master "wercker status")](https://app.wercker.com/project/byKey/2e560723c44622e5b42623fc55c613f9)
[![codecov](https://codecov.io/gh/jibcli/codegen/branch/master/graph/badge.svg)](https://codecov.io/gh/jibcli/codegen)
[![GitHub license](https://img.shields.io/github/license/jibcli/codegen.svg)](https://github.com/jibcli/codegen/blob/master/LICENSE)
[![install size](https://packagephobia.now.sh/badge?p=@jib/codegen)](https://packagephobia.now.sh/result?p=@jib/codegen)

Technically this package could be used as a standalone plugin to other CLI
frameworks, however it is designed to work in accordance with the `@jib/cli`
opinions and applicaton structure.

## Usage

```shell
npm install @jib/codegen
```

### Implementation

This plugin adds source code generators shipped directly within the CLI
itself. Integrating the plugin with `@jib/cli` project follows a _slightly_
different pattern than what one might expect if already familiar with
yeoman.

#### Structure

With jib, or TypeScript in general, the `generators` code is part of `src`
whereas `templates` is somewhere outside that in the hierarchy. This is because
`src` is the TypeScript source code and is _normally_ excluded when the project
is built/packaged/published. In the case of yeoman, `templates` can contain
anything, and should also be distributed with the project build.

```text
├── package.json
├── src
│   ├── commands
│   │   └── init
│   │       └── project.ts
│   └── generators
│       └── project
│           ├── index.ts
│           └── project.ts
└── templates
    └── project
        └── README.md
```

> In the tree above, there is a single generator called `project`, and corresponding
subdirectories in `src/generators/project` as well as `templates/project`.

#### In Commands

Considering the [structure](#structure) shown above, one would implement a generator
in the following way:

```typescript
// commands/init/project
import { Plugin, Command, BaseCommand } from '@jib/cli';
import { GeneratorEnv } from '@jib/codegen';

@Command({
  description: 'Sample command usage of @jib/codegen plugin',
  allowUnknown: true, // allows any options from the generator to be passed
})
export class InitProject extends BaseCommand {

  // load the plugin
  @Plugin(GeneratorEnv)
  private _codegen: GeneratorEnv;

  public help(): void {
    // get usage and append help text
    const usage = this._codegen.usage('project')[0];
    this.ui.outputSection(`Generator Options`, this.ui.grid(usage.options));
  }

  public async run(options: any, ...args: any[]) {
     // do things with this._gen
     await this._codegen.load() // load the generator enviroment
      .run('project', options, args) // run the `project` generator
  }
}
```

#### Generator Code

This project adds only a few simple abstractions onto the
[`Generator`](http://yeoman.io/generator/Generator.html) class maintainted by Yeoman,
and does not change standard behavior in any way. As such, you're encouraged to
reference their docs accordingly.

While not required, it's yeoman expects an `index.ts` file in each generator directory
that exports **only** the `Generator` implementation. This might look something
like the following:

```typescript
// generators/project/index.ts
import { ProjectGenerator } from './project';
export = ProjectGenerator;
```

```typescript
// generators/project/project.ts
import { BaseGenerator, IBaseGeneratorOptions } from '@jib/codejen';

export interface IProjectGeneratorOptions extends IBaseGeneratorOptions {
  name: string;
  description: string;
}

export class ProjectGenerator extends BaseGenerator<IProjectGeneratorOptions> {
  constructor(...args: any[]) {
    super(...args);
    this.option('name', {type: String, description: 'The new project name'})
      .option('description', {type: String, description: 'Description for the project'})
  }
  // ...
}
```

This approach is particularly useful with generator
[composability](http://yeoman.io/authoring/composability.html), where child
generators have exported interfaces for their options, etc.

## TODOs

- [ ] Create `@Generator()` decorator mapping `@jib/cli` option/argument annotations to the generator abstract

---
_Source: https://npm.io/package/@jib/codegen · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._