ArchiveBox/archivebox/pkgs/abx-spec-django/abx_spec_django.py

120 lines
4.0 KiB
Python

import abx
from typing import List, Dict, Any, cast
###########################################################################################
class DjangoPluginSpec:
__order__ = 10
@abx.hookspec
def get_INSTALLED_APPS() -> List[str]:
return ['abx_spec_django']
@abx.hookspec
def get_TEMPLATE_DIRS() -> List[str]:
return [] # e.g. ['your_plugin_type/plugin_name/templates']
@abx.hookspec
def get_STATICFILES_DIRS() -> List[str]:
return [] # e.g. ['your_plugin_type/plugin_name/static']
# @abx.hookspec
# def register_STATICFILES_DIRS(STATICFILES_DIRS):
# """Mutate STATICFILES_DIRS in place to add your static dirs in a specific position"""
# # e.g. STATICFILES_DIRS.insert(0, 'your_plugin_type/plugin_name/static')
# pass
@abx.hookspec
def get_MIDDLEWARES() -> List[str]:
return [] # e.g. ['your_plugin_type.plugin_name.middleware.YourMiddleware']
# @abx.hookspec
# def register_MIDDLEWARE(MIDDLEWARE):
# """Mutate MIDDLEWARE in place to add your middleware in a specific position"""
# # e.g. MIDDLEWARE.insert(0, 'your_plugin_type.plugin_name.middleware.YourMiddleware')
# pass
@abx.hookspec
def get_AUTHENTICATION_BACKENDS() -> List[str]:
return [] # e.g. ['django_auth_ldap.backend.LDAPBackend']
# @abx.hookspec
# def register_AUTHENTICATION_BACKENDS(AUTHENTICATION_BACKENDS):
# """Mutate AUTHENTICATION_BACKENDS in place to add your auth backends in a specific position"""
# # e.g. AUTHENTICATION_BACKENDS.insert(0, 'your_plugin_type.plugin_name.backend.YourBackend')
# pass
@abx.hookspec
def get_DJANGO_HUEY_QUEUES(QUEUE_DATABASE_NAME) -> Dict[str, Dict[str, Any]]:
return {} # e.g. {'some_queue_name': {'filename': 'some_queue_name.sqlite3', 'store_none': True, 'results': True, ...}}
# @abx.hookspec
# def register_DJANGO_HUEY(DJANGO_HUEY):
# """Mutate DJANGO_HUEY in place to add your huey queues in a specific position"""
# # e.g. DJANGO_HUEY['queues']['some_queue_name']['some_setting'] = 'some_value'
# pass
@abx.hookspec
def get_ADMIN_DATA_VIEWS_URLS() -> List[str]:
return []
# @abx.hookspec
# def register_ADMIN_DATA_VIEWS(ADMIN_DATA_VIEWS):
# """Mutate ADMIN_DATA_VIEWS in place to add your admin data views in a specific position"""
# # e.g. ADMIN_DATA_VIEWS['URLS'].insert(0, 'your_plugin_type/plugin_name/admin_data_views.py')
# pass
# @abx.hookspec
# def register_settings(settings):
# """Mutate settings in place to add your settings / modify existing settings"""
# # settings.SOME_KEY = 'some_value'
# pass
###########################################################################################
@abx.hookspec
def get_urlpatterns() -> List[str]:
return [] # e.g. [path('your_plugin_type/plugin_name/url.py', your_view)]
# @abx.hookspec
# def register_urlpatterns(urlpatterns):
# """Mutate urlpatterns in place to add your urlpatterns in a specific position"""
# # e.g. urlpatterns.insert(0, path('your_plugin_type/plugin_name/url.py', your_view))
# pass
###########################################################################################
@abx.hookspec
def register_admin(admin_site) -> None:
"""Register django admin views/models with the main django admin site instance"""
# e.g. admin_site.register(your_model, your_admin_class)
pass
###########################################################################################
@abx.hookspec
def ready() -> None:
"""Called when Django apps app.ready() are triggered"""
# e.g. abx.pm.hook.get_CONFIG().ytdlp.validate()
pass
PLUGIN_SPEC = DjangoPluginSpec
class ExpectedPluginSpec(DjangoPluginSpec):
pass
TypedPluginManager = abx.ABXPluginManager[ExpectedPluginSpec]
pm = cast(TypedPluginManager, abx.pm)