config

Sumor Cloud 도구입니다.
자세한 문서를 참조하세요.
Config Loader는 yaml 및 json 파일을 지원합니다. 디렉토리에 있는 모든 파일을 로드할 수 있습니다.
그리고 파일을 지정된 형식으로 자동으로 변환할 수 있습니다.

설치

npm i @sumor/config --save

Prerequisites

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 - config로 로드할 개체 접미사 (js는 경로만 로드)

import { meta } from '@sumor/config'

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

/*
데모 디렉토리 구조
- root
  - car.json
  - car.sql
  - ship.js
  - plane.yml
*/

// 아래와 같이 모든 config 파일을 로드합니다.
/*
{
  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)

Config 파일 로드

import { load } from '@sumor/config'

const config1 = await load(process.cwd(), 'demo')
// root 디렉토리에서 demo.yml 또는 demo.json을 로드합니다.

const config2 = await load(process.cwd(), 'demo', 'yaml')
// root 디렉토리에서 demo.yml 또는 demo.json을 로드하고 YAML 형식으로 변환합니다.

Config 파일 찾기

import { find } from '@sumor/config'

const config = await find(process.cwd(), 'entity')
// root 디렉토리에서 모든 *.entity.yml 또는 *.entity.json을 로드합니다.
/*
 * 예시:
 *   car.entity.yml, bike.entity.json
 *   {
 *       "car": {...}
 *       "bike": {...}
 * }
 * */

다른 파일에서 Config 파일 찾기

예를 들어 .vue, .js 파일 등과 같이 같은 이름의 config 파일을 가진 경우

import { findReference } from '@sumor/config'

const config = await findReference(process.cwd(), ['vue', 'js'])
// root 디렉토리에서 *.vue 또는 *.js와 같은 이름의 *.entity.yml 또는 *.entity.json을 모두 로드합니다.
/*
 * 예시:
 *   car.entity.yml, bike.entity.json
 *   car.vue, bike.js
 *   {
 *       "car": {...}
 *       "bike": {...}
 * }
 * */