fake-bpy-module 20240210__py3-none-any.whl → 20240326__py3-none-any.whl

bpy_extras/io_utils/__init__.pyi

@@ -1,56 +1,91 @@
-import sys
 import typing
 import bpy.types
 
 GenericType = typing.TypeVar("GenericType")
 
 class ExportHelper:
-    def check(self, _context): ...
-    def invoke(self, context, _event): ...
+    """ """
+
+    def check(self, _context):
+        """
+
+        :param _context:
+        """
+        ...
+
+    def invoke(self, context, _event):
+        """
+
+        :param context:
+        :param _event:
+        """
+        ...
 
 class ImportHelper:
-    def check(self, _context): ...
-    def invoke(self, context, _event): ...
+    """ """
+
+    def check(self, _context):
+        """
+
+        :param _context:
+        """
+        ...
+
+    def invoke(self, context, _event):
+        """
+
+        :param context:
+        :param _event:
+        """
+        ...
 
 def axis_conversion(from_forward="Y", from_up="Z", to_forward="Y", to_up="Z"):
-    """Each argument us an axis in ['X', 'Y', 'Z', '-X', '-Y', '-Z'] where the first 2 are a source and the second 2 are the target."""
+    """Each argument us an axis in ['X', 'Y', 'Z', '-X', '-Y', '-Z']
+    where the first 2 are a source and the second 2 are the target.
+
+    """
 
     ...
 
 def axis_conversion_ensure(
-    operator: "bpy.types.Operator", forward_attr: str, up_attr: str
+    operator: bpy.types.Operator, forward_attr: str, up_attr: str
 ) -> bool:
-    """Function to ensure an operator has valid axis conversion settings, intended to be used from `bpy.types.Operator.check`.
-
-    :param operator: the operator to access axis attributes from.
-    :type operator: 'bpy.types.Operator'
-    :param forward_attr: attribute storing the forward axis
-    :type forward_attr: str
-    :param up_attr: attribute storing the up axis
-    :type up_attr: str
-    :rtype: bool
-    :return: True if the value was modified.
+    """Function to ensure an operator has valid axis conversion settings, intended
+    to be used from `bpy.types.Operator.check`.
+
+        :param operator: the operator to access axis attributes from.
+        :type operator: bpy.types.Operator
+        :param forward_attr: attribute storing the forward axis
+        :type forward_attr: str
+        :param up_attr: attribute storing the up axis
+        :type up_attr: str
+        :return: True if the value was modified.
+        :rtype: bool
     """
 
     ...
 
 def create_derived_objects(
-    depsgraph: "bpy.types.Depsgraph", objects: typing.Iterable["bpy.types.Object"]
-) -> typing.Dict:
+    depsgraph: bpy.types.Depsgraph, objects: typing.Iterable[bpy.types.Object]
+) -> dict:
     """This function takes a sequence of objects, returning their instances.
 
