python3-cyberfusion-queue-support 1.2__tar.gz → 1.4__tar.gz

python3_cyberfusion_queue_support-1.4/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.1
+Name: python3-cyberfusion-queue-support
+Version: 1.4
+Summary: Library to queue actions.
+Author-email: Cyberfusion <support@cyberfusion.io>
+Project-URL: Source, https://github.com/CyberfusionIO/python3-cyberfusion-queue-support
+Description-Content-Type: text/markdown
+Requires-Dist: python3-cyberfusion-systemd-support~=2.1
+
+# python3-cyberfusion-queue-support
+
+Library to queue actions.
+
+`QueueSupport` allows you to _queue_ certain actions, such as restarting a service, unlinking a file, and much more.
+
+For example, suppose the file `/tmp/example.txt` should be chmodded to 0600. You can queue the chmod:
+
+```
+>>> from cyberfusion.QueueSupport import Queue
+>>> from cyberfusion.QueueSupport.items.chmod import ChmodItem
+>>> queue = Queue()
+>>> queue.add(ChmodItem(path="/tmp/example.txt", mode=0o600))
+```
+
+... see what the chmod _would_ do with 'preview mode':
+
+```
+>>> queue.process(preview=False)
+[<cyberfusion.QueueSupport.outcomes.ChmodItemModeChangeOutcome object at 0x7f947e8ef510>]
+>>> print(queue.process(preview=True)[0])
+Change mode of /tmp/example.txt from 0o644 to 0o600
+```
+
+... then actually run the chmod:
+
+```
+>>> print(queue.process(preview=False)[0])
+Change mode of /tmp/example2.txt from 0o644 to 0o600
+```
+
+# Install
+
+## PyPI
+
+Run the following command to install the package from PyPI:
+
+    pip3 install python3-cyberfusion-queue-support
+
+## Debian
+
+Run the following commands to build a Debian package:
+
+    mk-build-deps -i -t 'apt -o Debug::pkgProblemResolver=yes --no-install-recommends -y'
+    dpkg-buildpackage -us -uc
+
+# Configure
+
+No configuration is supported.
+
+# Usage
+
+## Concepts
+
+All project-specific terms are in _italic_.
+
+After creating a _queue_, _items_ can be added to it.
+
+```python
+from cyberfusion.QueueSupport import Queue
+
+queue = Queue()
+
+item = ...
+
+queue.add(item)
+```
+
+_Items_ are of a certain type. Such as `ChmodItem` or `SystemdUnitRestartItem`. Items can have attributes, such as a path for an `MkdirItem`, or a unit name for `SystemdUnitEnableItem`.
+
+```python
+from cyberfusion.QueueSupport.items.chmod import ChmodItem
+from cyberfusion.QueueSupport.items.systemd_unit_enable import SystemdUnitEnableItem
+
+item1 = ChmodItem(path="/tmp/example.txt", mode=0o600)
+item2 = SystemdUnitEnableItem(name="httpd.service")
+```
+
+Each _item_ type has one or multiple _outcomes_. These should come true for an _item_ of that type to be completed. **For example: for an _item_ of type `UnlinkItem`, the _outcome_ is that the file at the path given with the _item_ is unlinked.**
+
+When a _queue_ is _processed_, all the _items_ added to it are _fulfilled_, meaning all the _items'_ _outcomes_ come true.
+
+```python
+from cyberfusion.QueueSupport import Queue
+
+from cyberfusion.QueueSupport.items.rmtree import RmTreeItem
+
+item = RmTreeItem(path="/tmp/dir")
+
+queue = Queue()
+
+queue.add(item)
+
+# Fulfill every item in the queue
+
+queue.process(preview=False)
+queue.process(preview=True)  # Only show what the outcomes would be
+
+# Fulfill a single item
+
+item.fulfill()
+```
+
+## Diagram
+
+```mermaid
+graph TD;
+
+  subgraph QueueSupport
+    Queue["Queue"]
+    Item["Add item"]
+    Process["Process (fulfill all items)"]
+  end
+
+  Queue --> Item
+
+  subgraph ItemTypes["Item types"]
+    ChmodItem["ChmodItem"]
+    SystemdUnitEnableItem["SystemdUnitEnableItem"]
+    SystemdUnitRestartItem["SystemdUnitRestartItem"]
+    MkdirItem["MkdirItem"]
+    UnlinkItem["UnlinkItem"]
+    RmTreeItem["RmTreeItem"]
+    Other["Others..."]
+  end
+
+  Item --> ItemTypes
+  ItemTypes --> Outcome["Outcome (item's goal)"]
+
+  Process --> Fulfill["Fulfill outcomes for each item"]
+
+  %% Example flows for item attributes and outcomes
+  ChmodItem -.->|path, mode| Outcome
+  SystemdUnitEnableItem -.->|unit name| Outcome
+  MkdirItem -.->|path| Outcome
+  UnlinkItem -.->|unlink file| Outcome
+  RmTreeItem -.->|remove directory| Outcome
+
+  Queue --> Process
+  Process --> Fulfill
+```
+
+## Example
+
+```python
+from cyberfusion.QueueSupport import Queue
+from cyberfusion.QueueSupport.items.chmod import ChmodItem
+
+queue = Queue()
+
+item = ChmodItem(path="/tmp/example.txt", mode=0o600)
+print(item.outcomes)
+
+queue.add(item)
+
+preview = True or False
+
+outcomes = queue.process(preview=preview)
+
+for outcome in outcomes:
+    print(str(outcome))
+```

