feat/update-class-devices/SDKPY-147

[mateuscardosodeveloper]

What does PR do?

This PR completes the Devices class implementation in the Python SDK by adding missing methods that exist in the JavaScript SDK reference implementation.

Core Changes

• Added missing Devices methods: Implemented getChunk(), deleteChunk(), dataBackup(), and dataRestore() methods for chunk management and data backup/restore operations
• Enhanced documentation: Updated all method docstrings to follow the standardized pattern with @description, @see, and @example sections
• Type safety improvements: Added 4 new TypedDict definitions for chunk and backup operations
• Complete RST documentation: Added comprehensive Sphinx documentation for all 21 Devices methods and types
• Extended test coverage: Expanded test suite from 3 to 21 comprehensive test cases

Implementation Details

New Methods:

• getChunk(): Retrieves chunk information from immutable devices
• deleteChunk(): Deletes specific chunks from immutable devices
• dataBackup(): Exports device data to TagoIO Files in CSV format (supports both mutable and immutable devices)
• dataRestore(): Imports device data from CSV files stored in TagoIO Files

New TypedDict Definitions:

• DeviceChunkData: Chunk information structure with ID, dates, and data amount
• DeviceDataBackup: Parameters for data backup operations
• DeviceDataBackupResponse: Response structure from backup operations
• DeviceDataRestore: Parameters for data restore operations

Documentation Updates:

• All 21 methods updated with improved docstrings
• Added RST documentation for Devices class in docs/source/Resources/Devices/
• Included code examples for each method
• Added type definitions documentation

Quality Assurance

• All 21 tests pass successfully
• Code follows project conventions and style guidelines
• Linting passes with Ruff
• Documentation builds successfully with Sphinx (no warnings)

This completes the Devices class implementation to match the JavaScript SDK functionality! 🎉

JIRA cards

SDKPY-147

Type of alteration

• Bug fix
• New feature
• Breaking change
• Documentation update

[felipefdl]

Finding: ignores because params only include when truthy (devices.py lines ~263-288). Callers cannot request unsent params; should check before lower/str conversion so both True/False pass through.

[felipefdl]

Finding: paramList ignores sentStatus=False because params only include sent_status when truthy (devices.py lines ~263-288). Callers cannot request unsent params; should check sentStatus is not None before lower/str conversion so both True/False pass through.

[felipefdl]

LGTM after fix: sentStatus now handled when False so unsent params are reachable.