blender/tools
Campbell Barton 1216651ca9 PyAPI: make internal modules explicitly "private"
Rename modules in `./scripts/modules/` to use an underscore prefix to
make it clear they aren't intended to be part of public API's. This
also means there is no implication that these modules should be stable,
allowing us to change them based on Blender's internal usage.

The following modules have been marked as private:

- `animsys_refactor`
- `bl_console_utils`
- `bl_i18n_utils`
- `bl_previews_utils`
- `bl_rna_utils`
- `bl_text_utils`
- `bl_ui_utils`
- `bpy_restrict_state`
- `console_python`
- `console_shell`
- `graphviz_export`
- `keyingsets_utils`
- `rna_info`
- `rna_manual_reference`
- `rna_xml`

Note that we could further re-arrange these modules
(under `_bpy_internal` in some cases), this change is mainly to mark
them as private, further changes can be handed on a case-by-case basis.

Ref !147773
2025-10-13 09:35:09 +00:00
..
check_blender_release
check_docs
check_source PyAPI: make internal modules explicitly "private" 2025-10-13 09:35:09 +00:00
config
debug/gdb
git
modules UI: Replace contractions with long-form text 2025-08-05 11:16:22 +02:00
svn_rev_map
triage Fix: Typo in tools/triage/issues_needing_info.py 2025-09-25 10:32:04 +02:00
utils PyAPI: make internal modules explicitly "private" 2025-10-13 09:35:09 +00:00
utils_api
utils_build Cleanup: remove tools/utils_build/cmake-flags 2025-08-21 12:02:33 +10:00
utils_doc PyAPI: make internal modules explicitly "private" 2025-10-13 09:35:09 +00:00
utils_ide
utils_maintenance PyAPI: make internal modules explicitly "private" 2025-10-13 09:35:09 +00:00
readme.rst

Blender Dev Tools
#################

This repository is intended for miscellaneous tools, utilities, configurations and
anything that helps with Blender development, but aren't directly related to building Blender.

Some of the tools included may be used stand-alone, others expect Blenders source code to be available.


Usage
=====

While this is a stand-alone repository,
some of the scripts which access Blenders source code assume this repository will be located at
``tools`` within Blenders source code repository. At some point this may be included as a submodule.

Some tools also rely on the ``blender`` binary, this is assumed to be located at: ``../../blender.bin``.
*The root directory of Blender's git repository*


Categories
==========

Check Source
------------

Any tools for scanning source files to report issues with code, style, conventions, deprecated features etc.


Config
------

Configuration for 3rd party applications (IDE's, code-analysis, debugging tools... etc).


Git
---

Scripts and utilities for working with git.


Utils
-----

Programs (scripts) to help with development
(currently for converting formats, creating mouse cursor, updating themes).