Overview

What is the Bugzilla C# Proxy

Bugzproxy is a C# based assembly that provides access to a Bugzilla server, using the WebService interface of Bugzilla 3.0 or newer (at least 3.0.2 recommended)

The assembly provides an object oriented API for accessing a Bugzilla server, allowing other tools to be easily built on top of this assembly. This includes command line tools, SCM integration tools, and MonoDevelop and Microsoft Visual Studio plugins.

News

2008.01.17: A new release: version 0.2.0. Now supports the AppendComment call in very recent versions of Bugzilla, thanks to Tsahi Asher. Note, that the API, mostly the namespace, has changed for this version, and applications build against the earlier release will probably not compile with this. The API should follow .net conventions a bit closer now, and most changes are of the "search/replace" kind - there should be no major changes.

2008.01.03: Updated samples to use a common set of options. All sample programs now use the Bugzilla landfill server, using a default account. Changed the Linux compilation to use xbuild on the csproj file.

2007.11.26: Lots of changes are currently going in to the SVN repos, so the API is in somewhat of a flux.

2007.11.20: Migrated CVS to SVN at sourceforge. You need to use the new SVN path at https://bugzproxy.svn.sourceforge.net/svnroot/bugzproxy now.

2007.06.29: Updated CVS. Now with ssl support, provided by JP Rosevear

2007.06.28: Updated CVS. Now has VS 2005 build support, and a new LoggedIn property. Examples against landfill may be broken. New "Users" section below.

2007.02.26: Bugzilla 3.0RC1 released. Please use the CVS version of bugzproxy to access an installation of 3.0RC1.

2006.11.28: CVS updated with support for landfill.bugzilla.org/bugzilla-tip

2006.11.28: First release

Requirements

The WebService support in Bugzilla is still under development. To actually use this assembly, you need an installation of Bugzilla 3.0.2 or newer.

You also need the xml-rpc.net assembly from http://www.xml-rpc.net/. This assembly was developed with version 2.1.0 of xml-rpc.net.

Additionally, this assembly requires the .NET 2.0 platform (because it uses nullable types, which are not part of .NET 1.x).

License

This code is licensed under the LGPL, v.2. This goes for all code files, even those with no license included. All files are copyright Dansk BiblioteksCenter A/S, 2006 & 2007.

Downloading

The project lives, apart from these html pages at sourceforge. You can access the SVN repository and file releases from there.

Building The Assembly

The assembly has been developed under Linux, using Mono (1.2.6) and is known to work with Windows.

A .csproj file is provided for Windows. For Linux you either use this directly (with xbuild or MonoDevelop) or use the supplied Makefile, which calls xbuild.

Testing/trying It Out

A number of simple command line programs are included that serves both as test programs, and as an example on how to use the assembly. The programs are referenced from the documentation.

Note, that the sample programs "ServerInfo", "ListProducts", "ListBug" and "ListBugs" by default access the Bugzilla CVS Head Test Server. This allows you to test Bugzproxy against a live Bugzilla installation, without having to install one yourself. However, as the Bugzilla CVS Head Test Server is, by its very nature, unstable, you may experience some weirdness, when running these programs. The server is updated on an hourly basis, so if experience weirdness, please try running the programs again in a few minutes.

Status

As the main purpose of this assembly is to provide an object oriented API, the most important aspect of the implementation is the design of the API. This is currently evolving. The code itself is mostly a rather thin layer, utilizing the xml-rpc.net assembly for all the hard work.

Support

You can find the mailing list via sourceforge.

The main developer is Mads Bondo Dydensborg (mbd (aaaaa) dbc.dk). Feel free to mail him for questions (although the mailing list is the preferred method of contact, I am very happy to hear from you. It is a lot easier to argue that DBC should sponsor this project as an open source project, when I get some contribution or feedback from users).

Documentation

The assembly is documented using a Doxygen, and you can find the documentation here.

Users

Last updated January 2008.