django-chelseru 1.0.0__tar.gz → 1.0.2__tar.gz

django_chelseru-1.0.2/MANIFEST.in

@@ -0,0 +1 @@
+include README_PA.md

django_chelseru-1.0.2/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: django-chelseru
+Version: 1.0.2
+Summary: Authentication system, online and real-time chat, SMS system for Iranian SMS services.
+Home-page: https://pipdjango.chelseru.com
+Author: Sobhan Bahman|Rashnu
+Author-email: bahmanrashnu@gmail.com
+Project-URL: Documentation, https://github.com/Chelseru/django-chelseru-lour/
+Project-URL: Telegram Group, https://t.me/bahmanpy
+Project-URL: Telegram Channel, https://t.me/ChelseruCom
+Keywords: djangochelseruchat djangochat drfchat online-chat online real-time chat iran chelseru lor lur bahman rashnu lour sms djangoauth auth ywt otpauth otp authentication djangootp djangoiransms iransms djangosms djangokavenegar djangomelipayamak sobhan چت  سبحان بهمن رشنو چلسرو جنگو پایتون لر لور آنلاین ریل تایم
+Classifier: Programming Language :: Python :: 3
+Classifier: Framework :: Django
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=5.1.6
+Requires-Dist: djangorestframework==3.15.2
+Requires-Dist: djangorestframework_simplejwt==5.5.0
+Requires-Dist: channels==4.2.2
+Requires-Dist: channels_redis==4.2.1
+Requires-Dist: daphne==4.1.2
+Requires-Dist: zeep==4.3.1
+Requires-Dist: user-agents==2.2.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+django-chelseruیک بسته جنگویی برای گپ‌زنی همزمان، راستی‌آزمایی پیامکی و فرستادن پیامک با یاری‌دهنده‌های ایرانی.نویسندهSobhan Bahman Rashnu🚀 ویژگی‌ها📱 راستی‌آزمایی پیامکی (رمز یک‌بارمصرف): راستی‌آزمایی امن کاربران با یاری‌گیری از رمزهای یک‌بارمصرف که از راه پیامک فرستاده می‌شوند.💬 گپ‌زنی همزمان: کارکرد پیام‌رسانی همزمان بر پایه WebSocket.✉️ سامانه‌های پیامکی: فرستادن پیامک از راه یاری‌دهنده‌های نامور پیامکی ایرانی.⚙️ نصببسته را با یاری‌گیری از pip نصب کنید:pip install django-chelseru
+'drfchelseru' را به INSTALLED_APPS در پرونده settings.py خود بیفزایید:INSTALLED_APPS = [
+    ...
+    'channels',
+    'rest_framework',
+    'rest_framework_simplejwt',
+    'drfchelseru',
+    ...
+]
+🛠️ پیکربندیبرای پیکربندی بسته، واژه‌نامه DJANGO_CHELSERU را به پرونده settings.py خود بیفزایید. این واژه‌نامه به شما پروانه می‌دهد تا چیدمان‌های راستی‌آزمایی و پیامک را خودساخته نمایید.# settings.py
+
+DJANGO_CHELSERU = {
+    'AUTH': {
+        'AUTH_METHOD'           : 'OTP',                        # روش‌های پشتیبانی شده: OTP, PASSWD
+        'AUTH_SERVICE'          : 'rest_framework_simplejwt',   # سرویس‌های پشتیبانی شده: rest_framework_simplejwt
+        'OPTIONS': {
+            'OTP_LENGTH'            : 8,    # پیش‌فرض: 8
+            'OTP_EXPIRE_PER_MINUTES': 4,    # پیش‌فرض: 4
+            'OTP_SMS_TEMPLATE_ID'   : 1,    # شناسه قالب پیامکی برای رمز یک‌بارمصرف
+        }
+    },
+    'SMS': {
+        'SMS_SERVICE': 'PARSIAN_WEBCO_IR',  # یاری‌دهنده‌های پشتیبانی شده: PARSIAN_WEBCO_IR, MELI_PAYAMAK_COM, KAVENEGAR_COM
+        'SETTINGS': {
+            'PARSIAN_WEBCO_IR_API_KEY'  : 'YOUR_PARSIAN_WEBCO_API_KEY',
+            'MELI_PAYAMAK_COM_USERNAME' : 'YOUR_MELI_PAYAMAK_USERNAME',
+            'MELI_PAYAMAK_COM_PASSWORD' : 'YOUR_MELI_PAYAMAK_PASSWORD',
+            'MELI_PAYAMAK_COM_FROM'     : 'YOUR_MELI_PAYAMAK_FROM_NUMBER',
+            'KAVENEGAR_COM_API_KEY'     : 'YOUR_KAVENEGAR_API_KEY',
+            'KAVENEGAR_COM_FROM'        : 'YOUR_KAVENEGAR_FROM_NUMBER',
+        },
+        'TEMPLATES': {
+            'T1': 1,
+            'T2': 2,
+            ...
+        }
+    }
+}
+AUTH_METHOD: روش راستی‌آزمایی را روشن می‌سازد. برای راستی‌آزمایی پیامکی، از 'OTP' بهره بگیرید.OTP_LENGTH: درازای رمز یک‌بارمصرف.OTP_EXPIRE_PER_MINUTES: زمان پایان‌یافتن رمز یک‌بارمصرف بر پایه دقیقه.OTP_SMS_TEMPLATE_ID: شناسه قالب پیامکی که برای فرستادن رمز یک‌بارمصرف بهره گرفته می‌شود.SMS_SERVICE: یاری‌دهنده پیامکی دلخواه خود را برگزینید.SETTINGS: آگاهی‌های نیاز برای یاری‌دهنده پیامکی برگزیده‌تان را فراهم آورید.TEMPLATES: شناسه‌های قالب پیامکی خود را روشن سازید.🔌 نقطه‌های پایانیبرای به کارگیری کارکردهای این بسته، URLهای زیر را به پرونده urls.py خود بیفزایید.# urls.py
+
+from django.urls import path, include
+
+urlpatterns = [
+    ...
+    path('api/', include('drfchelseru.urls')),
+    ...
+]
+این بسته نقطه‌های پایانی API زیر را فراهم می‌آورد:نقطه‌ پایانیشرحروش/api/otp/send/یک رمز یک‌بارمصرف به شماره همراه گفته‌شده می‌فرستد.POST/api/authenticate/کاربری را با رمز یک‌بارمصرف دریافت‌شده، راستی‌آزمایی می‌کند.POST/api/sessions/نشست‌های فعال کاربر را فهرست کرده و درایوری می‌کند.GET/api/message/send/یک پیامک با یاری‌دهنده پیکربندی‌شده می‌فرستد.POSTبه کارگیری نقطه‌های پایانی1. فرستادن رمز یک‌بارمصرف (/api/otp/send/)روش: POSTشرح: یک رمز یک‌بارمصرف به شماره همراه کاربر می‌فرستد.داده‌نماهای نیاز:داده‌نماگونهشرحنمونهmobile_numberstrشماره همراه کاربر.09121234567پاسخ‌ها:HTTP 200 OK: رمز یک‌بارمصرف با کامیابی فرستاده شد.{"details": "The OTP code was sent correctly."}
+HTTP 400 BAD REQUEST: ساختار نادرست mobile_number.HTTP 409 CONFLICT: یک رمز یک‌بارمصرف پیش‌تر فرستاده شده و هنوز روایی دارد.{"details": "An OTP code has already been sent. Please wait X seconds before trying again."}
+HTTP 500 INTERNAL SERVER ERROR: یک دشواری در کارگذار پیش آمده است.2. راستی‌آزمایی (/api/authenticate/)روش: POSTشرح: کاربر را با رمز یک‌بارمصرف فراهم شده، راستی‌آزمایی می‌کند. اگر با کامیابی انجام شود، توکن‌های JWT (access و refresh) را بازمی‌گرداند.داده‌نماهای نیاز:داده‌نماگونهشرحنمونهmobile_numberstrشماره همراه کاربر.09121234567codestrرمز یک‌بارمصرف دریافت شده از راه پیامک.12345678groupintاختیاری: یک شناسه دسته برای کاربر.1پاسخ‌ها:HTTP 200 OK: راستی‌آزمایی با کامیابی انجام شد.{
+  "access": "...",
+  "refresh": "..."
+}
+HTTP 401 UNAUTHORIZED: رمز یک‌بارمصرف ناروا یا پایان‌یافته.{"error": "The code sent to this mobile number was not found."}
+HTTP 400 BAD REQUEST: داده‌نماهای نیاز ناپیدا یا ساختار نادرست.HTTP 500 INTERNAL SERVER ERROR: یک دشواری در کارگذار پیش آمده است.3. فرستادن پیامک (/api/message/send/)روش: POSTشرح: یک پیامک خودساخته را با یاری‌دهنده پیکربندی‌شده می‌فرستد.داده‌نماهای نیاز:داده‌نماگونهشرحنمونهmobile_numberstrشماره همراه گیرنده.09121234567message_textstrنوشتار پیام. (بیشینه ۲۹۰ نویسه)Hello, World!template_idintبرای برخی یاری‌دهنده‌ها (برای نمونه پارسیان) نیاز است.1پاسخ‌ها:HTTP 200 OK: پیام با کامیابی فرستاده شد.{"details": "The Message was sent correctly."}
+HTTP 400 BAD REQUEST: دشواری‌های درست‌سنجی برای داده‌نماها.HTTP 401 UNAUTHORIZED: راستی‌آزمایی انجام نشد.HTTP 500 INTERNAL SERVER ERROR: یک دشواری در کارگذار پیش آمده است.HTTP 502 BAD GATEWAY: یاری‌دهنده پیامکی یک دشواری را بازگرداند.4. فهرست نشست‌ها (/api/sessions/)روش: GETشرح: همه نشست‌های فعال کاربران را فهرست می‌کند. نیاز به راستی‌آزمایی (IsAuthenticated) دارد.سربرگ‌های نیاز:سربرگارزشAuthorizationBearer <your_access_token>💡 مدل‌هااین بسته یک مدل Session برای درایوری نشست‌های فعال کاربران دارد. می‌توانید به این نشست‌ها از راه نقطه‌ پایانی /api/sessions/ دسترسی یافته و آنها را درایوری کنید.

