azu / rc-config-loader

Load config from .{product}rc.{json,yml,js} file

rc-config-loader

Load config from .{product}rc.{json,yml,js} file.

It is a Node.js library for loading .textlintrc, .eslintrc, .stylelintrc etc...

Features

Find and load a configuration object from:

• a package.json property if it is needed
• a JSON or YAML, JS "rc file"
  • .<product>rc or .<product>rc.json or .<product>rc.js or.<product>rc.yml, .<product>rc.yaml
• TypeScript support
  • Includes .d.ts

Difference

with MoOx/rc-loader

• Safe API
  • rc contains shabang in .js file
• Enhance Error message

with cosmiconfig

• Sync loading
  • cosmiconfig@3+ support sync option
• Built-in TypeScript support
  • comisconfig@6* is written by TypeScript

If you want to async support and customize loader, recommended to use cosmiconfig.

Install

Install with npm:

npm install rc-config-loader

Usage

API

export interface rcConfigLoaderOption {
    // does look for `package.json`
    packageJSON?:
        | boolean
        | {
              fieldName: string;
          };
    // if config file name is not same with packageName, set the name
    configFileName?: string;
    // treat default(no ext file) as some extension
    defaultExtension?: string | string[];
    // where start to load
    cwd?: string;
}
/**
 * Find and load rcfile, return { config, filePath }
 * If not found any rcfile, throw an Error.
 * @param {string} pkgName
 * @param {rcConfigLoaderOption} [opts]
 * @returns {{ config: Object, filePath:string } | undefined}
 */
export declare function rcFile<R extends {}>(pkgName: string, opts?: rcConfigLoaderOption): {
    config: R;
    filePath: string;
} | undefined;

rcFile return { config, filePath } object.

• config: it is config object
• filePath: absolute path to config file

Note:

• rcFile function return undefined if the config file is not found
• rcFile throw an Error if the config file content is malformed (causing a parsing error)

Recommenced usage:

import { rcFile } from "rc-config-loader"

function loadRcFile(rcFileName){
    try {
        const results = rcFile(rcFileName);
        // Not Found
        if (!results) {
            return {};
        }
        return results.config;
    } catch (error) {
        // Found it, but it is parsing error
        return {} ; // default value
    }
}
// load config
const config = loadRcFile("your-application");
console.log(config); // => rcfile content

It will check these files and return config file if found it.

• .your-applicationrc.json
• .your-applicationrc.yml
• .your-applicationrc.yaml
• .your-applicationrc.js
• [optional] package.json
  • if packageJSON option is enabled

Example

import { rcFile } from "rc-config-loader"
// load .eslintrc from current dir
console.log(rcFile("eslint"));

// load .eslintrc from specific path
console.log(rcFile("eslint", {
    configFileName: `${__dirname}/test/fixtures/.eslintrc`
}));
/*
config: { extends: 'standard',
  rules:
   { 'comma-dangle': [ 2, 'always-multiline' ],
     'arrow-parens': [ 2, 'as-needed' ] } }
filePath: ${__dirname}/test/fixtures/.eslintrc
 */

// load property from package.json
console.log(rcFile("rc-config-loader", {
    packageJSON: {
        fieldName: "directories"
    }
}));
/*
config: { test: 'test' }
filePath: /path/to/package.json
 */

// load .eslintrc from specific dir
console.log(rcFile("eslint", {
    cwd: `${__dirname}/test/fixtures`
}));

// load specific filename from current dir
console.log(rcFile("travis", {configFileName: ".travis"}));
/*
config: { sudo: false, language: 'node_js', node_js: 'stable' }
filePath: /path/to/.travis
 */

// try to load as .json, .yml, js
console.log(rcFile("bar", {
    configFileName: `${__dirname}/test/fixtures/.barrc`,
    defaultExtension: [".json", ".yml", ".js"]
}));

// try to load as foobar, but .foobarrc is not found
console.log(rcFile("foorbar")); // => undefined

// try to load as .json, but it is not json
// throw SyntaxError
try {
    rcFile("unknown", {
        // This is not json
        configFileName: `${__dirname}/test/fixtures/.unknownrc`,
        defaultExtension: ".json"
    })
} catch (error) {
    console.log(error);
    /*
    SyntaxError: Cannot read config file: /test/fixtures/.unknownrc
    */
}

Users

• textlint

Changelog

See Releases page.

Running tests

Install devDependencies and Run npm test:

npm i -d && npm test

Contributing

Pull requests and stars are always welcome.

For bugs and feature requests, please create an issue.

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request :D

Author

• github/azu
• twitter/azu_re

License

MIT © azu

Acknowledgement

• zkochan/rcfile: Loads library configuration in all possible ways

Difference

• support multiple defaultExtension

rc-config-loader's Issues

Support ESM `"module":true` projects

When loading *rc.js files that contain export const or export default results in failing with errors.

rc-config-loader doesn't view config file in current path

Accorind sources, if I haven't options rc-config-loader use default path for search - current directory

const configFileName = opts.configFileName || `.${pkgName}rc`;

So I use loader without options and get undefined. Code available here

1. git clone https://github.com/ravecat/mendeleev.git --single-branch --branch rc-config-loader-issue
2. yarn

aTry to use in src/common/Media/responsive/index.js

/* eslint-disable */
import { css } from "styled-components";

const rcfile = require("rc-config-loader");

const responsive = (property, resolution) => {
  console.log(rcfile('sct'))

  return css`
    @media (max-width: ${resolution}px) {
      ${property};
    }
  `;
}

export default responsive;

Probably it's webpack settings relative with resolve options, but I use relative path, not absolute

How about supporting TypeScript file?

Writing configuration files in TypeScript is useful in preventing typographical and type errors.

import type {Config} from 'jest';

const config: Config = {
  verbose: true,
};

export default config;

https://jestjs.io/ja/docs/configuration

In cosmiconfig, TypeScript is supported by the third-party cosmiconfig-typescript-loader.
How about supporting TypeScript file?

TypeScript

It is a advantage.

Support JSONC

cf. mocha/config.js at master · mochajs/mocha

Doesn't work well with webpack

Because of dynamic require webpack can't work well with this package.

Can it be replaced with e.g. fs.readFile?

Module not found: Can't resolve 'module'

Try to use cosmiconfig without any use

const rcfile = require("rc-config-loader");

and get error

./node_modules/rc-config-loader/node_modules/require-from-string/index.js
Module not found: Can't resolve 'module' in '/home/max/project/mendeleev/node_modules/rc-config-loader/node_modules/require-from-string'

"rc-config-loader": "^2.0.2",
node: 8.12.0

support for ts files

i understand that the file would require something like ts-node or else, but even with deno the loading of ts files would be native so, do you think it should be supported in that lib?