fake-bge-module 20250104__py3-none-any.whl → 20250201__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (153) hide show
  1. addon_utils/__init__.pyi +11 -6
  2. aud/__init__.pyi +4 -0
  3. bge/types/__init__.pyi +66 -27
  4. bgl/__init__.pyi +2 -2
  5. bgui/image/__init__.pyi +3 -1
  6. bgui/system/__init__.pyi +12 -4
  7. bl_console_utils/autocomplete/complete_calltip/__init__.pyi +5 -2
  8. bl_console_utils/autocomplete/complete_import/__init__.pyi +6 -3
  9. bl_console_utils/autocomplete/complete_namespace/__init__.pyi +2 -1
  10. bl_console_utils/autocomplete/intellisense/__init__.pyi +8 -2
  11. bl_operators/node/__init__.pyi +78 -0
  12. bl_ui/anim/__init__.pyi +6 -0
  13. bl_ui/generic_ui_list/__init__.pyi +2 -2
  14. bl_ui/node_add_menu_shader/__init__.pyi +0 -1
  15. bl_ui/node_add_menu_texture/__init__.pyi +1 -0
  16. bl_ui/properties_data_camera/__init__.pyi +0 -2
  17. bl_ui/properties_mask_common/__init__.pyi +17 -0
  18. bl_ui/properties_material_gpencil/__init__.pyi +29 -0
  19. bl_ui/properties_scene/__init__.pyi +6 -0
  20. bl_ui/properties_view_layer/__init__.pyi +1 -0
  21. bl_ui/space_clip/__init__.pyi +53 -0
  22. bl_ui/space_graph/__init__.pyi +2 -0
  23. bl_ui/space_image/__init__.pyi +25 -0
  24. bl_ui/space_node/__init__.pyi +0 -1
  25. bl_ui/space_sequencer/__init__.pyi +2 -1
  26. blf/__init__.pyi +6 -3
  27. bmesh/ops/__init__.pyi +111 -54
  28. bmesh/types/__init__.pyi +134 -46
  29. bmesh/utils/__init__.pyi +17 -5
  30. bpy/__init__.pyi +1 -2
  31. bpy/_typing/__init__.pyi +4 -0
  32. bpy/{typing → _typing/rna_enums}/__init__.pyi +36 -36
  33. bpy/app/__init__.pyi +13 -5
  34. bpy/app/handlers/__init__.pyi +4 -2
  35. bpy/app/icons/__init__.pyi +6 -2
  36. bpy/app/translations/__init__.pyi +17 -8
  37. bpy/msgbus/__init__.pyi +14 -2
  38. bpy/ops/action/__init__.pyi +51 -151
  39. bpy/ops/anim/__init__.pyi +61 -179
  40. bpy/ops/armature/__init__.pyi +48 -147
  41. bpy/ops/asset/__init__.pyi +16 -71
  42. bpy/ops/boid/__init__.pyi +11 -44
  43. bpy/ops/brush/__init__.pyi +16 -42
  44. bpy/ops/buttons/__init__.pyi +6 -29
  45. bpy/ops/cachefile/__init__.pyi +5 -19
  46. bpy/ops/camera/__init__.pyi +2 -5
  47. bpy/ops/clip/__init__.pyi +95 -293
  48. bpy/ops/cloth/__init__.pyi +1 -3
  49. bpy/ops/collection/__init__.pyi +10 -26
  50. bpy/ops/console/__init__.pyi +21 -79
  51. bpy/ops/constraint/__init__.pyi +18 -45
  52. bpy/ops/curve/__init__.pyi +57 -186
  53. bpy/ops/curves/__init__.pyi +37 -109
  54. bpy/ops/cycles/__init__.pyi +3 -9
  55. bpy/ops/dpaint/__init__.pyi +8 -22
  56. bpy/ops/ed/__init__.pyi +20 -52
  57. bpy/ops/export_anim/__init__.pyi +1 -3
  58. bpy/ops/export_scene/__init__.pyi +55 -32
  59. bpy/ops/extensions/__init__.pyi +34 -110
  60. bpy/ops/file/__init__.pyi +40 -167
  61. bpy/ops/fluid/__init__.pyi +14 -77
  62. bpy/ops/font/__init__.pyi +23 -85
  63. bpy/ops/geometry/__init__.pyi +29 -46
  64. bpy/ops/gizmogroup/__init__.pyi +2 -9
  65. bpy/ops/gpencil/__init__.pyi +8 -32
  66. bpy/ops/graph/__init__.pyi +82 -201
  67. bpy/ops/grease_pencil/__init__.pyi +125 -324
  68. bpy/ops/image/__init__.pyi +61 -163
  69. bpy/ops/import_anim/__init__.pyi +1 -3
  70. bpy/ops/import_curve/__init__.pyi +1 -3
  71. bpy/ops/import_scene/__init__.pyi +4 -6
  72. bpy/ops/info/__init__.pyi +7 -29
  73. bpy/ops/lattice/__init__.pyi +11 -32
  74. bpy/ops/logic/__init__.pyi +26 -65
  75. bpy/ops/marker/__init__.pyi +11 -31
  76. bpy/ops/mask/__init__.pyi +39 -132
  77. bpy/ops/material/__init__.pyi +3 -19
  78. bpy/ops/mball/__init__.pyi +8 -19
  79. bpy/ops/mesh/__init__.pyi +223 -470
  80. bpy/ops/nla/__init__.pyi +42 -150
  81. bpy/ops/node/__init__.pyi +169 -393
  82. bpy/ops/object/__init__.pyi +320 -749
  83. bpy/ops/outliner/__init__.pyi +76 -268
  84. bpy/ops/paint/__init__.pyi +67 -147
  85. bpy/ops/paintcurve/__init__.pyi +8 -33
  86. bpy/ops/palette/__init__.pyi +7 -27
  87. bpy/ops/particle/__init__.pyi +39 -134
  88. bpy/ops/pose/__init__.pyi +64 -182
  89. bpy/ops/poselib/__init__.pyi +9 -33
  90. bpy/ops/preferences/__init__.pyi +35 -94
  91. bpy/ops/ptcache/__init__.pyi +7 -33
  92. bpy/ops/render/__init__.pyi +13 -37
  93. bpy/ops/rigidbody/__init__.pyi +22 -54
  94. bpy/ops/scene/__init__.pyi +47 -130
  95. bpy/ops/screen/__init__.pyi +46 -144
  96. bpy/ops/script/__init__.pyi +3 -11
  97. bpy/ops/sculpt/__init__.pyi +40 -94
  98. bpy/ops/sculpt_curves/__init__.pyi +4 -10
  99. bpy/ops/sequencer/__init__.pyi +104 -327
  100. bpy/ops/sound/__init__.pyi +17 -28
  101. bpy/ops/spreadsheet/__init__.pyi +4 -15
  102. bpy/ops/surface/__init__.pyi +6 -13
  103. bpy/ops/text/__init__.pyi +43 -175
  104. bpy/ops/text_editor/__init__.pyi +1 -3
  105. bpy/ops/texture/__init__.pyi +4 -21
  106. bpy/ops/transform/__init__.pyi +114 -134
  107. bpy/ops/ui/__init__.pyi +39 -120
  108. bpy/ops/uilist/__init__.pyi +3 -7
  109. bpy/ops/uv/__init__.pyi +58 -143
  110. bpy/ops/view2d/__init__.pyi +14 -39
  111. bpy/ops/view3d/__init__.pyi +68 -238
  112. bpy/ops/wm/__init__.pyi +178 -319
  113. bpy/ops/workspace/__init__.pyi +7 -33
  114. bpy/ops/world/__init__.pyi +2 -11
  115. bpy/path/__init__.pyi +16 -6
  116. bpy/props/__init__.pyi +157 -127
  117. bpy/types/__init__.pyi +35227 -34838
  118. bpy/utils/__init__.pyi +71 -25
  119. bpy/utils/previews/__init__.pyi +2 -1
  120. bpy/utils/units/__init__.pyi +2 -1
  121. bpy_extras/anim_utils/__init__.pyi +11 -3
  122. bpy_extras/bmesh_utils/__init__.pyi +2 -1
  123. bpy_extras/image_utils/__init__.pyi +5 -2
  124. bpy_extras/io_utils/__init__.pyi +12 -5
  125. bpy_extras/mesh_utils/__init__.pyi +27 -6
  126. bpy_extras/object_utils/__init__.pyi +6 -5
  127. bpy_extras/view3d_utils/__init__.pyi +9 -2
  128. {fake_bge_module-20250104.dist-info → fake_bge_module-20250201.dist-info}/METADATA +3 -3
  129. {fake_bge_module-20250104.dist-info → fake_bge_module-20250201.dist-info}/RECORD +153 -152
  130. {fake_bge_module-20250104.dist-info → fake_bge_module-20250201.dist-info}/WHEEL +1 -1
  131. freestyle/chainingiterators/__init__.pyi +7 -2
  132. freestyle/functions/__init__.pyi +16 -4
  133. freestyle/shaders/__init__.pyi +5 -1
  134. freestyle/types/__init__.pyi +103 -30
  135. freestyle/utils/ContextFunctions/__init__.pyi +2 -2
  136. freestyle/utils/__init__.pyi +2 -1
  137. gpu/capabilities/__init__.pyi +2 -1
  138. gpu/matrix/__init__.pyi +4 -2
  139. gpu/state/__init__.pyi +2 -2
  140. gpu/types/__init__.pyi +40 -8
  141. gpu_extras/batch/__init__.pyi +13 -1
  142. gpu_extras/presets/__init__.pyi +10 -1
  143. idprop/types/__init__.pyi +4 -2
  144. imbuf/__init__.pyi +6 -3
  145. imbuf/types/__init__.pyi +5 -2
  146. mathutils/__init__.pyi +126 -35
  147. mathutils/bvhtree/__init__.pyi +21 -6
  148. mathutils/geometry/__init__.pyi +68 -22
  149. mathutils/interpolate/__init__.pyi +5 -1
  150. mathutils/kdtree/__init__.pyi +21 -8
  151. mathutils/noise/__init__.pyi +2 -1
  152. rna_info/__init__.pyi +2 -1
  153. {fake_bge_module-20250104.dist-info → fake_bge_module-20250201.dist-info}/top_level.txt +0 -0