django_chelseru-1.0.2/README.md

@@ -0,0 +1,56 @@
+django-chelseruA Django package for real-time chat, SMS authentication, and sending SMS messages with Iranian providers.AuthorSobhan Bahman Rashnu🚀 Features📱 SMS Authentication (OTP): Secure user authentication using one-time passwords sent via SMS.💬 Real-time Chat: WebSocket-based real-time messaging functionality.✉️ SMS Services: Send SMS messages through popular Iranian SMS providers.⚙️ InstallationInstall the package using pip:pip install django-chelseru
+Add 'drfchelseru' to your INSTALLED_APPS in settings.py:INSTALLED_APPS = [
+    ...
+    'channels',
+    'rest_framework',
+    'rest_framework_simplejwt',
+    'drfchelseru',
+    ...
+]
+🛠️ ConfigurationTo configure the package, add the DJANGO_CHELSERU dictionary to your settings.py file. This dictionary allows you to customize authentication and SMS settings.# settings.py
+
+DJANGO_CHELSERU = {
+    'AUTH': {
+        'AUTH_METHOD'           : 'OTP',                        # Supported methods: OTP, PASSWD
+        'AUTH_SERVICE'          : 'rest_framework_simplejwt',   # Supported services: rest_framework_simplejwt
+        'OPTIONS': {
+            'OTP_LENGTH'            : 8,    # Default: 8
+            'OTP_EXPIRE_PER_MINUTES': 4,    # Default: 4
+            'OTP_SMS_TEMPLATE_ID'   : 1,    # SMS template ID for OTP
+        }
+    },
+    'SMS': {
+        'SMS_SERVICE': 'PARSIAN_WEBCO_IR',  # Supported providers: PARSIAN_WEBCO_IR, MELI_PAYAMAK_COM, KAVENEGAR_COM
+        'SETTINGS': {
+            'PARSIAN_WEBCO_IR_API_KEY'  : 'YOUR_PARSIAN_WEBCO_API_KEY',
+            'MELI_PAYAMAK_COM_USERNAME' : 'YOUR_MELI_PAYAMAK_USERNAME',
+            'MELI_PAYAMAK_COM_PASSWORD' : 'YOUR_MELI_PAYAMAK_PASSWORD',
+            'MELI_PAYAMAK_COM_FROM'     : 'YOUR_MELI_PAYAMAK_FROM_NUMBER',
+            'KAVENEGAR_COM_API_KEY'     : 'YOUR_KAVENEGAR_API_KEY',
+            'KAVENEGAR_COM_FROM'        : 'YOUR_KAVENEGAR_FROM_NUMBER',
+        },
+        'TEMPLATES': {
+            'T1': 1,
+            'T2': 2,
+            ...
+        }
+    }
+}
+AUTH_METHOD: Specifies the authentication method. Use 'OTP' for SMS-based authentication.OTP_LENGTH: The length of the one-time password.OTP_EXPIRE_PER_MINUTES: The expiration time for the OTP in minutes.OTP_SMS_TEMPLATE_ID: The template ID of the SMS message used for sending the OTP.SMS_SERVICE: Select your desired SMS provider.SETTINGS: Provide the necessary credentials for your chosen SMS provider.TEMPLATES: Define your SMS template IDs.🔌 EndpointsAdd the following URLs to your urls.py file to use the package's functionality.# urls.py
+
+from django.urls import path, include
+
+urlpatterns = [
+    ...
+    path('api/', include('drfchelseru.urls')),
+    ...
+]
+The package provides the following API endpoints:EndpointDescriptionMethod/api/otp/send/Sends an OTP to the specified phone number.POST/api/authenticate/Authenticates a user with the received OTP.POST/api/sessions/Lists and manages active user sessions.GET/api/message/send/Sends an SMS message using the configured provider.POSTEndpoint Usage1. OTP Code Sending (/api/otp/send/)Method: POSTDescription: Sends a one-time password to the user's mobile number.Required Parameters:ParameterTypeDescriptionExamplemobile_numberstrThe user's mobile number.09121234567Responses:HTTP 200 OK: OTP code sent successfully.{"details": "The OTP code was sent correctly."}
+HTTP 400 BAD REQUEST: Invalid mobile_number format.HTTP 409 CONFLICT: An OTP has already been sent and is still valid.{"details": "An OTP code has already been sent. Please wait X seconds before trying again."}
+HTTP 500 INTERNAL SERVER ERROR: An issue occurred on the server.2. Authentication (/api/authenticate/)Method: POSTDescription: Authenticates the user with the provided OTP. On success, it returns JWT tokens (access and refresh).Required Parameters:ParameterTypeDescriptionExamplemobile_numberstrThe user's mobile number.09121234567codestrThe OTP received via SMS.12345678groupintOptional: A group identifier for the user.1Responses:HTTP 200 OK: Authentication successful.{
+  "access": "...",
+  "refresh": "..."
+}
+HTTP 401 UNAUTHORIZED: Invalid or expired OTP code.{"error": "The code sent to this mobile number was not found."}
+HTTP 400 BAD REQUEST: Missing required parameters or invalid format.HTTP 500 INTERNAL SERVER ERROR: An issue occurred on the server.3. Message Sending (/api/message/send/)Method: POSTDescription: Sends a custom SMS message using the configured provider.Required Parameters:ParameterTypeDescriptionExamplemobile_numberstrThe recipient's mobile number.09121234567message_textstrThe text of the message. (Max 290 chars)Hello, World!template_idintRequired for some providers (e.g., Parsian).1Responses:HTTP 200 OK: Message sent successfully.{"details": "The Message was sent correctly."}
+HTTP 400 BAD REQUEST: Validation errors for parameters.HTTP 401 UNAUTHORIZED: Authentication failed.HTTP 500 INTERNAL SERVER ERROR: An issue occurred on the server.HTTP 502 BAD GATEWAY: SMS provider returned an error.4. Session List (/api/sessions/)Method: GETDescription: Lists all active user sessions. Requires authentication (IsAuthenticated).Required Headers:HeaderValueAuthorizationBearer <your_access_token>💡 ModelsThis package includes a Session model for managing active user sessions. You can access and manage these sessions through the /api/sessions/ endpoint.

django_chelseru-1.0.2/README_PA.md

@@ -0,0 +1,56 @@
+django-chelseruیک بسته جنگویی برای گپ‌زنی همزمان، راستی‌آزمایی پیامکی و فرستادن پیامک با یاری‌دهنده‌های ایرانی.نویسندهSobhan Bahman Rashnu🚀 ویژگی‌ها📱 راستی‌آزمایی پیامکی (رمز یک‌بارمصرف): راستی‌آزمایی امن کاربران با یاری‌گیری از رمزهای یک‌بارمصرف که از راه پیامک فرستاده می‌شوند.💬 گپ‌زنی همزمان: کارکرد پیام‌رسانی همزمان بر پایه WebSocket.✉️ سامانه‌های پیامکی: فرستادن پیامک از راه یاری‌دهنده‌های نامور پیامکی ایرانی.⚙️ نصببسته را با یاری‌گیری از pip نصب کنید:pip install django-chelseru
+'drfchelseru' را به INSTALLED_APPS در پرونده settings.py خود بیفزایید:INSTALLED_APPS = [
+    ...
+    'channels',
+    'rest_framework',
+    'rest_framework_simplejwt',
+    'drfchelseru',
+    ...
+]
+🛠️ پیکربندیبرای پیکربندی بسته، واژه‌نامه DJANGO_CHELSERU را به پرونده settings.py خود بیفزایید. این واژه‌نامه به شما پروانه می‌دهد تا چیدمان‌های راستی‌آزمایی و پیامک را خودساخته نمایید.# settings.py
+
+DJANGO_CHELSERU = {
+    'AUTH': {
+        'AUTH_METHOD'           : 'OTP',                        # روش‌های پشتیبانی شده: OTP, PASSWD
+        'AUTH_SERVICE'          : 'rest_framework_simplejwt',   # سرویس‌های پشتیبانی شده: rest_framework_simplejwt
+        'OPTIONS': {
+            'OTP_LENGTH'            : 8,    # پیش‌فرض: 8
+            'OTP_EXPIRE_PER_MINUTES': 4,    # پیش‌فرض: 4
+            'OTP_SMS_TEMPLATE_ID'   : 1,    # شناسه قالب پیامکی برای رمز یک‌بارمصرف
+        }
+    },
+    'SMS': {
+        'SMS_SERVICE': 'PARSIAN_WEBCO_IR',  # یاری‌دهنده‌های پشتیبانی شده: PARSIAN_WEBCO_IR, MELI_PAYAMAK_COM, KAVENEGAR_COM
+        'SETTINGS': {
+            'PARSIAN_WEBCO_IR_API_KEY'  : 'YOUR_PARSIAN_WEBCO_API_KEY',
+            'MELI_PAYAMAK_COM_USERNAME' : 'YOUR_MELI_PAYAMAK_USERNAME',
+            'MELI_PAYAMAK_COM_PASSWORD' : 'YOUR_MELI_PAYAMAK_PASSWORD',
+            'MELI_PAYAMAK_COM_FROM'     : 'YOUR_MELI_PAYAMAK_FROM_NUMBER',
+            'KAVENEGAR_COM_API_KEY'     : 'YOUR_KAVENEGAR_API_KEY',
+            'KAVENEGAR_COM_FROM'        : 'YOUR_KAVENEGAR_FROM_NUMBER',
+        },
+        'TEMPLATES': {
+            'T1': 1,
+            'T2': 2,
+            ...
+        }
+    }
+}
+AUTH_METHOD: روش راستی‌آزمایی را روشن می‌سازد. برای راستی‌آزمایی پیامکی، از 'OTP' بهره بگیرید.OTP_LENGTH: درازای رمز یک‌بارمصرف.OTP_EXPIRE_PER_MINUTES: زمان پایان‌یافتن رمز یک‌بارمصرف بر پایه دقیقه.OTP_SMS_TEMPLATE_ID: شناسه قالب پیامکی که برای فرستادن رمز یک‌بارمصرف بهره گرفته می‌شود.SMS_SERVICE: یاری‌دهنده پیامکی دلخواه خود را برگزینید.SETTINGS: آگاهی‌های نیاز برای یاری‌دهنده پیامکی برگزیده‌تان را فراهم آورید.TEMPLATES: شناسه‌های قالب پیامکی خود را روشن سازید.🔌 نقطه‌های پایانیبرای به کارگیری کارکردهای این بسته، URLهای زیر را به پرونده urls.py خود بیفزایید.# urls.py
+
+from django.urls import path, include
+
+urlpatterns = [
+    ...
+    path('api/', include('drfchelseru.urls')),
+    ...
+]
+این بسته نقطه‌های پایانی API زیر را فراهم می‌آورد:نقطه‌ پایانیشرحروش/api/otp/send/یک رمز یک‌بارمصرف به شماره همراه گفته‌شده می‌فرستد.POST/api/authenticate/کاربری را با رمز یک‌بارمصرف دریافت‌شده، راستی‌آزمایی می‌کند.POST/api/sessions/نشست‌های فعال کاربر را فهرست کرده و درایوری می‌کند.GET/api/message/send/یک پیامک با یاری‌دهنده پیکربندی‌شده می‌فرستد.POSTبه کارگیری نقطه‌های پایانی1. فرستادن رمز یک‌بارمصرف (/api/otp/send/)روش: POSTشرح: یک رمز یک‌بارمصرف به شماره همراه کاربر می‌فرستد.داده‌نماهای نیاز:داده‌نماگونهشرحنمونهmobile_numberstrشماره همراه کاربر.09121234567پاسخ‌ها:HTTP 200 OK: رمز یک‌بارمصرف با کامیابی فرستاده شد.{"details": "The OTP code was sent correctly."}
+HTTP 400 BAD REQUEST: ساختار نادرست mobile_number.HTTP 409 CONFLICT: یک رمز یک‌بارمصرف پیش‌تر فرستاده شده و هنوز روایی دارد.{"details": "An OTP code has already been sent. Please wait X seconds before trying again."}
+HTTP 500 INTERNAL SERVER ERROR: یک دشواری در کارگذار پیش آمده است.2. راستی‌آزمایی (/api/authenticate/)روش: POSTشرح: کاربر را با رمز یک‌بارمصرف فراهم شده، راستی‌آزمایی می‌کند. اگر با کامیابی انجام شود، توکن‌های JWT (access و refresh) را بازمی‌گرداند.داده‌نماهای نیاز:داده‌نماگونهشرحنمونهmobile_numberstrشماره همراه کاربر.09121234567codestrرمز یک‌بارمصرف دریافت شده از راه پیامک.12345678groupintاختیاری: یک شناسه دسته برای کاربر.1پاسخ‌ها:HTTP 200 OK: راستی‌آزمایی با کامیابی انجام شد.{
+  "access": "...",
+  "refresh": "..."
+}
+HTTP 401 UNAUTHORIZED: رمز یک‌بارمصرف ناروا یا پایان‌یافته.{"error": "The code sent to this mobile number was not found."}
+HTTP 400 BAD REQUEST: داده‌نماهای نیاز ناپیدا یا ساختار نادرست.HTTP 500 INTERNAL SERVER ERROR: یک دشواری در کارگذار پیش آمده است.3. فرستادن پیامک (/api/message/send/)روش: POSTشرح: یک پیامک خودساخته را با یاری‌دهنده پیکربندی‌شده می‌فرستد.داده‌نماهای نیاز:داده‌نماگونهشرحنمونهmobile_numberstrشماره همراه گیرنده.09121234567message_textstrنوشتار پیام. (بیشینه ۲۹۰ نویسه)Hello, World!template_idintبرای برخی یاری‌دهنده‌ها (برای نمونه پارسیان) نیاز است.1پاسخ‌ها:HTTP 200 OK: پیام با کامیابی فرستاده شد.{"details": "The Message was sent correctly."}
+HTTP 400 BAD REQUEST: دشواری‌های درست‌سنجی برای داده‌نماها.HTTP 401 UNAUTHORIZED: راستی‌آزمایی انجام نشد.HTTP 500 INTERNAL SERVER ERROR: یک دشواری در کارگذار پیش آمده است.HTTP 502 BAD GATEWAY: یاری‌دهنده پیامکی یک دشواری را بازگرداند.4. فهرست نشست‌ها (/api/sessions/)روش: GETشرح: همه نشست‌های فعال کاربران را فهرست می‌کند. نیاز به راستی‌آزمایی (IsAuthenticated) دارد.سربرگ‌های نیاز:سربرگارزشAuthorizationBearer <your_access_token>💡 مدل‌هااین بسته یک مدل Session برای درایوری نشست‌های فعال کاربران دارد. می‌توانید به این نشست‌ها از راه نقطه‌ پایانی /api/sessions/ دسترسی یافته و آنها را درایوری کنید.

