Widgets

This part of the documentation covers all the reusable django-wildewidgets widgets provided by django-sphinx-hosting.

Navigation

These widgets are used on every page.

Navigation customization settings:

• SPHINX_HOSTING_SETTINGS['EXTRA_MENU_ITEMS']

• SPHINX_HOSTING_SETTINGS['MENU_ITEM_BUILDERS']

• SPHINX_HOSTING_SETTINGS['NAVBAR_CLASS']

class sphinx_hosting.wildewidgets.SphinxHostingSidebar(*args, wide: bool | None = None, **kwargs)

The vertical menu area on the left of the page.

It houses our search form, sphinx_hosting.wildewidgets.search.GlobalSearchFormWidget, our main menu SphinxHostingMainMenu, and the global table of contents menu when reading a specific documentation version.

branding: Block = <wildewidgets.widgets.base.Block object>

contents: Final[list[Block]] = [<sphinx_hosting.wildewidgets.navigation.SphinxHostingMainMenu object>]

hide_below_viewport: str = 'xl'

The viewport size at which our menu container collapses to be hidden,

wide: bool = True

class sphinx_hosting.wildewidgets.SphinxHostingMainMenu(*items, **kwargs)

The primary menu that appears in SphinxHostingSidebar.

It appears directly underneath sphinx_hosting.wildewidgets.search.GlobalSearchFormWidget. The menu always includes the Project index and may include conditional items based on user permissions and project-level hook builders.

Parameters:

items – Additional menu items to inject at construction time.

Keyword Arguments:

kwargs – Keyword arguments forwarded to wildewidgets.Menu.

__init__(*items, **kwargs) → None

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

activate(text: str) → bool

Save active-item text for deferred matching during build_menu.

Parameters:

text – The text or URL to search among menu items.

Returns:

True always, because matching is deferred to build_menu.

build_menu(items: Iterable[MenuItem]) → None

Programmatically build the menu based on request-time context.

We defer conditional and hook-driven menu construction until this method because URL resolution and request context are guaranteed here.

Parameters:

items – Base menu items from wildewidgets.Menu.

Raises:

• RuntimeError – Request context is unavailable.

• TypeError – A configured setting or builder return type is invalid.

• ValueError – A configured item spec is invalid.

• Exception – Any exception raised by configured menu builders.

active_item: str | None

items: Final[list[MenuItem]]

title: str = 'Main'

class sphinx_hosting.wildewidgets.SphinxHostingBreadcrumbs(*args, title_class: str | None = None, **kwargs)

The breadcrumbs that appear at the top of each page.

items: ClassVar[list[BreadcrumbItem]]

The list of BreadcrumbItem objects from which we will

Projects

These widgets are used on the project listing and details pages.

class sphinx_hosting.wildewidgets.ClassifierFilterForm(table_name: str, column_number: int, **kwargs)

The tree-like classifier filter form that appears to the right of the sphinx_hosting.wildewidgets.project.ProjectTable. It is embedded in ClassifierFilterBlock.

It allows the user to select a set of classifiers by which to filter the projects listing table.

