Basic¶
A basic test project, with no extensions or specific themes.
Parameters¶
- pages:
Amount of pages to generate
- dummies:
Amount of “dummy data” to add (Some standard sphinx directives)
- sphinx:
Sphinx version to use
For the default values of the above parameters, please take a look into the performance.py file.
Information¶
- #dummies:
Overall amount of dummies created
Run¶
$ sphinx-performance --project basic
Running 1 test configurations.
Running 1 test configurations.
─────────────────────────────────── Run 1/1 ────────────────────────────────────
Project: basic
Core/s: 1
Builder: html
Config: sphinx: 5.1, dummies: 10, pages: 10, folders: 0, depth: 1
Info: #dummies: 100, #pages: 10, #indexes: 1, #folders: 0
Docs path: /tmp/tmpphbidty8
Docs files: 11 rst files with 8.96 kB
Docs setup: 0.04 s
Deps setup: 0.83 s
WARNING: html_static_path entry '_static' does not exist
Build files: 55 files with 747.00 kB
File max️: 281.82 kB by /tmp/tmpphbidty8/_build/_static/jquery-3.6.0.js
File min: 0.04 kB by /tmp/tmpphbidty8/_build/_static/custom.css
File Ø: 13.58 kB (0.02 s)
Reading time: 0.18 s
Writing time: 0.21 s
Build Duration: 1.09 s
─────────────────────────────────── RESULTS ────────────────────────────────────
╭───────────────┬───────────╮
│ # │ Run 1 │
├───────────────┼───────────┤
│ runtime │ 1.09 │
│ project │ basic │
│ │ │
│ builder │ html │
│ sphinx │ 5.1 │
│ folders │ 0 │
│ depth │ 1 │
│ dummies │ 10 │
│ parallel │ 1 │
│ pages │ 10 │
│ │ │
│ #folders │ 0 │
│ #indexes │ 1 │
│ #pages │ 10 │
│ #dummies │ 100 │
│ │ │
│ folder size │ 747.00 kB │
│ min file size │ 0.04 kB │
│ avg file time │ 0.02 s │
│ avg file size │ 13.58 kB │
│ writing time │ 0.21 s │
│ # files │ 55 │
│ max file size │ 281.82 kB │
│ reading time │ 0.18 s │
│ │ │
╰───────────────┴───────────╯
Overall runtime: 1.09 seconds.
Files¶
performance.py¶
parameters = {
"sphinx": "5.1",
"dummies": 10,
"pages": 10,
"folders": 0,
"depth": 1,
}
info = {
"#dummies": "{{dummies * page_amount}}",
"#pages": "{{page_amount}}",
"#indexes": "{{index_amount}}",
"#folders": "{{folders ** depth}}",
}
references = {
"small": {
"sphinx": "5.1",
"dummies": 10,
"pages": 10,
"folders": 0,
"depth": 1,
},
"medium": {
"sphinx": "5.1",
"dummies": 30,
"pages": 20,
"folders": 10,
"depth": 1,
},
"large": {
"sphinx": "5.1",
"dummies": 30,
"pages": 20,
"folders": 10,
"depth": 2,
},
}
requirements.template¶
sphinx=={{sphinx}}
conf.template¶
# -*- coding: utf-8 -*-
#
# needs test docs documentation build configuration file, created by
# sphinx-quickstart on Tue Mar 28 11:37:14 2017.
#
# This file is execfile()d with the current directory set to its
# containing dir.
#
# Note that not all possible configuration values are present in this
# autogenerated file.
#
# All configuration values have a default; values that are commented out
# serve to show the default.
# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here. If the directory is relative to the
# documentation root, use os.path.abspath to make it absolute, like shown here.
#
import os
import sys
from docutils.parsers.rst import directives
sys.path.insert(0, os.path.abspath("../../sphinxcontrib"))
# -- General configuration ------------------------------------------------
# If your documentation needs a minimal Sphinx version, state it here.
#
# needs_sphinx = '1.0'
# Add any Sphinx extension module names here, as strings. They can be
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
# ones.
extensions = []
# Add any paths that contain templates here, relative to this directory.
templates_path = ["_templates"]
# The suffix(es) of source filenames.
# You can specify multiple suffix as a list of string:
#
# source_suffix = ['.rst', '.md']
source_suffix = ".rst"
# The master toctree document.
master_doc = "index"
# General information about the project.
project = "needs test docs"
copyright = "team testing"
author = "team testing"
# The version info for the project you're documenting, acts as replacement for
# |version| and |release|, also used in various other places throughout the
# built documents.
#
# The short X.Y version.
version = "1.0"
# The full version, including alpha/beta/rc tags.
release = "1.0"
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
#
# This is also used if you do content translation via gettext catalogs.
# Usually you set "language" from the command line for these cases.
language = 'en'
# List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files.
# This patterns also effect to html_static_path and html_extra_path
exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
# The name of the Pygments (syntax highlighting) style to use.
pygments_style = "sphinx"
# If true, `todo` and `todoList` produce output, else they produce nothing.
todo_include_todos = False
# -- Options for HTML output ----------------------------------------------
# The theme to use for HTML and HTML Help pages. See the documentation for
# a list of builtin themes.
#
html_theme = "alabaster"
# Theme options are theme-specific and customize the look and feel of a theme
# further. For a list of options available for each theme, see the
# documentation.
#
# html_theme_options = {}
# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
html_static_path = ["_static"]
# -- Options for HTMLHelp output ------------------------------------------
# Output file base name for HTML help builder.
htmlhelp_basename = "needstestdocsdoc"
# -- Options for LaTeX output ---------------------------------------------
latex_elements = {
# The paper size ('letterpaper' or 'a4paper').
#
# 'papersize': 'letterpaper',
# The font size ('10pt', '11pt' or '12pt').
#
# 'pointsize': '10pt',
# Additional stuff for the LaTeX preamble.
#
# 'preamble': '',
# Latex figure (float) alignment
#
# 'figure_align': 'htbp',
}
# Grouping the document tree into LaTeX files. List of tuples
# (source start file, target name, title,
# author, documentclass [howto, manual, or own class]).
latex_documents = [
(master_doc, "needstestdocs.tex", "needs test docs Documentation", "team useblocks", "manual"),
]
# -- Options for manual page output ---------------------------------------
# One entry per manual page. List of tuples
# (source start file, name, description, authors, manual section).
man_pages = [(master_doc, "needstestdocs", "needs test docs Documentation", [author], 1)]
# -- Options for Texinfo output -------------------------------------------
# Grouping the document tree into Texinfo files. List of tuples
# (source start file, target name, title, author,
# dir menu entry, description, category)
texinfo_documents = [
(
master_doc,
"needstestdocs",
"needs test docs Documentation",
author,
"needstestdocs",
"One line description of project.",
"Miscellaneous",
),
]
index.template¶
{{ title}}
{{ "=" * title|length }}
Config
------
:pages: {{pages}}
:dummies: {{dummies}}
:keep: {{keep}}
:browser: {{browser}}
:debug: {{debug}}
Content
-------
.. contents::
.. toctree::
{%- for page in range(pages) %}
page_{{page}}
{%- endfor -%}
{%- if has_folders %}
{%- for folder in range(folders) %}
folder_{{folder}}/index
{%- endfor -%}
{% endif -%}
page.template¶
{{ title}}
{{ "=" * title|length }}
Test Data
---------
Dummies
~~~~~~~
Amount of dummies: **{{dummies}}**
{% for n in range(dummies) %}
**Dummy {{n}}**
.. note:: This is dummy {{n}}
And some **dummy** *text* for dummy {{n}}
{% endfor %}
