synmax-api-python-client 4.15.0__py3-none-any.whl → 4.16.1__py3-none-any.whl

synmax/openapi/client.py

@@ -10,7 +10,7 @@ import importlib
 from itertools import islice
 import pandas as pd
 
-from synmax.openapi.utils import change_signature, get_annotation, get_body_model, get_param_model
+from synmax.openapi.utils import change_signature, get_annotation, get_body_model, get_param_model, PARAM_MODEL_SUFFIX, BODY_MODEL_SUFFIX
 
 class OpenAPIClient:
     def __init__(self,
@@ -100,16 +100,15 @@ class OpenAPIClient:
 
     def _create_request_function(self, method: str, full_url: str, param_model: Optional[Type[BaseModel]], body_model: Optional[Type[BaseModel]]):
         def request_func(self, **kwargs) -> Result:
+            param_dict = None
+            if param_model:
+                data = param_model(**kwargs).model_dump(mode='json')
+                param_dict = {k: v for k, v in data.dict().items() if v is not None}
+            body_dict = None
+            if body_model:
+                data = body_model(**kwargs).model_dump(mode='json')
+                body_dict = {k: v for k, v in data.items() if v is not None}
             def generator() -> Iterator[Dict[str, Any]]:
-                param_dict = None
-                if param_model:
-                    data = param_model(**kwargs).model_dump(mode='json')
-                    param_dict = {k: v for k, v in data.dict().items() if v is not None}
-                body_dict = None
-                if body_model:
-                    data = body_model(**kwargs).model_dump(mode='json')
-                    
-                    body_dict = {k: v for k, v in data.items() if v is not None}
                 self._logger.info(f"Making request to {full_url}")
                 retry_count = 0
                 can_retry = True

synmax/openapi/utils.py

@@ -1,8 +1,15 @@
 import inspect
-from pydantic import BaseModel, create_model, Extra
+from pydantic import BaseModel, create_model, Extra, ValidationError
 from typing import Any, Dict, Optional, Type, Union, Literal
 from datetime import date
 
+import traceback
+import types
+import typing
+
+BODY_MODEL_SUFFIX = "BodyModel"
+PARAM_MODEL_SUFFIX = "ParamsModel"
+
 
 def change_signature(func, signature: inspect.Signature):
     """
@@ -14,7 +21,105 @@ def change_signature(func, signature: inspect.Signature):
     def wrapped(*args, **kwargs):
         bound_arguments = inspect.signature(func).bind(*args, **kwargs)
         bound_arguments.apply_defaults()
-        return func(*bound_arguments.args, **bound_arguments.kwargs)
+        try:
+            return func(*bound_arguments.args, **bound_arguments.kwargs)
+        except ValidationError as pydanticerror:
+            # strip user-irrelevant library guts from the error
+            tb = discard_traceback_frames(pydanticerror.__traceback__, 5)
+
+            # intercept familiar pydantic errors; replace them with user friendly ones
+            pretty = []
+            funcname = pydanticerror.title
+            funcname = funcname.removesuffix(BODY_MODEL_SUFFIX)
+            funcname = funcname.removesuffix(PARAM_MODEL_SUFFIX)
+            model = pydanticerror.model
+            fields = model.model_fields
+
+            errors_dict = {}
+            for e in pydanticerror.errors():
+                key = e['loc'][0]
+                if key not in errors_dict:
+                    errors_dict[key] = []
+                errors_dict[key].append(e)
+
+            pretty = []
+            for param,errors in errors_dict.items():
+                # case: spurious param
+                if param not in fields:
+                    pe = f"{funcname}:\n  unexpected parameter '{param}'"
+                    pretty.append(pe)
+                    continue
+
+                annotation = fields[param].annotation
+                # handle unions as follows:
+                # if any arm of the union shallowly matches, its "the" relevant arm
+                # if no arm shallowly matches and there is one simple branch, its that one
+                # otherwise, we keep the whole union i guess
+                num_simple = 0
+                paramtype = None
+                if typing.get_origin(annotation) == typing.Union:
+                    for e in errors:
+                        if len(e['loc']) == 2:
+                            input_value = e['input']
+                    args = list(typing.get_args(annotation))
+                    for arg in args:
+                        shallow = typing.get_origin(arg)
+                        if shallow is not None:
+                            if isinstance(input_value, shallow):
+                                paramtype = arg
+                                break
+                        else:
+                            num_simple += 1
+                            simple = arg
+                            if isinstance(input_value, arg):
+                                paramtype = arg
+                                break
+                    if paramtype is None:
+                        if num_simple == 1:
+                            paramtype = simple
+                        else:
+                            paramtype = annotation
+                else:
+                    paramtype = annotation
+
+                if paramtype in [date, str, int, bool, float]:
+                    input = errors[0]['input']
+                    pe = f"{funcname}:\n  '{param}' is expecting type '{paramtype.__name__}'"
+                    pe += f"\n  Got '{input}'"
+                    pretty.append(pe)
+                    continue
+                if typing.get_origin(paramtype) is list:
+                    bad_inputs = []
+                    not_list = False
+                    arg = typing.get_args(paramtype)[0]
+                    is_enum_list = typing.get_origin(arg) is typing.Literal
+                    expecting = str(paramtype)
+                    if is_enum_list:
+                        expecting = "list[enum]"
+                    pe = f"{funcname}:\n  '{param}' is expecting type '{expecting}'"
+                    if is_enum_list:
+                        enumvals = typing.get_args(arg)
+                        pe += f"\n  Accepted enum values are: {', '.join(enumvals)}"
+                    for e in errors:
+                        if len(e['loc']) == 3: # error in a list element (path depth 3)
+                            bad_inputs.append(str(e['input']))
+                        if len(e['loc']) == 2: # not giving a list where a list expected
+                            not_list = True
+                    if not_list:
+                        pe += f"\n  Got '{e['input']}'"
+                        pretty.append(pe)
+                        continue
+                    if len(bad_inputs > 0):
+                        pe += f"\n  Got '{', '.join(bad_inputs)}'"
+                        pretty.append(pe)
+                        continue
+            # if there's an error our prettifier recognized, just print that
+            # otherwise, fall back to the raw pydantic error
+            if len(pretty) == 0:
+                raise pydanticerror.with_traceback(tb)
+            else:
+                raise ParamError(pretty).with_traceback(tb) from None
+
     sig = inspect.signature(func)
     new_params = [
             inspect.Parameter(
@@ -54,7 +159,7 @@ def get_param_model(parameters: list, operation_id: str) -> Optional[Type[BaseMo
         schema = param.get("schema", {"type": "string"})
         required = param.get("required", False)
         param_fields[name] = (map_openapi_type(schema, name), ... if required else None)
-    return create_model(f"{operation_id}Params", **param_fields) if param_fields else None
+    return create_model_with_error_metadata(f"{operation_id}{PARAM_MODEL_SUFFIX}", **param_fields) if param_fields else None
 
 
 def get_body_model(request_body: dict, operation_id: str) -> Optional[Type[BaseModel]]:
@@ -69,7 +174,7 @@ def get_body_model(request_body: dict, operation_id: str) -> Optional[Type[BaseM
             body_fields[key] = (map_openapi_type(value, key), ... if is_required else None)
         if schema.get("additionalProperties") is False:
             body_extra = Extra.forbid
-    return create_model(f"{operation_id}Body", **body_fields, __config__=type("Config", (), {"extra": body_extra})) if body_fields else None
+    return create_model_with_error_metadata(f"{operation_id}{BODY_MODEL_SUFFIX}", **body_fields, __config__=type("Config", (), {"extra": body_extra})) if body_fields else None
 
 
 def map_openapi_type(schema: Dict[str, Any], name: str) -> Type:
@@ -99,3 +204,59 @@ def map_openapi_type(schema: Dict[str, Any], name: str) -> Type:
 
     return type_map.get(schema.get("type"), Any)
 
+
+def discard_traceback_frames(tb, discard):
+    frames = []
+    while tb:
+        frames.append(tb)
+        tb = tb.tb_next
+    keep = max(0, len(frames) - discard)
+    frames = frames[:keep]
+    head = None
+    current = None
+    for frame in frames:
+        new_tb = types.TracebackType(
+            tb_next=None,
+            tb_frame=frame.tb_frame,
+            tb_lasti=frame.tb_lasti,
+            tb_lineno=frame.tb_lineno
+        )
+        if head is None:
+            head = new_tb
+            current = head
+        else:
+            current.tb_next = new_tb
+            current = new_tb
+    return head
+
+
+class ParamError(ValueError):
+    def __init__(self, lines):
+        self.lines = lines
+
+    def __str__(self):
+        out = ''
+        for line in self.lines:
+            out += "\n" + line
+        return out
+
+    def __repr__(self):
+        return f'ParamError(lines={self.lines!r})'
+
+
+def create_model_with_error_metadata(name, **params):
+    base_model = create_model(name, **params)
+    def __init__(self, *args, **kwargs):
+        try:
+            super(base_model, self).__init__(*args, **kwargs)
+        except ValidationError as e:
+            e.model = base_model
+            raise e
+    enriched_model = type(
+        name,
+        (base_model,),
+        {'__init__': __init__}
+    )
+    return enriched_model
+
+

synmax/vulcan/v2/openapi.yaml

@@ -197,12 +197,34 @@ paths:
           content:
             application/json:
               schema: { $ref: '#/components/schemas/ErrorResponse' }
+
+  /infrastructure_watch_extended:
+    get:
+      operationId: routes.v2.infrastructure_watch_extended.get
+      x-method-name: infrastructure_watch_extended
+      summary: Get infrastructure watch extended data (Middle East conflict)
+      security: [ApiKeyAuth: [vulcan_infrastructure_watch_extended]]
+      responses:
+        '200':
+          description: Infrastructure watch extended data
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/InfrastructureWatchExtendedResponse'
+        '500':
+          description: Internal Server Error - Database error
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/ErrorResponse' }
+
   /beta/query_datalinks:
     post:
       x-method-name: beta_query_datalinks
       security: [ApiKeyAuth: [hyperion]]
       summary: Execute SQL queries against SynMax datalinks
-      description: Execute T-SQL queries directly against SynMax's 5 datalinks (19 tables). Returns query results as structured data.
+      description: Execute T-SQL queries directly against SynMax's datalinks. Returns query results as structured data.
       requestBody:
         required: true
         content:
@@ -215,7 +237,7 @@ paths:
                 query:
                   type: string
                   description: SQL query to execute. Tables must use {linkid}_{table} format. Use ANSI SQL (LIMIT not TOP).
-                  example: "SELECT * FROM 1005_v_pipeline_flow WHERE gas_day >= '2024-01-01' LIMIT 100"
+                  example: "SELECT * FROM v_pipeline_flow WHERE gas_day >= '2024-01-01' LIMIT 100"
                 session_id:
                   type: string
                   description: Optional session ID for logging/tracking. Auto-generated if not provided.
@@ -479,6 +501,11 @@ components:
           description: ISO date on which the record was created
           example: "2023-01-01T12:00:00Z"
           nullable: true
+        btm_generation:
+          type: boolean
+          description: Indicates if the data center has behind-the-meter generation
+          example: true
+          nullable: true
       required:
         - synmax_id
 
@@ -662,6 +689,11 @@ components:
           example: "4/14/2025"
           description: Date of the latest available satellite image
           nullable: true
+        county:
+          type: string
+          example: "Fayette"
+          description: Plant county - Provided by EIA
+          nullable: true
         latitude:
           type: number
           format: float
@@ -1379,6 +1411,100 @@ components:
           example: "2025-11-17"
           description: ISO date on which the record was last modified
           nullable: true
+          
+    InfrastructureWatchExtendedResponse:
+      type: object
+      properties:
+        site_id:
+          type: string
+          format: uuid
+          example: "f47ac10b-58cc-4372-a567-0e02b2c3d479"
+          description: Unique UUID identifying the infrastructure site.
+          nullable: false
+        site_name:
+          type: string
+          example: "South Pars"
+          description: Name of the tracked infrastructure site.
+          nullable: false
+        vulcan_assessment:
+          type: string
+          example: "visual change"
+          description: The latest visual or operational assessment of the site (e.g., no change, visual change).
+          nullable: false
+        vulcan_assessment_datetime:
+          type: string
+          format: date-time
+          example: "2026-03-05T20:00:00Z"
+          description: ISO-8601 timestamp of when the assessment was conducted.
+          nullable: false
+        additional_notes:
+          type: string
+          example: "site fires and scarring detected near LNG trains"
+          description: Additional context or observations regarding the assessment.
+          nullable: true
+        country:
+          type: string
+          example: "Iran"
+          description: Country where the infrastructure is located.
+          nullable: false
+        country_code:
+          type: string
+          example: "IR"
+          description: ISO country code of the location.
+          nullable: false
+        technology:
+          type: string
+          example: "Oil/Gas Processing"
+          description: The primary industry or technology type of the site.
+          nullable: true
+        capacity:
+          type: number
+          format: float
+          example: 730.0
+          description: Operational capacity of the infrastructure.
+          nullable: true
+        capacity_unit:
+          type: string
+          example: "MMcm/d"
+          description: Unit of measurement for the capacity.
+          nullable: true
+        latitude:
+          type: number
+          format: double
+          example: 27.508
+          description: Latitude of the site in decimal degrees.
+          nullable: false
+        longitude:
+          type: number
+          format: double
+          example: 52.575
+          description: Longitude of the site in decimal degrees.
+          nullable: false
+        location_wkt:
+          type: string
+          example: "POINT(52.575 27.508)"
+          description: Well-Known Text (WKT) spatial representation of the site coordinates (Longitude Latitude).
+          nullable: false
+        image_benchmark_datetime:
+          type: string
+          format: date-time
+          example: "2026-03-05T21:00:00Z"
+          description: ISO-8601 timestamp of the baseline image used for comparison.
+          nullable: true
+        image_acquisition_datetime:
+          type: string
+          format: date-time
+          example: "2026-03-05T20:00:00Z"
+          description: ISO-8601 timestamp of when the newest satellite image was acquired.
+          nullable: true
+        image_source:
+          type: string
+          example: "Planet"
+          description: Provider of the satellite imagery.
+          nullable: true
+        image_resolution:
+          type: string
+          example: "10m"
 
     ErrorResponse:
       type: object

synmax/vulcan/v2/vulcan_client.pyi

@@ -23,6 +23,9 @@ class VulcanApiClient:
     def iir_data(self) -> Result:
         """Get IIR data"""
         ...
+    def infrastructure_watch_extended(self) -> Result:
+        """Get infrastructure watch extended data (Middle East conflict)"""
+        ...
     def beta_query_datalinks(self,query: str,session_id: str = ...) -> Result:
         """Execute SQL queries against SynMax datalinks"""
         ...

{synmax_api_python_client-4.15.0.dist-info → synmax_api_python_client-4.16.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: synmax-api-python-client
-Version: 4.15.0
+Version: 4.16.1
 Summary: Synmax API client
 Home-page: https://github.com/SynMaxDev/synmax-api-python-client.git
 Author: SynMax Inc.
@@ -13,14 +13,23 @@ Requires-Dist: aioretry>=6.3.1
 Requires-Dist: packaging>=24.2
 Requires-Dist: pandas>=2.0.3
 Requires-Dist: pydantic>=2.10.6
-Requires-Dist: pydantic-core<2.32.0,>=2.27.2
+Requires-Dist: pydantic_core<2.32.0,>=2.27.2
 Requires-Dist: requests>=2.32.3
 Requires-Dist: tenacity>=9.0.0
 Requires-Dist: tqdm>=4.67.1
 Requires-Dist: urllib3>=2.3.0
 Requires-Dist: prance>=25.4.8.0
-Requires-Dist: openapi-spec-validator>=0.7.1
+Requires-Dist: openapi_spec_validator>=0.7.1
 Requires-Dist: httpx>=0.28.1
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 # SynMax API Python Client
 

{synmax_api_python_client-4.15.0.dist-info → synmax_api_python_client-4.16.1.dist-info}/RECORD

@@ -17,33 +17,27 @@ synmax/hyperion/v4/__init__.py,sha256=VpXU-_FP836dXUDcUFYr-0y0-ZrSM8aCtGE97Z2qbS
 synmax/hyperion/v4/hyperion_client.py,sha256=mhYL3QiOoD2viCI60grLMFvGdHx8iD8IF05NWC6-HS0,868
 synmax/hyperion/v4/hyperion_client.pyi,sha256=yNgEmWzZWKPeQ4Y-ilfBOr8e_lMD4GIMwWe3UCHu438,12039
 synmax/hyperion/v4/openapi.yaml,sha256=RU4mACjWtL3yNwN5tEyZHYcJ37-pg7F3Y84UyBDfveE,100266
-synmax/hyperion/v4/start_hyperion_client.py,sha256=0Cs6qgy8yYuhrVhSVZqa7TKKR9PHFkEomA26MTQUJlU,2495
 synmax/leviaton/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-synmax/leviaton/start_leviaton_client.py,sha256=XrgEHoYTsLgwyuBWkHxsCzeEGoj4C40RuDVD_0QZ_ks,4101
-synmax/leviaton/start_leviaton_client2.py,sha256=JdN0FJV67yqjptxw769CjRqgFdzqIdCvmpNclmnErzg,3107
 synmax/leviaton/v1/__init__.py,sha256=UgUccQqpTDS0qB20AyHb1ZCdoJvgjeWK1ZbEg2b2I6Y,93
 synmax/leviaton/v1/leviaton_client.py,sha256=rdASXkfD8V5ChNJMAUk2ZiptK-bgJpcBkdH812ih5jk,917
 synmax/leviaton/v1/leviaton_client.pyi,sha256=XwDR89SwF-Gc7YlGKxei0g0Z4e75qmFM5KzzmvMIHxo,14070
 synmax/leviaton/v1/openapi.yaml,sha256=0H4fJaVEfiDInHpY2yV03c5kZ4Bb_j_UiuMvO2Um03c,143378
 synmax/openapi/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-synmax/openapi/client.py,sha256=WC14WowLxt6hFOdA6WAKAYU9Uet7tXmQGbkkyIQf9eo,8698
-synmax/openapi/utils.py,sha256=q6PsmUT0D58_AdOCM0ZNw1CrveiYVF4IQN4J6ticZ4Q,3689
+synmax/openapi/client.py,sha256=lwENevbQmapCLktpcPgEpsqwYOATGLWDSwkpOs_3-LY,8684
+synmax/openapi/utils.py,sha256=UyNm2UJ1s3YuLnd0Cq5lWbC92OWUhguyRYyOqlFB4rk,9789
 synmax/theia/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synmax/vulcan/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-synmax/vulcan/start_vulcan_python_client.py,sha256=cx4DQyrNpIR6UyzOdEFreZWVLCwHE1Z1II5dfN6SPMg,746
 synmax/vulcan/v2/__init__.py,sha256=AGMAxDs93mZ_9zF1fFAufUsu9w9Ep94lO1vbLGbD-LU,81
-synmax/vulcan/v2/openapi.yaml,sha256=AkSc97bLX9hdR3OSSJqH_hF1TDCP7oghUk1uTsSmPNo,48866
-synmax/vulcan/v2/start_vulcan_client.py,sha256=XWHXzwCu6gK33Pw0FKfGjwXiEadg-G6VQI5UsqBlVHc,1002
-synmax/vulcan/v2/start_vulcan_client2.py,sha256=z59_ZLZ3NX7nO-50cEx7bqeuzYRj-pA4WEMlLf304qs,1833
+synmax/vulcan/v2/openapi.yaml,sha256=NzIGFtgqH5fd7ekSjXoTl6aQAkt2Fjk2kDaqDj-0z9M,53272
 synmax/vulcan/v2/vulcan_client.py,sha256=aeCaISqNyJ0bezbvCcxVgdGmUPp2Lv0SFqDbFCt9TXQ,879
-synmax/vulcan/v2/vulcan_client.pyi,sha256=N8hgva9k2xdIikxnaZwsAPNb_S_ve_UVgpxfrHl7Od4,1120
+synmax/vulcan/v2/vulcan_client.pyi,sha256=PwWS5qexlEWzwF3oK0N7_mgCP1ne8PFSwrlWyCd5b00,1263
+synmax_api_python_client-4.16.1.dist-info/licenses/LICENSE,sha256=vKvn9cDVfJhNepCuIXLWaHnnUoDPX26KD-iWb7NAZ4M,44
 test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 test/test_api_client.py,sha256=HFWCu_xBgqQXc9p6k6YmP2gVrdCFwuhoDVqlxpN1Yoc,4713
 test/test_hyperion_client.py,sha256=aCb4bMBXWofa82MInXoU9tJ5wWsg5sBRv7B_CHvkrcg,1380
 test/test_hyperion_e2e.py,sha256=BPhZH7eVQZSsFcvPdonKjmLahnfsLy37Z2DHp0LGeHc,6247
 test/test_hyperion_helpers.py,sha256=R0G7oqKaoz6jLRACODJ1Cf2gA0gaMPQhOZRjKp4a6-s,2006
-synmax_api_python_client-4.15.0.dist-info/LICENSE,sha256=vKvn9cDVfJhNepCuIXLWaHnnUoDPX26KD-iWb7NAZ4M,44
-synmax_api_python_client-4.15.0.dist-info/METADATA,sha256=nVpwzpTVF2G3zEFUaCMaZHf4NnTtDiaKdBc21HW3rEA,4994
-synmax_api_python_client-4.15.0.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-synmax_api_python_client-4.15.0.dist-info/top_level.txt,sha256=SAjmDfHlJzUmjoGCT1SnS4qGSLN_ZF-p58UN1yW5kB0,17
-synmax_api_python_client-4.15.0.dist-info/RECORD,,
+synmax_api_python_client-4.16.1.dist-info/METADATA,sha256=vkM0VHFRBA6soiZDcZSq-XyppOIUq-78ZGXfg4LfTxE,5193
+synmax_api_python_client-4.16.1.dist-info/WHEEL,sha256=SmOxYU7pzNKBqASvQJ7DjX3XGUF92lrGhMb3R6_iiqI,91
+synmax_api_python_client-4.16.1.dist-info/top_level.txt,sha256=SAjmDfHlJzUmjoGCT1SnS4qGSLN_ZF-p58UN1yW5kB0,17
+synmax_api_python_client-4.16.1.dist-info/RECORD,,

{synmax_api_python_client-4.15.0.dist-info → synmax_api_python_client-4.16.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.45.1)
+Generator: setuptools (79.0.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

synmax/hyperion/v4/start_hyperion_client.py

@@ -1,27 +0,0 @@
-# from synmax.hyperion.v4.hyperion_client import HyperionApiClient
-
-# access_token = "eyJwcm9qZWN0X2lkIjogIlN5bm1heCBjb21tZXJjaWFsIEFQSSIsICJwcml2YXRlX2tleSI6ICIwQndzX0ExMFpkdVQyaWlNLS1lbXh3Mk5BNUkxa09kdFNVai04RjVvNzU4IiwgImNsaWVudF9pZCI6ICJGZWxpeCBLZXkiLCAidHlwZSI6ICJvbmVfeWVhcl9saWNlbnNlZF9jdXN0b21lciIsICJzdGFydF9kYXRlIjogIjAzLzE5LzIwMjQiLCAiZW5kX2RhdGUiOiAiMDMvMTkvMjAyNSIsICJ0cmlhbF9saWNlbnNlIjogZmFsc2UsICJpc3N1ZV9kYXRldGltZSI6ICIxOS0wMy0yMDI0IDE0OjI0OjA4IiwgImFkbWluX3VzZXIiOiBmYWxzZSwgInVzZXJfcm9sZXMiOiBbImh5cGVyaW9uIiwgInZ1bGNhbiJdfQ=="
-
-# client = HyperionApiClient(access_token=access_token)
-
-# res = client.wells(response_fields=["county", "date_completion", "date_first_production", "date_permit", "date_spud", "depth_measured", "depth_tvd", "horizontal_length", "lat_bottomhole", "lon_bottomhole", "lat_surface", "lon_surface", "operator", "region_natgas", "state_code", "sub_region_natgas", "well_id", "wellbore_type", "wellpad_id", "produced_formation", "produced_basin"], date_first_production_min="2023-01-31", date_first_production_max="2024-09-01")
-# # res = client.daily_production()
-# df = res.df()
-# print(df)
-
-# from synmax.hyperion.v4 import HyperionApiClient
-
-from synmax.hyperion.v4 import HyperionApiClient
-
-SYNMAX_ACCESS_TOKEN = "eyJwcm9qZWN0X2lkIjogIlN5bm1heCBjb21tZXJjaWFsIEFQSSIsICJwcml2YXRlX2tleSI6ICIwQndzX0ExMFpkdVQyaWlNLS1lbXh3Mk5BNUkxa09kdFNVai04RjVvNzU4IiwgImNsaWVudF9pZCI6ICJGZWxpeCBLZXkiLCAidHlwZSI6ICJvbmVfeWVhcl9saWNlbnNlZF9jdXN0b21lciIsICJzdGFydF9kYXRlIjogIjAzLzE5LzIwMjQiLCAiZW5kX2RhdGUiOiAiMDMvMTkvMjAyNSIsICJ0cmlhbF9saWNlbnNlIjogZmFsc2UsICJpc3N1ZV9kYXRldGltZSI6ICIxOS0wMy0yMDI0IDE0OjI0OjA4IiwgImFkbWluX3VzZXIiOiBmYWxzZSwgInVzZXJfcm9sZXMiOiBbImh5cGVyaW9uIiwgInZ1bGNhbiJdfQ=="
-hyperion_api_client = HyperionApiClient(access_token=SYNMAX_ACCESS_TOKEN)
-hyperion_api_client._write_stub()
-
-# wells_resp = hyperion_api_client.wells(response_fields=["county", "date_completion", "date_first_production", "date_permit", "date_spud", "depth_measured", "depth_tvd", "horizontal_length", "lat_bottomhole", "lon_bottomhole", "lat_surface", "lon_surface", "operator", "region_natgas", "state_code", "sub_region_natgas", "well_id", "wellbore_type", "wellpad_id", "produced_formation", "produced_basin"], date_first_production_min="2023-01-31", date_first_production_max="2024-09-01")
-results = hyperion_api_client.fetch_tils_expanded()
-results_df = results.df()
-results_df.head()
-print(results_df)
-# wells_df = wells_resp.df()
-# wells_df.head()
-# print(wells_df)

synmax/leviaton/start_leviaton_client.py

@@ -1,105 +0,0 @@
-from synmax.leviaton.v1.leviaton_client import LeviatonApiClient
-import requests
-headers={'x-api-key': '36b5ee11-c0c8-4af2-a1d1-ffdd5447597b', "Accept": "application/json"}
-key = '36b5ee11-c0c8-4af2-a1d1-ffdd5447597b'
-# client = LeviatonApiClient(access_token=headers['x-api-key'])
-import json
-
-# claims = {
-#     "claims": [
-#         {"claim_name": "leviaton_volume_flows", "claim_json": {"name": "leviaton_countries", "type": "api", "filters": {}}},
-#         {"claim_name": "leviaton_terminals", "claim_json": {"name": "leviaton_terminals", "type": "api", "filters": {}}},
-#         {"claim_name": "leviaton_transactions", "claim_json": {"name": "leviaton_transactions", "type": "api", "filters": {}}},
-#         {"claim_name": "leviaton_vessels", "claim_json": {"name": "leviaton_volume_flows", "type": "api", "filters": {}}},
-#     ]
-# }
-# url = f"https://leviaton.api.synmax.com/v1/openapi.yaml"
-# url = "http://127.0.0.1:8080/v1/openapi.yaml"
-# client = LeviatonApiClient(access_token=key)
-
-# response = requests.get(url, headers=headers, verify=False)
-# response.raise_for_status()
-
-# with open(client._spec, "wb") as f:
-#     f.write(response.content)
-# client._write_stub()
-
-# payload = {
-#       "destination_polygons": [
-#         [
-#             [-125.0, 24.5],
-#             [-125.0, 49.5],
-#             [-66.9, 49.5],
-#             [-66.9, 24.5],
-#             [-125.0, 24.5]
-#         ],
-#         [
-#             [122.9, 24.0],
-#             [122.9, 45.5],
-#             [146.0, 45.5],
-#             [146.0, 24.0],
-#             [122.9, 24.0]
-#         ]
-#         ],
-#     "from_timestamp": "2025-05-11T12:55:47.957167",
-#     "to_timestamp": "2025-05-21T12:55:47.957167",
-
-# }
-# results = client.volume_flows_history(transaction_type='loading')
-# # results = client.volume_flows(**payload)
-# print(results.df())
-
-# res = client.transactions(destination_country_codes=["US"])
-# print(res.df())
-
-# for result in results:
-#     print(result)
-
-# breakpoint()
-
-# from synmax.leviaton.v1.leviaton_client import LeviatonApiClient
-
-# API Key - Replace with your actual API key
-# api_key = "36b5ee11-c0c8-4af2-a1d1-ffdd5447597b"
-
-# Initialize the client
-# client = LeviatonApiClient(access_token=key)
-# client._write_stub()
-
-# Fetch transactions for USA terminals
-# result = client.vessels_history(from_timestamp="2025-01-01T00:00:00Z", to_timestamp="2025-01-22T00:00:00Z")
-
-# Fetch transactions from specific terminals
-# result = client.transactions_history(
-#     destination_terminals=["LNG Canada", "Altamira", "Freeport", "Corpus Christi"]
-# )
-
-# result = client.terminals(countries=["USA"])
-# result = client.transactions()
-# result = client.vessels()
-# result = client.vessels_details()
-# result = client.volume_flows_history(transaction_type='loading')
-# result = client.volume_flows(transaction_type='loading')
-# result = client.countries()
-# result = client.transactions_details()
-# result = client.transactions_forecast()
-# result = client.transactions_forecast_details()
-# result = client.transactions_forecast_history()
-# result = client.transactions_forecast_history_details()
-# result = client.vessels_history()
-
-
-# print(result.df())for record in result:
-#     print(record)
-access_token = "eyJwcm9qZWN0X2lkIjogIlN5bm1heCBjb21tZXJjaWFsIEFQSSIsICJwcml2YXRlX2tleSI6ICI5V2lYYUZqdXl1ZkdERXBRSUFhWWd6NG4wZlZLajktVjJocHRaM0RoSWdVIiwgImNsaWVudF9pZCI6ICJzeWRuZWVfZHRpbCIsICJ0eXBlIjogImxvbmdfdGVybV9saWNlbnNlZF9jdXN0b21lciIsICJzdGFydF9kYXRlIjogIjA5LzEyLzIwMjUiLCAiZW5kX2RhdGUiOiAiMTIvMzEvOTk5OSIsICJ0cmlhbF9saWNlbnNlIjogZmFsc2UsICJpc3N1ZV9kYXRldGltZSI6ICIxMi0wOS0yMDI1IDE5OjI5OjQ1IiwgImFkbWluX3VzZXIiOiBmYWxzZSwgInVzZXJfcm9sZXMiOiBbImR0aWxfZXhwYW5zaW9uIiwgImh5cGVyaW9uIiwgInZ1bGNhbiJdfQ=="
-
-from synmax.leviaton.v1 import LeviatonApiClient
-LeviatonApiClient._write_stub()
-leviaton_client = LeviatonApiClient(access_token=access_token)
-
-# Method name:
-
-result =leviaton_client.transactions_history(loading_origin_terminals=["Corpus Christi"], from_timestamp="2025-07-15T22:43:41.371622+00:00", to_timestamp="2025-07-27T22:43:41.371622+00:00")
-
-for record in result:
-    print(record)

synmax/leviaton/start_leviaton_client2.py

@@ -1,81 +0,0 @@
-from synmax.leviaton.v1.leviaton_client import LeviatonApiClient
-
-
-# API Key - Replace with your actual API key
-api_key = "36b5ee11-c0c8-4af2-a1d1-ffdd5447597b"
-
-# Initialize the client
-client = LeviatonApiClient(access_token=api_key)
-
-# Fetch transactions for USA terminals
-# print('starting')
-# result = client.transac
-
-# print(result.df())
-
-import os
-import unittest
-from synmax.leviaton.v1.leviaton_client import LeviatonApiClient
-import json
-
-class TestLeviatonApiMethods(unittest.TestCase):
-    @classmethod
-    def setUpClass(cls):
-        api_key = "36b5ee11-c0c8-4af2-a1d1-ffdd5447597b"
-        # x_auth_data = json.dumps({"claims": [{"claim_name":"leviaton_countries","claim_json":{"name":"leviaton_countries","type":"api","filters":{}}},{"claim_name":"leviaton_terminals","claim_json":{"name":"leviaton_terminals","type":"api","filters":{}}},{"claim_name":"leviaton_transactions","claim_json":{"name":"leviaton_transactions","type":"api","filters":{}}},{"claim_name":"leviaton_vessels","claim_json":{"name":"leviaton_vessels","type":"api","filters":{}}},{"claim_name":"leviaton_volume_flows","claim_json":{"name":"leviaton_volume_flows","type":"api","filters":{}}}]})
-        cls.client = LeviatonApiClient(access_token=api_key)
-
-    def test_all_api_methods(self):
-        api_methods = [
-            "countries",
-            "healthcheck",
-            "terminals",
-            "vessels",
-            # "vessels_history",
-            "vessels_details",
-            "volume_flows",
-            "volume_flows/history",
-            "transactions",
-            "transactions_details",
-            "transactions_forecast",
-            "transactions_forecast_details",
-            "transactions_forecast_history",
-            "transactions_forecast_history_details",
-            "transactions_history",  
-        ]
-
-        for method_name in api_methods:
-            with self.subTest(method=method_name):
-                print(f"Testing {method_name}...")
-                method = getattr(self.client, method_name, None)
-                self.assertIsNotNone(method, f"Method '{method_name}' not found on client")
-
-                try:
-                    result = method()
-                    df = result.df()
-                    self.assertIsNotNone(df, f"{method_name} returned None")
-                    self.assertFalse(df.empty, f"{method_name} returned an empty dataframe")
-                except Exception as e:
-                    self.fail(f"{method_name} raised an exception: {e}")
-
-if __name__ == "__main__":
-    unittest.main()
-
-
-# from synmax.leviaton.v1.leviaton_client import LeviatonApiClient
-
-# # API Key - Replace with your actual API key
-# api_key = "36b5ee11-c0c8-4af2-a1d1-ffdd5447597b"
-
-# # Initialize the client
-# client = LeviatonApiClient(access_token=api_key)
-
-# # Fetch transactions for USA terminals
-# result = client.transactions_history(destination_country_codes=["US"])
-
-# # Fetch transactions from specific terminals
-# result = client.transactions_history(
-#     destination_terminals=["LNG Canada", "Altamira", "Freeport", "Corpus Christi"]
-# )
-
-# print(result.df())

synmax/vulcan/start_vulcan_python_client.py

@@ -1,14 +0,0 @@
-
-
-
-from synmax.vulcan.v2 import VulcanApiClient
-
-SYNMAX_ACCESS_TOKEN = "eyJwcm9qZWN0X2lkIjogIlN5bm1heCBjb21tZXJjaWFsIEFQSSIsICJwcml2YXRlX2tleSI6ICIwQndzX0ExMFpkdVQyaWlNLS1lbXh3Mk5BNUkxa09kdFNVai04RjVvNzU4IiwgImNsaWVudF9pZCI6ICJGZWxpeCBLZXkiLCAidHlwZSI6ICJvbmVfeWVhcl9saWNlbnNlZF9jdXN0b21lciIsICJzdGFydF9kYXRlIjogIjAzLzE5LzIwMjQiLCAiZW5kX2RhdGUiOiAiMDMvMTkvMjAyNSIsICJ0cmlhbF9saWNlbnNlIjogZmFsc2UsICJpc3N1ZV9kYXRldGltZSI6ICIxOS0wMy0yMDI0IDE0OjI0OjA4IiwgImFkbWluX3VzZXIiOiBmYWxzZSwgInVzZXJfcm9sZXMiOiBbImh5cGVyaW9uIiwgInZ1bGNhbiJdfQ=="
-vulcan_api_client = VulcanApiClient(access_token=SYNMAX_ACCESS_TOKEN)
-vulcan_api_client._write_stub()
-
-# wells_resp = vulcan_api_client.iir_data()
-
-# wells_df = wells_resp.df()
-# wells_df.head()
-# print(wells_df)

synmax/vulcan/v2/start_vulcan_client.py

@@ -1,27 +0,0 @@
-from synmax.vulcan.v2.vulcan_client import VulcanApiClient
-import json
-
-VulcanApiClient._write_stub()
-# access_token = os.environ.get("ACCESS_TOKEN")
-
-claims_dict = {
-    "claims": [
-        {"claim_name": "vulcan_datacenters", "claim_json": {"name": "vulcan_datacenters", "type": "api", "filters": {}}},
-        {"claim_name": "vulcan_underconstruction", "claim_json": {"name": "vulcan_underconstruction", "type": "api", "filters": {}}},
-        {"claim_name": "vulcan_lng_projects", "claim_json": {"name": "vulcan_lng_projects", "type": "api", "filters": {}}},
-        {"claim_name": "vulcan_metadata_history", "claim_json": {"name": "vulcan_metadata_history", "type": "api", "filters": {}}},
-        {"claim_name": "vulcan_project_rankings", "claim_json": {"name": "vulcan_project_rankings", "type": "api", "filters": {}}},
-    ]
-}
-
-client = VulcanApiClient(access_token='PSq8zWS3FgHnVGcE2Yz4ZNOBk4SRpUPI')
-
-
-payload = {}
-
-got = client.lng_projects()
-df = got.df()
-print(df)
-
-print(got)
-breakpoint()

synmax/vulcan/v2/start_vulcan_client2.py

@@ -1,43 +0,0 @@
-# result = client.transac
-
-# print(result.df())
-
-import os
-import unittest
-from synmax.vulcan.v2.vulcan_client import VulcanApiClient
-import json
-
-class TestVulcanApiMethods(unittest.TestCase):
-    @classmethod
-    def setUpClass(cls):
-        api_key = "PSq8zWS3FgHnVGcE2Yz4ZNOBk4SRpUPI"
-        x_auth_data = json.dumps({"claims": [{"claim_name":"vulcan_datacenters","claim_json":{"name":"vulcan_datacenters","type":"api","filters":{}}},{"claim_name":"vulcan_underconstruction","claim_json":{"name":"vulcan_underconstruction","type":"api","filters":{}}},{"claim_name":"vulcan_lng_projects","claim_json":{"name":"vulcan_lng_projects","type":"api","filters":{}}},{"claim_name":"vulcan_project_rankings","claim_json":{"name":"vulcan_project_rankings","type":"api","filters":{}}}]})
-        cls.client = VulcanApiClient(access_token=api_key)
-
-    def test_all_api_methods(self):
-        api_methods = [
-            "health",
-            "datacenters",
-            "underconstruction",
-            "lng_projects",
-            "project_rankings",
-            "iir_data"
-        ]
-
-        for method_name in api_methods:
-            with self.subTest(method=method_name):
-                print(f"Testing {method_name}...")
-                method = getattr(self.client, method_name, None)
-                self.assertIsNotNone(method, f"Method '{method_name}' not found on client")
-
-                try:
-                    result = method()
-                    df = result.df()
-                    print(df)
-                    self.assertIsNotNone(df, f"{method_name} returned None")
-                    self.assertFalse(df.empty, f"{method_name} returned an empty dataframe")
-                except Exception as e:
-                    self.fail(f"{method_name} raised an exception: {e}")
-
-if __name__ == "__main__":
-    unittest.main()