[Refactor] Replace Debug Statements with Proper Logging Framework

[astrogilda]

Description

This PR addresses issue #184 by replacing all DEBUG print statements with Python's logging framework, making the codebase production-ready.

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

How Has This Been Tested?

• All DEBUG prints replaced with logger.debug()
• Logging output verified at different levels
• No unwanted output in normal operation

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• Any dependent changes have been merged and published in downstream modules

Additional Information

This is a quick win improvement that:

• Makes the library production-ready
• Allows users to control log verbosity
• Improves debugging capabilities
• Cleans up the codebase

Resolves #184

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud