most-client 1.0.18__py3-none-any.whl → 1.0.20__py3-none-any.whl

most/api.py

@@ -9,6 +9,7 @@ import requests
 from adaptix import Retort
 from pydub import AudioSegment
 
+from most.score_calculation import ScoreCalculation
 from most.types import (
     Audio,
     DialogResult,
@@ -17,7 +18,7 @@ from most.types import (
     Script,
     StoredAudioData,
     Text,
-    is_valid_id,
+    is_valid_id, SearchParams, ScriptScoreMapping,
 )
 
 
@@ -48,6 +49,7 @@ class MostClient(object):
         self.session = requests.Session()
         self.access_token = None
         self.model_id = model_id
+        self.score_modifier = None
 
         self.refresh_access_token()
 
@@ -77,11 +79,13 @@ class MostClient(object):
                             model_id=self.model_id)
         client.access_token = self.access_token
         client.session = self.session
+        client.score_modifier = self.score_modifier
         return client
 
     def with_model(self, model_id):
         client = self.clone()
         client.model_id = model_id
+        client.score_modifier = None
         return client
 
     def refresh_access_token(self):
@@ -176,12 +180,23 @@ class MostClient(object):
         resp = self.get(f"https://api.the-most.ai/api/external/{self.client_id}/model/{self.model_id}/script")
         return self.retort.load(resp.json(), Script)
 
+    def get_score_modifier(self):
+        if self.score_modifier is None:
+            if not is_valid_id(self.model_id):
+                raise RuntimeError("Please choose valid model to apply. [try list_models()]")
+
+            resp = self.get(f"https://api.the-most.ai/api/external/{self.client_id}/model/{self.model_id}/score_mapping")
+            score_mapping = self.retort.load(resp.json(), List[ScriptScoreMapping])
+            self.score_modifier = ScoreCalculation(score_mapping)
+        return self.score_modifier
+
     def list_models(self):
         resp = self.get("https://api.the-most.ai/api/external/list_models")
         return [self.with_model(model['model'])
                 for model in resp.json()]
 
-    def apply(self, audio_id) -> Result:
+    def apply(self, audio_id,
+              modify_scores: bool = False) -> Result:
         if not is_valid_id(self.model_id):
             raise RuntimeError("Please choose valid model to apply. [try list_models()]")
 
@@ -189,9 +204,13 @@ class MostClient(object):
             raise RuntimeError("Please use valid audio_id. [try audio.id from list_audios()]")
 
         resp = self.post(f"https://api.the-most.ai/api/external/{self.client_id}/audio/{audio_id}/model/{self.model_id}/apply")
-        return self.retort.load(resp.json(), Result)
+        result = self.retort.load(resp.json(), Result)
+        if modify_scores:
+            result = self.score_modifier.modify(result)
+        return result
 
-    def apply_later(self, audio_id) -> Result:
+    def apply_later(self, audio_id,
+                    modify_scores: bool = False) -> Result:
         if not is_valid_id(self.model_id):
             raise RuntimeError("Please choose valid model to apply. [try list_models()]")
 
@@ -199,7 +218,10 @@ class MostClient(object):
             raise RuntimeError("Please use valid audio_id. [try audio.id from list_audios()]")
 
         resp = self.post(f"https://api.the-most.ai/api/external/{self.client_id}/audio/{audio_id}/model/{self.model_id}/apply_async")
-        return self.retort.load(resp.json(), Result)
+        result = self.retort.load(resp.json(), Result)
+        if modify_scores:
+            result = self.score_modifier.modify(result)
+        return result
 
     def get_job_status(self, audio_id) -> JobStatus:
         if not is_valid_id(self.model_id):
@@ -211,7 +233,8 @@ class MostClient(object):
         resp = self.post(f"https://api.the-most.ai/api/external/{self.client_id}/audio/{audio_id}/model/{self.model_id}/apply_status")
         return self.retort.load(resp.json(), JobStatus)
 
-    def fetch_results(self, audio_id) -> Result:
+    def fetch_results(self, audio_id,
+                      modify_scores: bool = False) -> Result:
         if not is_valid_id(self.model_id):
             raise RuntimeError("Please choose valid model to apply. [try list_models()]")
 
