nosyd

Summary

Nosyd is a minimalist personal command line friendly CI server. It is primarily meant to run on your developer machine. Nosyd tracks multiple projects and automatically runs your build whenever one of the monitored files of the monitored projects has changed.

How it works

Nosyd is an auto-testing tool, also called personnal Continuous Integration server. It is a daemonization of Jeff Wrinkler's original nosy script [1].

Nosyd sits in the background and can monitor multiple projects. This means you only need one instance of nosyd on your desktop. Today nosyd rebuilds projects if one of the files it monitors has changed. After it has built the project, nosyd tries to notify you of the build results using Desktop notifications. When it can, nosyd uses information from the build to report accurate information (number of failed tests, etc). Nosyd then goes back waiting for a project to be rebuilt.

Nosyd version has a command line interface, configuration files, supports multiple builders and desktop notifiers notifiers.

Features

• automatically run your build whenever one of the monitored files of the monitored projects has changed
• filesets to select files monitored
• support multiple builders (nosetests, maven2, trial, django)
• notify using Gnome's notification library on Linux, Growl on Mac OS X
• per project configuration to override defaults
• command line interface to add/remove/list jobs
• persists daemon configuration using files and links
• logging

Usage

• install in path and run nosyd in a terminal to start the daemon. The terminal should be kept open, you will see the build output there
• optionally create a ~/.nosyd/config to override some of the configuration
• optionaly create a .nosy file in your project's directory. If that file changes, the file will be reloaded at next build.
• add/remove the monitored project by using --add/--remove [path] options
  ** you can also do it manually by adding/removing symlinks into the .nosyd/jobs/ directory
  ln -s /path/to/your/project ~/.nosyd/jobs/

Layout

~/.nosyd/config optional main nosyd configuration ~/.nosyd/stop temporary file created to indicate nosyd should stop ~/.nosyd/jobs/a_link link to a directory on your file system representing a monitored project

/path/to/your/project/.nosy optional project specific configuration for nosyd

Configurations

Default values for the various configuration files:

~/.nosyd/config

[nosyd]
#logging=warning
#check_period=1

/path/to/your/project/.nosy

[nosy]
#type=default
#monitor_paths   (project specific)
#logging=warning (for the project and associated builder and notifier)
#check_period    (when ran standalone, i.e. with --local)
#virtualenv_activate (for django builder, path to the activate script)

Help

Usage: nosyd [options]

Options: --version show program's version number and exit -h, --help show this help message and exit -a, --add Start monitoring the specified or current directory -r, --remove Stop monitoring the specified or current directory -l, --list List the monitored projects -c, --clean Clean the projects nosyd can't track anymore (links point to nowhere) -1, --local Run the standalone nosyd on the specified or current directory -s, --stop Stops the running server, if any

Default behavior: Start nosyd

Comments & bugs to [email protected]

Links

[1] http://jeffwinkler.net/2006/04/27/keeping-your-nose-green/ [2] http://douglatornell.ca/software/python/Nosy-1.0.tar.gz