feat: Ruff formating and pre-commit ci for the codebase

[manishdait]

Description:
This PR adds pre-commit hooks and GitHub Actions to enforce consistent code quality, security, and modern Python standards across the SDK.

Changes Made:

• Added a GitHub Action to run pre-commit on all PRs.
• Migrated to use Ruff formating and checks
• Refactored code to use Python 3.10+ standards and sorted imports. (Mostly handle by Ruff)
• Updated docsting for the methods and class
• Updated docs on how to setup pre-commit

Related issue(s):

Fixes #2043

Notes for reviewer:

• Logic remains the same; changes are strictly formatting and syntax modernization.
• Initialy disable the -D docs check as some of our classes is currently missing the docstring.

Checklist

• Documented (Code comments, README, etc.)
• Tested (unit, integration, etc.)

[codecov]

Codecov Report

❌ Patch coverage is 96.15385% with 29 lines in your changes missing coverage. Please review.

@@            Coverage Diff             @@
##             main    #2082      +/-   ##
==========================================
- Coverage   93.70%   93.68%   -0.02%     
==========================================
  Files         145      145              
  Lines        9452     9426      -26     
==========================================
- Hits         8857     8831      -26     
  Misses        595      595              

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[codacy-production]

Not up to standards ⛔

🔴 Issues 4 medium

Alerts:
⚠ 4 issues (≤ 0 issues of at least minor severity)

Results:
4 new issues

Category	Results
Complexity	4 medium

View in Codacy

🟢 Metrics 0 complexity

Metric	Results
Complexity	0

View in Codacy

_{TIP This summary will be updated as you push new changes. Give us feedback}

[exploreriii]

i would not want to accept codacy's current changes for this PR! too much in one to refactor those.

[github-actions]

Hi, this is WorkflowBot.
Your pull request cannot be merged as it is not passing all our workflow checks.
Please click on each check to review the logs and resolve issues so all checks pass.
To help you:

• DCO signing guide
• Merge conflicts guide
• Rebase guide
• Testing guide
• Discord
• Community Calls
  Thank you for contributing!
  From the Hiero Python SDK Team

[exploreriii]

ci tests failing :(

[exploreriii]

Looks really great job, couple questions/notes

[exploreriii]

Thanks so much @manishdait