fitsms 1.0.0__tar.gz

fitsms-1.0.0/PKG-INFO

@@ -0,0 +1,42 @@
+Metadata-Version: 2.4
+Name: fitsms
+Version: 1.0.0
+Summary: Official Python SDK for FitSMS.lk Gateway
+Home-page: https://github.com/Global-Cloud-Media-Pvt-Ltd/fitsms-python-sdk
+Author: Danuja Dilanka
+Author-email: dilanka.rajapakshe1@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.1
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# FitSMS Python SDK (v4)
+
+The official Python SDK for the [FitSMS.lk](https://fitsms.lk) gateway, maintained by **Global Cloud Media**. Seamlessly integrate SMS capabilities into your Python applications, automation scripts, and AI agents.
+
+## Features
+* **Sri Lankan Number Formatting**: Automatically handles `07...` and `7...` formats to the required `947...` standard.
+* **v4 API Integration**: Fully compatible with the latest FitSMS REST API.
+* **Lightweight**: Minimal dependencies (uses `requests`).
+* **DevOps Ready**: Perfect for VPS monitoring and alert scripts.
+
+---
+
+## Installation
+
+### From Source (Local Development)
+```bash
+git clone [https://github.com/Global-Cloud-Media-Pvt-Ltd/fitsms-python-sdk.git](https://github.com/Global-Cloud-Media-Pvt-Ltd/fitsms-python-sdk.git)
+cd fitsms-python-sdk
+pip install .

fitsms-1.0.0/README.md

@@ -0,0 +1,19 @@
+# FitSMS Python SDK (v4)
+
+The official Python SDK for the [FitSMS.lk](https://fitsms.lk) gateway, maintained by **Global Cloud Media**. Seamlessly integrate SMS capabilities into your Python applications, automation scripts, and AI agents.
+
+## Features
+* **Sri Lankan Number Formatting**: Automatically handles `07...` and `7...` formats to the required `947...` standard.
+* **v4 API Integration**: Fully compatible with the latest FitSMS REST API.
+* **Lightweight**: Minimal dependencies (uses `requests`).
+* **DevOps Ready**: Perfect for VPS monitoring and alert scripts.
+
+---
+
+## Installation
+
+### From Source (Local Development)
+```bash
+git clone [https://github.com/Global-Cloud-Media-Pvt-Ltd/fitsms-python-sdk.git](https://github.com/Global-Cloud-Media-Pvt-Ltd/fitsms-python-sdk.git)
+cd fitsms-python-sdk
+pip install .

fitsms-1.0.0/fitsms/__init__.py

@@ -0,0 +1,9 @@
+# fitsms/__init__.py
+
+from .client import FitSMS
+
+__version__ = "1.0.0"
+__author__ = "Danuja Dilanka"
+
+# This makes 'FitSMS' the primary export of the package
+__all__ = ["FitSMS"]

fitsms-1.0.0/fitsms/client.py

@@ -0,0 +1,73 @@
+import requests
+import re
+
+class FitSMS:
+    def __init__(self, api_token, sender_id):
+        self.api_token = api_token
+        self.sender_id = sender_id
+        self.v4_base = "https://app.fitsms.lk/api/v4"
+        self.headers = {
+            "Authorization": f"Bearer {api_token}",
+            "Accept": "application/json"
+        }
+
+    def _format_number(self, phone):
+        """Standardizes SL numbers to 947XXXXXXXX format."""
+        cleaned = re.sub(r'\D', '', str(phone))
+        if cleaned.startswith('07') and len(cleaned) == 10:
+            cleaned = '94' + cleaned[1:]
+        elif cleaned.startswith('7') and len(cleaned) == 9:
+            cleaned = '94' + cleaned
+        return cleaned
+
+    def send(self, recipients, message, sms_type="plain"):
+        """Sends SMS to one or more recipients."""
+        if isinstance(recipients, list):
+            recipients = ",".join([self._format_number(n) for n in recipients])
+        else:
+            recipients = self._format_number(recipients)
+
+        payload = {
+            "recipient": recipients,
+            "sender_id": self.sender_id,
+            "type": sms_type,
+            "message": message
+        }
+
+        try:
+            response = requests.post(f"{self.v4_base}/sms/send", json=payload, headers=self.headers)
+            response.raise_for_status()
+            return response.json()
+        except requests.exceptions.RequestException as e:
+            return {"status": "error", "message": str(e)}
+
+    def get_balance(self):
+        """Retrieves account balance."""
+        response = requests.get(f"{self.v4_base}/balance", headers=self.headers)
+        return response.json()
+    
+    def get_status(self, ruid, phone):
+        """
+        Check the status of an existing SMS (v4 API).
+        :param ruid: The unique reference ID (received after sending)
+        :param phone: The recipient number
+        """
+        params = {
+            "recipient": self._format_number(phone)
+        }
+        
+        try:
+            # v4 uses the ruid in the URL path
+            response = requests.get(
+                f"{self.v4_base}/sms/{ruid}", 
+                params=params, 
+                headers=self.headers
+            )
+            response.raise_for_status()
+            return response.json()
+        except requests.exceptions.RequestException as e:
+            # Handle cases where RUID is not found or API is down
+            return {
+                "status": "error", 
+                "message": f"FitSMS Status Check Failed: {str(e)}"
+            }

fitsms-1.0.0/fitsms.egg-info/PKG-INFO

@@ -0,0 +1,42 @@
+Metadata-Version: 2.4
+Name: fitsms
+Version: 1.0.0
+Summary: Official Python SDK for FitSMS.lk Gateway
+Home-page: https://github.com/Global-Cloud-Media-Pvt-Ltd/fitsms-python-sdk
+Author: Danuja Dilanka
+Author-email: dilanka.rajapakshe1@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.1
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# FitSMS Python SDK (v4)
+
+The official Python SDK for the [FitSMS.lk](https://fitsms.lk) gateway, maintained by **Global Cloud Media**. Seamlessly integrate SMS capabilities into your Python applications, automation scripts, and AI agents.
+
+## Features
+* **Sri Lankan Number Formatting**: Automatically handles `07...` and `7...` formats to the required `947...` standard.
+* **v4 API Integration**: Fully compatible with the latest FitSMS REST API.
+* **Lightweight**: Minimal dependencies (uses `requests`).
+* **DevOps Ready**: Perfect for VPS monitoring and alert scripts.
+
+---
+
+## Installation
+
+### From Source (Local Development)
+```bash
+git clone [https://github.com/Global-Cloud-Media-Pvt-Ltd/fitsms-python-sdk.git](https://github.com/Global-Cloud-Media-Pvt-Ltd/fitsms-python-sdk.git)
+cd fitsms-python-sdk
+pip install .

fitsms-1.0.0/fitsms.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+setup.py
+fitsms/__init__.py
+fitsms/client.py
+fitsms.egg-info/PKG-INFO
+fitsms.egg-info/SOURCES.txt
+fitsms.egg-info/dependency_links.txt
+fitsms.egg-info/requires.txt
+fitsms.egg-info/top_level.txt

fitsms-1.0.0/fitsms.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

fitsms-1.0.0/fitsms.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25.1

fitsms-1.0.0/fitsms.egg-info/top_level.txt

@@ -0,0 +1 @@
+fitsms

fitsms-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

fitsms-1.0.0/setup.py

@@ -0,0 +1,23 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="fitsms",
+    version="1.0.0",
+    author="Danuja Dilanka",
+    author_email="dilanka.rajapakshe1@gmail.com",
+    description="Official Python SDK for FitSMS.lk Gateway",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/Global-Cloud-Media-Pvt-Ltd/fitsms-python-sdk",
+    packages=find_packages(),
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    install_requires=["requests>=2.25.1"],
+    python_requires='>=3.6',
+)