cdist/oo.py
Steven Armstrong f262cc4ccf ++example usage
Signed-off-by: Steven Armstrong <steven@icarus.ethz.ch>
2011-10-06 01:04:09 +02:00

365 lines
9.9 KiB
Python

import os
import tempfile
# FIXME: change these to match your environment
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):
@staticmethod
def base_dir():
"""Return the absolute path to the top level directory where objects
are defined.
Requires the environment variable '__cdist_out_dir' to be set.
"""
base_dir = os.path.join(
os.environ['__cdist_out_dir'],
'object'
)
# FIXME: should directory be created elsewhere?
if not os.path.isdir(base_dir):
os.mkdir(base_dir)
return base_dir
@classmethod
def list_objects(cls):
"""Return a list of object instances"""
for object_name in cls.list_object_names():
type_name = object_name.split(os.sep)[0]
object_id = os.sep.join(object_name.split(os.sep)[1:])
yield cls(Type(type_name), object_id=object_id)
@classmethod
def list_type_names(cls):
"""Return a list of type names"""
return os.listdir(cls.base_dir())
@classmethod
def list_object_names(cls):
"""Return a list of object names"""
for path, dirs, files in os.walk(cls.base_dir()):
# FIXME: use constant instead of string
if '.cdist' in dirs:
yield os.path.relpath(path, cls.base_dir())
def __init__(self, type, object_id=None, parameter=None, requirements=None):
self.type = type # instance of Type
self.object_id = object_id
self.qualified_name = os.path.join(self.type.name, self.object_id)
self.parameter = parameter or {}
self.requirements = requirements or []
def __repr__(self):
return '<Object %s>' % self.qualified_name
@property
def path(self):
return os.path.join(
self.base_dir(),
self.qualified_name,
'.cdist'
)
@property
def changed(self):
"""Check whether the object has been changed."""
return os.path.isfile(os.path.join(self.path, "changed"))
@changed.setter
def changed(self, value):
"""Change the objects changed status."""
path = os.path.join(self.path, "changed")
if value:
open(path, "w").close()
else:
try:
os.remove(path)
except EnvironmentError:
# ignore
pass
# FIXME: implement other properties/methods