fake-bpy-module 20250612__py3-none-any.whl → 20260118__py3-none-any.whl

bpy/ops/armature/__init__.pyi

@@ -4,12 +4,12 @@ import typing_extensions
 import numpy.typing as npt
 import bpy.ops.transform
 
-def align(execution_context: int | str | None = None, undo: bool | None = None) -> None:
-    """Align selected bones to the active bone (or to their parent)
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+def align(
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
+) -> None:
+    """Align selected bones to the active bone (or to their parent)"""
 
 def assign_to_collection(
     execution_context: int | str | None = None,
@@ -21,12 +21,8 @@ def assign_to_collection(
 ) -> None:
     """Assign all selected bones to a collection, or unassign them, depending on whether the active bone is already assigned or not
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param collection_index: Collection Index, Index of the collection to assign selected bones to. When the operator should create a new bone collection, use new_collection_name to define the collection name, and set this parameter to the parent index of the new bone collection
-    :type collection_index: int | None
     :param new_collection_name: Name, Name of a to-be-added bone collection. Only pass this if you want to create a new bone collection and assign the selected bones to it. To assign to an existing collection, do not include this parameter and use collection_index
-    :type new_collection_name: str
     """
 
 def autoside_names(
@@ -38,8 +34,6 @@ def autoside_names(
 ) -> None:
     """Automatically renames the selected bones according to which side of the target axis they fall on
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param type: Axis, Axis to tag names with
 
     XAXIS
