univention.appcenter.actions package

univention.appcenter.actions.possible_network_error(func)[source]
class univention.appcenter.actions.StoreAppAction(option_strings, dest, nargs=None, const=None, default=None, type=None, choices=None, required=False, help=None, metavar=None)[source]

Bases: argparse.Action

cache_class

alias of univention.appcenter.app_cache.Apps

class univention.appcenter.actions.UniventionAppActionMeta(name, bases, attrs)[source]

Bases: type

class univention.appcenter.actions.UniventionAppAction[source]

Bases: object

parent_logger = <Logger univention.appcenter.actions (DEBUG)>
classmethod get_action_name()[source]
classmethod debug(msg, logger=None)[source]
classmethod log(msg, logger=None)[source]
classmethod warn(msg, logger=None)[source]
classmethod fatal(msg, logger=None)[source]
classmethod log_exception(exc, logger=None)[source]
setup_parser(parser)[source]
property percentage
classmethod call_safe(**kwargs)[source]
classmethod call(**kwargs)[source]
call_with_namespace(namespace)[source]
univention.appcenter.actions.get_action(action_name)[source]
univention.appcenter.actions.all_actions()[source]

Submodules

univention.appcenter.actions.configure module

class univention.appcenter.actions.configure.Configure[source]

Bases: univention.appcenter.actions.UniventionAppAction

Configures an application.

help = 'Configure an app'
setup_parser(parser)[source]
main(args)[source]
classmethod list_config(app)[source]
logger = <Logger univention.appcenter.actions.configure (DEBUG)>
progress = <Logger univention.appcenter.actions.configure.progress (DEBUG)>

univention.appcenter.actions.credentials module

class univention.appcenter.actions.credentials.CredentialsAction[source]

Bases: univention.appcenter.actions.UniventionAppAction

setup_parser(parser)[source]
check_user_credentials(args)[source]

univention.appcenter.actions.domain module

class univention.appcenter.actions.domain.Domain[source]

Bases: univention.appcenter.actions.credentials.CredentialsAction

Shows information about the domain and enabled management of app installations.

help = 'Domain management'
setup_parser(parser)[source]
main(args)[source]
get_appcenter_hosts(lo, pos)[source]
manage(login, pwdfile, logger, *args)[source]
classmethod to_dict(apps)[source]
logger = <Logger univention.appcenter.actions.domain (DEBUG)>
progress = <Logger univention.appcenter.actions.domain.progress (DEBUG)>

univention.appcenter.actions.get module

class univention.appcenter.actions.get.StoreKeysAction(option_strings, dest, nargs=None, const=None, default=None, type=None, choices=None, required=False, help=None, metavar=None)[source]

Bases: argparse.Action

class univention.appcenter.actions.get.Get[source]

Bases: univention.appcenter.actions.UniventionAppAction

Fetches meta information about the app.

help = 'Query an app'
setup_parser(parser)[source]
main(args)[source]
classmethod to_dict(app)[source]
classmethod raw_value(app, section, option)[source]
get_values(app, keys, warn=True)[source]
logger = <Logger univention.appcenter.actions.get (DEBUG)>
progress = <Logger univention.appcenter.actions.get.progress (DEBUG)>

univention.appcenter.actions.info module

class univention.appcenter.actions.info.Info[source]

Bases: univention.appcenter.actions.UniventionAppAction

Shows information on the current state of the App Center itself.

help = 'Show general info'
setup_parser(parser)[source]
main(args)[source]
classmethod get_ucs_version()[source]
classmethod is_compatible(other_version, function=None)[source]
classmethod get_compatibility()[source]

Returns the version number of the App Center. As App Center within a domain may talk to each other it is necessary to ask whether they are compatible. The version number will rise whenever a change was made that may break compatibility.

1: initial app center 12/12 (not assigned, appcenter/version was not supported) 2: app center with remote installation 02/13 (not assigned, appcenter/version was not supported) 3: app center with version and only_dry_run 03/13 4: app center with docker support and new App class 11/15 Starting with UCS 4.3 (03/18): The full UCS version

get_installed_apps()[source]
get_upgradable_apps()[source]
logger = <Logger univention.appcenter.actions.info (DEBUG)>
progress = <Logger univention.appcenter.actions.info.progress (DEBUG)>

univention.appcenter.actions.install module

exception univention.appcenter.actions.install.ControlScriptException[source]

Bases: Exception

class univention.appcenter.actions.install.Install[source]

Bases: univention.appcenter.actions.install_base.InstallRemoveUpgrade

Installs an application from the Univention App Center.

help = 'Install an app'
prescript_ext = 'preinst'
pre_readme = 'readme_install'
post_readme = 'readme_post_install'
setup_parser(parser)[source]
main(args)[source]
do_it_once(app, args)[source]
logger = <Logger univention.appcenter.actions.install (DEBUG)>
progress = <Logger univention.appcenter.actions.install.progress (DEBUG)>

univention.appcenter.actions.install_base module

class univention.appcenter.actions.install_base.StoreConfigAction(option_strings, dest, nargs=None, const=None, default=None, type=None, choices=None, required=False, help=None, metavar=None)[source]