django_chelseru-1.0.2/django_chelseru.egg-info/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: django-chelseru
+Version: 1.0.2
+Summary: Authentication system, online and real-time chat, SMS system for Iranian SMS services.
+Home-page: https://pipdjango.chelseru.com
+Author: Sobhan Bahman|Rashnu
+Author-email: bahmanrashnu@gmail.com
+Project-URL: Documentation, https://github.com/Chelseru/django-chelseru-lour/
+Project-URL: Telegram Group, https://t.me/bahmanpy
+Project-URL: Telegram Channel, https://t.me/ChelseruCom
+Keywords: djangochelseruchat djangochat drfchat online-chat online real-time chat iran chelseru lor lur bahman rashnu lour sms djangoauth auth ywt otpauth otp authentication djangootp djangoiransms iransms djangosms djangokavenegar djangomelipayamak sobhan چت  سبحان بهمن رشنو چلسرو جنگو پایتون لر لور آنلاین ریل تایم
+Classifier: Programming Language :: Python :: 3
+Classifier: Framework :: Django
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=5.1.6
+Requires-Dist: djangorestframework==3.15.2
+Requires-Dist: djangorestframework_simplejwt==5.5.0
+Requires-Dist: channels==4.2.2
+Requires-Dist: channels_redis==4.2.1
+Requires-Dist: daphne==4.1.2
+Requires-Dist: zeep==4.3.1
+Requires-Dist: user-agents==2.2.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+django-chelseruیک بسته جنگویی برای گپ‌زنی همزمان، راستی‌آزمایی پیامکی و فرستادن پیامک با یاری‌دهنده‌های ایرانی.نویسندهSobhan Bahman Rashnu🚀 ویژگی‌ها📱 راستی‌آزمایی پیامکی (رمز یک‌بارمصرف): راستی‌آزمایی امن کاربران با یاری‌گیری از رمزهای یک‌بارمصرف که از راه پیامک فرستاده می‌شوند.💬 گپ‌زنی همزمان: کارکرد پیام‌رسانی همزمان بر پایه WebSocket.✉️ سامانه‌های پیامکی: فرستادن پیامک از راه یاری‌دهنده‌های نامور پیامکی ایرانی.⚙️ نصببسته را با یاری‌گیری از pip نصب کنید:pip install django-chelseru
+'drfchelseru' را به INSTALLED_APPS در پرونده settings.py خود بیفزایید:INSTALLED_APPS = [
+    ...
+    'channels',
+    'rest_framework',
+    'rest_framework_simplejwt',
+    'drfchelseru',
+    ...
+]
+🛠️ پیکربندیبرای پیکربندی بسته، واژه‌نامه DJANGO_CHELSERU را به پرونده settings.py خود بیفزایید. این واژه‌نامه به شما پروانه می‌دهد تا چیدمان‌های راستی‌آزمایی و پیامک را خودساخته نمایید.# settings.py
+
+DJANGO_CHELSERU = {
+    'AUTH': {
+        'AUTH_METHOD'           : 'OTP',                        # روش‌های پشتیبانی شده: OTP, PASSWD
+        'AUTH_SERVICE'          : 'rest_framework_simplejwt',   # سرویس‌های پشتیبانی شده: rest_framework_simplejwt
+        'OPTIONS': {
+            'OTP_LENGTH'            : 8,    # پیش‌فرض: 8
+            'OTP_EXPIRE_PER_MINUTES': 4,    # پیش‌فرض: 4
+            'OTP_SMS_TEMPLATE_ID'   : 1,    # شناسه قالب پیامکی برای رمز یک‌بارمصرف
+        }
+    },
+    'SMS': {
+        'SMS_SERVICE': 'PARSIAN_WEBCO_IR',  # یاری‌دهنده‌های پشتیبانی شده: PARSIAN_WEBCO_IR, MELI_PAYAMAK_COM, KAVENEGAR_COM
+        'SETTINGS': {
+            'PARSIAN_WEBCO_IR_API_KEY'  : 'YOUR_PARSIAN_WEBCO_API_KEY',
+            'MELI_PAYAMAK_COM_USERNAME' : 'YOUR_MELI_PAYAMAK_USERNAME',
+            'MELI_PAYAMAK_COM_PASSWORD' : 'YOUR_MELI_PAYAMAK_PASSWORD',
+            'MELI_PAYAMAK_COM_FROM'     : 'YOUR_MELI_PAYAMAK_FROM_NUMBER',
+            'KAVENEGAR_COM_API_KEY'     : 'YOUR_KAVENEGAR_API_KEY',
+            'KAVENEGAR_COM_FROM'        : 'YOUR_KAVENEGAR_FROM_NUMBER',
+        },
+        'TEMPLATES': {
+            'T1': 1,
+            'T2': 2,
+            ...
+        }
+    }
+}
+AUTH_METHOD: روش راستی‌آزمایی را روشن می‌سازد. برای راستی‌آزمایی پیامکی، از 'OTP' بهره بگیرید.OTP_LENGTH: درازای رمز یک‌بارمصرف.OTP_EXPIRE_PER_MINUTES: زمان پایان‌یافتن رمز یک‌بارمصرف بر پایه دقیقه.OTP_SMS_TEMPLATE_ID: شناسه قالب پیامکی که برای فرستادن رمز یک‌بارمصرف بهره گرفته می‌شود.SMS_SERVICE: یاری‌دهنده پیامکی دلخواه خود را برگزینید.SETTINGS: آگاهی‌های نیاز برای یاری‌دهنده پیامکی برگزیده‌تان را فراهم آورید.TEMPLATES: شناسه‌های قالب پیامکی خود را روشن سازید.🔌 نقطه‌های پایانیبرای به کارگیری کارکردهای این بسته، URLهای زیر را به پرونده urls.py خود بیفزایید.# urls.py
+
+from django.urls import path, include
+
+urlpatterns = [
+    ...
+    path('api/', include('drfchelseru.urls')),
+    ...
+]
+این بسته نقطه‌های پایانی API زیر را فراهم می‌آورد:نقطه‌ پایانیشرحروش/api/otp/send/یک رمز یک‌بارمصرف به شماره همراه گفته‌شده می‌فرستد.POST/api/authenticate/کاربری را با رمز یک‌بارمصرف دریافت‌شده، راستی‌آزمایی می‌کند.POST/api/sessions/نشست‌های فعال کاربر را فهرست کرده و درایوری می‌کند.GET/api/message/send/یک پیامک با یاری‌دهنده پیکربندی‌شده می‌فرستد.POSTبه کارگیری نقطه‌های پایانی1. فرستادن رمز یک‌بارمصرف (/api/otp/send/)روش: POSTشرح: یک رمز یک‌بارمصرف به شماره همراه کاربر می‌فرستد.داده‌نماهای نیاز:داده‌نماگونهشرحنمونهmobile_numberstrشماره همراه کاربر.09121234567پاسخ‌ها:HTTP 200 OK: رمز یک‌بارمصرف با کامیابی فرستاده شد.{"details": "The OTP code was sent correctly."}
+HTTP 400 BAD REQUEST: ساختار نادرست mobile_number.HTTP 409 CONFLICT: یک رمز یک‌بارمصرف پیش‌تر فرستاده شده و هنوز روایی دارد.{"details": "An OTP code has already been sent. Please wait X seconds before trying again."}
+HTTP 500 INTERNAL SERVER ERROR: یک دشواری در کارگذار پیش آمده است.2. راستی‌آزمایی (/api/authenticate/)روش: POSTشرح: کاربر را با رمز یک‌بارمصرف فراهم شده، راستی‌آزمایی می‌کند. اگر با کامیابی انجام شود، توکن‌های JWT (access و refresh) را بازمی‌گرداند.داده‌نماهای نیاز:داده‌نماگونهشرحنمونهmobile_numberstrشماره همراه کاربر.09121234567codestrرمز یک‌بارمصرف دریافت شده از راه پیامک.12345678groupintاختیاری: یک شناسه دسته برای کاربر.1پاسخ‌ها:HTTP 200 OK: راستی‌آزمایی با کامیابی انجام شد.{
+  "access": "...",
+  "refresh": "..."
+}
+HTTP 401 UNAUTHORIZED: رمز یک‌بارمصرف ناروا یا پایان‌یافته.{"error": "The code sent to this mobile number was not found."}
+HTTP 400 BAD REQUEST: داده‌نماهای نیاز ناپیدا یا ساختار نادرست.HTTP 500 INTERNAL SERVER ERROR: یک دشواری در کارگذار پیش آمده است.3. فرستادن پیامک (/api/message/send/)روش: POSTشرح: یک پیامک خودساخته را با یاری‌دهنده پیکربندی‌شده می‌فرستد.داده‌نماهای نیاز:داده‌نماگونهشرحنمونهmobile_numberstrشماره همراه گیرنده.09121234567message_textstrنوشتار پیام. (بیشینه ۲۹۰ نویسه)Hello, World!template_idintبرای برخی یاری‌دهنده‌ها (برای نمونه پارسیان) نیاز است.1پاسخ‌ها:HTTP 200 OK: پیام با کامیابی فرستاده شد.{"details": "The Message was sent correctly."}
+HTTP 400 BAD REQUEST: دشواری‌های درست‌سنجی برای داده‌نماها.HTTP 401 UNAUTHORIZED: راستی‌آزمایی انجام نشد.HTTP 500 INTERNAL SERVER ERROR: یک دشواری در کارگذار پیش آمده است.HTTP 502 BAD GATEWAY: یاری‌دهنده پیامکی یک دشواری را بازگرداند.4. فهرست نشست‌ها (/api/sessions/)روش: GETشرح: همه نشست‌های فعال کاربران را فهرست می‌کند. نیاز به راستی‌آزمایی (IsAuthenticated) دارد.سربرگ‌های نیاز:سربرگارزشAuthorizationBearer <your_access_token>💡 مدل‌هااین بسته یک مدل Session برای درایوری نشست‌های فعال کاربران دارد. می‌توانید به این نشست‌ها از راه نقطه‌ پایانی /api/sessions/ دسترسی یافته و آنها را درایوری کنید.