python3_cyberfusion_queue_support-1.4/README.md

@@ -0,0 +1,162 @@
+# python3-cyberfusion-queue-support
+
+Library to queue actions.
+
+`QueueSupport` allows you to _queue_ certain actions, such as restarting a service, unlinking a file, and much more.
+
+For example, suppose the file `/tmp/example.txt` should be chmodded to 0600. You can queue the chmod:
+
+```
+>>> from cyberfusion.QueueSupport import Queue
+>>> from cyberfusion.QueueSupport.items.chmod import ChmodItem
+>>> queue = Queue()
+>>> queue.add(ChmodItem(path="/tmp/example.txt", mode=0o600))
+```
+
+... see what the chmod _would_ do with 'preview mode':
+
+```
+>>> queue.process(preview=False)
+[<cyberfusion.QueueSupport.outcomes.ChmodItemModeChangeOutcome object at 0x7f947e8ef510>]
+>>> print(queue.process(preview=True)[0])
+Change mode of /tmp/example.txt from 0o644 to 0o600
+```
+
+... then actually run the chmod:
+
+```
+>>> print(queue.process(preview=False)[0])
+Change mode of /tmp/example2.txt from 0o644 to 0o600
+```
+
+# Install
+
+## PyPI
+
+Run the following command to install the package from PyPI:
+
+    pip3 install python3-cyberfusion-queue-support
+
+## Debian
+
+Run the following commands to build a Debian package:
+
+    mk-build-deps -i -t 'apt -o Debug::pkgProblemResolver=yes --no-install-recommends -y'
+    dpkg-buildpackage -us -uc
+
+# Configure
+
+No configuration is supported.
+
+# Usage
+
+## Concepts
+
+All project-specific terms are in _italic_.
+
+After creating a _queue_, _items_ can be added to it.
+
+```python
+from cyberfusion.QueueSupport import Queue
+
+queue = Queue()
+
+item = ...
+
+queue.add(item)
+```
+
+_Items_ are of a certain type. Such as `ChmodItem` or `SystemdUnitRestartItem`. Items can have attributes, such as a path for an `MkdirItem`, or a unit name for `SystemdUnitEnableItem`.
+
+```python
+from cyberfusion.QueueSupport.items.chmod import ChmodItem
+from cyberfusion.QueueSupport.items.systemd_unit_enable import SystemdUnitEnableItem
+
+item1 = ChmodItem(path="/tmp/example.txt", mode=0o600)
+item2 = SystemdUnitEnableItem(name="httpd.service")
+```
+
+Each _item_ type has one or multiple _outcomes_. These should come true for an _item_ of that type to be completed. **For example: for an _item_ of type `UnlinkItem`, the _outcome_ is that the file at the path given with the _item_ is unlinked.**
+
+When a _queue_ is _processed_, all the _items_ added to it are _fulfilled_, meaning all the _items'_ _outcomes_ come true.
+
+```python
+from cyberfusion.QueueSupport import Queue
+
+from cyberfusion.QueueSupport.items.rmtree import RmTreeItem
+
+item = RmTreeItem(path="/tmp/dir")
+
+queue = Queue()
+
+queue.add(item)
+
+# Fulfill every item in the queue
+
+queue.process(preview=False)
+queue.process(preview=True)  # Only show what the outcomes would be
+
+# Fulfill a single item
+
+item.fulfill()
+```
+
+## Diagram
+
+```mermaid
+graph TD;
+
+  subgraph QueueSupport
+    Queue["Queue"]
+    Item["Add item"]
+    Process["Process (fulfill all items)"]
+  end
+
+  Queue --> Item
+
+  subgraph ItemTypes["Item types"]
+    ChmodItem["ChmodItem"]
+    SystemdUnitEnableItem["SystemdUnitEnableItem"]
+    SystemdUnitRestartItem["SystemdUnitRestartItem"]
+    MkdirItem["MkdirItem"]
+    UnlinkItem["UnlinkItem"]
+    RmTreeItem["RmTreeItem"]
+    Other["Others..."]
+  end
+
+  Item --> ItemTypes
+  ItemTypes --> Outcome["Outcome (item's goal)"]
+
+  Process --> Fulfill["Fulfill outcomes for each item"]
+
+  %% Example flows for item attributes and outcomes
+  ChmodItem -.->|path, mode| Outcome
+  SystemdUnitEnableItem -.->|unit name| Outcome
+  MkdirItem -.->|path| Outcome
+  UnlinkItem -.->|unlink file| Outcome
+  RmTreeItem -.->|remove directory| Outcome
+
+  Queue --> Process
+  Process --> Fulfill
+```
+
+## Example
+
+```python
+from cyberfusion.QueueSupport import Queue
+from cyberfusion.QueueSupport.items.chmod import ChmodItem
+
+queue = Queue()
+
+item = ChmodItem(path="/tmp/example.txt", mode=0o600)
+print(item.outcomes)
+
+queue.add(item)
+
+preview = True or False
+
+outcomes = queue.process(preview=preview)
+
+for outcome in outcomes:
+    print(str(outcome))
+```

