Mozbot/Download

From MozillaWiki
Jump to: navigation, search

Mozbot and all of its source code are available for download. Mozbot is licensed under the Mozilla Public License, and is thus free to use and modify under most circumstances.

You can download a tarball of the latest current stable version of Mozbot or older versions from mozilla.org's FTP server.

The current release will always be:

If you have a tarball, you can update to the newest release using the CVS instructions below. This is a good way to update if you've made local changes, as CVS will attempt to merge your changes with the current release (although you may have to do some merging yourself if it finds conflicts between what you changed and what we changed - see the CVS documentation for details on conflict resolution).

Be sure to see the Installation section of the mozbot documentation (there's also a copy included in the tarball).

If you want to know what's changed from one version to the next, view the changelogs for Mozbot (generated directly from the raw CVS checkin messages).

Older Versions

Mozbot CVS

If you'd like to have some additional flexibility, you can get mozbot from mozilla.org's anonymous CVS server. Of course, with this added flexibility comes a little bit more complexity.

Update Existing Install

NOTE: You do not need to shut down (or even restart) your bot during this process. Changes will take effect automatically!

If you have a tarball, it is already primed for being updated via CVS. This allows updating to a newer version without downloading a new tarball. The first thing you need to do is login to the CVS server anonymously.

$ cd <mozbot install directory>
$ cvs login
(Logging in to anonymous@cvs-mirror.mozilla.org)
CVS password: anonymous

If you have an existing install that you'd like to update, you can use the cvs update command. However, you must use either the -A or a -r flag.</p>

If you wish to update to the most recent stable release, you should use the Mozbot_Stable tag.

$ cvs update -rMozbot_Stable -dP

If you want to run the latest CVS tip (at your own risk), then use the -A flag.

$ cvs update -A -dP

You can also checkout older versions using CVS tags. All version tags since 2.2 follow the format of MOZBOT-2_2. The syntax is the same as above for the Mozbot_Stable tag.

If you would like to submit patches, we'd prefer that you do so against the tip rather than a stable version. If you can't do your patch against the tip, then we'd rather have it against a release than not have it at all.

Initial Checkout

If you do not have mozbot yet then you must use the cvs checkout -d mozbot mozilla/webtools/mozbot command. This is more difficult than downloading the tarball because of mozbot's location in mozilla.org's CVS repository is three levels deep.

The first thing you have to do is log in to the CVS repository anonymously.

$ export CVSROOT=:pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot
$ cvs login
(Logging in to anonymous@cvs-mirror.mozilla.org)
CVS password: anonymous

After that, you can either checkout the CVS tip or a specific release tag.

$ cvs checkout -d mozbot mozilla/webtools/mozbot

If you wish to get the most recent release out of CVS, you should use the Mozbot_Stable tag.

$ cvs checkout -d mozbot -rMozbot_Stable mozilla/webtools/mozbot

The mozbot files will now be in the mozbot subdirectory of the current working directory.

Note: The commands above use the syntax for bash like shells. Other shells, such as csh or windows, should be the same for everything but setting the environment variable. Sample syntax for these two shells are shown below.

csh: % setenv CVSROOT ":pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot"
win: > SET CVSROOT=":pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot"

Any other shell's syntax is left as an exercise for the reader.