-    :param depsgraph: The evaluated depsgraph.
-    :type depsgraph: 'bpy.types.Depsgraph'
-    :param objects: A sequencer of objects.
-    :type objects: typing.Iterable['bpy.types.Object']
-    :rtype: typing.Dict
-    :return: A dictionary where each key is an object from `objects`, values are lists of (`bpy.types.Object`, `mathutils.Matrix`) tuples representing instances.
+        :param depsgraph: The evaluated depsgraph.
+        :type depsgraph: bpy.types.Depsgraph
+        :param objects: A sequencer of objects.
+        :type objects: typing.Iterable[bpy.types.Object]
+        :return: A dictionary where each key is an object from objects,
+    values are lists of (`bpy.types.Object`, `mathutils.Matrix`) tuples representing instances.
+        :rtype: dict
     """
 
     ...
 
 def orientation_helper(axis_forward="Y", axis_up="Z"):
-    """A decorator for import/export classes, generating properties needed by the axis conversion system and IO helpers, with specified default values (axes)."""
+    """A decorator for import/export classes, generating properties needed by the axis conversion system and IO helpers,
+    with specified default values (axes).
+
+    """
 
     ...
 
@@ -60,38 +95,41 @@ def path_reference(
     base_dst: str,
     mode: str = "AUTO",
     copy_subdir: str = "",
-    copy_set: typing.Set = None,
-    library: typing.Optional["bpy.types.Library"] = None,
+    copy_set: set = None,
+    library=None,
 ) -> str:
-    """Return a filepath relative to a destination directory, for use with exporters.
-
-    :param filepath: the file path to return, supporting blenders relative '//' prefix.
-    :type filepath: str
-    :param base_src: the directory the *filepath* is relative too (normally the blend file).
-    :type base_src: str
-    :param base_dst: the directory the *filepath* will be referenced from (normally the export path).
-    :type base_dst: str
-    :param mode: the method used get the path in ['AUTO', 'ABSOLUTE', 'RELATIVE', 'MATCH', 'STRIP', 'COPY']
-    :type mode: str
-    :param copy_subdir: the subdirectory of *base_dst* to use when mode='COPY'.
-    :type copy_subdir: str
-    :param copy_set: collect from/to pairs when mode='COPY', pass to *path_reference_copy* when exporting is done.
-    :type copy_set: typing.Set
-    :param library: The library this path is relative to.
-    :type library: typing.Optional['bpy.types.Library']
-    :rtype: str
-    :return: the new filepath.
+    """Return a filepath relative to a destination directory, for use with
+    exporters.
+
+        :param filepath: the file path to return,
+    supporting blenders relative '//' prefix.
+        :type filepath: str
+        :param base_src: the directory the filepath is relative too
+    (normally the blend file).
+        :type base_src: str
+        :param base_dst: the directory the filepath will be referenced from
+    (normally the export path).
+        :type base_dst: str
+        :param mode: the method used get the path in
+    ['AUTO', 'ABSOLUTE', 'RELATIVE', 'MATCH', 'STRIP', 'COPY']
+        :type mode: str
+        :param copy_subdir: the subdirectory of base_dst to use when mode='COPY'.
+        :type copy_subdir: str
+        :param copy_set: collect from/to pairs when mode='COPY',
+    pass to path_reference_copy when exporting is done.
+        :type copy_set: set
+        :param library: The library this path is relative to.
+        :return: the new filepath.
+        :rtype: str
     """
 
     ...
 
-def path_reference_copy(
-    copy_set: typing.Set, report: typing.Any = "<built-in function print>"
-):
+def path_reference_copy(copy_set: set, report: typing.Any = None):
     """Execute copying files of path_reference
 
     :param copy_set: set of (from, to) pairs to copy.
-    :type copy_set: typing.Set
+    :type copy_set: set
     :param report: function used for reporting warnings, takes a string argument.
     :type report: typing.Any
     """