{python3_cyberfusion_queue_support-1.2 → python3_cyberfusion_queue_support-1.4}/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python3-cyberfusion-queue-support"
-version = "1.2"
+version = "1.4"
 description = "Library to queue actions."
 readme = "README.md"
 authors = [
     { name = "Cyberfusion", email = "support@cyberfusion.io" },
 ]
 dependencies = [
-    "python3-cyberfusion-systemd-support~=1.0",
+    "python3-cyberfusion-systemd-support~=2.1",
 ]
 
 [project.urls]

python3_cyberfusion_queue_support-1.4/src/cyberfusion/QueueSupport/items/systemd_unit_start.py

@@ -0,0 +1,52 @@
+"""Item."""
+
+import logging
+from typing import List, Optional
+
+from cyberfusion.QueueSupport.items import _Item
+from cyberfusion.QueueSupport.outcomes import (
+    SystemdUnitStartItemStartOutcome,
+)
+from cyberfusion.SystemdSupport.units import Unit
+
+logger = logging.getLogger(__name__)
+
+
+class SystemdUnitStartItem(_Item):
+    """Represents item."""
+
+    def __init__(
+        self,
+        *,
+        name: str,
+        reference: Optional[str] = None,
+        hide_outcomes: bool = False,
+    ) -> None:
+        """Set attributes."""
+        self.name = name
+        self._reference = reference
+        self._hide_outcomes = hide_outcomes
+
+        self.unit = Unit(self.name)
+
+    @property
+    def outcomes(self) -> List[SystemdUnitStartItemStartOutcome]:
+        """Get outcomes of item."""
+        outcomes = []
+
+        if not self.unit.is_active:
+            outcomes.append(SystemdUnitStartItemStartOutcome(unit=self.unit))
+
+        return outcomes
+
+    def fulfill(self) -> None:
+        """Fulfill outcomes."""
+        for outcome in self.outcomes:
+            outcome.unit.start()
+
+    def __eq__(self, other: object) -> bool:
+        """Get equality based on attributes."""
+        if not isinstance(other, SystemdUnitStartItem):
+            return False
+
+        return other.name == self.name

