config

Sumor Cloud ツール。
詳細なドキュメント
Config Loader は yaml と json ファイルをサポートしています。 ディレクトリ内のすべてのファイルをロードできます。
ファイルは指定された形式に自動的に変換されます。

インストール

npm i @sumor/config --save

前提条件

Node.JS のバージョン

Node.JS バージョン 16.x 以上が必要です。

Node.JS の ES モジュールの要件

このパッケージは ES モジュールで書かれているため、package.json ファイル内の以下のコードを変更してください。

{
  "type": "module"
}

使用方法

エントリーメソッド

load

import { load } from '@sumor/config'

• root: string - ルートディレクトリ
• name: string - ファイル名
• ext: string - 変換するファイル拡張子 (yml、json)

search

ディレクトリ内のすべてのファイルをロードします。

• root: string - ルートディレクトリ
• suffix: string - 設定にロードされるオブジェクトの接尾辞 (js はパスのみロードされます)

import { meta } from '@sumor/config'

const config = await meta(process.cwd(), ['js', 'sql'])

/*
デモディレクトリ構造
- root
  - car.json
  - car.sql
  - ship.js
  - plane.yml
*/

// 以下のようにすべての設定ファイルをロードします
/*
{
  car: {
    name: 'car',
    sql: "..."
  },
  ship: {
    name: 'ship'
    js: '<root>/ship.js'
  },
  plane: {
    name: 'plane'
  }
}
*/

レガシーメソッド

find

import { find } from '@sumor/config'

• root: string - ルートディレクトリ
• category: string - カテゴリ名
• ext: string - 変換するファイル拡張子 (yml、json)

findReference

import { findReference } from '@sumor/config'

• root: string - ルートディレクトリ
• references: array - 参照ファイル拡張子 (vue、js)
• ext: string - 変換するファイル拡張子 (yml、json)

設定ファイルをロードする

import { load } from '@sumor/config'

const config1 = await load(process.cwd(), 'demo')
// ルートディレクトリ内の demo.yml または demo.json をロードします

const config2 = await load(process.cwd(), 'demo', 'yaml')
// ルートディレクトリ内の demo.yml または demo.json をロードし、yaml 形式のファイルに変換します

設定ファイルを検索する

import { find } from '@sumor/config'

const config = await find(process.cwd(), 'entity')
// ルートディレクトリ内のすべての *.entity.yml または *.entity.json をロードします
/*
 * 例:
 *   car.entity.yml、bike.entity.json
 *   {
 *       "car": {...}
 *       "bike": {...}
 *   }
 * */

他のファイルから設定ファイルを検索する

たとえば .vue、.js ファイルなど、同じ名前の設定ファイルを持つファイルから

import { findReference } from '@sumor/config'

const config = await findReference(process.cwd(), ['vue', 'js'])
// ルートディレクトリ内の *.entity.yml または *.entity.json で、*.vue や *.js の名前と同じファイルをすべてロードします
/*
 * 例:
 *   car.entity.yml、bike.entity.json
 *   car.vue、bike.js
 *   {
 *       "car": {...}
 *       "bike": {...}
 *   }
 * */