ng-barrel

CLI tool to add generated Angular files to barrel files

Usage no npm install needed!

<script type="module">
  import ngBarrel from 'https://cdn.skypack.dev/ng-barrel';
</script>

README

ng-barrel npm version

ng-barrel is a small CLI tool, that takes the output of ng generate commands and adds the new service / component / ... to the closest index.ts file.

Installation

npm i -g ng-barrel

You can now pipe ng generate output into ng-barrel or ngb.

Example

└───src
    ├───app
    │   └───foo
    │       └───components
    |           └───index.ts
    ...
$ ng generate component foo/components/example Example | ng-barrel
Angular:
        CREATE src/app/foo/components/example/example.component.html (26 bytes)
        CREATE src/app/foo/components/example/example.component.spec.ts (635 bytes)
        CREATE src/app/foo/components/example/example.component.ts (273 bytes)
        CREATE src/app/foo/components/example/example.component.css (0 bytes)
        UPDATE src/app/app.module.ts (4077 bytes)

NgBarrel:
        export * from './example/example.component'; >> src/app/foo/components/index.ts
└───src
    ├───app
    │   └───foo
    │       └───components
    │           │   index.ts
    │           └───example
    │                   example.component.css
    │                   example.component.html
    │                   example.component.spec.ts
    │                   example.component.ts
    ...
$ cat src/app/foo/components/index.ts
export * from './example/example.component';

How it works

ng-barrel takes the CLI output and searches for newly created .ts files (excluding .spec.ts) and adds all their exports to the closest barrel.

To find the closest barrel the tools starts from the newly created file and traverses upwards. The first barrel file will be used.

By default it searches for index.ts. You can change this behaviour via --barrel / -b. With this option you can use it for Angular libraries as well:

ng g s services/foo Foo --project=my-lib | ng-barrel --barrel public_api.ts

Creating missing barrels

You can also pass a relative path as an argument to specify where a barrel file should be created. If this argument is specified it takes priority over tree traversing.

If a barrel file at the specified path already exists, the export will be appended. Otherwise a new file will be written.

The argument should be a path relative to the created TS files.

$ ng g s foo/services/Data data | ngb .
Angular:
        CREATE src/app/foo/services/data.service.spec.ts (323 bytes)
        CREATE src/app/foo/services/data.service.ts (133 bytes)

NgBarrel:
        export * from './data.service'; >> src\app\foo\services\index.ts (NEW)
└───src
    ├───app
    │   └───foo
    │       ├───components
    │       │   └─── ...
    │       └───services
    │               data.service.spec.ts
    │               data.service.ts
    │               index.ts
    ...