@@ -99,28 +137,40 @@ def path_reference_copy(
     ...
 
 def unique_name(
-    key: typing.Any,
+    key,
     name: str,
-    name_dict: typing.Dict,
+    name_dict: dict,
     name_max=-1,
     clean_func: typing.Any = None,
     sep: str = ".",
 ):
-    """Helper function for storing unique names which may have special characters stripped and restricted to a maximum length.
-
-    :param key: unique item this name belongs to, name_dict[key] will be reused when available. This can be the object, mesh, material, etc instance itself.
-    :type key: typing.Any
-    :param name: The name used to create a unique value in *name_dict*.
-    :type name: str
-    :param name_dict: This is used to cache namespace to ensure no collisions occur, this should be an empty dict initially and only modified by this function.
-    :type name_dict: typing.Dict
-    :param clean_func: Function to call on *name* before creating a unique value.
-    :type clean_func: typing.Any
-    :param sep: Separator to use when between the name and a number when a duplicate name is found.
-    :type sep: str
+    """Helper function for storing unique names which may have special characters
+    stripped and restricted to a maximum length.
+
+        :param key: unique item this name belongs to, name_dict[key] will be reused
+    when available.
+    This can be the object, mesh, material, etc instance itself.
+        :param name: The name used to create a unique value in name_dict.
+        :type name: str
+        :param name_dict: This is used to cache namespace to ensure no collisions
+    occur, this should be an empty dict initially and only modified by this
+    function.
+        :type name_dict: dict
+        :param clean_func: Function to call on name before creating a unique value.
+        :type clean_func: typing.Any
+        :param sep: Separator to use when between the name and a number when a
+    duplicate name is found.
+        :type sep: str
     """
 
     ...
 
-def unpack_face_list(list_of_tuples): ...
-def unpack_list(list_of_tuples): ...
+def unpack_face_list(list_of_tuples):
+    """ """
+
+    ...
+
+def unpack_list(list_of_tuples):
+    """ """
+
+    ...

bpy_extras/keyconfig_utils/__init__.pyi

@@ -1,10 +1,9 @@
-import sys
 import typing
 
 GenericType = typing.TypeVar("GenericType")
 
 def addon_keymap_register(keymap_data):
-    """Register a set of keymaps for addons using a list of keymaps. See 'blender_defaults.py' for examples of the format this takes."""
+    """Register a set of keymaps for addons using a list of keymaps.See 'blender_defaults.py' for examples of the format this takes."""
 
     ...
 
@@ -13,4 +12,7 @@ def addon_keymap_unregister(keymap_data):
 
     ...
 
-def keyconfig_test(kc): ...
+def keyconfig_test(kc):
+    """ """
+
+    ...

bpy_extras/mesh_utils/__init__.pyi

@@ -1,85 +1,93 @@
-import sys
 import typing
 import bpy.types
 
 GenericType = typing.TypeVar("GenericType")
 
-def edge_face_count(mesh) -> typing.List:
+def edge_face_count(mesh) -> list:
     """
 
-    :rtype: typing.List
     :return: list face users for each item in mesh.edges.
+    :rtype: list
     """
 
     ...
 
-def edge_face_count_dict(mesh) -> typing.Dict:
+def edge_face_count_dict(mesh) -> dict:
     """
 
-    :rtype: typing.Dict
-    :return: dict of edge keys with their value set to the number of faces using each edge.
+        :return: dict of edge keys with their value set to the number of
+    faces using each edge.
+        :rtype: dict
     """
 
     ...
 
 def edge_loops_from_edges(mesh, edges=None):
-    """Edge loops defined by edges Takes me.edges or a list of edges and returns the edge loops return a list of vertex indices. [ [1, 6, 7, 2], ...] closed loops have matching start and end values."""
+    """Edge loops defined by edgesTakes me.edges or a list of edges and returns the edge loopsreturn a list of vertex indices.
+    [ [1, 6, 7, 2], ...]closed loops have matching start and end values.
+
+    """
 
     ...
 
-def mesh_linked_triangles(mesh: "bpy.types.Mesh") -> typing.List:
-    """Splits the mesh into connected triangles, use this for separating cubes from other mesh elements within 1 mesh datablock.
+def mesh_linked_triangles(mesh: bpy.types.Mesh) -> list:
+    """Splits the mesh into connected triangles, use this for separating cubes from
+    other mesh elements within 1 mesh datablock.
 
-    :param mesh: the mesh used to group with.
-    :type mesh: 'bpy.types.Mesh'
-    :rtype: typing.List
-    :return: lists of lists containing triangles.
+        :param mesh: the mesh used to group with.
+        :type mesh: bpy.types.Mesh
+        :return: lists of lists containing triangles.
+        :rtype: list
     """
 
     ...
 
-def mesh_linked_uv_islands(mesh: "bpy.types.Mesh") -> typing.List:
+def mesh_linked_uv_islands(mesh: bpy.types.Mesh) -> list:
     """Returns lists of polygon indices connected by UV islands.
 
     :param mesh: the mesh used to group with.
-    :type mesh: 'bpy.types.Mesh'
-    :rtype: typing.List
+    :type mesh: bpy.types.Mesh
     :return: list of lists containing polygon indices
+    :rtype: list
     """
 
     ...
 
 def ngon_tessellate(
-    from_data: typing.Union[typing.List, "bpy.types.Mesh"],
-    indices: typing.List,
+    from_data: typing.Union[list, bpy.types.Mesh],
+    indices: list,
     fix_loops: bool = True,
     debug_print=True,
 ):
-    """Takes a poly-line of indices (ngon) and returns a list of face index lists. Designed to be used for importers that need indices for an ngon to create from existing verts.
-
-    :param from_data: either a mesh, or a list/tuple of vectors.
-    :type from_data: typing.Union[typing.List, 'bpy.types.Mesh']
-    :param indices: a list of indices to use this list is the ordered closed poly-line to fill, and can be a subset of the data given.
-    :type indices: typing.List
-    :param fix_loops: If this is enabled poly-lines that use loops to make multiple poly-lines are dealt with correctly.
-    :type fix_loops: bool
+    """Takes a poly-line of indices (ngon) and returns a list of face
+    index lists. Designed to be used for importers that need indices for an
+    ngon to create from existing verts.
+
+        :param from_data: either a mesh, or a list/tuple of vectors.
+        :type from_data: typing.Union[list, bpy.types.Mesh]
+        :param indices: a list of indices to use this list
+    is the ordered closed poly-line
+    to fill, and can be a subset of the data given.
+        :type indices: list
+        :param fix_loops: If this is enabled poly-lines
+    that use loops to make multiple
+    poly-lines are dealt with correctly.
+        :type fix_loops: bool
     """
 
     ...
 
 def triangle_random_points(
-    num_points: typing.Any,
-    loop_triangles: typing.Union["bpy.types.MeshLoopTriangle", typing.Sequence],
-) -> typing.List:
+    num_points,
+    loop_triangles: typing.Union[bpy.types.MeshLoopTriangle, typing.Sequence],
+) -> list:
     """Generates a list of random points over mesh loop triangles.
 
-    :type int: typing.Any
+    :param num_points: the number of random points to generate on each triangle.
     :param loop_triangles: list of the triangles to generate points on.
-    :type loop_triangles: typing.Union['bpy.types.MeshLoopTriangle', typing.Sequence]
-    :param num_points:  the number of random points to generate on each triangle.
-    :type num_points: typing.Any
-    :rtype: typing.List
+    :type loop_triangles: typing.Union[bpy.types.MeshLoopTriangle, typing.Sequence]
     :return: list of random points over all triangles.
+    :rtype: list
     """
 
     ...

bpy_extras/node_utils/__init__.pyi

@@ -1,8 +1,8 @@
-import sys
 import typing
 
 GenericType = typing.TypeVar("GenericType")
 
-def connect_sockets(input, output): ...
-def find_base_socket_type(socket): ...
-def find_node_input(node, name): ...
+def find_node_input(node, name):
+    """ """
+
+    ...

bpy_extras/object_utils/__init__.pyi

@@ -1,31 +1,39 @@
-import sys
 import typing
 import bpy.types
 import mathutils
-import bpy
 
 GenericType = typing.TypeVar("GenericType")
 
 class AddObjectHelper:
-    def align_update_callback(self, _context): ...
+    """ """
+
+    def align_update_callback(self, _context):
+        """
+
+        :param _context:
+        """
+        ...
 
 def add_object_align_init(
-    context: "bpy.types.Context", operator: "bpy.types.Operator"
-) -> "mathutils.Matrix":
+    context: bpy.types.Context, operator: bpy.types.Operator
+) -> mathutils.Matrix:
     """Return a matrix using the operator settings and view context.
 
     :param context: The context to use.
-    :type context: 'bpy.types.Context'
+    :type context: bpy.types.Context
     :param operator: The operator, checked for location and rotation properties.
-    :type operator: 'bpy.types.Operator'
-    :rtype: 'mathutils.Matrix'
+    :type operator: bpy.types.Operator
     :return: the matrix from the context and settings.
+    :rtype: mathutils.Matrix
     """
 
     ...
 
 def object_add_grid_scale(context):
-    """Return scale which should be applied on object data to align it to grid scale"""
+    """Return scale which should be applied on object
+    data to align it to grid scale
+
+    """
 
     ...
 
@@ -35,55 +43,62 @@ def object_add_grid_scale_apply_operator(operator, context):
     ...
 
 def object_data_add(
-    context: "bpy.types.Context",
-    obdata: "bpy.data",
-    operator: "bpy.types.Operator" = None,
+    context: bpy.types.Context,
+    obdata,
+    operator: bpy.types.Operator = None,
     name: str = None,
-) -> "bpy.types.Object":
-    """Add an object using the view context and preference to initialize the location, rotation and layer.
-
-    :param context: The context to use.
-    :type context: 'bpy.types.Context'
-    :param obdata: the data used for the new object.
-    :type obdata: 'bpy.data'
-    :param operator: The operator, checked for location and rotation properties.
-    :type operator: 'bpy.types.Operator'
-    :param name: Optional name
-    :type name: str
-    :rtype: 'bpy.types.Object'
-    :return: the newly created object in the scene.
+) -> bpy.types.Object:
+    """Add an object using the view context and preference to initialize the
+    location, rotation and layer.
+
+        :param context: The context to use.
+        :type context: bpy.types.Context
+        :param obdata: the data used for the new object.
+        :param operator: The operator, checked for location and rotation properties.
+        :type operator: bpy.types.Operator
+        :param name: Optional name
+        :type name: str
+        :return: the newly created object in the scene.
+        :rtype: bpy.types.Object
     """
 
     ...
 
 def object_report_if_active_shape_key_is_locked(
-    obj: "bpy.types.Object", operator: "bpy.types.Operator"
+    obj: bpy.types.Object, operator: bpy.types.Operator
 ):
