mirror of
https://github.com/ArchiveBox/ArchiveBox.git
synced 2026-09-14 11:06:13 +05:00
Some checks are pending
CodeQL / Analyze (${{ matrix.language }}) (none, python) (push) Waiting to run
Build Debian package / build (amd64) (push) Waiting to run
Build Debian package / build (arm64) (push) Waiting to run
Build Debian package / test (amd64, ubuntu-24.04) (push) Blocked by required conditions
Build Debian package / test (arm64, ubuntu-24.04-arm) (push) Blocked by required conditions
Build Debian package / release (push) Blocked by required conditions
Build Docker image / build ${{ matrix.platform }} (digest-linux-amd64, docker-amd64, linux/amd64, ubuntu-24.04) (push) Waiting to run
Build Docker image / build ${{ matrix.platform }} (digest-linux-arm64, docker-arm64, linux/arm64, ubuntu-24.04-arm) (push) Waiting to run
Build Docker image / publish multiarch tags (push) Blocked by required conditions
Run linters / lint (push) Waiting to run
Build Pip package / build (push) Waiting to run
Release State / release-state (push) Waiting to run
Parallel Tests / Discover test files (push) Waiting to run
Parallel Tests / ${{ matrix.test.name }} (push) Blocked by required conditions
Parallel Tests / ${{ matrix.plugin.name }} (push) Blocked by required conditions
Run tests / python_tests (ubuntu-22.04, 3.13) (push) Waiting to run
Run tests / docker_tests (push) Waiting to run
Clean rebuild of docs/apidocs/archivebox/ via autodoc2: - Removes 19 stale module pages whose source files no longer exist (cli_utils, host_utils, schedule_utils — renamed to *_util; actors, ideas, debugging, folders, legacy, progress_layout, tests_piping, config_tags, personas.runtime/views, orchestrator*, worker, tasks). - Adds 29 new module pages for code that was added since the previous generation but not yet documented. - Updates 100 existing pages to reflect API surface changes (e.g. ENABLED_PLUGINS Field removed, SNAPSHOTS_PER_PAGE clamp removed, default bumped to 50, etc.). 156 source modules <-> 156 apidoc files (zero drift). Build clean under sphinx-build -W --keep-going. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
351 lines
8.5 KiB
Markdown
351 lines
8.5 KiB
Markdown
# {py:mod}`archivebox.base_models.admin`
|
|
|
|
```{py:module} archivebox.base_models.admin
|
|
```
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin
|
|
:allowtitles:
|
|
```
|
|
|
|
## Module Contents
|
|
|
|
### Classes
|
|
|
|
````{list-table}
|
|
:class: autosummary longtable
|
|
:align: left
|
|
|
|
* - {py:obj}`HexUUIDConverter <archivebox.base_models.admin.HexUUIDConverter>`
|
|
- ```{autodoc2-docstring} archivebox.base_models.admin.HexUUIDConverter
|
|
:summary:
|
|
```
|
|
* - {py:obj}`ConfigOption <archivebox.base_models.admin.ConfigOption>`
|
|
-
|
|
* - {py:obj}`KeyValueWidget <archivebox.base_models.admin.KeyValueWidget>`
|
|
- ```{autodoc2-docstring} archivebox.base_models.admin.KeyValueWidget
|
|
:summary:
|
|
```
|
|
* - {py:obj}`ConfigEditorMixin <archivebox.base_models.admin.ConfigEditorMixin>`
|
|
- ```{autodoc2-docstring} archivebox.base_models.admin.ConfigEditorMixin
|
|
:summary:
|
|
```
|
|
* - {py:obj}`BaseModelAdmin <archivebox.base_models.admin.BaseModelAdmin>`
|
|
-
|
|
````
|
|
|
|
### API
|
|
|
|
`````{py:class} HexUUIDConverter
|
|
:canonical: archivebox.base_models.admin.HexUUIDConverter
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.HexUUIDConverter
|
|
```
|
|
|
|
````{py:attribute} regex
|
|
:canonical: archivebox.base_models.admin.HexUUIDConverter.regex
|
|
:value: >
|
|
'[0-9a-fA-F]{32}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}'
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.HexUUIDConverter.regex
|
|
```
|
|
|
|
````
|
|
|
|
````{py:method} to_python(value: str) -> str
|
|
:canonical: archivebox.base_models.admin.HexUUIDConverter.to_python
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.HexUUIDConverter.to_python
|
|
```
|
|
|
|
````
|
|
|
|
````{py:method} to_url(value) -> str
|
|
:canonical: archivebox.base_models.admin.HexUUIDConverter.to_url
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.HexUUIDConverter.to_url
|
|
```
|
|
|
|
````
|
|
|
|
`````
|
|
|
|
`````{py:class} ConfigOption()
|
|
:canonical: archivebox.base_models.admin.ConfigOption
|
|
|
|
Bases: {py:obj}`typing.TypedDict`
|
|
|
|
````{py:attribute} plugin
|
|
:canonical: archivebox.base_models.admin.ConfigOption.plugin
|
|
:type: str
|
|
:value: >
|
|
None
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.ConfigOption.plugin
|
|
```
|
|
|
|
````
|
|
|
|
````{py:attribute} type
|
|
:canonical: archivebox.base_models.admin.ConfigOption.type
|
|
:type: str | list[str]
|
|
:value: >
|
|
None
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.ConfigOption.type
|
|
```
|
|
|
|
````
|
|
|
|
````{py:attribute} default
|
|
:canonical: archivebox.base_models.admin.ConfigOption.default
|
|
:type: object
|
|
:value: >
|
|
None
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.ConfigOption.default
|
|
```
|
|
|
|
````
|
|
|
|
````{py:attribute} description
|
|
:canonical: archivebox.base_models.admin.ConfigOption.description
|
|
:type: str
|
|
:value: >
|
|
None
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.ConfigOption.description
|
|
```
|
|
|
|
````
|
|
|
|
````{py:attribute} enum
|
|
:canonical: archivebox.base_models.admin.ConfigOption.enum
|
|
:type: typing.NotRequired[list[object]]
|
|
:value: >
|
|
None
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.ConfigOption.enum
|
|
```
|
|
|
|
````
|
|
|
|
````{py:attribute} pattern
|
|
:canonical: archivebox.base_models.admin.ConfigOption.pattern
|
|
:type: typing.NotRequired[str]
|
|
:value: >
|
|
None
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.ConfigOption.pattern
|
|
```
|
|
|
|
````
|
|
|
|
````{py:attribute} minimum
|
|
:canonical: archivebox.base_models.admin.ConfigOption.minimum
|
|
:type: typing.NotRequired[int | float]
|
|
:value: >
|
|
None
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.ConfigOption.minimum
|
|
```
|
|
|
|
````
|
|
|
|
````{py:attribute} maximum
|
|
:canonical: archivebox.base_models.admin.ConfigOption.maximum
|
|
:type: typing.NotRequired[int | float]
|
|
:value: >
|
|
None
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.ConfigOption.maximum
|
|
```
|
|
|
|
````
|
|
|
|
`````
|
|
|
|
``````{py:class} KeyValueWidget(attrs=None)
|
|
:canonical: archivebox.base_models.admin.KeyValueWidget
|
|
|
|
Bases: {py:obj}`django.forms.Widget`
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.KeyValueWidget
|
|
```
|
|
|
|
```{rubric} Initialization
|
|
```
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.KeyValueWidget.__init__
|
|
```
|
|
|
|
````{py:attribute} template_name
|
|
:canonical: archivebox.base_models.admin.KeyValueWidget.template_name
|
|
:value: <Multiline-String>
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.KeyValueWidget.template_name
|
|
```
|
|
|
|
````
|
|
|
|
`````{py:class} Media
|
|
:canonical: archivebox.base_models.admin.KeyValueWidget.Media
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.KeyValueWidget.Media
|
|
```
|
|
|
|
````{py:attribute} css
|
|
:canonical: archivebox.base_models.admin.KeyValueWidget.Media.css
|
|
:value: >
|
|
None
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.KeyValueWidget.Media.css
|
|
```
|
|
|
|
````
|
|
|
|
````{py:attribute} js
|
|
:canonical: archivebox.base_models.admin.KeyValueWidget.Media.js
|
|
:value: >
|
|
[]
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.KeyValueWidget.Media.js
|
|
```
|
|
|
|
````
|
|
|
|
`````
|
|
|
|
````{py:method} _get_config_options() -> dict[str, archivebox.base_models.admin.ConfigOption]
|
|
:canonical: archivebox.base_models.admin.KeyValueWidget._get_config_options
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.KeyValueWidget._get_config_options
|
|
```
|
|
|
|
````
|
|
|
|
````{py:method} _parse_value(value: object) -> dict[str, object]
|
|
:canonical: archivebox.base_models.admin.KeyValueWidget._parse_value
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.KeyValueWidget._parse_value
|
|
```
|
|
|
|
````
|
|
|
|
````{py:method} render(name: str, value: object, attrs: collections.abc.Mapping[str, str] | None = None, renderer: django.forms.renderers.BaseRenderer | None = None) -> django.utils.safestring.SafeString
|
|
:canonical: archivebox.base_models.admin.KeyValueWidget.render
|
|
|
|
````
|
|
|
|
````{py:method} _render_row(widget_id: str, key: str, value: str) -> str
|
|
:canonical: archivebox.base_models.admin.KeyValueWidget._render_row
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.KeyValueWidget._render_row
|
|
```
|
|
|
|
````
|
|
|
|
````{py:method} _escape(s: object) -> str
|
|
:canonical: archivebox.base_models.admin.KeyValueWidget._escape
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.KeyValueWidget._escape
|
|
```
|
|
|
|
````
|
|
|
|
````{py:method} value_from_datadict(data: django.http.QueryDict | collections.abc.Mapping[str, object], files: object, name: str) -> str
|
|
:canonical: archivebox.base_models.admin.KeyValueWidget.value_from_datadict
|
|
|
|
````
|
|
|
|
``````
|
|
|
|
`````{py:class} ConfigEditorMixin(model, admin_site)
|
|
:canonical: archivebox.base_models.admin.ConfigEditorMixin
|
|
|
|
Bases: {py:obj}`django.contrib.admin.ModelAdmin`
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.ConfigEditorMixin
|
|
```
|
|
|
|
```{rubric} Initialization
|
|
```
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.ConfigEditorMixin.__init__
|
|
```
|
|
|
|
````{py:method} formfield_for_dbfield(db_field: django.db.models.Field, request: django.http.HttpRequest, **kwargs: object) -> django.forms.Field | None
|
|
:canonical: archivebox.base_models.admin.ConfigEditorMixin.formfield_for_dbfield
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.ConfigEditorMixin.formfield_for_dbfield
|
|
```
|
|
|
|
````
|
|
|
|
````{py:method} save_model(request: django.http.HttpRequest, obj, form, change)
|
|
:canonical: archivebox.base_models.admin.ConfigEditorMixin.save_model
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.ConfigEditorMixin.save_model
|
|
```
|
|
|
|
````
|
|
|
|
`````
|
|
|
|
`````{py:class} BaseModelAdmin(model, admin_site)
|
|
:canonical: archivebox.base_models.admin.BaseModelAdmin
|
|
|
|
Bases: {py:obj}`django_object_actions.DjangoObjectActions`, {py:obj}`django.contrib.admin.ModelAdmin`
|
|
|
|
````{py:attribute} list_display
|
|
:canonical: archivebox.base_models.admin.BaseModelAdmin.list_display
|
|
:value: >
|
|
('id', 'created_at', 'created_by')
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.BaseModelAdmin.list_display
|
|
```
|
|
|
|
````
|
|
|
|
````{py:attribute} readonly_fields
|
|
:canonical: archivebox.base_models.admin.BaseModelAdmin.readonly_fields
|
|
:value: >
|
|
('id', 'created_at', 'modified_at')
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.BaseModelAdmin.readonly_fields
|
|
```
|
|
|
|
````
|
|
|
|
````{py:attribute} show_search_mode_selector
|
|
:canonical: archivebox.base_models.admin.BaseModelAdmin.show_search_mode_selector
|
|
:value: >
|
|
False
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.BaseModelAdmin.show_search_mode_selector
|
|
```
|
|
|
|
````
|
|
|
|
````{py:method} get_default_search_mode() -> str
|
|
:canonical: archivebox.base_models.admin.BaseModelAdmin.get_default_search_mode
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.BaseModelAdmin.get_default_search_mode
|
|
```
|
|
|
|
````
|
|
|
|
````{py:method} get_form(request: django.http.HttpRequest, obj: django.db.models.Model | None = None, change: bool = False, **kwargs: object)
|
|
:canonical: archivebox.base_models.admin.BaseModelAdmin.get_form
|
|
|
|
````
|
|
|
|
````{py:method} get_urls()
|
|
:canonical: archivebox.base_models.admin.BaseModelAdmin.get_urls
|
|
|
|
```{autodoc2-docstring} archivebox.base_models.admin.BaseModelAdmin.get_urls
|
|
```
|
|
|
|
````
|
|
|
|
`````
|