You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
134 lines
4.1 KiB
Python
134 lines
4.1 KiB
Python
# Copyright (c) 2003-2013 LOGILAB S.A. (Paris, FRANCE).
|
|
# 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.
|
|
"""utilities methods and classes for reporters"""
|
|
from __future__ import print_function
|
|
|
|
import sys
|
|
import locale
|
|
import os
|
|
|
|
|
|
from pylint import utils
|
|
|
|
CMPS = ['=', '-', '+']
|
|
|
|
# py3k has no more cmp builtin
|
|
if sys.version_info >= (3, 0):
|
|
def cmp(a, b): # pylint: disable=redefined-builtin
|
|
return (a > b) - (a < b)
|
|
|
|
def diff_string(old, new):
|
|
"""given a old and new int value, return a string representing the
|
|
difference
|
|
"""
|
|
diff = abs(old - new)
|
|
diff_str = "%s%s" % (CMPS[cmp(old, new)], diff and ('%.2f' % diff) or '')
|
|
return diff_str
|
|
|
|
|
|
class BaseReporter(object):
|
|
"""base class for reporters
|
|
|
|
symbols: show short symbolic names for messages.
|
|
"""
|
|
|
|
extension = ''
|
|
|
|
def __init__(self, output=None):
|
|
self.linter = None
|
|
# self.include_ids = None # Deprecated
|
|
# self.symbols = None # Deprecated
|
|
self.section = 0
|
|
self.out = None
|
|
self.out_encoding = None
|
|
self.encode = None
|
|
self.set_output(output)
|
|
# Build the path prefix to strip to get relative paths
|
|
self.path_strip_prefix = os.getcwd() + os.sep
|
|
|
|
def handle_message(self, msg):
|
|
"""Handle a new message triggered on the current file.
|
|
|
|
Invokes the legacy add_message API by default."""
|
|
self.add_message(
|
|
msg.msg_id, (msg.abspath, msg.module, msg.obj, msg.line, msg.column),
|
|
msg.msg)
|
|
|
|
def add_message(self, msg_id, location, msg):
|
|
"""Deprecated, do not use."""
|
|
raise NotImplementedError
|
|
|
|
def set_output(self, output=None):
|
|
"""set output stream"""
|
|
self.out = output or sys.stdout
|
|
# py3k streams handle their encoding :
|
|
if sys.version_info >= (3, 0):
|
|
self.encode = lambda x: x
|
|
return
|
|
|
|
def encode(string):
|
|
if not isinstance(string, unicode):
|
|
return string
|
|
encoding = (getattr(self.out, 'encoding', None) or
|
|
locale.getdefaultlocale()[1] or
|
|
sys.getdefaultencoding())
|
|
# errors=replace, we don't want to crash when attempting to show
|
|
# source code line that can't be encoded with the current locale
|
|
# settings
|
|
return string.encode(encoding, 'replace')
|
|
self.encode = encode
|
|
|
|
def writeln(self, string=''):
|
|
"""write a line in the output buffer"""
|
|
print(self.encode(string), file=self.out)
|
|
|
|
def display_results(self, layout):
|
|
"""display results encapsulated in the layout tree"""
|
|
self.section = 0
|
|
if hasattr(layout, 'report_id'):
|
|
layout.children[0].children[0].data += ' (%s)' % layout.report_id
|
|
self._display(layout)
|
|
|
|
def _display(self, layout):
|
|
"""display the layout"""
|
|
raise NotImplementedError()
|
|
|
|
# Event callbacks
|
|
|
|
def on_set_current_module(self, module, filepath):
|
|
"""starting analyzis of a module"""
|
|
pass
|
|
|
|
def on_close(self, stats, previous_stats):
|
|
"""global end of analyzis"""
|
|
pass
|
|
|
|
|
|
class CollectingReporter(BaseReporter):
|
|
"""collects messages"""
|
|
|
|
name = 'collector'
|
|
|
|
def __init__(self):
|
|
BaseReporter.__init__(self)
|
|
self.messages = []
|
|
|
|
def handle_message(self, msg):
|
|
self.messages.append(msg)
|
|
|
|
|
|
def initialize(linter):
|
|
"""initialize linter with reporters in this package """
|
|
utils.register_plugins(linter, __path__[0])
|