6.1.3.1 sendchange

This command is used to tell the buildmaster about source changes. It is intended to be used from within a commit script, installed on the VC server. It requires that you have a PBChangeSource (see PBChangeSource) running in the buildmaster (by being set in c['change_source']).

     buildbot sendchange --master MASTERHOST:PORT --auth USER:PASS \
             --who COMMITTER FILENAMES..

The auth option specifies the credentials to use to connect to the master, in the form user:pass. If the password is omitted, then sendchange will prompt for it. If both are omitted, the old default (username "change" and password "changepw") will be used. Note that this password is well-known, and should not be used on an internet-accessible port.

The master and who arguments can also be given in the options file (see .buildbot config directory). There are other (optional) arguments which can influence the Change that gets submitted:

--branch

(or option branch) This provides the (string) branch specifier. If omitted, it defaults to None, indicating the “default branch”. All files included in this Change must be on the same branch.

--category

(or option category) This provides the (string) category specifier. If omitted, it defaults to None, indicating “no category”. The category property can be used by Schedulers to filter what changes they listen to.

--project

(or option project) This provides the (string) project to which this change applies, and defaults to ”. The project can be used by schedulers to decide which builders should respond to a particular change.

--repository

(or option repository) This provides the repository from which this change came, and defaults to ”.

--revision

This provides a revision specifier, appropriate to the VC system in use.

--revision_file

This provides a filename which will be opened and the contents used as the revision specifier. This is specifically for Darcs, which uses the output of darcs changes --context as a revision specifier. This context file can be a couple of kilobytes long, spanning a couple lines per patch, and would be a hassle to pass as a command-line argument.

--property

This parameter is used to set a property on the Change generated by sendchange. Properties are specified as a name:value pair, separated by a colon. You may specify many properties by passing this parameter multiple times.

--comments

This provides the change comments as a single argument. You may want to use --logfile instead.

--logfile

This instructs the tool to read the change comments from the given file. If you use - as the filename, the tool will read the change comments from stdin.

--encoding

Specifies the character encoding for all other parameters, defaulting to 'utf8'.