Django Model Field Contain Strange Attribute _("private")

Currently I have been learning Django and while reading, I have come across the below code block which I don't understand. private = models.BooleanField( _('private'),

Solution 1:

_('private') sets the attribute verbose_name.

The leading underscore is the commonly used function alias for the one of the ugettext functions used by the internationalization (i18n) mechanics.

It means that when you have i18n running, the labels will be translated into the appropriate end-user language, if a translation is available.

Check this answer: https://stackoverflow.com/a/2964256/9361129

Solution 2:

As you can see in the source code of Django, the constructor of a Field (which BooleanField inherits) takes verbose_name as first positional argument. So, your first argument (_('private')) will be affected to verbose_name.

However, to make your code clearer, I would recommend to pass it as a keyword argument:

private = models.BooleanField(
    verbose_name=_('private'),default=False,
    help_text=_('theme is available ONLY for the site.'),
)

Using keyword argument for verbose_name will make it clearer for you and people reading your code, especially since Django documentation does not give the order of positional arguments. Using positional argument forces readers to read Django source code to know what it is.

When you use keyword arguments, you can position your arguments as you like, so this code will work the same:

private = models.BooleanField(
    help_text=_('theme is available ONLY for the site.'),
    verbose_name=_('private'),default=False,
)