feat: file object data type

[cofin]

Description

Implement a file data type that leverages obstore or fsspec. Supports any supported FSSpec or Obstore backend it including sftp, gcs, s3, local, and more.

Closes

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 80.74454% with 150 lines in your changes missing coverage. Please review.

Project coverage is 87.81%. Comparing base (dfc0f7f) to head (14681eb).

Files with missing lines	Patch %	Lines
...anced_alchemy/types/file_object/session_tracker.py	53.94%	30 Missing and 5 partials ⚠️
advanced_alchemy/_listeners.py	77.04%	19 Missing and 9 partials ⚠️
...nced_alchemy/types/file_object/backends/obstore.py	72.27%	18 Missing and 10 partials ⚠️
...anced_alchemy/types/file_object/backends/fsspec.py	79.64%	11 Missing and 12 partials ⚠️
advanced_alchemy/types/file_object/data_type.py	70.17%	12 Missing and 5 partials ⚠️
advanced_alchemy/types/file_object/_utils.py	66.66%	7 Missing and 3 partials ⚠️
advanced_alchemy/types/file_object/file.py	95.97%	3 Missing and 3 partials ⚠️
advanced_alchemy/types/file_object/base.py	92.68%	3 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #291      +/-   ##
==========================================
- Coverage   89.03%   87.81%   -1.22%     
==========================================
  Files          68       78      +10     
  Lines        4358     5106     +748     
  Branches      529      636     +107     
==========================================
+ Hits         3880     4484     +604     
- Misses        328      426      +98     
- Partials      150      196      +46     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

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

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
83.8% Coverage on New Code
0.8% Duplication on New Code

See analysis details on SonarQube Cloud

[github-actions]

Documentation preview will be available shortly at https://litestar-org.github.io/advanced-alchemy-docs-preview/291