django-unicom 0.1.0__tar.gz

django_unicom-0.1.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md
+include LICENSE
+recursive-include unicom/static *
+recursive-include unicom/templates *
+exclude unicom_project/*
+exclude tests/*

django_unicom-0.1.0/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: django-unicom
+Version: 0.1.0
+Summary: Unified communication layer for Django (Telegram, WhatsApp, Email)
+Home-page: https://github.com/meena-erian/unicom
+Author: Meena (Menas) Erian
+Author-email: hi@menas.pro
+Classifier: Framework :: Django
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Description-Content-Type: text/markdown
+Requires-Dist: Django>=3.2
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-django; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: summary
+
+# Django Unicom
+
+**Unified communication layer for Django** — easily integrate Telegram bots, WhatsApp, and Email with a consistent API across all platforms.
+
+---
+
+## 🚀 Quick Start
+
+1. **Install the package:**
+   ```bash
+   pip install django-unicom
+   ```
+
+2. **Add `unicom` to your Django settings:**
+
+   ```python
+   INSTALLED_APPS = [
+       ...
+       'unicom',
+   ]
+   ```
+
+3. **Include `unicom` URLs in your project’s `urls.py`:**
+
+   > This is required so that webhook URLs can be constructed correctly.
+
+   ```python
+   from django.urls import path, include
+
+   urlpatterns = [
+       ...
+       path('unicom/', include('unicom.urls')),
+   ]
+   ```
+
+4. **Define your public origin:**
+   In your Django `settings.py`:
+
+   ```python
+   DJANGO_PUBLIC_ORIGIN = "https://yourdomain.com"
+   ```
+
+   Or via environment variable:
+
+   ```env
+   DJANGO_PUBLIC_ORIGIN=https://yourdomain.com
+   ```
+
+That’s it! Unicom can now register and manage public-facing webhooks (e.g., for Telegram bots) based on your defined base URL.
+
+---
+
+## 🧑‍💻 Contributing
+
+We ❤️ contributors!
+
+### Requirements:
+
+* Docker & Docker Compose installed
+
+### Getting Started:
+
+1. Clone the repo:
+
+   ```bash
+   git clone https://github.com/meena-erian/unicom.git
+   cd unicom
+   ```
+
+2. Create a `db.env` file in the root:
+
+   ```env
+   POSTGRES_DB=unicom_test
+   POSTGRES_USER=unicom
+   POSTGRES_PASSWORD=unicom
+   DJANGO_PUBLIC_ORIGIN=https://yourdomain.com
+   ```
+
+3. Start the dev environment:
+
+   ```bash
+   docker-compose up --build
+   ```
+
+4. Run tests:
+
+   ```bash
+   docker-compose exec app pytest
+   ```
+
+   or just
+
+   ```bash
+   pytest
+   ```
+   Note: To run ```test_telegram_live``` tests you need to create ```telegram_credentials.py``` in the tests folder and define in it ```TELEGRAM_API_TOKEN``` and ```TELEGRAM_SECRET_TOKEN```
+
+No need to modify `settings.py` — everything is pre-wired to read from `db.env`.
+
+---
+
+## 📄 License
+
+MIT License © Meena (Menas) Erian

django_unicom-0.1.0/README.md

@@ -0,0 +1,104 @@
+# Django Unicom
+
+**Unified communication layer for Django** — easily integrate Telegram bots, WhatsApp, and Email with a consistent API across all platforms.
+
+---
+
+## 🚀 Quick Start
+
+1. **Install the package:**
+   ```bash
+   pip install django-unicom
+   ```
+
+2. **Add `unicom` to your Django settings:**
+
+   ```python
+   INSTALLED_APPS = [
+       ...
+       'unicom',
+   ]
+   ```
+
+3. **Include `unicom` URLs in your project’s `urls.py`:**
+
+   > This is required so that webhook URLs can be constructed correctly.
+
+   ```python
+   from django.urls import path, include
+
+   urlpatterns = [
+       ...
+       path('unicom/', include('unicom.urls')),
+   ]
+   ```
+
+4. **Define your public origin:**
+   In your Django `settings.py`:
+
+   ```python
+   DJANGO_PUBLIC_ORIGIN = "https://yourdomain.com"
+   ```
+
+   Or via environment variable:
+
+   ```env
+   DJANGO_PUBLIC_ORIGIN=https://yourdomain.com
+   ```
+
+That’s it! Unicom can now register and manage public-facing webhooks (e.g., for Telegram bots) based on your defined base URL.
+
+---
+
+## 🧑‍💻 Contributing
+
+We ❤️ contributors!
+
+### Requirements:
+
+* Docker & Docker Compose installed
+
+### Getting Started:
+
+1. Clone the repo:
+
+   ```bash
+   git clone https://github.com/meena-erian/unicom.git
+   cd unicom
+   ```
+
+2. Create a `db.env` file in the root:
+
+   ```env
+   POSTGRES_DB=unicom_test
+   POSTGRES_USER=unicom
+   POSTGRES_PASSWORD=unicom
+   DJANGO_PUBLIC_ORIGIN=https://yourdomain.com
+   ```
+
+3. Start the dev environment:
+
+   ```bash
+   docker-compose up --build
+   ```
+
+4. Run tests:
+
+   ```bash
+   docker-compose exec app pytest
+   ```
+
+   or just
+
+   ```bash
+   pytest
+   ```
+   Note: To run ```test_telegram_live``` tests you need to create ```telegram_credentials.py``` in the tests folder and define in it ```TELEGRAM_API_TOKEN``` and ```TELEGRAM_SECRET_TOKEN```
+
+No need to modify `settings.py` — everything is pre-wired to read from `db.env`.
+
+---
+
+## 📄 License
+
+MIT License © Meena (Menas) Erian

django_unicom-0.1.0/django_unicom.egg-info/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: django-unicom
+Version: 0.1.0
+Summary: Unified communication layer for Django (Telegram, WhatsApp, Email)
+Home-page: https://github.com/meena-erian/unicom
+Author: Meena (Menas) Erian
+Author-email: hi@menas.pro
+Classifier: Framework :: Django
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Description-Content-Type: text/markdown
+Requires-Dist: Django>=3.2
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-django; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: summary
+
+# Django Unicom
+
+**Unified communication layer for Django** — easily integrate Telegram bots, WhatsApp, and Email with a consistent API across all platforms.
+
+---
+
+## 🚀 Quick Start
+
+1. **Install the package:**
+   ```bash
+   pip install django-unicom
+   ```
+
+2. **Add `unicom` to your Django settings:**
+
+   ```python
+   INSTALLED_APPS = [
+       ...
+       'unicom',
+   ]
+   ```
+
+3. **Include `unicom` URLs in your project’s `urls.py`:**
+
+   > This is required so that webhook URLs can be constructed correctly.
+
+   ```python
+   from django.urls import path, include
+
+   urlpatterns = [
+       ...
+       path('unicom/', include('unicom.urls')),
+   ]
+   ```
+
+4. **Define your public origin:**
+   In your Django `settings.py`:
+
+   ```python
+   DJANGO_PUBLIC_ORIGIN = "https://yourdomain.com"
+   ```
+
+   Or via environment variable:
+
+   ```env
+   DJANGO_PUBLIC_ORIGIN=https://yourdomain.com
+   ```
+
+That’s it! Unicom can now register and manage public-facing webhooks (e.g., for Telegram bots) based on your defined base URL.
+
+---
+
+## 🧑‍💻 Contributing
+
+We ❤️ contributors!
+
+### Requirements:
+
+* Docker & Docker Compose installed
+
+### Getting Started:
+
+1. Clone the repo:
+
+   ```bash
+   git clone https://github.com/meena-erian/unicom.git
+   cd unicom
+   ```
+
+2. Create a `db.env` file in the root:
+
+   ```env
+   POSTGRES_DB=unicom_test
+   POSTGRES_USER=unicom
+   POSTGRES_PASSWORD=unicom
+   DJANGO_PUBLIC_ORIGIN=https://yourdomain.com
+   ```
+
+3. Start the dev environment:
+
+   ```bash
+   docker-compose up --build
+   ```
+
+4. Run tests:
+
+   ```bash
+   docker-compose exec app pytest
+   ```
+
+   or just
+
+   ```bash
+   pytest
+   ```
+   Note: To run ```test_telegram_live``` tests you need to create ```telegram_credentials.py``` in the tests folder and define in it ```TELEGRAM_API_TOKEN``` and ```TELEGRAM_SECRET_TOKEN```
+
+No need to modify `settings.py` — everything is pre-wired to read from `db.env`.
+
+---
+
+## 📄 License
+
+MIT License © Meena (Menas) Erian

django_unicom-0.1.0/django_unicom.egg-info/SOURCES.txt

@@ -0,0 +1,32 @@
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+django_unicom.egg-info/PKG-INFO
+django_unicom.egg-info/SOURCES.txt
+django_unicom.egg-info/dependency_links.txt
+django_unicom.egg-info/requires.txt
+django_unicom.egg-info/top_level.txt
+unicom/__init__.py
+unicom/admin.py
+unicom/apps.py
+unicom/signals.py
+unicom/urls.py
+unicom/management/__init__.py
+unicom/management/commands/__init__.py
+unicom/management/commands/mail_inbox_listen.py
+unicom/migrations/0001_initial.py
+unicom/migrations/__init__.py
+unicom/models/__init__.py
+unicom/models/account.py
+unicom/models/account_chat.py
+unicom/models/bot.py
+unicom/models/chat.py
+unicom/models/constants.py
+unicom/models/message.py
+unicom/models/update.py
+unicom/templates/admin/unicom/chat_history.html
+unicom/views/__init__.py
+unicom/views/chat_history_view.py
+unicom/views/telegram_webhook.py
+unicom/views/whatsapp_webhook.py

django_unicom-0.1.0/django_unicom.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

django_unicom-0.1.0/django_unicom.egg-info/requires.txt

@@ -0,0 +1,5 @@
+Django>=3.2
+
+[dev]
+pytest
+pytest-django

django_unicom-0.1.0/django_unicom.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+unicom
+unicom_project

django_unicom-0.1.0/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=42"]
+build-backend = "setuptools.build_meta"

django_unicom-0.1.0/setup.cfg

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

django_unicom-0.1.0/setup.py

@@ -0,0 +1,28 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='django-unicom',
+    version='0.1.0',
+    description='Unified communication layer for Django (Telegram, WhatsApp, Email)',
+    long_description=open('README.md').read(),
+    long_description_content_type='text/markdown',
+    author='Meena (Menas) Erian',
+    author_email='hi@menas.pro',
+    url='https://github.com/meena-erian/unicom',
+    packages=find_packages(exclude=['tests*']),
+    include_package_data=True,
+    install_requires=[
+        'Django>=3.2',
+    ],
+    extras_require={
+        'dev': [
+            'pytest',
+            'pytest-django',
+        ],
+    },
+    classifiers=[
+        'Framework :: Django',
+        'Programming Language :: Python :: 3',
+        'License :: OSI Approved :: MIT License',
+    ],
+)

django_unicom-0.1.0/unicom/admin.py

@@ -0,0 +1,53 @@
+from django.contrib import admin
+from unicom.models import Message, Update, Chat, Account, AccountChat, Bot
+from django.utils.html import format_html
+from unicom.views.chat_history_view import chat_history_view
+from django.urls import path
+
+
+class ChatAdmin(admin.ModelAdmin):
+    list_filter = ('platform', 'is_private')
+    list_display = ('id', 'name', 'view_chat_link')
+    search_fields = ('id', 'name') 
+
+    def view_chat_link(self, obj):
+        return format_html('<a href="{}" target="_blank">View Chat</a>', self.url_for_chat(obj.id))
+
+    def url_for_chat(self, id):
+        return f"{id}/messages/"
+
+    def get_urls(self):
+        urls = super().get_urls()
+        custom_urls = [
+            path('<path:chat_id>/messages/', self.admin_site.admin_view(chat_history_view), name='chat-detail')
+        ]
+        return custom_urls + urls
+
+    view_chat_link.short_description = 'View Chat'
+
+
+class AccountChatAdmin(admin.ModelAdmin):
+    list_filter = ('account__platform', )
+    search_fields = ('account__name', 'chat__name') 
+
+
+class AccountAdmin(admin.ModelAdmin):
+    list_filter = ('platform', )
+    search_fields = ('name', )
+
+class BotAdmin(admin.ModelAdmin):
+    list_filter = ('platform', )
+    search_fields = ('name', )
+    list_display = ('id', 'name', 'platform', 'active', 'confirmed_webhook_url', 'error')
+
+    def get_readonly_fields(self, request, obj=None):
+        if obj:
+            return ['active', 'confirmed_webhook_url', 'error']
+        return super().get_readonly_fields(request, obj)
+
+admin.site.register(Bot)
+admin.site.register(Message)
+admin.site.register(Update)
+admin.site.register(Chat, ChatAdmin)
+admin.site.register(Account, AccountAdmin)
+admin.site.register(AccountChat, AccountChatAdmin)

django_unicom-0.1.0/unicom/apps.py

@@ -0,0 +1,10 @@
+from django.apps import AppConfig
+from unicom.services.telegram.set_telegram_webhook import set_telegram_webhook
+from pprint import pprint
+
+
+class UnicomConfig(AppConfig):
+    name = 'unicom'
+
+    def ready(self):
+        import unicom.signals

django_unicom-0.1.0/unicom/management/commands/mail_inbox_listen.py

@@ -0,0 +1,55 @@
+# import time
+# import logging
+# from imapclient import IMAPClient, SEEN
+# from django.core.management.base import BaseCommand
+# from django.conf import settings
+
+# from robopower.services.email.save_email_message import save_email_message
+
+# logger = logging.getLogger(__name__)
+
+# class Command(BaseCommand):
+#     help = "Listen to an IMAP account via IDLE and hand off new emails."
+
+#     def handle(self, *args, **options):
+#         while True:
+#             try:
+#                 with IMAPClient(settings.IMAP_HOST, port=settings.IMAP_PORT, ssl=settings.IMAP_USE_SSL) as server:
+#                     print(f"Logging in to {settings.IMAP_HOST}:{settings.IMAP_PORT} as {settings.IMAP_USER} with pwd {settings.IMAP_PASSWORD}")
+#                     server.login(settings.IMAP_USER, settings.IMAP_PASSWORD)
+#                     server.select_folder('INBOX')
+#                     self.stdout.write("✅ Connected to IMAP, entering IDLE…")
+
+#                     while True:
+#                         try:
+#                             server.idle()                             # enter IDLE
+#                             responses = server.idle_check(timeout=300)  # wake up at least every 5m
+#                         except (ConnectionResetError, OSError) as e:
+#                             logger.warning("IMAP idle connection lost: %s", e)
+#                             break  # break inner loop to reconnect
+#                         finally:
+#                             # if idle() succeeded we need to terminate it
+#                             # (noop if connection already gone)
+#                             try:
+#                                 server.idle_done()
+#                             except Exception:
+#                                 pass
+
+#                         if not responses:
+#                             continue
+
+#                         # process all new unseen messages
+#                         uids = server.search(['UNSEEN'])
+#                         for uid in uids:
+#                             try:
+#                                 resp = server.fetch(uid, ['BODY.PEEK[]'])
+#                                 raw = resp[uid][b'BODY[]']
+#                                 msg = save_email_message(raw)
+#                                 self.stdout.write(f"💾 Saved email {msg.id} (uid={uid})")
+#                                 server.add_flags(uid, [SEEN])
+#                             except Exception as exc:
+#                                 logger.exception("Failed to process UID %s: %s", uid, exc)
+
+#             except Exception as e:
+#                 logger.exception("Fatal IMAP error, reconnecting in 30s…")
+#                 time.sleep(30)

django_unicom-0.1.0/unicom/migrations/0001_initial.py

@@ -0,0 +1,103 @@
+# Generated by Django 4.2.20 on 2025-05-20 11:04
+
+from django.conf import settings
+import django.contrib.postgres.fields
+import django.core.validators
+from django.db import migrations, models
+import django.db.models.deletion
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Account',
+            fields=[
+                ('id', models.CharField(max_length=500, primary_key=True, serialize=False)),
+                ('platform', models.CharField(choices=[('Telegram', 'Telegram'), ('WhatsApp', 'WhatsApp'), ('Internal', 'Internal'), ('Email', 'Email')], max_length=100)),
+                ('is_bot', models.BooleanField(default=False)),
+                ('name', models.CharField(blank=True, max_length=100, null=True)),
+                ('raw', models.JSONField()),
+            ],
+        ),
+        migrations.CreateModel(
+            name='Bot',
+            fields=[
+                ('id', models.BigAutoField(primary_key=True, serialize=False)),
+                ('name', models.CharField(max_length=100)),
+                ('platform', models.CharField(choices=[('Telegram', 'Telegram'), ('WhatsApp', 'WhatsApp'), ('Internal', 'Internal'), ('Email', 'Email')], max_length=100)),
+                ('config', models.JSONField()),
+                ('active', models.BooleanField(default=False, editable=False)),
+                ('confirmed_webhook_url', models.CharField(blank=True, editable=False, max_length=500, null=True)),
+                ('error', models.CharField(blank=True, editable=False, max_length=500, null=True)),
+            ],
+        ),
+        migrations.CreateModel(
+            name='Chat',
+            fields=[
+                ('id', models.CharField(max_length=500, primary_key=True, serialize=False)),
+                ('platform', models.CharField(choices=[('Telegram', 'Telegram'), ('WhatsApp', 'WhatsApp'), ('Internal', 'Internal'), ('Email', 'Email')], max_length=100)),
+                ('is_private', models.BooleanField(default=True)),
+                ('name', models.CharField(blank=True, max_length=100, null=True)),
+            ],
+        ),
+        migrations.CreateModel(
+            name='Message',
+            fields=[
+                ('id', models.CharField(max_length=500, primary_key=True, serialize=False)),
+                ('platform', models.CharField(choices=[('Telegram', 'Telegram'), ('WhatsApp', 'WhatsApp'), ('Internal', 'Internal'), ('Email', 'Email')], max_length=100)),
+                ('is_bot', models.BooleanField(default=False)),
+                ('sender_name', models.CharField(max_length=100)),
+                ('subject', models.CharField(blank=True, help_text='Subject of the message (only for email messages)', max_length=512, null=True)),
+                ('text', models.TextField()),
+                ('html', models.TextField(blank=True, help_text='Full HTML body (only for email messages)', null=True)),
+                ('to', django.contrib.postgres.fields.ArrayField(base_field=models.EmailField(max_length=254, validators=[django.core.validators.EmailValidator()]), blank=True, default=list, help_text='List of To: addresses', size=None)),
+                ('cc', django.contrib.postgres.fields.ArrayField(base_field=models.EmailField(max_length=254, validators=[django.core.validators.EmailValidator()]), blank=True, default=list, help_text='List of Cc: addresses', size=None)),
+                ('bcc', django.contrib.postgres.fields.ArrayField(base_field=models.EmailField(max_length=254, validators=[django.core.validators.EmailValidator()]), blank=True, default=list, help_text='List of Bcc: addresses', size=None)),
+                ('media', models.FileField(blank=True, null=True, upload_to='media/')),
+                ('timestamp', models.DateTimeField()),
+                ('time_sent', models.DateTimeField(blank=True, null=True)),
+                ('time_delivered', models.DateTimeField(blank=True, null=True)),
+                ('time_seen', models.DateTimeField(blank=True, null=True)),
+                ('sent', models.BooleanField(default=False)),
+                ('delivered', models.BooleanField(default=False)),
+                ('seen', models.BooleanField(default=False)),
+                ('raw', models.JSONField()),
+                ('media_type', models.CharField(choices=[('text', 'Text'), ('html', 'HTML'), ('image', 'Image'), ('audio', 'Audio')], default='text', max_length=10)),
+                ('chat', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='messages', to='unicom.chat')),
+                ('reply_to_message', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='replies', to='unicom.message')),
+                ('sender', models.ForeignKey(on_delete=django.db.models.deletion.RESTRICT, to='unicom.account')),
+                ('user', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.RESTRICT, to=settings.AUTH_USER_MODEL)),
+            ],
+            options={
+                'ordering': ['-timestamp'],
+            },
+        ),
+        migrations.CreateModel(
+            name='Update',
+            fields=[
+                ('platform', models.CharField(choices=[('Telegram', 'Telegram'), ('WhatsApp', 'WhatsApp'), ('Internal', 'Internal'), ('Email', 'Email')], max_length=100)),
+                ('id', models.CharField(max_length=100, primary_key=True, serialize=False)),
+                ('payload', models.JSONField()),
+                ('bot', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='unicom.bot')),
+                ('message', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.DO_NOTHING, to='unicom.message')),
+            ],
+        ),
+        migrations.CreateModel(
+            name='AccountChat',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('account', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='unicom.account')),
+                ('chat', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='unicom.chat')),
+            ],
+            options={
+                'unique_together': {('account', 'chat')},
+            },
+        ),
+    ]