linkchecker/linkcheck/lc_cgi.py
2012-04-20 19:25:27 +02:00

314 lines
9.5 KiB
Python

# -*- coding: iso-8859-1 -*-
# Copyright (C) 2000-2012 Bastian Kleineidam
#
# This program 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.
#
# This program 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 this program; if not, write to the Free Software Foundation, Inc.,
# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
"""
Functions used by the WSGI script.
"""
import cgi
import os
import threading
from StringIO import StringIO
import locale
import re
import time
import urlparse
from PyQt4 import QtCore
from . import configuration, strformat, checker, director, \
add_intern_pattern, get_link_pat, init_i18n, url as urlutil
from .logger import Logger
def application(environ, start_response):
"""WSGI interface: start an URL check."""
# the environment variable CONTENT_LENGTH may be empty or missing
try:
request_body_size = int(environ.get('CONTENT_LENGTH', 0))
except ValueError:
request_body_size = 0
# When the method is POST the query string will be sent
# in the HTTP request body which is passed by the WSGI server
# in the file like wsgi.input environment variable.
if request_body_size > 0:
request_body = environ['wsgi.input'].read(request_body_size)
else:
request_body = environ['wsgi.input'].read()
form = cgi.parse_qs(request_body)
status = '200 OK'
start_response(status, get_response_headers())
for output in checklink(form=form, env=environ):
yield output
_supported_langs = ('de', 'C')
# map language -> locale name
lang_locale = {
'de': 'de_DE',
'C': 'C',
'en': 'en_EN',
}
_is_level = re.compile(r'^(0|1|2|3|-1)$').match
class LCFormError (StandardError):
"""Form related errors."""
pass
def get_response_headers():
"""Get list of response headers in key-value form."""
return [("Content-type", "text/html"),
("Cache-Control", "no-cache"),
("Pragma:", "no-cache")
]
def formvalue (form, key):
"""Get value with given key from WSGI form."""
field = form.get(key)
if isinstance(field, list):
field = field[0]
return field
class ThreadsafeStringIO (StringIO):
"""Thread-safe String I/O class."""
def __init__(self):
self.buf = []
self.lock = threading.Lock()
self.closed = False
def write (self, data):
self.lock.acquire()
try:
if self.closed:
raise IOError("Write on closed I/O object")
self.buf.append(data)
finally:
self.lock.release()
def get_data (self):
self.lock.acquire()
try:
data = "".join(self.buf)
self.buf = []
return data
finally:
self.lock.release()
def close (self):
self.lock.acquire()
try:
self.buf = []
self.closed = True
finally:
self.lock.release()
class SignalLogger (Logger):
"""Use Qt signals for logged URLs and statistics."""
def __init__ (self, **args):
"""Store signals for URL and statistic data."""
super(SignalLogger, self).__init__(**args)
self.log_url_signal = args["signal"]
self.log_stats_signal = args["stats"]
def start_fileoutput (self):
"""Override fileoutput handling of base class."""
pass
def close_fileoutput (self):
"""Override fileoutput handling of base class."""
pass
def log_url (self, url_data):
"""Emit URL data which gets logged in the main window."""
self.log_url_signal.emit(url_data)
def end_output (self):
"""Emit statistic data which gets logged in the main window."""
self.log_stats_signal.emit(self.stats)
class DelegateLogger (QtCore.QObject):
"""Logger using connected signals, delegating output to
another logger class."""
log_url_signal = QtCore.pyqtSignal(object)
log_stats_signal = QtCore.pyqtSignal(object)
def __init__ (self):
"""Connect signals to this instance and init state."""
super(DelegateLogger, self).__init__()
self.log_url_signal.connect(self.log_url)
self.log_stats_signal.connect(self.log_stats)
self.logger = None
self.finished = False
def add_logger (self, logger):
"""Delegate to given logger."""
self.logger = logger
def log_url (self, url_data):
"""Delegate URL logging to internal logger."""
self.logger.log_url(url_data)
def log_stats (self, statistics):
"""Delegate statistic logging to internal logger."""
self.logger.stats = statistics
self.logger.end_output()
self.finished = True
def encode(s):
return s.encode('utf-8', 'ignore')
def checklink (form=None, env=os.environ):
"""Validates the CGI form and checks the given links."""
if form is None:
form = {}
try:
checkform(form)
except LCFormError, errmsg:
log(env, errmsg)
yield encode(format_error(errmsg))
return
delegate_logger = DelegateLogger()
config = get_configuration(form, delegate_logger)
out = ThreadsafeStringIO()
html_logger = config.logger_new('html', fd=out)
delegate_logger.add_logger(html_logger)
url = strformat.stripurl(formvalue(form, "url"))
aggregate = director.get_aggregate(config)
url_data = checker.get_url_from(url, 0, aggregate)
try:
add_intern_pattern(url_data, config)
except UnicodeError, errmsg:
log(env, errmsg)
msg = _("URL has unparsable domain name: %s") % errmsg
yield encode(format_error(msg))
return
aggregate.urlqueue.put(url_data)
html_logger.start_output()
# check in background
t = threading.Thread(target=director.check_urls, args=(aggregate,))
t.start()
# time to wait for new data
sleep_seconds = 2
# 5 minutes timeout
max_seconds = 300
# current running time
run_seconds = 0
while not delegate_logger.finished:
data = out.get_data()
yield encode(data)
time.sleep(sleep_seconds)
run_seconds += sleep_seconds
if run_seconds > max_seconds:
# XXX signal checker to stop
html_logger.end_output()
break
yield encode(out.get_data())
out.close()
def get_configuration(form, logger):
"""Initialize a CGI configuration."""
config = configuration.Configuration()
config["recursionlevel"] = int(formvalue(form, "level"))
config.logger_add("signal", SignalLogger)
config["logger"] = config.logger_new('signal',
signal=logger.log_url_signal, stats=logger.log_stats_signal)
config["threads"] = 0
if "anchors" in form:
config["anchors"] = True
if "errors" not in form:
config["verbose"] = True
# avoid checking of local files or other nasty stuff
pat = "!^%s$" % urlutil.safe_url_pattern
config["externlinks"].append(get_link_pat(pat, strict=True))
return config
def get_host_name (form):
"""Return host name of given URL."""
return urlparse.urlparse(formvalue(form, "url"))[1]
def checkform (form):
"""Check form data. throw exception on error
Be sure to NOT print out any user-given data as HTML code, so use
only plain strings as exception text."""
# check lang support
if "language" in form:
lang = formvalue(form, 'language')
if lang in _supported_langs:
locale.setlocale(locale.LC_ALL, lang_locale[lang])
init_i18n()
else:
raise LCFormError(_("unsupported language"))
# check url syntax
if "url" in form:
url = formvalue(form, "url")
if not url or url == "http://":
raise LCFormError(_("empty url was given"))
if not urlutil.is_safe_url(url):
raise LCFormError(_("disallowed url was given"))
else:
raise LCFormError(_("no url was given"))
# check recursion level
if "level" in form:
level = formvalue(form, "level")
if not _is_level(level):
raise LCFormError(_("invalid recursion level"))
# check options
for option in ("anchors", "errors", "intern"):
if option in form:
if not formvalue(form, option) == "on":
raise LCFormError(_("invalid %s option syntax") % option)
def log (env, msg):
"""Log message to WSGI error output."""
logfile = env['wsgi.errors']
logfile.write(msg + "\n")
def dump (env, form):
"""Log environment and form."""
for var, value in env.items():
log(env, var+"="+value)
for key in form:
log(env, str(formvalue(form, key)))
def format_error (why):
"""Print standard error page."""
return _("""<html><head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>LinkChecker Online Error</title></head>
<body text=#192c83 bgcolor=#fff7e5 link=#191c83 vlink=#191c83 alink=#191c83>
<blockquote>
<b>Error: %s</b><br>
The LinkChecker Online script has encountered an error. Please ensure
that your provided URL link begins with <code>http://</code> and
contains only these characters: <code>A-Za-z0-9./_~-</code><br><br>
Errors are logged.
</blockquote>
</body>
</html>""") % cgi.escape(why)