use WebService::FogBugz::XML; # Config generally read from ~/.fb.conf my $fb = WebService::FogBugz::XML->new; my $case = $fb->get_case(1234);
WebService::FogBugz::XML provides an OO interface to the FogBugz XML API. You can use this to search for cases, change what you're working on, etc. It's particularly useful to build external reporting on development activity.
Documentation for the API itself is here: FogBugz XML API Doucmentation
Configuration is expected to be found in ~/.fb.conf. If it's not there, you'll be prompted for url, email and password. The password should not be stored in the file, since it's only used to generate an auth_token.
Example config file:
url = https://www.mysite.com/fogbugz/api.asp email = firstname.lastname@example.org
The URL should probably end in api.asp.
An auth token is stored in ~/.fb_auth_token. This is a persistent login key. Once this exists, neither email nor password are required again.
There are attributes available for email, password and url on the object itself, but it's a bad pattern to hard code a password ever.
Where to find the configuration file.
Where to find and store the auth token file.
The URL to the fogbugz API. Should include the protocol, and the full path to the api. e.g. https:://www.mysite.com/fogbugz/api.asp
The email address to logon to Fogbugz with
The password address to logon to Fogbugz with
The auth token to use when talking to fogbugz
Fetches a case from fogbugz.
Returns a WebService::FogBugz::XML::Case object.
Called when there's no token present. You shouldn't ever need to call this.
Log out of the fogbugz service.
Retrieves an arbitrary command. Accepts a hashref of arguments.
Many more methods to wrap up for convenience.
gbjk: Gareth Kirwan <email@example.com>
djh: Dominic Humphries <firstname.lastname@example.org>
2012 Thermeon Worldwide PLC
This library is free software. You can redistribute it and/or modify it under the same terms as Perl itself.