Commands

Duplicate Pages

class integreat_cms.core.management.commands.duplicate_pages.Command(stdout=None, stderr=None, no_color=False, force_color=False)[source]

Bases: DebugCommand

Management command to duplicate all pages of a region

__init__(stdout=None, stderr=None, no_color=False, force_color=False)[source]
add_arguments(parser: CommandParser) None[source]

Define the arguments of this command

Parameters:

parser (CommandParser) – The argument parser

Return type:

None

add_base_argument(parser, *args, **kwargs)[source]

Call the parser’s add_argument() method, suppressing the help text according to BaseCommand.suppressed_base_arguments.

base_stealth_options = ('stderr', 'stdout')[source]
check(app_configs=None, tags=None, display_num_errors=False, include_deployment_checks=False, fail_level=40, databases=None)[source]

Use the system check framework to validate entire Django project. Raise CommandError for any serious message (error or critical errors). If there are only light messages (like warnings), print them to stderr and don’t raise an exception.

check_migrations()[source]

Print a warning if the set of migrations on disk don’t match the migrations in the database.

create_parser(prog_name, subcommand, **kwargs)[source]

Create and return the ArgumentParser which will be used to parse the arguments to this command.

execute(*args: Any, **options: Any) None[source]

Try to run the command

Parameters:
  • *args (Any) – The supplied arguments

  • **options (Any) – The supplied keyword options

Raises:

CommandError – When the input is invalid

Return type:

None

get_version()[source]

Return the Django version, which should be correct for all built-in Django commands. User-supplied commands can override this method to return their own version.

handle(*args: Any, region_slug: str, **options: Any) None[source]

Try to run the command

Parameters:
  • *args (Any) – The supplied arguments

  • region_slug (str) – The slug of the given region

  • **options (Any) – The supplied keyword options

Raises:

CommandError – When the input is invalid

Return type:

None

help = 'Duplicate all pages of a specific region'[source]
output_transaction = False[source]
print_help(prog_name, subcommand)[source]

Print the help message for this command, derived from self.usage().

requires_migrations_checks = False[source]
requires_system_checks = '__all__'[source]
run_from_argv(argv)[source]

Set up any environment changes requested (e.g., Python path and Django settings), then run this command. If the command raises a CommandError, intercept it and print it sensibly to stderr. If the --traceback option is present or the raised Exception is not CommandError, raise it.

set_logging_stream() None[source]

Set the output stream to the command’s stdout/stderr wrapper. Has to be called as part of the command’s handle() function.

Return type:

None

stealth_options = ()[source]
suppressed_base_arguments = {}[source]
integreat_cms.core.management.commands.duplicate_pages.duplicate_page(old_page: Page, new_parent: Page | None = None) Page[source]

Duplicate a page and insert it as child of the given new parent

Parameters:
  • old_page (Page) – The old page which should be copied

  • new_parent (Page | None) – The new parent where the duplicate should reside

Returns:

The copied page

Return type:

Page

integreat_cms.core.management.commands.duplicate_pages.duplicate_pages(region: Region, old_parent: Page | None = None, new_parent: Page | None = None) None[source]

Duplicate pages recursively for the given region

Parameters:
  • region (Region) – The given region

  • old_parent (Page | None) – The old parent page which descendants should be copied

  • new_parent (Page | None) – The new parent where the duplicates should reside

Return type:

None

Find Large Files

class integreat_cms.core.management.commands.find_large_files.Command(stdout=None, stderr=None, no_color=False, force_color=False)[source]

Bases: LogCommand

Management command to find large media files

__init__(stdout=None, stderr=None, no_color=False, force_color=False)[source]
add_arguments(parser: CommandParser) None[source]

Define the arguments of this command

Parameters:

parser (CommandParser) – The argument parser

Return type:

None

add_base_argument(parser, *args, **kwargs)[source]

Call the parser’s add_argument() method, suppressing the help text according to BaseCommand.suppressed_base_arguments.