{python3_cyberfusion_queue_support-1.2 → python3_cyberfusion_queue_support-1.4}/src/cyberfusion/QueueSupport/outcomes.py

@@ -248,6 +248,25 @@ class SystemdUnitEnableItemEnableOutcome(OutcomeInterface):
         return other.unit.name == self.unit.name
 
 
+class SystemdUnitStartItemStartOutcome(OutcomeInterface):
+    """Represents outcome."""
+
+    def __init__(self, *, unit: Unit) -> None:
+        """Set attributes."""
+        self.unit = unit
+
+    def __str__(self) -> str:
+        """Get human-readable string."""
+        return f"Start {self.unit.name}"
+
+    def __eq__(self, other: object) -> bool:
+        """Get equality based on attributes."""
+        if not isinstance(other, SystemdUnitStartItemStartOutcome):
+            return False
+
+        return other.unit.name == self.unit.name
+
+
 class SystemdUnitDisableItemDisableOutcome(OutcomeInterface):
     """Represents outcome."""
 

python3_cyberfusion_queue_support-1.4/src/python3_cyberfusion_queue_support.egg-info/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.1
+Name: python3-cyberfusion-queue-support
+Version: 1.4
+Summary: Library to queue actions.
+Author-email: Cyberfusion <support@cyberfusion.io>
+Project-URL: Source, https://github.com/CyberfusionIO/python3-cyberfusion-queue-support
+Description-Content-Type: text/markdown
+Requires-Dist: python3-cyberfusion-systemd-support~=2.1
+
+# python3-cyberfusion-queue-support
+
+Library to queue actions.
+
+`QueueSupport` allows you to _queue_ certain actions, such as restarting a service, unlinking a file, and much more.
+
+For example, suppose the file `/tmp/example.txt` should be chmodded to 0600. You can queue the chmod:
+
+```
+>>> from cyberfusion.QueueSupport import Queue
+>>> from cyberfusion.QueueSupport.items.chmod import ChmodItem
+>>> queue = Queue()
+>>> queue.add(ChmodItem(path="/tmp/example.txt", mode=0o600))
+```
+
+... see what the chmod _would_ do with 'preview mode':
+
+```
+>>> queue.process(preview=False)
+[<cyberfusion.QueueSupport.outcomes.ChmodItemModeChangeOutcome object at 0x7f947e8ef510>]
+>>> print(queue.process(preview=True)[0])
+Change mode of /tmp/example.txt from 0o644 to 0o600
+```
+
+... then actually run the chmod:
+
+```
+>>> print(queue.process(preview=False)[0])
+Change mode of /tmp/example2.txt from 0o644 to 0o600
+```
+
+# Install
+
+## PyPI
+
+Run the following command to install the package from PyPI:
+
+    pip3 install python3-cyberfusion-queue-support
+
+## Debian
+
+Run the following commands to build a Debian package:
+
+    mk-build-deps -i -t 'apt -o Debug::pkgProblemResolver=yes --no-install-recommends -y'
+    dpkg-buildpackage -us -uc
+
+# Configure
+
+No configuration is supported.
+
+# Usage
+
+## Concepts
+
+All project-specific terms are in _italic_.
+
+After creating a _queue_, _items_ can be added to it.
+
+```python
+from cyberfusion.QueueSupport import Queue
+
+queue = Queue()
+
+item = ...
+
+queue.add(item)
+```
+
+_Items_ are of a certain type. Such as `ChmodItem` or `SystemdUnitRestartItem`. Items can have attributes, such as a path for an `MkdirItem`, or a unit name for `SystemdUnitEnableItem`.
+
+```python
+from cyberfusion.QueueSupport.items.chmod import ChmodItem
+from cyberfusion.QueueSupport.items.systemd_unit_enable import SystemdUnitEnableItem
+
+item1 = ChmodItem(path="/tmp/example.txt", mode=0o600)
+item2 = SystemdUnitEnableItem(name="httpd.service")
+```
+
+Each _item_ type has one or multiple _outcomes_. These should come true for an _item_ of that type to be completed. **For example: for an _item_ of type `UnlinkItem`, the _outcome_ is that the file at the path given with the _item_ is unlinked.**
+
+When a _queue_ is _processed_, all the _items_ added to it are _fulfilled_, meaning all the _items'_ _outcomes_ come true.
+
+```python
+from cyberfusion.QueueSupport import Queue
+
+from cyberfusion.QueueSupport.items.rmtree import RmTreeItem
+
+item = RmTreeItem(path="/tmp/dir")
+
+queue = Queue()
+
+queue.add(item)
+
+# Fulfill every item in the queue
+
+queue.process(preview=False)
+queue.process(preview=True)  # Only show what the outcomes would be
+
+# Fulfill a single item
+
+item.fulfill()
+```
+
+## Diagram
+
+```mermaid
+graph TD;
+
+  subgraph QueueSupport
+    Queue["Queue"]
+    Item["Add item"]
+    Process["Process (fulfill all items)"]
+  end
+
+  Queue --> Item
+
+  subgraph ItemTypes["Item types"]
+    ChmodItem["ChmodItem"]
+    SystemdUnitEnableItem["SystemdUnitEnableItem"]
+    SystemdUnitRestartItem["SystemdUnitRestartItem"]
+    MkdirItem["MkdirItem"]
+    UnlinkItem["UnlinkItem"]
+    RmTreeItem["RmTreeItem"]
+    Other["Others..."]
+  end
+
+  Item --> ItemTypes
+  ItemTypes --> Outcome["Outcome (item's goal)"]
+
+  Process --> Fulfill["Fulfill outcomes for each item"]
+
+  %% Example flows for item attributes and outcomes
+  ChmodItem -.->|path, mode| Outcome
+  SystemdUnitEnableItem -.->|unit name| Outcome
+  MkdirItem -.->|path| Outcome
+  UnlinkItem -.->|unlink file| Outcome
+  RmTreeItem -.->|remove directory| Outcome
+
+  Queue --> Process
+  Process --> Fulfill
+```
+
+## Example
+
+```python
+from cyberfusion.QueueSupport import Queue
+from cyberfusion.QueueSupport.items.chmod import ChmodItem
+
+queue = Queue()
+
+item = ChmodItem(path="/tmp/example.txt", mode=0o600)
+print(item.outcomes)
+
+queue.add(item)
+
+preview = True or False
+
+outcomes = queue.process(preview=preview)
+
+for outcome in outcomes:
+    print(str(outcome))
+```

