Django Private Chat2

New and improved https://github.com/Bearle/django-private-chat

Chat app for Django, powered by Django Channels, Websockets & Asyncio

Documentation

The full documentation will be at https://django_private_chat2.readthedocs.io.

Quickstart

Install django_private_chat2:

pip install django_private_chat2

Add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'django_private_chat2.apps.DjangoPrivateChat2Config',
    ...
)

Add django_private_chat2's URL patterns:

from django.urls import re_path, include


urlpatterns = [
    ...
    re_path(r'', include('django_private_chat2.urls', namespace='django_private_chat2')),
    ...
]

Add django_private_chat2's websocket URLs to your asgi.py:

django_asgi_app = get_asgi_application()
from channels.routing import ProtocolTypeRouter, URLRouter
from channels.auth import AuthMiddlewareStack
from django_private_chat2 import urls
application = ProtocolTypeRouter({
    "http": django_asgi_app,
    "websocket": AuthMiddlewareStack(
        URLRouter(urls.websocket_urlpatterns)
    ),
})

Important:

django_private_chat2 doesn't provide any endpoint to fetch users (required to start new chat, for example) It's up to you to do so. The example app does it in urls.py so feel free to copy the handler from there if you wish.

Support

It's important for us to have django_private_chat2 thoroughly tested.

Using github actions, we're able to have django_private_chat2 tested against python3.6, python3.7, python3.8, python3.9, python3.10 with Django 3.0, Django 3.1, Django 3.2, Django 4.0

You can view the builds here:

https://github.com/Bearle/django_private_chat2/actions

The builds are composed of officially supported Django & Python combinations.

Please file an issue if you have any problems with any combination of the above.

Features

Django-related

-:white_check_mark: Fully-functional example app

-:white_check_mark: Uses Django admin

-:white_check_mark: Supports pluggable User model (and accounts for non-integer primary keys, too)

-:white_check_mark: Doesn't require Django Rest Framework (views are based off django.views.generic)

-:white_check_mark: Configurable via settings

-:white_check_mark: Fully translatable

-:white_check_mark: Uses Django storage system & FileField for file uploads (swappable)

Functionality-related

-:white_check_mark: Soft deletable messages

-:white_check_mark: Read/unread messages

-:white_check_mark: Random id (send message first, write to database later)

-:white_check_mark: Supports text & file messages

-:white_check_mark: Gracefully handles errors

-:white_check_mark: Support 'typing' statuses

-:white_check_mark: Upload the file first, send the message later (async uploads) - potential for file ref re-use later

... and more

Example app frontend features

Auto reconnected websocket
Toasts about errors & events
Send text messages
Search for users
Create new chat with another user
Online/offline status
Realtime messaging via websocket
Last message
Auto-avatar (identicon) based on user id
Connection status display
Typing... status
Message delivery status (sent, received, waiting, etc.)
Message history
Persistent chat list
Read / unread messages
Unread messages counters (updates when new messages are received)
Send file messages (upload them to server)

TODO

Frontend (example app) & backend

Pagination support on frontend
1. For messages
2. For dialogs
Example app only - user list
1. ✅ Endpoint
2. ✅ UI
✅ New dialog support
Online's fetching on initial load
Last message
1. ✅ In fetch
2. ✅ In new dialog
3. ✅ On arriving message
✅ Read / unread/ unread count
Last seen
Send photo
✅ Send file
Reply to message
Delete message
Forward message
Search for dialog (username)
1. ✅ Frontend (local)
2. ~~Server based~~ - won't do, out of the scope of the project
✅ Fake data generator (to test & bench) - done via factories in tests
Cache dialogs (get_groups_to_add) - ?
Move views to async views - ?
Add some sounds
1. New message
2. New dialog
3. Sent message received db_id
Optimize /messages/ endpoint
✅Some tests
Full test coverage
Migration from v1 guide
Documentation
self-messaging (Saved messages)

Running Tests

Does the code actually work?

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install tox
(myenv) $ tox

Development commands

pip install -r requirements_dev.txt
invoke -l

Credits

Tools used in rendering this package:

Paid support

If you wish to have professional help from the authors of django_private_chat2, or simply hire Django experts to solve a particular problem, please contact us via email tech at bearle.ru or Bearle in telegram

License

VSofficial/django_private_chat2

ErrorLooks like something went wrong!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages