gen_template_ecto_service v0.2.0 Mix.Gen.Template.EctoService

EctoService: a mix gen template for ecto stand alone projects

You use this repo to bootstrap your elixir service that needs a Postgres database. We are using Ecto to manage data migration.

This is an alternative for mix new, based on Dave Thomas’ extensible templating engine for creating project templates.

You use it in combination with the mix gen mix task, which you will need to install.

New Project Template

    mix gen ecto_service «name» [ --into «path» ] [--app[lication] «app»] [--module «module»]

Install

This template is installed using the template.install mix task. Projects are generated from it using the mix gen task.

So, before using templates for the first time, you need to install these two tasks:

$ mix archive.install mix_templates
$ mix archive.install mix_generator

Then you can install this template using

$ mix template.install gen_template_ecto_service

Use

To create a new project run:

$ mix gen ecto_service «project_name»

«project_name» is both the name of the subdirectory that will hold the project and the name that will be given to the application. This affects entries in mix.exs as well as the names of the main file in lib/ and the skeleton test in test/. The application module name will be the camelcase version of «name».

By default the subdirectory will be created under your current directory; you can change this with the --into option:

$ mix gen ecto_service «project_name» --into some/other/dir

Variants

The application’s start function is created in lib/«name»/application.ex, along with a basic supervisor.

You can change the name used for the application:

$ mix gen ecto_service «project_name» --app[lication] «app»

The original «project_name» parameter will be the name used for the directory, and «app» will be used when creating file names in that directory and when customizing the file contents.

Finally, you can override the name used for the application module:

$ mix gen ecto_service «project_name» --module «Module»

«Module» must be a valid Elixir module name or alias.

More Info On mix gen

You can watch a video of Dave Thomas explaining the new generator project, and how to use it.

You can also look at his projects related to project generation.

  • https://github.com/pragdave/mix_templates
  • https://github.com/pragdave/gen_template_template
  • https://github.com/pragdave/gen_template_project

Summary

Functions

Return the name or path of a template that this template is based upon. That template will be processed first, and then this one will be executed

Override this function to do any cleanup after your template has been copied into the user project. One use of this is to remove unwanted files created by a template upon which this template is based

Return the name of this template as an atom. This is the name passed to the gen command

Return the list of options supported by this template

Return the short description of this template, or nil

Return the absolute path to the tree that is to be copied when instantiating this template. This top-level dir will typically just contain a directory called $APP_NAME$

Functions

based_on()

Return the name or path of a template that this template is based upon. That template will be processed first, and then this one will be executed.

clean_up(assigns)

Override this function to do any cleanup after your template has been copied into the user project. One use of this is to remove unwanted files created by a template upon which this template is based.

name()

Return the name of this template as an atom. This is the name passed to the gen command.

options()

Return the list of options supported by this template.

short_desc()

Return the short description of this template, or nil.

source_dir()

Return the absolute path to the tree that is to be copied when instantiating this template. This top-level dir will typically just contain a directory called $APP_NAME$.