{python3_cyberfusion_queue_support-1.2 → python3_cyberfusion_queue_support-1.4}/src/python3_cyberfusion_queue_support.egg-info/SOURCES.txt

@@ -19,6 +19,7 @@ src/cyberfusion/QueueSupport/items/systemd_unit_disable.py
 src/cyberfusion/QueueSupport/items/systemd_unit_enable.py
 src/cyberfusion/QueueSupport/items/systemd_unit_reload.py
 src/cyberfusion/QueueSupport/items/systemd_unit_restart.py
+src/cyberfusion/QueueSupport/items/systemd_unit_start.py
 src/cyberfusion/QueueSupport/items/systemd_unit_stop.py
 src/cyberfusion/QueueSupport/items/unlink.py
 src/python3_cyberfusion_queue_support.egg-info/PKG-INFO

python3_cyberfusion_queue_support-1.4/src/python3_cyberfusion_queue_support.egg-info/requires.txt

@@ -0,0 +1 @@
+python3-cyberfusion-systemd-support~=2.1

python3_cyberfusion_queue_support-1.2/PKG-INFO

@@ -1,91 +0,0 @@
-Metadata-Version: 2.1
-Name: python3-cyberfusion-queue-support
-Version: 1.2
-Summary: Library to queue actions.
-Author-email: Cyberfusion <support@cyberfusion.io>
-Project-URL: Source, https://github.com/CyberfusionIO/python3-cyberfusion-queue-support
-Description-Content-Type: text/markdown
-Requires-Dist: python3-cyberfusion-systemd-support~=1.0
-
-# python3-cyberfusion-queue-support
-
-Library to queue actions.
-
-# Concepts
-
-All project-specific terms are in _italic_.
-
-After creating a _queue_, _items_ can be added to it.
-
-```python
-queue = Queue()
-
-queue.add(item)
-```
-
-These _items_ can be of multiple types such as `ChmodItem` or `SystemdUnitRestartItem`, and they can have attributes such as a path for an `MkdirItem` or a unit name for a `SystemdUnitEnableItem`.
-
-```python
-item1 = ChmodItem(path="/tmp/example.txt", mode=0o600)
-item2 = SystemdUnitEnableItem(name="httpd.service")
-```
-
-Each _item_ type has one or multiple _outcomes_ that should come true for an _item_ of that type to be completed. For example: for an _item_ of type `UnlinkItem`, the _outcome_ is that the file at the path given with the _item_ is unlinked.
-
-When a _queue_ is _processed_, all the _items_ added to it are _fulfilled_, meaning all the _items'_ _outcomes_ are completed.
-
-```python
-item = RmTreeItem(path="/tmp/dir")
-
-queue = Queue()
-
-queue.add(item)
-
-# for each item added to the queue, its fulfill() function is run
-queue.process()
-
-# this would do the same
-item.fulfill()
-```
-
-# Install
-
-## PyPI
-
-Run the following command to install the package from PyPI:
-
-    pip3 install python3-cyberfusion-queue-support
-
-## Debian
-
-Run the following commands to build a Debian package:
-
-    mk-build-deps -i -t 'apt -o Debug::pkgProblemResolver=yes --no-install-recommends -y'
-    dpkg-buildpackage -us -uc
-
-# Configure
-
-No configuration is supported.
-
-# Usage
-
-## Example
-
-```python
-from cyberfusion.QueueSupport import Queue
-from cyberfusion.QueueSupport.items.chmod import ChmodItem
-
-queue = Queue()
-
-item = ChmodItem(path="/tmp/example.txt", mode=0o600)
-print(item.outcomes)
-
-queue.add(item)
-
-preview = True or False
-
-outcomes = queue.process(preview=preview)
-
-for outcome in outcomes:
-    print(str(outcome))
-```

