pushframe 5.0.0__py3-none-any.whl

pushframe/utils/dt.py

@@ -0,0 +1,15 @@
+from datetime import datetime
+
+AURA_DT_FORMAT = '%Y-%m-%dT%H:%M:%S.%fZ'
+
+
+def parse_aura_dt(aura_dt_str: str):
+    return datetime.strptime(aura_dt_str, AURA_DT_FORMAT)
+
+
+def get_utc_now():
+    return datetime.utcnow()
+
+
+def format_dt_to_aura(dt: datetime):
+    return dt.strftime(AURA_DT_FORMAT)

pushframe/utils/io.py

@@ -0,0 +1,23 @@
+import json
+import os
+from typing import Union
+
+from pydantic import BaseModel
+
+
+def build_path(*args, make_dir: bool = True):
+    path = os.path.join(*args)
+    if make_dir:
+        os.makedirs(os.path.dirname(path), exist_ok=True)
+    return path
+
+
+def _pydantic_default(obj):
+    if isinstance(obj, BaseModel):
+        return obj.model_dump(mode="json")
+    raise TypeError(f"Object of type {type(obj).__name__} is not JSON serializable")
+
+
+def write_model(model: Union[BaseModel, list[BaseModel]], path: str) -> None:
+    with open(path, 'w') as out:
+        json.dump(model, out, default=_pydantic_default)

pushframe/utils/settings.py

@@ -0,0 +1,59 @@
+import os
+from pathlib import Path
+
+
+def _env(*names: str) -> str | None:
+    """First set variable among `names` (IDN-04, phase 20): PUSHFRAME_* is the
+    documented primary spelling, the legacy AURA_* spellings remain readable
+    as a one-release fallback. Explicitly-set values win in the order given."""
+    for name in names:
+        value = os.getenv(name)
+        if value is not None:
+            return value
+    return None
+
+
+LOCALE = _env('PUSHFRAME_LOCALE', 'AURA_LOCALE') or 'en-US'
+AURA_APP_IDENTIFIER = _env('PUSHFRAME_APP_IDENTIFIER', 'AURA_APP_IDENTIFIER') or 'com.pushd.client'
+# TODO: Load device identifier through config
+DEVICE_IDENTIFIER = _env('PUSHFRAME_DEVICE_IDENTIFIER', 'AURA_DEVICE_IDENTIFIER') or '0000000000000000'
+IMAGE_PROXY_BASE_URL = 'https://imgproxy.pushd.com'
+
+
+def _bool_env(name: str, default: bool) -> bool:
+    """Defensive boolean env-var parser (Phase 09, ANTI-05) -- Python's
+    built-in `bool("false")` is `True`, so every non-empty string env var
+    needs this membership test instead. Missing var -> `default`; present
+    -> case-insensitive membership in `('1', 'true', 'yes', 'on')`."""
+    return _bool_env2(os.getenv(name), default)
+
+
+def _bool_env2(raw: str | None, default: bool) -> bool:
+    """Boolean parse of an already-resolved raw value (IDN-04): None ->
+    default; present -> case-insensitive membership in ('1','true','yes','on')."""
+    if raw is None:
+        return default
+    return raw.strip().lower() in ('1', 'true', 'yes', 'on')
+
+
+# Proactive write-rate-budget + geo pre-flight guard config (Phase 09,
+# ANTI-05) -- the first non-string env vars in this codebase, hence the
+# `_bool_env` helper above and bare `float(...)` for the numeric ones.
+AURA_WRITE_BUDGET_CAPACITY = float(_env('PUSHFRAME_WRITE_BUDGET_CAPACITY', 'AURA_WRITE_BUDGET_CAPACITY') or '30')
+AURA_WRITE_BUDGET_REFILL_PER_MIN = float(_env('PUSHFRAME_WRITE_BUDGET_REFILL_PER_MIN', 'AURA_WRITE_BUDGET_REFILL_PER_MIN') or '0.75')
+AURA_WRITE_BUDGET_WAIT = _bool_env2(_env('PUSHFRAME_WRITE_BUDGET_WAIT', 'AURA_WRITE_BUDGET_WAIT'), True)
+AURA_WRITE_BUDGET_MAX_WAIT = float(_env('PUSHFRAME_WRITE_BUDGET_MAX_WAIT', 'AURA_WRITE_BUDGET_MAX_WAIT') or '3600')
+# None -> geo pre-flight check skipped entirely, per check_geo's falsy contract.
+AURA_COUNTRY = _env('PUSHFRAME_COUNTRY', 'AURA_COUNTRY')
+AURA_GEO_FAIL_OPEN = _bool_env2(_env('PUSHFRAME_GEO_FAIL_OPEN', 'AURA_GEO_FAIL_OPEN'), True)
+AURA_STATE_DIR = Path(_env('PUSHFRAME_STATE_DIR', 'AURA_STATE_DIR') or '~/.config/pushframe').expanduser()
+
+# AWS endpoints/identifiers (Phase 19, MOD-02) -- moved out of the hardcoded
+# module constants in pushframe/aws/s3client.py and sqsclient.py (closing
+# their `TODO: read them in through config?`). Defaults ARE the literals that
+# shipped for years, so an unset environment behaves byte-identically.
+AWS_S3_BUCKET = _env('PUSHFRAME_AWS_S3_BUCKET', 'AURA_AWS_S3_BUCKET') or 'images.senseapp.co'
+AWS_UPLOAD_IDENTITY_POOL_ID = _env(
+    'PUSHFRAME_AWS_UPLOAD_POOL_ID', 'AURA_AWS_UPLOAD_POOL_ID') or 'us-east-1:b92826c0-8274-43db-abff-136977c13598'
+AWS_SQS_IDENTITY_POOL_ID = _env(
+    'PUSHFRAME_AWS_SQS_POOL_ID', 'AURA_AWS_SQS_POOL_ID') or 'us-east-1:98ccd0ff-69fe-4e9a-ad34-671b4381ab12'