@@ -219,7 +242,10 @@ class MostClient(object):
             raise RuntimeError("Please use valid audio_id. [try audio.id from list_audios()]")
 
         resp = self.get(f"https://api.the-most.ai/api/external/{self.client_id}/audio/{audio_id}/model/{self.model_id}/results")
-        return self.retort.load(resp.json(), Result)
+        result = self.retort.load(resp.json(), Result)
+        if modify_scores:
+            result = self.score_modifier.modify(result)
+        return result
 
     def fetch_text(self, audio_id: str) -> Result:
         if not is_valid_id(self.model_id):
@@ -296,3 +322,24 @@ class MostClient(object):
         audio = AudioSegment.from_file(io.BytesIO(resp.content),
                                        format=format)
         return audio
+
+    def index_audio(self, audio_id: str) -> None:
+        resp = self.post(f"https://api.the-most.ai/api/external/{self.client_id}/audio/{audio_id}/model/{self.model_id}/indexing")
+        if resp.status_code >= 400:
+            raise RuntimeError("Audio can't be indexed")
+        return None
+
+    def search(self,
+               query: str,
+               filter: SearchParams,
+               limit: int = 10) -> List[Audio]:
+        resp = self.post(f"https://api.the-most.ai/api/external/{self.client_id}/model/{self.model_id}/search",
+                         json={
+                             "query": query,
+                             "filter": filter.to_dict(),
+                             "limit": limit,
+                         })
+        if resp.status_code >= 400:
+            raise RuntimeError("Audio can't be indexed")
+        audio_list = resp.json()
+        return self.retort.load(audio_list, List[Audio])

most/async_api.py

@@ -9,6 +9,7 @@ import json5
 from adaptix import Retort
 from pydub import AudioSegment
 
+from most.score_calculation import ScoreCalculation
 from most.types import (
     Audio,
     DialogResult,
@@ -17,7 +18,7 @@ from most.types import (
     Script,
     StoredAudioData,
     Text,
-    is_valid_id,
+    is_valid_id, SearchParams, ScriptScoreMapping,
 )
 
 
@@ -48,6 +49,7 @@ class AsyncMostClient(object):
         self.session = httpx.AsyncClient()
         self.access_token = None
         self.model_id = model_id
+        self.score_modifier: Optional[ScoreCalculation] = None
 
     async def __aenter__(self):
         await self.session.__aenter__()
@@ -83,6 +85,7 @@ class AsyncMostClient(object):
                                  model_id=self.model_id)
         client.access_token = self.access_token
         client.session = self.session
+        client.score_modifier = self.score_modifier
         return client
 
     def with_model(self, model_id):
@@ -90,6 +93,7 @@ class AsyncMostClient(object):
         if not is_valid_id(self.model_id):
             raise RuntimeError("Please choose valid model to apply. [try list_models()]")
         client.model_id = model_id
+        client.score_modifier = None
         return client
 
     async def refresh_access_token(self):
@@ -185,12 +189,23 @@ class AsyncMostClient(object):
         resp = await self.get(f"https://api.the-most.ai/api/external/{self.client_id}/model/{self.model_id}/script")
         return self.retort.load(resp.json(), Script)
 
+    async def get_score_modifier(self):
+        if self.score_modifier is None:
+            if not is_valid_id(self.model_id):
+                raise RuntimeError("Please choose valid model to apply. [try list_models()]")
+
+            resp = await self.get(f"https://api.the-most.ai/api/external/{self.client_id}/model/{self.model_id}/score_mapping")
+            score_mapping = self.retort.load(resp.json(), List[ScriptScoreMapping])
+            self.score_modifier = ScoreCalculation(score_mapping)
+        return self.score_modifier
+
     async def list_models(self):
         resp = await self.get("https://api.the-most.ai/api/external/list_models")
         return [self.with_model(model['model'])
                 for model in resp.json()]
 
-    async def apply(self, audio_id) -> Result:
+    async def apply(self, audio_id,
+                    modify_scores: bool = False) -> Result:
         if not is_valid_id(self.model_id):
             raise RuntimeError("Please choose valid model to apply. [try list_models()]")
 
@@ -198,9 +213,13 @@ class AsyncMostClient(object):
             raise RuntimeError("Please use valid audio_id. [try audio.id from list_audios()]")
 
         resp = await self.post(f"https://api.the-most.ai/api/external/{self.client_id}/audio/{audio_id}/model/{self.model_id}/apply")
