python-terminusgps 31.0.0__py3-none-any.whl → 31.0.1__py3-none-any.whl

{python_terminusgps-31.0.0.dist-info → python_terminusgps-31.0.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-terminusgps
-Version: 31.0.0
+Version: 31.0.1
 Summary: Provides abstractions/utilities for working with Wialon API, Authorize.NET API, AWS API, and more.
 Project-URL: Documentation, https://app.terminusgps.com/docs/apps/python-terminusgps/index.html
 Project-URL: Repository, https://github.com/terminusgps/python-terminusgps

{python_terminusgps-31.0.0.dist-info → python_terminusgps-31.0.1.dist-info}/RECORD

@@ -17,7 +17,7 @@ terminusgps/django/mixins.py,sha256=jzs_dH_YDmohH86I3uPnN-66C9OPVXaDPVdRHXA6vdk,
 terminusgps/django/settings.py,sha256=vY5yNjyMu-7Ya0bIPWUvrrSLERtxHGdkfeoY4Ul6cP0,613
 terminusgps/django/utils.py,sha256=SYDQyHA5tTuVwdpZGsCtf0LpTTD0ilRKoxa8StfSTpQ,156
 terminusgps/twilio/__init__.py,sha256=dYo41F2jft_eHDWSUtSpKGSRG1bewq_qClqilUJZkYM,33
-terminusgps/twilio/caller.py,sha256=TiQ4f0TDDC35he1M1iSsBM2vutdGriwtV4pc17T--6I,3552
+terminusgps/twilio/caller.py,sha256=Q0wcJ5aaNDGvKfht7ARwPTFdqpFoB81DmZ_K2oZixyA,5077
 terminusgps/twilio/validators.py,sha256=nn7CCBTktNjcln6M4MR0ACxEsClgioSu89LRLgIiBZk,1112
 terminusgps/wialon/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 terminusgps/wialon/constants.py,sha256=-fRrvtQuSAJ6hpBJzp_Xa4GDI4LuQbqZ1z1L_QFzZiE,5609
@@ -34,7 +34,7 @@ terminusgps/wialon/items/route.py,sha256=amNPKZqgl8pEzKA_XJudnvBPzEsfHTmrC7uF15s
 terminusgps/wialon/items/unit.py,sha256=ChONjm3wlFSlbNz-yEXziNbbs4LJ70F9-MI2c-p905k,10638
 terminusgps/wialon/items/unit_group.py,sha256=QV2ZZgICaN3n6W1pFIyMLyNKB6KYBsLyKG64i-qXoOg,4113
 terminusgps/wialon/items/user.py,sha256=N30wdejdG7LXrgafdKZH74YArGkX3xpZfTucn3m3aqM,7155
-python_terminusgps-31.0.0.dist-info/METADATA,sha256=y4fXM6pCMkZ0znIWvVqoAOzitHrjZDbrhSDPIy06qcE,1061
-python_terminusgps-31.0.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-python_terminusgps-31.0.0.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-python_terminusgps-31.0.0.dist-info/RECORD,,
+python_terminusgps-31.0.1.dist-info/METADATA,sha256=nrk9c775z_OXX5PVMLZgRkd4x_Butw1pspqwR_XyF48,1061
+python_terminusgps-31.0.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+python_terminusgps-31.0.1.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+python_terminusgps-31.0.1.dist-info/RECORD,,

terminusgps/twilio/caller.py

@@ -17,30 +17,53 @@ if not hasattr(settings, "TWILIO_MESSAGING_SID"):
 
 
 class TwilioCaller:
-    def __init__(self) -> None:
-        """Sets Twilio messaging session variables."""
-        self.client_sid = settings.TWILIO_SID
-        self.client_token = settings.TWILIO_TOKEN
-        self.from_number = settings.TWILIO_FROM_NUMBER
-        self.messaging_sid = settings.TWILIO_MESSAGING_SID
+    def __init__(
+        self,
+        client_sid: str | None = None,
+        client_token: str | None = None,
+        from_number: str | None = None,
+        messaging_sid: str | None = None,
+    ) -> None:
+        """
+        Sets Twilio client session variables.
+
+        All parameters are optional, default values are pulled from a Django settings module.
+
+        :param client_sid: A Twilio client session id.
+        :type client_sid: :py:obj:`str` | :py:obj:`None`
+        :param client_token: A Twilio client API token.
+        :type client_token: :py:obj:`str` | :py:obj:`None`
+        :param from_number: Phone number used to send notifications.
+        :type from_number: :py:obj:`str` | :py:obj:`None`
+        :param messaging_sid: A Twilio client messaging service session id.
+        :type messaging_sid: :py:obj:`str` | :py:obj:`None`
+        :returns: Nothing.
+        :rtype: :py:obj:`None`
+
+        """
+        self._client_sid = client_sid or settings.TWILIO_SID
+        self._client_token = client_token or settings.TWILIO_TOKEN
+        self._from_number = from_number or settings.TWILIO_FROM_NUMBER
+        self._messaging_sid = messaging_sid or settings.TWILIO_MESSAGING_SID
 
     def __enter__(self) -> "TwilioCaller":
-        """Creates an asyncronous Twilio client."""
+        """Opens a context manager and creates an asyncronous Twilio client."""
         self.client = twilio.rest.Client(
-            self.client_sid, self.client_token, http_client=AsyncTwilioHttpClient()
+            self.client_sid, self._client_token, http_client=AsyncTwilioHttpClient()
         )
         return self
 
     def __exit__(self, exc_type, exc_value, exc_tb) -> None:
+        """Closes the context manager."""
         return None
 
-    async def create_notification(
+    def create_notification(
         self, to_number: str, message: str, method: str = "sms"
     ) -> asyncio.Task[Any]:
         """
         Returns an awaitable notification task.
 
-        Available methods are ``"sms"``, ``"call"`` and ``"phone"``.
+        Valid methods are ``"sms"``, ``"call"`` and ``"phone"``.
 
         :param to_number: A phone number to notify.
         :type to_number: :py:obj:`str`
@@ -48,6 +71,7 @@ class TwilioCaller:
         :type message: :py:obj:`str`
         :param method: A notification method. Default is ``"sms"``.
         :type method: :py:obj:`str`
+        :raises ValueError: If ``method`` is invalid.
         :returns: An awaitable task.
         :rtype: :py:obj:`~asyncio.Task`
 
@@ -100,3 +124,33 @@ class TwilioCaller:
             body=message,
             messaging_service_sid=self.messaging_sid,
         )
+
+    @property
+    def client_sid(self) -> str:
+        """
+        Client session id.
+
+        :type: :py:obj:`str`
+
+        """
+        return self._client_sid
+
+    @property
+    def from_number(self) -> str:
+        """
+        Origin phone number.
+
+        :type: :py:obj:`str`
+
+        """
+        return self._from_number
+
+    @property
+    def messaging_sid(self) -> str:
+        """
+        Messaging service session id.
+
+        :type: :py:obj:`str`
+
+        """
+        return self._messaging_sid