SCANPY-235 Fix documentation and behavior of --toml-path

[marc-jasper-sonarsource]

No description provided.

[sonar-review-alpha]

Summary

Summary

This PR enhances the --toml-path CLI argument to accept either:

• A full path to the pyproject.toml file directly, OR
• A path to the folder containing it (the previous behavior)

The changes include:

• Updated documentation (CLI help text, README, and CLI args documentation) to clarify both usage patterns
• Modified TomlConfigurationLoader.load() to detect whether the provided path is a file or directory and handle both cases
• Variable rename (toml_dir → toml_path) to better reflect the dual-mode functionality
• New unit tests covering the direct file path scenario

This improves usability by allowing more flexible path specifications without breaking existing code that passes directory paths.

What reviewers should know

This PR comment is ready to post at the top of PR #300. It provides reviewers with a quick 30-second overview of the changes: what the feature does, which files were touched, and why it matters (improved usability). The comment complements the lack of an author description by explaining both the documentation updates and the behavioral change in the code.

---

• Generate Walkthrough
• Generate Diagram

🗣️ Give feedback

[hashicorp-vault-sonar-prod]

SCANPY-235

[sonarqube-next]

Quality Gate passed for 'Python Scanner'

Issues
0 New issues
0 Fixed issues
0 Accepted issues

Measures
0 Security Hotspots
0 Dependency risks
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube

[thomas-serre-sonarsource]

LGTM !