-        return self.retort.load(resp.json(), Result)
+        result = self.retort.load(resp.json(), Result)
+        if modify_scores:
+            result = self.score_modifier.modify(result)
+        return result
 
-    async def apply_later(self, audio_id):
+    async def apply_later(self, audio_id,
+                          modify_scores: bool = False) -> Result:
         if not is_valid_id(self.model_id):
             raise RuntimeError("Please choose valid model to apply. [try list_models()]")
 
@@ -208,7 +227,10 @@ class AsyncMostClient(object):
             raise RuntimeError("Please use valid audio_id. [try audio.id from list_audios()]")
 
         resp = await self.post(f"https://api.the-most.ai/api/external/{self.client_id}/audio/{audio_id}/model/{self.model_id}/apply_async")
-        return self.retort.load(resp.json(), Result)
+        result = self.retort.load(resp.json(), Result)
+        if modify_scores:
+            result = self.score_modifier.modify(result)
+        return result
 
     async def get_job_status(self, audio_id) -> JobStatus:
         if not is_valid_id(self.model_id):
@@ -220,7 +242,8 @@ class AsyncMostClient(object):
         resp = await self.post(f"https://api.the-most.ai/api/external/{self.client_id}/audio/{audio_id}/model/{self.model_id}/apply_status")
         return self.retort.load(resp.json(), JobStatus)
 
-    async def fetch_results(self, audio_id) -> Result:
+    async def fetch_results(self, audio_id,
+                            modify_scores: bool = False) -> Result:
         if not is_valid_id(self.model_id):
             raise RuntimeError("Please choose valid model to apply. [try list_models()]")
 
@@ -228,7 +251,10 @@ class AsyncMostClient(object):
             raise RuntimeError("Please use valid audio_id. [try audio.id from list_audios()]")
 
         resp = await self.get(f"https://api.the-most.ai/api/external/{self.client_id}/audio/{audio_id}/model/{self.model_id}/results")
-        return self.retort.load(resp.json(), Result)
+        result = self.retort.load(resp.json(), Result)
+        if modify_scores:
+            result = self.score_modifier.modify(result)
+        return result
 
     async def fetch_text(self, audio_id) -> Result:
         if not is_valid_id(self.model_id):
@@ -301,3 +327,24 @@ class AsyncMostClient(object):
         audio = AudioSegment.from_file(io.BytesIO(resp.content),
                                        format=format)
         return audio
+
+    async def index_audio(self, audio_id: str) -> None:
+        resp = await self.post(f"https://api.the-most.ai/api/external/{self.client_id}/audio/{audio_id}/model/{self.model_id}/indexing")
+        if resp.status_code >= 400:
+            raise RuntimeError("Audio can't be indexed")
+        return None
+
+    async def search(self,
+                     query: str,
+                     filter: SearchParams,
+                     limit: int = 10) -> List[Audio]:
+        resp = await self.post(f"https://api.the-most.ai/api/external/{self.client_id}/model/{self.model_id}/search",
+                               json={
+                                   "query": query,
+                                   "filter": filter.to_dict(),
+                                   "limit": limit,
+                               })
+        if resp.status_code >= 400:
+            raise RuntimeError("Audio can't be indexed")
+        audio_list = resp.json()
+        return self.retort.load(audio_list, List[Audio])

most/score_calculation.py

@@ -0,0 +1,23 @@
+import dataclasses
+from typing import Dict, Tuple, List, Optional
+
+from .types import Result, ScriptScoreMapping
+
+
+class ScoreCalculation:
+    def __init__(self, score_mapping: List[ScriptScoreMapping]):
+        super(ScoreCalculation, self).__init__()
+        self.score_mapping = {
+            (sm.column, sm.subcolumn, sm.from_score): sm.to_score
+            for sm in score_mapping
+        }
+
+    def modify(self, result: Optional[Result]):
+        if result is None:
+            return None
+        result = dataclasses.replace(result)
+        for column_result in result.results:
+            for subcolumn_result in column_result.subcolumns:
+                subcolumn_result.score = self.score_mapping[(column_result.name, subcolumn_result.name, subcolumn_result.score)]
+
+        return result

most/types.py

@@ -53,6 +53,15 @@ class Script(DataClassJsonMixin):
     columns: List[Column]
 
 
