morelists 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

morelists/__init__.py

@@ -1,9 +1,29 @@
 import time
+import json
 
 class GameList():
-    def __init__(self):
-        self.list = {}
-        self.flippedList = {}
+    def __init__(self, list = None, expirationList = None, flippedList = None, freeze = False, deltaTime = 0):
+        """
+        Creates a new GameList
+
+        Useful when you want to add, subtract, multiply, and divide items
+        inside a list to calculate strength of effect or other things.
+        Comes with a built-in expiration date for easy use.
+
+        Perfect for game engine with changing stats like adding buffs and debuffs. 
+
+        Should not receive any arguments without experienced knowledge of the library.
+
+        Keyword arguments:
+        list -- the starting list (default None)
+        expirationList -- the starting list tracking expiration dates (default None)
+        flippedList -- inverted list, used for faster lookup (default None)
+        freeze -- preserve the list and stops the built-in expiration date deletor (default False)
+        deltaTime -- tells the list how much behind it is in time. Used in updateToPresent() (default 0)
+        """
+        self.list: dict = list if list != None else {}
+        self.expirationList: dict = expirationList if expirationList != None else {}
+        self.flippedList: dict = flippedList if flippedList != None else {}
 
         self.addValue = 0
         self.subtractValue = 0
@@ -11,12 +31,50 @@ class GameList():
         self.divideValue = 1
         self.sum = 0
 
+        self.freeze = freeze
+
+        self.history = [(0, {}, {}, {}, 0.0)]
+
+        self.deltaTime = deltaTime
+
+
+    def safeSum(self):
+        try:
+            return (self.addValue - self.subtractValue) * self.multiplyValue / self.divideValue
+        except ZeroDivisionError:
+            print("[WARNING]: GameList can't sum the list because of a ZeroDivisionError. Defaulted the sum value to be 0.")
+            return 0
+
+
     def add(self, item, expires = -1):
-        expires += time.time()
+        """
+        Adds a item to the list.
+
+        Keyword arguments:
+        item -- item you wish to add. Format: {"name":"nameHere", "type":"add/subtract/multiply/divide", "value":float}
+        expires -- in seconds on how long until it expires and gets deleted. Set it to -1 to allow it to exist forever (default -1)
+        """
+        immortal = True if expires == -1 else False
+        perf_counter = time.time()
+        expires += perf_counter
         self.list[expires] = {"name":item.get("name", ""), "type":item.get("type", "add"), "value":item.get("value", 0)}
+
+
         if self.list[expires]["type"] not in ["add", "subtract", "multiply", "divide"]:
-            self.list[expires]["type"] = "add"
-        self.flippedList[str(self.list[expires])] = expires
+            print(f"[WARNING]: GameList only supports add/subtract/multiply/divide types. Your input type: {self.list[expires]["type"]}. Defaulting to add type.") 
+            self.list[expires]["type"] = "add" 
+
+        if not "value" in item:
+            defaultValue = 0 if self.list[expires]["type"] in ["add", "subtract"] else 1
+            self.list[expires]["value"] = defaultValue
+            print(f"[WARNING]: GameList uses the key 'value' to store the value of each item. You seem to have not given it a value. Defaulted to {defaultValue}.") 
+
+        if self.list[expires]["name"] == "":
+            print(f'[WARNING]: GameList uses the key \'name\' to track items. You seem to have not given it a value. This will make it hard to track and pop at a later time (before its expiration date). Defaulted to "".') 
+
+        if not immortal:
+            self.expirationList[expires] = self.list[expires]
+        self.flippedList[json.dumps(self.list[expires], sort_keys=True)] = expires
 
         if item["type"]   == "add":
             self.addValue += item["value"]
@@ -25,12 +83,27 @@ class GameList():
         elif item["type"] == "multiply":
             self.multiplyValue += (item["value"] - 1)
         elif item["type"] == "divide":
-            self.divideValue += (item["value"] - 1)
+            self.divideValue += (item["value"] - 1) 
+
+        object.__getattribute__(self, "history").append((perf_counter, self.list, self.expirationList, self.flippedList, self.safeSum()))
 
     def unsafeAdd(self, item, expires = -1):