base_stealth_options = ('stderr', 'stdout')[source]
check(app_configs=None, tags=None, display_num_errors=False, include_deployment_checks=False, fail_level=40, databases=None)[source]

Use the system check framework to validate entire Django project. Raise CommandError for any serious message (error or critical errors). If there are only light messages (like warnings), print them to stderr and don’t raise an exception.

check_migrations()[source]

Print a warning if the set of migrations on disk don’t match the migrations in the database.

create_parser(prog_name, subcommand, **kwargs)[source]

Create and return the ArgumentParser which will be used to parse the arguments to this command.

execute(*args, **options)[source]

Try to execute this command, performing system checks if needed (as controlled by the requires_system_checks attribute, except if force-skipped).

get_version()[source]

Return the Django version, which should be correct for all built-in Django commands. User-supplied commands can override this method to return their own version.

handle(*args: Any, limit: int, threshold: int, **options: Any) None[source]

Try to run the command

Parameters:
  • *args (Any) – The supplied arguments

  • limit (int) – Limit the result to this number

  • threshold (int) – Only show the files larger than this value

  • **options (Any) – The supplied keyword options

Raises:

CommandError – When the input is invalid

Return type:

None

help = 'Find large media files in the CMS'[source]
output_transaction = False[source]
print_help(prog_name, subcommand)[source]

Print the help message for this command, derived from self.usage().

requires_migrations_checks = False[source]
requires_system_checks = '__all__'[source]
run_from_argv(argv)[source]

Set up any environment changes requested (e.g., Python path and Django settings), then run this command. If the command raises a CommandError, intercept it and print it sensibly to stderr. If the --traceback option is present or the raised Exception is not CommandError, raise it.

set_logging_stream() None[source]

Set the output stream to the command’s stdout/stderr wrapper. Has to be called as part of the command’s handle() function.

Return type:

None

stealth_options = ()[source]
suppressed_base_arguments = {}[source]

Find Missing Versions

class integreat_cms.core.management.commands.find_missing_versions.Command(stdout=None, stderr=None, no_color=False, force_color=False)[source]

Bases: LogCommand

Management command to find missing versions

__init__(stdout=None, stderr=None, no_color=False, force_color=False)[source]
add_arguments(parser: CommandParser) None[source]

Define the arguments of this command

Parameters:

parser (CommandParser) – The argument parser

Return type:

None

add_base_argument(parser, *args, **kwargs)[source]

Call the parser’s add_argument() method, suppressing the help text according to BaseCommand.suppressed_base_arguments.

base_stealth_options = ('stderr', 'stdout')[source]
check(app_configs=None, tags=None, display_num_errors=False, include_deployment_checks=False, fail_level=40, databases=None)[source]

Use the system check framework to validate entire Django project. Raise CommandError for any serious message (error or critical errors). If there are only light messages (like warnings), print them to stderr and don’t raise an exception.

check_migrations()[source]

Print a warning if the set of migrations on disk don’t match the migrations in the database.

create_parser(prog_name, subcommand, **kwargs)[source]

Create and return the ArgumentParser which will be used to parse the arguments to this command.

execute(*args, **options)[source]

Try to execute this command, performing system checks if needed (as controlled by the requires_system_checks attribute, except if force-skipped).

get_version()[source]

Return the Django version, which should be correct for all built-in Django commands. User-supplied commands can override this method to return their own version.

handle(*args: Any, model: ModelBase, **options: Any) None[source]

Try to run the command

Parameters:
  • *args (Any) – The supplied arguments

  • model (ModelBase) – The model to check

  • **options (Any) – The supplied keyword options

Return type:

None

help = 'Find version inconsistencies in the CMS'[source]
output_transaction = False[source]
print_help(prog_name, subcommand)[source]

Print the help message for this command, derived from self.usage().

