ffizer

ffizer is a files and folders initializer / generator. Create any kind (or part) of project from template(s).

keywords: file generator, project template, project scaffolding, quick start, project bootstrap, project skeleton

• Features
• Usages
  • Install
  • via homebrew
  • via github releases
  • via cargo
  • Run
  • Self upgrade the executable
  • Apply a template
  • Authoring a template
• Templates
• Build
• Alternatives
  • Generic
  • Specialized

Features

• A native executable (cli)
  • Install via download a standalone single file on system (no requirements like python, ruby, nodejs, java, ...).
  • Run as fast enough project generator.
  • Run with dry mode (useful to test).
  • Support self-upgrade.
• A rust library
  • Can be included into other tool
• Templates Authoring
  • Can be used for any file & folder generation (no specialization to one ecosystem).
  • Can start as simple as a folder to copy "as is".
  • Can use the [Handlebars] template syntax for file content, extended with functions:
  • To transform strings (toUpperCase, toLowerCase, Capitalize,...)
  • To retrieve content via http get (like .gitignore from gitignore.io, license from spdx)
  • ...
  • Can replace variables part in file and folder's name
  • Can be composed of other templates (applied as layer)
  • Can ignore file / folder under conditions
  • Can store the content at the root of the folder or under the sub-folder template
• Templates Hosting
  • On a local folder
  • On a hosted git repository (public / private, github / bitbucket/ gitlab / ...)
  • At the root of the repository
  • In a sub-folder of the repository
  • In any revision (branch, tag, commit)

Suggestions are welcomes ;-)

Usages

Install

sh curl https://raw.githubusercontent.com/ffizer/ffizer/master/scripts/getLatest.sh | sh

via homebrew

sh brew tap ffizer/ffizer brew install ffizer-bin ffizer upgrade

via github releases

Download the binary for your platform from github releases, then un-archive it and place it your PATH.

via cargo

sh cargo install ffizer --force --features cli

Run

```txt ➜ ffizer --help

ffizer 1.2.0 https://github.com/ffizer/ffizer ffizer is a files and folders initializer / generator. Create any kind (or part) of project from template.

USAGE: ffizer [FLAGS]

FLAGS: -h, --help Prints help information -V, --version Prints version information -v, --verbose Verbose mode (-v, -vv (very verbose / level debug), -vvv) print on stderr

SUBCOMMANDS: apply Apply a template into a target directory help Prints this message or the help of the given subcommand(s) upgrade Self upgrade ffizer executable ```

Self upgrade the executable

```sh ➜ ffizer upgrade --help

ffizer-upgrade 1.2.0 https://github.com/ffizer/ffizer Self upgrade ffizer executable

USAGE: ffizer upgrade

FLAGS: -h, --help Prints help information -V, --version Prints version information ```

Apply a template

```sh ➜ ffizer apply --help

ffizer-apply 1.2.0 https://github.com/ffizer/ffizer Apply a template into a target directory

USAGE: ffizer apply [FLAGS] [OPTIONS] --destination --source

FLAGS: -h, --help Prints help information --offline in offline, only local templates or cached templates are used -V, --version Prints version information --x-alwaysdefaultvalue should not ask for valiables values, always use defautl value or empty (experimental)

OPTIONS: --confirm ask confirmation 'never' or 'always' [default: never] -d, --destination destination folder (created if doesn't exist) --rev git revision of the template [default: master] --source-subfolder path of the folder under the source uri to use for template -s, --source uri / path of the template ```

• use a local folder as template

  sh ffizer apply --source $HOME/my_templates/tmpl0 --destination my_project

• use a remote git repository as template

  sh ffizer apply --source https://github.com/ffizer/template_sample.git --destination my_project

  output

  ```sh Configure variables

  projectname: myproject

  Plan to execute

  • mkdir "my_project/"
  • mkdir "myproject/dir1"
  • copyraw "myproject/dir1/file11.txt"
  • mkdir "myproject/dir2myproject"
  • copyraw "myproject/dir2myproject/file12.txt"
  • copyraw "myproject/file1.txt"
  • copyrender "myproject/file2.txt"
  • keep "myproject/file2.txt"
  • copyrender "myproject/file3.txt"
  • copyraw "myproject/file4myproject.txt"
  • copyrender "myproject/file5myproject.txt"
  • copyraw "myproject/file6.hbs" ```

Authoring a template

see Template Authoring - ffizer WIP

Templates

• ffizer/templates_default: the default collections of templates for ffizer (WIP)
• davidB31 / cg-starter-multi-rust · GitLab Project template for Multi-Bot in Rust on CodinGame.
• davidB/templates: repository to host the my collections of templates to used with ffizer.
• github repo tagged ffizer-template
• samples (used for test, demo) templatesdefault)
  • test1
  • test_2 (demo of usage of gitignore.io)
  • ffizer/template_sample: a simple template for ffizer used for demo and test

Build

sh cargo install cargo-make --force cargo make ci-flow

Update CHANGELOG.md

sh cargo make update-changelog git add CHANGELOG.md git commit -m ':memo: (CHANGELOG) update'

Release a new version by bump patch (or minoror major)

sh cargo make publish -- patch --dry-run cargo make publish -- patch

Alternatives

Generic

• Cookiecutter, lot of templates, require python + pip + install dependencies on system (automatic)
• Cookiecutter — Similar projects
• sethyuan/fgen: A file generator library to be used to generate project structures, file templates and/or snippets. Templates are based on mustache. require nodejs
• project_init in rust, use mustache for templating but I have some issues with it (project template creation not obvious, github only) I could contributes but I have incompatible requirements.
• skeleton, good idea but no template file, more like a script.
• porteurbars, very similar but I discovered it too late.

Specialized

specialized to a platform, build tool,...

• The web's scaffolding tool for modern webapps | Yeoman, nodejs ecosystem
• JHipster - Generate your Spring Boot + Angular/React applications! require java, dedicated to java web ecosystem, optionnated template (not generic)
• Giter8 require java + Conscript
• Typesafe activator, require java, target Scala ecosystem
• Maven – Archetypes require java + maven, target maven ecosystem
• cargo-generate, limited capabilities, target rust/cargo ecosystem