django_chelseru-1.0.2/django_chelseru.egg-info/SOURCES.txt

@@ -0,0 +1,28 @@
+LICENSE
+MANIFEST.in
+README.md
+README_PA.md
+pyproject.toml
+setup.py
+django_chelseru.egg-info/PKG-INFO
+django_chelseru.egg-info/SOURCES.txt
+django_chelseru.egg-info/dependency_links.txt
+django_chelseru.egg-info/requires.txt
+django_chelseru.egg-info/top_level.txt
+drfchelseru/__init__.py
+drfchelseru/admin.py
+drfchelseru/apps.py
+drfchelseru/middlewares.py
+drfchelseru/models.py
+drfchelseru/serializers.py
+drfchelseru/services.py
+drfchelseru/settings.py
+drfchelseru/signals.py
+drfchelseru/tests.py
+drfchelseru/urls.py
+drfchelseru/validators.py
+drfchelseru/views.py
+drfchelseru/migrations/0001_initial.py
+drfchelseru/migrations/0002_otpcode_session_user.py
+drfchelseru/migrations/0003_rename_mobile_otpcode_mobile_number.py
+drfchelseru/migrations/__init__.py

{django_chelseru-1.0.0 → django_chelseru-1.0.2}/django_chelseru.egg-info/requires.txt