requires_migrations_checks = False[source]
requires_system_checks = '__all__'[source]
run_from_argv(argv)[source]

Set up any environment changes requested (e.g., Python path and Django settings), then run this command. If the command raises a CommandError, intercept it and print it sensibly to stderr. If the --traceback option is present or the raised Exception is not CommandError, raise it.

set_logging_stream() None[source]

Set the output stream to the command’s stdout/stderr wrapper. Has to be called as part of the command’s handle() function.

Return type:

None

stealth_options = ()[source]
suppressed_base_arguments = {}[source]
integreat_cms.core.management.commands.find_missing_versions.MODELS: dict[str, ModelBase] = {'event': <class 'integreat_cms.cms.models.events.event_translation.EventTranslation'>, 'page': <class 'integreat_cms.cms.models.pages.page_translation.PageTranslation'>, 'poi': <class 'integreat_cms.cms.models.pois.poi_translation.POITranslation'>}[source]

The possible model choices

{
    'event': <class 'integreat_cms.cms.models.events.event_translation.EventTranslation'>,
    'page': <class 'integreat_cms.cms.models.pages.page_translation.PageTranslation'>,
    'poi': <class 'integreat_cms.cms.models.pois.poi_translation.POITranslation'>,
}
integreat_cms.core.management.commands.find_missing_versions.get_model(model_str: str) ModelBase[source]

Convert a model string to a translation model class

Parameters:

model_str (str) – The model string

Returns:

The model class

Raises:

ArgumentTypeError – When the input is invalid

Return type:

ModelBase

Hix Bulk

class integreat_cms.core.management.commands.hix_bulk.Command(stdout=None, stderr=None, no_color=False, force_color=False)[source]

Bases: LogCommand

Command to calculate the hix values for public page translations which do not currently have a score

__init__(stdout=None, stderr=None, no_color=False, force_color=False)[source]
add_arguments(parser: CommandParser) None[source]

Define the arguments of this command

Parameters:

parser (CommandParser) – The argument parser

Return type:

None

add_base_argument(parser, *args, **kwargs)[source]

Call the parser’s add_argument() method, suppressing the help text according to BaseCommand.suppressed_base_arguments.

base_stealth_options = ('stderr', 'stdout')[source]
check(app_configs=None, tags=None, display_num_errors=False, include_deployment_checks=False, fail_level=40, databases=None)[source]

Use the system check framework to validate entire Django project. Raise CommandError for any serious message (error or critical errors). If there are only light messages (like warnings), print them to stderr and don’t raise an exception.

check_migrations()[source]

Print a warning if the set of migrations on disk don’t match the migrations in the database.

create_parser(prog_name, subcommand, **kwargs)[source]

Create and return the ArgumentParser which will be used to parse the arguments to this command.

execute(*args, **options)[source]

Try to execute this command, performing system checks if needed (as controlled by the requires_system_checks attribute, except if force-skipped).

get_version()[source]

Return the Django version, which should be correct for all built-in Django commands. User-supplied commands can override this method to return their own version.

handle(*args: Any, region_slugs: list[str], **options: Any) None[source]

Try to run the command

Parameters:
  • *args (Any) – The supplied arguments

  • region_slugs (list[str]) – The slugs of the given regions

  • **options (Any) – The supplied keyword options

Return type:

None

help = 'Calculates and stores the hix value for all public page translations for which it is missing'[source]
output_transaction = False[source]
print_help(prog_name, subcommand)[source]

Print the help message for this command, derived from self.usage().

requires_migrations_checks = False[source]
requires_system_checks = '__all__'[source]
run_from_argv(argv)[source]

Set up any environment changes requested (e.g., Python path and Django settings), then run this command. If the command raises a CommandError, intercept it and print it sensibly to stderr. If the --traceback option is present or the raised Exception is not CommandError, raise it.

set_logging_stream() None[source]

Set the output stream to the command’s stdout/stderr wrapper. Has to be called as part of the command’s handle() function.

