Changes between Version 2 and Version 3 of utilitiespy

Timestamp:

10/09/24 10:13:27 (7 weeks ago)

Author:

wouter

Comment:

--

utilitiespy

@@ -14 +14 @@
 == immutablelist
 This is a partial translation of the [wiki:immutablelist java immutablelist].
+
+== listener
+This is a translation of the [wiki:Listener java Listener]
+
+== Tools
+Tools contains a set of small tools for python.
+=== enum
+enum is a tool to support 'classic enums' in python. The classic way was to just put enumeration values inside a class. For example, math.pi equals the number 3.1415 etc. We refer to pi in math.pi as an **enum item** in the math class.
+We call this the "classic" enumeration, to distinguish it from the more complex Enum type in python. 
+
+This tool assumes that all enum items in the class are actual instances of that class. So for example, this SimpleEnum class contains enum items P and Q:
+
+{{{
+class SimpleEnum:
+ def val(self) -> str:
+  return "$"
+ @staticmethod
+ def _static_init_():
+  SimpleEnum.P = SimpleEnum()
+  SimpleEnum.Q = SimpleEnum()
+SimpleEnum._static_init_()
+}}}
+
+the enum method enumValues(claz) returns all the enum items contained in that claz. So in the above example, {{{enumValues(SimpleEnum) -> [SimpleEnum.P, SimpleEnum.Q]}}}.
+
+The enum method enumToString(item) returns the string representation. So in the above example, enumToString(SimpleEnum.P) returns "P".