__init__(table_name: str, column_number: int, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

add_subtree(contents: UnorderedList, nodes: dict[str, sphinx_hosting.models.ClassifierNode]) → None

Add a subtree of classifier checkboxes.

Parameters:

• contents – the <ul> block to which to add our list of classifier checkboxes nodes (_type_): _description_

• nodes – the classifier nodes to add to the list. The key is the classifier id, and the value is the ClassifierNode instance.

get_checkbox(node: ClassifierNode) → HorizontalLayoutBlock

Build and return the wildewidgets.CheckboxInputBlock for the classifier node.

Parameters:

node – the classifier data

Returns:

A configured wildewidgets.CheckboxInputBlock

block: str = 'classifiers__filter__form'

block is the official wildewidgets name of the block; it can’t be changed

tag: str = 'form'

class sphinx_hosting.wildewidgets.ClassifierFilterBlock(table_name: str, column_number: int, **kwargs)

A wildewidgets.CardWidget that contains the ClassifierFilterForm. This the right of the sphinx_hosting.wildewidgets.project.ProjectTable. This widget is embedded in sphinx_hosting.wildewdigets.project.ProjectTableWidget

Parameters:

• table_name – the name of the dataTables table to control

• column_number – the number of the column in the dataTable that contains classifier names

__init__(table_name: str, column_number: int, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

name: str = 'classifiers__filter'

The CSS class that will be added to this element to as an identifier for

class sphinx_hosting.wildewidgets.ProjectCreateModalWidget(*args, **kwargs)

A modal dialog that holds the sphinx_hosting.forms.ProjectCreateForm.

Parameters:

args – the arguments to pass to the modal widget

Keyword Arguments:

kwargs – the keyword arguments to pass to the modal widget

__init__(*args, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

modal_id: str = 'project__create'

modal_title: str = 'Add Project'

class sphinx_hosting.wildewidgets.ProjectDetailWidget(*blocks: Any, form: Form | None = None, **kwargs: Any)

Renders an update form for a sphinx_hosting.models.Project.

Use directly it like so:

>>> project = Project.objects.get(pk=1)
>>> form = ProjectUpdateForm(instance=project)
>>> widget = ProjectDetailWidget(form=form)

Or you can simply add the form to your view context and ProjectDetailWidget will pick it up automatically.

css_class: str = ' p-4'

modifier: str = 'general'

If specified, also add a class named {name}--{modifier} to the CSS

name: str = 'project-detail__section'

The CSS class that will be added to this element to as an identifier for

class sphinx_hosting.wildewidgets.ProjectTableWidget(user: AbstractUser, **kwargs)

A wildewidgets.CardWidget that gives our ProjectTable dataTable a nice header with a total book count and an “Add Project” button that opens a modal dialog.

__init__(user: AbstractUser, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

get_title(user: AbstractUser) → WidgetListLayoutHeader

Retrieve the widget’s title.

Returns:

The widget’s title string, widget object, or None if no title is set.

class sphinx_hosting.wildewidgets.ProjectVersionsTableWidget(project_id: int, **kwargs)

A wildewidgets.CardWidget that gives our ProjectVersionTable dataTable a nice header with a total version count.

__init__(project_id: int, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

get_title() → WidgetListLayoutHeader

Retrieve the widget’s title.

Returns:

The widget’s title string, widget object, or None if no title is set.

class sphinx_hosting.wildewidgets.ProjectTable(*args, actions: list[wildewidgets.widgets.tables.actions.RowActionButton] | None = None, button_size: str | None = None, justify: Literal['start', 'center', 'end'] | None = None, **kwargs)

Displays a dataTable of our sphinx_hosting.models.Project instances.

It’s used as a the main widget in by ProjectTableWidget.

model

alias of Project

filter_classifiers_column(qs: QuerySet, _: str, value: str) → QuerySet

Filter our results by the value, a comma separated list of sphinx_hosting.models.Classifier names.

Parameters:

• qs – the current QuerySet

• colunn – the name of the column to filter on

• value – a comma-separated list of classifier names

Returns:

A QuerySet filtered for rows that contain the selected classifiers.

render_classifiers_column(row: Project, _: str) → str

Render our classifiers column.

Parameters:

• row – the Project we are rendering

• colunn – the name of the column to render

Returns:

A <br> separated list of classifier names

render_latest_version_column(row: Project, _: str) → str

Render our latest_version column. This is the version string of the sphinx_hosting.models.Version that has the most recent sphinx_hosting.models.Version.modified timestamp.

If there are not yet any sphinx_hosting.models.Version instances for this project, return empty string.

Parameters:

• row – the Project we are rendering

• colunn – the name of the column to render

Returns:

The version string of the most recently published version, or empty string.

render_latest_version_date_column(row: Project, _: str) → str

Render our latest_version_date column. This is the last modified date of the sphinx_hosting.models.Version that has the most recent sphinx_hosting.models.Version.modified timestamp.

If there are not yet any sphinx_hosting.models.Version instances for this project, return empty string.

Parameters:

• row – the Project we are rendering

• colunn – the name of the column to render

Returns:

The of the most recently published version, or empty string.

actions: Final[list[RowActionButton]] = [<sphinx_hosting.wildewidgets.project.LatestVersionButton object>, <wildewidgets.widgets.tables.actions.RowModelUrlButton object>, <wildewidgets.widgets.tables.actions.RowEditButton object>]

A list of RowActionButton subclasses to display in the

alignment: Final[dict[str, str]] = {'classifiers': 'left', 'description': 'left', 'latest_version': 'left', 'latest_version_date': 'left', 'machine_name': 'left', 'title': 'left'}

fields: Final[list[str]] = ['title', 'machine_name', 'classifiers', 'latest_version', 'description', 'latest_version_date']

A list of fields that we will list as columns. These are either fields on our model, or defined as render_FIELD_NAME_column methods

hidden: Final[list[str]] = ['classifiers', 'machine_name', 'latest_version_date']

page_length: int = 25

striped: bool = True

unsearchable: Final[list[str]] = ['classifiers', 'latest_version', 'latest_version_date']

A list of names of columns that will will not be searched when doing a

unsortable: Final[list[str]] = ['latest_version', 'latest_version_date']

A list of names of columns that will will not be sortable

verbose_names: Final[dict[str, str]] = {'latest_version': 'Latest Version', 'latest_version_date': 'Import Date', 'machine_name': 'Machine Name', 'title': 'Project Name'}

A dict of column name to column label. We use it to override the

class sphinx_hosting.wildewidgets.ProjectVersionTable(*args, **kwargs)

Displays a dataTable of our sphinx_hosting.models.Version instances for a particular sphinx_hosting.models.Project.

It’s used as a the main widget in by ProjectVersionTableWidget.

model

alias of Version

__init__(*args, **kwargs) → None

One of our kwargs must be project_id, the pk of the sphinx_hosting.models.Project for which we want to list sphinx_hosting.models.Version objects.

This will get added to the extra_data dict in the kwargs key, from which we reference it.

get_initial_queryset() → QuerySet[Version]

Filter our sphinx_hosting.models.Version objects by project_id.

Returns:

A filtered QuerySet on sphinx_hosting.models.Version

render_num_images_column(row: Version, _: str) → str

Render our num_images column. This is the number of sphinx_hosting.models.SphinxImage objects imported for this version.

Parameters:

• row – the Version we are rendering

• colunn – the name of the column to render

Returns:

The number of images for this version.

render_num_pages_column(row: Version, _: str) → str

Render our num_pages column. This is the number of sphinx_hosting.models.SphinxPage objects imported for this version.

Parameters:

• row – the Version we are rendering

• colunn – the name of the column to render

Returns:

The number of pages for this version.

actions: bool = True

Per row action buttons. If not False, this will simply add a rightmost column named Actions with a button named default_action_button_label which when clicked will take the

alignment: Final[dict[str, str]] = {'created': 'left', 'modified': 'left', 'num_images': 'right', 'num_pages': 'right', 'version': 'left'}

fields: Final[list[str]] = ['version', 'num_pages', 'num_images', 'created', 'modified']

A list of fields that we will list as columns. These are either fields on our model, or defined as render_FIELD_NAME_column methods

page_length: int = 25

project_id: int | None

The pk of the sphinx_hosting.models.Project for which to

sort_ascending: bool = False

striped: bool = True

unsearchable: Final[list[str]] = ['num_pages', 'num_images', 'created', 'modified']

A list of names of columns that will will not be searched when doing a

unsortable: Final[list[str]] = ['num_pages', 'num_images']

verbose_names: Final[dict[str, str]] = {'num_images': '# Images', 'num_pages': '# Pages', 'title': 'Version'}

A dict of column name to column label. We use it to override the

ProjectRelatedLinks

class sphinx_hosting.wildewidgets.ProjectRelatedLinkCreateModalWidget(project: Project, *args, **kwargs)

A modal dialog that holds the sphinx_hosting.forms.ProjectRelatedLinkForm for creating links.

Parameters:

• project – the project to create the link for

• args – the arguments to pass to the modal widget

Keyword Arguments:

kwargs – the keyword arguments to pass to the modal widget

__init__(project: Project, *args, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

class sphinx_hosting.wildewidgets.ProjectRelatedLinkUpdateModalWidget(link: ProjectRelatedLink, *args, **kwargs)

A modal dialog that holds the sphinx_hosting.forms.ProjectRelatedLinkForm for updating links.

One of these is created for each sphinx_hosting.models.ProjectRelatedLink object, and lives in the sphinx_hosting.widgets.ProjectRelatedLinksWidget.

__init__(link: ProjectRelatedLink, *args, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

class sphinx_hosting.wildewidgets.ProjectRelatedLinksListWidget(*args, remove_url: str | None = None, **kwargs: Any)

Renders a list of sphinx_hosting.models.ProjectRelatedLink objects as a list of wildewidgets.Link objects.

This is used on the project detail page, and is the read-only version of ProjectRelatedLinksWidget.

get_model_subblock(instance: ProjectRelatedLink) → Block

Create a block for displaying a model instance.

If the model instance has a get_absolute_url method, the text will be wrapped in a link to that URL.

Parameters:

instance – The model instance to create a block for

Returns:

A block for displaying the model instance

Return type:

Block

item_label: str = 'Related Link'

The label to use for each instance. This is used in the confirmation

class sphinx_hosting.wildewidgets.ProjectRelatedLinksWidget(project: Project, **kwargs)

A wildewidgets.CardWidget that allows us to manage the sphinx_hosting.models.ProjectRelatedLink objects for this sphinx_hosting.models.Project.

It renders a list of ProjectRelatedLinkListItemWidget objects and a “Add Related Link” button that opens a modal dialog.

This is used on the project update page, and is the editable version of ProjectRelatedLinksListWidget.

__init__(project: Project, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

get_title() → WidgetListLayoutHeader

Retrieve the widget’s title.

Returns:

The widget’s title string, widget object, or None if no title is set.

class sphinx_hosting.wildewidgets.ProjectRelatedLinkListItemWidget(object: ProjectRelatedLink)

Used by ProjectRelatedLinksWidget to render a single sphinx_hosting.models.ProjectRelatedLink object in its list.

__init__(object: ProjectRelatedLink)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

css_class: str = 'mb-2'

Search

These widgets are used on the search results page.

class sphinx_hosting.wildewidgets.GlobalSearchFormWidget(*args, **kwargs)

Encapsulates the sphinx_hosting.forms.GlobalSearchForm.

__init__(*args, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

css_class: str = 'mb-3'

name: str = 'global-search'

The CSS class that will be added to this element to as an identifier for

class sphinx_hosting.wildewidgets.PagedSearchLayout(results: SearchQuerySet, query: str | None = None, facets: dict[str, list[str]] | None = None, **kwargs)

The page layout for the entire search results page.

Parameters:

query – the text entered into the search form that got us to this results page

Keyword Arguments:

• query – the text entered into the search form that got us to this results page

• facets – the active facet filters. This will be a dict where the key is the facet name, and the value is a list of facet values to filter by.

__init__(results: SearchQuerySet, query: str | None = None, facets: dict[str, list[str]] | None = None, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

modifier: str = 'paged'

If specified, also add a class named {name}--{modifier} to the CSS

name: str = 'search-layout'

The CSS class that will be added to this element to as an identifier for

class sphinx_hosting.wildewidgets.SearchResultsPageHeader(query: str | None, facets: dict[str, list[str]] | None = None, **kwargs)

The header for the entire search results page. This shows the search string that got us here, and any active facet filters, allowing the user to remove any active filter by clicking the “X” next to the filter name.

Parameters:

query – the text entered into the search form that got us to this results page

Keyword Arguments:

facets – the active facet filters. This will be a dict where the key is the facet name, and the value is a list of facet values to filter by.

__init__(query: str | None, facets: dict[str, list[str]] | None = None, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

block: str = 'search-results__header'

block is the official wildewidgets name of the block; it can’t be changed

css_class: str = 'mb-5'

class sphinx_hosting.wildewidgets.FacetBlock(results: SearchQuerySet, query: str | None, **kwargs)

Base class for blocks that appear to the right of the search results listing on the search results page that allows you to refine your results by a particular facet that is present in the result set.

Subclass this to create facet filtering blocks for specific facets. Any facet you want to filter by must be defined on your search index by adding faceted=True to the field definition.

Parameters:

• results – the Haystack search queryset containing our search results

• query – the text entered into the search form that got us to this results page

__init__(results: SearchQuerySet, query: str | None, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

facet: str

model: type[django.db.models.Model]

model_field: str

class sphinx_hosting.wildewidgets.SearchResultsClassifiersFacet(results: SearchQuerySet, query: str | None, **kwargs)

A FacetBlock that allows the user to filter search results by classifier.

model

alias of Classifier

facet: str = 'classifiers'

model_field: str = 'name'

title: str = 'Classifiers'

class sphinx_hosting.wildewidgets.SearchResultsProjectFacet(results: SearchQuerySet, query: str | None, **kwargs)

A FacetBlock that allows the user to filter search results by project.

model

alias of Project

facet: str = 'project_id'

model_field: str = 'pk'

title: str = 'Projects'

class sphinx_hosting.wildewidgets.PagedSearchResultsBlock(results: SearchQuerySet, query: str | None, facets: dict[str, list[str]] | None = None, **kwargs)

Paged listing of SearchResultBlock entries describing our search results.

Parameters:

• results – the Haystack search queryset containing our search results

• query – the text entered into the search form that got us to this results

• page –

Keyword Arguments:

facets – a dictionary of facet names to lists of facet values that were selected on the search results page

model_widget

alias of SearchResultBlock

__init__(results: SearchQuerySet, query: str | None, facets: dict[str, list[str]] | None = None, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

page_kwarg: str = 'p'

paginate_by: int = 10

class sphinx_hosting.wildewidgets.SearchResultsHeader(results: SearchQuerySet, **kwargs)

The header for the search results listing (not the page header – that is SearchResultsPageHeader).

Parameters:

results – the Haystack search queryset containing our search results

__init__(results: SearchQuerySet, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

justify: str = 'between'

How to align items horizontally within this widget. Valid choices: start, : center, end, between, around, evenly. See Bootstrap: Flex, justify content. If not supplied here and justify is None, do whatever

name: str = 'search-results__title'

The CSS class that will be added to this element to as an identifier for

class sphinx_hosting.wildewidgets.SearchResultBlock(object: SearchResult = None, **kwargs)

Block we use for rendering a particular search result on the search results page.

Keyword Arguments:

object – the haystack.models.SearchResult object to render

class Header(result: SearchResult, **kwargs)

__init__(result: SearchResult, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

name: str = 'search-result__header'

The CSS class that will be added to this element to as an identifier for

__init__(object: SearchResult = None, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

block: str = 'search-result'

block is the official wildewidgets name of the block; it can’t be changed

Versions

class sphinx_hosting.wildewidgets.VersionInfoWidget(version: Version, **kwargs)

Gives a wildewidget.Datagrid type overview of information about this version:

• A link to the project that owns this sphinx_hosting.models.Version

• Create and last modified timestamps

• What version of Sphinx was used to generate the pages

Parameters:

version – the Version object we’re describing

__init__(version: Version, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

class sphinx_hosting.wildewidgets.VersionSphinxPageTableWidget(version_id: int, **kwargs)

A wildewidgets.CardWidget that gives our VersionSphinxPageTable dataTable a nice header with a total page count.

__init__(version_id: int, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

get_title() → WidgetListLayoutHeader

Retrieve the widget’s title.

Returns:

The widget’s title string, widget object, or None if no title is set.

class sphinx_hosting.wildewidgets.VersionUploadBlock(*blocks, form=None, **kwargs)

Holds the upload form for uploading documentation tarballs. Once uploaded, the tarball will be run through sphinx_hosting.importers.SphinxPackageImporter to actually import it into the database.

__init__(*blocks, form=None, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

css_class: str = 'my-3 border'

class sphinx_hosting.wildewidgets.VersionSphinxImageTableWidget(version_id: int, **kwargs)

A wildewidgets.CardWidget that gives our VersionSphinxImageTable dataTable a nice header with a total image count.

__init__(version_id: int, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

get_title() → WidgetListLayoutHeader

Retrieve the widget’s title.

Returns:

The widget’s title string, widget object, or None if no title is set.

class sphinx_hosting.wildewidgets.VersionSphinxPageTable(*args, **kwargs)

Displays a dataTable of our sphinx_hosting.models.SphinxPage instances for a particular sphinx_hosting.models.Version.

It’s used as a the main widget in by VersionSphinxPageTableWidget.

model

alias of SphinxPage

__init__(*args, **kwargs) → None

One of our kwargs must be version_id, the pk of the sphinx_hosting.models.Version for which we want to list sphinx_hosting.models.SphinxPage objects.

This will get added to the extra_data dict in the kwargs key, from which we reference it.

get_initial_queryset() → QuerySet

Filter our sphinx_hosting.models.SphinxPage objects by version_id.

actions: bool = True

Per row action buttons. If not False, this will simply add a rightmost column named Actions with a button named default_action_button_label which when clicked will take the

alignment: Final[dict[str, str]] = {'relative_path': 'left', 'size': 'right', 'title': 'left'}

fields: Final[list[str]] = ['title', 'relative_path', 'size']

These are the fields on our model (or which are computed) that we will

page_length: int = 25

striped: bool = True

version_id: int | None

The pk of the sphinx_hosting.models.Version for which to

class sphinx_hosting.wildewidgets.VersionSphinxImageTable(*args, **kwargs)

Displays a dataTable of our sphinx_hosting.models.SphinxImage instances for a particular sphinx_hosting.models.Version.

It’s used as a the main widget in by VersionSphinxImageTableWidget.

model

alias of SphinxImage

__init__(*args, **kwargs) → None

One of our kwargs must be version_id, the pk of the sphinx_hosting.models.Version for which we want to list sphinx_hosting.models.SphinxPage objects.

This will get added to the extra_data dict in the kwargs key, from which we reference it.

get_initial_queryset() → QuerySet

Filter our sphinx_hosting.models.SphinxPage objects by version_id.

render_file_path_column(row: Version, _: str) → str

Render our file_path column. This is the path to the file in MEDIA_ROOT.

Parameters:

• row – the Version we are rendering

• colunn – the name of the column to render

Returns:

The size in bytes of the uploaded file.

render_size_column(row: Version, _: str) → str

Render our size column. This is the size in bytes of the sphinx_hosting.models.SphinxImage.file field.

Parameters:

• row – the Version we are rendering

• colunn – the name of the column to render

Returns:

The size in bytes of the uploaded file.

alignment: Final[dict[str, str]] = {'file_path': 'left', 'orig_path': 'left', 'size': 'right'}

fields: Final[list[str]] = ['orig_path', 'file_path', 'size']

These are the fields on our model (or which are computed) that we will

page_length: int = 25

striped: bool = True

version_id: int | None

The pk of the sphinx_hosting.models.Version for which to

Sphinx Pages

class sphinx_hosting.wildewidgets.SphinxPageGlobalTableOfContentsMenu(*items: MenuItem, title: str | None = None, title_tag: str | None = None, title_css_classes: str | None = None, **kwargs)

The version-specific navigation menu that gets inserted into the page sidebar when viewing the documentation for a sphinx_hosting.models.Version. It will appear on all pages for that version.

classmethod parse_obj(version: Version) → SphinxPageGlobalTableOfContentsMenu

Parse the globaltoc of a sphinx_hosting.models.Version into a wildewidgets.Menu suitable for insertion into a wildewidgets.Navbar

The sphinx_hosting.models.Version.globaltoc is a dict that looks like this:

{
    items: [
        {'text': 'foo'},
        {'text': 'bar', 'url': '/foo', 'icon': 'blah'}
        {'text': 'bar', 'url': '/foo', 'icon': 'blah', items: [{'text': 'blah' ...} ...]}
        ...
    ]
}

Parameters:

version – the Version for which we are building the menu

Returns:

A configured SphinxPageGlobalTableOfContentsMenu.

css_class: str = 'mt-4'

title_css_classes: str = 'mt-3'

class sphinx_hosting.wildewidgets.SphinxPageLayout(page: SphinxPage, **kwargs)

The page layout for a single sphinx_hosting.models.SphinxPage. It consists of a two column layout with the page’s table of contents in the left column, and the content of the page in the right column.

Parameters:

page – the SphinxPage to render

__init__(page: SphinxPage, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

class sphinx_hosting.wildewidgets.SphinxPagePagination(page: SphinxPage, **kwargs)

Draws the “Previous Page”, Parent Page and Next Page buttons that are found at the top of each sphinx_hosting.views.SphinxPageDetailView.

It is built out of a Tabler/Bootstrap row, with each of the buttons in an equal sized col.

__init__(page: SphinxPage, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

name: str = 'sphinxpage-pagination'

The CSS class that will be added to this element to as an identifier for

class sphinx_hosting.wildewidgets.SphinxPageTitle(page: SphinxPage, **kwargs)

The title block for a sphinx_hosting.models.SphinxPage page.

Parameters:

page – the SphinxPage to render

__init__(page: SphinxPage, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

block: str = 'sphinxpage-title'

block is the official wildewidgets name of the block; it can’t be changed

css_class: str = 'mb-5'

class sphinx_hosting.wildewidgets.SphinxPagePermalinkWidget(page: SphinxPage, **kwargs)

Draws the “Permalink” button that is found at the top of the right-hand column of each sphinx_hosting.views.SphinxPageDetailView.

Parameters:

page – the SphinxPage we are rendering

__init__(page: SphinxPage, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

get_script() → str | None

Return the Javascript that will be executed when the “Permalink” button is clicked. This will copy the permalink to the browser clipboard.

Returns:

The javascript for this block.

class sphinx_hosting.wildewidgets.SphinxPageBodyWidget(page: SphinxPage, **kwargs)

The body of the page. The body as stored in the model is actually a Django template, so we retrieve the body, run it through the Django template engine, and display the results.

Parameters:

page – the SphinxPage we are rendering

__init__(page: SphinxPage, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

css_class: str = 'sphinxpage-body'

class sphinx_hosting.wildewidgets.SphinxPageTableOfContentsWidget(page: SphinxPage, **kwargs)

Draws the in-page navigation – the header hierarchy.

Parameters:

page – the SphinxPage we are rendering

__init__(page: SphinxPage, **kwargs)

Initialize a new Widget instance.

Parameters:

*args – Variable length argument list passed to parent.

Keyword Arguments:

• title – Optional title to display with the widget.

• icon – Optional icon identifier to use for this widget.

• **kwargs – Arbitrary keyword arguments passed to parent.

css_class: str = 'sphinxpage-toc'