Return type:

None

stealth_options = ()[source]
suppressed_base_arguments = {}[source]
integreat_cms.core.management.commands.hix_bulk.calculate_hix_for_region(region: Region) None[source]

Calculates the hix score for all missing pages in the region. Assumes that hix is globally enabled and enabled for the region

Parameters:

region (Region) – The region

Return type:

None

Repair Tree

class integreat_cms.core.management.commands.repair_tree.Command(stdout=None, stderr=None, no_color=False, force_color=False)[source]

Bases: LogCommand

Management command to repair a broken Treebeard page tree

__init__(stdout=None, stderr=None, no_color=False, force_color=False)[source]
add_arguments(parser: CommandParser) None[source]

Define the arguments of this command

Parameters:

parser (CommandParser) – The argument parser

Return type:

None

add_base_argument(parser, *args, **kwargs)[source]

Call the parser’s add_argument() method, suppressing the help text according to BaseCommand.suppressed_base_arguments.

base_stealth_options = ('stderr', 'stdout')[source]
calculate_left_right_values(tree_node: Page, left: int, commit: bool) int[source]

Recursively calculate the left and right value for a given node and its children.

Parameters:
  • tree_node (Page) – A node of a MPTT tree

  • left (int) – The new left value of the node

  • commit (bool) – Whether changes should be written to the database

Returns:

The new right value of the node

Return type:

int

check(app_configs=None, tags=None, display_num_errors=False, include_deployment_checks=False, fail_level=40, databases=None)[source]

Use the system check framework to validate entire Django project. Raise CommandError for any serious message (error or critical errors). If there are only light messages (like warnings), print them to stderr and don’t raise an exception.

check_for_orphans(tree_id: int) None[source]

Check whether orphans exist (pages with the same tree_id, but its ancestors are in another tree)

Parameters:

tree_id (int) – The current tree id

Return type:

None

check_migrations()[source]

Print a warning if the set of migrations on disk don’t match the migrations in the database.

check_tree_fields(tree_node: Page, left: int, right: int) bool[source]

Check whether the tree fields are correct

Parameters:
  • tree_node (Page) – The current node

  • left (int) – The new left value of the node

  • right (int) – The new right value of the node

Returns:

Whether the tree fields of the node are valid

Return type:

bool

create_parser(prog_name, subcommand, **kwargs)[source]

Create and return the ArgumentParser which will be used to parse the arguments to this command.

execute(*args, **options)[source]

Try to execute this command, performing system checks if needed (as controlled by the requires_system_checks attribute, except if force-skipped).

get_version()[source]

Return the Django version, which should be correct for all built-in Django commands. User-supplied commands can override this method to return their own version.

handle(*args: Any, page_id: int, commit: bool, **options: Any) None[source]

Try to run the command

Parameters:
  • *args (Any) – The supplied arguments

  • page_id (int) – The page ID (node) of a broken tree

  • commit (bool) – Whether changes should be written to the database

  • **options (Any) – The supplied keyword options

Raises:

CommandError – When the input is invalid

Return type:

None

help = 'Repair broken tree structure'[source]
output_transaction = False[source]
pages_seen: list[int] = [][source]
print_help(prog_name, subcommand)[source]

Print the help message for this command, derived from self.usage().

requires_migrations_checks = False[source]
requires_system_checks = '__all__'[source]
run_from_argv(argv)[source]

Set up any environment changes requested (e.g., Python path and Django settings), then run this command. If the command raises a CommandError, intercept it and print it sensibly to stderr. If the --traceback option is present or the raised Exception is not CommandError, raise it.

set_logging_stream() None[source]

Set the output stream to the command’s stdout/stderr wrapper. Has to be called as part of the command’s handle() function.

Return type:

None

stealth_options = ()[source]
suppressed_base_arguments = {}[source]

Reset Mt Budget