Bases: argparse.Action

class univention.appcenter.actions.install_base.InstallRemoveUpgrade[source]

Bases: univention.appcenter.actions.register.Register

prescript_ext = None
pre_readme = None
post_readme = None
setup_parser(parser)[source]
main = None
do_it(args)[source]
do_it_once(app, args)[source]
needs_credentials(app)[source]
dry_run(app, args)[source]

univention.appcenter.actions.list_apps module

class univention.appcenter.actions.list_apps.List[source]

Bases: univention.appcenter.actions.UniventionAppAction

Lists all available apps; shows installed version.

help = 'List all apps'
setup_parser(parser)[source]
main(args)[source]
classmethod get_apps()[source]
logger = <Logger univention.appcenter.actions.list (DEBUG)>
progress = <Logger univention.appcenter.actions.list.progress (DEBUG)>

univention.appcenter.actions.register module

class univention.appcenter.actions.register.Register[source]

Bases: univention.appcenter.actions.credentials.CredentialsAction

Registers one or more applications. Done automatically via install, only useful if something went wrong / finer grained control is needed.

help = 'Registers an app'
setup_parser(parser)[source]
main(args)[source]
logger = <Logger univention.appcenter.actions.register (DEBUG)>
progress = <Logger univention.appcenter.actions.register.progress (DEBUG)>

univention.appcenter.actions.remove module

class univention.appcenter.actions.remove.Remove[source]

Bases: univention.appcenter.actions.install_base.InstallRemoveUpgrade

Removes an application from the Univention App Center.

help = 'Uninstall an app'
prescript_ext = 'prerm'
pre_readme = 'readme_uninstall'
post_readme = 'readme_post_uninstall'
main(args)[source]
needs_credentials(app)[source]
logger = <Logger univention.appcenter.actions.remove (DEBUG)>
progress = <Logger univention.appcenter.actions.remove.progress (DEBUG)>

univention.appcenter.actions.stall module

class univention.appcenter.actions.stall.Stall[source]

Bases: univention.appcenter.actions.UniventionAppAction

Disbales updates for this app. Useful for suppressing warnings when an app reached its end of life but shall still be used.

help = 'Stalls an app'
setup_parser(parser)[source]
main(args)[source]
logger = <Logger univention.appcenter.actions.stall (DEBUG)>
progress = <Logger univention.appcenter.actions.stall.progress (DEBUG)>

univention.appcenter.actions.update module

class univention.appcenter.actions.update.Update[source]

Bases: univention.appcenter.actions.UniventionAppAction

Updates the list of all available applications by asking the App Center server

help = 'Updates the list of apps'
setup_parser(parser)[source]
main(args)[source]
logger = <Logger univention.appcenter.actions.update (DEBUG)>
progress = <Logger univention.appcenter.actions.update.progress (DEBUG)>

univention.appcenter.actions.update_certificates module

class univention.appcenter.actions.update_certificates.UpdateCertificates[source]

Bases: univention.appcenter.actions.UniventionAppAction

Update certificates for an application.

help = 'Update certificates for an app'
setup_parser(parser)[source]
update_certificates(app)[source]
main(args)[source]
logger = <Logger univention.appcenter.actions.update-certificates (DEBUG)>
progress = <Logger univention.appcenter.actions.update-certificates.progress (DEBUG)>

univention.appcenter.actions.update_check module

class univention.appcenter.actions.update_check.CheckUcsVersion(option_strings, dest, nargs=None, const=None, default=None, type=None, choices=None, required=False, help=None, metavar=None)[source]

Bases: argparse.Action

class univention.appcenter.actions.update_check.UpdateCheck[source]

Bases: univention.appcenter.actions.UniventionAppAction

Check if update to next ucs minor version is possible with the locally installed apps

For docker apps check if is available in next UCS version. For package based apps check if there is an app version with the same component in the next UCS version

help = 'Check for all locally installed Apps if they are available in the next UCS version'
setup_parser(parser)[source]
classmethod app_can_update(app, next_version, next_apps)[source]

checks if update is possible for this app docker apps have to support the next version components must be available in the next version component id of package based app must be available in the next version

classmethod get_blocking_apps(ucs_version)[source]

checks if update is possible for this app

logger = <Logger univention.appcenter.actions.update-check (DEBUG)>
main(args)[source]
progress = <Logger univention.appcenter.actions.update-check.progress (DEBUG)>

univention.appcenter.actions.upgrade module

class univention.appcenter.actions.upgrade.Upgrade[source]

Bases: univention.appcenter.actions.install.Install

Upgrades an installed application from the Univention App Center.

help = 'Upgrade an app'
pre_readme = 'readme_update'
post_readme = 'readme_post_update'
setup_parser(parser)[source]
main(args)[source]
do_it_once(app, args)[source]
needs_credentials(app)[source]
classmethod iter_upgradable_apps()[source]
logger = <Logger univention.appcenter.actions.upgrade (DEBUG)>
progress = <Logger univention.appcenter.actions.upgrade.progress (DEBUG)>