pyqttoolkit 0.9.1__py3-none-any.whl

pyqttoolkit/__init__.py

@@ -0,0 +1,20 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# 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 3 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
+# 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 this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+
+from ._version import get_versions
+__version__ = get_versions()['version']
+del get_versions

pyqttoolkit/_version.py

@@ -0,0 +1,21 @@
+
+# This file was generated by 'versioneer.py' (0.18) from
+# revision-control system data, or from the parent directory name of an
+# unpacked source archive. Distribution tarballs contain a pre-generated copy
+# of this file.
+
+import json
+
+version_json = '''
+{
+ "date": "2026-10-20T09:25:30+0100",
+ "dirty": false,
+ "error": null,
+ "full-revisionid": "06c8bebf565d6ca91beb9a0fb7d8b171ebfd80fc",
+ "version": "0.9.1"
+}
+'''  # END VERSION_JSON
+
+
+def get_versions():
+    return json.loads(version_json)

pyqttoolkit/application/__init__.py

@@ -0,0 +1,18 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# 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 3 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
+# 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 this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from .application import Application
+from .garbage_collector import GarbageCollector

pyqttoolkit/application/application.py

@@ -0,0 +1,86 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# 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 3 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
+# 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 this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+import sys
+import logging
+
+from PyQt5.QtCore import pyqtSignal
+from PyQt5.QtWidgets import QApplication, QWidget
+
+from pyqttoolkit.services import MessageBoard, TaskRunner, ToolWindowService, EventRegistry, ObjectConverter
+from pyqttoolkit.dependencies import DependencyContainer
+from .garbage_collector import GarbageCollector
+
+LOGGER = logging.getLogger(__name__)
+
+class Application(QApplication):
+    def __init__(self, argv):
+        QApplication.__init__(self, argv)
+        self._dependency_container = DependencyContainer()
+        self._garbage_collector = GarbageCollector(self)
+
+        self._module_service = None
+        self._message_board = None
+        self._project_manager = None
+
+        self._handling_exception = False
+
+        sys.excepthook = self._handle_exception
+    
+    mainWindowLoaded = pyqtSignal(QWidget)
+
+    def run(self, filename=None):
+        LOGGER.info('Running Application')
+        self._register_default_services()
+        self._register_modules()
+
+        if filename:
+            self._project_manager.load_project(filename)
+        
+        self.mainWindowLoaded.emit(self._module_service.openModule('Base'))
+        return self.exec_()
+    
+    def _handle_exception(self, ex_type, ex_value, traceback_obj):
+        LOGGER.error('Application Exception: %s, %s', ex_type, ex_value)
+        if self._handling_exception:
+            return
+        self._handling_exception = True
+        self._perform_exception_handling(ex_type, ex_value, traceback_obj)
+        self._handling_exception = False
+    
+    def _perform_exception_handling(self, ex_type, ex_value, traceback_obj):
+        pass
+    
+    def _register_default_services(self):
+        self._dependency_container.register_instance('application', self)
+        self._dependency_container.register_instance('dependency_container', self._dependency_container)
+        self._dependency_container.register_instance('task_runner', TaskRunner(self))
+        self._dependency_container.register_instance('message_board', MessageBoard(self))
+        self._dependency_container.register_instance('tool_window_service', ToolWindowService(self._dependency_container))
+        self._dependency_container.register_instance('event_registry', EventRegistry())
+        self._dependency_container.register_instance('object_converter', ObjectConverter())
+        self._dependency_container.register_instance('garbage_collector', self._garbage_collector)
+
+    def _register_modules(self):
+        modules = self._get_modules()
+        for module_type in [v for k, v in modules.__dict__.items() if k.endswith('Module')]:
+            module = self._dependency_container.resolve(module_type)
+            module.register(dependency_container=self._dependency_container)
+
+        self._module_service = self._dependency_container.get_instance('module_service')
+
+        self._message_board = self._dependency_container.get_instance('message_board')
+        self._project_manager = self._dependency_container.get_instance('project_manager')