-    """Checks if the active shape key of the specified object is locked, and reports an error if so. If the object has no shape keys, there is nothing to lock, and the function returns False.
+    """Checks if the active shape key of the specified object is locked, and reports an error if so.If the object has no shape keys, there is nothing to lock, and the function returns False.
 
     :param obj: Object to check.
-    :type obj: 'bpy.types.Object'
+    :type obj: bpy.types.Object
     :param operator: Currently running operator to report the error through. Use None to suppress emitting the message.
-    :type operator: 'bpy.types.Operator'
+    :type operator: bpy.types.Operator
+    :return: True if the shape key was locked.
     """
 
     ...
 
 def world_to_camera_view(
-    scene: "bpy.types.Scene",
-    obj: "bpy.types.Object",
-    coord: typing.Union[typing.Sequence[float], "mathutils.Vector"],
-) -> "mathutils.Vector":
-    """Returns the camera space coords for a 3d point. (also known as: normalized device coordinates - NDC). Where (0, 0) is the bottom left and (1, 1) is the top right of the camera frame. values outside 0-1 are also supported. A negative 'z' value means the point is behind the camera. Takes shift-x/y, lens angle and sensor size into account as well as perspective/ortho projections.
-
-    :param scene: Scene to use for frame size.
-    :type scene: 'bpy.types.Scene'
-    :param obj: Camera object.
-    :type obj: 'bpy.types.Object'
-    :param coord: World space location.
-    :type coord: typing.Union[typing.Sequence[float], 'mathutils.Vector']
-    :rtype: 'mathutils.Vector'
-    :return: a vector where X and Y map to the view plane and Z is the depth on the view axis.
+    scene: bpy.types.Scene,
+    obj: bpy.types.Object,
+    coord: typing.Union[typing.Sequence[float], mathutils.Vector],
+) -> mathutils.Vector:
+    """Returns the camera space coords for a 3d point.
+    (also known as: normalized device coordinates - NDC).Where (0, 0) is the bottom left and (1, 1)
+    is the top right of the camera frame.
+    values outside 0-1 are also supported.
+    A negative 'z' value means the point is behind the camera.Takes shift-x/y, lens angle and sensor size into account
+    as well as perspective/ortho projections.
+
+        :param scene: Scene to use for frame size.
+        :type scene: bpy.types.Scene
+        :param obj: Camera object.
+        :type obj: bpy.types.Object
+        :param coord: World space location.
+        :type coord: typing.Union[typing.Sequence[float], mathutils.Vector]
+        :return: a vector where X and Y map to the view plane and
+    Z is the depth on the view axis.
+        :rtype: mathutils.Vector
     """
 
     ...