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

pyfcstm/config/meta.py

@@ -7,7 +7,7 @@ Overview:
 __TITLE__ = 'pyfcstm'
 
 #: Version of this project.
-__VERSION__ = '0.1.0'
+__VERSION__ = '0.1.2'
 
 #: Short description of the project, will be included in ``setup.py``.
 __DESCRIPTION__ = ('A Python framework for parsing finite state machine DSL and '

pyfcstm/model/model.py

@@ -38,6 +38,8 @@ __all__ = [
     'parse_dsl_node_to_state_machine',
 ]
 
+from ..utils import sequence_safe
+
 
 @dataclass
 class Operation(AstExportable):
@@ -877,18 +879,27 @@ class State(AstExportable, PlantUMLExportable):
         :return: PlantUML representation of the state
         :rtype: str
         """
+
+        def _name_safe(sub_state: Optional[str] = None):
+            subpath = [*self.path]
+            if sub_state is not None:
+                subpath.append(sub_state)
+            return sequence_safe(subpath)
+
         with io.StringIO() as sf:
             if self.is_leaf_state:
-                print(f'state {self.name}', file=sf, end='')
+                print(f'state {json.dumps(self.name)} as {_name_safe()}', file=sf, end='')
             else:
-                print(f'state {self.name} {{', file=sf)
+                print(f'state {json.dumps(self.name)} as {_name_safe()} {{', file=sf)
                 for state in self.substates.values():
                     print(indent(state.to_plantuml(), prefix='    '), file=sf)
                 for trans in self.transitions:
                     with io.StringIO() as tf:
-                        print('[*]' if trans.from_state is dsl_nodes.INIT_STATE else trans.from_state, file=tf, end='')
+                        print('[*]' if trans.from_state is dsl_nodes.INIT_STATE
+                              else _name_safe(trans.from_state), file=tf, end='')
                         print(' --> ', file=tf, end='')
-                        print('[*]' if trans.to_state is dsl_nodes.EXIT_STATE else trans.to_state, file=tf, end='')
+                        print('[*]' if trans.to_state is dsl_nodes.EXIT_STATE
+                              else _name_safe(trans.to_state), file=tf, end='')
 
                         if trans.event is not None:
                             print(f' : {".".join(list(trans.event.path[len(self.path):]))}', file=tf, end='')
@@ -920,7 +931,7 @@ class State(AstExportable, PlantUMLExportable):
                     for during_aspect_item in self.on_during_aspects:
                         print(during_aspect_item.to_ast_node(), file=tf)
                     text = json.dumps(tf.getvalue().rstrip()).strip("\"")
-                    print(f'{self.name} : {text}', file=sf, end='')
+                    print(f'{_name_safe()} : {text}', file=sf, end='')
 
             return sf.getvalue()
 
@@ -1021,8 +1032,8 @@ class StateMachine(AstExportable, PlantUMLExportable):
                 print('end note', file=sf)
                 print('', file=sf)
             print(self.root_state.to_plantuml(), file=sf)
-            print(f'[*] --> {self.root_state.name}', file=sf)
-            print(f'{self.root_state.name} --> [*]', file=sf)
+            print(f'[*] --> {sequence_safe(self.root_state.path)}', file=sf)
+            print(f'{sequence_safe(self.root_state.path)} --> [*]', file=sf)
             print('@enduml', file=sf, end='')
             return sf.getvalue()
 
@@ -1147,7 +1158,7 @@ def parse_dsl_node_to_state_machine(dnode: dsl_nodes.StateMachineDSLProgram) ->
 
         transitions = current_state.transitions
         for subnode in node.substates:
-            _inner_force_transitions = [*force_transitions]
+            _inner_force_transitions = []
             for from_state, to_state, my_event_id, trans_event, condition_expr, guard in force_transition_tuples_to_inherit:
                 if from_state is dsl_nodes.ALL or from_state == subnode.name:
                     transitions.append(Transition(

pyfcstm/utils/__init__.py

@@ -3,5 +3,6 @@ from .decode import auto_decode
 from .doc import format_multiline_comment
 from .jinja2 import add_builtins_to_env, add_settings_for_env
 from .json import IJsonOp
+from .safe import sequence_safe
 from .text import normalize, to_identifier
 from .validate import ValidationError, ModelValidationError, IValidatable

pyfcstm/utils/safe.py

@@ -0,0 +1,41 @@
+"""
+Utility module for creating safe sequence identifiers.
+
+This module provides functionality to convert sequences of strings into safe, 
+underscore-separated identifiers. It's particularly useful for generating 
+consistent naming conventions from potentially inconsistent input strings.
+
+The main use case is to take a collection of string segments that may use
+different naming conventions (CamelCase, snake_case, kebab-case, etc.) and
+normalize them into a consistent, safe identifier format using underscores
+as separators.
+"""
+
+import re
+from typing import Iterable
+
+from hbutils.string import underscore
+
+
+def sequence_safe(segments: Iterable[str]) -> str:
+    """
+    Convert a sequence of strings into a safe underscore-separated identifier.
+
+    This function takes a sequence of strings, converts each to underscore format,
+    normalizes multiple consecutive underscores to single underscores, and joins
+    them with double underscores ('__'). This is useful for creating consistent
+    identifiers from potentially inconsistent input strings.
+
+    :param segments: A sequence of strings to be converted into a safe identifier.
+    :type segments: Iterable[str]
+
+    :return: A safe underscore-separated identifier string.
+    :rtype: str
+
+    Example::
+        >>> sequence_safe(['CamelCase', 'snake_case', 'kebab-case'])
+        'camel_case__snake_case__kebab_case'
+        >>> sequence_safe(['Hello World', 'Test___String'])
+        'hello_world__test_string'
+    """
+    return '__'.join(map(lambda x: re.sub(r'_+', '_', underscore(x)), segments))

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyfcstm
-Version: 0.1.0
+Version: 0.1.2
 Summary: A Python framework for parsing finite state machine DSL and generating executable code in multiple target languages.
 Home-page: https://github.com/hansbug/pyfcstm
 Author: HansBug

{pyfcstm-0.1.0.dist-info → pyfcstm-0.1.2.dist-info}/RECORD

@@ -1,7 +1,7 @@
 pyfcstm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pyfcstm/__main__.py,sha256=rqAJpNJgf8R-OZnKecjYyCrK_hJcQhHaO0UL6Vb92-8,75
 pyfcstm/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pyfcstm/config/meta.py,sha256=z4hf_T3kF1MS6kkQlF4QsxASIvNRh93TTGLkjUQZnNQ,534
+pyfcstm/config/meta.py,sha256=aaBszpb_wRXoEVbFncNHuD9R0bLJbUlWeCyBhWpTTUk,534
 pyfcstm/dsl/__init__.py,sha256=3GMEILDRArhkjz0vQPHOk_eiby74H94TOa3o-Tpo4x0,349
 pyfcstm/dsl/error.py,sha256=BEaroPj98Q8J12IT73rfPeb9y0TXjPG6llDo5GiqRIU,8878
 pyfcstm/dsl/listener.py,sha256=9J8QETMu40HxT20ZOJ4c9QWY7X_Y6AbEgkzoD-xTAg4,19633
@@ -25,23 +25,24 @@ pyfcstm/entry/plantuml.py,sha256=uZUZ_kxhxinh8Jw6nf0e4c2C14kfqH5eeRS3bbCDRbc,266
 pyfcstm/model/__init__.py,sha256=aJ76DOX21iXRJN2xwsH7CiEG7iPkpDJMXKvEh9Xb9Q4,93
 pyfcstm/model/base.py,sha256=3H6Sf9uTfAZUNemSmR4L1aoSICG42EcrVncgQDZNAXY,1761
 pyfcstm/model/expr.py,sha256=X3eyOYMeZ66LdD0ZpwDjDRQUQrkpXtpSWLY9TILFzSI,18908
-pyfcstm/model/model.py,sha256=fiZ69V3CGUBbCxV4gkRrWECTOsXaJ9Ful3adHlIv8tk,56066
+pyfcstm/model/model.py,sha256=hIxzlFjViZo7C9nwP7NAtGD6USedmK1k69QJFZbYLTw,56476
 pyfcstm/render/__init__.py,sha256=Bettq3kIoswqSZQSxjQciMrmRZqkn5noaKoQO9d8Jlw,153
 pyfcstm/render/env.py,sha256=pjZnlvYLL8sA9lZupKtIHijrHOiAWBeBU_ytNYLxz1w,1106
 pyfcstm/render/expr.py,sha256=sT7uazQuEFrAFHBSTV0FviubNIYP-CTjhNhd4dO96Fo,7551
 pyfcstm/render/func.py,sha256=FZlQiKxKpOomH83FDqYYoeeclXlmm07zHYJk8MN5Cws,2663
 pyfcstm/render/render.py,sha256=FmhHJvoIwWFGpm-KqDqybadj9pZbo7-bIiNxnyBF2Fc,11577
-pyfcstm/utils/__init__.py,sha256=9Bhh0epIZ_zL3ynzN7LUG9ts3aBcSXMbxSr_fRCJIkg,314
+pyfcstm/utils/__init__.py,sha256=FwtqP21-Uzj_2ocvdKTJ9ex-qJ_hcnyhWKj_vFYd6pg,346
 pyfcstm/utils/binary.py,sha256=6AnX6Hx4JFRHl0Y1A6OJ1b_1-QtzaajEywp0h-a4kbs,1196
 pyfcstm/utils/decode.py,sha256=V9WYt9_db_ddIB3PiSsGPPAO_aAeHinNRvA3W5jO6XM,3636
 pyfcstm/utils/doc.py,sha256=CNGQoxTl33KEAnEXl_sr4I97zNARaAa2IwKKt5IC1MA,1905
 pyfcstm/utils/jinja2.py,sha256=9lJFnsxfzTfc9Wj1twhk3e6aFgRzBW-mbhdOVudNcKw,4321
 pyfcstm/utils/json.py,sha256=WPubB5ObTNT8eEyGV3DcgFE8BuYxJUO8xYPx5_kvvCQ,3732
+pyfcstm/utils/safe.py,sha256=PT5WbzRlQqbaxYVqPB5f6mIhJXb3sa8JBwPcqXnuU9U,1565
 pyfcstm/utils/text.py,sha256=wb4vIWB3mLne1R64x_MIS5qsIlGQ6cGCUVcbPlV21Hw,2895
 pyfcstm/utils/validate.py,sha256=87k1B-gzYd-mZP2N5-nsC8OeLZsfNTOCjp_5LUgsaxw,3129
-pyfcstm-0.1.0.dist-info/LICENSE,sha256=pWgb-bBdsU2Gd2kwAXxketnm5W_2u8_fIeWEgojfrxs,7651
-pyfcstm-0.1.0.dist-info/METADATA,sha256=UD0bt8g15Yl44cOudHA7YEX6O6ghsCT6wGhHnY9U5J8,13742
-pyfcstm-0.1.0.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
-pyfcstm-0.1.0.dist-info/entry_points.txt,sha256=Jh9a4hY-nMh5VTiuIBiZcM403biCHOwXk5hKNBr3Eok,53
-pyfcstm-0.1.0.dist-info/top_level.txt,sha256=0VZTj6MqIhOSyoQLYUk1inV0P34VgetNZIKrzj-HNqo,8
-pyfcstm-0.1.0.dist-info/RECORD,,
+pyfcstm-0.1.2.dist-info/LICENSE,sha256=pWgb-bBdsU2Gd2kwAXxketnm5W_2u8_fIeWEgojfrxs,7651
+pyfcstm-0.1.2.dist-info/METADATA,sha256=EFjxrNds-RricBfU83I1ykUuXDjO89fgzRfvkDHKc_w,13742
+pyfcstm-0.1.2.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
+pyfcstm-0.1.2.dist-info/entry_points.txt,sha256=Jh9a4hY-nMh5VTiuIBiZcM403biCHOwXk5hKNBr3Eok,53
+pyfcstm-0.1.2.dist-info/top_level.txt,sha256=0VZTj6MqIhOSyoQLYUk1inV0P34VgetNZIKrzj-HNqo,8
+pyfcstm-0.1.2.dist-info/RECORD,,