python3_cyberfusion_queue_support-1.2/README.md

@@ -1,82 +0,0 @@
-# python3-cyberfusion-queue-support
-
-Library to queue actions.
-
-# Concepts
-
-All project-specific terms are in _italic_.
-
-After creating a _queue_, _items_ can be added to it.
-
-```python
-queue = Queue()
-
-queue.add(item)
-```
-
-These _items_ can be of multiple types such as `ChmodItem` or `SystemdUnitRestartItem`, and they can have attributes such as a path for an `MkdirItem` or a unit name for a `SystemdUnitEnableItem`.
-
-```python
-item1 = ChmodItem(path="/tmp/example.txt", mode=0o600)
-item2 = SystemdUnitEnableItem(name="httpd.service")
-```
-
-Each _item_ type has one or multiple _outcomes_ that should come true for an _item_ of that type to be completed. For example: for an _item_ of type `UnlinkItem`, the _outcome_ is that the file at the path given with the _item_ is unlinked.
-
-When a _queue_ is _processed_, all the _items_ added to it are _fulfilled_, meaning all the _items'_ _outcomes_ are completed.
-
-```python
-item = RmTreeItem(path="/tmp/dir")
-
-queue = Queue()
-
-queue.add(item)
-
-# for each item added to the queue, its fulfill() function is run
-queue.process()
-
-# this would do the same
-item.fulfill()
-```
-
-# Install
-
-## PyPI
-
-Run the following command to install the package from PyPI:
-
-    pip3 install python3-cyberfusion-queue-support
-
-## Debian
-
-Run the following commands to build a Debian package:
-
-    mk-build-deps -i -t 'apt -o Debug::pkgProblemResolver=yes --no-install-recommends -y'
-    dpkg-buildpackage -us -uc
-
-# Configure
-
-No configuration is supported.
-
-# Usage
-
-## Example
-
-```python
-from cyberfusion.QueueSupport import Queue
-from cyberfusion.QueueSupport.items.chmod import ChmodItem
-
-queue = Queue()
-
-item = ChmodItem(path="/tmp/example.txt", mode=0o600)
-print(item.outcomes)
-
-queue.add(item)
-
-preview = True or False
-
-outcomes = queue.process(preview=preview)
-
-for outcome in outcomes:
-    print(str(outcome))
-```