pushframe-5.0.0.dist-info/METADATA

@@ -0,0 +1,53 @@
+Metadata-Version: 2.5
+Name: pushframe
+Version: 5.0.0
+License: MIT License
+        
+        Copyright (c) 2026 Fabrice DIDIERJEAN (coredmp95)
+        Copyright (c) 2023 zmanowar (zach@codehooker.com) — original auraframes client
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+        ---
+        
+        Provenance note: this project began as a fork of zmanowar's `auraframes`
+        (https://github.com/zmanowar/auraframes), which ships without an explicit
+        license. The original author's work (reverse-engineered API models, auth,
+        read/upload flows) is credited in the README and preserved in the git
+        history. This fork's own additions are licensed MIT above. If you are the
+        original author and want a different arrangement, please open an issue.
+License-File: LICENSE
+Requires-Python: >=3.14
+Requires-Dist: boto3>=1.34
+Requires-Dist: botocore>=1.34
+Requires-Dist: geopy>=2.4
+Requires-Dist: h2>=4
+Requires-Dist: httpx[http2]>=0.27
+Requires-Dist: loguru>=0.7
+Requires-Dist: piexif>=1.1.3
+Requires-Dist: pillow-heif>=1.6
+Requires-Dist: pillow>=10.4
+Requires-Dist: pydantic>=2
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: requests>=2.31
+Requires-Dist: tqdm>=4.66
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Provides-Extra: google-browser
+Requires-Dist: playwright>=1.63.0; extra == 'google-browser'

pushframe-5.0.0.dist-info/RECORD

