mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
Some pylint nits.
This commit is contained in:
parent
d93b236545
commit
407a0c47c1
1
Makefile
1
Makefile
@ -8,7 +8,6 @@ all: clean-pyc check
|
||||
|
||||
check:
|
||||
@$(PYTHON) utils/check_sources.py -i sphinx/style/jquery.js sphinx
|
||||
@$(PYTHON) utils/check_sources.py converter
|
||||
|
||||
clean: clean-pyc clean-patchfiles
|
||||
|
||||
|
@ -109,7 +109,8 @@ def main(argv=sys.argv):
|
||||
key, val = val.split('=')
|
||||
try:
|
||||
val = int(val)
|
||||
except: pass
|
||||
except ValueError:
|
||||
pass
|
||||
confoverrides[key] = val
|
||||
elif opt == '-N':
|
||||
nocolor()
|
||||
@ -158,7 +159,8 @@ def main(argv=sys.argv):
|
||||
print >>sys.stderr, ('Please also report this if it was a user '
|
||||
'error, so that a better error message '
|
||||
'can be provided next time.')
|
||||
print >>sys.stderr, 'Send reports to sphinx-dev@googlegroups.com. Thanks!'
|
||||
print >>sys.stderr, ('Send reports to sphinx-dev@googlegroups.com. '
|
||||
'Thanks!')
|
||||
return 1
|
||||
|
||||
|
||||
|
@ -9,7 +9,6 @@
|
||||
:license: BSD.
|
||||
"""
|
||||
|
||||
import sys
|
||||
import codecs
|
||||
from os import path
|
||||
|
||||
|
@ -226,11 +226,6 @@ class TemplateBridge(object):
|
||||
that renders templates given a template name and a context.
|
||||
"""
|
||||
|
||||
def __init__(self):
|
||||
"""
|
||||
Initialize the class.
|
||||
"""
|
||||
|
||||
def init(self, builder):
|
||||
"""
|
||||
Called by the builder to initialize the template system. *builder*
|
||||
|
@ -25,7 +25,7 @@ from docutils.frontend import OptionParser
|
||||
from docutils.readers.doctree import Reader as DoctreeReader
|
||||
|
||||
from sphinx import addnodes
|
||||
from sphinx.util import mtimes_of_files, ensuredir, relative_uri, SEP, os_path
|
||||
from sphinx.util import ensuredir, relative_uri, SEP, os_path
|
||||
from sphinx.htmlhelp import build_hhx
|
||||
from sphinx.htmlwriter import HTMLWriter, HTMLTranslator, SmartyPantsHTMLTranslator
|
||||
from sphinx.latexwriter import LaTeXWriter
|
||||
@ -775,7 +775,7 @@ class LaTeXBuilder(Builder):
|
||||
subtree = process_tree(includefile,
|
||||
self.env.get_doctree(includefile))
|
||||
self.docnames.add(includefile)
|
||||
except:
|
||||
except Exception:
|
||||
self.warn('%s: toctree contains ref to nonexisting file %r' %
|
||||
(docname, includefile))
|
||||
else:
|
||||
|
@ -77,7 +77,7 @@ def desc_index_text(desctype, currmodule, name):
|
||||
elif desctype == 'method':
|
||||
try:
|
||||
clsname, methname = name.rsplit('.', 1)
|
||||
except:
|
||||
except ValueError:
|
||||
if currmodule:
|
||||
return '%s() (in module %s)' % (name, currmodule)
|
||||
else:
|
||||
@ -89,7 +89,7 @@ def desc_index_text(desctype, currmodule, name):
|
||||
elif desctype == 'attribute':
|
||||
try:
|
||||
clsname, attrname = name.rsplit('.', 1)
|
||||
except:
|
||||
except ValueError:
|
||||
if currmodule:
|
||||
return '%s (in module %s)' % (name, currmodule)
|
||||
else:
|
||||
@ -133,7 +133,8 @@ def parse_py_signature(signode, sig, desctype, env):
|
||||
* it is added to the full name (return value) if not present
|
||||
"""
|
||||
m = py_sig_re.match(sig)
|
||||
if m is None: raise ValueError
|
||||
if m is None:
|
||||
raise ValueError
|
||||
classname, name, arglist = m.groups()
|
||||
|
||||
add_module = True
|
||||
@ -177,14 +178,17 @@ def parse_py_signature(signode, sig, desctype, env):
|
||||
stack[-1] += opt
|
||||
stack.append(opt)
|
||||
elif token == ']':
|
||||
try: stack.pop()
|
||||
except IndexError: raise ValueError
|
||||
try:
|
||||
stack.pop()
|
||||
except IndexError:
|
||||
raise ValueError
|
||||
elif not token or token == ',' or token.isspace():
|
||||
pass
|
||||
else:
|
||||
token = token.strip()
|
||||
stack[-1] += addnodes.desc_parameter(token, token)
|
||||
if len(stack) != 1: raise ValueError
|
||||
if len(stack) != 1:
|
||||
raise ValueError
|
||||
return fullname, classname
|
||||
|
||||
|
||||
@ -267,7 +271,8 @@ opcode_sig_re = re.compile(r'(\w+(?:\+\d)?)\s*\((.*)\)')
|
||||
def parse_opcode_signature(signode, sig):
|
||||
"""Transform an opcode signature into RST nodes."""
|
||||
m = opcode_sig_re.match(sig)
|
||||
if m is None: raise ValueError
|
||||
if m is None:
|
||||
raise ValueError
|
||||
opname, arglist = m.groups()
|
||||
signode += addnodes.desc_name(opname, opname)
|
||||
paramlist = addnodes.desc_parameterlist()
|
||||
@ -657,7 +662,7 @@ def toctree_directive(name, arguments, options, content, lineno,
|
||||
m = caption_ref_re.match(docname)
|
||||
if m:
|
||||
docname = m.group(2)
|
||||
includetitles[docname] = m.group(1)
|
||||
includetitles[docname] = m.group(1)
|
||||
# absolutize filenames, remove suffixes
|
||||
if docname.endswith(suffix):
|
||||
docname = docname[:-len(suffix)]
|
||||
|
@ -22,7 +22,7 @@ from string import uppercase
|
||||
try:
|
||||
import hashlib
|
||||
md5 = hashlib.md5
|
||||
except:
|
||||
except ImportError:
|
||||
# 2.4 compatibility
|
||||
import md5
|
||||
md5 = md5.new
|
||||
@ -701,7 +701,8 @@ class BuildEnvironment:
|
||||
stream=RedirStream(self._warnfunc))
|
||||
return doctree
|
||||
|
||||
def get_and_resolve_doctree(self, docname, builder, doctree=None, prune_toctrees=True):
|
||||
def get_and_resolve_doctree(self, docname, builder, doctree=None,
|
||||
prune_toctrees=True):
|
||||
"""Read the doctree from the pickle, resolve cross-references and
|
||||
toctrees and return it."""
|
||||
if doctree is None:
|
||||
@ -932,7 +933,7 @@ class BuildEnvironment:
|
||||
if type == 'single':
|
||||
try:
|
||||
entry, subentry = string.split(';', 1)
|
||||
except:
|
||||
except ValueError:
|
||||
entry, subentry = string, ''
|
||||
add_entry(entry.strip(), subentry.strip())
|
||||
elif type == 'pair':
|
||||
|
@ -155,7 +155,7 @@ def generate_rst(what, name, members, inherited, undoc, add_content, document,
|
||||
args = '()'
|
||||
else:
|
||||
args = ''
|
||||
except:
|
||||
except Exception:
|
||||
args = ''
|
||||
if len(objpath) == 2:
|
||||
qualname = '%s.%s' % (cls, obj)
|
||||
|
@ -326,7 +326,7 @@ class LaTeXTranslator(nodes.NodeVisitor):
|
||||
try:
|
||||
type, container = d.type.rsplit(' ', 1)
|
||||
container = container.rstrip('.')
|
||||
except:
|
||||
except ValueError:
|
||||
container = ''
|
||||
type = d.type
|
||||
t2 = "{%s}{%s}{%s}" % (container, type, d.name)
|
||||
@ -454,7 +454,8 @@ class LaTeXTranslator(nodes.NodeVisitor):
|
||||
|
||||
def visit_entry(self, node):
|
||||
if node.has_key('morerows') or node.has_key('morecols'):
|
||||
raise NotImplementedError('Column or row spanning cells are not implemented.')
|
||||
raise NotImplementedError('Column or row spanning cells are '
|
||||
'not implemented.')
|
||||
if self.table.col > 0:
|
||||
self.body.append(' & ')
|
||||
self.table.col += 1
|
||||
|
Loading…
Reference in New Issue
Block a user