Table of Contents

Using pinesol in the Evergreen IRC channel

pinesol green is considered a "concierge bot," or program that listens for commands sent to it through IRC. pinesol then takes specific actions for the commands it receives.

General Usage Commands

When exploring these commands, we recommend chatting with pinesol privately. This prevents the main channel from getting all of your back and forth with the bot.

Getting a list of available pinesol commands

Example question directed at kmlussier

@list

Here is what pinesol will reply with

your_irc_nickname: Admin, Anagram, Assorted2, Blame, Bugtracker, Channel, ChannelLogger, Config, Dunno, Encyclopedia, Games, Git, Herald, Insult, Karma, Later, LoveHate, MARC, Math, MeetBot, Misc, Note, Owner, Praise, Quote, RSS, Reply, Seen, Status, Time, Todo, Twitter, User, and Weather

Getting information about a command

Get more information about the @marc command

@help marc

Here is what pinesol will reply with

your_irc_nickname: (marc look up field or field/subfield combo in MARC docs) -- eg. @marc 245 or @marc 245 a

Getting MARC tag information

Use the @marc command with a tag number (and optionally a subfield value) to get information on that tag

@marc 856

Here is what pinesol will reply with

your_irc_nickname: The information needed to locate and access an electronic resource. The field may be used in a bibliographic record for a resource when that resource or a subset of it is available electronically. In addition, it may be used to locate and access an electronic version of a non-electronic resource described in the bibliographic record or a related electronic resource. (Repeatable) (1 more message)

Use the @more command to get additional information from pinesol of the previous message ends with "(1 more message)"

@more

Here is what pinesol will reply with

your_irc_nickname: [a,b,c,d,f,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z,2,3,6,8]

Send a note to someone for later

Use "@later tell" to send a note to someone later

@later tell <username> Could you take a look into my bug fix?

pinesol will reply with this

<your username>: The operation succeeded.

If the user is currently logged into the channel they will receive the message immediately, if they are not they will receive the message after logging in and sending a command.

Checking notes

You can check who has a note waiting for them using @notes

@notes <username>

If you don't supply a username it will show you who all has a note waiting, but if you do it will show you what notes are waiting for that user. Here is without a username.

I currently have notes waiting for _An, ackaca, actually,, AlexBoardman, anyzh, capeschools, Chris2222, community_irc_meeting, dat, davit, dbs,, dbs:, edbarrett, eeevil:, EGUEST089, emrikol^, faizi, figu, garren_h2, GDCPLG, geonetis, gett, gmcharlt, gmcharlt:, Guest71726, htrap, huginn, iarnc, jhaig_, jmeeuwen_:, Kathleen_:, kimilahtio, kivilaht3o, kmlussier:, kuku, Lakeside, lemma, (1 more message)

And with a username.

Sent (some amount of time) ago: <username> Could you take a look into my bug fix?

Getting Weather Information

Use the @weather or @wunder command to get information about weather at the chosen location. Example provided by gsams.

@weather 76262

Here is what pinesol will reply with

The current temperature in Roanoke, Texas is 61.2°F (9:07 AM CDT on March 31, 2014). Conditions: Mostly Cloudy. Humidity: 81%. Dew Point: 55.4°F. Pressure: 29.90 in 1012 hPa (Steady).

Launchpad Bug Tracker Integration

If you mention a Launchpad bug number in a certain way, pinesol will reply back with more information about that bug. There are several different formats that it looks for. Generally include the prefix "bug, bugs, lp or launchpad" and then the bug number with or without #. Multiple bugs can be listed with a comma separating them.

Please look at bug 1484655.
What about lp 1484655.
Take a look at these two bugs 1484655, 1485240
I think that launchpad #1110817 should be fixed by now.

pinesol will respond with something like this

Launchpad bug 1484655 in Evergreen 2.8 "ftp://ftp.mozilla.org has moved to http://archive.mozilla.org" (affected: 1, heat: 6) [High,Fix committed] https://launchpad.net/bugs/1484655

Git Repository Integration

If you mention a git commit hash from the evergreen, opensrf, evergreen_website or sipserver repositories then pinesol will give you more information about that commit. You need to include at least 6 characters of the hash.

I think the problem is in commit 8d14cfb562d8e72e25a7d90cbb5370bf904ccf1c
No, it is actually in commit 8d14cf

pinesol will respond with something like:

<pinesol> [evergreen|Jason Stephenson] LP 1484655: ftp://ftp.mozilla.org moved to http://archive.mozilla.org - <http://git.evergreen-ils.org/?p=Evergreen.git;a=commit;h=8d14cfb>

Advanced Usage Commands

Fun Commands

Get a drink from the bartender

Use @bartender to receive a drink or send a drink to another person.

@bartender <username>

Here is what pinesol can reply with.

pinesol fills a pint glass with Ruedrich's Red Seal Ale, and sends it sliding down the bar to <username> (http://beeradvocate.com/beer/profile/112/410/)

There are a variety of drinks available from the bartender, this was just an example of one.

Have a nice cup of coffee or tea

Use @coffee or @tea to receive a cup/pot of coffer/tea or send it to another person.

@tea <username>
@coffee <username>

Here is what pinesol can reply with for @tea.

pinesol brews and pours a pot of Liu An Gua Pian Green Tea, and sends it sliding down the bar to <username> (http://ratetea.com/tea/teavivre/liu-an-gua-pian-green-tea/6492/)

And @coffee

pinesol brews and pours a cup of India AA Elkhill Estate, and sends it sliding down the bar to <username>

Create a D&D/Gamma World/Librarian/Developer Character Sheet

pinesol can randomly generate character stats in a variety of formats.

@dnd
@gamma
@librarian
@developer

pinesol will respond with the following for @dnd:

strength:13 dexterity:10 constitution:11 intelligence:16 wisdom:18 charisma:16

@gamma

Charisma:12, Constitution:16, Dexterity:10, Intelligence:14, Mental Strength:10, Physical Strength:16

@librarian

Management:10, Cataloging:11, Acquisitions:13, Reference:12, Circulation:9, Systems:15, Research:13, Custodial:8

@developer

Communication:8, BigPicture:9, DetailOriented:10, KungFu:8, GetsStuffDone:6, FlakeFactor:13, JavaAvoidance:14

Get sorted by the sorting hat!

@sortinghat will sort you into a house

@sortinghat

pinesol replied to gsams with:

Hmm... gsams... Let me see now... GRYFFINDOR!

Quote Database

Seeing the quote commands

@list quote will show a list of sub commands for the quote plug-in

@list quote

pinesol replies

add, change, get, random, remove, replace, search, and stats
Adding a quote to the database
@quote add <Bmagic> It's as if millions of bugs all cried out at once, and were silenced.
Search the database
@quote search Bmagic

pinesol replies

4 found: #149: "< Bmagic> my favorite viruses are the ones...", #172: "< Bmagic> I like to keep my systems at a power...", #179: "<Bmagic> It's amazing how often 30 days comes...", and #213: "<Bmagic> It's as if millions of bugs all cried..."
Retrieve a specific quote by ID
@quote get 149

pinesol replies

Quote #149: "< Bmagic> my favorite viruses are the ones claiming to be the cure" (added by csharp at 10:32 AM, March 22, 2016)

Using MeetBot for IRC Meetings

The Meetbot is documented at Using MeetBot for IRC Meetings