python3_cyberfusion_queue_support-1.2/src/python3_cyberfusion_queue_support.egg-info/PKG-INFO

@@ -1,91 +0,0 @@
-Metadata-Version: 2.1
-Name: python3-cyberfusion-queue-support
-Version: 1.2
-Summary: Library to queue actions.
-Author-email: Cyberfusion <support@cyberfusion.io>
-Project-URL: Source, https://github.com/CyberfusionIO/python3-cyberfusion-queue-support
-Description-Content-Type: text/markdown
-Requires-Dist: python3-cyberfusion-systemd-support~=1.0
-
-# python3-cyberfusion-queue-support
-
-Library to queue actions.
-
-# Concepts
-
-All project-specific terms are in _italic_.
-
-After creating a _queue_, _items_ can be added to it.
-
-```python
-queue = Queue()
-
-queue.add(item)
-```
-
-These _items_ can be of multiple types such as `ChmodItem` or `SystemdUnitRestartItem`, and they can have attributes such as a path for an `MkdirItem` or a unit name for a `SystemdUnitEnableItem`.
-
-```python
-item1 = ChmodItem(path="/tmp/example.txt", mode=0o600)
-item2 = SystemdUnitEnableItem(name="httpd.service")
-```
-
-Each _item_ type has one or multiple _outcomes_ that should come true for an _item_ of that type to be completed. For example: for an _item_ of type `UnlinkItem`, the _outcome_ is that the file at the path given with the _item_ is unlinked.
-
-When a _queue_ is _processed_, all the _items_ added to it are _fulfilled_, meaning all the _items'_ _outcomes_ are completed.
-
-```python
-item = RmTreeItem(path="/tmp/dir")
-
-queue = Queue()
-
-queue.add(item)
-
-# for each item added to the queue, its fulfill() function is run
-queue.process()
-
-# this would do the same
-item.fulfill()
-```
-
-# Install
-
-## PyPI
-
-Run the following command to install the package from PyPI:
-
-    pip3 install python3-cyberfusion-queue-support
-
-## Debian
-
-Run the following commands to build a Debian package:
-
-    mk-build-deps -i -t 'apt -o Debug::pkgProblemResolver=yes --no-install-recommends -y'
-    dpkg-buildpackage -us -uc
-
-# Configure
-
-No configuration is supported.
-
-# Usage
-
-## Example
-
-```python
-from cyberfusion.QueueSupport import Queue
-from cyberfusion.QueueSupport.items.chmod import ChmodItem
-
-queue = Queue()
-
-item = ChmodItem(path="/tmp/example.txt", mode=0o600)
-print(item.outcomes)
-
-queue.add(item)
-
-preview = True or False
-
-outcomes = queue.process(preview=preview)
-
-for outcome in outcomes:
-    print(str(outcome))
-```

python3_cyberfusion_queue_support-1.2/src/python3_cyberfusion_queue_support.egg-info/requires.txt

@@ -1 +0,0 @@
-python3-cyberfusion-systemd-support~=1.0