File: //usr/lib/python3/dist-packages/cloudinit/distros/raspberry_pi_os.py
# Copyright (C) 2024-2025 Raspberry Pi Ltd. All rights reserved.
#
# Author: Paul Oberosler <paul.oberosler@raspberrypi.com>
#
# This file is part of cloud-init. See LICENSE file for license information.
import logging
from cloudinit import subp
from cloudinit.distros import debian
LOG = logging.getLogger(__name__)
class Distro(debian.Distro):
def set_keymap(self, layout: str, model: str, variant: str, options: str):
"""Currently Raspberry Pi OS sys-mods only supports
setting the layout"""
subp.subp(
[
"/usr/lib/raspberrypi-sys-mods/imager_custom",
"set_keymap",
layout,
]
)
def apply_locale(self, locale, out_fn=None, keyname="LANG"):
try:
subp.subp(
[
"/usr/bin/raspi-config",
"nonint",
"do_change_locale",
f"{locale}",
]
)
except subp.ProcessExecutionError:
if not locale.endswith(".UTF-8"):
LOG.info("Trying to set locale %s.UTF-8", locale)
subp.subp(
[
"/usr/bin/raspi-config",
"nonint",
"do_change_locale",
f"{locale}.UTF-8",
]
)
else:
LOG.error("Failed to set locale %s")
def add_user(self, name, **kwargs) -> bool:
"""
Add a user to the system using standard GNU tools
This should be overridden on distros where useradd is not desirable or
not available.
Returns False if user already exists, otherwise True.
"""
result = super().add_user(name, **kwargs)
if not result:
return result
try:
subp.subp(
[
"/usr/bin/rename-user",
"-f",
"-s",
],
update_env={"SUDO_USER": name},
)
except subp.ProcessExecutionError as e:
LOG.error("Failed to setup user: %s", e)
return False
return True