feat/update-analyses-class-and-enable-regions/SDKPY-144 (#53)

* feat: enhance Analyses class with snippet methods and improved documentation

Added listSnippets() and getSnippetFile() methods to fetch analysis code examples from TagoIO's public repository. Enhanced all existing methods with comprehensive docstrings following the Account class pattern, including descriptions, references, and practical examples. Updated type definitions to support new snippet functionality with SnippetRuntime, SnippetItem, and SnippetsListResponse types. Expanded test coverage with 8 new test cases and updated RST documentation with detailed method descriptions and code examples.

* feat: enhance regions support and Analysis runtime with async execution

Expanded regions.py with EU region support, TDeploy project integration, and runtime region caching. Refactored Analysis class to support async/await execution patterns with improved error handling and console service integration. Removed deprecated api_socket.py infrastructure and added JSONParseSafe utility for safer JSON parsing. Updated Analysis type definitions with new constructor params and function signatures. Added comprehensive region tests covering TDeploy and multi-region scenarios.

* feat: enhance Analysis class initialization and region handling

- Add instance attributes (params, started, _running) for better state management
- Fix autostart logic to explicitly check for False instead of falsy values
- Fix region configuration to safely handle missing region parameter using .get()

This improves the Analysis class initialization by adding proper state tracking and preventing potential KeyError when region is not provided.

* feat: update Analysis class to start automatically based on autostart parameter

* feat: modify autostart parameter default to True in Analysis class

* feat: refactor Analysis class initialization and improve region support

Restructured Analysis class to separate initialization from execution flow using new init() method pattern. Modified TagoContext from TypedDict to class for better runtime flexibility. Updated documentation examples to reflect Python runtime instead of Deno.

* feat: update Analysis class to correctly assign analysis_id and environment from environment variables

Author: mateuscardosodeveloper

.vscode/settings.json

@@ -8,6 +8,7 @@
         "ignoretz",
         "PYPI",
         "pytest",
-        "serie_number"
+        "serie_number",
+        "Tago"
     ]
 }

docs/source/Resources/Analysis/Analysis_Type.rst

@@ -102,3 +102,68 @@ AnalysisListItem
         | locked_at: Optional[datetime]
 
         | console: Optional[List[str]]
+
+
+.. _SnippetRuntime:
+
+SnippetRuntime
+--------------
+
+    Available runtime environments for snippets.
+
+    **Type:**
+
+        | Literal["node-legacy", "python-legacy", "node-rt2025", "python-rt2025", "deno-rt2025"]
+
+
+.. _SnippetItem:
+
+SnippetItem
+-----------
+
+    Individual snippet metadata.
+
+    **Attributes:**
+
+        | id: str
+        | Unique identifier for the snippet
+
+        | title: str
+        | Human-readable title
+
+        | description: str
+        | Description of what the snippet does
+
+        | language: str
+        | Programming language (typescript, javascript, python)
+
+        | tags: List[str]
+        | Array of tags for categorization
+
+        | filename: str
+        | Filename of the snippet
+
+        | file_path: str
+        | Full path to the file in the runtime directory
+
+
+.. _SnippetsListResponse:
+
+SnippetsListResponse
+--------------------
+
+    API response containing all snippets metadata for a runtime.
+
+    **Attributes:**
+
+        | runtime: :ref:`SnippetRuntime`
+        | Runtime environment identifier
+
+        | schema_version: int
+        | Schema version for the API response format
+
+        | generated_at: str
+        | ISO timestamp when the response was generated
+
+        | snippets: List[:ref:`SnippetItem`]
+        | Array of all available snippets for this runtime