@@ -0,0 +1,49 @@
+pushframe/__init__.py,sha256=-WHw8HbuRSp-Zfv2svg9sYcc5906dEk5ovWq-M3gBJ8,245
+pushframe/aura.py,sha256=5P9ho5OHHyv5pzkQdWBk0wvKkEgvyfXXL9r3kOVxw0g,8050
+pushframe/cache.py,sha256=tPa3m8u7_iSZA8zZMb-jfdSunWIg7AWCGMpQJFgV_Y0,1394
+pushframe/cli.py,sha256=Jvu2indOJUxMqvmYli7qFo9x4yMNdVOqlWN3x95FlfM,56870
+pushframe/client.py,sha256=zvLK-VQBSi7wpc42nUp-D9V4WlAjCBa6TUdJokVWrzI,11734
+pushframe/exif.py,sha256=BATVlXUmNYfCcIQ-PzVyHqMhpAktAumMAj_UTkIctcc,5001
+pushframe/export.py,sha256=FzxxGeJweTRGOboENLo1GnVtdiX3-l66EqqCXpdnI8Q,1994
+pushframe/gsync.py,sha256=DlbRkCBTS4aNFgbFSNteEp9h-cZ0GTHLMH4nLIkPI1U,19909
+pushframe/migration.py,sha256=HPQK7-EjYcvCZJkVUjieZspkn5Tx8VbW8aSyN7A4V5w,3171
+pushframe/ratelimit.py,sha256=zct6vEdDSML-2Av3N44AYOBMrfo7Ymm6ZidWA1QCjNQ,10150
+pushframe/reconcile.py,sha256=YpkBkVQwC5_XPPFYY0OxXk9b7xiEuFFGd2cqnMbSTu0,20195
+pushframe/sync.py,sha256=HD1IMaR7nH6dveIXMa85qNV09d3IScuuhh3UqGStJ48,58011
+pushframe/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pushframe/api/accountApi.py,sha256=ncEsFVuZJJpHbC-D9klDhg80JnkhsRiDf_SCFOjCZPE,2624
+pushframe/api/activityApi.py,sha256=q7JeXTFKiWuDiBKSDeaRODAXyKWvdM4-f5PSuB-dYWo,3673
+pushframe/api/assetApi.py,sha256=EvO0VUtrCyWxWFPkM7BKChwX23m1AnXs7lHkyYdRLP8,9223
+pushframe/api/baseApi.py,sha256=bh6n-VB1NNmMCCanjFNKFMj-vlfcZg3KIRuseqYzyz8,123
+pushframe/api/frameApi.py,sha256=x98q3rcBu4Uyy6PIU61VAOKKeoxAXd-ZAkeQxTjvkks,13867
+pushframe/api/notificationApi.py,sha256=WTEuPWa5eH_3kaKxlDadR6C8jQheRG-QusYntzoIyoU,417
+pushframe/api/peopleApi.py,sha256=H0gTumZKXr9XNx2xFUgy6i_PNJj7fabWkRBBxDyQeKU,855
+pushframe/api/playlistApi.py,sha256=xV-s9sUOeCiPCuZ_xUdrxwsqsIOmSiyKV2pqkDFdNMU,410
+pushframe/aws/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pushframe/aws/awsclient.py,sha256=tgVjzazUQi8GzS5C4HbwVn_WzhlhFWJ8GEQa7JE1-zk,761
+pushframe/aws/s3client.py,sha256=7voCybCgmBVpM9JgbSbxGrczShlyFgi-ORBlsgd3H6U,1449
+pushframe/aws/sqsclient.py,sha256=1lfvoXg0A_QqWdAuv28ae_lltnCBMQmdGG29BUsg8N4,1531
+pushframe/google/__init__.py,sha256=PEvLM4wu30SEK-vgn8U3OP1R-Pg0-lrU-LhNQGm6W2A,1545
+pushframe/google/bootstrap.py,sha256=ZkS32-PpKO00idqaISSjC2ZpnX45StoOZAKSHxGA8Gw,5972
+pushframe/google/cache.py,sha256=CxccnrSBkMwWdlMAEJpe4o-g0OZ3v77T74toUWwCbJ8,6992
+pushframe/google/client.py,sha256=XD6oi0P1Bb_pKRb6KuvDVVOeZvl-A9axAoLAitQ3Os4,5820
+pushframe/google/enumerate.py,sha256=E224EsK3Uo3ihWyN8yL1H1gCfU-7puOay8RDZeiQzAE,11522
+pushframe/google/manifest.py,sha256=59JU4WCKaO3qd9Le1f97GEmT5gc1Lb7I5tsm72V7aTE,4618
+pushframe/google/parsers.py,sha256=yyOF0S4beaY_SlcjZZn375CW2ZTahCg2jjT2wmTlpCQ,12913
+pushframe/google/redaction.py,sha256=I3KnEPNKXM7-Nr8RQQZnDSJD_6LRAvK43uO1YUXpd-o,1331
+pushframe/google/vault.py,sha256=Y1AAjt-E0nohsZhhe3lLWL8oQ59_AGujscaSPtzStPw,5129
+pushframe/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pushframe/models/activity.py,sha256=KVPdaiba5oTMISPXesjJbeLIuUsLYyx-zCjzDWOGWpo,1872
+pushframe/models/asset.py,sha256=VyP3ZLPlvgvU2CBV6JwwwWAcHP56wzqUd8Z7cWame18,6087
+pushframe/models/frame.py,sha256=-DIRiJw9_okkFZ6ll1lKktL9Yhx7raA923i0dS9KAlw,3298
+pushframe/models/meta.py,sha256=pi5VQYjutn2MmlGUZpmOHyr7cLbYlcuUCgJ4rY98ws4,330
+pushframe/models/person.py,sha256=8eNAxSiF9yKjDL0BMApqO9qSqzdPJ5NTvjbLKk06kmI,462
+pushframe/models/user.py,sha256=huscS56RlN3W0DMX20wAKbDACf5Ueg2ajJiU_zYvHs4,582
+pushframe/utils/dt.py,sha256=lgziyv0Ie4138l2njwkV7VvMei_uPoZrt2CfZE4JnsU,297
+pushframe/utils/io.py,sha256=bu1e-2FUCfMf9O1gcNtawqx2ecDeM1WjTjNqvjVTAYo,612
+pushframe/utils/settings.py,sha256=NlDVcdGTJtjMSebQ_MRu8ASmaDWOllTZJwcWPifMTbo,3218
+pushframe-5.0.0.dist-info/METADATA,sha256=KmEwFky6zjaCnJlsSeHxczrk8BK9_hUcT2cCeI4PTd4,2483
+pushframe-5.0.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+pushframe-5.0.0.dist-info/entry_points.txt,sha256=3JQ8L1X8lpPWQfMLx0rto47zM_FZedgu1GpH7TQY8Ho,49
+pushframe-5.0.0.dist-info/licenses/LICENSE,sha256=_YQ-4jjriQDARI8HmVx4te8JNpc57Dq7JduhhPu-lY4,1611
+pushframe-5.0.0.dist-info/RECORD,,

pushframe-5.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

pushframe-5.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pushframe = pushframe.cli:main

pushframe-5.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,31 @@
+MIT License
+
+Copyright (c) 2026 Fabrice DIDIERJEAN (coredmp95)
+Copyright (c) 2023 zmanowar (zach@codehooker.com) — original auraframes client
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Provenance note: this project began as a fork of zmanowar's `auraframes`
+(https://github.com/zmanowar/auraframes), which ships without an explicit
+license. The original author's work (reverse-engineered API models, auth,
+read/upload flows) is credited in the README and preserved in the git
+history. This fork's own additions are licensed MIT above. If you are the
+original author and want a different arrangement, please open an issue.