mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
80 lines
2.2 KiB
Python
80 lines
2.2 KiB
Python
# -*- coding: utf-8 -*-
|
|
"""
|
|
test_config
|
|
~~~~~~~~~~~
|
|
|
|
Test the sphinx.config.Config class and its handling in the
|
|
Application class.
|
|
|
|
:copyright: Copyright 2007-2010 by the Sphinx team, see AUTHORS.
|
|
:license: BSD, see LICENSE for details.
|
|
"""
|
|
|
|
from util import *
|
|
|
|
from sphinx.application import ExtensionError
|
|
|
|
|
|
@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 <Tests>'
|
|
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 <Tests> v0.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)
|