@@ -441,7 +441,7 @@ type CurvesHandleTypeItems = typing.Literal[
441
441
  "FREE", # Free.The handle can be moved anywhere, and doesn't influence the point's other handle.
442
442
  "AUTO", # Auto.The location is automatically calculated to be smooth.
443
443
  "VECTOR", # Vector.The location is calculated to point to the next/previous control point.
444
- "ALIGN", # Align.The location is constrained to point in the opposite direction as the other handleW.
444
+ "ALIGN", # Align.The location is constrained to point in the opposite direction as the other handle.
445
445
  ]
446
446
  type CurvesTypeItems = typing.Literal[
447
447
  "CATMULL_ROM", # Catmull Rom.
@@ -592,7 +592,7 @@ type EventTypeItems = typing.Literal[
592
592
  "ESC", # Esc.
593
593
  "TAB", # Tab.
594
594
  "RET", # Return.Enter.
595
- "SPACE", # Spacebar.Space.
595
+ "SPACE", # Space Bar.Spacebar.
596
596
  "LINE_FEED", # Line Feed.
597
597
  "BACK_SPACE", # Backspace.BkSpace.
598
598
  "DEL", # Delete.Del.
@@ -1582,15 +1582,15 @@ type IconItems = typing.Literal[
1582
1582
  "COLLECTION_COLOR_06", # COLLECTION_COLOR_06.
1583
1583
  "COLLECTION_COLOR_07", # COLLECTION_COLOR_07.
1584
1584
  "COLLECTION_COLOR_08", # COLLECTION_COLOR_08.
1585
- "SEQUENCE_COLOR_01", # SEQUENCE_COLOR_01.
1586
- "SEQUENCE_COLOR_02", # SEQUENCE_COLOR_02.
1587
- "SEQUENCE_COLOR_03", # SEQUENCE_COLOR_03.
1588
- "SEQUENCE_COLOR_04", # SEQUENCE_COLOR_04.
1589
- "SEQUENCE_COLOR_05", # SEQUENCE_COLOR_05.
1590
- "SEQUENCE_COLOR_06", # SEQUENCE_COLOR_06.
1591
- "SEQUENCE_COLOR_07", # SEQUENCE_COLOR_07.
1592
- "SEQUENCE_COLOR_08", # SEQUENCE_COLOR_08.
1593
- "SEQUENCE_COLOR_09", # SEQUENCE_COLOR_09.
1585
+ "STRIP_COLOR_01", # STRIP_COLOR_01.
1586
+ "STRIP_COLOR_02", # STRIP_COLOR_02.
1587
+ "STRIP_COLOR_03", # STRIP_COLOR_03.
1588
+ "STRIP_COLOR_04", # STRIP_COLOR_04.
1589
+ "STRIP_COLOR_05", # STRIP_COLOR_05.
1590
+ "STRIP_COLOR_06", # STRIP_COLOR_06.
1591
+ "STRIP_COLOR_07", # STRIP_COLOR_07.
1592
+ "STRIP_COLOR_08", # STRIP_COLOR_08.
1593
+ "STRIP_COLOR_09", # STRIP_COLOR_09.
1594
1594
  "LIBRARY_DATA_INDIRECT", # LIBRARY_DATA_INDIRECT.
1595
1595
  "LIBRARY_DATA_OVERRIDE_NONEDITABLE", # LIBRARY_DATA_OVERRIDE_NONEDITABLE.
1596
1596
  "LAYERGROUP_COLOR_01", # LAYERGROUP_COLOR_01.
@@ -2042,9 +2042,9 @@ type NodeClampItems = typing.Literal[
2042
2042
  "RANGE", # Range.Constrain value between min and max, swapping arguments when min > max.
2043
2043
  ]
2044
2044
  type NodeCombsepColorItems = typing.Literal[
2045
- "RGB", # RGB.Use RGB color processing.
2046
- "HSV", # HSV.Use HSV color processing.
2047
- "HSL", # HSL.Use HSL color processing.
2045
+ "RGB", # RGB.Use RGB (Red, Green, Blue) color processing.
2046
+ "HSV", # HSV.Use HSV (Hue, Saturation, Value) color processing.
2047
+ "HSL", # HSL.Use HSL (Hue, Saturation, Lightness) color processing.
2048
2048
  ]
2049
2049
  type NodeCompareOperationItems = typing.Literal[
2050
2050
  "LESS_THAN", # Less Than.True when the first input is smaller than second input.
@@ -2739,28 +2739,6 @@ type RigidbodyObjectTypeItems = typing.Literal[
2739
2739
  "ACTIVE", # Active.Object is directly controlled by simulation results.
2740
2740
  "PASSIVE", # Passive.Object is directly controlled by animation system.
2741
2741
  ]
2742
- type SequenceModifierTypeItems = typing.Literal[
2743
- "BRIGHT_CONTRAST", # Brightness/Contrast.
2744
- "COLOR_BALANCE", # Color Balance.
2745
- "CURVES", # Curves.
2746
- "HUE_CORRECT", # Hue Correct.
2747
- "MASK", # Mask.
2748
- "TONEMAP", # Tone Map.
2749
- "WHITE_BALANCE", # White Balance.
2750
- "SOUND_EQUALIZER", # Sound Equalizer.
2751
- ]
2752
- type SequenceSoundModifierTypeItems = typing.Literal[
2753
- "SOUND_EQUALIZER", # Sound Equalizer.
2754
- ]
2755
- type SequenceVideoModifierTypeItems = typing.Literal[
2756
- "BRIGHT_CONTRAST", # Brightness/Contrast.
2757
- "COLOR_BALANCE", # Color Balance.
2758
- "CURVES", # Curves.
2759
- "HUE_CORRECT", # Hue Correct.
2760
- "MASK", # Mask.
2761
- "TONEMAP", # Tone Map.
2762
- "WHITE_BALANCE", # White Balance.
2763
- ]
2764
2742
  type ShadingTypeItems = typing.Literal[
2765
2743
  "WIREFRAME", # Wireframe.Display the object as wire edges.
2766
2744
  "SOLID", # Solid.Display in solid mode.
@@ -2879,6 +2857,28 @@ type StripColorItems = typing.Literal[
2879
2857
  "COLOR_08", # Color 08.
2880
2858
  "COLOR_09", # Color 09.
2881
2859
  ]
2860
+ type StripModifierTypeItems = typing.Literal[
2861
+ "BRIGHT_CONTRAST", # Brightness/Contrast.
2862
+ "COLOR_BALANCE", # Color Balance.
2863
+ "CURVES", # Curves.
2864
+ "HUE_CORRECT", # Hue Correct.
2865
+ "MASK", # Mask.
2866
+ "TONEMAP", # Tone Map.
2867
+ "WHITE_BALANCE", # White Balance.
2868
+ "SOUND_EQUALIZER", # Sound Equalizer.
2869
+ ]
2870
+ type StripSoundModifierTypeItems = typing.Literal[
2871
+ "SOUND_EQUALIZER", # Sound Equalizer.
2872
+ ]
2873
+ type StripVideoModifierTypeItems = typing.Literal[
2874
+ "BRIGHT_CONTRAST", # Brightness/Contrast.
2875
+ "COLOR_BALANCE", # Color Balance.
2876
+ "CURVES", # Curves.
2877
+ "HUE_CORRECT", # Hue Correct.
2878
+ "MASK", # Mask.
2879
+ "TONEMAP", # Tone Map.
2880
+ "WHITE_BALANCE", # White Balance.
2881
+ ]
2882
2882
  type SubdivisionBoundarySmoothItems = typing.Literal[
2883
2883
  "PRESERVE_CORNERS", # Keep Corners.Smooth boundaries, but corners are kept sharp.
2884
2884
  "ALL", # All.Smooth boundaries, including corners.
bpy/app/__init__.pyi CHANGED
@@ -14,7 +14,7 @@ bpy.app.timers.rst
14
14
  import typing
15
15
  import collections.abc
16
16
  import typing_extensions
17
- import bpy.typing
17
+ import bpy._typing.rna_enums
18
18
 
19
19
  from . import handlers as handlers
20
20
  from . import icons as icons
@@ -28,11 +28,11 @@ def help_text(all: bool | None = False):
28
28
  :type all: bool | None
29
29
  """
30
30
 
31
- def is_job_running(job_type: bpy.typing.WmJobTypeItems):
31
+ def is_job_running(job_type: bpy._typing.rna_enums.WmJobTypeItems):
32
32
  """Check whether a job of the given type is running.
33
33
 
34
34
  :param job_type: job type in `rna_enum_wm_job_type_items`.
35
- :type job_type: bpy.typing.WmJobTypeItems
35
+ :type job_type: bpy._typing.rna_enums.WmJobTypeItems
36
36
  :return: Whether a job of the given type is currently running.
37
37
  """
38
38
 
@@ -192,6 +192,10 @@ ffmpeg: typing.Any
192
192
  """ Constant value bpy.app.ffmpeg(supported=True, avcodec_version=(60, 31, 102), avcodec_version_string='60, 31, 102', avdevice_version=(60, 3, 100), avdevice_version_string='60, 3, 100', avformat_version=(60, 16, 100), avformat_version_string='60, 16, 100', avutil_version=(58, 29, 100), avutil_version_string='58, 29, 100', swscale_version=(7, 5, 100), swscale_version_string=' 7, 5, 100')
193
193
  """
194
194
 
195
+ module: typing.Any
196
+ """ Boolean, True when running Blender as a python module
197
+ """
198
+
195
199
  ocio: typing.Any
196
200
  """ Constant value bpy.app.ocio(supported=True, version=(2, 3, 2), version_string=' 2, 3, 2')
197
201
  """
@@ -216,6 +220,10 @@ openvdb: typing.Any
216
220
  """ Constant value bpy.app.openvdb(supported=True, version=(11, 0, 0), version_string='11, 0, 0')
217
221
  """
218
222
 
223
+ portable: typing.Any
224
+ """ Boolean, True unless blender was built to reference absolute paths (on UNIX).
225
+ """
226
+
219
227
  python_args: typing.Any
220
228
  """ Leading arguments to use when calling Python directly (via sys.executable). These arguments match settings Blender uses to ensure Python runs with a compatible environment (read-only).
221
229
  """
@@ -249,7 +257,7 @@ use_userpref_skip_save_on_exit: typing.Any
249
257
  """
250
258
 
251
259
  version: tuple[int, int, int]
252
- """ The Blender version as a tuple of 3 numbers. eg. (2, 83, 1)
260
+ """ The Blender version as a tuple of 3 numbers (major, minor, micro). eg. (4, 3, 1)
253
261
  """
254
262
 
255
263
  version_cycle: typing.Any
@@ -257,7 +265,7 @@ version_cycle: typing.Any
257
265
  """
258
266
 
259
267
  version_file: typing.Any
260
- """ The Blender version, as a tuple, last used to save a .blend file, compatible with bpy.data.version. This value should be used for handling compatibility changes between Blender versions
268
+ """ The Blender File version, as a tuple of 3 numbers (major, minor, file sub-version), that will be used to save a .blend file. The last item in this tuple indicates the file sub-version, which is different from the release micro version (the last item of the bpy.app.version tuple). The file sub-version can be incremented multiple times while a Blender version is under development. This value is, and should be, used for handling compatibility changes between Blender versions
261
269
  """
262
270
 
263
271
  version_string: typing.Any
@@ -80,11 +80,13 @@ composite_pre: list[collections.abc.Callable[[bpy.types.Scene], None]]
80
80
  """ on a compositing background job (before)
81
81
  """
82
82
 
83
- depsgraph_update_post: list[collections.abc.Callable[[bpy.types.Scene], None]]
83
+ depsgraph_update_post: list[
84
+ collections.abc.Callable[[bpy.types.Scene, bpy.types.Depsgraph], None]
85
+ ]
84
86
  """ on depsgraph update (post)
85
87
  """
86
88
 
87
- depsgraph_update_pre: list[collections.abc.Callable[[bpy.types.Scene], None]]
89
+ depsgraph_update_pre: list[collections.abc.Callable[[bpy.types.Scene, None], None]]
88
90
  """ on depsgraph update (pre)
89
91
  """
90
92
 
@@ -2,10 +2,13 @@ import typing
2
2
  import collections.abc
3
3
  import typing_extensions
4
4
 
5
- def new_triangles(range, coords: bytes | None, colors: bytes | None) -> int:
5
+ def new_triangles(
6
+ range: tuple[int, int] | None, coords: bytes | None, colors: bytes | None
7
+ ) -> int:
6
8
  """Create a new icon from triangle geometry.
7
9
 
8
10
  :param range: Pair of ints.
11
+ :type range: tuple[int, int] | None
9
12
  :param coords: Sequence of bytes (6 floats for one triangle) for (X, Y) coordinates.
10
13
  :type coords: bytes | None
11
14
  :param colors: Sequence of bytes (12 for one triangles) for RGBA.
@@ -14,10 +17,11 @@ def new_triangles(range, coords: bytes | None, colors: bytes | None) -> int:
14
17
  :rtype: int
15
18
  """
16
19
 
17
- def new_triangles_from_file(filepath) -> int:
20
+ def new_triangles_from_file(filepath: str | None) -> int:
18
21
  """Create a new icon from triangle geometry.
19
22
 
20
23
  :param filepath: File path.
24
+ :type filepath: str | None
21
25
  :return: Unique icon value (pass to interface icon_value argument).
22
26
  :rtype: int
23
27
  """
@@ -67,67 +67,76 @@ def locale_explode(locale):
67
67
  :return: A tuple (language, country, variant, language_country, language@variant).
68
68
  """
69
69
 
70
- def pgettext(msgid: str | None, msgctxt=None):
70
+ def pgettext(msgid: str | None, msgctxt: None | str | None = None):
71
71
  """Try to translate the given msgid (with optional msgctxt).
72
72
 
73
73
  :param msgid: The string to translate.
74
74
  :type msgid: str | None
75
75
  :param msgctxt: The translation context (defaults to BLT_I18NCONTEXT_DEFAULT).
76
+ :type msgctxt: None | str | None
76
77
  :return: The translated string (or msgid if no translation was found).
77
78
  """
78
79
 
79
- def pgettext_data(msgid: str | None, msgctxt=None):
80
+ def pgettext_data(msgid: str | None, msgctxt: None | str | None = None):
80
81
  """Try to translate the given msgid (with optional msgctxt), if new data name's translation is enabled.
81
82
 
82
83
  :param msgid: The string to translate.
83
84
  :type msgid: str | None
84
85
  :param msgctxt: The translation context (defaults to BLT_I18NCONTEXT_DEFAULT).
86
+ :type msgctxt: None | str | None
85
87
  :return: The translated string (or msgid if no translation was found).
86
88
  """
87
89
 
88
- def pgettext_iface(msgid: str | None, msgctxt=None):
90
+ def pgettext_iface(msgid: str | None, msgctxt: None | str | None = None):
89
91
  """Try to translate the given msgid (with optional msgctxt), if labels' translation is enabled.
90
92
 
91
93
  :param msgid: The string to translate.
92
94
  :type msgid: str | None
93
95
  :param msgctxt: The translation context (defaults to BLT_I18NCONTEXT_DEFAULT).
96
+ :type msgctxt: None | str | None
94
97
  :return: The translated string (or msgid if no translation was found).
95
98
  """
96
99
 
97
- def pgettext_n(msgid: str | None, msgctxt=None):
100
+ def pgettext_n(msgid: str | None, msgctxt: None | str | None = None):
98
101
  """Extract the given msgid to translation files. This is a no-op function that will only mark the string to extract, but not perform the actual translation.
99
102
 
100
103
  :param msgid: The string to extract.
101
104
  :type msgid: str | None
102
105
  :param msgctxt: The translation context (defaults to BLT_I18NCONTEXT_DEFAULT).
106
+ :type msgctxt: None | str | None
103
107
  :return: The original string.
104
108
  """
105
109
 
106
- def pgettext_rpt(msgid: str | None, msgctxt=None):
110
+ def pgettext_rpt(msgid: str | None, msgctxt: None | str | None = None):
107
111
  """Try to translate the given msgid (with optional msgctxt), if reports' translation is enabled.
108
112
 
109
113
  :param msgid: The string to translate.
110
114
  :type msgid: str | None
111
115
  :param msgctxt: The translation context (defaults to BLT_I18NCONTEXT_DEFAULT).
116
+ :type msgctxt: None | str | None
112
117
  :return: The translated string (or msgid if no translation was found).
113
118
  """
114
119
 
115
- def pgettext_tip(msgid: str | None, msgctxt=None):
120
+ def pgettext_tip(msgid: str | None, msgctxt: None | str | None = None):
116
121
  """Try to translate the given msgid (with optional msgctxt), if tooltips' translation is enabled.
117
122
 
118
123
  :param msgid: The string to translate.
119
124
  :type msgid: str | None
120
125
  :param msgctxt: The translation context (defaults to BLT_I18NCONTEXT_DEFAULT).
126
+ :type msgctxt: None | str | None
121
127
  :return: The translated string (or msgid if no translation was found).
122
128
  """
123
129
 
124
- def register(module_name: str | None, translations_dict):
130
+ def register(
131
+ module_name: str | None, translations_dict: dict[str, dict[str, str]] | None
132
+ ):
125
133
  """Registers an addon's UI translations.
126
134
 
127
135
  :param module_name: The name identifying the addon.
128
136
  :type module_name: str | None
129
137
  :param translations_dict: A dictionary built like that:
130
138
  {locale: {msg_key: msg_translation, ...}, ...}
139
+ :type translations_dict: dict[str, dict[str, str]] | None
131
140
  """
132
141
 
133
142
  def unregister(module_name: str | None):
@@ -138,7 +147,7 @@ def unregister(module_name: str | None):
138
147
  """
139
148
 
140
149
  contexts: typing.Any
141
- """ Constant value bpy.app.translations.contexts(default_real=None, default='*', operator_default='Operator', ui_events_keymaps='UI_Events_KeyMaps', plural='Plural', id_action='Action', id_armature='Armature', id_brush='Brush', id_cachefile='CacheFile', id_camera='Camera', id_collection='Collection', id_curves='Curves', id_curve='Curve', id_fs_linestyle='FreestyleLineStyle', id_gpencil='GPencil', id_id='ID', id_image='Image', id_lattice='Lattice', id_library='Library', id_light='Light', id_lightprobe='LightProbe', id_mask='Mask', id_material='Material', id_mesh='Mesh', id_metaball='Metaball', id_movieclip='MovieClip', id_nodetree='NodeTree', id_object='Object', id_paintcurve='PaintCurve', id_palette='Palette', id_particlesettings='ParticleSettings', id_pointcloud='PointCloud', id_scene='Scene', id_screen='Screen', id_sequence='Sequence', id_shapekey='Key', id_simulation='Simulation', id_sound='Sound', id_speaker='Speaker', id_text='Text', id_texture='Texture', id_vfont='VFont', id_volume='Volume', id_windowmanager='WindowManager', id_workspace='WorkSpace', id_world='World', editor_filebrowser='File browser', editor_python_console='Python console', editor_preferences='Preferences', editor_view3d='View3D', amount='Amount', color='Color', constraint='Constraint', time='Time', unit='Unit')
150
+ """ Constant value bpy.app.translations.contexts(default_real=None, default='*', operator_default='Operator', ui_events_keymaps='UI_Events_KeyMaps', plural='Plural', id_action='Action', id_armature='Armature', id_brush='Brush', id_cachefile='CacheFile', id_camera='Camera', id_collection='Collection', id_curves='Curves', id_curve='Curve', id_fs_linestyle='FreestyleLineStyle', id_gpencil='GPencil', id_id='ID', id_image='Image', id_lattice='Lattice', id_library='Library', id_light='Light', id_lightprobe='LightProbe', id_mask='Mask', id_material='Material', id_mesh='Mesh', id_metaball='Metaball', id_movieclip='MovieClip', id_nodetree='NodeTree', id_object='Object', id_paintcurve='PaintCurve', id_palette='Palette', id_particlesettings='ParticleSettings', id_pointcloud='PointCloud', id_scene='Scene', id_screen='Screen', id_sequence='Sequence', id_shapekey='Key', id_simulation='Simulation', id_sound='Sound', id_speaker='Speaker', id_text='Text', id_texture='Texture', id_vfont='VFont', id_volume='Volume', id_windowmanager='WindowManager', id_workspace='WorkSpace', id_world='World', editor_filebrowser='File browser', editor_python_console='Python console', editor_preferences='Preferences', editor_view3d='View3D', amount='Amount', color='Color', constraint='Constraint', modifier='Modifier', navigation='Navigation', render_layer='Render Layer', time='Time', unit='Unit')
142
151
  """
143
152
 
144
153
  contexts_C_to_py: typing.Any
bpy/msgbus/__init__.pyi CHANGED
@@ -47,11 +47,14 @@ see bpy.app.handlers.load_post.
47
47
  import typing
48
48
  import collections.abc
49
49
  import typing_extensions
50
+ import bpy.types
50
51
 
51
52
  def clear_by_owner(owner):
52
53
  """Clear all subscribers using this owner."""
53
54
 
54
- def publish_rna(key):
55
+ def publish_rna(
56
+ key: bpy.types.Property | bpy.types.Struct | tuple[bpy.types.Struct, str] | None,
57
+ ):
55
58
  """Notify subscribers of changes to this property
56
59
  (this typically doesn't need to be called explicitly since changes will automatically publish updates).
57
60
  In some cases it may be useful to publish changes explicitly using more general keys.
@@ -62,9 +65,16 @@ def publish_rna(key):
62
65
  - A property instance.
63
66
  - A struct type.
64
67
  - A tuple representing a (struct, property name) pair.
68
+ :type key: bpy.types.Property | bpy.types.Struct | tuple[bpy.types.Struct, str] | None
65
69
  """
66
70
 
67
- def subscribe_rna(key, owner, args, notify, options=set()):
71
+ def subscribe_rna(
72
+ key: bpy.types.Property | bpy.types.Struct | tuple[bpy.types.Struct, str] | None,
73
+ owner: typing.Any | None,
74
+ args,
75
+ notify,
76
+ options=set(),
77
+ ):
68
78
  """Register a message bus subscription. It will be cleared when another blend file is
69
79
  loaded, or can be cleared explicitly via `bpy.msgbus.clear_by_owner`.
70
80
 
@@ -74,7 +84,9 @@ def subscribe_rna(key, owner, args, notify, options=set()):
74
84
  - A property instance.
75
85
  - A struct type.
76
86
  - A tuple representing a (struct, property name) pair.
87
+ :type key: bpy.types.Property | bpy.types.Struct | tuple[bpy.types.Struct, str] | None
77
88
  :param owner: Handle for this subscription (compared by identity).
89
+ :type owner: typing.Any | None
78
90
  :param options: Change the behavior of the subscriber.
79
91
 
80
92
  PERSISTENT when set, the subscriber will be kept when remapping ID data.