Git Product home page Git Product logo

babel-plugin-wildcard's Introduction

babel-plugin-wildcard

Allows you to import all files from a directory at compile-time.

Installation

$ npm install babel-plugin-wildcard

Usage

Via .babelrc (Recommended)

.babelrc

{
  "plugins": ["wildcard"]
}

Via CLI

$ babel --plugins include script.js

Via Node API

require('babel').transform('code', {
  plugins: ['wildcard']
});

Example

With the following folder structure:

|- index.js
|- dir
    |- a.js
    |- b.js
    |- c.js

the following JS:

import * as Items from './dir';

will be compiled to:

const Items = {};
import _wcImport from "./dir/a";
Items.A = _wcImport;
import _wcImport1 from "./dir/b";
Items.B = _wcImport1;
import _wcImport2 from "./dir/c";
Items.C = _wcImport2;

meaning you will be able to access the items using Items.A and Items.B.


You can also selectively choose files using:

import { A, C } from "dir/*";

which in the above example would convert to:

import A from "./dir/a";
import C from "./dir/c";

The above is like doing:

import * as temp from "dir";
const { A, C } = temp;

There is also simple Glob support so given the directory structure:

|- index.js
|- dir
    |- a.js
    |- a.spec.js
    |- b.js
    |- b.spec.js

this import:

import * as tests from './dir/*.spec';

will compile to:

import aSpec from './dir/a.spec';
import bSpec from './dir/b.spec';

Files are automatically camel-cased and in the import statements the extensions are clipped unless specified otherwise (see below)

Information

  • File extensions are removed in the resulting variable. Dotfiles will be imported without their preceding . (e.g. .foo -> Foo or foo depending on settings)
  • in an import { ... } from 'foo/*', the identifiers inside { ... } are the same as what their name would be if you were to import the whole directory. This means it is the files' names' camel-cased and extensions removed etc. by default (depending on settings of course).

Options

babel-plugin-wildcard allows you to change various settings by providing an options object by using the following instead:

{
    plugins: [
        ['wildcard', { options }]
    ]
}

where { options } is the options object. The following options are available:

exts

By default, the files with the following extensions: ["js", "es6", "es", "jsx"], will be imported. You can change this using:

{
    plugins: [
        ['wildcard', {
            'exts': ["js", "es6", "es", "jsx", "javascript"]
        }]
    ]
}

nostrip

By default, the file extension will be removed in the generated import statements, you can change this using:

{
    plugins: [
        ['include', {
            'nostrip': true
        }]
    ]
}

This is useful when the extension of your source files is different from the outputted ones. (e.g. .jsx to .js).

noCamelCase

By default, the name will be automatically camel cased, the following regex is used to extract the words, those words then have their first letter capitalized and are joined together:

[A-Z][a-z]+(?![a-z])|[A-Z]+(?![a-z])|([a-zA-Z\d]+(?=-))|[a-zA-Z\d]+(?=_)|[a-z]+(?=[A-Z])|[A-Za-z0-9]+

you can disable this behavior using:

{
    plugins: [
        ['include', {
            'noCamelCase': true
        }]
    ]
}

Extensions are still removed (except dotfiles, see "Information").

babel-plugin-wildcard's People

Contributors

drgould avatar pamidur avatar puck7744 avatar raybenefield avatar simding avatar vihanb avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.