[book] add autoload section from code and fix sphinx warnings
* drop misleading faq entry since clear explanation can be found in internationalization chapter
* use autodata sphinx directive instead of raw text
* fill empty chapter with autodoc:
- devweb/httpcaching.rst
- devweb/resource.rst
- devweb/views/idownloadable.rst
- devweb/views/wdoc.rst
* use shebang in excerpt to denote shell code
* fix some bad indented docstrings in javascript files
# copyright %(year)s %(author)s, all rights reserved.
# contact %(author-web-site)s -- mailto:%(author-email)s
#
%(long-license)s
"""%(distname)s automatic tests
uncomment code below if you want to activate automatic test for your cube:
.. sourcecode:: python
from cubicweb.devtools.testlib import AutomaticWebTest
class AutomaticWebTest(AutomaticWebTest):
'''provides `to_test_etypes` and/or `list_startup_views` implementation
to limit test scope
'''
def to_test_etypes(self):
'''only test views for entities of the returned types'''
return set(('My', 'Cube', 'Entity', 'Types'))
def list_startup_views(self):
'''only test startup views of the returned identifiers'''
return ('some', 'startup', 'views')
"""
from cubicweb.devtools import testlib
class DefaultTC(testlib.CubicWebTC):
def test_something(self):
self.skipTest('this cube has no test')
if __name__ == '__main__':
from logilab.common.testlib import unittest_main
unittest_main()