Skip to content

factory

Factory Utility API

This module provides a thread-safe singleton factory to register, create, and list items.

Classes:

Classes

SingletonMeta

Thread-safe singleton.

ItemFactory 

ItemFactory()

Item factory enables registering, creating, and listing items. It is a singleton class.

Source code in helia_edge/utils/factory.py 
43
44
def __init__(self):
    self._items = {}

Functions

shared classmethod 
shared(factory: str) -> ItemFactory

Get the shared instance of the factory

Returns:

Source code in helia_edge/utils/factory.py 
49
50
51
52
53
54
55
56
@classmethod
def shared(cls, factory: str) -> "ItemFactory":
    """Get the shared instance of the factory

    Returns:
        ItemFactory: shared instance
    """
    return cls(singleton=factory)
register 
register(name: str, item: T) -> None

Register an item

Parameters:

  • name
    (str) –

    Unique item name

  • item
    (T) –

    Item

Source code in helia_edge/utils/factory.py 
58
59
60
61
62
63
64
65
def register(self, name: str, item: T) -> None:
    """Register an item

    Args:
        name (str): Unique item name
        item (T): Item
    """
    self._items[name] = item
unregister 
unregister(name: str) -> None

Unregister an item

Parameters:

  • name
    (str) –

    Item name

Source code in helia_edge/utils/factory.py 
67
68
69
70
71
72
73
def unregister(self, name: str) -> None:
    """Unregister an item

    Args:
        name (str): Item name
    """
    self._items.pop(name, None)
list 
list() -> list[str]

List registered items

Returns:

  • list[str] –

    list[str]: item names

Source code in helia_edge/utils/factory.py 
75
76
77
78
79
80
81
def list(self) -> list[str]:
    """List registered items

    Returns:
        list[str]: item names
    """
    return list(self._items.keys())
get 
get(name: str) -> T

Get an item

Parameters:

  • name
    (str) –

    Item name

Returns:

  • T ( T ) –

    Item

Source code in helia_edge/utils/factory.py 
83
84
85
86
87
88
89
90
91
92
def get(self, name: str) -> T:
    """Get an item

    Args:
        name (str): Item name

    Returns:
        T: Item
    """
    return self._items[name]
has 
has(name: str) -> bool

Check if an item is registered

Parameters:

  • name
    (str) –

    Item name

Returns:

  • bool ( bool ) –

    True if item is registered

Source code in helia_edge/utils/factory.py 
 94
 95
 96
 97
 98
 99
100
101
102
103
def has(self, name: str) -> bool:
    """Check if an item is registered

    Args:
        name (str): Item name

    Returns:
        bool: True if item is registered
    """
    return name in self._items

Functions

create_factory 

create_factory(factory: str, type: Type[T]) -> ItemFactory[T]

Create a factory

Parameters:

  • factory

    (str) –

    Factory name

  • type

    (Type[T]) –

    Item type

Returns:

Source code in helia_edge/utils/factory.py 
106
107
108
109
110
111
112
113
114
115
116
def create_factory(factory: str, type: Type[T]) -> ItemFactory[T]:
    """Create a factory

    Args:
        factory (str): Factory name
        type (Type[T]): Item type

    Returns:
        ItemFactory[T]: factory
    """
    return ItemFactory[T].shared(factory)