mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
105 lines
2.7 KiB
Python
105 lines
2.7 KiB
Python
"""Test the autodoc extension. This tests mainly for private-members option.
|
|
"""
|
|
|
|
import pytest
|
|
|
|
from .test_ext_autodoc import do_autodoc
|
|
|
|
|
|
@pytest.mark.sphinx('html', testroot='ext-autodoc')
|
|
def test_private_field(app):
|
|
app.config.autoclass_content = 'class'
|
|
options = {"members": None}
|
|
actual = do_autodoc(app, 'module', 'target.private', options)
|
|
assert list(actual) == [
|
|
'',
|
|
'.. py:module:: target.private',
|
|
'',
|
|
'',
|
|
'.. py:data:: _PUBLIC_CONSTANT',
|
|
' :module: target.private',
|
|
' :value: None',
|
|
'',
|
|
' :meta public:',
|
|
'',
|
|
'',
|
|
'.. py:function:: _public_function(name)',
|
|
' :module: target.private',
|
|
'',
|
|
' public_function is a docstring().',
|
|
'',
|
|
' :meta public:',
|
|
'',
|
|
]
|
|
|
|
|
|
@pytest.mark.sphinx('html', testroot='ext-autodoc')
|
|
def test_private_field_and_private_members(app):
|
|
app.config.autoclass_content = 'class'
|
|
options = {"members": None,
|
|
"private-members": None}
|
|
actual = do_autodoc(app, 'module', 'target.private', options)
|
|
assert list(actual) == [
|
|
'',
|
|
'.. py:module:: target.private',
|
|
'',
|
|
'',
|
|
'.. py:data:: PRIVATE_CONSTANT',
|
|
' :module: target.private',
|
|
' :value: None',
|
|
'',
|
|
' :meta private:',
|
|
'',
|
|
'',
|
|
'.. py:data:: _PUBLIC_CONSTANT',
|
|
' :module: target.private',
|
|
' :value: None',
|
|
'',
|
|
' :meta public:',
|
|
'',
|
|
'',
|
|
'.. py:function:: _public_function(name)',
|
|
' :module: target.private',
|
|
'',
|
|
' public_function is a docstring().',
|
|
'',
|
|
' :meta public:',
|
|
'',
|
|
'',
|
|
'.. py:function:: private_function(name)',
|
|
' :module: target.private',
|
|
'',
|
|
' private_function is a docstring().',
|
|
'',
|
|
' :meta private:',
|
|
'',
|
|
]
|
|
|
|
|
|
@pytest.mark.sphinx('html', testroot='ext-autodoc')
|
|
def test_private_members(app):
|
|
app.config.autoclass_content = 'class'
|
|
options = {"members": None,
|
|
"private-members": "_PUBLIC_CONSTANT,_public_function"}
|
|
actual = do_autodoc(app, 'module', 'target.private', options)
|
|
assert list(actual) == [
|
|
'',
|
|
'.. py:module:: target.private',
|
|
'',
|
|
'',
|
|
'.. py:data:: _PUBLIC_CONSTANT',
|
|
' :module: target.private',
|
|
' :value: None',
|
|
'',
|
|
' :meta public:',
|
|
'',
|
|
'',
|
|
'.. py:function:: _public_function(name)',
|
|
' :module: target.private',
|
|
'',
|
|
' public_function is a docstring().',
|
|
'',
|
|
' :meta public:',
|
|
'',
|
|
]
|