class integreat_cms.core.management.commands.reset_mt_budget.Command(stdout=None, stderr=None, no_color=False, force_color=False)[source]

Bases: LogCommand

Management command to reset MT budget

__init__(stdout=None, stderr=None, no_color=False, force_color=False)[source]
add_arguments(parser: CommandParser) None[source]

Define the arguments of this command

Parameters:

parser (CommandParser) – The argument parser

Return type:

None

add_base_argument(parser, *args, **kwargs)[source]

Call the parser’s add_argument() method, suppressing the help text according to BaseCommand.suppressed_base_arguments.

base_stealth_options = ('stderr', 'stdout')[source]
check(app_configs=None, tags=None, display_num_errors=False, include_deployment_checks=False, fail_level=40, databases=None)[source]

Use the system check framework to validate entire Django project. Raise CommandError for any serious message (error or critical errors). If there are only light messages (like warnings), print them to stderr and don’t raise an exception.

check_migrations()[source]

Print a warning if the set of migrations on disk don’t match the migrations in the database.

create_parser(prog_name, subcommand, **kwargs)[source]

Create and return the ArgumentParser which will be used to parse the arguments to this command.

execute(*args, **options)[source]

Try to execute this command, performing system checks if needed (as controlled by the requires_system_checks attribute, except if force-skipped).

get_version()[source]

Return the Django version, which should be correct for all built-in Django commands. User-supplied commands can override this method to return their own version.

handle(*args: Any, force: bool, **options: Any) None[source]

Try to run the command

Parameters:
  • args (Any) –

  • force (bool) –

  • options (Any) –

Return type:

None

help: str = 'Reset MT budget'[source]
output_transaction = False[source]
print_help(prog_name, subcommand)[source]

Print the help message for this command, derived from self.usage().

requires_migrations_checks = False[source]
requires_system_checks = '__all__'[source]
run_from_argv(argv)[source]

Set up any environment changes requested (e.g., Python path and Django settings), then run this command. If the command raises a CommandError, intercept it and print it sensibly to stderr. If the --traceback option is present or the raised Exception is not CommandError, raise it.

set_logging_stream() None[source]

Set the output stream to the command’s stdout/stderr wrapper. Has to be called as part of the command’s handle() function.

Return type:

None

stealth_options = ()[source]
suppressed_base_arguments = {}[source]

Send Push Notifications

class integreat_cms.core.management.commands.send_push_notifications.Command(stdout=None, stderr=None, no_color=False, force_color=False)[source]

Bases: LogCommand

Management command to send timed push notifications

__init__(stdout=None, stderr=None, no_color=False, force_color=False)[source]
add_arguments(parser)[source]

Entry point for subclassed commands to add custom arguments.

add_base_argument(parser, *args, **kwargs)[source]

Call the parser’s add_argument() method, suppressing the help text according to BaseCommand.suppressed_base_arguments.

base_stealth_options = ('stderr', 'stdout')[source]
check(app_configs=None, tags=None, display_num_errors=False, include_deployment_checks=False, fail_level=40, databases=None)[source]

Use the system check framework to validate entire Django project. Raise CommandError for any serious message (error or critical errors). If there are only light messages (like warnings), print them to stderr and don’t raise an exception.

check_migrations()[source]

Print a warning if the set of migrations on disk don’t match the migrations in the database.

create_parser(prog_name, subcommand, **kwargs)[source]

Create and return the ArgumentParser which will be used to parse the arguments to this command.

execute(*args, **options)[source]

Try to execute this command, performing system checks if needed (as controlled by the requires_system_checks attribute, except if force-skipped).

get_version()[source]

Return the Django version, which should be correct for all built-in Django commands. User-supplied commands can override this method to return their own version.

handle(*args: Any, **options: Any) None[source]

Try to run the command

Parameters:
  • *args (Any) – The supplied arguments

  • **options (Any) – The supplied keyword options

Return type:

None