-        expiration = expires + time.time()
-        self.list[expiration] = item
-        self.flippedList[str(item)] = expiration
+        """
+        Adds a item to the list using a more unsafe method.
+
+        Only use this if you know what you are doing!
+
+        Keyword arguments:
+        item -- item you wish to add. Format: {"name":"nameHere", "type":"add/subtract/multiply/divide", "value":float}
+        expires -- in seconds on how long until it expires and gets deleted. Set it to -1 to allow it to exist forever (default -1)
+        """
+        immortal = True if expires == -1 else False
+        perf_counter = time.time()
+        expires += perf_counter
+        self.list[expires] = item
+        if not immortal:
+            self.expirationList[expires] = self.list[expires]
+        self.flippedList[json.dumps(item, sort_keys=True)] = expires
     
         if item["type"]   == "add":
             self.addValue += item["value"]
@@ -41,10 +114,44 @@ class GameList():
         elif item["type"] == "divide":
             self.divideValue += (item["value"] - 1)
 
+        object.__getattribute__(self, "history").append((perf_counter, self.list, self.expirationList, self.flippedList, self.safeSum()))
+            
+
+    def calculateSumWithoutUpdate(self):
+        """
+        Calculates the sum of the list without checking for expired items
+
+        Use only if you want to access the sum without updating
+        """
+        self.addValue = 0
+        self.subtractValue = 0
+        self.multiplyValue = 1
+        self.divideValue = 1
+        for item in self.list.values():
+            if item["type"]   == "add":
+                self.addValue += item["value"]
+            elif item["type"] == "subtract":
+                self.subtractValue += item["value"]
+            elif item["type"] == "multiply":
+                self.multiplyValue += (item["value"] - 1)
+            elif item["type"] == "divide":
+                self.divideValue += (item["value"] - 1)
+
+        return self.safeSum()
+
+
 
     def update(self):
+        """
+        Updates the list and removes any expires items.
+
+        This is already called upon when accessing the sum or history.
+        This function doesn't need to be by the user.
+        """
+
+        # update() ignore the reeze flag because it's assumed the user is calling it with the purpose of updating it manually
         try:
-            expiration = min(self.list.keys())
+            expiration = min(self.expirationList.keys())
             while expiration < time.time():
                 if self.list[expiration]["type"] == "add":
                     self.addValue -= self.list[expiration]["value"]
@@ -54,36 +161,181 @@ class GameList():
                     self.multiplyValue -= (self.list[expiration]["value"] - 1)
                 else:
                     self.divideValue -= (self.list[expiration]["value"] - 1)
+
+                del self.flippedList[json.dumps(self.list[expiration], sort_keys=True)]
                 del self.list[expiration]
 
-                expiration = min(self.list.keys())
-        except ValueError:
-            pass
+                object.__getattribute__(self, "history").append((expiration, self.list, self.expirationList, self.flippedList, self.safeSum()))
+                expiration = min(self.expirationList.keys())
+        except ValueError as e:
+            print(f"[WARNING]: While updating the list, a new error appeared: {e}")
+
+    def pause(self):
+        """
+        Prevents the list from auto-updating and prevents deletions of expired items without user input.
+        """
+        self.freeze = True
+
+    def resume(self):
+        """
+        Resumes the list to auto-update and delete expired items automatically.
+        """
+        self.freeze = False
+
+    def updateToPresent(self):
+        """
+        Updates each item in the list to match if the list was in the present. Setting deltaTime changes how much this affects the list.
+
+        Only use this if you are experienced and know what you are doing.
+        """
+        newList = {}
+        for key, value in self.list.items():
+            newList[key + self.deltaTime] = value
+        self.deltaTime = 0
+
+    def restoreState(self, t) -> "GameList":
+        """
+        Creates a new GameList from the history of the list. Useful if you want to track previous sum values and such.
+
+        Keyword arguments:
+        t -- the time you want the new list to be based on
+        """
+        self.update()
+        lastItem = None
+        for item in self.history:
+            if item[0] < t:
+                lastItem = item
+            else:
+                break
+
+        if lastItem == None:
+            return GameList()
+        else:
+            return GameList(lastItem[1], lastItem[2], False, time.time() - lastItem[0])
+
+    def getOldSums(self, t0, t1) -> list[tuple]:
+        """
+        Creates a list of tuples with the sum value from t0 -> t1.
+
+        Format: [(time, sum_value), ...]
+
+        Keyword arguments:
+        t0 -- the time you want the list to start
+        t1 -- the time you want the list to end
+        """
+        self.update()
+        items = []
+        for item in self.history:
+            if item[0] < t0:
+                items = [(item[0], item[4])]
+            elif item[0] < t1:
+                items.append((item[0], item[4]))
+            else:
+                break
+
+        return items
+        
 
     def pop(self, name):
