Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

236 lines (143 sloc) 6.027 kB

Name

sqitch-add-change - Add a deployment change

Synopsis

  sqitch [options] add-change [<template-options>] name

Description

Add a new deployment change. This will result in the creation of a new script files with the --extension extension in the --deploy-dir, --revert-dir, and --test-dir directories. The content of these files is determined by the evaluation of templates. By default, system templates in $(etc_path)/templates are used. These can be overridden by a single user by creating templates in ~/.sqitch/templates/ See "Templates" for details.

Options

-r
--requires

Name of a change that is required by the new change. May be specified multiple times.

-c
--conflicts

Name of a change that conflicts with the new change. May be specified multiple times.

-s
--set

Set a variable name and value for use in the templates. The format must be name=value, e.g., --set comment='This one is for you, babe.'.

--template-directory

Location to look for the templates. If none is specified, add-change will first look in ~/.sqitch/templates/ for each template, and fall back on $($etc_prefix)/templates.

--deploy-template
--revert-template
--test-template

Path to the template for the given change script. Defaults to the individual templates found in --template-directory.

--no-deploy
--no-revert
--no-test

Do not generate the named script.

--deploy
--revert
--test

Generate the named script. These are not mutually exclusive.

Templates

Sqitch contains a very simple set of templates for generating the deploy, revert, and test scripts. By default, it uses system-wide templates installed in ($etc_path)/templates; call sqitch --etc-path to find out where, exactly. Individual templates may be overridden on a user bases by copying templates to ~/.sqitch/tempates and making modifications. They may also be overridden by using the --tmplaet-directory option, as well as the template-specific options.

Syntax

The syntax of the templates is the very simple but limited language provided by Template::Tiny, which is limited to:

[% %]

This is the directive syntax. By default, the return value of the expression is output:

  -- Deploy [% change %]

You can add - to the immediate start or end of a directive tag to control the whitespace chomping options:

  [% IF foo -%]    # remove trailing newline
  We have foo!
  [%- END %]       # remove leading newline
[% IF %]
[% IF %] / [% ELSE %]
[% UNLESS %]

Conditional blocks:

  [% IF transactions  %]
  BEGIN;
  [% ELSE %]
  -- No transaction, beware!
  [% END %]
[% FOREACH item IN list %]

Loop over a list of values:

  [% FOREACH item IN requires -%]
  -- requires: [% item %]
  [% END -%]

Variables

Sqitch defines three variables for all templates. Any number of additional variables can be added via the --set option, like so:

  sqitch add-change --set transations=1 --set schema=foo

Any number of variables may be specified in this manner. You may then use those variables in custom templates. Variables that appear multiple times will be passed to the templates as lists of values for which you will likely want to use [% FOREACH %]. If the templates do not reference your variables, they will be ignored. Variables may also be specified in a [add-change "variables] config section (see "Configuration Variables"). Variables specified via --set will override configuration variables.

The three core variables are:

change

The name of the change being added.

requires

A list of required changes as passed via one or more instances of the --requiers option.

conflicts

A list of conflicting changes as passed via one or more instances of the --requiers option.

Configuration Variables

add-change.template_directory

Directory in which to find the templates which should be named deploy.tmpl, revert.tmpl, and test.tmpl. This will override looking for user- or system-specific templates, and may in turn be overridden by the --template-directory, --deploy-template, --revert-template, and --test-template options.

add-change.with_deploy
add-change.with_revert
add-change.with_test

Boolean variable indicating whether or not to generate the specified script when adding a change. They are all enabled by default. If you've disabled them but wish to create them for a given call to add-change, use the appropriate option: --deploy, --revert, or --test.

add-change.deploy_template
add-change.revert_template
add-change.test_template

Location of individual templates. My be overridden by the appropriate option: --deploy-template, --revert-template, or --test-template.

[add-change.variables]

A section defining template variables. Useful if you've customized templates with your own variables and want project-, user-, or system-specific defaults for them.

Files

Unless explicitly told where to find templates via --template-directory or, as appropriate, --deploy-template, --user-template or --test-template, Sqitch looks in two locations for templates: A system-wide location and a user-specific location:

$(etc_path)/templates/deploy.tmpl
$(etc_path)/templates/revert.tmpl
$(etc_path)/templates/test.tmpl

The system-wide templates for creating deploy, revert, and test scripts.

~/.sqitch/templates/deploy.tmpl
~/.sqitch/templates/revert.tmpl
~/.sqitch/templates/test.tmpl

User-specific templates to override the system-wide templates.

Sqitch

Part of the sqitch suite.

Jump to Line
Something went wrong with that request. Please try again.