gitstore 0.2.1__tar.gz → 0.2.3__tar.gz

{gitstore-0.2.1 → gitstore-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitstore
-Version: 0.2.1
+Version: 0.2.3
 Summary: Utilities to encrypt files/directories with utilitz and exchange them through GitHub repositories.
 Author: artitzco
 License: MIT
@@ -63,7 +63,7 @@ record = upload_to_github(
     request_timeout=60,                   # default
     security_level="high",                # default
     replace_existing=True,                # default
-    force_upload=False,                   # default
+    force=False,                          # default
     commit_message=None,                  # default: automatic message
 )
 print(record)
@@ -73,7 +73,7 @@ Upload behavior:
 
 - computes `source_hash` from source content before encryption
 - skips upload if same `name` already has same `source_hash`
-- set `force_upload=True` to upload even when the current source matches the remote metadata
+- set `force=True` to upload even when the current source matches the remote metadata
 - stores artifact as `vault/<name>.asc`
 - stores metadata in `vault/index.json`
 - removes temporary encrypted file after processing
@@ -109,11 +109,12 @@ folder/documento
 from gitstore import restore_from_github
 
 output_path = restore_from_github(
-    github_url="https://github.com/USER/REPO/blob/main/vault/documento_ventas_q2.asc",
+    github_raw_url="https://raw.githubusercontent.com/USER/REPO/main/vault/documento_ventas_q2.asc",
     password=None,      # default: uses GITSTORE_PASSWORD
     output_path=None,   # default: restores in the current working directory
     overwrite=False,    # default
-    force_download=False, # default
+    force=False,        # default
+    use_urllib=False,   # default: True uses urllib alternative route
 )
 print(output_path)
 ```
@@ -138,9 +139,11 @@ Tip:
 
 Download behavior:
 
-- accepts normal GitHub file URLs (`github.com/.../blob/...`) and raw URLs
+- expects RAW GitHub URLs (`raw.githubusercontent.com/...`) as primary input
+- also accepts `github.com/.../blob/...` and normalizes automatically
 - skips download when `output_path` already exists and matches the remote `source_hash` in `vault/index.json`
-- set `force_download=True` to download even when the local output appears aligned
+- set `force=True` to download even when the local output appears aligned
+- set `use_urllib=True` to use the urllib alternative transport path
 - downloads the encrypted `.asc` file to a temporary location
 - restores files or directories automatically with `utilitz.crypto`
 - removes the temporary encrypted file after restore

{gitstore-0.2.1 → gitstore-0.2.3}/README.md

@@ -52,7 +52,7 @@ record = upload_to_github(
     request_timeout=60,                   # default
     security_level="high",                # default
     replace_existing=True,                # default
-    force_upload=False,                   # default
+    force=False,                          # default
     commit_message=None,                  # default: automatic message
 )
 print(record)
@@ -62,7 +62,7 @@ Upload behavior:
 
 - computes `source_hash` from source content before encryption
 - skips upload if same `name` already has same `source_hash`
-- set `force_upload=True` to upload even when the current source matches the remote metadata
+- set `force=True` to upload even when the current source matches the remote metadata
 - stores artifact as `vault/<name>.asc`
 - stores metadata in `vault/index.json`
 - removes temporary encrypted file after processing
@@ -98,11 +98,12 @@ folder/documento
 from gitstore import restore_from_github
 
 output_path = restore_from_github(
-    github_url="https://github.com/USER/REPO/blob/main/vault/documento_ventas_q2.asc",
+    github_raw_url="https://raw.githubusercontent.com/USER/REPO/main/vault/documento_ventas_q2.asc",
     password=None,      # default: uses GITSTORE_PASSWORD
     output_path=None,   # default: restores in the current working directory
     overwrite=False,    # default
-    force_download=False, # default
+    force=False,        # default
+    use_urllib=False,   # default: True uses urllib alternative route
 )
 print(output_path)
 ```
@@ -127,9 +128,11 @@ Tip:
 
 Download behavior:
 
-- accepts normal GitHub file URLs (`github.com/.../blob/...`) and raw URLs
+- expects RAW GitHub URLs (`raw.githubusercontent.com/...`) as primary input
+- also accepts `github.com/.../blob/...` and normalizes automatically
 - skips download when `output_path` already exists and matches the remote `source_hash` in `vault/index.json`
-- set `force_download=True` to download even when the local output appears aligned
+- set `force=True` to download even when the local output appears aligned
+- set `use_urllib=True` to use the urllib alternative transport path
 - downloads the encrypted `.asc` file to a temporary location
 - restores files or directories automatically with `utilitz.crypto`
 - removes the temporary encrypted file after restore

{gitstore-0.2.1 → gitstore-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gitstore"
-version = "0.2.1"
+version = "0.2.3"
 description = "Utilities to encrypt files/directories with utilitz and exchange them through GitHub repositories."
 readme = "README.md"
 requires-python = ">=3.10"

{gitstore-0.2.1 → gitstore-0.2.3}/src/gitstore/client.py

@@ -7,10 +7,15 @@ import hmac
 import re
 from dataclasses import dataclass
 from datetime import datetime, timezone
-from pathlib import Path
-
+from pathlib import Path
+
 from .config import GitStoreConfig
-from .github_ops import download_raw_file, git_add_commit_push, normalize_github_file_url
+from .github_ops import (
+    download_raw_file,
+    download_raw_file_urllib,
+    git_add_commit_push,
+    normalize_github_file_url,
+)
 from .crypto_ops import decrypt_auto, encrypt_directory, encrypt_file
 
 DEFAULT_PASSWORD_ENV_VAR = "GITSTORE_PASSWORD"
@@ -97,18 +102,19 @@ def _hmac_source(path: Path, secret: str) -> str:
 
 
 def restore_from_github(
-    github_url: str,
+    github_raw_url: str,
     password: str | None = None,
     output_path: str | None = None,
     overwrite: bool = False,
-    force_download: bool = False,
+    force: bool = False,
+    use_urllib: bool = False,
     request_timeout: int = 60,
     password_env_var: str = DEFAULT_PASSWORD_ENV_VAR,
 ) -> str:
     resolved_password = _resolve_password(password, password_env_var)
     config = GitStoreConfig(password=resolved_password, request_timeout=request_timeout)
-    raw_url = normalize_github_file_url(github_url)
-    if output_path is not None and not overwrite and not force_download:
+    raw_url = normalize_github_file_url(github_raw_url)
+    if output_path is not None and not overwrite and not force:
         existing_output = Path(output_path).expanduser().resolve()
         if existing_output.exists():
             remote_record = _load_remote_record_for_artifact(raw_url, request_timeout)
@@ -130,7 +136,10 @@ def restore_from_github(
         temp_dir = Path(tempfile.mkdtemp(prefix="gitstore_download_"))
         temp_file = temp_dir / "artifact.asc"
     try:
-        download_raw_file(raw_url, str(temp_file), timeout=request_timeout)
+        if use_urllib:
+            download_raw_file_urllib(raw_url, str(temp_file), timeout=request_timeout)
+        else:
+            download_raw_file(raw_url, str(temp_file), timeout=request_timeout)
         restored_path = decrypt_auto(
             encrypted_path=str(temp_file),
             config=config,
@@ -201,7 +210,7 @@ def upload_to_github(
     security_level: str = "high",
     commit_message: str | None = None,
     replace_existing: bool = True,
-    force_upload: bool = False,
+    force: bool = False,
 ) -> StoredArtifact:
     if not repo_path:
         raise ValueError("repo_path is required.")
@@ -227,7 +236,7 @@ def upload_to_github(
     existing_record = manifest.get(name)
     if existing_record:
         existing_source_hash = str(existing_record.get("source_hash", "")).lower()
-        if existing_source_hash == source_hash.lower() and not force_upload:
+        if existing_source_hash == source_hash.lower() and not force:
             print(
                 f"[gitstore] Skip upload: '{name}' already up to date "
                 f"(source_hash={source_hash[:24]})."

{gitstore-0.2.1 → gitstore-0.2.3}/src/gitstore/github_ops.py

@@ -1,5 +1,6 @@
-import subprocess
-from pathlib import Path
+import subprocess
+import urllib.request
+from pathlib import Path
 
 import requests
 
@@ -40,6 +41,16 @@ def download_raw_file(raw_url: str, output_path: str, timeout: int = 60) -> str:
     return str(destination)
 
 
+def download_raw_file_urllib(raw_url: str, output_path: str, timeout: int = 60) -> str:
+    destination = Path(output_path).expanduser().resolve()
+    destination.parent.mkdir(parents=True, exist_ok=True)
+    with urllib.request.urlopen(raw_url, timeout=timeout) as response:
+        content = response.read()
+    with open(destination, "wb") as f:
+        f.write(content)
+    return str(destination)
+
+
 def git_add_commit_push(
     repo_path: str,
     paths_in_repo: list[str],

{gitstore-0.2.1 → gitstore-0.2.3}/src/gitstore.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitstore
-Version: 0.2.1
+Version: 0.2.3
 Summary: Utilities to encrypt files/directories with utilitz and exchange them through GitHub repositories.
 Author: artitzco
 License: MIT
@@ -63,7 +63,7 @@ record = upload_to_github(
     request_timeout=60,                   # default
     security_level="high",                # default
     replace_existing=True,                # default
-    force_upload=False,                   # default
+    force=False,                          # default
     commit_message=None,                  # default: automatic message
 )
 print(record)
@@ -73,7 +73,7 @@ Upload behavior:
 
 - computes `source_hash` from source content before encryption
 - skips upload if same `name` already has same `source_hash`
-- set `force_upload=True` to upload even when the current source matches the remote metadata
+- set `force=True` to upload even when the current source matches the remote metadata
 - stores artifact as `vault/<name>.asc`
 - stores metadata in `vault/index.json`
 - removes temporary encrypted file after processing
@@ -109,11 +109,12 @@ folder/documento
 from gitstore import restore_from_github
 
 output_path = restore_from_github(
-    github_url="https://github.com/USER/REPO/blob/main/vault/documento_ventas_q2.asc",
+    github_raw_url="https://raw.githubusercontent.com/USER/REPO/main/vault/documento_ventas_q2.asc",
     password=None,      # default: uses GITSTORE_PASSWORD
     output_path=None,   # default: restores in the current working directory
     overwrite=False,    # default
-    force_download=False, # default
+    force=False,        # default
+    use_urllib=False,   # default: True uses urllib alternative route
 )
 print(output_path)
 ```
@@ -138,9 +139,11 @@ Tip:
 
 Download behavior:
 
-- accepts normal GitHub file URLs (`github.com/.../blob/...`) and raw URLs
+- expects RAW GitHub URLs (`raw.githubusercontent.com/...`) as primary input
+- also accepts `github.com/.../blob/...` and normalizes automatically
 - skips download when `output_path` already exists and matches the remote `source_hash` in `vault/index.json`
-- set `force_download=True` to download even when the local output appears aligned
+- set `force=True` to download even when the local output appears aligned
+- set `use_urllib=True` to use the urllib alternative transport path
 - downloads the encrypted `.asc` file to a temporary location
 - restores files or directories automatically with `utilitz.crypto`
 - removes the temporary encrypted file after restore