function_finder (for Rust)

A .py tool (function_finder.py) with a cli Q&A interface for use
with Rust files (.rs) and code directories (e.g. /src/) to:

A. Extract a function or nest of functions from a directory or file

• primary function
• up to N depth of the same for functions called by that function
• in up to N depth sub-directories of modules in the code directory
• results saved to files with timestamped names in function_finder_files/

B. Save those functions to individual files and optionally to one flat file

The goal of this tool is to be useful for projects with more than a few functions,
where a routine but non-trivial task is extracting the code-scope
around a specific function (a function, and the functions called by that function).

Simple Tool:

This is a simple tool that does not cover all possible edge cases.
An error-log file is produced to provide possible exception data.

Function 1: function_finder()

Signature

function_finder(
    rust_code_dir_path: str,        # often the src/ file in your rust 'crate'
    function_name_to_find: str,     # prime target: the function you are looking for
    function_depth: int = 0,        # how much recursive search: functions called by that function to find
    file_depth: int = 2,            # directory-file depth to -r search
    only_search_this_file_path: str | None = None,  # optional examine only one file
    output_dir: str | None = None,  # if None: default is use CWD (current working directory)
) -> list[str]

Function 2: flatten_finder(dir_path)

Signature

flatten_finder(dir_path: str) -> str