-        pops = [value for value in self.list.values() if value["name"] == name]
-        pops.sort(key=lambda a: a["expires"])
+        """
+        Pops a item from the list with the closest expiration date to the current time
+
+        Keyword arguments:
+        name -- the name you gave the item in the list
+        """
+        perf_counter = time.time()
+        pops = [(key, value) for key, value in self.list.items() if value["name"] == name]
+        pops.sort(key=lambda a: a[0])
         if pops:
-            del self.list[self.flippedList[str(pops[0])]]
-            del self.flippedList[str(pops[0])]
+            stringedList = json.dumps(pops[0][1], sort_keys=True)
+
+            item = self.list[self.flippedList[stringedList]]
+            del self.list[self.flippedList[stringedList]]
+            if self.flippedList[stringedList] in self.expirationList: del self.expirationList[self.flippedList[stringedList]]
+            del self.flippedList[stringedList]
+
+            if item["type"] == "add":
+                self.addValue -= item["value"]
+            elif item["type"] == "subtract":
+                self.subtractValue -= item["value"]
+            elif item["type"] == "multiply":
+                self.multiplyValue -= (item["value"] - 1)
+            else:
+                self.divideValue -= (item["value"] - 1)
+
+            object.__getattribute__(self, "history").append((perf_counter, self.list, self.expirationList, self.flippedList, self.safeSum()))
 
     def popAny(self, name):
+        """
+        Pops a item from the list with no regards for expiration date
+
+        Keyword arguments:
+        name -- the name you gave the item in the list
+        """
+        perf_counter = time.time()
         pops = [value for value in self.list.values() if value["name"] == name]
         if pops:
-            del self.list[self.flippedList[str(pops[0])]]
-            del self.flippedList[str(pops[0])]
+            stringedList = json.dumps(pops[0], sort_keys=True)
+
+            item = self.list[self.flippedList[stringedList]]
+            del self.list[self.flippedList[stringedList]]
+            if self.flippedList[stringedList] in self.expirationList: del self.expirationList[self.flippedList[stringedList]]
+            del self.flippedList[stringedList]
+
+            if item["type"] == "add":
+                self.addValue -= item["value"]
+            elif item["type"] == "subtract":
+                self.subtractValue -= item["value"]
+            elif item["type"] == "multiply":
+                self.multiplyValue -= (item["value"] - 1)
+            else:
+                self.divideValue -= (item["value"] - 1)
+
+            object.__getattribute__(self, "history").append((perf_counter, self.list, self.expirationList, self.flippedList, self.safeSum()))
 
     def popAll(self, name):
+        """
+        Pops every item from the list with the given name
+
+        Keyword arguments:
+        name -- the name you gave the item(s) in the list
+        """
+        perf_counter = time.time()
         pops = [value for value in self.list.values() if value["name"] == name]
         if pops:
             for x in range(len(pops)):
-                del self.list[self.flippedList[str(pops[x])]]
-                del self.flippedList[str(pops[x])]
+                stringedList = json.dumps(pops[x], sort_keys=True)
+
+
+                item = self.list[self.flippedList[stringedList]]
+                del self.list[self.flippedList[stringedList]]
+                if self.flippedList[stringedList] in self.expirationList: del self.expirationList[self.flippedList[stringedList]]
+                del self.flippedList[stringedList]
+
+                if item["type"] == "add":
+                    self.addValue -= item["value"]
+                elif item["type"] == "subtract":
+                    self.subtractValue -= item["value"]
+                elif item["type"] == "multiply":
+                    self.multiplyValue -= (item["value"] - 1)
+                else:
+                    self.divideValue -= (item["value"] - 1)
+
+            object.__getattribute__(self, "history").append((perf_counter, self.list, self.expirationList, self.flippedList, self.safeSum()))
 
     def remove(self, item):
-        if self.flippedList.get(str(item), None):
-            del self.list[self.flippedList[str(item)]]
-            del self.flippedList[str(item)]
+        """
+        Removes a specific item from the list (if it exists)
+
+        Keyword arguments:
+        name -- the name you gave the item(s) in the list
+        """
+        perf_counter = time.time()
+        stringedList = json.dumps(item, sort_keys=True)
+        if self.flippedList.get(stringedList, None):
+            del self.list[self.flippedList[stringedList]]
+            if self.flippedList[stringedList] in self.expirationList: del self.expirationList[self.flippedList[stringedList]]
+            del self.flippedList[stringedList]
 
             if item["type"] == "add":
                 self.addValue -= item["value"]
