core.layout

Attributes

_T

Classes

Layout	Contains useful methods related to rendering pages in html. Think of it
ChameleonLayout	Extends the base layout class with methods related to chameleon

Module Contents

core.layout._T

class core.layout.Layout(model: Any, request: core.request.CoreRequest)

Contains useful methods related to rendering pages in html. Think of it as an API that you can rely on in your templates.

The idea is to provide basic layout functions here, if they are usful for any kind of html application. You should then extend the core layout classes with your own.

timezone

time_format = 'HH:mm'

date_format = 'dd.MM.yyyy'

datetime_format = 'dd.MM.yyyy HH:mm'

date_long_format = 'dd. MMMM yyyy'

datetime_long_format = 'd. MMMM yyyy HH:mm'

weekday_long_format = 'EEEE'

weekday_short_format = 'E'

month_long_format = 'MMMM'

custom_body_attributes: dict[str, Any]

custom_html_attributes: dict[str, Any]

model

request

property app: core.framework.Framework

Returns the application behind the request.

batched(iterable: Iterable[_T], batch_size: int, container_factory: type[tuple] = ...) → Iterator[tuple[_T, ...]]

batched(iterable: Iterable[_T], batch_size: int, container_factory: type[list]) → Iterator[list[_T]]

batched(iterable: Iterable[_T], batch_size: int, container_factory: Callable[[Iterator[_T]], Collection[_T]]) → Iterator[Collection[_T]]

See onegov.core.utils.batched().

property csrf_token: str

Returns a csrf token for use with DELETE links (forms do their own thing automatically).

csrf_protected_url(url: str) → str

Adds a csrf token to the given url.

format_date(dt: datetime | date | None, format: str) → str

Takes a datetime and formats it according to local timezone and the given format.

isodate(date: datetime.datetime) → str

Returns the given date in the ISO 8601 format.

parse_isodate(string: str) → datetime.datetime

Returns the given ISO 8601 string as datetime.

static number_symbols(locale: str) → tuple[str, str]

Returns the locale specific number symbols.

format_number(number: numbers.Number | Decimal | float | None, decimal_places: int | None = None, padding: str = '') → str

Takes the given numer and formats it according to locale.

If the number is an integer, the default decimal places are 0, otherwise 2.

property view_name: str | None

Returns the view name of the current view, or None if it is the default view.

Note: This relies on morepath internals and is experimental in nature!

today() → datetime.date

now() → datetime.datetime

class core.layout.ChameleonLayout(model: Any, request: core.request.CoreRequest)

Bases: Layout

Extends the base layout class with methods related to chameleon template rendering.

This class assumes the existance of two templates:

• layout.pt -> Contains the page skeleton with headers, body and so on.

• macros.pt -> Contains chameleon macros.

property template_loader: core.templates.TemplateLoader

Returns the chameleon template loader.

property base: chameleon.PageTemplateFile

Returns the layout, which defines the base layout of all pages.

See templates/layout.pt.

property macros: core.templates.MacrosLookup

Returns the macros, which offer often used html constructs. See templates/macros.pt.

property elements: PageTemplate | PageTemplateFile

The templates used by the elements. Overwrite this with your own templates/elements.pt if neccessary.