Diffusion invenio-infoscience (maint-0.99) Browse

webcoll.in
80630812b66cmaint-0.99

webcoll.in
View Options

			## $Id$
			## Script that creates collection pages, starting from the collection
			## passed to the script as an argument.

			## This file is part of the CERN Document Server Software (CDSware).
			## Copyright (C) 2002 CERN.
			##
			## The CDSware is free software; you can redistribute it and/or
			## modify it under the terms of the GNU General Public License as
			## published by the Free Software Foundation; either version 2 of the
			## License, or (at your option) any later version.
			##
			## The CDSware is distributed in the hope that it will be useful, but
			## WITHOUT ANY WARRANTY; without even the implied warranty of
			## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
			## General Public License for more details.
			##
			## You should have received a copy of the GNU General Public License
			## along with CDSware; if not, write to the Free Software Foundation, Inc.,
			## 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.

			## read config variables:
			#include "config.wml"
			#include "configbis.wml"

			## start Python:
			<protect>#!</protect><PYTHON>
			<protect>## $Id$</protect>
			<protect>## DO NOT EDIT THIS FILE! IT WAS AUTOMATICALLY GENERATED FROM CDSware WML SOURCES.</protect>
			"""Creates CDSware collection specific pages, using WML and MySQL configuration tables."""

			## fill config variables:
			pylibdir = "<LIBDIR>/python"

			### okay, rest of the Python code goes below ###

			## import modules:
			try:
			import copy
			import getopt
			import marshal
			import signal
			import sys
			import cgi
			import sre
			import os
			import math
			import string
			import urllib
			import zlib
			import MySQLdb
			import Numeric
			import time
			import traceback
			except ImportError, e:
			print "Error: %s" % e
			import sys
			sys.exit(1)

			try:
			sys.path.append('%s' % pylibdir)
			from cdsware.config import *
			from cdsware.messages import *
			from cdsware.search_engine import HitSet, search_pattern
			from cdsware.search_engine_config import cfg_author_et_al_threshold, cfg_instant_browse, cfg_max_recID, cfg_narrow_search_show_grandsons
			from cdsware.dbquery import run_sql
			except ImportError, e:
			print "Error: %s" % e
			import sys
			sys.exit(1)

			## global vars
			collection_house = {} # will hold collections we treat in this run of the program; a dict of {collname2, collobject1}, ...
			options = {} # will hold task options

			## TODO: still leaving live SQL queries here and there in the code; a
			## ``real way'' of doing this would be to grab a snapshot of the
			## database, initiate our own classes, work on memory, and flush the
			## results back. Refactoring needed, but time is low.

			def get_collection(colname):
			"""Return collection object from the collection house for given colname.
			If does not exist, then create it."""
			if not collection_house.has_key(colname):
			colobject = Collection(colname)
			collection_house[colname] = colobject
			return collection_house[colname]

			## auxiliary functions:
			def mymkdir(newdir, mode=0777):
			"""works the way a good mkdir should :)
			- already exists, silently complete
			- regular file in the way, raise an exception
			- parent directory(ies) does not exist, make them as well
			"""
			if os.path.isdir(newdir):
			pass
			elif os.path.isfile(newdir):
			raise OSError("a file with the same name as the desired " \
			"dir, '%s', already exists." % newdir)
			else:
			head, tail = os.path.split(newdir)
			if head and not os.path.isdir(head):
			mymkdir(head, mode)
			if tail:
			os.umask(022)
			os.mkdir(newdir, mode)

			def nice_number(num):
			"Returns nice number when using comma as thousands separator."
			chars_in = list(str(num))
			num = len(chars_in)
			chars_out = []
			for i in range(0,num):
			if i % 3 == 0 and i != 0:
			chars_out.append(',')
			chars_out.append(chars_in[num-i-1])
			chars_out.reverse()
			return ''.join(chars_out)

			def escape_string(s):
			"Escapes special chars in string. For MySQL queries."
			s = MySQLdb.escape_string(s)
			return s

			def is_selected(var, fld):
			"Checks if the two are equal, and if yes, returns ' selected'. Useful for select boxes."
			if var == fld:
			return " selected"
			else:
			return ""

			def write_message(msg, stream=sys.stdout):
			"""Write message and flush output stream (may be sys.stdout or sys.stderr). Useful for debugging stuff."""
			if stream == sys.stdout or stream == sys.stderr:
			stream.write(time.strftime("%Y-%m-%d %H:%M:%S --> ", time.localtime()))
			stream.write("%s\n" % msg)
			stream.flush()
			else:
			sys.stderr.write("Unknown stream %s. [must be sys.stdout or sys.stderr]\n" % stream)
			return

			def create_andornot_box(name='op', value='', ln='en'):
			"Returns HTML code for the AND/OR/NOT selection box."
			out = """
			<select name="%s">
			<option value="a"%s>%s
			<option value="o"%s>%s
			<option value="n"%s>%s
			</select>
			""" % (name,
			is_selected('a', value), msg_and[ln],
			is_selected('o', value), msg_or[ln],
			is_selected('n', value), msg_and_not[ln])
			return out

			def create_matchtype_box(name='m', value='', ln='en'):
			"Returns HTML code for the 'match type' selection box."
			out = """
			<select name="%s">
			<option value="a"%s>%s
			<option value="o"%s>%s
			<option value="e"%s>%s
			<option value="p"%s>%s
			<option value="r"%s>%s
			</select>
			""" % (name,
			is_selected('a', value), msg_all_of_the_words[ln],
			is_selected('o', value), msg_any_of_the_words[ln],
			is_selected('e', value), msg_exact_phrase[ln],
			is_selected('p', value), msg_partial_phrase[ln],
			is_selected('r', value), msg_regular_expression[ln])
			return out

			def get_field(recID, tag):
			"Gets list of field 'tag' for the record with 'recID' system number."

			out = []
			digit = tag[0:2]

			bx = "bib%sx" % digit
			bibx = "bibrec_bib%sx" % digit
			query = "SELECT bx.value FROM %s AS bx, %s AS bibx WHERE bibx.id_bibrec='%s' AND bx.id=bibx.id_bibxxx AND bx.tag='%s'" \
			% (bx, bibx, recID, tag)
			res = run_sql(query)
			for row in res:
			out.append(row[0])
			return out

			def print_record(recID, format='hb'):
			"Prints record 'recID' formatted accoding to 'format'."

			out = ""
			# HTML brief format by default
			query = "SELECT value FROM bibfmt WHERE id_bibrec='%s' AND format='%s'" % (recID, format)
			res = run_sql(query, None, 1)
			if res:
			# record 'recID' is formatted in 'format', so print it
			out += "%s" % zlib.decompress(res[0][0])
			else:
			# record 'recID' does not exist in format 'format', so print some default format:
			# firstly, title:
			titles = get_field(recID, "245__a")
			for title in titles:
			out += "<strong>%s</strong> " % cgi.escape(title)
			# secondly, authors:
			authors = get_field(recID, "100__a") + get_field(recID, "700__a")
			if authors:
			out += " / "
			for i in range (0,cfg_author_et_al_threshold):
			if i < len(authors):
			out += """<a href="%s/search.py?p=%s&f=author">%s</a> ;""" \
			% (weburl, urllib.quote(authors[i]), cgi.escape(authors[i]))
			if len(authors) > cfg_author_et_al_threshold:
			out += " <em>et al.</em>"
			# thirdly, date of creation:
			dates = get_field(recID, "260__c")
			for date in dates:
			out += " %s." % cgi.escape(date)
			# thirdly bis, report numbers:
			rns = get_field(recID, "037__a")
			for rn in rns:
			out += """ <small class="quicknote">[%s]</small>""" % cgi.escape(rn)
			rns = get_field(recID, "088__a")
			for rn in rns:
			out += """ <small class="quicknote">[%s]</small>""" % cgi.escape(rn)
			# fourthly, beginning of abstract:
			abstracts = get_field(recID, "520__a")
			for abstract in abstracts:
			out += "<br><small>%s [...]</small>" % cgi.escape(abstract[:1+string.find(abstract, '.')])
			# fifthly, fulltext link:
			urls_z = get_field(recID, "8564_z")
			urls_u = get_field(recID, "8564_u")
			for idx in range(0,len(urls_u)):
			out += """<br><small class="note"><a class="note" href="%s">%s</a></small>""" % (urls_u[idx], urls_u[idx])

			# at the end of HTML mode, print "Detailed record" and "Mark record" functions:
			out += """<br><span class="moreinfo"><a class="moreinfo" href="%s/search.py?recid=%s">Detailed record</a>""" \
			% (weburl, recID)
			#out += """<- <input name="mark[]" type="checkbox" value="%s"> Mark record""" % recID
			out += "</span>"
			return out

			class Collection:
			"Holds the information on collections (id,name,nameshort,dbquery)."

			def __init__(self, name=""):
			"Creates collection instance by querying the MySQL configuration database about 'name'."
			self.calculate_reclist_run_already = 0 # to speed things up wihtout much refactoring
			self.update_reclist_run_already = 0 # to speed things up wihtout much refactoring
			self.reclist_with_nonpublic_subcolls = HitSet()
			if not name:
			self.name = cdsname # by default we are working on the home page
			self.id = 1
			self.dbquery = None
			self.nbrecs = None
			self.reclist = HitSet()
			else:
			self.name = name
			query = "SELECT id,name,nameshort,dbquery,nbrecs,reclist FROM collection WHERE name='%s'" % escape_string(name)
			try:
			res = run_sql(query, None, 1)
			if res:
			self.id = res[0][0]
			self.name = res[0][1]
			self.nameshort = res[0][2]
			self.dbquery = res[0][3]
			self.nbrecs = res[0][4]
			try:
			self.reclist = HitSet(Numeric.loads(zlib.decompress(res[0][5])))
			except:
			self.reclist = HitSet()
			else: # collection does not exist!
			self.id = None
			self.nameshort = None
			self.dbquery = None
			self.nbrecs = None
			self.reclist = HitSet()
			except MySQLdb.Error, e:
			print "Error %d: %s" % (e.args[0], e.args[1])
			sys.exit(1)

			def get_ancestors(self):
			"Returns list of ancestors of the current collection."
			ancestors = []
			id_son = self.id
			while 1:
			query = "SELECT cc.id_dad,c.name FROM collection_collection AS cc, collection AS c "\
			"WHERE cc.id_son=%d AND c.id=cc.id_dad" % int(id_son)
			res = run_sql(query, None, 1)
			if res:
			col_ancestor = get_collection(res[0][1])
			ancestors.append(col_ancestor)
			id_son = res[0][0]
			else:
			break
			ancestors.reverse()
			return ancestors

			def restricted_p(self):
			"""Predicate to test if the collection is restricted or not. Return the contect of the
			`restrited' column of the collection table (typically Apache group). Otherwise return
			None if the collection is public."""
			out = None
			query = "SELECT restricted FROM collection WHERE id=%d" % self.id
			res = run_sql(query, None, 1)
			try:
			out = res[0][0]
			except:
			pass
			return out

			def get_sons(self, type='r'):
			"Returns list of direct sons of type 'type' for the current collection."
			sons = []
			id_dad = self.id
			query = "SELECT cc.id_son,c.name FROM collection_collection AS cc, collection AS c "\
			"WHERE cc.id_dad=%d AND cc.type='%s' AND c.id=cc.id_son ORDER BY score DESC, c.name ASC" % (int(id_dad), type)
			res = run_sql(query)
			for row in res:
			sons.append(get_collection(row[1]))
			return sons

			def get_descendants(self, type='r'):
			"Returns list of all descendants of type 'type' for the current collection."
			descendants = []
			id_dad = self.id
			query = "SELECT cc.id_son,c.name FROM collection_collection AS cc, collection AS c "\
			"WHERE cc.id_dad=%d AND cc.type='%s' AND c.id=cc.id_son ORDER BY score DESC" % (int(id_dad), type)
			res = run_sql(query)
			for row in res:
			col_desc = get_collection(row[1])
			descendants.append(col_desc)
			descendants += col_desc.get_descendants()
			return descendants

			def write_cache_file(self, filename='', filebody=''):
			"Write a file inside collection cache."
			# open file:
			dirname = "%s/collections/%d" % (cachedir, self.id)
			mymkdir(dirname)
			fullfilename = dirname + "/%s.html" % filename
			try:
			os.umask(022)
			f = open(fullfilename, "w")
			except IOError, v:
			try:
			(code, message) = v
			except:
			code = 0
			message = v
			print "I/O Error: " + str(message) + " (" + str(code) + ")"
			sys.exit(1)
			# print user info:
			if options["verbose"]:
			write_message("... creating %s" % fullfilename)
			sys.stdout.flush()
			# print page body:
			f.write(filebody)
			# close file:
			f.close()

			def update_webpage_cache(self):
			"""Create collection page header, navtrail, body (including left and right stripes) and footer, and
			call write_cache_file() afterwards to update the collection webpage cache."""
			## do this for each language:
			for lang in ['de', 'en', 'es', 'fr', 'it', 'ru', 'sk', 'cz']:
			## first, update navtrail:
			for as in range(0,2):
			self.write_cache_file("navtrail-as=%s-ln=%s" % (as, lang), self.create_navtrail_links(as, lang))
			## second, update page body:
			for as in range(0,2): # do both simple search and advanced search pages:
			body = ""
			body += """<form action="%s/search.py" method="get">""" % weburl
			body += self.create_portalbox('te')
			body += "" + self.create_searchfor(as, lang)
			body += self.create_portalbox('np')
			body += """<table cellspacing="0" cellpadding="0" border="0">"""
			body += """<tr>"""
			body += """<td valign="top">""" + self.create_narrowsearch(as, lang, msg_narrow_search[lang]) + "</td>"
			body_focuson = self.create_narrowsearch(as, lang, msg_focus_on[lang], "v")
			if body_focuson:
			body += """<td valign="top">""" + body_focuson + """</td>"""
			body += "</tr></table>"
			body += self.create_portalbox('ne')
			body += "</form>"
			self.write_cache_file("body-as=%s-ln=%s" % (as, lang), body)
			## third, write portalboxes:
			self.write_cache_file("portalbox-lt-ln=%s" % lang, self.create_portalbox("lt"))
			self.write_cache_file("portalbox-lb-ln=%s" % lang, self.create_portalbox("lb"))
			self.write_cache_file("portalbox-rt-ln=%s" % lang, self.create_portalbox("rt"))
			self.write_cache_file("portalbox-rb-ln=%s" % lang, self.create_portalbox("rb"))
			## fourth, write 'last updated' information:
			self.write_cache_file("last-updated-ln=%s" % lang, time.strftime("%02d %b %04Y %02H:%02M:%02S %Z", time.localtime()))
			return

			def create_navtrail_links(self, \
			as=0,
			ln=cdslang,
			separator=" > "):
			"""Creates navigation trail links, i.e. links to collection ancestors (except Home collection).
			If as==1, then links to Advanced Search interfaces; otherwise Simple Search.
			"""
			out = ""
			for dad in self.get_ancestors():
			if dad.name != cdsname: # exclude Home collection
			if out:
			out += separator
			out += """<a class="navtrail" href="%s/?c=%s&as=%d&ln=%s">%s</a>""" % \
			(weburl, urllib.quote_plus(dad.name), as, ln, dad.name)
			return out

			def create_nbrecs_info(self, prolog=""" <small class="nbdoccoll">(""", epilog=""")</small>"""):
			"Return information on the number of records."
			out = ""
			if self.nbrecs:
			out = prolog + nice_number(self.nbrecs) + epilog
			return out

			def create_portalbox(self, position="rt"):
			"""Creates portalboxes of the position 'position' by consulting MySQL configuration database.
			The position may be: 'lt'='left top', 'lb'='left bottom', 'rt'='right top', 'rb'='right bottom',
			'tl'='top left', 'tr'='top right', 'bl'='bottom left', 'br='bottom right'."""
			out = ""
			query = "SELECT p.title,p.body FROM portalbox AS p, collection_portalbox AS cp "\
			" WHERE cp.id_collection=%d AND p.id=cp.id_portalbox AND cp.position='%s' "\
			" ORDER BY cp.score DESC" % (self.id, position)
			res = run_sql(query)
			for row in res:
			title, body = row[0], row[1]
			if title:
			out += """<table class="portalbox" width="100%%">
			<thead>
			<tr>
			<th class="portalboxheader">%s</th>
			</tr>
			</thead>
			<tbody>
			<tr>
			<td class="portalboxbody">%s</td>
			</tr>
			</tbody>
			</table>""" % (title, body)
			else:
			# no title specified, so print body ``as is'' only:
			out += body
			return out

			def create_narrowsearch(self, as=0, ln=cdslang, title="Narrow search", type="r"):
			"""Creates list of collection descendants of type 'type' under title 'title'.
			If as==1, then links to Advanced Search interfaces; otherwise Simple Search.
			Suitable for 'Narrow search' and 'Focus on' boxes."""
			narrowsearch=""
			# return nothing for type 'v' (virtual collection) if there are no sons:
			if type == 'v' and not self.get_sons(type):
			return ""
			# firstly write silent 'cc' (=current collection) argument:
			if type == 'r': # but not for virtual collections
			narrowsearch += """<input type="hidden" name="cc" value="%s">""" % self.name
			# then get list of sons and analyse it:
			sons = self.get_sons(type)
			# decide upon writing style: if there are grandchildren, then print in bold
			descendants = self.get_descendants(type)
			if len(descendants)>len(sons):
			style_prolog = "<strong>"
			style_epilog = "</strong>"
			else:
			style_prolog = ""
			style_epilog = ""
			# are there some sons?
			if len(sons):
			narrowsearch += """<table class="narrowsearchbox">
			<thead>
			<tr>
			<th colspan="2" align="left" class="narrowsearchboxheader">
			%s
			</th>
			</tr>
			</thead>
			<tbody>""" % title
			# iterate through sons:
			for son in sons:
			narrowsearch += """<tr><td class="narrowsearchboxbody" valign="top">"""
			if type=='r':
			if son.restricted_p() and son.restricted_p() != self.restricted_p():
			narrowsearch += """<input type=checkbox name="c" value="%s"> </td>""" % son.name
			else:
			narrowsearch += """<input type=checkbox name="c" value="%s" checked> </td>""" % son.name
			narrowsearch += """<td valign="top"><a href="%s/?c=%s&as=%d&ln=%s">%s%s%s</a>%s """ % \
			(weburl, urllib.quote_plus(son.name), as, ln, style_prolog, son.name, style_epilog, son.create_nbrecs_info())
			if son.restricted_p():
			narrowsearch += """ <small class="warning">[restricted]</small>"""
			if cfg_narrow_search_show_grandsons:
			# iterate trough grandsons:
			grandsons = son.get_sons()
			nb_grandsons = len(grandsons)
			if nb_grandsons:
			narrowsearch += """<br>"""
			for i in range(0,nb_grandsons):
			narrowsearch += """<a href="%s/?c=%s&as=%d&ln=%s">%s</a>%s """ % \
			(weburl, urllib.quote_plus(grandsons[i].name), as, ln, grandsons[i].name, \
			grandsons[i].create_nbrecs_info())
			narrowsearch += """</td></tr>"""
			narrowsearch += "</tbody></table>"
			else:
			if type == 'r':
			# no sons, and type 'r', so print info on collection content:
			narrowsearch += """<table class="narrowsearchbox">
			<thead>
			<tr>
			<th class="narrowsearchboxheader">
			Latest additions:
			</th>
			</tr>
			</thead>
			<tbody>
			<tr>
			<td class="narrowsearchboxbody">%s</td>
			</tr>
			<tbody>
			</table>""" % self.create_instant_browse()

			return narrowsearch

			def create_instant_browse(self, rg=cfg_instant_browse):
			"Searches database and produces list of last 'rg' records."
			box = ""
			if self.restricted_p():
			box += """<small><strong>Restricted!</strong></small><br> This collection has restricted content."""
			else:
			url = "%s/search.py?cc=%s&jrec=%d" % (weburl, urllib.quote_plus(self.name), rg+1)
			if self.nbrecs and self.reclist:
			# firstly, get last 'rg' records:
			box += "<ol>"
			recIDs = Numeric.nonzero(self.reclist._set)
			for idx in range(self.nbrecs-1, self.nbrecs-rg-1, -1):
			if idx>=0:
			box += """<li><p><small>""" + print_record(recIDs[idx]) + "</small></p>"
			box += "</ol>"
			if self.nbrecs > rg:
			box += """<div align="right"><small><a href="%s">[>> more]</a></small></div>""" % url
			else:
			box += """<small><strong>No records! </strong></small><br> This collection does not contain any document yet."""
			return box

			def create_searchoptions(self):
			"Produces 'Search options' portal box."
			# TODO: distinguish name/nameshort, i.e. naviguable/non-naviguable search options
			box=""
			query = """SELECT DISTINCT(cff.id_field),f.code,f.nameshort FROM collection_field_fieldvalue AS cff, field AS f
			WHERE cff.id_collection=%d AND cff.id_fieldvalue IS NOT NULL AND cff.id_field=f.id
			ORDER BY cff.score DESC""" % self.id
			res = run_sql(query)
			if res:
			for row in res:
			field_id = row[0]
			field_code = row[1]
			field_name = row[2]
			query_bis = """SELECT fv.value,fv.nameshort FROM fieldvalue AS fv, collection_field_fieldvalue AS cff
			WHERE cff.id_collection=%d AND cff.type='seo' AND cff.id_field=%d AND fv.id=cff.id_fieldvalue
			ORDER BY cff.score_fieldvalue DESC, cff.score DESC, fv.nameshort ASC""" % (self.id, field_id)
			res_bis = run_sql(query_bis)
			if res_bis:
			box += """<select name="%s">""" % field_code
			box += """<option value="">any %s""" % field_name
			for row_bis in res_bis:
			box += """<option value="%s">%s""" % (cgi.escape(row_bis[0], 1), row_bis[1])
			box += """</select>"""
			return box

			def create_inputdate(self, name="d1"):
			"Produces 'From Date', 'Until Date' kind of selection box. Suitable for search options."
			box = ""
			# day
			box += """<select name="%sd">""" % name
			box += """<option value="">any day"""
			for day in range(1,32):
			box += """<option value="%02d">%02d""" % (day, day)
			box += """</select>"""
			# month
			box += """<select name="%sm">""" % name
			box += """<option value="">any month"""
			for mm, month in [('01','January'), ('02','February'), ('03','March'), ('04','April'), \
			('05','May'), ('06','June'), ('07','July'), ('08','August'), \
			('09','September'), ('10','October'), ('11','November'), ('12','December')]:
			box += """<option value="%s">%s""" % (mm, month)
			box += """</select>"""
			# year
			box += """<select name="%sy">""" % name
			box += """<option value="">any year"""
			for year in range(1980,2004):
			box += """<option value="%d">%d""" % (year, year)
			box += """</select>"""
			return box

			def create_publishedin(self, title="From date", name="d1"):
			"""Produces 'Published in' selection box, if collection name contains the text 'Articles'.
			Suitable for advanced search option."""
			out = ""
			if string.find(self.name, "Article") == -1:
			return out
			# journal title:
			cell_1a = "<small><strong>Published in:</strong></small><br>"
			cell_1a += """<select name="pt">"""
			cell_1a += """<option value="Phys. Rev. A">Phys. Rev. A"""
			cell_1a += """<option value="Phys. Rev. B">Phys. Rev. B"""
			cell_1a += """<option value="Phys. Rev. C">Phys. Rev. C"""
			cell_1a += """<option value="Phys. Rev. D">Phys. Rev. D"""
			cell_1a += """<option value="Phys. Rev. E">Phys. Rev. E"""
			cell_1a += """</select>"""
			# volume:
			cell_1b = "<small><strong>Volume:</strong></small><br>"
			cell_1b += """<input type="text" name="pv" size="4" value="">"""
			# year:
			cell_1c = "<small><strong>Year:</strong></small><br>"
			cell_1c += """<input type="text" name="py" size="4" value="">"""
			# page:
			cell_1d = "<small><strong>Page:</strong></small><br>"
			cell_1d += """<input type="text" name="pp" size="4" value="">"""
			out += """<table cellpadding="3" cellspacing="0">
			<tr>
			<td colspan="3" height="3">
			</td>
			</tr>
			<tr valign="bottom" class="searchbox">
			<td align="left">%s</td>
			<td align="left">%s</td>
			<td align="left">%s</td>
			<td align="left">%s</td>
			</tr>
			</table>""" % \
			(cell_1a, cell_1b, cell_1c, cell_1d)
			return out

			def create_sortoptions(self, ln=cdslang):
			"Produces 'Sort options' portal box."
			box=""
			query = """SELECT f.code,f.nameshort FROM field AS f, collection_field_fieldvalue AS cff
			WHERE id_collection=%d AND cff.type='soo' AND cff.id_field=f.id
			ORDER BY cff.score DESC, f.name ASC""" % self.id
			box += """<select name="sf">"""
			box += """ <option value="">- %s -""" % msg_latest_first[ln]
			res = run_sql(query)
			if res:
			for row in res:
			box += """ <option value="%s">%s""" % (row[0], row[1])
			else:
			for field in ('title','author','report number','year'):
			box += """ <option value="%s">%s""" % (field, field)
			box += """</select>"""
			box += """<select name="so">
			<option value="a">%s
			<option value="d">%s
			</select>""" % (msg_ascending[ln], msg_descending[ln])
			return box

			def create_displayoptions(self):
			"Produces 'Display options' portal box."
			box=""
			# firstly, display hits per collection selection box:
			box += """<select name="rg">
			<option value=10>10 results
			<option value=25>25 results
			<option value=50>50 results
			<option value=10>100 results
			<option value=25>250 results
			<option value=50>500 results
			</select>"""
			# secondly, display split by collection selection box:
			if self.get_sons():
			box += """<select name="sc">
			<option value="1">split by collection
			<option value="0">single list
			</select>"""
			return box

			def create_formatoptions(self):
			"Produces 'Output format options' portal box."
			box = ""
			box += """<select name="of">
			"""
			query = """SELECT f.code,f.name FROM format AS f, collection_format AS cf
			WHERE cf.id_collection=%d AND cf.id_format=f.id ORDER BY cf.score DESC, f.name ASC""" % self.id
			res = run_sql(query)
			if res:
			# propose found formats:
			for row in res:
			box += """<option value="%s">%s""" % (row[0],row[1])
			else:
			# no formats are defined for this collection, so propose the default HTML one:
			box += """<option value="hb">HTML brief"""
			box += """</select>"""
			return box

			def create_searchwithin_selection_box(self, fieldname='f', value='', ln='en'):
			"Produces 'search within' selection box for the current collection."
			out = ""
			out += """<select name="%s">""" % fieldname
			out += """<option value="">%s""" % msg_any_field[ln]
			query = """SELECT f.code,f.name FROM field AS f, collection_field_fieldvalue AS cff
			WHERE cff.type='sew' AND cff.id_collection=%d AND cff.id_field=f.id
			ORDER BY cff.score DESC, f.name ASC""" % self.id
			res = run_sql(query)
			if res:
			# propose found 'search within' fields:
			for row in res:
			out += """<option value="%s"%s>%s""" % (row[0], is_selected(row[0], value), row[1])
			else:
			# no 'search within' fields are defined for this collection, so propose default ones:
			if cfg_cern_site:
			out += """<option value="title"%s>%s""" % (is_selected("title", value), msg_title[ln])
			out += """<option value="author"%s>%sr""" % (is_selected("author", value), msg_author[ln])
			out += """<option value="reportnumber"%s>%s""" % (is_selected("reportnumber", value), msg_report_number[ln])
			out += """<option value="year"%s>%s""" % (is_selected("year", value), msg_year[ln])
			else:
			out += """<option value="title"%s>- %s""" % (is_selected("title", value), msg_title[ln])
			out += """<option value="author"%s>- %s""" % (is_selected("author", value), msg_author[ln])
			out += """<option value="abstract"%s>- %s""" % (is_selected("abstract", value), msg_abstract[ln])
			out += """<option value="keyword"%s>- %s""" % (is_selected("keyword", value), msg_keyword[ln])
			out += """<option value="reportnumber"%s>- %s""" % (is_selected("reportnumber", value), msg_report_number[ln])
			out += """<option value="year"%s>- %s""" % (is_selected("year", value), msg_year[ln])
			out += """<option value="fulltext"%s>%s""" % (is_selected("fulltext", value), msg_fulltext[ln])
			out += """<option value="reference"%s>%s""" % (is_selected("reference", value), msg_reference[ln])
			out += """</select>"""
			return out

			def create_searchexample(self):
			"Produces search example(s) for the current collection."
			out = "$collSearchExamples = getSearchExample(%d, $se);" % self.id
			return out

			def create_searchfor(self, as=0, ln=cdslang):
			"Produces either Simple or Advanced 'Search for' box for the current collection."
			if as == 1:
			return self.create_searchfor_advanced(ln)
			else:
			return self.create_searchfor_simple(ln)

			def create_searchfor_simple(self, ln=cdslang):
			"Produces simple 'Search for' box for the current collection."
			# print commentary start:
			out = "<!--create_searchfor_simple()-->"
			out += """<input type="hidden" name="sc" value="1">"""
			out += """<input type="hidden" name="ln" value="%s">""" % ln
			# define URL add-ons for simple and advanced search boxen:
			if self.name != cdsname:
			ssearchurl = "?c=%s&as=0&ln=%s" % (urllib.quote_plus(self.name), ln)
			asearchurl = "?c=%s&as=1&ln=%s" % (urllib.quote_plus(self.name), ln)
			else: # hide cdsname for aesthetical reasons
			ssearchurl = "?as=0&ln=%s" % ln
			asearchurl = "?as=1&ln=%s" % ln
			# define search box elements:
			header = msg_search_records_for[ln] % self.create_nbrecs_info("","")
			cell_1_left = """<input type="text" name="p" size="40" value="">"""
			cell_1_middle = "%s" % self.create_searchwithin_selection_box(ln=ln)
			cell_1_right = """<input class="formbutton" type="submit" name="action" value="%s"><input class="formbutton" type="submit" name="action" value="%s">""" % (msg_search[ln], msg_browse[ln])
			cell_2 = """<small><a href="%s/help/search/tips.%s.html">%s</a> :: <a href="%s">%s</a></small>""" \
			% (weburl, ln, msg_search_tips[ln], asearchurl, msg_advanced_search[ln])
			# merge them:
			out += """<table class="searchbox">
			<thead>
			<tr align="left">
			<th colspan="3" class="searchboxheader">%s</th>
			</tr>
			</thead>
			<tbody>
			<tr valign="baseline">
			<td class="searchboxbody" align="left">%s</td>
			<td class="searchboxbody" align="left">%s</td>
			<td class="searchboxbody" align="left">%s</td>
			</tr>
			<tr valign="baseline">
			<td class="searchboxbody" colspan="3" align="right">%s</td>
			</tr>
			</tbody>
			</table>""" % \
			(header,
			cell_1_left, cell_1_middle, cell_1_right,
			cell_2)
			# print commentary end:
			out += "<!--/create_searchfor_simple()-->"
			return out

			def create_searchfor_advanced(self, ln=cdslang):
			"Produces simple 'Search for' box for the current collection."
			# print commentary start:
			out = "<!--create_searchfor_advanced()-->"
			out += """<input type="hidden" name="as" value="1">"""
			out += """<input type="hidden" name="ln" value="%s">""" % ln
			# define URL add-ons for simple and advanced search boxen:
			if self.name != cdsname:
			ssearchurl = "?c=%s&as=0&ln=%s" % (urllib.quote_plus(self.name), ln)
			asearchurl = "?c=%s&as=1&ln=%s" % (urllib.quote_plus(self.name), ln)
			else: # hide cdsname for aesthetical reasons
			ssearchurl = "?as=0&ln=%s" % ln
			asearchurl = "?as=1&ln=%s" % ln
			# define search box elements:
			header = msg_search_records_for[ln] % self.create_nbrecs_info("", "")
			cell_1_left = create_matchtype_box('m1', ln=ln) + """<input type="text" name="p1" size="40" value="">"""
			cell_1_middle = self.create_searchwithin_selection_box('f1', ln=ln)
			cell_1_right = create_andornot_box('op1', ln=ln)
			cell_2_left = create_matchtype_box('m2', ln=ln) + """<input type="text" name="p2" size="40" value="">"""
			cell_2_middle = self.create_searchwithin_selection_box('f2', ln=ln)
			cell_2_right = create_andornot_box('op2', ln=ln)
			cell_3_left = create_matchtype_box('m3', ln=ln) + """<input type="text" name="p3" size="40" value="">"""
			cell_3_middle = self.create_searchwithin_selection_box('f3', ln=ln)
			cell_3_right = """<input class="formbutton" type="submit" name="search" value="%s"><input class="formbutton" type="submit" name="search" value="%s"> """ % (msg_search[ln], msg_browse[ln])
			cell_4 = """<small><a href="%s/help/search/tips.%s.html">%s</a> :: <a href="%s">%s</a></small>""" \
			% (weburl, ln, msg_search_tips[ln], ssearchurl, msg_simple_search[ln])
			# merge them:
			out += """<table class="searchbox">
			<thead>
			<tr>
			<th class="searchboxheader" colspan="3">%s</th>
			</tr>
			</thead>
			<tbody>
			<tr valign="bottom">
			<td nowrap>%s</td>
			<td class="searchboxbody">%s</td>
			<td class="searchboxbody">%s</td>
			</tr>
			<tr valign="bottom">
			<td class="searchboxbody" nowrap>%s</td>
			<td class="searchboxbody">%s</td>
			<td class="searchboxbody">%s</td>
			</tr>
			<tr valign="bottom">
			<td class="searchboxbody" nowrap>%s</td>
			<td class="searchboxbody">%s</td>
			<td class="searchboxbody" nowrap>%s</td>
			</tr>
			<tr valign="bottom">
			<td colspan="3" class="searchboxbody" align="right">%s</td>
			</tr>
			</tbody>
			</table>""" % \
			(header,
			cell_1_left, cell_1_middle, cell_1_right, \
			cell_2_left, cell_2_middle, cell_2_right, \
			cell_3_left, cell_3_middle, cell_3_right, \
			cell_4)
			# create more search options, if any:
			if self.create_searchoptions():
			out += """<table class="searchbox">
			<thead>
			<tr>
			<th class="searchboxheader">
			Search options:
			</th>
			</tr>
			</thead>
			<tbody>
			<tr valign="bottom">
			<td class="searchboxbody">%s</td>
			</tr>
			<tbody>
			</table>""" % self.create_searchoptions()
			if 0:
			# TODO: create published in, if appropriate:
			if self.create_publishedin():
			out += self.create_publishedin()
			# arrival date: from/until:
			cell_6_a = self.create_inputdate("d1")
			cell_6_b = self.create_inputdate("d2")
			out += """<table class="searchbox">
			<thead>
			<tr>
			<th class="searchboxheader">
			Added since:
			</th>
			<th class="searchboxheader">
			until:
			</th>
			</tr>
			</thead>
			<tbody>
			<tr valign="bottom">
			<td class="searchboxbody">%s</td>
			<td class="searchboxbody">%s</td>
			</tr>
			</tbody>
			</table>""" % \
			(cell_6_a, cell_6_b)
			# format options, etc in the last table:
			cell_7_a = self.create_sortoptions(ln)
			cell_7_b = self.create_displayoptions()
			cell_7_c = self.create_formatoptions()
			out += """<table class="searchbox">
			<thead>
			<tr>
			<th class="searchboxheader">
			%s
			</th>
			<th class="searchboxheader">
			%s
			</th>
			<th class="searchboxheader">
			%s
			</th>
			</tr>
			</thead>
			<tbody>
			<tr valign="bottom">
			<td class="searchboxbody">%s</td>
			<td class="searchboxbody">%s</td>
			<td class="searchboxbody">%s</td>
			</tr>
			</tbody>
			</table>""" % \
			(msg_sort_by[ln], msg_display_results[ln], msg_output_format[ln], cell_7_a, cell_7_b, cell_7_c)
			# print commentary end:
			out += "<!--/create_searchfor_advanced()-->"
			return out

			def calculate_reclist(self):
			"""Calculate, set and return the (reclist, reclist_with_nonpublic_subcolls) tuple for given collection."""
			if self.calculate_reclist_run_already:
			# do we have to recalculate?
			return (self.reclist, self.reclist_with_nonpublic_subcolls)
			if options["verbose"]:
			write_message("... calculating reclist of %s" % self.name)
			reclist = HitSet() # will hold results for public sons only; good for storing into DB
			reclist_with_nonpublic_subcolls = HitSet() # will hold results for both public and nonpublic sons; good for deducing total
			# number of documents
			if not self.dbquery:
			# A - collection does not have dbquery, so query recursively all its sons
			# that are either non-restricted or that have the same restriction rules
			for coll in self.get_sons():
			coll_reclist, coll_reclist_with_nonpublic_subcolls = coll.calculate_reclist()
			if ((coll.restricted_p() is None) or
			(coll.restricted_p() == self.restricted_p())):
			# add this reclist ``for real'' only if it is public
			reclist.union(coll_reclist)
			reclist_with_nonpublic_subcolls.union(coll_reclist_with_nonpublic_subcolls)
			else:
			# B - collection does have dbquery, so compute it:
			reclist = search_pattern(None,self.dbquery)
			reclist_with_nonpublic_subcolls = copy.deepcopy(reclist)
			# deduce the number of records:
			reclist.calculate_nbhits()
			reclist_with_nonpublic_subcolls.calculate_nbhits()
			# store the results:
			self.nbrecs = reclist_with_nonpublic_subcolls._nbhits
			self.reclist = reclist
			self.reclist_with_nonpublic_subcolls = reclist_with_nonpublic_subcolls
			# last but not least, update the speed-up flag:
			self.calculate_reclist_run_already = 1
			# return the two sets:
			return (self.reclist, self.reclist_with_nonpublic_subcolls)

			def update_reclist(self):
			"Update the record universe for given collection; nbrecs, reclist of the collection table."
			if self.update_reclist_run_already:
			# do we have to reupdate?
			return 0
			if options["verbose"]:
			write_message("... updating reclist of %s (%s recs)" % (self.name, self.nbrecs))
			sys.stdout.flush()
			try:
			query = "UPDATE collection SET nbrecs=%d, reclist='%s' WHERE id=%d" % \
			(self.nbrecs, escape_string(zlib.compress(Numeric.dumps(self.reclist._set))), self.id)
			res = run_sql(query)
			self.reclist_updated_since_start = 1
			except MySQLdb.Error, e:
			print "Database Query Error %d: %s." % (e.args[0], e.args[1])
			sys.exit(1)
			# last but not least, update the speed-up flag:
			self.update_reclist_run_already = 1
			return 0

			def usage(code, msg=''):
			"Prints usage info."
			if msg:
			sys.stderr.write("Error: %s.\n" % msg)
			sys.stderr.write("Usage: %s <action> [collection][+]\n" % sys.argv[0])
			sys.stderr.write("""Description:
			%s updates the collection cache
			(record universe for a given collection plus web page elements)
			based on WML and MySQL configuration parameters.
			If the collection name is passed as the second argument, it'll update
			this collection only. If the collection name is immediately followed
			by a plus sign, it will also update all its desdendants. The
			top-level collection name may be entered as the void string.\n""" % sys.argv[0])
			sys.stderr.write("Example: %s update-reclist\n" % sys.argv[0])
			sys.stderr.write("Example: %s update-webpage\n" % sys.argv[0])
			sys.stderr.write("Example: %s update-webpage \"Articles & Preprints\"\n" % sys.argv[0])
			sys.stderr.write("Example: %s update-webpage \"Articles & Preprints\"+\n" % sys.argv[0])
			sys.stderr.write("Example: %s update-webpage \"\"\n" % sys.argv[0])
			sys.stderr.write("Example: %s update-reclist \"\"+\n" % sys.argv[0])
			sys.exit(code)

			def get_datetime(var, format_string="%Y-%m-%d %H:%M:%S"):
			"""Returns a date string according to the format string.
			It can handle normal date strings and shifts with respect
			to now."""
			date = time.time()
			shift_re=sre.compile("([-\+]{0,1})([\d]+)([dhms])")
			factors = {"d":24*3600, "h":3600, "m":60, "s":1}
			m = shift_re.match(var)
			if m:
			sign = m.groups()[0] == "-" and -1 or 1
			factor = factors[m.groups()[2]]
			value = float(m.groups()[1])
			date = time.localtime(date + sign * factor * value)
			date = time.strftime(format_string, date)
			else:
			date = time.strptime(var, format_string)
			date = time.strftime(format_string, date)
			return date

			def write_message(msg, stream=sys.stdout):
			"""Prints message and flush output stream (may be sys.stdout or sys.stderr)."""
			if stream == sys.stdout or stream == sys.stderr:
			stream.write(time.strftime("%Y-%m-%d %H:%M:%S --> ", time.localtime()))
			stream.write("%s\n" % msg)
			stream.flush()
			else:
			sys.stderr.write("Unknown stream %s. [must be sys.stdout or sys.stderr]\n" % stream)

			def task_sig_sleep(sig, frame):
			"""Signal handler for the 'sleep' signal sent by BibSched."""
			if options["verbose"] >= 9:
			write_message("got signal %d" % sig)
			write_message("sleeping...")
			task_update_status("SLEEPING")
			signal.pause() # wait for wake-up signal

			def task_sig_wakeup(sig, frame):
			"""Signal handler for the 'wakeup' signal sent by BibSched."""
			if options["verbose"] >= 9:
			write_message("got signal %d" % sig)
			write_message("continuing...")
			task_update_status("CONTINUING")

			def task_sig_stop(sig, frame):
			"""Signal handler for the 'stop' signal sent by BibSched."""
			if options["verbose"] >= 9:
			write_message("got signal %d" % sig)
			write_message("stopping...")
			task_update_status("STOPPING")
			pass # FIXME: is there anything to be done?
			task_update_status("STOPPED")
			sys.exit(0)

			def task_sig_suicide(sig, frame):
			"""Signal handler for the 'suicide' signal sent by BibSched."""
			if options["verbose"] >= 9:
			write_message("got signal %d" % sig)
			write_message("suiciding myself now...")
			task_update_status("SUICIDING")
			write_message("suicided")
			task_update_status("SUICIDED")
			sys.exit(0)

			def task_sig_unknown(sig, frame):
			"""Signal handler for the other unknown signals sent by shell or user."""
			write_message("unknown signal %d ignored" % sig) # do nothing for other signals

			def getpass(prompt = "Password: "):
			"""Prompts for a password without echoing it back to the screen"""
			import termios, sys
			fd = sys.stdin.fileno()
			old = termios.tcgetattr(fd)
			new = termios.tcgetattr(fd)
			new[3] = new[3] & ~termios.ECHO # lflags
			passwd = ""
			try:
			termios.tcsetattr(fd, termios.TCSADRAIN, new)
			passwd = raw_input(prompt)
			print
			finally:
			termios.tcsetattr(fd, termios.TCSADRAIN, old)
			return passwd

			def authenticate(user):
			"""Authenticates a user against the user database.
			NOTE: Access might be more complex in the future"""
			print "WebColl Task Submission"
			print "======================="
			if user == "":
			print >> sys.stdout, "\rUsername: ",
			user = string.strip(string.lower(sys.stdin.readline()))
			else:
			print >> sys.stdout, "\rUsername:", user
			res = run_sql("select password from user where email=%s", (user,), 1)
			if res:
			row = res[0]
			password_db = row[0]
			if password_db != '':
			# authentication needed
			password_entered = getpass()
			if password_db == password_entered:
			return user
			else:
			print "Sorry, you seem to be unauthorized user. Exiting."
			sys.exit(1)
			else:
			# no authentication needed
			return user
			else:
			print "Sorry, %s seems to be unauthorized user. Exiting." % user
			sys.exit(1)

			def task_submit(options):
			"""Submits task to the BibSched task queue. This is what people will be invoking via command line."""
			## sanity check: remove eventual "task" option:
			if options.has_key("task"):
			del options["task"]
			## authenticate user:
			user = authenticate(options.get("user", ""))
			## submit task:
			if options["verbose"] >= 9:
			print ""
			write_message("storing task options %s\n" % options)
			task_id = run_sql("""INSERT INTO schTASK (id,proc,user,runtime,sleeptime,status,arguments)
			VALUES (NULL,'webcoll',%s,%s,%s,'WAITING',%s)""",
			(user, options["runtime"], options["sleeptime"], marshal.dumps(options)))
			## update task number:
			options["task"] = task_id
			run_sql("""UPDATE schTASK SET arguments=%s WHERE id=%s""", (marshal.dumps(options),task_id))
			write_message("Task #%d submitted." % task_id)
			return task_id

			def task_update_progress(msg):
			"""Updates progress information in the BibSched task table."""
			global task_id
			return run_sql("UPDATE schTASK SET progress=%s where id=%s", (msg, task_id))

			def task_update_status(val):
			"""Updates status information in the BibSched task table."""
			global task_id
			return run_sql("UPDATE schTASK SET status=%s where id=%s", (val, task_id))

			def task_read_status(task_id):
			"""Read status information in the BibSched task table."""
			res = run_sql("SELECT status FROM schTASK where id=%s", (task_id,), 1)
			try:
			out = res[0][0]
			except:
			out = 'UNKNOWN'
			return out

			def task_get_options(id):
			"""Returns options for the task 'id' read from the BibSched task queue table."""
			out = {}
			res = run_sql("SELECT arguments FROM schTASK WHERE id=%s AND proc='webcoll'", (id,))
			try:
			out = marshal.loads(res[0][0])
			except:
			write_message("Error: WebColl task %d does not seem to exist." % id)
			sys.exit(1)
			return out

			def task_run():
			"""Run the WebColl task by fetching arguments from the BibSched task queue.
			This is what BibSched will be invoking via daemon call.
			The task will update collection reclist cache and collection web pages for
			given collection. (default is all).
			Arguments described in usage() function.
			Return 1 in case of success and 0 in case of failure."""
			global task_id, options
			options = task_get_options(task_id) # get options from BibSched task table
			## check task id:
			if not options.has_key("task"):
			write_message("Error: The task #%d does not seem to be a WebColl task." % task_id)
			return 0
			## check task status:
			task_status = task_read_status(task_id)
			if task_status != "WAITING":
			write_message("Error: The task #%d is %s. I expected WAITING." % (task_id, task_status))
			return 0
			## we can run the task now:
			if options["verbose"]:
			write_message("Task #%d started." % task_id)
			task_update_status("RUNNING")
			## initialize signal handler:
			signal.signal(signal.SIGUSR1, task_sig_sleep)
			signal.signal(signal.SIGTERM, task_sig_stop)
			signal.signal(signal.SIGABRT, task_sig_suicide)
			signal.signal(signal.SIGCONT, task_sig_wakeup)
			signal.signal(signal.SIGINT, task_sig_unknown)
			colls = []
			# firstly, decide which collections to do:
			if options.has_key("collection"):
			coll = get_collection(options["collection"])
			if coll.id == None:
			usage(1, 'Collection %s does not exist' % coll_name)
			colls.append(coll)
			else:
			res = run_sql("SELECT name FROM collection ORDER BY id")
			for row in res:
			colls.append(get_collection(row[0]))

			# secondly, update collection reclist cache:
			i = 0
			for coll in colls:
			i += 1
			if options["verbose"]:
			write_message("%s / reclist cache update" % coll.name)
			coll.calculate_reclist()
			coll.update_reclist()
			task_update_progress("Part 1/2: done %d/%d." % (i,len(colls)))
			# thirdly, update collection webpage cache:
			i = 0
			for coll in colls:
			i += 1
			if options["verbose"]:
			write_message("%s / web cache update" % coll.name)
			coll.update_webpage_cache()
			task_update_progress("Part 2/2: done %d/%d." % (i,len(colls)))
			## we are done:
			task_update_progress("Done.")
			task_update_status("DONE")
			if options["verbose"]:
			write_message("Task #%d finished." % task_id)
			return 1

			def usage(exitcode=1, msg=""):
			"""Prints usage info."""
			if msg:
			sys.stderr.write("Error: %s.\n" % msg)
			sys.stderr.write("Usage: %s [options]\n" % sys.argv[0])
			sys.stderr.write("Command options:\n")
			sys.stderr.write(" -c, --collection\t Update only given collection. [all]\n")
			sys.stderr.write("Scheduling options:\n")
			sys.stderr.write(" -u, --user=USER \t User name to submit the task as, password needed.\n")
			sys.stderr.write(" -t, --runtime=TIME \t Time to execute the task (now), e.g.: +15s, 5m, 3h, 2002-10-27 13:57:26\n")
			sys.stderr.write(" -s, --sleeptime=SLEEP \t Sleeping frequency after which to repeat task (no), e.g.: 30m, 2h, 1d\n")
			sys.stderr.write("General options:\n")
			sys.stderr.write(" -h, --help \t\t Print this help.\n")
			sys.stderr.write(" -V, --version \t\t Print version information.\n")
			sys.stderr.write(" -v, --verbose=LEVEL \t Verbose level (from 0 to 9, default 1).\n")
			sys.stderr.write("""Description: %s updates the collection cache
			(record universe for a given collection plus web page elements)
			based on WML and MySQL configuration parameters.
			If the collection name is passed as the second argument, it'll update
			this collection only. If the collection name is immediately followed
			by a plus sign, it will also update all its desdendants. The
			top-level collection name may be entered as the void string.\n""" % sys.argv[0])
			sys.exit(exitcode)

			def main():
			"""Main function that analyzes command line input and calls whatever is appropriate.
			Useful for learning on how to write BibSched tasks."""
			global task_id
			## parse command line:
			if len(sys.argv) == 2 and sys.argv[1].isdigit():
			## A - run the task
			task_id = int(sys.argv[1])
			try:
			if not task_run():
			write_message("Error occurred. Exiting.", sys.stderr)
			except StandardError, e:
			write_message("Unexpected error occurred: %s." % e, sys.stderr)
			write_message("Traceback is:", sys.stderr)
			traceback.print_tb(sys.exc_info()[2])
			write_message("Exiting.", sys.stderr)
			task_update_status("ERROR")
			else:
			## B - submit the task
			# set default values:
			options["runtime"] = time.strftime("%Y-%m-%d %H:%M:%S")
			options["verbose"] = 1
			options["sleeptime"] = 0
			# set user-defined options:
			try:
			opts, args = getopt.getopt(sys.argv[1:], "hVv:u:s:t:c:",
			["help", "version", "verbose=","user=","sleep=","time=","collection="])
			except getopt.GetoptError, err:
			usage(1, err)
			try:
			for opt in opts:
			if opt[0] in ["-h", "--help"]:
			usage(0)
			elif opt[0] in ["-V", "--version"]:
			print __version__
			sys.exit(0)
			elif opt[0] in [ "-u", "--user"]:
			options["user"] = opt[1]
			elif opt[0] in ["-v", "--verbose"]:
			options["verbose"] = int(opt[1])
			elif opt[0] in [ "-s", "--sleeptime" ]:
			get_datetime(opt[1]) # see if it is a valid shift
			options["sleeptime"] = opt[1]
			elif opt[0] in [ "-t", "--runtime" ]:
			options["runtime"] = get_datetime(opt[1])
			elif opt[0] in [ "-c", "--collection"]:
			options["collection"] = opt[1]
			else:
			usage(1)
			except StandardError, e:
			usage(e)
			task_submit(options)
			return

			### okay, here we go:
			if __name__ == '__main__':
			main()

R3600/modules/websearch/bin/webcoll.in80630812b66cmaint-0.99

webcoll.inView Options

R3600/modules/websearch/bin/webcoll.in
80630812b66cmaint-0.99

webcoll.in
View Options