pyqttoolkit/application/garbage_collector.py

@@ -0,0 +1,65 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# 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 3 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
+# 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 this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+import gc
+import logging
+
+from PyQt5.QtCore import QObject, QTimer
+
+from pyqttoolkit.logs import TRACE
+
+LOGGER = logging.getLogger(__name__)
+
+class GarbageCollector(QObject):
+    '''
+    Disable automatic garbage collection and instead collect manually
+    every INTERVAL milliseconds.
+
+    This is done to ensure that garbage collection only happens in the GUI
+    thread, as otherwise Qt can crash.
+    '''
+
+    def __init__(self, parent, interval=60000):
+        super().__init__(parent)
+        self._interval = interval
+        self._threshold = gc.get_threshold()
+        gc.disable()
+
+        if self._interval:
+            self._timer = QTimer(self)
+            self._timer.timeout.connect(self.check)
+            self._timer.start(self._interval)
+        else:
+            self._timer = None
+
+    def check(self, full=False):
+        l0, l1, l2 = gc.get_count()
+        LOGGER.log(TRACE, 'gc_check called: l0=%d, l1=%d, l2=%d', l0, l1, l2)
+        if full or l0 > self._threshold[0]:
+            num = gc.collect(0)
+            LOGGER.log(TRACE, 'Collecting gen 0, found: %d unreachable', num)
+            if full or l1 > self._threshold[1]:
+                num = gc.collect(1)
+                LOGGER.log(TRACE, 'Collecting gen 1, found: %d unreachable', num)
+                if full or l2 > self._threshold[2]:
+                    num = gc.collect(2)
+                    LOGGER.log(TRACE, 'Collecting gen 2, found: %d unreachable', num)
+
+    def debug_cycles(self):
+        gc.set_debug(gc.DEBUG_SAVEALL)
+        gc.collect()
+        for obj in gc.garbage:
+            LOGGER.log(TRACE, "gc: obj=%s, (%s), type=%s", obj, repr(obj), type(obj))

pyqttoolkit/colors/__init__.py

@@ -0,0 +1,84 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# 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 3 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
+# 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 this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from enum import Enum
+
+from itertools import chain
+from math import ceil
+
+def hex_to_rgb(hex_value):
+    hex_value = hex_value.lstrip('#')
+    return tuple(int(hex_value[i:i+2], 16) / 255 for i in [0, 2, 4])
+
+def rgb_to_hex(rgb_value):
+    return '#' + ''.join('{:02x}'.format(int(v * 255)) for v in rgb_value)
+
+def interpolate_rgb(a, b, n):
+    if n <= 0:
+        return [a, b]
+    step = tuple((b_val - a_val) / (n + 1) for a_val, b_val in zip(a, b))
+    return [tuple(a_val + step_val * i for a_val, step_val in zip(a, step)) for i in range(1, n+1)]
+
+def expand_rgb(colors, n):
+    extras_per_gap = int(ceil((n - len(colors)) / (len(colors) - 1)))
+    if extras_per_gap <= 0:
+        return list(colors)
+    result = [*chain(
+        *([a, *interpolate_rgb(a, b, extras_per_gap)] for a, b in zip(colors, colors[1:]))
+    ), colors[-1]]
+    return result
+
+class ColorFormat(Enum):
+    rgba_string_256 = 0
+    rgb_string_256 = 1
+    hex_string = 2
+    hexa_string = 3
+
+def format_color(color, color_format=ColorFormat.rgba_string_256, opacity=None, lighten=None):
+    if len(color) == 4:
+        r, g, b, a = color
+    elif len(color) == 3:
+        r, g, b = color
+        a = 255
+    else:
+        raise ValueError(f'Invalid value for color: {color}')
+    a = a if opacity is None else opacity
+
+    if lighten is not None:
+        r, g, b = redistribute_rgb(lighten * (r or 100), lighten * (g or 100), lighten * (b or 100))
+
+    if color_format == ColorFormat.rgba_string_256:
+        return f'rgba({r},{g},{b},{a})'
+    if color_format == ColorFormat.rgb_string_256:
+        return f'rgb({r},{g},{b})'
+    if color_format == ColorFormat.hex_string:
+        return '#{:02x}{:02x}{:02x}'.format(*(int(c * 255) for c in (r, g, b)))
+    if color_format == ColorFormat.hexa_string:
+        return '#{:02x}{:02x}{:02x}{:02x}'.format(*(int(c * 255) for c in (a, r, g, b)))
+    
+    raise ValueError(f'Invalid format: {color_format}')
+
+def redistribute_rgb(r, g, b):
+    threshold = 255.999
+    m = max(r, g, b)
+    if m <= threshold:
+        return int(r), int(g), int(b)
+    total = r + g + b
+    if total >= 3 * threshold:
+        return int(threshold), int(threshold), int(threshold)
+    x = (3 * threshold - total) / (3 * m - total)
+    gray = threshold - x * m
+    return int(gray + x * r), int(gray + x * g), int(gray + x * b)

