Skip to main content

No project description provided

Project description

🕯️ Candles CLI (TeamBridge Ecosystem)

PyPI version Python Version License: MIT

Candles CLI (teambridge-candles) is a developer-focused terminal synchronization utility built for the TeamBridge workspace ecosystem.

It monitors your local project files, detects changes, and synchronizes them with the TeamBridge cloud workspace in real-time.


🌐 Platform

Workspace Portal:

https://candels1921.vercel.app/

Production API:

https://candels.onrender.com


✨ Features

⚡ Real-Time Synchronization

Candles CLI watches your project directory and automatically syncs:

  • New files
  • Updated files
  • Deleted files
  • Folder changes
  • Project structure updates

🧠 Architecture

Local Project

Candles CLI

File Watcher

WebSocket Sync Engine

TeamBridge Cloud Workspace

Live Dashboard


🚀 Installation

Install package:

pip install teambridge-candles

After installation:

candles

or:

cn

Both commands are identical.


📖 Commands

🔐 Login

Command:

cn login

Example:

Enter your Candles registered email:
dev@example.com

Enter password:
********

Creates a secure authentication session.


Logout

Command:

cn logout

Output:

[Success] Cleared local session storage.

📂 Workspace Commands

Initialize Workspace

Command:

cn init

Output:

[Success]

Workspace initialized.

Start Live Sync

Command:

cn link

Starts the background file watcher.

Example:

[Sync] Connecting workspace...

[WebSocket] Connected

[Start] File watcher running

Press Ctrl+C to stop

All changes are synced automatically.


Download Workspace

Command:

cn get

Downloads latest workspace files.

Example:

[Sync] Downloading files...

README.md
backend/app.py
frontend/src/App.jsx

[Success]
Workspace updated.

Delete File

Command:

cn drop <file_path>

Example:

cn drop backend/test.py

Removes the file locally and from the cloud workspace.


Status

Command:

cn status

Displays:

  • Current user
  • Workspace
  • Connection
  • Directory path

Example:

CANDLES CLI STATUS

User:
Developer

Workspace:
TB-TEAM-ADB9A6

Connection:
Connected

Create Workspace

Command:

cn create

Opens workspace creation page.


🚫 Ignore System

Candles automatically ignores:

.git
.candles
node_modules
__pycache__
*.pyc
venv
env
virtualenv
dist
build

Improves:

  • Performance
  • Speed
  • Bandwidth usage

🔒 Security

Candles provides:

  • JWT authentication
  • Secure API communication
  • Encrypted session handling

Passwords are never stored as plain text.


🛠 Technology Stack

Built using:

  • Python
  • Watchdog
  • WebSockets
  • REST API
  • JWT
  • Cloud Storage

📦 Package

Install:

pip install teambridge-candles

🔄 Version History

Version Status Description
v1.0.0 Deprecated Initial sync engine
v1.0.1 Latest Improved synchronization and stability

🤝 Contributing

Clone:

git clone <repository>

Install:

pip install -r requirements.txt

Create your feature branch and submit changes.


🛡 License

MIT License


🕯️ Candles CLI

Code locally. Sync instantly. Build together.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

teambridge_candles-1.0.2.tar.gz (13.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

teambridge_candles-1.0.2-py3-none-any.whl (13.3 kB view details)

Uploaded Python 3

File details

Details for the file teambridge_candles-1.0.2.tar.gz.

File metadata

  • Download URL: teambridge_candles-1.0.2.tar.gz
  • Upload date:
  • Size: 13.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.11

File hashes

Hashes for teambridge_candles-1.0.2.tar.gz
Algorithm Hash digest
SHA256 2b35077a80c2649f36c4eba7ca74d70e08a0c19787dee1f1651ba7af94957c8d
MD5 6b2ef12609915417d7e0e8b30e09dcf8
BLAKE2b-256 dfd5e586ceb22fe626de9f1d701499d23305fcd61a15befef2e598753ce9864c

See more details on using hashes here.

File details

Details for the file teambridge_candles-1.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for teambridge_candles-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 82497614d6a2b0bb40b4a0df3d5022a47d79a8f0a4c8102db9a19428f1d93571
MD5 903f4e17a592bda0df09bdbab9d7d8ff
BLAKE2b-256 bdf3e4c55b81952ddd47cc765b7dbbadf90be946d6cac153ea0509d5cc4b4b80

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page