@@ -4,3 +4,5 @@ djangorestframework_simplejwt==5.5.0
 channels==4.2.2
 channels_redis==4.2.1
 daphne==4.1.2
+zeep==4.3.1
+user-agents==2.2.0

django_chelseru-1.0.2/django_chelseru.egg-info/top_level.txt

@@ -0,0 +1 @@
+drfchelseru

django_chelseru-1.0.2/drfchelseru/admin.py

@@ -0,0 +1,24 @@
+from django.contrib import admin
+from .models import User, OTPCode, Session, Message
+
+@admin.register(User)
+class MobileAdmin(admin.ModelAdmin):
+    list_display = ['id', 'user__id', 'user__username', 'mobile', 'user__is_active']
+
+
+@admin.register(OTPCode)
+class OTPCodeAdmin(admin.ModelAdmin):
+    list_display = ['id', 'code', 'mobile_number', 'created_at']
+    ordering = ('-created_at', )
+
+
+@admin.register(Session)
+class SessionAdmin(admin.ModelAdmin):
+    list_display = ['id', 'user__id', 'user__username', 'ip_address', 'last_seen']
+    ordering = ('-created_at', )
+
+@admin.register(Message)
+class MessageAdmin(admin.ModelAdmin):
+    list_display = ['id', 'mobile_number', 'message_text', 'status']
+    ordering = ('-created_at', )
+

