MAGUS is a tool for automatically generating magic source files based on a manifest.
go install github.com/ismtabo/magus/v2@latestmagus generate [manifest] --dir outputArguments:
manifest: path to the manifest file.
Flags:
--dir: directory where the magic source file will be generated. Defaults to the current directory.--dry-run: whether to perform a dry run or not. Defaults tofalse.--overwrite,-w: whether to overwrite existing files or not. Defaults tofalse.--clean: whether to clean the output directory before generating the magic source file or not. Defaults tofalse.--var: list of variables to be used in the manifest. This flag can be used multiple times. E.g:--var name=foo --var version=1.0.0.--var-files: list of files containing variables to be used in the manifest. This flag can be used multiple times. E.g:--var-files ./vars.yaml --var-files ./vars.json.
The manifest is a YAML file that describes the magic source file to be generated. It contains the following fields:
name: Name of the magic source file to be generated.version: Version of the magic source file to be generated.root: Root directory of the magic source file to be generated.variables: List of variables to be used in the magic source file to be generated.casts: List of casts to be used in the magic source file to be generated.
Variables are used to define the values of the magic source file to be generated. They are defined as a list of key-value pairs, where the key is the name of the variable and the value is the value of the variable.
Variables can be of three types:
literal: The value of the variable is a literal value.env: The value of the variable is the value of an environment variable.template: The value of the variable is a template that will be rendered using the variables defined in the manifest.
Casts are used to define the casts of the magic source file to be generated. They are defined as a record with the following fields:
to: output directory relative torootwhere the cast will be generated.from: input source where the cast will be generated from.variables: list of variables to be used in the cast.
Additionally, the following fields can be used to generate casts conditionally:
if/unless: condition to be evaluated to determine if the cast should be generated.
Furthermore, the following fields can be used to generate casts for each element of a list defined in a variable:
each: list of casts to be generated for each element of the list defined in the variable. This field must render into a valid JSON array. To do so, the helperto_jsoncan be used.as: alias of theeachelement in the cast.include/omit: condition to be evaluated to determine if theeachelement should be included in the cast.
Sources are used to define the sources of the magic source file to be generated. Currently, only the template source is supported. It is defined as template string to be render using text/template with the variables defined in the manifest.
Magus extends the basic golang text/template engine by including slim-sprig. This package provides a set of helper functions that can be used in the YAML manifest. Helper functions are used in the render of paths, templates, and conditions. In addition, magus add the following helpers:
snake: converts a string into snake case.kebab: converts a string into kebab case.camel: converts a string into camel case.pascal: converts a string into pascal case.constant: converts a string into constant case.
version: "1"
name: "go"
root: "."
casts:
README.md:
to: "./README.md"
from: |
# {{ .name | title }}
{{ .description }}
{{ .usage }}
main.go:
to: "./main.go"
from: |
package main
import (
"fmt"
)
func main() {
fmt.Println("Hello, world!")
}
.gitignore:
to: "./.gitignore"
from: |
{{ range .gitignore }}
{{ . }}
{{ end }}Given the following variables, this manifest will generate a React component with tests and stories.
name: Name of the component.stories: Whether to generate stories or not.
version: "1"
name: "react"
root: "./{{ .name | kebab }}"
casts:
index.js:
to: "./index.jsx"
from: |
import React from 'react';
import PropTypes from 'prop-types';
const {{ .name | pascal }} = (props) => {
return (
<div>
{{ .name | pascal }}
</div>
);
};
{{ .name | pascal }}.propTypes = {
name: PropTypes.string,
};
{{ .name | pascal }}.defaultProps = {
name: '{{ .name | pascal }}',
};
export default {{ .name | pascal }};
index.test.js:
to: "./index.test.js"
from: |
import React from 'react';
import { render } from '@testing-library/react';
import {{ .name | pascal }} from './index';
describe('{{ .name | pascal }}', () => {
it('should render the component', () => {
const { container } = render(<{{ .name | pascal }} />);
expect(container).toMatchSnapshot();
});
});
index.stories.js:
to: "./index.stories.jsx"
from: |
import React from 'react';
import {{ .name | pascal }} from './index';
export default {
title: '{{ .name | pascal }}',
component: {{ .name | pascal }},
};
const Template = (args) => <{{ .name | pascal }} {...args} />;
export const Default = Template.bind({});
Default.args = {
name: '{{ .name | pascal }}',
};
if: "{{ .stories }}"See LICENSE for more information.
- Add support for more sources (e.g.: files, or remote manifests).
- Add support for more helpers (e.g.: shell scripts defined in the manifest).
- Add support for more casts (e.g.:
copy). - Add support for spells (aka actions) (e.g.:
append,format,compile, ...).
To contribute to this project, please fork the repository and submit a pull request.
See CHANGELOG for more information.
This project uses SemVer for versioning. For the versions available, see tags.