desksync 0.1.0__tar.gz

desksync-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,36 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build package
+        run: |
+          pip install build
+          python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

desksync-0.1.0/.gitignore

@@ -0,0 +1,35 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+dist/
+build/
+*.whl
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Distribution
+*.tar.gz
+*.zip

desksync-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 aratech-jp
+
+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.

desksync-0.1.0/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: desksync
+Version: 0.1.0
+Summary: Multi-platform project directory sync tool — sync your projects across Win/Mac/Linux
+Project-URL: Homepage, https://github.com/tsubome/desksync
+Project-URL: Issues, https://github.com/tsubome/desksync
+Project-URL: Repository, https://github.com/tsubome/desksync
+Author: tsubome
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Requires-Python: >=3.9
+Requires-Dist: click>=8.0
+Requires-Dist: httpx>=0.24.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# desksync
+
+![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue)
+![License: MIT](https://img.shields.io/badge/license-MIT-green)
+
+Sync your `~/projects` directory across Windows, macOS, and Linux. Sit at the same desk regardless of which PC you're on.
+
+desksync uses Syncthing (P2P) for non-git files and GitHub for git repositories — so your work is always where you are.
+
+## How It Works
+
+```
+~/projects/
+  ├── my-app/          # git repo  -> managed via GitHub (clone/push/pull)
+  ├── another-repo/    # git repo  -> managed via GitHub
+  └── notes/           # plain dir -> synced via Syncthing (P2P)
+
+.stignore auto-generated to exclude git repo contents from Syncthing.
+Git repos tracked in a registry; auto-cloned on new machines after desksync init.
+Syncthing is downloaded and managed automatically (isolated instance, custom ports).
+```
+
+## Quick Start
+
+```bash
+pip install desksync
+
+# On your first machine
+desksync init
+
+# On a new machine
+desksync init
+desksync post-switch
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `desksync init` | Initialize desksync, download Syncthing, configure everything |
+| `desksync status` | Show sync status of projects, git repos, and Syncthing |
+| `desksync sync` | Trigger a sync cycle (push git repos, sync files) |
+| `desksync scan` | Scan `~/projects` and update the git repo registry |
+| `desksync pre-switch` | Prepare before switching to another machine (push all) |
+| `desksync post-switch` | Set up after arriving on a new machine (clone all) |
+| `desksync daemon` | Start the background sync daemon |
+| `desksync devices` | List and manage paired Syncthing devices |
+| `desksync upgrade` | Upgrade Syncthing to the latest version |
+
+## Requirements
+
+- Python 3.9+
+- Git
+- GitHub account (for git repository sync)
+
+Syncthing is downloaded and managed automatically — no manual installation required.
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.
+
+**Author:** tsubome — [https://github.com/tsubome/desksync](https://github.com/tsubome/desksync)

desksync-0.1.0/README.md

@@ -0,0 +1,62 @@
+# desksync
+
+![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue)
+![License: MIT](https://img.shields.io/badge/license-MIT-green)
+
+Sync your `~/projects` directory across Windows, macOS, and Linux. Sit at the same desk regardless of which PC you're on.
+
+desksync uses Syncthing (P2P) for non-git files and GitHub for git repositories — so your work is always where you are.
+
+## How It Works
+
+```
+~/projects/
+  ├── my-app/          # git repo  -> managed via GitHub (clone/push/pull)
+  ├── another-repo/    # git repo  -> managed via GitHub
+  └── notes/           # plain dir -> synced via Syncthing (P2P)
+
+.stignore auto-generated to exclude git repo contents from Syncthing.
+Git repos tracked in a registry; auto-cloned on new machines after desksync init.
+Syncthing is downloaded and managed automatically (isolated instance, custom ports).
+```
+
+## Quick Start
+
+```bash
+pip install desksync
+
+# On your first machine
+desksync init
+
+# On a new machine
+desksync init
+desksync post-switch
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `desksync init` | Initialize desksync, download Syncthing, configure everything |
+| `desksync status` | Show sync status of projects, git repos, and Syncthing |
+| `desksync sync` | Trigger a sync cycle (push git repos, sync files) |
+| `desksync scan` | Scan `~/projects` and update the git repo registry |
+| `desksync pre-switch` | Prepare before switching to another machine (push all) |
+| `desksync post-switch` | Set up after arriving on a new machine (clone all) |
+| `desksync daemon` | Start the background sync daemon |
+| `desksync devices` | List and manage paired Syncthing devices |
+| `desksync upgrade` | Upgrade Syncthing to the latest version |
+
+## Requirements
+
+- Python 3.9+
+- Git
+- GitHub account (for git repository sync)
+
+Syncthing is downloaded and managed automatically — no manual installation required.
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.
+
+**Author:** tsubome — [https://github.com/tsubome/desksync](https://github.com/tsubome/desksync)

desksync-0.1.0/pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "desksync"
+version = "0.1.0"
+description = "Multi-platform project directory sync tool — sync your projects across Win/Mac/Linux"
+requires-python = ">=3.9"
+license = "MIT"
+readme = "README.md"
+authors = [
+    { name = "tsubome" },
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Environment :: Console",
+    "Topic :: Software Development",
+]
+dependencies = [
+    "click>=8.0",
+    "httpx>=0.24.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/tsubome/desksync"
+Issues = "https://github.com/tsubome/desksync"
+Repository = "https://github.com/tsubome/desksync"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21.0",
+]
+
+[project.scripts]
+desksync = "desksync.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/desksync"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py39"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

desksync-0.1.0/src/desksync/__init__.py

@@ -0,0 +1,67 @@
+from __future__ import annotations
+
+__version__ = "0.1.0"
+
+__all__ = ["DeskSync", "PreSwitchResult", "PostSwitchResult", "SyncStatus", "__version__"]
+
+from dataclasses import dataclass, field
+
+
+@dataclass
+class PreSwitchResult:
+    success: bool = False
+    git_pushed: list[str] = field(default_factory=list)
+    git_warnings: list[str] = field(default_factory=list)
+    syncthing_synced: bool = False
+    cloud_synced: bool = False
+    errors: list[str] = field(default_factory=list)
+
+
+@dataclass
+class PostSwitchResult:
+    success: bool = False
+    git_pulled: list[str] = field(default_factory=list)
+    git_conflicts: list[str] = field(default_factory=list)
+    syncthing_status: str = "unknown"
+    errors: list[str] = field(default_factory=list)
+
+
+@dataclass
+class SyncStatus:
+    # スケルトンのみ
+    pass
+
+
+class DeskSync:
+    def __init__(self, projects_dir: str | None = None) -> None:
+        """Initialize DeskSync.
+
+        Args:
+            projects_dir: Path to the projects directory.
+                If None, reads from ~/.desksync/config.json.
+        """
+        raise NotImplementedError
+
+    def pre_switch(self) -> PreSwitchResult:
+        """Perform pre-switch synchronization (push git repos, sync files).
+
+        Returns:
+            PreSwitchResult with details of what was synchronized.
+        """
+        raise NotImplementedError
+
+    def post_switch(self) -> PostSwitchResult:
+        """Perform post-switch synchronization (pull git repos, check sync status).
+
+        Returns:
+            PostSwitchResult with details of what was synchronized.
+        """
+        raise NotImplementedError
+
+    def status(self) -> SyncStatus:
+        """Get current synchronization status.
+
+        Returns:
+            SyncStatus with current sync state.
+        """
+        raise NotImplementedError

desksync-0.1.0/src/desksync/__main__.py

@@ -0,0 +1,4 @@
+from desksync.cli import main
+
+if __name__ == "__main__":
+    main()