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.1.tar.gz (12.6 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.1-py3-none-any.whl (12.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: teambridge_candles-1.0.1.tar.gz
  • Upload date:
  • Size: 12.6 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.1.tar.gz
Algorithm Hash digest
SHA256 d7aac21ec9c8b3aa532fae7834b1a83754699ced9b0812626323de06c39c9b0d
MD5 bab718f1c2d46493db6447b08a558909
BLAKE2b-256 c8449672f784599fb1f13e8d9352a87893237ce1e4e1bcd41dde8c904010b939

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for teambridge_candles-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 20d339bfcd8643d56740f6dcfabc96a9cd17ce6c25d5a3238b866e69386bdc86
MD5 f8b6f93eae765c4aabc518146696a9d9
BLAKE2b-256 b4f00b6f7b582aae2b0201324c7587fc432c0415c9be1e4a3a02551378aedeac

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