django_chelseru-1.0.2/drfchelseru/apps.py

@@ -0,0 +1,9 @@
+from django.apps import AppConfig
+
+
+class DrfchelseruConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "drfchelseru"
+
+    def ready(self):
+        import drfchelseru.signals

django_chelseru-1.0.2/drfchelseru/middlewares.py

@@ -0,0 +1,44 @@
+from django.utils.timezone import datetime
+from .models import Session
+import user_agents
+
+
+class TakeUserSessionMiddlaware:
+    def __init__(self, get_response):
+        self.get_response = get_response
+
+    def __call__(self, request):
+        response = self.get_response(request)
+
+        if request.user.is_authenticated:
+            user_agent = request.META.get('HTTP_USER_AGENT', '')
+            ip = self.get_client_ip(request)
+
+            if not request.session.session_key:
+                request.session.create()
+            
+            session_key = request.session.session_key
+
+            session, created = Session.objects.get_or_create(
+                user = request.user,
+                session_key = session_key,
+                defaults = {
+                    'user_agent': user_agent,
+                    'ip_address': ip,
+                    'device': user_agents.parse(user_agent).device.family,
+                    'browser': user_agents.parse(user_agent).browser.family,
+                }
+            )
+
+            session.user_agent = user_agent
+            session.ip_address = ip
+            session.last_seen = datetime.now()
+            session.save()
+        
+        return response
+    
+    def get_client_ip(self, request):
+        x_forwarded_for = request.META.get('X_FORWARDED_FOR')
+        if x_forwarded_for:
+            return x_forwarded_for.split(',')[0]
+        return request.META.get('REMOTE_ADDR')

