# -*- coding: utf-8 -*- """ test_config ~~~~~~~~~~~ Test the sphinx.config.Config class and its handling in the Application class. :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import sys from util import TestApp, with_app, with_tempdir, raises, raises_msg, write_file from sphinx.config import Config from sphinx.errors import ExtensionError, ConfigError, VersionRequirementError from sphinx.util.pycompat import b @with_app(confoverrides={'master_doc': 'master', 'nonexisting_value': 'True', 'latex_elements.docclass': 'scrartcl'}) def test_core_config(app): cfg = app.config # simple values assert 'project' in cfg.__dict__ assert cfg.project == 'Sphinx ' assert cfg.templates_path == ['_templates'] # overrides assert cfg.master_doc == 'master' assert cfg.latex_elements['docclass'] == 'scrartcl' # simple default values assert 'locale_dirs' not in cfg.__dict__ assert cfg.locale_dirs == [] assert cfg.trim_footnote_reference_space == False # complex default values assert 'html_title' not in cfg.__dict__ assert cfg.html_title == 'Sphinx 0.6alpha1 documentation' # complex default values mustn't raise for valuename in cfg.config_values: getattr(cfg, valuename) # "contains" gives True both for set and unset values assert 'project' in cfg assert 'html_title' in cfg assert 'nonexisting_value' not in cfg # invalid values raises(AttributeError, getattr, cfg, '_value') raises(AttributeError, getattr, cfg, 'nonexisting_value') # non-value attributes are deleted from the namespace raises(AttributeError, getattr, cfg, 'sys') # setting attributes cfg.project = 'Foo' assert cfg.project == 'Foo' # alternative access via item interface cfg['project'] = 'Sphinx Tests' assert cfg['project'] == cfg.project == 'Sphinx Tests' @with_app() def test_extension_values(app): cfg = app.config # default value assert cfg.value_from_ext == [] # non-default value assert cfg.value_from_conf_py == 84 # no duplicate values allowed raises_msg(ExtensionError, 'already present', app.add_config_value, 'html_title', 'x', True) raises_msg(ExtensionError, 'already present', app.add_config_value, 'value_from_ext', 'x', True) @with_tempdir def test_errors_warnings(dir): # test the error for syntax errors in the config file write_file(dir / 'conf.py', u'project = \n', 'ascii') raises_msg(ConfigError, 'conf.py', Config, dir, 'conf.py', {}, None) # test the automatic conversion of 2.x only code in configs write_file(dir / 'conf.py', u'# -*- coding: utf-8\n\n' u'project = u"Jägermeister"\n', 'utf-8') cfg = Config(dir, 'conf.py', {}, None) cfg.init_values() assert cfg.project == u'Jägermeister' # test the warning for bytestrings with non-ascii content # bytestrings with non-ascii content are a syntax error in python3 so we # skip the test there if sys.version_info >= (3, 0): return write_file(dir / 'conf.py', u'# -*- coding: latin-1\nproject = "fooä"\n', 'latin-1') cfg = Config(dir, 'conf.py', {}, None) warned = [False] def warn(msg): warned[0] = True cfg.check_unicode(warn) assert warned[0] @with_tempdir def test_errors_if_setup_is_not_callable(dir): # test the error to call setup() in the config file (dir / 'conf.py').write_text(u'setup = 1') raises_msg(ConfigError, 'callable', TestApp, srcdir=dir) def test_needs_sphinx(): raises(VersionRequirementError, TestApp, confoverrides={'needs_sphinx': '9.9'}) @with_tempdir def test_config_eol(tmpdir): # test config file's eol patterns: LF, CRLF configfile = tmpdir / 'conf.py' for eol in ('\n', '\r\n'): configfile.write_bytes(b('project = "spam"' + eol)) cfg = Config(tmpdir, 'conf.py', {}, None) cfg.init_values() assert cfg.project == u'spam'