A Singleton python project
Project description
A Singleton python project
Did you need help? Call meeseeks from a single box from anywhere
This is meeseeks a single class to do singletons. In the core meeseeks is a class decorator that allows you to have a global singleton scope or a specialized one, some configurations can be used to give more flexibility to your code.
Scopes
The scope can be global that means your configuration and your singletons can be called anywhere inside your code, or specialized one, that is otherwise you create meeseeks object (OnlyOne) and this object will have your configuration and singletons
Global
import meeseeks
@meeseeks.OnlyOne
class A:
def __int__(self, a):
pass
a1a = A(10)
a1b = A(10)
a1c = A(20)
assert a1a == a1b == a1c
On this example we register the class reference in the global scope
Specialized
import meeseeks
@meeseeks.OnlyOne()
class A:
def __int__(self, a):
pass
a1a = A(10)
a1b = A(10)
a1c = A(20)
assert a1a == a1b == a1c
or
import meeseeks
only_one = meeseeks.OnlyOne()
@only_one
class A:
def __int__(self, a):
pass
a1a = A(10)
a1b = A(10)
a1c = A(20)
assert a1a == a1b == a1c
On this example we register the class reference in the meeseeks class instance scope
Configuration
We provide two configuration options:
tll: int
(time to live) in seconds. Setting a value greater than 0, the singleton reference will have a time to live in seconds (default 0). Obs: the expired time validation will be made only when you create a new instance of the registered class ie your object will still be in memoryby_args_hash: bool
( a hash will be made of all args and kwargs ). Setting True, a singleton reference will be created for each arg + kwargs hash (default False). Obs: The kwargs`s order doesn't have influence
TTL
import meeseeks
import time
meeseeks.OnlyOne.set_global_options(ttl=1)
@meeseeks.OnlyOne
class A:
def __int__(self, *args, **kwargs):
pass
a1a = A(1, var_a="a")
a1b = A(1, var_a="a")
time.sleep(1)
a1c = A(1, var_a="a")
assert a1a == a1b
assert a1b != a1c
In this example, we set the ttl
to 1
second and validate if the first two calls result in the same object and after 1 second we validate if the object is different from the first two
BY_ARGS_HASH
import meeseeks
import time
@meeseeks.OnlyOne(by_args_hash=True)
class A:
def __int__(self, a):
pass
a1a = A(1, var_a="a", var_b="b")
a1b = A(1, var_b="b", var_a="a")
a1c = A(10, var_b="b", var_a="a")
assert a1a == a1b
assert a1c != a1b
In this example, we set by_args_hash
variable to True
and validate if the first two calls result in the same object despite the kwargs order being different. The last validation shows us that different args and kwargs result in different objects.
Test
Yes! We tested it!!! Did you need a proof?! OK, click here
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for meeseeks_singleton-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | faf7f42683566a33e4aaa33a7c503324d927f57743007ab6bec4221541833125 |
|
MD5 | 134d3ae6857258cb28cd533fc79e39ac |
|
BLAKE2b-256 | 8b5b83a8d17183b7a9a7a9ef3afb8f9af095cf6e1db33df1402be6f09fd6e2a5 |