pyqttoolkit/config/__init__.py

@@ -0,0 +1,20 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# 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 3 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
+# 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 this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from .default import DefaultApplicationConfiguration
+from .multi_json_file import MultiJsonFileApplicationConfiguration
+from .composite import CompositeApplicationConfiguration
+from .environment import EnvironmentApplicationConfiguration

pyqttoolkit/config/base.py

@@ -0,0 +1,22 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# 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 3 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
+# 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 this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+class BaseApplicationConfiguration:
+    def get_value(self, key):
+        raise NotImplementedError()
+    
+    def set_value(self, key, value):
+        raise NotImplementedError()

pyqttoolkit/config/composite.py

@@ -0,0 +1,31 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# 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 3 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
+# 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 this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from .base import BaseApplicationConfiguration
+
+class CompositeApplicationConfiguration(BaseApplicationConfiguration):
+    def __init__(self, *inners):
+        self._inners = inners
+    
+    def get_value(self, key):
+        for inner in self._inners:
+            value = inner.get_value(key)
+            if value is not None:
+                return value
+        return None
+    
+    def set_value(self, key, value):
+        self._inners[0].set_value(key, value)

pyqttoolkit/config/default.py

@@ -0,0 +1,27 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# 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 3 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
+# 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 this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from .base import BaseApplicationConfiguration
+
+class DefaultApplicationConfiguration(BaseApplicationConfiguration):
+    def __init__(self, config):
+        self._configuration = config
+    
+    def get_value(self, key):
+        return self._configuration.get(key)
+
+    def set_value(self, key, value):
+        self._configuration[key] = value

pyqttoolkit/config/environment.py

@@ -0,0 +1,35 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# 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 3 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
+# 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 this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+import os
+import json
+from .base import BaseApplicationConfiguration
+
+class EnvironmentApplicationConfiguration(BaseApplicationConfiguration):    
+    def get_value(self, key):
+        value = os.getenv(self._format_key(key))
+        if value is None:
+            return value
+        try:
+            return json.loads(value)
+        except json.decoder.JSONDecodeError:
+            return value
+
+    def set_value(self, key, value):
+        os.environ[self._format_key(key)] = str(value)
+    
+    def _format_key(self, key):
+        return key.replace('.', '_').upper()

pyqttoolkit/config/multi_json_file.py

