Source code for linkcheck.plugins.anchorcheck

# Copyright (C) 2000-2014 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
# 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.
Check HTML anchors
import urllib.parse

from . import _ContentPlugin
from .. import log, LOG_PLUGIN
from ..htmlutil import linkparse

[docs]class AnchorCheck(_ContentPlugin): """Checks validity of HTML anchors.""" def __init__(self, config): """Initialize plugin.""" super().__init__(config) log.warn( LOG_PLUGIN, _("Anchor check plugin is broken. Fixes welcome.") )
[docs] def applies_to(self, url_data): """Check for HTML anchor existence.""" return False # XXX Plugin disabled return url_data.is_html() and url_data.anchor
[docs] def check(self, url_data): """Check content for invalid anchors.""" log.debug(LOG_PLUGIN, "checking content for invalid anchors") # list of parsed anchors self.anchors = [] linkparse.find_links(url_data.get_soup(), self.add_anchor, linkparse.AnchorTags) self.check_anchor(url_data)
[docs] def add_anchor(self, url, line, column, name, base): """Add anchor URL.""" self.anchors.append((url, line, column, name, base))
[docs] def check_anchor(self, url_data): """If URL is valid, parseable and has an anchor, check it. A warning is logged and True is returned if the anchor is not found. """ log.debug(LOG_PLUGIN, "checking anchor %r in %s", url_data.anchor, self.anchors) if any(x for x in self.anchors if urllib.parse.quote(x[0]) == url_data.anchor): return if self.anchors: anchornames = sorted(set("`%s'" % x[0] for x in self.anchors)) anchors = ", ".join(anchornames) else: anchors = "-" args = {"name": url_data.anchor, "anchors": anchors} msg = "%s %s" % ( _("Anchor `%(name)s' not found.") % args, _("Available anchors: %(anchors)s.") % args, ) url_data.add_warning(msg)