@@ -94,10 +346,23 @@ class GameList():
             else:
                 self.divideValue -= (item["value"] - 1)
 
+            object.__getattribute__(self, "history").append((perf_counter, self.list, self.expirationList, self.flippedList, self.safeSum()))
+
     def unsafeRemove(self, item):
+        """
+        Removes a specific item from the list (if it exists)
+
+        More unsafe compared to remove(item), so use only if you know what you are doing!
+
+        Keyword arguments:
+        name -- the name you gave the item(s) in the list
+        """
+        perf_counter = time.time()
         if item in self.list.values():
-            del self.list[dict(self.flippedList[str(item)])]
-            del self.flippedList[str(item)]
+            stringedList = json.dumps(item, sort_keys=True)
+            del self.list[dict(self.flippedList[stringedList])]
+            if dict(self.flippedList[stringedList]) in self.expirationList: del self.expirationList[dict(self.flippedList[stringedList])]
+            del self.flippedList[stringedList]
 
             if item["type"] == "add":
                 self.addValue -= item["value"]
@@ -108,18 +373,31 @@ class GameList():
             else:
                 self.divideValue -= (item["value"] - 1)
 
+            object.__getattribute__(self, "history").append((perf_counter, self.list, self.expirationList, self.flippedList, self.safeSum()))
+
     def __getattribute__(self, name):
+        """
+        Retrieves attributes from the class
+
+        Updates the list if you grab the sum value or the history data
+
+        Keyword arguments:
+        name -- the name of the attribute you want to grab
+        """
         if name == "sum":
-            self.update()
+            if not object.__getattribute__(self, "freeze"):
+                self.update()
             return (object.__getattribute__(self, "addValue") - 
                     object.__getattribute__(self, "subtractValue")) * \
                    object.__getattribute__(self, "multiplyValue") / \
                    object.__getattribute__(self, "divideValue")
-        return object.__getattribute__(self, name)
-        
-
+        elif name == "history":
+            if not object.__getattribute__(self, "freeze"):
+                self.update()
 
 
+        return object.__getattribute__(self, name)
+        
 
 
 

{morelists-0.1.0.dist-info → morelists-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: morelists
-Version: 0.1.0
+Version: 0.1.2
 Summary: A small and easy list you can add together like a math equation and has a expiration date for items. Mostly useful for games with stats from multiple sources. More lists will come soon.
 Home-page: https://github.com/EmanuelNorsk/enlist
 Author: Emanuel Odén Hesselroth
@@ -13,3 +13,4 @@ Requires-Python: >=3.6
 License-File: LICENSE
 Dynamic: author
 Dynamic: home-page
+Dynamic: license-file

morelists-0.1.2.dist-info/RECORD

@@ -0,0 +1,6 @@
+morelists/__init__.py,sha256=b46BNQD_evFdrX8YU5ignMxU6ZBDIpEx0KbXoQCY8PI,16729
+morelists-0.1.2.dist-info/licenses/LICENSE,sha256=-ASFHlrne1rk8zV57Qj01X2JB-D67ZHPMv1PtQhrbN8,32
+morelists-0.1.2.dist-info/METADATA,sha256=JtoS_qxKDCJ8q_r3ootsTvDI_1E38VcM7jx4dVHaMvk,681
+morelists-0.1.2.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
+morelists-0.1.2.dist-info/top_level.txt,sha256=Zd7NosYzor-RcH_aD86FXJa3fQzWunYA4_FQS3Yodqo,10
+morelists-0.1.2.dist-info/RECORD,,

{morelists-0.1.0.dist-info → morelists-0.1.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.8.0)
+Generator: setuptools (79.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

morelists-0.1.0.dist-info/RECORD

@@ -1,6 +0,0 @@
-morelists/__init__.py,sha256=MCofk70SKqV9lkk01iBpyYAIFl29vB09RXX4WnOM0UA,4718
-morelists-0.1.0.dist-info/LICENSE,sha256=-ASFHlrne1rk8zV57Qj01X2JB-D67ZHPMv1PtQhrbN8,32
-morelists-0.1.0.dist-info/METADATA,sha256=jq8smAfeCnSeI0uDBOOBJt-44Xa4oI-AY2GWO-H517Q,658
-morelists-0.1.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-morelists-0.1.0.dist-info/top_level.txt,sha256=Zd7NosYzor-RcH_aD86FXJa3fQzWunYA4_FQS3Yodqo,10
-morelists-0.1.0.dist-info/RECORD,,