@@ -0,0 +1,93 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# 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 3 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
+# 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 this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from os import path, makedirs
+from json import load, dump, JSONDecodeError
+import logging
+import shutil
+
+from .base import BaseApplicationConfiguration
+
+LOGGER = logging.getLogger(__name__)
+
+class MultiJsonFileApplicationConfiguration(BaseApplicationConfiguration):
+    def __init__(self, directory):
+        self._directory = directory
+
+    def get_value(self, key):
+        parts = key.split('.')
+        if len(parts) < 2:
+            raise ValueError('key')
+
+        filename = path.join(self._directory, f'{parts[0]}.json')
+        value_path = parts[1:]
+
+        if not path.exists(filename):
+            return None
+
+        try:
+            with open(filename) as fp:
+                values = load(fp)
+        except JSONDecodeError as err:
+            LOGGER.warning('Invalid json file, exception: %s', err)
+            self._backup_file(filename)
+            return None
+        
+        result = values
+        for p in value_path:
+            result = result.get(p, {})
+        
+        if result == {}:
+            return None
+
+        return result
+
+    def _backup_file(self, filename):
+        backup_path_root = path.join(path.dirname(filename), f'{path.basename(filename)}.json.bak')
+        attempt = 0
+        backup_path = backup_path_root
+        while path.isfile(backup_path):
+            attempt += 1
+            backup_path = backup_path_root + f'.{attempt}'
+        LOGGER.warning('Backing up config file %s to %s', filename, backup_path)
+        shutil.move(filename, backup_path)
+
+    def set_value(self, key, value):
+        parts = key.split('.')
+        if len(parts) < 2:
+            raise ValueError('key')
+        
+        filename = path.join(self._directory, f'{parts[0]}.json')
+        if path.exists(filename):
+            try:
+                with open(filename) as fp:
+                    current_config = load(fp)
+            except JSONDecodeError as err:
+                LOGGER.warning('Invalid json file, exception: %s', err)
+                current_config = {}
+        else:
+            current_config = {}
+        
+        parent = current_config
+        for p in parts[1:-1]:
+            parent = current_config.setdefault(p, {})
+        parent[parts[-1]] = value
+
+        if not path.isdir(path.dirname(filename)):
+            makedirs(path.dirname(filename))
+
+        with open(filename, 'w') as fp:
+            dump(current_config, fp, indent=4, sort_keys=True)

pyqttoolkit/config/with_signal.py

@@ -0,0 +1,30 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# 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 3 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
+# 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 this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from PyQt5.QtCore import pyqtSignal, QObject
+
+class WithValueChangedConfiguration(QObject):
+    def __init__(self, inner):
+        self._inner = inner
+    
+    onValueChanged = pyqtSignal(str, object)
+    
+    def get_value(self, key):
+        return self._inner.get_value(key)
+
+    def set_value(self, key, value):
+        self._inner.set_value(key, value)
+        self.onValueChanged(key, value)

pyqttoolkit/config/with_value_changed.py

@@ -0,0 +1,31 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# 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 3 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
+# 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 this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from PyQt5.QtCore import pyqtSignal, QObject
+
+class WithValueChangedConfiguration(QObject):
+    def __init__(self, parent, inner):
+        super().__init__(parent)
+        self._inner = inner
+    
+    onValueChanged = pyqtSignal(str, object)
+    
+    def get_value(self, key):
+        return self._inner.get_value(key)
+
+    def set_value(self, key, value):
+        self._inner.set_value(key, value)
+        self.onValueChanged.emit(key, value)

pyqttoolkit/data/__init__.py

@@ -0,0 +1,21 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# 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 3 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
+# 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 this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+from .cache import Cache
+from .interval import calculate_interval
+from .bits import get_next_available_bit
+from .names import get_next_available_name
+from .message import MessageType, MessageResponse

pyqttoolkit/data/bits.py

@@ -0,0 +1,23 @@
+# pyqttoolkit
+# Copyright (C) 2018-2019, Simmovation Ltd.
+#
+# 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 3 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
+# 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 this program; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+def get_next_available_bit(bits):
+    bit = 1
+    for _ in range(63):
+        if not bit in bits:
+            return bit
+        bit <<= 1
+    return 0