> [!WARNING]
> This package now has a new home: https://www.npmjs.com/package/refmerge [https://github.com/doublenot/refmerge]


refs

Compile and merge YAML, JSON or INI config files together through file path references

$3

``bash
$ npm install -g refs
`

$3

#### Template(s):
`yaml
AWSTemplateFormatVersion: '2010-09-09'

Resources:
- $ref: ./relative/path/to/file.yaml
`
`yaml
RolePolicies:
$ref: ./resources/role-policies.yaml
`
`yaml
Type: 'AWS::IAM::Policy'
Properties:
PolicyName: custom-role
Roles:
- custom-role
PolicyDocument:
Version: '2012-10-17'
Statement:
-
Sid: PassRole
Effect: Allow
Resource:
-
'Fn::Join':
- ""
-
- 'arn:aws:iam::'
-
Ref: 'AWS::AccountId'
- ':role/*'
Action:
- 'iam:PassRole'
`

#### Code:
`javascript
'use strict';

const path = require('path');
const refs = require('refs');

const templateDir = ${__dirname}/../templates;
const buildDir = ${__dirname}/../build;
const inputTemplate = path.resolve(${templateDir}/template.yaml);
const outputFile = path.resolve(${buildDir}/output-template.yaml);

try {
refs(inputTemplate, outputFile)
.then((results) => {
console.log(\n File written: ${results.outputFile});
});
} catch (e) {
console.error(e.message);
console.error(e.stack);
}
`

#### Or cli:
`bash
$ refs -o ./build/output.yaml ./templates/main.yaml
`

#### Output:
`yaml
AWSTemplateFormatVersion: '2010-09-09'
Resources:
- RolePolicies:
Type: 'AWS::IAM::Policy'
Properties:
PolicyName: custom-role
Roles:
- custom-role
PolicyDocument:
Version: '2012-10-17'
Statement:
- Sid: PassRole
Effect: Allow
Resource:
- 'Fn::Join':
- ''
- - 'arn:aws:iam::'
- Ref: 'AWS::AccountId'
- ':role/*'
Action:
- 'iam:PassRole'
``