264 lines
8.0 KiB
Python
264 lines
8.0 KiB
Python
# Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
# not use this file except in compliance with the License. You may obtain
|
|
# a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
# License for the specific language governing permissions and limitations
|
|
# under the License.
|
|
|
|
"""
|
|
test_os_api_ref
|
|
----------------------------------
|
|
|
|
Tests for `os_api_ref` module.
|
|
"""
|
|
|
|
from bs4 import BeautifulSoup
|
|
import sphinx
|
|
from sphinx_testing import with_app
|
|
|
|
from os_api_ref.tests import base
|
|
|
|
|
|
# FIXME(stephenfin): This is horrible. We're monkeypatching this to work around
|
|
# the fact that Sphinx 1.8+ started called 'abspath' from within the
|
|
# 'sphinx.application.Application' class [1]. This means our careful use of
|
|
# 'sphinx_testing.path.path' for 'Application.outdir' etc. gets stomped on.
|
|
# We're correcting that but we're doing so globally because mock doesn't work
|
|
# for some reason and this is bound to have some side effects
|
|
#
|
|
# [1] https://github.com/sphinx-doc/sphinx/commit/3a85b3502f
|
|
try:
|
|
sphinx.application.abspath = lambda x: x
|
|
except ImportError: # Sphinx < 1.8
|
|
pass
|
|
|
|
|
|
class TestBasicExample(base.TestCase):
|
|
"""Test basic rendering.
|
|
|
|
This can be used to test that basic rendering works for these
|
|
examples, so if someone breaks something we know.
|
|
"""
|
|
|
|
@with_app(buildername='html', srcdir=base.example_dir('basic'),
|
|
copy_srcdir_to_tmpdir=True)
|
|
def setUp(self, app, status, warning):
|
|
super(TestBasicExample, self).setUp()
|
|
self.app = app
|
|
self.status = status
|
|
self.warning = warning
|
|
self.app.build()
|
|
self.html = (app.outdir / 'index.html').read_text(encoding='utf-8')
|
|
self.soup = BeautifulSoup(self.html, 'html.parser')
|
|
self.content = str(self.soup)
|
|
|
|
def test_expand_all(self):
|
|
"""Do we get an expand all button like we expect."""
|
|
content = str(self.soup.find(id='expand-all'))
|
|
example_button = ('<button class="btn btn-info btn-sm btn-expand-all" '
|
|
'data-toggle="collapse" id="expand-all">'
|
|
'Show All</button>')
|
|
self.assertEqual(
|
|
example_button,
|
|
content)
|
|
|
|
def test_rest_method(self):
|
|
"""Do we get a REST method call block"""
|
|
|
|
# TODO(sdague): it probably would make sense to do this as a
|
|
# whole template instead of parts.
|
|
content = str(self.soup.find_all(class_='operation-grp'))
|
|
self.assertIn(
|
|
'<span class="glyphicon glyphicon-link"></span>',
|
|
str(content))
|
|
self.assertIn(
|
|
'<span class="label label-GET">GET</span>',
|
|
str(content))
|
|
self.assertIn(
|
|
'<div class="row col-md-12">/servers</div>',
|
|
str(content))
|
|
self.assertIn(
|
|
('<button class="btn btn-info btn-sm btn-detail" '
|
|
'data-target="#list-servers-detail" data-toggle="collapse" '
|
|
'id="list-servers-detail-btn">detail</button>'),
|
|
str(content))
|
|
|
|
def test_parameters(self):
|
|
"""Do we get some parameters table"""
|
|
|
|
# TODO(stephenfin): Drop support for this once we drop support for both
|
|
# Python 2.7 and Sphinx < 2.0, likely in "U"
|
|
if sphinx.version_info >= (2, 0, 0):
|
|
table = """<table class="docutils align-center">
|
|
<colgroup>
|
|
<col style="width: 20%"/>
|
|
<col style="width: 10%"/>
|
|
<col style="width: 10%"/>
|
|
<col style="width: 60%"/>
|
|
</colgroup>
|
|
<thead>
|
|
<tr class="row-odd"><th class="head"><p>Name</p></th>
|
|
<th class="head"><p>In</p></th>
|
|
<th class="head"><p>Type</p></th>
|
|
<th class="head"><p>Description</p></th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr class="row-even"><td><p>name</p></td>
|
|
<td><p>body</p></td>
|
|
<td><p>string</p></td>
|
|
<td><p>The name of things</p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>"""
|
|
else:
|
|
table = """<table border="1" class="docutils">
|
|
<colgroup>
|
|
<col width="20%"/>
|
|
<col width="10%"/>
|
|
<col width="10%"/>
|
|
<col width="60%"/>
|
|
</colgroup>
|
|
<thead valign="bottom">
|
|
<tr class="row-odd"><th class="head">Name</th>
|
|
<th class="head">In</th>
|
|
<th class="head">Type</th>
|
|
<th class="head">Description</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody valign="top">
|
|
<tr class="row-even"><td>name</td>
|
|
<td>body</td>
|
|
<td>string</td>
|
|
<td>The name of things</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>"""
|
|
|
|
self.assertIn(table, self.content)
|
|
|
|
def test_rest_response(self):
|
|
|
|
# TODO(stephenfin): Drop support for this once we drop support for both
|
|
# Python 2.7 and Sphinx < 2.0, likely in "U"
|
|
if sphinx.version_info >= (2, 0, 0):
|
|
success_table = """<table class="docutils align-center">
|
|
<colgroup>
|
|
<col style="width: 30%"/>
|
|
<col style="width: 70%"/>
|
|
</colgroup>
|
|
<thead>
|
|
<tr class="row-odd"><th class="head"><p>Code</p></th>
|
|
<th class="head"><p>Reason</p></th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr class="row-even"><td><code>200 - OK</code></td>
|
|
<td><p>Request was successful.</p></td>
|
|
</tr>
|
|
<tr class="row-odd"><td><code>100 - Continue</code></td>
|
|
<td><p>An unusual code for an API</p></td>
|
|
</tr>
|
|
<tr class="row-even"><td><code>201 - Created</code></td>
|
|
<td><p>Resource was created and is ready to use.</p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>"""
|
|
|
|
error_table = """<table class="docutils align-center">
|
|
<colgroup>
|
|
<col style="width: 30%"/>
|
|
<col style="width: 70%"/>
|
|
</colgroup>
|
|
<thead>
|
|
<tr class="row-odd"><th class="head"><p>Code</p></th>
|
|
<th class="head"><p>Reason</p></th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr class="row-even"><td><code>405 - Method Not Allowed</code></td>
|
|
<td><p>Method is not valid for this endpoint.</p></td>
|
|
</tr>
|
|
<tr class="row-odd"><td><code>403 - Forbidden</code></td>
|
|
<td><p>Policy does not allow current user to do this operation.</p></td>
|
|
</tr>
|
|
<tr class="row-even"><td><code>401 - Unauthorized</code></td>
|
|
<td><p>User must authenticate before making a request</p></td>
|
|
</tr>
|
|
<tr class="row-odd"><td><code>400 - Bad Request</code></td>
|
|
<td><p>Some content in the request was invalid</p></td>
|
|
</tr>
|
|
<tr class="row-even"><td><code>500 - Internal Server Error</code></td>
|
|
<td><p>Something went wrong inside the service.</p></td>
|
|
</tr>
|
|
<tr class="row-odd"><td><code>409 - Conflict</code></td>
|
|
<td><p>There is already a zone with this name.</p></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>"""
|
|
else:
|
|
success_table = """table border="1" class="docutils">
|
|
<colgroup>
|
|
<col width="30%"/>
|
|
<col width="70%"/>
|
|
</colgroup>
|
|
<thead valign="bottom">
|
|
<tr class="row-odd"><th class="head">Code</th>
|
|
<th class="head">Reason</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody valign="top">
|
|
<tr class="row-even"><td><code>200 - OK</code></td>
|
|
<td>Request was successful.</td>
|
|
</tr>
|
|
<tr class="row-odd"><td><code>100 - Continue</code></td>
|
|
<td>An unusual code for an API</td>
|
|
</tr>
|
|
<tr class="row-even"><td><code>201 - Created</code></td>
|
|
<td>Resource was created and is ready to use.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
"""
|
|
|
|
error_table = """<table border="1" class="docutils">
|
|
<colgroup>
|
|
<col width="30%"/>
|
|
<col width="70%"/>
|
|
</colgroup>
|
|
<thead valign="bottom">
|
|
<tr class="row-odd"><th class="head">Code</th>
|
|
<th class="head">Reason</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody valign="top">
|
|
<tr class="row-even"><td><code>405 - Method Not Allowed</code></td>
|
|
<td>Method is not valid for this endpoint.</td>
|
|
</tr>
|
|
<tr class="row-odd"><td><code>403 - Forbidden</code></td>
|
|
<td>Policy does not allow current user to do this operation.</td>
|
|
</tr>
|
|
<tr class="row-even"><td><code>401 - Unauthorized</code></td>
|
|
<td>User must authenticate before making a request</td>
|
|
</tr>
|
|
<tr class="row-odd"><td><code>400 - Bad Request</code></td>
|
|
<td>Some content in the request was invalid</td>
|
|
</tr>
|
|
<tr class="row-even"><td><code>500 - Internal Server Error</code></td>
|
|
<td>Something went wrong inside the service.</td>
|
|
</tr>
|
|
<tr class="row-odd"><td><code>409 - Conflict</code></td>
|
|
<td>There is already a zone with this name.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
"""
|
|
|
|
self.assertIn(success_table, self.content)
|
|
self.assertIn(error_table, self.content)
|