help: str = 'Send pending push notifications'[source]
output_transaction = False[source]
print_help(prog_name, subcommand)[source]

Print the help message for this command, derived from self.usage().

requires_migrations_checks = False[source]
requires_system_checks = '__all__'[source]
run_from_argv(argv)[source]

Set up any environment changes requested (e.g., Python path and Django settings), then run this command. If the command raises a CommandError, intercept it and print it sensibly to stderr. If the --traceback option is present or the raised Exception is not CommandError, raise it.

send_push_notification(counter: int, total: int, push_notification: PushNotification) None[source]

Sends a push notification

Parameters:
  • counter (int) – The current counter

  • total (int) – How many push notifications are scheduled for this slot

  • push_notification (PushNotification) – The push notification object

Return type:

None

set_logging_stream() None[source]

Set the output stream to the command’s stdout/stderr wrapper. Has to be called as part of the command’s handle() function.

Return type:

None

stealth_options = ()[source]
suppressed_base_arguments = {}[source]

SUMM.AI Bulk

class integreat_cms.core.management.commands.summ_ai_bulk.Command(stdout=None, stderr=None, no_color=False, force_color=False)[source]

Bases: LogCommand

Management command to create an initial translation for Easy German via SUMM.AI

__init__(stdout=None, stderr=None, no_color=False, force_color=False)[source]
add_arguments(parser: CommandParser) None[source]

Define the arguments of this command

Parameters:

parser (CommandParser) – The argument parser

Return type:

None

add_base_argument(parser, *args, **kwargs)[source]

Call the parser’s add_argument() method, suppressing the help text according to BaseCommand.suppressed_base_arguments.

base_stealth_options = ('stderr', 'stdout')[source]
check(app_configs=None, tags=None, display_num_errors=False, include_deployment_checks=False, fail_level=40, databases=None)[source]

Use the system check framework to validate entire Django project. Raise CommandError for any serious message (error or critical errors). If there are only light messages (like warnings), print them to stderr and don’t raise an exception.

check_migrations()[source]

Print a warning if the set of migrations on disk don’t match the migrations in the database.

create_parser(prog_name, subcommand, **kwargs)[source]

Create and return the ArgumentParser which will be used to parse the arguments to this command.

execute(*args, **options)[source]

Try to execute this command, performing system checks if needed (as controlled by the requires_system_checks attribute, except if force-skipped).

get_version()[source]

Return the Django version, which should be correct for all built-in Django commands. User-supplied commands can override this method to return their own version.

handle(*args: Any, region_slug: str, username: str, initial: bool, **options: Any) None[source]

Try to run the command

Parameters:
  • *args (Any) – The supplied arguments

  • region_slug (str) – The slug of the given region

  • username (str) – The username of the creator

  • initial (bool) – Whether existing translations should not be updated

  • **options (Any) – The supplied keyword options

Return type:

None

help: str = 'Creates an initial translation for Easy German via SUMM.AI'[source]
output_transaction = False[source]
print_help(prog_name, subcommand)[source]

Print the help message for this command, derived from self.usage().

requires_migrations_checks = False[source]
requires_system_checks = '__all__'[source]
run_from_argv(argv)[source]

Set up any environment changes requested (e.g., Python path and Django settings), then run this command. If the command raises a CommandError, intercept it and print it sensibly to stderr. If the --traceback option is present or the raised Exception is not CommandError, raise it.

set_logging_stream() None[source]

Set the output stream to the command’s stdout/stderr wrapper. Has to be called as part of the command’s handle() function.

Return type:

None

stealth_options = ()[source]
suppressed_base_arguments = {}[source]
integreat_cms.core.management.commands.summ_ai_bulk.summ_ai_bulk(region: Region, username: str, initial: bool = True) None[source]

Translate a complete region into Easy German

Parameters:
  • region (Region) – The current region

  • username (str) – The username of the creator of the translation objects

  • initial (bool) – Whether existing translations should not be updated

Return type:

None