dfpyre 0.6.3__tar.gz → 0.7.0__tar.gz

{dfpyre-0.6.3 → dfpyre-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dfpyre
-Version: 0.6.3
+Version: 0.7.0
 Summary: A package for creating and modifying code templates for the DiamondFire Minecraft server.
 Home-page: https://github.com/Amp63/pyre
 License: MIT
@@ -70,6 +70,7 @@ pip install dfpyre
 
 ## Extras
 
+- [Editing Tags](#editing-tags)
 - [Importing from Code](#importing-from-code)
 - [Script Generation](#script-generation)
 - [Method List](#method-list)
@@ -374,7 +375,7 @@ t.player_action('SendMessage', 'Hello, ', var('name', 'line'))
 
 ### Conditionals and Brackets
 
-A list of conditionals and loops can be found [here](#commands).
+A list of conditionals and loops can be found [here](#method-list).
 
 A specific syntax must be followed when creating conditionals and loops. Each conditional statement must be followed by a `bracket()` method, which will contain code. Here's an example:
 
@@ -404,7 +405,6 @@ t.else_()
 t.bracket(
     t.player_action('ActionBar', 'in the air')
 )
-t.build()
 ```
 
 ### Loops
@@ -444,6 +444,19 @@ t = DFTemplate()
 t.player_event('Join')
 t.call_function('doStuff')
 ```
+
+### Editing Tags
+You can edit an action's tags by passing the `tags` argument to a template method:
+
+```py
+from dfpyre import *
+t = DFTemplate()
+t.player_event('Join')
+t.player_action('SendMessage', 'hello', tags={'Alignment Mode': 'Centered'})
+```
+
+If you choose not to modify a specific tag, its default value will be used.
+Order does not matter when adding multiple tag entries.
  
 ### Importing from Code
 

{dfpyre-0.6.3 → dfpyre-0.7.0}/README.md

@@ -52,6 +52,7 @@ pip install dfpyre
 
 ## Extras
 
+- [Editing Tags](#editing-tags)
 - [Importing from Code](#importing-from-code)
 - [Script Generation](#script-generation)
 - [Method List](#method-list)
@@ -356,7 +357,7 @@ t.player_action('SendMessage', 'Hello, ', var('name', 'line'))
 
 ### Conditionals and Brackets
 
-A list of conditionals and loops can be found [here](#commands).
+A list of conditionals and loops can be found [here](#method-list).
 
 A specific syntax must be followed when creating conditionals and loops. Each conditional statement must be followed by a `bracket()` method, which will contain code. Here's an example:
 
@@ -386,7 +387,6 @@ t.else_()
 t.bracket(
     t.player_action('ActionBar', 'in the air')
 )
-t.build()
 ```
 
 ### Loops
@@ -426,6 +426,19 @@ t = DFTemplate()
 t.player_event('Join')
 t.call_function('doStuff')
 ```
+
+### Editing Tags
+You can edit an action's tags by passing the `tags` argument to a template method:
+
+```py
+from dfpyre import *
+t = DFTemplate()
+t.player_event('Join')
+t.player_action('SendMessage', 'hello', tags={'Alignment Mode': 'Centered'})
+```
+
+If you choose not to modify a specific tag, its default value will be used.
+Order does not matter when adding multiple tag entries.
  
 ### Importing from Code
 

dfpyre-0.7.0/dfpyre/actiondump.py

@@ -0,0 +1,72 @@
+import os
+import json
+from dfpyre.util import warn
+
+
+ACTIONDUMP_PATH = os.path.join(os.path.dirname(__file__), 'data/actiondump_min.json')
+
+CODEBLOCK_NAME_LOOKUP = {
+    'PLAYER ACTION': 'player_action',
+    'ENTITY ACTION': 'entity_action',
+    'GAME ACTION': 'game_action',
+    'SET VARIABLE': 'set_var',
+    'IF PLAYER': 'if_player',
+    'IF ENTITY': 'if_entity',
+    'IF GAME': 'if_game',
+    'IF VARIABLE': 'if_var',
+    'REPEAT': 'repeat',
+    'SELECT OBJECT': 'select_object',
+    'CONTROL': 'control',
+    'PLAYER EVENT': 'event',
+    'ENTITY EVENT': 'entity_event',
+    'FUNCTION': 'func',
+    'CALL FUNCTION': 'call_func',
+    'PROCESS': 'process',
+    'START PROCESS': 'start_process',
+}
+
+
+def get_action_tags(action_data: dict) -> list[dict]:
+    action_tags = []
+    for tag_data in action_data['tags']:
+        options = [o['name'] for o in tag_data['options']]
+        converted_tag_data = {
+            'name': tag_data['name'],
+            'options': options,
+            'default': tag_data['defaultOption'],
+            'slot': tag_data['slot']
+        }
+        action_tags.append(converted_tag_data)
+    return action_tags
+
+
+def parse_actiondump():
+    codeblock_data = {n: {} for n in CODEBLOCK_NAME_LOOKUP.values()}
+    codeblock_data['else'] = {'tags': []}
+
+    if not os.path.exists(ACTIONDUMP_PATH):
+        warn('data.json not found -- Item tags and error checking will not work.')
+        return {}, set()
+    
+    with open(ACTIONDUMP_PATH, 'r', encoding='utf-8') as f:
+        actiondump = json.loads(f.read())
+    
+    for action_data in actiondump['actions']:
+        action_tags = get_action_tags(action_data)
+        parsed_action_data = {'tags': action_tags}
+        if dep_note := action_data['icon']['deprecatedNote']:
+            parsed_action_data['deprecatedNote'] = ' '.join(dep_note)
+        
+        codeblock_name = CODEBLOCK_NAME_LOOKUP[action_data['codeblockName']]
+        codeblock_data[codeblock_name][action_data['name']] = parsed_action_data
+    
+    return codeblock_data
+
+
+def get_default_tags(codeblock_type: str|None, codeblock_action: str|None) -> dict[str, str]:
+    if codeblock_type is None or codeblock_action is None:
+        return {}
+    return {t['name']: t['default'] for t in CODEBLOCK_DATA[codeblock_type][codeblock_action]['tags']}
+
+
+CODEBLOCK_DATA = parse_actiondump()