masstack-python-client 0.0.4__py3-none-any.whl → 0.0.5__py3-none-any.whl

masstack_python_client/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "0.0.4"
+__version__ = "0.0.5"
 __homepage__ = "https://somconnexio.coop/"
 __author__ = "Borja Gimeno <borja.gimeno@somconnexio.coop>"
 __license__ = "GPL-3.0-only"

masstack_python_client/resources/enums/technology.py

@@ -0,0 +1,7 @@
+from enum import Enum
+
+
+class Technology(Enum):
+    ADSL = "ADSL"
+    FTTH = "FTTH"
+    MIFIJO = "MIFIJO"

masstack_python_client/resources/feasibility.py

@@ -1,6 +1,7 @@
 import os
 from typing import Optional, List
 from masstack_python_client.client import MasstackClient
+from masstack_python_client.resources.enums.technology import Technology
 from masstack_python_client.resources.models.address import (
     BuildingData,
     ClarifierData,
@@ -8,6 +9,18 @@ from masstack_python_client.resources.models.address import (
     StreetData,
     UnitData,
 )
+from masstack_python_client.resources.models.portability import PortabilityData
+
+
+"""
+FeasibilityResource
+├── Coverage
+│   ├── Streets
+│   ├── Buildings
+│   └── Units
+└── Portability
+    └── PortabilityCheck
+"""
 
 
 class FeasibilityResource:
@@ -17,6 +30,79 @@ class FeasibilityResource:
 
     _api_domain = "feasibility"
 
+    @classmethod
+    def _get_endpoint(cls, suffix: str) -> str:
+        return f"{cls._api_path}/{cls._api_subpath}{suffix}"
+
+    @classmethod
+    def _request(
+        cls,
+        *,
+        method: str,
+        suffix: Optional[str] = "",
+        header: Optional[dict] = None,
+        data: Optional[dict] = None,
+        params: Optional[dict] = None,
+    ) -> dict | list:
+        client = MasstackClient()
+        func = getattr(client, method)
+
+        return func(
+            api=cls._api_domain,
+            version=cls._version,
+            endpoint=cls._get_endpoint(suffix),
+            params=params,
+            data=data,
+            header=header,
+        )
+
+
+class Portability(FeasibilityResource):
+
+    _api_path = "portability"
+    _version = "v2"
+
+
+class PortabilityCheck(Portability):
+
+    _api_subpath = "portabilityCheck"
+
+    @classmethod
+    def check(
+        cls,
+        number: str,
+        address_id: str,
+        territory_owner: Optional[str] = None,
+        technical_id: Optional[str] = None,
+        technology: Technology = Technology.FTTH,
+    ) -> PortabilityData:
+        """Returns whether the portability process can be carried out
+        and whether it requires a new installation
+
+        Args:
+            number (str): Fixed number to be ported
+            address_id (str): Unique address ID
+            territory_owner (str): Territory owner. Not mandatory if technology is MIFIJO
+            technical_id (str): Technical id. Not mandatory if technology is MIFIJO. g17 or g37
+            technology (Technology): Technology to be provided
+
+        Returns:
+            PortabilityData
+
+        """
+
+        portability = cls._request(
+            method="post",
+            data={
+                "number": number,
+                "territoryOwner": territory_owner,
+                "technicalId": technical_id,
+                "addressId": address_id,
+                "technology": technology.value,
+            },
+        )
+        return PortabilityData.from_dict(**portability)
+
 
 class Coverage(FeasibilityResource):
 
@@ -31,10 +117,6 @@ class Coverage(FeasibilityResource):
     def _sf_channel() -> str:
         return os.environ.get("MASSTACK_COVERAGE_CHANNEL", "")
 
-    @classmethod
-    def _get_endpoint(cls, subpath: str) -> str:
-        return f"{cls._api_path}/{subpath}"
-
     @classmethod
     def _get_header(cls, uuid: str) -> dict:
         return {
@@ -44,25 +126,8 @@ class Coverage(FeasibilityResource):
         }
 
     @classmethod
-    def _request(
-        cls,
-        method: str,
-        subpath: str,
-        uuid: str,
-        data: Optional[dict] = None,
-        params: Optional[dict] = None,
-    ) -> dict:
-        client = MasstackClient()
-        func = getattr(client, method)
-
-        return func(
-            api=cls._api_domain,
-            version=cls._version,
-            endpoint=cls._get_endpoint(subpath),
-            params=params,
-            data=data,
-            header=cls._get_header(uuid),
-        )
+    def _request(cls, *, uuid: str, **kwargs) -> dict | list:
+        return super()._request(header=cls._get_header(uuid), **kwargs)
 
 
 class Streets(Coverage):
@@ -83,9 +148,8 @@ class Streets(Coverage):
 
         """
         streets = cls._request(
-            "get",
-            cls._api_subpath,
-            uuid,
+            method="get",
+            uuid=uuid,
             params={"search": text},
         )
         return [StreetData.from_dict(uuid, lang, **street) for street in streets]
@@ -104,9 +168,9 @@ class Streets(Coverage):
             ClarifierData
         """
         clarifiers = cls._request(
-            "get",
-            f"{cls._api_subpath}/clarifiers/{street_id}",
-            uuid,
+            method="get",
+            suffix=f"/clarifiers/{street_id}",
+            uuid=uuid,
         )
 
         return [ClarifierData(uuid, **clarifier) for clarifier in clarifiers]
@@ -129,9 +193,8 @@ class Buildings(Coverage):
             BuildingData
         """
         buildings = cls._request(
-            "get",
-            cls._api_subpath,
-            uuid,
+            method="get",
+            uuid=uuid,
             params={"search": text},
         )
         return [
@@ -154,9 +217,9 @@ class Buildings(Coverage):
             BuildingData
         """
         building = cls._request(
-            "get",
-            f"{cls._api_subpath}/{id}",
-            uuid,
+            method="get",
+            suffix=f"/{id}",
+            uuid=uuid,
             params={"unit_to_data": unit_to_data},
         )
         return BuildingData.from_dict(
@@ -193,9 +256,9 @@ class Buildings(Coverage):
         """
 
         buildings = cls._request(
-            "post",
-            f"{cls._api_subpath}/search",
-            uuid,
+            method="post",
+            suffix="/search",
+            uuid=uuid,
             data={
                 "way_name": way_name,
                 "number": number,
@@ -229,9 +292,9 @@ class Units(Coverage):
             UnitData
         """
         unit = cls._request(
-            "get",
-            f"{cls._api_subpath}/{unit_id}",
-            uuid,
+            method="get",
+            suffix=f"/{unit_id}",
+            uuid=uuid,
             params={"parent_coverage": parent_coverage},
         )
         return UnitData.from_dict(
@@ -257,9 +320,9 @@ class Units(Coverage):
             CoverageData
         """
         unit = cls._request(
-            "get",
-            f"{cls._api_subpath}/extra",
-            uuid,
+            method="get",
+            suffix="/extra",
+            uuid=uuid,
             params={"id": unit_id, "territory_owner": territory_owner},
         )
         return CoverageData.from_dict(

masstack_python_client/resources/models/fixed_phone.py

@@ -0,0 +1,6 @@
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class FixedPhoneData:
+    number: str

masstack_python_client/resources/models/portability.py

@@ -0,0 +1,39 @@
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class InstallationInfoData:
+    internalAccess: bool
+    iua: str
+    brand: str
+    number: str
+    documentNumber: str
+    gescal: str
+
+
+@dataclass(frozen=True)
+class OperatorData:
+    code: str
+    name: str
+
+
+@dataclass(frozen=True)
+class PortabilityData:
+    internalPortability: bool
+    isPortable: bool
+    installationRequired: bool
+    operator: OperatorData
+    installationInfo: InstallationInfoData
+
+    @classmethod
+    def from_dict(
+        cls,
+        operator,
+        installationInformation,
+        **kwargs,
+    ):
+        return cls(
+            operator=OperatorData(**operator),
+            installationInfo=InstallationInfoData(**installationInformation),
+            **kwargs,
+        )

masstack_python_client/resources/provision.py

@@ -0,0 +1,61 @@
+from typing import Optional
+from masstack_python_client.client import MasstackClient
+from masstack_python_client.resources.models.fixed_phone import FixedPhoneData
+
+
+"https://provision-inventory-network.sta.masstack.com/v1/orgs/marblanca/fixed/number"
+
+
+class ProvisionNetworkResource:
+    """not documented"""
+
+    _api_domain = "provision-inventory-network"
+
+
+class FixedPhone(ProvisionNetworkResource):
+    _api_path = "fixed"
+    _version = "v1"
+
+    @classmethod
+    def _get_endpoint(cls, subpath: str) -> str:
+        return f"{cls._api_path}/{subpath}"
+
+    @classmethod
+    def _request(
+        cls,
+        method: str,
+        subpath: str,
+        params: Optional[dict] = None,
+        data: Optional[dict] = None,
+    ) -> dict:
+        client = MasstackClient()
+        func = getattr(client, method)
+
+        return func(
+            api=cls._api_domain,
+            version=cls._version,
+            endpoint=cls._get_endpoint(subpath),
+            params=params,
+            data=data,
+        )
+
+    @classmethod
+    def get_number(cls, postal_code: str, state: str = "new"):
+        """Obtain fixed numbering for sale.
+
+        Args:
+            postal_code (str): postal code
+            state (str): state
+        Returns:
+            FixedPhoneData
+
+        """
+        response = cls._request(
+            "get",
+            "number",
+            {
+                "postal_code": postal_code,
+                "state": state,
+            },
+        )
+        return FixedPhoneData(response["number"])

{masstack_python_client-0.0.4.dist-info → masstack_python_client-0.0.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: masstack-python-client
-Version: 0.0.4
+Version: 0.0.5
 Summary: This Python API client provides access to masmovil core API domains
 Author-email: Borja Gimeno <borja.gimeno@somconnexio.coop>
 License: GPL-3.0-only
@@ -37,6 +37,9 @@ This Python API client provides access to masmovil core API domains.
         - Units:
             - get: returns a unit by id with a list of coverages
             - get_coverage: returns coverage info for a unit id and territory_owner
+    - Portability - Checks if a landline portability or an access transfer is allowed
+        - PortabilityCheck:
+            - check: Returns whether the portability process can be carried out and whether it requires a new installation
 
 * Customers
     - Signups - access to signups new clients
@@ -49,6 +52,11 @@ This Python API client provides access to masmovil core API domains.
     - bundled_products - access to bundled products
         - get sellable bundled products
 
+* Provision inventory network
+    - fixed - Obtain fixed numbering for sale
+        - get number
+
+
 ## Installation
 
 ```commandline

{masstack_python_client-0.0.4.dist-info → masstack_python_client-0.0.5.dist-info}/RECORD

@@ -1,4 +1,4 @@
-masstack_python_client/__init__.py,sha256=6TDc7ulFeITzFwqtn2Uqj3pBTqGRHYGHN43zbbpu5aY,154
+masstack_python_client/__init__.py,sha256=LglbAMxBWseiHlWgcEl_eDDUXuK1sHtH-Rx6_y6YVbU,154
 masstack_python_client/client.py,sha256=5b52Q2ekABi7DlZPsNobcmaJXOKzZfhKE_kHvNEqE9Q,2496
 masstack_python_client/exceptions.py,sha256=HkX1cP4Ryeas59CzIVW8N5gmnRE1x0yQUQwS3tm9QZQ,2115
 masstack_python_client/auth/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -12,7 +12,8 @@ masstack_python_client/data/unit_translation.csv,sha256=34FPfaCC1eSmBfV0BbHSHJ-t
 masstack_python_client/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 masstack_python_client/resources/catalogue.py,sha256=6evwB75NC2jRsTQ6Zz3-qmzNo9dFsQhdtAtYhwW9Zu0,4002
 masstack_python_client/resources/customers.py,sha256=9GTXQ5fiVosbAzK__uydZOBu9wXC9yO4pHufseHqD38,2924
-masstack_python_client/resources/feasibility.py,sha256=DbiPwWa9orSmITgcID7RVPKf7b50Pk8h1XQh0xxGYhw,7119
+masstack_python_client/resources/feasibility.py,sha256=WSPprQFMoJAJFzlI65YLnt6AfErnfoziMbBqxpZYqGE,8974
+masstack_python_client/resources/provision.py,sha256=EkSgYz7xaAWPrILTcrDATK3spBCOdEKwnV4-TvRzLg4,1525
 masstack_python_client/resources/enums/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 masstack_python_client/resources/enums/bundled_product_category.py,sha256=0rEsOud4kyDVX07DQ15C_DPcw8hZy84bAVj8j7nT22k,388
 masstack_python_client/resources/enums/commercial_segment_name.py,sha256=94yOXfHNCcZNCoR9ELQ-x2tarNin7gdYBVZ-CTzJsGA,101
@@ -20,18 +21,21 @@ masstack_python_client/resources/enums/customer_segment_name.py,sha256=NSQUUSUGL
 masstack_python_client/resources/enums/customer_type_name.py,sha256=mMdZh0D7qLDMxe6QYVQLGMqHqQMBAnZaPkjgE8q_D9Q,99
 masstack_python_client/resources/enums/document_type_search.py,sha256=pniXpUA_odqeKyxS6yYiN2uje0-F1kKXXBLOk0F8UTQ,136
 masstack_python_client/resources/enums/sale_type_name.py,sha256=NWl5j_SkbysOGVBn4-c7gVbzynOiE44Aqj34n_1v_sU,183
+masstack_python_client/resources/enums/technology.py,sha256=ipHLhdY2EMQgmeDzJ0LnvWvdiG_Oq-JHuEb5ZIx5x3g,106
 masstack_python_client/resources/enums/technology_name.py,sha256=7h8LUyZ-2XHAxOZXelUkkFifmk9dCcwmBbWueFABfQ4,90
 masstack_python_client/resources/models/address.py,sha256=hKnEUVVz8AfGjhaDngzQ0HuR4_Z6zhK6Xe8Aj6xJR7I,5451
 masstack_python_client/resources/models/bundled.py,sha256=1zhWZFrQh15slaGSEZIDa1rURU76gRH5czppXYNSyow,1480
 masstack_python_client/resources/models/client_address.py,sha256=7WBiPTce2X6uZUVVZvZlTMgiohbVITUzmKgYYPvpM-w,204
 masstack_python_client/resources/models/client_attribute.py,sha256=rZlLjJeBVD6IpXbSEucujTqcmHhqoJGRTOV1wqyStak,697
 masstack_python_client/resources/models/client_payment.py,sha256=yMGMTuk_07-TzXWO89sCaaZv8soTO9cT0TzfV3xQa1o,262
+masstack_python_client/resources/models/fixed_phone.py,sha256=ihF-iICz89eVhkeyRsX3pXYkODlXRpYPGJLiFiTBilM,98
+masstack_python_client/resources/models/portability.py,sha256=ZO7la2BDabw6aLQhTxW0d9TZ3Iu9Cc4Kvf1WxrliiJo,775
 masstack_python_client/resources/models/products.py,sha256=cIuUlEKs0OfvBXtYxxUwG4vibfAlZL4uVBK7-nAL9rw,1831
 masstack_python_client/resources/models/signup.py,sha256=Hvo5nZce1ikpUUMEoLt_2g2HipHwh4XRIz344X8_IJk,2018
 masstack_python_client/resources/models/user.py,sha256=N5mwuZN0Saxiro2UXYcCxLL6jrpIU83crHhmrdAcgE8,1080
 masstack_python_client/resources/utils/serialize.py,sha256=F6JxqR2M9HH0TpYKaJritnppWkYlpPztZ9ZC43FdPLg,251
-masstack_python_client-0.0.4.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-masstack_python_client-0.0.4.dist-info/METADATA,sha256=GJo4SVII_bljYCjkMAjrpbXHGYrX0YGSZk4Fz7uLYZ0,3818
-masstack_python_client-0.0.4.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-masstack_python_client-0.0.4.dist-info/top_level.txt,sha256=q_iYlqJq22lhg_2O2iktARr7Mzz3QfjaW4l6J4vwyE8,23
-masstack_python_client-0.0.4.dist-info/RECORD,,
+masstack_python_client-0.0.5.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+masstack_python_client-0.0.5.dist-info/METADATA,sha256=I_UMFcemF9efNV1wjDrsrT5Di2e6nhy9jA6CPuQBttk,4154
+masstack_python_client-0.0.5.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+masstack_python_client-0.0.5.dist-info/top_level.txt,sha256=q_iYlqJq22lhg_2O2iktARr7Mzz3QfjaW4l6J4vwyE8,23
+masstack_python_client-0.0.5.dist-info/RECORD,,