Source code for qubesadmin.tags

# -*- encoding: utf8 -*-
# The Qubes OS Project,
# Copyright (C) 2017 Marek Marczykowski-Górecki
#                               <>
# This program 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 2 of the License, or
# (at your option) any later version.
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# GNU General Public License for more details.
# You should have received a copy of the GNU General Public License along
# with this program; if not, see <>.

'''VM tags interface'''

[docs] class Tags(object): '''Manager of the tags. Tags are simple: tag either can be present on qube or not. Tag is a simple string consisting of ASCII alphanumeric characters, plus `_` and `-`. ''' # pylint: disable=too-few-public-methods def __init__(self, vm): super().__init__() self.vm = vm
[docs] def remove(self, elem): '''Remove a tag''' self.vm.qubesd_call(, 'admin.vm.tag.Remove', elem)
[docs] def add(self, elem): '''Add a tag''' self.vm.qubesd_call(, 'admin.vm.tag.Set', elem)
[docs] def update(self, *others): '''Add tags from iterable(s)''' for other in others: for elem in other: self.add(elem)
[docs] def discard(self, elem): '''Remove a tag if present''' try: self.remove(elem) except KeyError: pass
def __iter__(self): qubesd_response = self.vm.qubesd_call(, 'admin.vm.tag.List') return iter(qubesd_response.decode('utf-8').splitlines()) def __contains__(self, elem): '''Does the VM have a tag''' response = self.vm.qubesd_call(, 'admin.vm.tag.Get', elem) return response == b'1'