+@dataclass_json
+@dataclass
+class ScriptScoreMapping(DataClassJsonMixin):
+    column: str
+    subcolumn: str
+    from_score: int
+    to_score: int
+
+
 @dataclass_json
 @dataclass
 class JobStatus(DataClassJsonMixin):
@@ -113,6 +122,32 @@ class DialogResult(DataClassJsonMixin):
     results: Optional[List[ColumnResult]]
 
 
+@dataclass_json
+@dataclass
+class StoredInfoCondition(DataClassJsonMixin):
+    key: str
+    match: Optional[str] = None
+    starts_with: Optional[str] = None
+    ends_with: Optional[str] = None
+
+
+@dataclass_json
+@dataclass
+class ResultsCondition(DataClassJsonMixin):
+    column: str
+    subcolumn: str
+    score_greater_than: Optional[int] = None
+    score_less_than: Optional[int] = None
+
+
+@dataclass_json
+@dataclass
+class SearchParams(DataClassJsonMixin):
+    must: List[StoredInfoCondition | ResultsCondition]
+    should: List[StoredInfoCondition | ResultsCondition]
+    must_not: List[StoredInfoCondition | ResultsCondition]
+
+
 def is_valid_objectid(oid: str) -> bool:
     """
     Check if a given string is a valid MongoDB ObjectId (24-character hex).

{most_client-1.0.18.dist-info → most_client-1.0.20.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: most-client
-Version: 1.0.18
+Version: 1.0.20
 Summary: Most AI API for https://the-most.ai
 Home-page: https://github.com/the-most-ai/most-client
 Author: George Kasparyants

most_client-1.0.20.dist-info/RECORD

@@ -0,0 +1,10 @@
+most/__init__.py,sha256=62uFFeM_1VVR83K3bTYWK3PEoqnmFCy9aWYerQ6U4Ds,67
+most/api.py,sha256=8OzUI_Af0Ct1hx0fopTf3bDGPU8gxWuuMP1VvxpAFiU,14227
+most/async_api.py,sha256=40orcOYLvFJTTlfYGIyyUXvvsfKYchDblRXzHNNGNPs,15124
+most/score_calculation.py,sha256=oGBEIzefKiqCS77BOX7-jHTvpLRkH0Vhnqu1IVDmsdM,800
+most/types.py,sha256=Qgyv261J8b1cfbmeITz1C9QgkoCMGQQd_L4t4M3dd6M,3603
+most_client-1.0.20.dist-info/METADATA,sha256=XTRaD7okJvsBLOJWUKlRTPaRhM423CFOkQ6wuT2_1XI,1027
+most_client-1.0.20.dist-info/WHEEL,sha256=jB7zZ3N9hIM9adW7qlTAyycLYW9npaWKLRzaoVcLKcM,91
+most_client-1.0.20.dist-info/top_level.txt,sha256=2g5fk02LKkM1hV3pVVti_LQ60TToLBcR2zQ3JEKGVk8,5
+most_client-1.0.20.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+most_client-1.0.20.dist-info/RECORD,,

most_client-1.0.18.dist-info/RECORD

@@ -1,9 +0,0 @@
-most/__init__.py,sha256=62uFFeM_1VVR83K3bTYWK3PEoqnmFCy9aWYerQ6U4Ds,67
-most/api.py,sha256=IvgklvaP9fvcr_fy-gGvnEDWcyxPRTxNN0MO492YgT0,12101
-most/async_api.py,sha256=tFFLTWhGVexVz5v9hYuNp4BqFEWTNSp_6DLSAQBjF9c,12858
-most/types.py,sha256=apUz6FHFAHWJNVvRh57wVQk5DFw2XKnLLhkAyWgtvfw,2825
-most_client-1.0.18.dist-info/METADATA,sha256=bJfi-Nsqkp3oHirr417vvUtJgo79AzaCOqsBUSUJq58,1027
-most_client-1.0.18.dist-info/WHEEL,sha256=jB7zZ3N9hIM9adW7qlTAyycLYW9npaWKLRzaoVcLKcM,91
-most_client-1.0.18.dist-info/top_level.txt,sha256=2g5fk02LKkM1hV3pVVti_LQ60TToLBcR2zQ3JEKGVk8,5
-most_client-1.0.18.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-most_client-1.0.18.dist-info/RECORD,,