= #django !DjangoBot =

The #django IRC channel has bot that aides everyone with some pretty basic tasks. It takes the identify of the nickname '''!DjangoBot'''. It is currently written using the [http://twistedmatrix.com/trac/ Twisted] networking library and can be found at http://code.google.com/p/djangobot/. It is written and maintained by [http://djangopeople.net/brosner/ Brian Rosner].

== Features ==

=== The ```help``` command ===

There is now a ```help``` command that gives you help. You can pass in the name of other commands to get their help.

{{{
/msg DjangoBot help who
<DjangoBot> who <nickname> [<nickname> ...]
<DjangoBot> Sends back the real name, location and URL for the nickname if the person is registered on djangopeople.net.
}}}

=== Trac Ticket/Changeset Linking ===

It is very common for someone to reference a ticket or changeset in the IRC room. The !DjangoBot will handle the linking for you if you follow the basic syntax it requires. To reference a ticket simply use the Trac syntax '''#13'''. The same applies to changesets, r530. The !DjangoBot does not work with the square bracket notation due to IRC nickname collisions for those who use square brackets around their numbered name.

There are two commands ```ticket``` and ```changeset``` that when sent to the bot in a private message will result in returning a link. Here is an example:

{{{
/msg DjangoBot ticket 13 2070
<DjangoBot> http://code.djangoproject.com/ticket/13
<DjangoBot> http://code.djangoproject.com/ticket/2070

/msg DjangoBot changeset 530
<DjangoBot> http://code.djangoproject.com/changeset/530
}}}

=== !DjangoPeople Integration ===

The excellent [http://www.djangopeople.net/ djangopeople.net] website created by [http://djangopeople.net/simon/ Simon Willison] and [http://djangopeople.net/natbat/ Natalie Downe] is integrated with the bot. If you send a privmsg to the bot you can find out a bit more information about the peers you talk with in #django. Simply do:

{{{
/msg DjangoBot who brosner
}}}

The bot will then go out and fetch information about '''brosner'''. This works with any IRC handle that is associated to a profile on !DjangoPeople. The ```who``` command also accepts multiple nicknames separated by spaces. You can also do:

{{{
/msg DjangoBot who brosner empty
}}}

=== Multiple Channel Support ===

The bot has the ability to live in more than one channel. This will be useful during sprints when #django and #django-sprint channels are in use.

=== Ticket/Changeset Channel Notification ===

The bot will now notify when tickets are opened/closed/reopened and changesets to the Django source code. It follows this [http://code.djangoproject.com/timeline?from=02%2F15%2F08&daysback=1&ticket=on&changeset=on&update=Update timeline RSS feed].

== Future Features ==

=== Dpaste Channel Notification ===

There is the possibility of doing some form of integration with the official Django pastebin, [http://dpaste.com dpaste.com]. There is no word on what the integration will look like, but a good future feature.

== Reporting Bugs ==

If you happen to come across a bug with the bot, please head over to http://code.google.com/p/djangobot/issues/list and check if it has already been issued, if not please create a new issue!