portacode 1.3.27__py3-none-any.whl → 1.3.27.dev1__py3-none-any.whl

portacode/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '1.3.27'
-__version_tuple__ = version_tuple = (1, 3, 27)
+__version__ = version = '1.3.27.dev1'
+__version_tuple__ = version_tuple = (1, 3, 27, 'dev1')
 
 __commit_id__ = commit_id = None

{portacode-1.3.27.dist-info → portacode-1.3.27.dev1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: portacode
-Version: 1.3.27
+Version: 1.3.27.dev1
 Summary: Portacode CLI client and SDK
 Home-page: https://github.com/portacode/portacode
 Author: Meena Erian

{portacode-1.3.27.dist-info → portacode-1.3.27.dev1.dist-info}/RECORD

@@ -1,7 +1,7 @@
 portacode/README.md,sha256=4dKtpvR8LNgZPVz37GmkQCMWIr_u25Ao63iW56s7Ke4,775
 portacode/__init__.py,sha256=oB3sV1wXr-um-RXio73UG8E5Xx6cF2ZVJveqjNmC-vQ,1086
 portacode/__main__.py,sha256=jmHTGC1hzmo9iKJLv-SSYe9BSIbPPZ2IOpecI03PlTs,296
-portacode/_version.py,sha256=lfm8QKOCYrPf3hyLkHj9R9SFlWO01BBk81sZeN5NiXw,706
+portacode/_version.py,sha256=__3W72Vcvh990Z238N2VaJ8keiMTtgdf7iI_1_6HAtI,719
 portacode/cli.py,sha256=eDqcZMVFHKzqqWxedhhx8ylu5WMVCLqeJQkbPR7RcJE,16333
 portacode/data.py,sha256=5-s291bv8J354myaHm1Y7CQZTZyRzMU3TGe5U4hb-FA,1591
 portacode/keypair.py,sha256=PAcOYqlVLOoZTPYi6LvLjfsY6BkrWbLOhSZLb8r5sHs,3635
@@ -35,10 +35,9 @@ portacode/connection/handlers/project_state/models.py,sha256=EZTKvxHKs8QlQUbzI0u
 portacode/connection/handlers/project_state/utils.py,sha256=LsbQr9TH9Bz30FqikmtTxco4PlB_n0kUIuPKQ6Fb_mo,1665
 portacode/static/js/test-ntp-clock.html,sha256=bUow9sifIuLNPqKvuPbpQozmEE6RhdCI4Plib3CqUmw,2130
 portacode/static/js/utils/ntp-clock.js,sha256=KMeHGT-IlUSlxVRZZ899z25dQCJh6EJbgXjlh8dD8vA,4495
-portacode/utils/NTP_ARCHITECTURE.md,sha256=WkESTbz5SNAgdmDKk3DrHMhtYOPji_Kt3_a9arWdRig,3894
 portacode/utils/__init__.py,sha256=NgBlWTuNJESfIYJzP_3adI1yJQJR0XJLRpSdVNaBAN0,33
 portacode/utils/ntp_clock.py,sha256=6QJOVZr9VQuxIyJt9KNG4dR-nZ3bKNyipMxjqDWP89Y,5152
-portacode-1.3.27.dist-info/licenses/LICENSE,sha256=2FGbCnUDgRYuQTkB1O1dUUpu5CVAjK1j4_p6ack9Z54,1066
+portacode-1.3.27.dev1.dist-info/licenses/LICENSE,sha256=2FGbCnUDgRYuQTkB1O1dUUpu5CVAjK1j4_p6ack9Z54,1066
 test_modules/README.md,sha256=Do_agkm9WhSzueXjRAkV_xEj6Emy5zB3N3VKY5Roce8,9274
 test_modules/__init__.py,sha256=1LcbHodIHsB0g-g4NGjSn6AMuCoGbymvXPYLOb6Z7F0,53
 test_modules/test_device_online.py,sha256=yiSyVaMwKAugqIX_ZIxmLXiOlmA_8IRXiUp12YmpB98,1653
@@ -63,8 +62,8 @@ testing_framework/core/playwright_manager.py,sha256=9kGXJtRpRNEhaSlV7XVXvx4UQSHS
 testing_framework/core/runner.py,sha256=j2QwNJmAxVBmJvcbVS7DgPJUKPNzqfLmt_4NNdaKmZU,19297
 testing_framework/core/shared_cli_manager.py,sha256=BESSNtyQb7BOlaOvZmm04T8Uezjms4KCBs2MzTxvzYQ,8790
 testing_framework/core/test_discovery.py,sha256=2FZ9fJ8Dp5dloA-fkgXoJ_gCMC_nYPBnA3Hs2xlagzM,4928
-portacode-1.3.27.dist-info/METADATA,sha256=3achcETltaOKmWGJ6gje69ghCufW6F3KtizLCtGjEf0,6989
-portacode-1.3.27.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-portacode-1.3.27.dist-info/entry_points.txt,sha256=lLUUL-BM6_wwe44Xv0__5NQ1BnAz6jWjSMFvZdWW3zU,48
-portacode-1.3.27.dist-info/top_level.txt,sha256=TGhTYUxfW8SyVZc_zGgzjzc24gGT7nSw8Qf73liVRKM,41
-portacode-1.3.27.dist-info/RECORD,,
+portacode-1.3.27.dev1.dist-info/METADATA,sha256=x5Uy8Re8oUeOEzqpwpywke4MeknBGAu0f1O6XD3XMEU,6994
+portacode-1.3.27.dev1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+portacode-1.3.27.dev1.dist-info/entry_points.txt,sha256=lLUUL-BM6_wwe44Xv0__5NQ1BnAz6jWjSMFvZdWW3zU,48
+portacode-1.3.27.dev1.dist-info/top_level.txt,sha256=TGhTYUxfW8SyVZc_zGgzjzc24gGT7nSw8Qf73liVRKM,41
+portacode-1.3.27.dev1.dist-info/RECORD,,

portacode/utils/NTP_ARCHITECTURE.md

@@ -1,136 +0,0 @@
-# NTP Clock Architecture
-
-## Overview
-
-All entities (client, server, device) synchronize to **time.cloudflare.com** for distributed tracing.
-
-## Architecture: Single Package for Everything
-
-All NTP clock implementations (Python and JavaScript) are in the **portacode package** to ensure DRY principles.
-
-## Python Implementation
-
-**Location:** `portacode/utils/ntp_clock.py` (in portacode package)
-
-### Import Path
-```python
-from portacode.utils.ntp_clock import ntp_clock
-```
-
-### Usage Locations
-1. **Django Server Consumers** (`server/portacode_django/dashboard/consumers.py`)
-2. **Device Base Handlers** (`portacode/connection/handlers/base.py`)
-3. **Device Client** (`server/portacode_django/data/services/device_client.py`)
-4. **Any Python code with portacode installed**
-
-### Dependencies
-- `setup.py`: Added `ntplib>=0.4.0` to `install_requires`
-- `server/portacode_django/requirements.txt`: Added `portacode>=1.3.26`
-
-### API
-```python
-# Get NTP-synchronized timestamp (None if not synced)
-ntp_clock.now_ms()      # milliseconds
-ntp_clock.now()         # seconds
-ntp_clock.now_iso()     # ISO format
-
-# Check sync status
-status = ntp_clock.get_status()
-# {
-#   'server': 'time.cloudflare.com',
-#   'offset_ms': 6.04,
-#   'last_sync': '2025-10-05T04:37:12.768445+00:00',
-#   'is_synced': True
-# }
-```
-
-## JavaScript Implementation
-
-**Location:** `portacode/static/js/utils/ntp-clock.js` (in portacode package)
-
-### Django Setup
-
-Django will serve static files from the portacode package automatically after `collectstatic`:
-
-```python
-# Django settings.py - no changes needed, just ensure:
-INSTALLED_APPS = [
-    # ... other apps
-    'portacode',  # Add portacode as an installed app (optional, for admin integration)
-]
-
-# Static files will be collected from portacode package
-STATIC_URL = '/static/'
-```
-
-After installing portacode (`pip install portacode` or `pip install -e .`), run:
-```bash
-python manage.py collectstatic
-```
-
-This will copy `portacode/static/js/utils/ntp-clock.js` to Django's static files directory.
-
-### Import Path (in Django templates/JS)
-```javascript
-import ntpClock from '/static/js/utils/ntp-clock.js';
-// or relative to your JS file:
-import ntpClock from './utils/ntp-clock.js';
-```
-
-### Usage Locations
-1. **Dashboard WebSocket** (`websocket-service.js`)
-2. **Project WebSocket** (`websocket-service-project.js`)
-
-### API
-```javascript
-// Get NTP-synchronized timestamp (null if not synced)
-ntpClock.now()          // milliseconds
-ntpClock.nowISO()       // ISO format
-
-// Check sync status
-const status = ntpClock.getStatus();
-// {
-//   server: 'time.cloudflare.com',
-//   offset: 6.04,
-//   lastSync: '2025-10-05T04:37:12.768445+00:00',
-//   isSynced: true
-// }
-```
-
-## Design Principles
-
-1. **DRY (Don't Repeat Yourself)**
-   - **Python:** Single implementation in portacode package (`portacode/utils/ntp_clock.py`)
-   - **JavaScript:** Single implementation in portacode package (`portacode/static/js/utils/ntp-clock.js`)
-   - Both served from the same package, no duplication across repos
-
-2. **No Fallback Servers**
-   - All entities MUST sync to time.cloudflare.com
-   - If sync fails, timestamps are None/null
-   - Ensures all timestamps are comparable
-
-3. **Auto-Sync**
-   - Re-syncs every 5 minutes automatically
-   - Initial sync on import/load
-   - Max 3 retry attempts before marking as failed
-
-4. **Thread-Safe (Python)**
-   - Uses threading.Lock for concurrent access
-   - Background daemon thread for periodic sync
-
-## Testing
-
-### Python
-```bash
-python tools/test_python_ntp_clock.py
-```
-
-### JavaScript
-The test file is included in the package at `portacode/static/js/test-ntp-clock.html`.
-
-After Django collectstatic, open: `/static/js/test-ntp-clock.html` in browser
-
-Or run directly from package:
-```bash
-python -c "import portacode, os; print(os.path.join(os.path.dirname(portacode.__file__), 'static/js/test-ntp-clock.html'))"
-```