dfpyre 0.8.2__py3-none-any.whl → 0.8.4__py3-none-any.whl

dfpyre/items.py

@@ -7,7 +7,7 @@ import re
 from typing import Literal, Any
 from dfpyre.style import is_ampersand_coded, ampersand_to_minimessage
 from dfpyre.util import PyreException, warn
-from mcitemlib.itemlib import Item as NbtItem
+from mcitemlib.itemlib import Item as NbtItem, MCItemlibException
 
 
 NUMBER_REGEX = r'^-?\d*\.?\d+$'
@@ -32,21 +32,6 @@ def _add_slot(d: dict, slot: int|None):
         d['slot'] = slot
 
 
-class Item(NbtItem):
-    """
-    Represents a Minecraft item.
-    """
-    type = 'item'
-
-    def format(self, slot: int|None):
-        formatted_dict = {"item": {"id": self.type, "data": {"item": self.get_nbt()}}}
-        _add_slot(formatted_dict, slot)
-        return formatted_dict
-
-    def __repr__(self) -> str:
-        return f'{self.__class__.__name__}({self.get_id()}, {self.get_count()})'
-
-
 class String:
     """
     Represents a DiamondFire string object. (`txt`)
@@ -107,6 +92,71 @@ class Number:
 Num = Number  # Number alias
 
 
+class Item(NbtItem):
+    """
+    Represents a Minecraft item.
+    """
+    type = 'item'
+
+    def format(self, slot: int|None):
+        formatted_dict = {"item": {"id": self.type, "data": {"item": self.get_nbt()}}}
+        _add_slot(formatted_dict, slot)
+        return formatted_dict
+
+    def __repr__(self) -> str:
+        return f'{self.__class__.__name__}({self.get_id()}, {self.get_count()})'
+    
+    def set_tag(self, tag_name: str, tag_value: str|int|float|String|Number):
+        """
+        Add a DiamondFire custom tag to this item.
+        """
+        if isinstance(tag_value, String):
+            tag_value = tag_value.value
+        elif isinstance(tag_value, Number):
+            tag_value = float(tag_value.value)
+        elif isinstance(tag_value, int):
+            tag_value = float(tag_value)
+        
+        try:
+            item_tags = self.get_custom_data('PublicBukkitValues')
+        except MCItemlibException:
+            item_tags = {}
+        
+        item_tags[f'hypercube:{tag_name}'] = tag_value
+        self.set_custom_data('PublicBukkitValues', item_tags)
+    
+    def get_tag(self, tag_name: str) -> str|float|None:
+        """
+        Get a DiamondFire custom tag from this item.
+        """
+        try:
+            item_tags = self.get_custom_data('PublicBukkitValues')
+        except MCItemlibException:
+            return None
+        
+        try:
+            return item_tags[f'hypercube:{tag_name}']
+        except KeyError:
+            return None
+    
+    def remove_tag(self, tag_name: str) -> bool:
+        """
+        Remove a DiamondFire custom tag from this item.
+
+        :return: `True` on success, `False` on fail
+        """
+        try:
+            item_tags = self.get_custom_data('PublicBukkitValues')
+        except MCItemlibException:
+            return False
+
+        try:
+            del item_tags[f'hypercube:{tag_name}']
+            return True
+        except KeyError:
+            return False
+
+
 class Location:
     """
     Represents a DiamondFire location object.
@@ -335,7 +385,7 @@ class Parameter:
         return f'{self.__class__.__name__}({self.name}, type: {raw_type})'
 
 
-def item_from_dict(item_dict: dict) -> object:
+def item_from_dict(item_dict: dict) -> Any:
     item_id = item_dict['id']
     item_data = item_dict['data']
 

dfpyre/pyre.py

@@ -291,6 +291,8 @@ class DFTemplate:
             else:
                 self.codeblocks[index:index+len(insert_codeblocks)] = insert_codeblocks
         elif isinstance(insert_codeblocks, CodeBlock):
+            if index == -1:
+                index = len(self.codeblocks)
             self.codeblocks.insert(index, insert_codeblocks)
         else:
             raise PyreException('Expected CodeBlock or list[CodeBlock] to insert.')

