add-management-command

name

add-management-command

description

Use when adding or fixing a batch Django management command under src/ranking/management/commands/ — wiring add_arguments, the CLIST command skeleton (AttrDict(options), getLogger, print_sql_decorator), the EventLog/failed_on_exception monitoring idiom, Resource.get() host filtering, or wiring a cron entry with a Healthchecks monitor in config/cron. Keywords: management command, BaseCommand, add_arguments, cron, Healthchecks monitor, run-manage.bash, EventLog, tqdm.

Add a CLIST management command (+ cron/Healthchecks monitor)

Management commands live in src/ranking/management/commands/ (16 existing). They back the cron schedule (config/cron) and the RQ workers. Always read 2–3 similar ones first — set_account_rank.py, set_country_fields.py, and anonymize_accounts.py are the cleanest references.

The CLIST skeleton (copy this)

#!/usr/bin/env python3

from logging import getLogger

from django.core.management.base import BaseCommand
from django.db.models import Q
from django.utils import timezone
from django_print_sql import print_sql_decorator
from tqdm import tqdm

from clist.models import Resource
from ranking.models import Account
from utils.attrdict  AttrDict


 ():
     = 

     ():
        ().__init__(*args, **kwargs)
        .logger = getLogger()

     ():
        parser.add_argument(, , metavar=, nargs=, =)
        parser.add_argument(, , =, =)
        parser.add_argument(, action=, =)


     ():
        .stdout.write((options))           
        args = AttrDict(options)

        resources = Resource.available_for_update_objects.()
         args.resources:
            resources = Resource.get(args.resources, queryset=resources)   
         args.limit:
            resources = resources[:args.limit]

         resource  tqdm(resources, total=(resources), desc=):
            ... work ...