mcbot/cmds/rfc.lua
author Mikael Berthe <mikael@lilotux.net>
Tue, 27 Nov 2012 16:36:17 +0100
changeset 67 5c756a9d7d8c
parent 66 d9c00a9fe9d5
permissions -rw-r--r--
Quick'n dirty hack to remove hardcoded paths
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
31
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
     1
#! /usr/bin/env lua
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
     2
66
d9c00a9fe9d5 Add notices before public release
Mikael Berthe <mikael@lilotux.net>
parents: 34
diff changeset
     3
--  This module is part of the McBot / mcabbot project
d9c00a9fe9d5 Add notices before public release
Mikael Berthe <mikael@lilotux.net>
parents: 34
diff changeset
     4
--  RFC index parser
d9c00a9fe9d5 Add notices before public release
Mikael Berthe <mikael@lilotux.net>
parents: 34
diff changeset
     5
--
d9c00a9fe9d5 Add notices before public release
Mikael Berthe <mikael@lilotux.net>
parents: 34
diff changeset
     6
-- Copyright (C) 2010-2012 Mikael Berthe <mikael@lilotux.net>
d9c00a9fe9d5 Add notices before public release
Mikael Berthe <mikael@lilotux.net>
parents: 34
diff changeset
     7
--
d9c00a9fe9d5 Add notices before public release
Mikael Berthe <mikael@lilotux.net>
parents: 34
diff changeset
     8
-- This program is free software; you can redistribute it and/or modify
d9c00a9fe9d5 Add notices before public release
Mikael Berthe <mikael@lilotux.net>
parents: 34
diff changeset
     9
-- it under the terms of the GNU General Public License as published by
d9c00a9fe9d5 Add notices before public release
Mikael Berthe <mikael@lilotux.net>
parents: 34
diff changeset
    10
-- the Free Software Foundation; either version 2 of the License, or (at
d9c00a9fe9d5 Add notices before public release
Mikael Berthe <mikael@lilotux.net>
parents: 34
diff changeset
    11
-- your option) any later version.
d9c00a9fe9d5 Add notices before public release
Mikael Berthe <mikael@lilotux.net>
parents: 34
diff changeset
    12
--
d9c00a9fe9d5 Add notices before public release
Mikael Berthe <mikael@lilotux.net>
parents: 34
diff changeset
    13
-- Please check the license in the COPYING file at the root of the tree.
d9c00a9fe9d5 Add notices before public release
Mikael Berthe <mikael@lilotux.net>
parents: 34
diff changeset
    14
--
31
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    15
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    16
-- TXT index database, retrieved from
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    17
-- <ftp://ftp.rfc-editor.org/in-notes/rfc-index.txt>
67
5c756a9d7d8c Quick'n dirty hack to remove hardcoded paths
Mikael Berthe <mikael@lilotux.net>
parents: 66
diff changeset
    18
local home = os.getenv("HOME")
5c756a9d7d8c Quick'n dirty hack to remove hardcoded paths
Mikael Berthe <mikael@lilotux.net>
parents: 66
diff changeset
    19
local indexfname = home.."/.mcabber/mcabbot/mcbot/rfc-index.txt"
5c756a9d7d8c Quick'n dirty hack to remove hardcoded paths
Mikael Berthe <mikael@lilotux.net>
parents: 66
diff changeset
    20
home = nil
31
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    21
32
96bce644394a Add URLs to RFCs
Mikael Berthe <mikael@lilotux.net>
parents: 31
diff changeset
    22
local urlbase = "http://tools.ietf.org/html/rfc"
96bce644394a Add URLs to RFCs
Mikael Berthe <mikael@lilotux.net>
parents: 31
diff changeset
    23
31
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    24
local rfc = { ["desc"] = "Search RFC database" }
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    25
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    26
local rfcdb = {}
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    27
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    28
local function parse_file (fname)
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    29
    local fh = io.open(fname)
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    30
34
ca01a1696cff Remove print() in rfc module
Mikael Berthe <mikael@lilotux.net>
parents: 32
diff changeset
    31
    if not fh then return nil, "Cannot open RFC database" end
31
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    32
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    33
    -- Skip header
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    34
    local count = 0
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    35
    for line in fh:lines() do
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    36
        count = count + 1
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    37
        if line:match("^%s+RFC INDEX%s*$") and count > 30 then
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    38
            break
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    39
        end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    40
    end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    41
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    42
    -- Skip 2 more lines
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    43
    fh:read("*l")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    44
    fh:read("*l")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    45
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    46
    local contents = fh:read("*a")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    47
    fh:close()
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    48
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    49
    for entry in contents:gfind("(%d%d%d%d .-)\n\n") do
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    50
        entry = entry:gsub("\n     ", " ")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    51
        local n = entry:match("^(%d%d%d%d) ")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    52
        entry = entry:gsub("^(%d%d%d%d) ", "")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    53
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    54
        local data = {}
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    55
        data.title = entry:match("^(.-)%. ")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    56
        entry = entry:gsub("^(.-)%. ", "")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    57
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    58
        data.date = entry:match("%. (.-)%. %(Format:")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    59
        data.obsoletes = entry:match("%(Obsoletes (.-)%)")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    60
        data.obsoleted_by = entry:match("%(Obsoleted by (.-)%)")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    61
        data.updates = entry:match("%(Updates (.-)%)")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    62
        data.updated_by = entry:match("%(Updated by (.-)%)")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    63
        data.also = entry:match("%(Also (.-)%)")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    64
        data.status = entry:match("%(Status: (.-)%)")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    65
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    66
        if data.title then
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    67
            rfcdb[n] = data
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    68
        end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    69
    end
34
ca01a1696cff Remove print() in rfc module
Mikael Berthe <mikael@lilotux.net>
parents: 32
diff changeset
    70
    return true
31
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    71
end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    72
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    73
local function rfc_lookup_string (rfcstring)
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    74
    rfcstring = rfcstring:lower()
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    75
    local r = ""
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    76
    for id, data in pairs(rfcdb) do
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    77
        if data.title:lower():find(rfcstring) then
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    78
            r = r.."RFC"..id..": "..data.title.."\n"
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    79
        end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    80
    end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    81
    r = r:gsub("\n$", "")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    82
    if r ~= "" then return r; end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    83
    return nil, "Sorry, I couldn't find any relevant RFC"
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    84
end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    85
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    86
local function rfc_lookup_number (rfcnum)
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    87
    rfcnum = tostring(rfcnum)
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    88
    rfcnum = string.rep("0", 4 - rfcnum:len()) .. rfcnum
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    89
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    90
    local data = rfcdb[rfcnum]
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    91
    if not data then return nil, "Sorry, RFC not found" end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    92
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    93
    local r = "RFC"..rfcnum .. " is " .. data.title .. "\n"
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    94
    if data.status then
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    95
        r = r .. "Status:\t" .. data.status:lower() .. "\n"
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    96
    end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    97
    if data.obsoletes then
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    98
        r = r .. "Obsoletes:\t" .. data.obsoletes .. "\n"
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    99
    end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   100
    if data.obsoleted_by then
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   101
        r = r .. "Obsoleted by:\t" .. data.obsoleted_by .. "\n"
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   102
    end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   103
    if data.updates then
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   104
        r = r .. "Updates:\t" .. data.updates .. "\n"
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   105
    end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   106
    if data.updated_by then
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   107
        r = r .. "Updated by:\t" .. data.updated_by .. "\n"
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   108
    end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   109
    if data.also then
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   110
        r = r .. "Also:\t" .. data.also .. "\n"
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   111
    end
32
96bce644394a Add URLs to RFCs
Mikael Berthe <mikael@lilotux.net>
parents: 31
diff changeset
   112
    r = r .. "URL:\t" .. urlbase..rfcnum
31
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   113
    return r
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   114
end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   115
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   116
function rfc.cmd (rfcnum)
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   117
    local empty = true
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   118
    for i,v in pairs(rfcdb) do empty = false; break end
34
ca01a1696cff Remove print() in rfc module
Mikael Berthe <mikael@lilotux.net>
parents: 32
diff changeset
   119
    if empty then
ca01a1696cff Remove print() in rfc module
Mikael Berthe <mikael@lilotux.net>
parents: 32
diff changeset
   120
        local r, err = parse_file(indexfname)
ca01a1696cff Remove print() in rfc module
Mikael Berthe <mikael@lilotux.net>
parents: 32
diff changeset
   121
        if not r then return nil, err end
ca01a1696cff Remove print() in rfc module
Mikael Berthe <mikael@lilotux.net>
parents: 32
diff changeset
   122
    end
31
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   123
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   124
    if (rfcnum) then
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   125
        rfcnum = rfcnum:gsub("^RFC[%s%-]*", "")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   126
        rfcnum = rfcnum:gsub("^rfc[%s%-]*", "")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   127
        rfcnum = rfcnum:gsub("[!%?%s:]+$", "")
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   128
    end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   129
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   130
    if not rfcnum or rfcnum == "" then
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   131
        return nil, "What RFC do you want?"
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   132
    end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   133
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   134
    local n = tonumber(rfcnum)
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   135
    if not n then return rfc_lookup_string(rfcnum) end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   136
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   137
    return rfc_lookup_number(n)
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   138
end
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   139
71bf91612a33 Add command rfc
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
   140
mcbot_register_command("rfc", rfc)