REDROOM

Navigation

Breadcrumbs

Create

Preview: cloud.py Size: 3.22 KB

//lib/python3.6/site-packages/cloudinit/cloud.py

# Copyright (C) 2012 Canonical Ltd.
# Copyright (C) 2012 Hewlett-Packard Development Company, L.P.
# Copyright (C) 2012 Yahoo! Inc.
#
# This file is part of cloud-init. See LICENSE file for license information.

import copy
import logging
import os
from typing import Optional

from cloudinit.distros import Distro
from cloudinit.helpers import Paths, Runners
from cloudinit.reporting import events
from cloudinit.sources import DataSource

LOG = logging.getLogger(__name__)

# This class is the high level wrapper that provides
# access to cloud-init objects without exposing the stage objects
# to handler and or module manipulation. It allows for cloud
# init to restrict what those types of user facing code may see
# and or adjust (which helps avoid code messing with each other)
#
# It also provides util functions that avoid having to know
# how to get a certain member from this submembers as well
# as providing a backwards compatible object that can be maintained
# while the stages/other objects can be worked on independently...


class Cloud:
    def __init__(
        self,
        datasource: DataSource,
        paths: Paths,
        cfg: dict,
        distro: Distro,
        runners: Runners,
        reporter: Optional[events.ReportEventStack] = None,
    ):
        self.datasource = datasource
        self.paths = paths
        self.distro = distro
        self._cfg = cfg
        self._runners = runners
        if reporter is None:
            reporter = events.ReportEventStack(
                name="unnamed-cloud-reporter",
                description="unnamed-cloud-reporter",
                reporting_enabled=False,
            )
        self.reporter = reporter

    @property
    def cfg(self):
        # Ensure that cfg is not indirectly modified
        return copy.deepcopy(self._cfg)

    def run(self, name, functor, args, freq=None, clear_on_fail=False):
        return self._runners.run(name, functor, args, freq, clear_on_fail)

    def get_template_filename(self, name):
        fn = self.paths.template_tpl % (name)
        if not os.path.isfile(fn):
            LOG.warning(
                "No template found in %s for template named %s",
                os.path.dirname(fn),
                name,
            )
            return None
        return fn

    # The rest of these are just useful proxies
    def get_userdata(self, apply_filter=True):
        return self.datasource.get_userdata(apply_filter)

    def get_instance_id(self):
        return self.datasource.get_instance_id()

    @property
    def launch_index(self):
        return self.datasource.launch_index

    def get_public_ssh_keys(self):
        return self.datasource.get_public_ssh_keys()

    def get_locale(self):
        return self.datasource.get_locale()

    def get_hostname(self, fqdn=False, metadata_only=False):
        return self.datasource.get_hostname(
            fqdn=fqdn, metadata_only=metadata_only
        )

    def device_name_to_device(self, name):
        return self.datasource.device_name_to_device(name)

    def get_ipath_cur(self, name=None):
        return self.paths.get_ipath_cur(name)

    def get_cpath(self, name=None):
        return self.paths.get_cpath(name)

    def get_ipath(self, name=None):
        return self.paths.get_ipath(name)

Name	Size	Perms	Modified	Actions
analyze DIR	-	drwxr-xr-x	2026-01-24 23:01:14	Edit Download recursive recursive
cmd DIR	-	drwxr-xr-x	2026-01-24 23:01:14	Edit Download recursive recursive
config DIR	-	drwxr-xr-x	2026-01-24 23:01:14	Edit Download recursive recursive
distros DIR	-	drwxr-xr-x	2026-01-24 23:01:14	Edit Download recursive recursive
filters DIR	-	drwxr-xr-x	2026-01-24 23:01:14	Edit Download recursive recursive
handlers DIR	-	drwxr-xr-x	2026-01-24 23:01:14	Edit Download recursive recursive
mergers DIR	-	drwxr-xr-x	2026-01-24 23:01:14	Edit Download recursive recursive
net DIR	-	drwxr-xr-x	2026-01-24 23:01:14	Edit Download recursive recursive
reporting DIR	-	drwxr-xr-x	2026-01-24 23:01:14	Edit Download recursive recursive
sources DIR	-	drwxr-xr-x	2026-01-24 23:01:14	Edit Download recursive recursive
__pycache__ DIR	-	drwxr-xr-x	2026-01-24 23:01:14	Edit Download recursive recursive
apport.py	7.05 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
atomic_helper.py	2.45 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
cloud.py	3.22 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
dmi.py	6.77 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
event.py	2.00 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
features.py	3.38 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
gpg.py	4.28 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
helpers.py	16.41 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
importer.py	2.43 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
log.py	5.47 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
netinfo.py	22.97 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
persistence.py	2.52 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
registry.py	1022 B	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
safeyaml.py	10.28 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
settings.py	2.02 KB	lrw-r--r--	2026-01-23 08:56:46	Edit Download recursive recursive
signal_handler.py	1.74 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
simpletable.py	1.93 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
ssh_util.py	22.28 KB	lrw-r--r--	2026-01-23 08:56:47	Edit Download recursive recursive
stages.py	38.88 KB	lrw-r--r--	2026-01-23 08:56:46	Edit Download recursive recursive
subp.py	13.23 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
templater.py	5.95 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
temp_utils.py	3.15 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
type_utils.py	703 B	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
url_helper.py	27.32 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
user_data.py	14.43 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
util.py	96.43 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
version.py	566 B	lrw-r--r--	2026-01-23 08:56:50	Edit Download recursive recursive
warnings.py	3.76 KB	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive
__init__.py	0 B	lrw-r--r--	2023-12-04 11:47:40	Edit Download recursive recursive

Directory Contents