mapillary-downloader 0.1.0__tar.gz → 0.1.1__tar.gz

mapillary_downloader-0.1.1/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: mapillary_downloader
+Version: 0.1.1
+Summary: Download your Mapillary data before it's gone
+Author-email: Gareth Davidson <gaz@bitplane.net>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Classifier: License :: Public Domain
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+License-File: LICENSE.md
+Requires-Dist: requests>=2.31.0
+Requires-Dist: piexif>=1.1.3
+Requires-Dist: pre-commit ; extra == "dev"
+Requires-Dist: pytest ; extra == "dev"
+Requires-Dist: coverage ; extra == "dev"
+Requires-Dist: pytest-cov ; extra == "dev"
+Requires-Dist: build ; extra == "dev"
+Requires-Dist: twine ; extra == "dev"
+Requires-Dist: ruff ; extra == "dev"
+Requires-Dist: pydoc-markdown ; extra == "dev"
+Requires-Dist: Pillow ; extra == "dev"
+Project-URL: Documentation, https://bitplane.net/dev/python/mapillary_downloader/pydoc
+Project-URL: Homepage, https://bitplane.net/dev/python/mapillary_downloader
+Project-URL: Issues, https://github.com/bitplane/mapillary_downloader/issues
+Project-URL: Repository, https://github.com/bitplane/mapillary_downloader
+Provides-Extra: dev
+
+# Mapillary Downloader
+
+Download your Mapillary data before it's gone.
+
+## Installation
+
+```bash
+pip install mapillary-downloader
+```
+
+Or from source:
+
+```bash
+make install
+```
+
+## Usage
+
+First, get your Mapillary API access token from https://www.mapillary.com/dashboard/developers
+
+```bash
+mapillary-download --token YOUR_TOKEN --username YOUR_USERNAME --output ./downloads
+```
+
+Options:
+- `--token`: Your Mapillary API access token (required)
+- `--username`: Your Mapillary username (required)
+- `--output`: Output directory (default: ./mapillary_data)
+- `--quality`: Image quality - 256, 1024, 2048, or original (default: original)
+- `--bbox`: Bounding box filter: west,south,east,north
+
+The downloader will:
+- Fetch all your uploaded images from Mapillary
+- Download full-resolution images organized by sequence
+- Inject EXIF metadata (GPS coordinates, camera info, timestamps, compass direction)
+- Save progress so you can safely resume if interrupted
+
+## Features
+
+- **Resume capability**: Interrupt and restart anytime - it tracks what's downloaded
+- **EXIF restoration**: Restores GPS, camera, and timestamp metadata that Mapillary stripped
+- **Atomic writes**: Progress tracking uses atomic file operations to prevent corruption
+- **Organized output**: Images organized by sequence ID with metadata in JSONL format
+
+## Development
+
+```bash
+make dev      # Setup dev environment
+make test     # Run tests
+make coverage # Run tests with coverage
+```
+
+## Links
+
+* [🏠 home](https://bitplane.net/dev/python/mapillary_downloader)
+* [📖 pydoc](https://bitplane.net/dev/python/mapillary_downloader/pydoc)
+* [🐍 pypi](https://pypi.org/project/mapillary-downloader)
+* [🐱 github](https://github.com/bitplane/mapillary_downloader)
+
+## License
+
+WTFPL with one additional clause
+
+1. Don't blame me
+
+Do wtf you want, but don't blame me when it breaks.
+

mapillary_downloader-0.1.1/README.md

@@ -0,0 +1,66 @@
+# Mapillary Downloader
+
+Download your Mapillary data before it's gone.
+
+## Installation
+
+```bash
+pip install mapillary-downloader
+```
+
+Or from source:
+
+```bash
+make install
+```
+
+## Usage
+
+First, get your Mapillary API access token from https://www.mapillary.com/dashboard/developers
+
+```bash
+mapillary-download --token YOUR_TOKEN --username YOUR_USERNAME --output ./downloads
+```
+
+Options:
+- `--token`: Your Mapillary API access token (required)
+- `--username`: Your Mapillary username (required)
+- `--output`: Output directory (default: ./mapillary_data)
+- `--quality`: Image quality - 256, 1024, 2048, or original (default: original)
+- `--bbox`: Bounding box filter: west,south,east,north
+
+The downloader will:
+- Fetch all your uploaded images from Mapillary
+- Download full-resolution images organized by sequence
+- Inject EXIF metadata (GPS coordinates, camera info, timestamps, compass direction)
+- Save progress so you can safely resume if interrupted
+
+## Features
+
+- **Resume capability**: Interrupt and restart anytime - it tracks what's downloaded
+- **EXIF restoration**: Restores GPS, camera, and timestamp metadata that Mapillary stripped
+- **Atomic writes**: Progress tracking uses atomic file operations to prevent corruption
+- **Organized output**: Images organized by sequence ID with metadata in JSONL format
+
+## Development
+
+```bash
+make dev      # Setup dev environment
+make test     # Run tests
+make coverage # Run tests with coverage
+```
+
+## Links
+
+* [🏠 home](https://bitplane.net/dev/python/mapillary_downloader)
+* [📖 pydoc](https://bitplane.net/dev/python/mapillary_downloader/pydoc)
+* [🐍 pypi](https://pypi.org/project/mapillary-downloader)
+* [🐱 github](https://github.com/bitplane/mapillary_downloader)
+
+## License
+
+WTFPL with one additional clause
+
+1. Don't blame me
+
+Do wtf you want, but don't blame me when it breaks.

{mapillary_downloader-0.1.0 → mapillary_downloader-0.1.1}/pyproject.toml

@@ -1,18 +1,35 @@
 [project]
 name = "mapillary_downloader"
 description = "Download your Mapillary data before it's gone"
-version = "0.1.0"
+version = "0.1.1"
 authors = [
     { name = "Gareth Davidson", email = "gaz@bitplane.net" }
 ]
 readme = "README.md"
 requires-python = ">=3.10"
+license = { text = "Public Domain" }
+classifiers = [
+    "License :: Public Domain",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
 
 dependencies = [
     "requests>=2.31.0",
     "piexif>=1.1.3",
 ]
 
+[project.urls]
+Homepage = "https://bitplane.net/dev/python/mapillary_downloader"
+Documentation = "https://bitplane.net/dev/python/mapillary_downloader/pydoc"
+Repository = "https://github.com/bitplane/mapillary_downloader"
+Issues = "https://github.com/bitplane/mapillary_downloader/issues"
+
+[project.scripts]
+mapillary-download = "mapillary_downloader.__main__:main"
+
 [project.optional-dependencies]
 dev = [
     "pre-commit",
@@ -22,8 +39,6 @@ dev = [
     "build",
     "twine",
     "ruff",
-    "mkdocs",
-    "mkdocs-material",
     "pydoc-markdown",
     "Pillow",
 ]

{mapillary_downloader-0.1.0 → mapillary_downloader-0.1.1}/src/mapillary_downloader/client.py

@@ -2,6 +2,7 @@
 
 import time
 import requests
+from requests.exceptions import RequestException
 
 
 class MapillaryClient:
@@ -66,8 +67,22 @@ class MapillaryClient:
         url = f"{self.base_url}/images"
 
         while url:
-            response = self.session.get(url, params=params)
-            response.raise_for_status()
+            max_retries = 10
+            base_delay = 1.0
+
+            for attempt in range(max_retries):
+                try:
+                    response = self.session.get(url, params=params)
+                    response.raise_for_status()
+                    break
+                except RequestException as e:
+                    if attempt == max_retries - 1:
+                        raise
+
+                    delay = base_delay * (2 ** attempt)
+                    print(f"Request failed (attempt {attempt + 1}/{max_retries}): {e}")
+                    print(f"Retrying in {delay:.1f} seconds...")
+                    time.sleep(delay)
 
             data = response.json()
 
@@ -91,17 +106,27 @@ class MapillaryClient:
         Returns:
             Number of bytes downloaded if successful, 0 otherwise
         """
-        try:
-            response = self.session.get(image_url, stream=True)
-            response.raise_for_status()
-
-            total_bytes = 0
-            with open(output_path, "wb") as f:
-                for chunk in response.iter_content(chunk_size=8192):
-                    f.write(chunk)
-                    total_bytes += len(chunk)
-
-            return total_bytes
-        except Exception as e:
-            print(f"Error downloading {image_url}: {e}")
-            return 0
+        max_retries = 10
+        base_delay = 1.0
+
+        for attempt in range(max_retries):
+            try:
+                response = self.session.get(image_url, stream=True)
+                response.raise_for_status()
+
+                total_bytes = 0
+                with open(output_path, "wb") as f:
+                    for chunk in response.iter_content(chunk_size=8192):
+                        f.write(chunk)
+                        total_bytes += len(chunk)
+
+                return total_bytes
+            except RequestException as e:
+                if attempt == max_retries - 1:
+                    print(f"Error downloading {image_url} after {max_retries} attempts: {e}")
+                    return 0
+
+                delay = base_delay * (2 ** attempt)
+                print(f"Download failed (attempt {attempt + 1}/{max_retries}): {e}")
+                print(f"Retrying in {delay:.1f} seconds...")
+                time.sleep(delay)

mapillary_downloader-0.1.0/PKG-INFO

@@ -1,54 +0,0 @@
-Metadata-Version: 2.4
-Name: mapillary_downloader
-Version: 0.1.0
-Summary: Download your Mapillary data before it's gone
-Author-email: Gareth Davidson <gaz@bitplane.net>
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE.md
-Requires-Dist: requests>=2.31.0
-Requires-Dist: piexif>=1.1.3
-Requires-Dist: pre-commit ; extra == "dev"
-Requires-Dist: pytest ; extra == "dev"
-Requires-Dist: coverage ; extra == "dev"
-Requires-Dist: pytest-cov ; extra == "dev"
-Requires-Dist: build ; extra == "dev"
-Requires-Dist: twine ; extra == "dev"
-Requires-Dist: ruff ; extra == "dev"
-Requires-Dist: mkdocs ; extra == "dev"
-Requires-Dist: mkdocs-material ; extra == "dev"
-Requires-Dist: pydoc-markdown ; extra == "dev"
-Requires-Dist: Pillow ; extra == "dev"
-Provides-Extra: dev
-
-# Mapillary Downloader
-
-Download your Mapillary data before it's gone.
-
-## Installation
-
-```bash
-make install
-```
-
-## Usage
-
-First, get your Mapillary API access token from https://www.mapillary.com/dashboard/developers
-
-```bash
-source .venv/bin/activate
-python -m mapillary_downloader --token YOUR_TOKEN --username YOUR_USERNAME --output ./downloads
-```
-
-## Development
-
-```bash
-make dev      # Setup dev environment
-make test     # Run tests
-make coverage # Run tests with coverage
-```
-
-## License
-
-WTFPL + Warranty (Don't blame me)
-

mapillary_downloader-0.1.0/README.md

@@ -1,30 +0,0 @@
-# Mapillary Downloader
-
-Download your Mapillary data before it's gone.
-
-## Installation
-
-```bash
-make install
-```
-
-## Usage
-
-First, get your Mapillary API access token from https://www.mapillary.com/dashboard/developers
-
-```bash
-source .venv/bin/activate
-python -m mapillary_downloader --token YOUR_TOKEN --username YOUR_USERNAME --output ./downloads
-```
-
-## Development
-
-```bash
-make dev      # Setup dev environment
-make test     # Run tests
-make coverage # Run tests with coverage
-```
-
-## License
-
-WTFPL + Warranty (Don't blame me)