Skip to content
This repository has been archived by the owner on Jan 19, 2023. It is now read-only.

tomheaton/pcj8-jazzed-jerboas

Repository files navigation

Jazzed Jerboas

Python Discord Code Jam 8 - Jazzed Jerboas

This is the Jazzed Jerboa's submission to the Python Discord Summer Code Jam 2021 (Code Jam 8)

ThaBox

Introducing ThaBox, a text-based chat application. ThaBox is a social media platform in which the conversations between users are for the users only. Not a single message is saved, giving you the utmost privacy.

Chat with strangers in boxes, or have a blast with your friends in boxes.

Messages can be sent to another person in the same box, by simply typing it out when you receive the prompt. Messages that you receive are available for several seconds after the message has been sent before disappearing.

Cylce through ThaBox's many options using you keyboard and select from a variety of customisations that can be applied to your boxes. The colour scheme of your box can be changed in the preferences page once logged in. Colours can be used to personalise different parts of your box

ThaBox

  • built using the Rich framework

How to set up the project

Creating the environment

Create a virtual environment in the folder .venv.

$ cd 'path/to/clone_of_repo'
$ python -m venv .venv

Enter the environment

It will change based on your operating system and shell.

# Linux, Bash
$ source .venv/bin/activate
# Linux, Fish
$ source .venv/bin/activate.fish
# Linux, Csh
$ source .venv/bin/activate.csh
# Linux, PowerShell Core
$ .venv/bin/Activate.ps1
# Windows, cmd.exe
> .venv\Scripts\activate.bat
# Windows, PowerShell
> .venv\Scripts\Activate.ps1

Installing the Dependencies

Once the environment is created and activated, use this command to install the development dependencies.

$ cd 'path/to/clone_of_repo'
$ pip install -r dev-requirements.txt

Starting the Scripts

Use this command to start the server. (Needs to be done before running client)

$ cd 'path/to/clone_of_repo'
$ python server/server.py

Finally, use this command to start the client interface.

$ cd 'path/to/clone_of_repo'
$ python client/client.py

Using the project

Testing the project

Testing of the project has to be done locally. (Tom Heathon could not get his server up :| R.I.P server)

For testing of the messages you need to terminals up running client/client.py and one terminal runing server/server.py (For client to work the server needs to run in the backround first)

Info

If you are using windows we reccomend using the new and modern Windows Terminal which you can find in the Microsoft Store. (This makes animation much smoother)

The project will not work on Linux unless you are root because of how the keyboard module works.

When typing out password you will not see what you type. (This is to hide your password from hackers who look over your shoulder while you are typing your password lol)

Authors

Team Jazzed Jerboas - tomheaton, MikeNoCap, HiPeople21, TahU28, ryoflux, b-a-b-i-s

Releases

No releases published

Sponsor this project

 

Packages

No packages published

Languages