Guido van Rossum | c27e042 | 1995-09-07 19:47:46 +0000 | [diff] [blame^] | 1 | #! /home/guido/bin.sgi/python |
Guido van Rossum | 4450bab | 1994-10-11 14:57:03 +0000 | [diff] [blame] | 2 | #! /usr/local/bin/python |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 3 | |
| 4 | # Tk man page browser -- currently only shows the Tcl/Tk man pages |
| 5 | |
| 6 | import sys |
| 7 | import os |
| 8 | import string |
| 9 | import regex |
| 10 | from Tkinter import * |
Guido van Rossum | ac97fd7 | 1994-10-06 15:50:49 +0000 | [diff] [blame] | 11 | |
| 12 | import addpack |
Guido van Rossum | 4450bab | 1994-10-11 14:57:03 +0000 | [diff] [blame] | 13 | addpack.addpack('/ufs/guido/src/python/Demo/guido/tkinter') |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 14 | from ManPage import ManPage |
| 15 | |
Guido van Rossum | 36ea0e7 | 1994-07-11 13:15:05 +0000 | [diff] [blame] | 16 | MANNDIR = '/usr/local/man/mann' |
| 17 | MAN3DIR = '/usr/local/man/man3' |
Guido van Rossum | c27e042 | 1995-09-07 19:47:46 +0000 | [diff] [blame^] | 18 | MANNDIR = '/depot/sundry/man/mann' |
| 19 | MAN3DIR = '/depot/sundry/man/man3' |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 20 | |
Guido van Rossum | 36ea0e7 | 1994-07-11 13:15:05 +0000 | [diff] [blame] | 21 | def listmanpages(mandir): |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 22 | files = os.listdir(mandir) |
| 23 | names = [] |
| 24 | for file in files: |
Guido van Rossum | 36ea0e7 | 1994-07-11 13:15:05 +0000 | [diff] [blame] | 25 | if file[-2:-1] == '.' and (file[-1] in 'ln123456789'): |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 26 | names.append(file[:-2]) |
| 27 | names.sort() |
| 28 | return names |
| 29 | |
| 30 | class SelectionBox: |
| 31 | |
| 32 | def __init__(self, master=None): |
| 33 | self.choices = [] |
| 34 | |
| 35 | self.frame = Frame(master, { |
Guido van Rossum | 3e4f182 | 1994-07-12 16:35:35 +0000 | [diff] [blame] | 36 | 'name': 'frame', |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 37 | Pack: {'expand': 1, 'fill': 'both'}}) |
| 38 | self.master = self.frame.master |
| 39 | self.subframe = Frame(self.frame, { |
Guido van Rossum | 3e4f182 | 1994-07-12 16:35:35 +0000 | [diff] [blame] | 40 | 'name': 'subframe', |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 41 | Pack: {'expand': 0, 'fill': 'both'}}) |
Guido van Rossum | 36ea0e7 | 1994-07-11 13:15:05 +0000 | [diff] [blame] | 42 | self.leftsubframe = Frame(self.subframe, { |
Guido van Rossum | 3e4f182 | 1994-07-12 16:35:35 +0000 | [diff] [blame] | 43 | 'name': 'leftsubframe', |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 44 | Pack: {'side': 'left', 'expand': 1, 'fill': 'both'}}) |
Guido van Rossum | 36ea0e7 | 1994-07-11 13:15:05 +0000 | [diff] [blame] | 45 | self.rightsubframe = Frame(self.subframe, { |
Guido van Rossum | 3e4f182 | 1994-07-12 16:35:35 +0000 | [diff] [blame] | 46 | 'name': 'rightsubframe', |
Guido van Rossum | 36ea0e7 | 1994-07-11 13:15:05 +0000 | [diff] [blame] | 47 | Pack: {'side': 'right', 'expand': 1, 'fill': 'both'}}) |
| 48 | self.chaptervar = StringVar(master) |
| 49 | self.chapter = Menubutton(self.rightsubframe, |
Guido van Rossum | 3e4f182 | 1994-07-12 16:35:35 +0000 | [diff] [blame] | 50 | {'name': 'chapter', |
| 51 | 'text': 'Directory', |
Guido van Rossum | 36ea0e7 | 1994-07-11 13:15:05 +0000 | [diff] [blame] | 52 | 'relief': 'raised', 'bd': 2, |
| 53 | Pack: {'side': 'top'}}) |
Guido van Rossum | 3e4f182 | 1994-07-12 16:35:35 +0000 | [diff] [blame] | 54 | self.chaptermenu = Menu(self.chapter, {'name': 'chaptermenu'}) |
Guido van Rossum | 36ea0e7 | 1994-07-11 13:15:05 +0000 | [diff] [blame] | 55 | self.chaptermenu.add_radiobutton({'label': 'C functions', |
| 56 | 'value': MAN3DIR, |
| 57 | 'variable': self.chaptervar, |
| 58 | 'command': self.newchapter}) |
| 59 | self.chaptermenu.add_radiobutton({'label': 'Tcl/Tk functions', |
| 60 | 'value': MANNDIR, |
| 61 | 'variable': self.chaptervar, |
| 62 | 'command': self.newchapter}) |
| 63 | self.chapter['menu'] = self.chaptermenu |
| 64 | self.listbox = Listbox(self.rightsubframe, |
Guido van Rossum | 3e4f182 | 1994-07-12 16:35:35 +0000 | [diff] [blame] | 65 | {'name': 'listbox', |
| 66 | 'relief': 'sunken', 'bd': 2, |
Guido van Rossum | c27e042 | 1995-09-07 19:47:46 +0000 | [diff] [blame^] | 67 | 'width': 20, 'height': 5, |
Guido van Rossum | 36ea0e7 | 1994-07-11 13:15:05 +0000 | [diff] [blame] | 68 | Pack: {'expand': 1, 'fill': 'both'}}) |
| 69 | self.l1 = Button(self.leftsubframe, |
Guido van Rossum | 3e4f182 | 1994-07-12 16:35:35 +0000 | [diff] [blame] | 70 | {'name': 'l1', |
| 71 | 'text': 'Display manual page named:', |
Guido van Rossum | 119749b | 1994-07-08 14:28:38 +0000 | [diff] [blame] | 72 | 'command': self.entry_cb, |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 73 | Pack: {'side': 'top'}}) |
Guido van Rossum | 36ea0e7 | 1994-07-11 13:15:05 +0000 | [diff] [blame] | 74 | self.entry = Entry(self.leftsubframe, |
Guido van Rossum | 3e4f182 | 1994-07-12 16:35:35 +0000 | [diff] [blame] | 75 | {'name': 'entry', |
| 76 | 'relief': 'sunken', 'bd': 2, |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 77 | 'width': 20, |
| 78 | Pack: {'side': 'top', |
| 79 | 'expand': 0, 'fill': 'x'}}) |
Guido van Rossum | 3e4f182 | 1994-07-12 16:35:35 +0000 | [diff] [blame] | 80 | self.l2frame = Frame(self.leftsubframe, |
| 81 | {'name': 'l2frame', |
| 82 | Pack: {'expand': 0, 'fill': 'none'}}) |
Guido van Rossum | 119749b | 1994-07-08 14:28:38 +0000 | [diff] [blame] | 83 | self.l2 = Button(self.l2frame, |
Guido van Rossum | 3e4f182 | 1994-07-12 16:35:35 +0000 | [diff] [blame] | 84 | {'name': 'l2', |
| 85 | 'text': 'Search regexp:', |
Guido van Rossum | 119749b | 1994-07-08 14:28:38 +0000 | [diff] [blame] | 86 | 'command': self.search_cb, |
| 87 | Pack: {'side': 'left'}}) |
| 88 | self.casesense = Checkbutton(self.l2frame, |
Guido van Rossum | 3e4f182 | 1994-07-12 16:35:35 +0000 | [diff] [blame] | 89 | {'name': 'casesense', |
| 90 | 'text': 'Case sensitive', |
Guido van Rossum | 119749b | 1994-07-08 14:28:38 +0000 | [diff] [blame] | 91 | 'variable': 'casesense', |
| 92 | 'relief': 'flat', |
| 93 | Pack: {'side': 'left'}}) |
Guido van Rossum | 36ea0e7 | 1994-07-11 13:15:05 +0000 | [diff] [blame] | 94 | self.search = Entry(self.leftsubframe, |
Guido van Rossum | 3e4f182 | 1994-07-12 16:35:35 +0000 | [diff] [blame] | 95 | {'name': 'search', |
| 96 | 'relief': 'sunken', 'bd': 2, |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 97 | 'width': 20, |
| 98 | Pack: {'side': 'top', |
| 99 | 'expand': 0, 'fill': 'x'}}) |
Guido van Rossum | 36ea0e7 | 1994-07-11 13:15:05 +0000 | [diff] [blame] | 100 | self.title = Label(self.leftsubframe, |
Guido van Rossum | 3e4f182 | 1994-07-12 16:35:35 +0000 | [diff] [blame] | 101 | {'name': 'title', |
| 102 | 'text': '(none)', |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 103 | Pack: {'side': 'bottom'}}) |
| 104 | self.text = ManPage(self.frame, |
Guido van Rossum | 3e4f182 | 1994-07-12 16:35:35 +0000 | [diff] [blame] | 105 | {'name': 'text', |
| 106 | 'relief': 'sunken', 'bd': 2, |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 107 | 'wrap': 'none', 'width': 72, |
Guido van Rossum | c27e042 | 1995-09-07 19:47:46 +0000 | [diff] [blame^] | 108 | 'selectbackground': 'pink', |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 109 | Pack: {'expand': 1, 'fill': 'both'}}) |
| 110 | |
| 111 | self.entry.bind('<Return>', self.entry_cb) |
| 112 | self.search.bind('<Return>', self.search_cb) |
| 113 | self.listbox.bind('<Double-1>', self.listbox_cb) |
| 114 | |
Guido van Rossum | 119749b | 1994-07-08 14:28:38 +0000 | [diff] [blame] | 115 | self.entry.bind('<Tab>', self.entry_tab) |
| 116 | self.search.bind('<Tab>', self.search_tab) |
| 117 | self.text.bind('<Tab>', self.text_tab) |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 118 | |
Guido van Rossum | 119749b | 1994-07-08 14:28:38 +0000 | [diff] [blame] | 119 | self.entry.focus_set() |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 120 | |
Guido van Rossum | 36ea0e7 | 1994-07-11 13:15:05 +0000 | [diff] [blame] | 121 | self.chaptervar.set(MANNDIR) |
| 122 | self.newchapter() |
| 123 | |
| 124 | def newchapter(self): |
| 125 | mandir = self.chaptervar.get() |
| 126 | self.choices = [] |
| 127 | self.addlist(listmanpages(mandir)) |
| 128 | |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 129 | def addchoice(self, choice): |
| 130 | if choice not in self.choices: |
| 131 | self.choices.append(choice) |
| 132 | self.choices.sort() |
| 133 | self.update() |
| 134 | |
| 135 | def addlist(self, list): |
| 136 | self.choices[len(self.choices):] = list |
| 137 | self.choices.sort() |
| 138 | self.update() |
| 139 | |
Guido van Rossum | 119749b | 1994-07-08 14:28:38 +0000 | [diff] [blame] | 140 | def entry_cb(self, *e): |
| 141 | self.update() |
| 142 | |
| 143 | def listbox_cb(self, e): |
| 144 | selection = self.listbox.curselection() |
| 145 | if selection and len(selection) == 1: |
| 146 | name = self.listbox.get(selection[0]) |
| 147 | self.show_page(name) |
| 148 | |
| 149 | def search_cb(self, *e): |
| 150 | self.search_string(self.search.get()) |
| 151 | |
| 152 | def entry_tab(self, e): |
| 153 | self.search.focus_set() |
| 154 | |
| 155 | def search_tab(self, e): |
| 156 | self.entry.focus_set() |
| 157 | |
| 158 | def text_tab(self, e): |
| 159 | self.entry.focus_set() |
| 160 | |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 161 | def updatelist(self): |
| 162 | key = self.entry.get() |
| 163 | ok = filter(lambda name, key=key, n=len(key): name[:n]==key, |
| 164 | self.choices) |
Guido van Rossum | c27e042 | 1995-09-07 19:47:46 +0000 | [diff] [blame^] | 165 | if not ok: |
| 166 | self.frame.bell() |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 167 | self.listbox.delete(0, AtEnd()) |
| 168 | exactmatch = 0 |
| 169 | for item in ok: |
| 170 | if item == key: exactmatch = 1 |
| 171 | self.listbox.insert(AtEnd(), item) |
| 172 | if exactmatch: |
| 173 | return key |
Guido van Rossum | c27e042 | 1995-09-07 19:47:46 +0000 | [diff] [blame^] | 174 | n = self.listbox.size() |
| 175 | if n == 1: |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 176 | return self.listbox.get(0) |
Guido van Rossum | 119749b | 1994-07-08 14:28:38 +0000 | [diff] [blame] | 177 | # Else return None, meaning not a unique selection |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 178 | |
| 179 | def update(self): |
Guido van Rossum | 119749b | 1994-07-08 14:28:38 +0000 | [diff] [blame] | 180 | name = self.updatelist() |
| 181 | if name: |
| 182 | self.show_page(name) |
| 183 | self.entry.delete(0, AtEnd()) |
| 184 | self.updatelist() |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 185 | |
| 186 | def show_page(self, name): |
Guido van Rossum | 36ea0e7 | 1994-07-11 13:15:05 +0000 | [diff] [blame] | 187 | file = '%s/%s.?' % (self.chaptervar.get(), name) |
Guido van Rossum | 119749b | 1994-07-08 14:28:38 +0000 | [diff] [blame] | 188 | fp = os.popen('nroff -man %s | ul -i' % file, 'r') |
| 189 | self.text.kill() |
| 190 | self.title['text'] = name |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 191 | self.text.parsefile(fp) |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 192 | |
| 193 | def search_string(self, search): |
| 194 | if not search: |
Guido van Rossum | c27e042 | 1995-09-07 19:47:46 +0000 | [diff] [blame^] | 195 | self.frame.bell() |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 196 | print 'Empty search string' |
| 197 | return |
Guido van Rossum | 119749b | 1994-07-08 14:28:38 +0000 | [diff] [blame] | 198 | if self.frame.tk.getvar('casesense') != '1': |
| 199 | map = regex.casefold |
| 200 | else: |
| 201 | map = None |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 202 | try: |
Guido van Rossum | 119749b | 1994-07-08 14:28:38 +0000 | [diff] [blame] | 203 | if map: |
| 204 | prog = regex.compile(search, map) |
| 205 | else: |
| 206 | prog = regex.compile(search) |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 207 | except regex.error, msg: |
Guido van Rossum | c27e042 | 1995-09-07 19:47:46 +0000 | [diff] [blame^] | 208 | self.frame.bell() |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 209 | print 'Regex error:', msg |
| 210 | return |
| 211 | here = self.text.index(AtInsert()) |
| 212 | lineno = string.atoi(here[:string.find(here, '.')]) |
| 213 | end = self.text.index(AtEnd()) |
| 214 | endlineno = string.atoi(end[:string.find(end, '.')]) |
| 215 | wraplineno = lineno |
Guido van Rossum | c27e042 | 1995-09-07 19:47:46 +0000 | [diff] [blame^] | 216 | found = 0 |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 217 | while 1: |
| 218 | lineno = lineno + 1 |
| 219 | if lineno > endlineno: |
| 220 | if wraplineno <= 0: |
| 221 | break |
| 222 | endlineno = wraplineno |
| 223 | lineno = 0 |
| 224 | wraplineno = 0 |
| 225 | line = self.text.get('%d.0 linestart' % lineno, |
| 226 | '%d.0 lineend' % lineno) |
| 227 | i = prog.search(line) |
| 228 | if i >= 0: |
Guido van Rossum | c27e042 | 1995-09-07 19:47:46 +0000 | [diff] [blame^] | 229 | found = 1 |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 230 | n = max(1, len(prog.group(0))) |
| 231 | try: |
| 232 | self.text.tag_remove('sel', |
| 233 | AtSelFirst(), |
| 234 | AtSelLast()) |
| 235 | except TclError: |
| 236 | pass |
| 237 | self.text.tag_add('sel', |
| 238 | '%d.%d' % (lineno, i), |
| 239 | '%d.%d' % (lineno, i+n)) |
| 240 | self.text.mark_set(AtInsert(), |
| 241 | '%d.%d' % (lineno, i)) |
| 242 | self.text.yview_pickplace(AtInsert()) |
| 243 | break |
Guido van Rossum | c27e042 | 1995-09-07 19:47:46 +0000 | [diff] [blame^] | 244 | if not found: |
| 245 | self.frame.bell() |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 246 | |
| 247 | def main(): |
| 248 | root = Tk() |
| 249 | sb = SelectionBox(root) |
Guido van Rossum | f09b770 | 1994-07-06 21:17:21 +0000 | [diff] [blame] | 250 | if sys.argv[1:]: |
| 251 | sb.show_page(sys.argv[1]) |
| 252 | root.minsize(1, 1) |
| 253 | root.mainloop() |
| 254 | |
| 255 | main() |