django_chelseru-1.0.2/drfchelseru/migrations/0001_initial.py

@@ -0,0 +1,33 @@
+# Generated by Django 5.1.6 on 2025-08-12 01:59
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = []
+
+    operations = [
+        migrations.CreateModel(
+            name="Message",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("message_text", models.TextField()),
+                ("mobile_number", models.CharField(max_length=20)),
+                ("_from", models.CharField(blank=True, max_length=20, null=True)),
+                ("status", models.CharField(blank=True, max_length=20, null=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+            ],
+        ),
+    ]

django_chelseru-1.0.2/drfchelseru/migrations/0002_otpcode_session_user.py

@@ -0,0 +1,92 @@
+# Generated by Django 5.1.6 on 2025-08-12 02:29
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("drfchelseru", "0001_initial"),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="OTPCode",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("code", models.CharField(max_length=10)),
+                ("mobile", models.CharField(max_length=11)),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+            ],
+        ),
+        migrations.CreateModel(
+            name="Session",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("session_key", models.CharField(max_length=40, unique=True)),
+                ("user_agent", models.TextField()),
+                ("ip_address", models.GenericIPAddressField()),
+                ("device", models.TextField()),
+                ("browser", models.TextField()),
+                ("last_seen", models.DateTimeField(auto_now=True)),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                (
+                    "user",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.DO_NOTHING,
+                        related_name="session_drf_chelseru",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+            ],
+        ),
+        migrations.CreateModel(
+            name="User",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("mobile", models.CharField(max_length=11)),
+                (
+                    "group",
+                    models.IntegerField(
+                        default=0,
+                        help_text="choice group type or user level, with numbers.",
+                    ),
+                ),
+                (
+                    "user",
+                    models.OneToOneField(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="mobile_drf_chelseru",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+            ],
+        ),
+    ]

django_chelseru-1.0.2/drfchelseru/migrations/0003_rename_mobile_otpcode_mobile_number.py

@@ -0,0 +1,18 @@
+# Generated by Django 5.1.6 on 2025-08-12 03:15
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("drfchelseru", "0002_otpcode_session_user"),
+    ]
+
+    operations = [
+        migrations.RenameField(
+            model_name="otpcode",
+            old_name="mobile",
+            new_name="mobile_number",
+        ),
+    ]