@@ -50,7 +44,6 @@ def autoside_names(
 
     ZAXIS
     Z-Axis -- Top/Bottom.
-        :type type: typing.Literal['XAXIS','YAXIS','ZAXIS'] | None
     """
 
 def bone_primitive_add(
@@ -58,14 +51,11 @@ def bone_primitive_add(
     undo: bool | None = None,
     /,
     *,
-    name: str = "",
+    name: str = "Bone",
 ) -> None:
     """Add a new bone located at the 3D cursor
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param name: Name, Name of the newly created bone
-    :type name: str
     """
 
 def calculate_roll(
@@ -92,35 +82,26 @@ def calculate_roll(
     axis_flip: bool | None = False,
     axis_only: bool | None = False,
 ) -> None:
-    """Automatically fix alignment of select bones' axes
+    """Automatically fix alignment of select bones axes
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param type: Type
-    :type type: typing.Literal['POS_X','POS_Z','GLOBAL_POS_X','GLOBAL_POS_Y','GLOBAL_POS_Z','NEG_X','NEG_Z','GLOBAL_NEG_X','GLOBAL_NEG_Y','GLOBAL_NEG_Z','ACTIVE','VIEW','CURSOR'] | None
     :param axis_flip: Flip Axis, Negate the alignment axis
-    :type axis_flip: bool | None
     :param axis_only: Shortest Rotation, Ignore the axis direction, use the shortest rotation to align
-    :type axis_only: bool | None
     """
 
 def click_extrude(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Create a new bone going from the last selected joint to the mouse position
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Create a new bone going from the last selected joint to the mouse position"""
 
 def collection_add(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Add a new bone collection
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Add a new bone collection"""
 
 def collection_assign(
     execution_context: int | str | None = None,
@@ -131,10 +112,7 @@ def collection_assign(
 ) -> None:
     """Add selected bones to the chosen bone collection
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param name: Bone Collection, Name of the bone collection to assign this bone to; empty to assign to the active bone collection
-    :type name: str
     """
 
 def collection_create_and_assign(
@@ -146,20 +124,15 @@ def collection_create_and_assign(
 ) -> None:
     """Create a new bone collection and assign all selected bones
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param name: Bone Collection, Name of the bone collection to create
-    :type name: str
     """
 
 def collection_deselect(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Deselect bones of active Bone Collection
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Deselect bones of active Bone Collection"""
 
 def collection_move(
     execution_context: int | str | None = None,
@@ -170,47 +143,36 @@ def collection_move(
 ) -> None:
     """Change position of active Bone Collection in list of Bone collections
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param direction: Direction, Direction to move the active Bone Collection towards
-    :type direction: typing.Literal['UP','DOWN'] | None
     """
 
 def collection_remove(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Remove the active bone collection
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Remove the active bone collection"""
 
 def collection_remove_unused(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Remove all bone collections that have neither bones nor children. This is done recursively, so bone collections that only have unused children are also removed
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Remove all bone collections that have neither bones nor children. This is done recursively, so bone collections that only have unused children are also removed"""
 
 def collection_select(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Select bones in active Bone Collection
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Select bones in active Bone Collection"""
 
 def collection_show_all(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Show all bone collections
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Show all bone collections"""
 
 def collection_unassign(
     execution_context: int | str | None = None,
@@ -221,10 +183,7 @@ def collection_unassign(
 ) -> None:
     """Remove selected bones from the active bone collection
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param name: Bone Collection, Name of the bone collection to unassign this bone from; empty to unassign from the active bone collection
-    :type name: str
     """
 
 def collection_unassign_named(
@@ -237,22 +196,16 @@ def collection_unassign_named(
 ) -> None:
     """Unassign the named bone from this bone collection
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param name: Bone Collection, Name of the bone collection to unassign this bone from; empty to unassign from the active bone collection
-    :type name: str
     :param bone_name: Bone Name, Name of the bone to unassign from the collection; empty to use the active bone
-    :type bone_name: str
     """
 
 def collection_unsolo_all(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Clear the 'solo' setting on all bone collections
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Clear the solo setting on all bone collections"""
 
 def copy_bone_color_to_selected(
     execution_context: int | str | None = None,
@@ -263,8 +216,6 @@ def copy_bone_color_to_selected(
 ) -> None:
     """Copy the bone color of the active bone to all selected bones
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param bone_type: Type
 
     EDIT
@@ -272,7 +223,6 @@ def copy_bone_color_to_selected(
 
     POSE
     Pose Bone -- Copy Pose Bone colors from the active pose bone to all selected pose bones.
-        :type bone_type: typing.Literal['EDIT','POSE'] | None
     """
 
 def delete(
@@ -284,20 +234,15 @@ def delete(
 ) -> None:
     """Remove selected bones from the armature
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param confirm: Confirm, Prompt for confirmation
-    :type confirm: bool | None
     """
 
 def dissolve(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Dissolve selected bones from the armature
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Dissolve selected bones from the armature"""
 
 def duplicate(
     execution_context: int | str | None = None,
@@ -308,10 +253,7 @@ def duplicate(
 ) -> None:
     """Make copies of the selected bones within the same armature
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param do_flip_names: Flip Names, Try to flip names of the bones, if possible, instead of adding a number extension
-    :type do_flip_names: bool | None
     """
 
 def duplicate_move(
@@ -324,12 +266,8 @@ def duplicate_move(
 ) -> None:
     """Make copies of the selected bones within the same armature and move them
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param ARMATURE_OT_duplicate: Duplicate Selected Bone(s), Make copies of the selected bones within the same armature
-    :type ARMATURE_OT_duplicate: duplicate | None
     :param TRANSFORM_OT_translate: Move, Move selected items
-    :type TRANSFORM_OT_translate: bpy.ops.transform.translate | None
     """
 
 def extrude(
@@ -341,10 +279,7 @@ def extrude(
 ) -> None:
     """Create new bones from the selected joints
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param forked: Forked
-    :type forked: bool | None
     """
 
 def extrude_forked(
@@ -357,12 +292,8 @@ def extrude_forked(
 ) -> None:
     """Create new bones from the selected joints and move them
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param ARMATURE_OT_extrude: Extrude, Create new bones from the selected joints
-    :type ARMATURE_OT_extrude: extrude | None
     :param TRANSFORM_OT_translate: Move, Move selected items
-    :type TRANSFORM_OT_translate: bpy.ops.transform.translate | None
     """
 
 def extrude_move(
@@ -375,20 +306,16 @@ def extrude_move(
 ) -> None:
     """Create new bones from the selected joints and move them
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param ARMATURE_OT_extrude: Extrude, Create new bones from the selected joints
-    :type ARMATURE_OT_extrude: extrude | None
     :param TRANSFORM_OT_translate: Move, Move selected items
-    :type TRANSFORM_OT_translate: bpy.ops.transform.translate | None
     """
 
-def fill(execution_context: int | str | None = None, undo: bool | None = None) -> None:
-    """Add bone between selected joint(s) and/or 3D cursor
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+def fill(
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
+) -> None:
+    """Add bone between selected joint(s) and/or 3D cursor"""
 
 def flip_names(
     execution_context: int | str | None = None,
@@ -399,10 +326,7 @@ def flip_names(
 ) -> None:
     """Flips (and corrects) the axis suffixes of the names of selected bones
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param do_strip_numbers: Strip Numbers, Try to remove right-most dot-number from flipped names.Warning: May result in incoherent naming in some cases
-    :type do_strip_numbers: bool | None
     """
 
 def hide(
@@ -414,10 +338,7 @@ def hide(
 ) -> None:
     """Tag selected bones to not be visible in Edit Mode
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param unselected: Unselected, Hide unselected rather than selected
-    :type unselected: bool | None
     """
 
 def move_to_collection(
@@ -430,12 +351,8 @@ def move_to_collection(
 ) -> None:
     """Move bones to a collection
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param collection_index: Collection Index, Index of the collection to move selected bones to. When the operator should create a new bone collection, do not include this parameter and pass new_collection_name
-    :type collection_index: int | None
     :param new_collection_name: Name, Name of a to-be-added bone collection. Only pass this if you want to create a new bone collection and move the selected bones to it. To move to an existing collection, do not include this parameter and use collection_index
-    :type new_collection_name: str
     """
 
 def parent_clear(
@@ -447,10 +364,7 @@ def parent_clear(
 ) -> None:
     """Remove the parent-child relationship between selected bones and their parents
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param type: Clear Type, What way to clear parenting
-    :type type: typing.Literal['CLEAR','DISCONNECT'] | None
     """
 
 def parent_set(
@@ -462,10 +376,7 @@ def parent_set(
 ) -> None:
     """Set the active bone as the parent of the selected bones
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param type: Parent Type, Type of parenting
-    :type type: typing.Literal['CONNECTED','OFFSET'] | None
     """
 
 def reveal(
@@ -477,10 +388,7 @@ def reveal(
 ) -> None:
     """Reveal all bones hidden in Edit Mode
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param select: Select
-    :type select: bool | None
     """
 
 def roll_clear(
@@ -492,10 +400,7 @@ def roll_clear(
 ) -> None:
     """Clear roll for selected bones
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param roll: Roll
-    :type roll: float | None
     """
 
 def select_all(
@@ -507,8 +412,6 @@ def select_all(
 ) -> None:
     """Toggle selection status of all bones
 
-        :type execution_context: int | str | None
-        :type undo: bool | None
         :param action: Action, Selection action to execute
 
     TOGGLE
@@ -522,7 +425,6 @@ def select_all(
 
     INVERT
     Invert -- Invert selection of all elements.
-        :type action: typing.Literal['TOGGLE','SELECT','DESELECT','INVERT'] | None
     """
 
 def select_hierarchy(
@@ -535,22 +437,16 @@ def select_hierarchy(
 ) -> None:
     """Select immediate parent/children of selected bones
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param direction: Direction
-    :type direction: typing.Literal['PARENT','CHILD'] | None
     :param extend: Extend, Extend the selection
-    :type extend: bool | None
     """
 
 def select_less(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Deselect those bones at the boundary of each selection region
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Deselect those bones at the boundary of each selection region"""
 
 def select_linked(
     execution_context: int | str | None = None,
@@ -561,10 +457,7 @@ def select_linked(
 ) -> None:
     """Select all bones linked by parent/child connections to the current selection
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param all_forks: All Forks, Follow forks in the parents chain
-    :type all_forks: bool | None
     """
 
 def select_linked_pick(
@@ -577,12 +470,8 @@ def select_linked_pick(
 ) -> None:
     """(De)select bones linked by parent/child connections under the mouse cursor
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param deselect: Deselect
-    :type deselect: bool | None
     :param all_forks: All Forks, Follow forks in the parents chain
-    :type all_forks: bool | None
     """
 
 def select_mirror(
@@ -595,22 +484,16 @@ def select_mirror(
 ) -> None:
     """Mirror the bone selection
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param only_active: Active Only, Only operate on the active bone
-    :type only_active: bool | None
     :param extend: Extend, Extend the selection
-    :type extend: bool | None
     """
 
 def select_more(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Select those bones connected to the initial selection
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Select those bones connected to the initial selection"""
 
 def select_similar(
     execution_context: int | str | None = None,
@@ -634,38 +517,30 @@ def select_similar(
 ) -> None:
     """Select similar bones by property types
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param type: Type
-    :type type: typing.Literal['CHILDREN','CHILDREN_IMMEDIATE','SIBLINGS','LENGTH','DIRECTION','PREFIX','SUFFIX','BONE_COLLECTION','COLOR','SHAPE'] | None
     :param threshold: Threshold
-    :type threshold: float | None
     """
 
 def separate(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Isolate selected bones into a separate armature
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Isolate selected bones into a separate armature"""
 
 def shortest_path_pick(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Select shortest path between two bones
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Select shortest path between two bones"""
 
-def split(execution_context: int | str | None = None, undo: bool | None = None) -> None:
-    """Split off selected bones from connected unselected bones
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+def split(
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
+) -> None:
+    """Split off selected bones from connected unselected bones"""
 
 def subdivide(
     execution_context: int | str | None = None,
@@ -676,20 +551,15 @@ def subdivide(
 ) -> None:
     """Break selected bones into chains of smaller bones
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param number_cuts: Number of Cuts
-    :type number_cuts: int | None
     """
 
 def switch_direction(
-    execution_context: int | str | None = None, undo: bool | None = None
+    execution_context: int | str | None = None,
+    undo: bool | None = None,
+    /,
 ) -> None:
-    """Change the direction that a chain of bones points in (head and tail swap)
-
-    :type execution_context: int | str | None
-    :type undo: bool | None
-    """
+    """Change the direction that a chain of bones points in (head and tail swap)"""
 
 def symmetrize(
     execution_context: int | str | None = None,
@@ -697,11 +567,10 @@ def symmetrize(
     /,
     *,
     direction: typing.Literal["NEGATIVE_X", "POSITIVE_X"] | None = "NEGATIVE_X",
+    copy_bone_colors: bool | None = False,
 ) -> None:
     """Enforce symmetry, make copies of the selection or use existing
 
-    :type execution_context: int | str | None
-    :type undo: bool | None
     :param direction: Direction, Which sides to copy from and to (when both are selected)
-    :type direction: typing.Literal['NEGATIVE_X','POSITIVE_X'] | None
+    :param copy_bone_colors: Bone Colors, Copy colors to existing bones
     """