Getting the Source

From Scantegrity Wiki

The Scantegrity voting system source code is maintained using the Subversion version control system. From the free book about Subversion:

"Subversion is a free/open-source version control system. That is, Subversion manages files and directories over time. A tree of files is placed into a central repository. The repository is much like an ordinary file server, except that it remembers every change ever made to your files and directories. This allows you to recover older versions of your data, or examine the history of how your data changed. In this regard, many people think of a version control system as a sort of “time machine”."

The subversion repositories are located here:

http://scantegrity.org/svn/

Everyone should be able to browse the current revision of the repositories using the link above. If not, please submit a bug.

OS Download Instructions[edit]

To download the latest version of the source directly to your hard drive you can use one of the following methods:

  1. Windows users: can use TortoiseSVN to check out a working copy of the repository.
  2. Mac OS X Users: can use SC Plugin to check out a working copy of the repository.
  3. Eclipse Users: can use the Subclipse plug in to check out a working copy of the repository.
  4. Other users: If you install the "command line tools" for Subversion, you can checkout a working copy of a repository in a directory called "scantegrity" with the following command:
svn checkout http://scantegrity.org/svn/ scantegrity

For more information, see the free book about it.

Compiling[edit]

The trunk can be compiled with maven2. In general, running mvn compile will compile the source code, and mvn assembly:assembly will compile the source code into a jarfile with dependencies included so that it can be run with java -jar <jarfile>.

Note that you may have to mvn install some of the components before others will compile. This is true for jsane and zxing, which are other open source projects that we've included, and also true for common which is a common dependency across all the other projects.

Other Resources[edit]

If you are having trouble with compiling or getting the source code, the best place to ask is on the developers list. If you wish to contribute to the project, you should learn how to submit a patch.