[enhancement] - Find module - Adding directory exclusion logic with depth-based exclusion control

[ghecko]

Summary

This pull request introduces the implementation of directory exclusion logic with depth-based control in the find method in SMBSession.py and the Find module.

Key Features:

• Directory Exclusion by Name: You can now exclude directories by name using the --exclude-dir option. The exclusion comparison is case-sensitive.
• Depth-Based Exclusion Control: The --exclude-dir-depth parameter allows you to specify at which depth directories should be excluded:
  • 0: Excludes directories at the initial level (default behavior).
  • Positive integers: Exclude directories at the corresponding depth level.
  • -1: Exclude directories at all levels, ensuring directories are skipped regardless of their depth in the hierarchy.

Use Case:

This feature allows users to fine-tune their searches by excluding specific directories at different levels of the directory structure. It is particularly useful when performing searches across deep directory hierarchies, giving users more control over which directories are included or excluded during the search.