{dfpyre-0.8.2.dist-info → dfpyre-0.8.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dfpyre
-Version: 0.8.2
+Version: 0.8.4
 Summary: A package for creating and modifying code templates for the DiamondFire Minecraft server.
 Home-page: https://github.com/Amp63/pyre
 License: MIT
@@ -39,8 +39,10 @@ This module works best with [CodeClient](https://modrinth.com/mod/codeclient) in
 - All code item types
 - Direct sending to DF via recode or codeclient
 - Automatic type conversion (int to num, str to text)
+- Auto completed action names (if your IDE supports type hints)
 - Warnings for unrecognized actions and tags
-- Full tag support
+- Shorthand format for variables
+- Convert existing templates into equivalent Python code (see [Script Generation](#script-generation))
 
 ## Documentation
 ## Basics
@@ -485,6 +487,21 @@ t.generate_script('my_template.py')    # generated python script will be written
 
 This feature is useful for getting a text representation of existing templates.
 
+
+### Inserting Codeblocks
+
+Use the `insert` method to insert additional codeblocks into an existing template. By default, codeblocks will be added to the end of the template.
+
+```py
+from dfpyre import *
+
+my_template = player_event('Join', [
+  player_action('SendMessage', '%default has joined!', target=Target.ALL_PLAYERS)
+])
+my_template.insert(player_action('SendMessage', 'Welcome!'))  # Add a new codeblock to the end
+```
+
+
 ### Function List
 
 - **Events / Function / Process**
@@ -500,7 +517,7 @@ This feature is useful for getting a text representation of existing templates.
   - game_action
   - entity_action
 
-- **Conditionals / Loops**
+- **Control Flow**
   - if_player
   - if_variable
   - if_game

{dfpyre-0.8.2.dist-info → dfpyre-0.8.4.dist-info}/RECORD

@@ -2,12 +2,12 @@ dfpyre/__init__.py,sha256=apPsSxJ1Tztfl71MoORoSmDfX7LyKLYlLwOGeLQUitw,25
 dfpyre/action_literals.py,sha256=jvI3ZI1_rnDqS58q5Z0_bb5jgKJ2pu_pgN-1whXpEDQ,16212
 dfpyre/actiondump.py,sha256=MVI1kVJBNpab882Tgqo-xtemiBN2W1_2OcopBcRupWQ,2587
 dfpyre/data/actiondump_min.json,sha256=hFcIbG_G55FWwqRSW6X77ZrKkQiXLs4CGgJrZgyR2Gg,1938799
-dfpyre/items.py,sha256=fNcgX6oHc8F65Aj6TCC8BE0XhGsOmrLnPVcSZB3oPB0,11662
-dfpyre/pyre.py,sha256=DM7QuLIPMRlHh13frzyx__6t-Auvx3yOjr2wiXRXzsI,24494
+dfpyre/items.py,sha256=4FWCCAfJ2Wc6JqwTJFy_V-mwJXdT7b831AdGZpEftNw,13237
+dfpyre/pyre.py,sha256=NOBcllwx1RiUJhAf-bqGRN7Z9046nKm2efBJsddLgow,24567
 dfpyre/scriptgen.py,sha256=X0GeH3DYJXXuXEF3Jj5joBu-MC94L2oswGCU1IlhToQ,7589
 dfpyre/style.py,sha256=mLW1CFvvi8_9fk8JaH10I5S4WI0YBdQIXHtI3G_4sR8,980
 dfpyre/util.py,sha256=EpX4XGwwX0A9MlObuQTEuHj4Q-55wj29m8am8ULPmz8,791
-dfpyre-0.8.2.dist-info/LICENSE,sha256=_vuDskB0ja2c-Fgm7Gt8Q8cO9NsLNpZAVyvmZwX7E6o,1060
-dfpyre-0.8.2.dist-info/METADATA,sha256=tbmPOL3dSlog2RVTj7_PcWG4Wf0TbA-0JvCZ1sNgrtY,11335
-dfpyre-0.8.2.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
-dfpyre-0.8.2.dist-info/RECORD,,
+dfpyre-0.8.4.dist-info/LICENSE,sha256=_vuDskB0ja2c-Fgm7Gt8Q8cO9NsLNpZAVyvmZwX7E6o,1060
+dfpyre-0.8.4.dist-info/METADATA,sha256=SHapZvjDxoyORZCttqBVKwah-PkSRxnmVzko97vdEww,11935
+dfpyre-0.8.4.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+dfpyre-0.8.4.dist-info/RECORD,,