forked from ungleich-public/cdist
move Object class into its own file
Signed-off-by: Steven Armstrong <steven@icarus.ethz.ch>
This commit is contained in:
Steven Armstrong
parent
a4abb53ced
commit
cdba503ff2
1 changed files with 37 additions and 288 deletions
|
|
@ -1,292 +1,37 @@
|
||||||
|
# -*- coding: utf-8 -*-
|
||||||
|
#
|
||||||
|
# 2010-2011 Steven Armstrong (steven-cdist at armstrong.cc)
|
||||||
|
#
|
||||||
|
# This file is part of cdist.
|
||||||
|
#
|
||||||
|
# cdist is free software: you can redistribute it and/or modify
|
||||||
|
# it under the terms of the GNU General Public License as published by
|
||||||
|
# the Free Software Foundation, either version 3 of the License, or
|
||||||
|
# (at your option) any later version.
|
||||||
|
#
|
||||||
|
# cdist is distributed in the hope that it will be useful,
|
||||||
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
# GNU General Public License for more details.
|
||||||
|
#
|
||||||
|
# You should have received a copy of the GNU General Public License
|
||||||
|
# along with cdist. If not, see <http://www.gnu.org/licenses/>.
|
||||||
|
#
|
||||||
|
#
|
||||||
|
|
||||||
import os
|
import os
|
||||||
import tempfile
|
|
||||||
|
|
||||||
# FIXME: change these to match your environment
|
import cdist
|
||||||
os.environ['__cdist_base_dir'] = '/home/sar/vcs/cdist'
|
|
||||||
# FIXME: testing against the cache, change path
|
|
||||||
os.environ['__cdist_out_dir'] = '/home/sar/vcs/cdist/cache/sans-asteven-02.ethz.ch/out'
|
|
||||||
|
|
||||||
|
|
||||||
'''
|
|
||||||
cd /path/to/dir/with/this/file
|
|
||||||
ipython
|
|
||||||
|
|
||||||
|
|
||||||
In [1]: import oo
|
|
||||||
|
|
||||||
In [2]: t = oo.Type('__mkfs')
|
|
||||||
|
|
||||||
In [3]: t.
|
|
||||||
t.base_dir t.is_install t.list_type_names t.name t.path
|
|
||||||
t.explorers t.is_singleton t.list_types t.optional_parameters t.required_parameters
|
|
||||||
|
|
||||||
In [3]: t.path
|
|
||||||
Out[3]: '/home/sar/vcs/cdist/conf/type/__mkfs'
|
|
||||||
|
|
||||||
In [4]: t.required_parameters
|
|
||||||
Out[4]: ['type']
|
|
||||||
|
|
||||||
In [5]: t.optional_parameters
|
|
||||||
Out[5]: ['device', 'options', 'blocks']
|
|
||||||
|
|
||||||
In [6]: t.is
|
|
||||||
t.is_install t.is_singleton
|
|
||||||
|
|
||||||
In [6]: t.is_singleton
|
|
||||||
Out[6]: False
|
|
||||||
|
|
||||||
In [7]: o = oo.Object(t, 'dev/sda1')
|
|
||||||
|
|
||||||
In [8]: o.
|
|
||||||
o.base_dir o.list_object_names o.list_type_names o.parameter o.qualified_name o.type
|
|
||||||
o.changed o.list_objects o.object_id o.path o.requirements
|
|
||||||
|
|
||||||
In [8]: o.pa
|
|
||||||
o.parameter o.path
|
|
||||||
|
|
||||||
In [8]: o.path
|
|
||||||
Out[8]: '/home/sar/vcs/cdist/cache/sans-asteven-02.ethz.ch/out/object/__mkfs/dev/sda1/.cdist'
|
|
||||||
|
|
||||||
In [9]: o.changed
|
|
||||||
Out[9]: False
|
|
||||||
|
|
||||||
In [10]: o.changed = True
|
|
||||||
|
|
||||||
In [11]: # creates /home/sar/vcs/cdist/cache/sans-asteven-02.ethz.ch/out/object/__mkfs/dev/sda1/.cdist/changed
|
|
||||||
|
|
||||||
In [12]: o.changed
|
|
||||||
Out[12]: True
|
|
||||||
|
|
||||||
In [13]: o.changed = False
|
|
||||||
|
|
||||||
In [14]: # removes /home/sar/vcs/cdist/cache/sans-asteven-02.ethz.ch/out/object/__mkfs/dev/sda1/.cdist/changed
|
|
||||||
|
|
||||||
In [15]:
|
|
||||||
|
|
||||||
|
|
||||||
-----
|
|
||||||
|
|
||||||
In [1]: import oo
|
|
||||||
|
|
||||||
In [2]: oo.Type.
|
|
||||||
oo.Type.base_dir oo.Type.is_install oo.Type.list_type_names oo.Type.mro oo.Type.path
|
|
||||||
oo.Type.explorers oo.Type.is_singleton oo.Type.list_types oo.Type.optional_parameters oo.Type.required_parameters
|
|
||||||
|
|
||||||
In [2]: oo.Type.list
|
|
||||||
oo.Type.list_type_names oo.Type.list_types
|
|
||||||
|
|
||||||
In [2]: oo.Type.list_type_names()
|
|
||||||
Out[2]:
|
|
||||||
['__addifnosuchline',
|
|
||||||
'__apt_ppa',
|
|
||||||
'__apt_update_index',
|
|
||||||
'__autofs_map',
|
|
||||||
'__autofs_master',
|
|
||||||
'__debconf_set_selections',
|
|
||||||
'__directory',
|
|
||||||
'__file',
|
|
||||||
'__group',
|
|
||||||
'__issue',
|
|
||||||
'__key_value',
|
|
||||||
'__link',
|
|
||||||
'__mkfs',
|
|
||||||
'__motd',
|
|
||||||
'__package',
|
|
||||||
'__package_apt',
|
|
||||||
'__package_pacman',
|
|
||||||
'__package_pkg_openbsd',
|
|
||||||
'__package_rubygem',
|
|
||||||
'__package_yum',
|
|
||||||
'__partition_msdos',
|
|
||||||
'__partition_msdos_apply',
|
|
||||||
'__postgres_database',
|
|
||||||
'__postgres_role',
|
|
||||||
'__process',
|
|
||||||
'__removeline',
|
|
||||||
'__ssh_authorized_key',
|
|
||||||
'__timezone',
|
|
||||||
'__user']
|
|
||||||
|
|
||||||
In [3]: list(oo.Type.list_types())
|
|
||||||
Out[3]:
|
|
||||||
[<Type name=__addifnosuchline>,
|
|
||||||
<Type name=__apt_ppa>,
|
|
||||||
<Type name=__apt_update_index>,
|
|
||||||
<Type name=__autofs_map>,
|
|
||||||
<Type name=__autofs_master>,
|
|
||||||
<Type name=__debconf_set_selections>,
|
|
||||||
<Type name=__directory>,
|
|
||||||
<Type name=__file>,
|
|
||||||
<Type name=__group>,
|
|
||||||
<Type name=__issue>,
|
|
||||||
<Type name=__key_value>,
|
|
||||||
<Type name=__link>,
|
|
||||||
<Type name=__mkfs>,
|
|
||||||
<Type name=__motd>,
|
|
||||||
<Type name=__package>,
|
|
||||||
<Type name=__package_apt>,
|
|
||||||
<Type name=__package_pacman>,
|
|
||||||
<Type name=__package_pkg_openbsd>,
|
|
||||||
<Type name=__package_rubygem>,
|
|
||||||
<Type name=__package_yum>,
|
|
||||||
<Type name=__partition_msdos>,
|
|
||||||
<Type name=__partition_msdos_apply>,
|
|
||||||
<Type name=__postgres_database>,
|
|
||||||
<Type name=__postgres_role>,
|
|
||||||
<Type name=__process>,
|
|
||||||
<Type name=__removeline>,
|
|
||||||
<Type name=__ssh_authorized_key>,
|
|
||||||
<Type name=__timezone>,
|
|
||||||
<Type name=__user>]
|
|
||||||
|
|
||||||
In [4]:
|
|
||||||
|
|
||||||
In [4]: oo.Object.
|
|
||||||
oo.Object.base_dir oo.Object.changed oo.Object.list_object_names oo.Object.list_objects oo.Object.list_type_names oo.Object.mro oo.Object.path
|
|
||||||
|
|
||||||
In [4]: oo.Object.list
|
|
||||||
oo.Object.list_object_names oo.Object.list_objects oo.Object.list_type_names
|
|
||||||
|
|
||||||
In [4]: oo.Object.list_ob
|
|
||||||
oo.Object.list_object_names oo.Object.list_objects
|
|
||||||
|
|
||||||
In [4]: oo.Object.list_object_names()
|
|
||||||
Out[4]: <generator object list_object_names at 0x1b759b0>
|
|
||||||
|
|
||||||
In [5]: list(oo.Object.list_object_names())
|
|
||||||
Out[5]:
|
|
||||||
['__mkfs/dev/sda1',
|
|
||||||
'__mkfs/dev/sda2',
|
|
||||||
'__mkfs/dev/sda5',
|
|
||||||
'__mkfs/dev/sda6',
|
|
||||||
'__mkfs/dev/sda7',
|
|
||||||
'__partition_msdos/dev/sda1',
|
|
||||||
'__partition_msdos/dev/sda2',
|
|
||||||
'__partition_msdos/dev/sda3',
|
|
||||||
'__partition_msdos/dev/sda5',
|
|
||||||
'__partition_msdos/dev/sda6',
|
|
||||||
'__partition_msdos/dev/sda7',
|
|
||||||
'__partition_msdos_apply/singleton']
|
|
||||||
|
|
||||||
In [6]: list(oo.Object.list_objects())
|
|
||||||
Out[6]:
|
|
||||||
[<Object __mkfs/dev/sda1>,
|
|
||||||
<Object __mkfs/dev/sda2>,
|
|
||||||
<Object __mkfs/dev/sda5>,
|
|
||||||
<Object __mkfs/dev/sda6>,
|
|
||||||
<Object __mkfs/dev/sda7>,
|
|
||||||
<Object __partition_msdos/dev/sda1>,
|
|
||||||
<Object __partition_msdos/dev/sda2>,
|
|
||||||
<Object __partition_msdos/dev/sda3>,
|
|
||||||
<Object __partition_msdos/dev/sda5>,
|
|
||||||
<Object __partition_msdos/dev/sda6>,
|
|
||||||
<Object __partition_msdos/dev/sda7>,
|
|
||||||
<Object __partition_msdos_apply/singleton>]
|
|
||||||
|
|
||||||
In [7]:
|
|
||||||
|
|
||||||
|
|
||||||
'''
|
|
||||||
|
|
||||||
class Type(object):
|
|
||||||
|
|
||||||
@staticmethod
|
|
||||||
def base_dir():
|
|
||||||
"""Return the absolute path to the top level directory where types
|
|
||||||
are defined.
|
|
||||||
|
|
||||||
Requires the environment variable '__cdist_base_dir' to be set.
|
|
||||||
|
|
||||||
"""
|
|
||||||
return os.path.join(
|
|
||||||
os.environ['__cdist_base_dir'],
|
|
||||||
'conf',
|
|
||||||
'type'
|
|
||||||
)
|
|
||||||
|
|
||||||
@classmethod
|
|
||||||
def list_types(cls):
|
|
||||||
"""Return a list of type instances"""
|
|
||||||
for type_name in cls.list_type_names():
|
|
||||||
yield cls(type_name)
|
|
||||||
|
|
||||||
@classmethod
|
|
||||||
def list_type_names(cls):
|
|
||||||
"""Return a list of type names"""
|
|
||||||
return os.listdir(cls.base_dir())
|
|
||||||
|
|
||||||
|
|
||||||
def __init__(self, name):
|
|
||||||
self.name = name
|
|
||||||
self.__explorers = None
|
|
||||||
self.__required_parameters = None
|
|
||||||
self.__optional_parameters = None
|
|
||||||
|
|
||||||
def __repr__(self):
|
|
||||||
return '<Type name=%s>' % self.name
|
|
||||||
|
|
||||||
@property
|
|
||||||
def path(self):
|
|
||||||
return os.path.join(
|
|
||||||
self.base_dir(),
|
|
||||||
self.name
|
|
||||||
)
|
|
||||||
|
|
||||||
@property
|
|
||||||
def is_singleton(self):
|
|
||||||
"""Check whether a type is a singleton."""
|
|
||||||
return os.path.isfile(os.path.join(self.path, "singleton"))
|
|
||||||
|
|
||||||
@property
|
|
||||||
def is_install(self):
|
|
||||||
"""Check whether a type is used for installation (if not: for configuration)"""
|
|
||||||
return os.path.isfile(os.path.join(self.path, "install"))
|
|
||||||
|
|
||||||
@property
|
|
||||||
def explorers(self):
|
|
||||||
"""Return a list of available explorers"""
|
|
||||||
if not self.__explorers:
|
|
||||||
try:
|
|
||||||
self.__explorers = os.listdir(os.path.join(self.path, "explorer"))
|
|
||||||
except EnvironmentError as e:
|
|
||||||
# error ignored
|
|
||||||
self.__explorers = []
|
|
||||||
return self.__explorers
|
|
||||||
|
|
||||||
@property
|
|
||||||
def required_parameters(self):
|
|
||||||
"""Return a list of required parameters"""
|
|
||||||
if not self.__required_parameters:
|
|
||||||
parameters = []
|
|
||||||
try:
|
|
||||||
with open(os.path.join(self.path, "parameter", "required")) as fd:
|
|
||||||
for line in fd:
|
|
||||||
parameters.append(line.strip())
|
|
||||||
except EnvironmentError as e:
|
|
||||||
# error ignored
|
|
||||||
pass
|
|
||||||
finally:
|
|
||||||
self.__required_parameters = parameters
|
|
||||||
return self.__required_parameters
|
|
||||||
|
|
||||||
@property
|
|
||||||
def optional_parameters(self):
|
|
||||||
"""Return a list of optional parameters"""
|
|
||||||
if not self.__optional_parameters:
|
|
||||||
parameters = []
|
|
||||||
try:
|
|
||||||
with open(os.path.join(self.path, "parameter", "optional")) as fd:
|
|
||||||
for line in fd:
|
|
||||||
parameters.append(line.strip())
|
|
||||||
except EnvironmentError as e:
|
|
||||||
# error ignored
|
|
||||||
pass
|
|
||||||
finally:
|
|
||||||
self.__optional_parameters = parameters
|
|
||||||
return self.__optional_parameters
|
|
||||||
|
|
||||||
|
|
||||||
class Object(object):
|
class Object(object):
|
||||||
|
"""Represents a cdist object.
|
||||||
|
|
||||||
|
All interaction with objects in cdist should be done through this class.
|
||||||
|
Directly accessing an object through the file system from python code is
|
||||||
|
a bug.
|
||||||
|
|
||||||
|
"""
|
||||||
|
|
||||||
@staticmethod
|
@staticmethod
|
||||||
def base_dir():
|
def base_dir():
|
||||||
|
|
@ -296,10 +41,14 @@ class Object(object):
|
||||||
Requires the environment variable '__cdist_out_dir' to be set.
|
Requires the environment variable '__cdist_out_dir' to be set.
|
||||||
|
|
||||||
"""
|
"""
|
||||||
base_dir = os.path.join(
|
try:
|
||||||
os.environ['__cdist_out_dir'],
|
base_dir = os.path.join(
|
||||||
'object'
|
os.environ['__cdist_out_dir'],
|
||||||
)
|
'object'
|
||||||
|
)
|
||||||
|
except KeyError as e:
|
||||||
|
raise cdist.MissingEnvironmentVariableError(e.args[0])
|
||||||
|
|
||||||
# FIXME: should directory be created elsewhere?
|
# FIXME: should directory be created elsewhere?
|
||||||
if not os.path.isdir(base_dir):
|
if not os.path.isdir(base_dir):
|
||||||
os.mkdir(base_dir)
|
os.mkdir(base_dir)
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue