claudesync 0.2.7__tar.gz → 0.2.9__tar.gz

{claudesync-0.2.7 → claudesync-0.2.9}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 jahwag
+Copyright (c) 2024 Jahziah Wagner
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

claudesync-0.2.9/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.1
+Name: claudesync
+Version: 0.2.9
+Summary: A tool to synchronize local files with Claude.ai projects
+Author-email: Jahziah Wagner <jahziah.wagner+pypi@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2024 Jahziah Wagner
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/jahwag/claudesync
+Project-URL: Bug Tracker, https://github.com/jahwag/claudesync/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Click
+Requires-Dist: requests
+Requires-Dist: pathspec
+Requires-Dist: crontab
+Requires-Dist: setuptools
+Requires-Dist: pytest
+Requires-Dist: pytest-cov
+Requires-Dist: click_completion
+
+```
+  .oooooo.   oooo                              .o8                .oooooo..o                                   
+ d8P'  `Y8b  `888                             "888               d8P'    `Y8                                   
+888           888   .oooo.   oooo  oooo   .oooo888   .ooooo.     Y88bo.      oooo    ooo ooo. .oo.    .ooooo.  
+888           888  `P  )88b  `888  `888  d88' `888  d88' `88b     `"Y8888o.   `88.  .8'  `888P"Y88b  d88' `"Y8 
+888           888   .oP"888   888   888  888   888  888ooo888         `"Y88b   `88..8'    888   888  888       
+`88b    ooo   888  d8(  888   888   888  888   888  888    .o    oo     .d8P    `888'     888   888  888   .o8 
+ `Y8bood8P'  o888o `Y888""8o  `V88V"V8P' `Y8bod88P" `Y8bod8P'    8""88888P'      .8'     o888o o888o `Y8bod8P' 
+                                                                             .o..P'                            
+                                                                             `Y8P'                              
+```
+![License](https://img.shields.io/badge/License-MIT-blue.svg)
+[![PyPI version](https://badge.fury.io/py/claudesync.svg)](https://badge.fury.io/py/claudesync)
+
+ClaudeSync is a powerful tool designed to seamlessly synchronize your local files with [Claude.ai](https://www.anthropic.com/claude) projects.
+
+## Overview and Scope
+
+ClaudeSync bridges the gap between your local development environment and Claude.ai's knowledge base. At a high level, the scope of ClaudeSync includes:
+
+- Real-time synchronization with Claude.ai projects
+- Command-line interface (CLI) for easy management
+- Multiple organization and project support
+- Automatic handling of file creation, modification, and deletion
+- Intelligent file filtering based on .gitignore rules
+- Configurable sync interval with cron job support
+- Seamless integration with your existing workflow
+
+## Roadmap
+
+1. Enhanced support for large file synchronization
+2. Improved conflict resolution mechanisms
+3. GUI client for easier management
+4. Integration with popular IDEs and text editors
+5. Support for additional AI platforms beyond Claude.ai
+
+## Quick Start
+
+1. **Install ClaudeSync:**
+   ```bash
+   pip install claudesync
+   ```
+
+2. **Login to Claude.ai:**
+   ```bash
+   claudesync login claude.ai
+   ```
+
+3. **Select an organization:**
+   ```bash
+   claudesync organization select
+   ```
+
+4. **Select or create a project:**
+   ```bash
+   claudesync project select
+   # or
+   claudesync project create
+   ```
+
+5. **Start syncing:**
+   ```bash
+   claudesync sync
+   ```
+
+## Advanced Usage
+
+### Organization Management
+- List organizations: `claudesync organization ls`
+- Select active organization: `claudesync organization select`
+
+### Project Management
+- List projects: `claudesync project ls`
+- Create a new project: `claudesync project create`
+- Archive a project: `claudesync project archive`
+- Select active project: `claudesync project select`
+
+### File Management
+- List remote files: `claudesync ls`
+- Sync files: `claudesync sync`
+
+### Configuration
+- View current status: `claudesync status`
+
+### Scheduled Sync
+Set up automatic syncing at regular intervals:
+```bash
+claudesync schedule
+```
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for more information.
+
+## Communication Channels
+
+- **Issues**: For bug reports and feature requests, please use our [GitHub Issues](https://github.com/jahwag/claudesync/issues).
+
+## License
+
+ClaudeSync is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+## Related Projects
+
+- [Claude.ai](https://www.anthropic.com/claude): The AI assistant that ClaudeSync integrates with.
+
+---
+
+Made with ❤️ by the ClaudeSync team

claudesync-0.2.9/README.md

@@ -0,0 +1,109 @@
+```
+  .oooooo.   oooo                              .o8                .oooooo..o                                   
+ d8P'  `Y8b  `888                             "888               d8P'    `Y8                                   
+888           888   .oooo.   oooo  oooo   .oooo888   .ooooo.     Y88bo.      oooo    ooo ooo. .oo.    .ooooo.  
+888           888  `P  )88b  `888  `888  d88' `888  d88' `88b     `"Y8888o.   `88.  .8'  `888P"Y88b  d88' `"Y8 
+888           888   .oP"888   888   888  888   888  888ooo888         `"Y88b   `88..8'    888   888  888       
+`88b    ooo   888  d8(  888   888   888  888   888  888    .o    oo     .d8P    `888'     888   888  888   .o8 
+ `Y8bood8P'  o888o `Y888""8o  `V88V"V8P' `Y8bod88P" `Y8bod8P'    8""88888P'      .8'     o888o o888o `Y8bod8P' 
+                                                                             .o..P'                            
+                                                                             `Y8P'                              
+```
+![License](https://img.shields.io/badge/License-MIT-blue.svg)
+[![PyPI version](https://badge.fury.io/py/claudesync.svg)](https://badge.fury.io/py/claudesync)
+
+ClaudeSync is a powerful tool designed to seamlessly synchronize your local files with [Claude.ai](https://www.anthropic.com/claude) projects.
+
+## Overview and Scope
+
+ClaudeSync bridges the gap between your local development environment and Claude.ai's knowledge base. At a high level, the scope of ClaudeSync includes:
+
+- Real-time synchronization with Claude.ai projects
+- Command-line interface (CLI) for easy management
+- Multiple organization and project support
+- Automatic handling of file creation, modification, and deletion
+- Intelligent file filtering based on .gitignore rules
+- Configurable sync interval with cron job support
+- Seamless integration with your existing workflow
+
+## Roadmap
+
+1. Enhanced support for large file synchronization
+2. Improved conflict resolution mechanisms
+3. GUI client for easier management
+4. Integration with popular IDEs and text editors
+5. Support for additional AI platforms beyond Claude.ai
+
+## Quick Start
+
+1. **Install ClaudeSync:**
+   ```bash
+   pip install claudesync
+   ```
+
+2. **Login to Claude.ai:**
+   ```bash
+   claudesync login claude.ai
+   ```
+
+3. **Select an organization:**
+   ```bash
+   claudesync organization select
+   ```
+
+4. **Select or create a project:**
+   ```bash
+   claudesync project select
+   # or
+   claudesync project create
+   ```
+
+5. **Start syncing:**
+   ```bash
+   claudesync sync
+   ```
+
+## Advanced Usage
+
+### Organization Management
+- List organizations: `claudesync organization ls`
+- Select active organization: `claudesync organization select`
+
+### Project Management
+- List projects: `claudesync project ls`
+- Create a new project: `claudesync project create`
+- Archive a project: `claudesync project archive`
+- Select active project: `claudesync project select`
+
+### File Management
+- List remote files: `claudesync ls`
+- Sync files: `claudesync sync`
+
+### Configuration
+- View current status: `claudesync status`
+
+### Scheduled Sync
+Set up automatic syncing at regular intervals:
+```bash
+claudesync schedule
+```
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for more information.
+
+## Communication Channels
+
+- **Issues**: For bug reports and feature requests, please use our [GitHub Issues](https://github.com/jahwag/claudesync/issues).
+
+## License
+
+ClaudeSync is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+## Related Projects
+
+- [Claude.ai](https://www.anthropic.com/claude): The AI assistant that ClaudeSync integrates with.
+
+---
+
+Made with ❤️ by the ClaudeSync team

{claudesync-0.2.7 → claudesync-0.2.9}/pyproject.toml

@@ -4,22 +4,28 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claudesync"
-version = "0.2.7"
+version = "0.2.9"
 authors = [
     {name = "Jahziah Wagner", email = "jahziah.wagner+pypi@gmail.com"},
 ]
 description = "A tool to synchronize local files with Claude.ai projects"
+license = {file = "LICENSE"}
 readme = "README.md"
-requires-python = ">=3.6"
+requires-python = ">=3.7"
 classifiers = [
     "Programming Language :: Python :: 3",
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
 ]
 dependencies = [
-    "watchdog",
+    "Click",
     "requests",
     "pathspec",
+    "crontab",
+    "setuptools",
+    "pytest",
+    "pytest-cov",
+    "click_completion",
 ]
 
 [project.urls]
@@ -27,7 +33,14 @@ dependencies = [
 "Bug Tracker" = "https://github.com/jahwag/claudesync/issues"
 
 [project.scripts]
-claudesync = "claudesync.main:main"
+claudesync = "claudesync.cli.main:cli"
 
 [tool.setuptools.packages.find]
 where = ["src"]
+include = ["claudesync*"]
+
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = "test_*.py"
+addopts = "-v --cov=claudesync --cov-report=term-missing"

{claudesync-0.2.7 → claudesync-0.2.9}/setup.py

@@ -3,4 +3,4 @@ from setuptools import setup, find_packages
 setup(
     packages=find_packages(where="src"),
     package_dir={"": "src"},
-)
+)

claudesync-0.2.9/src/claudesync/cli/__init__.py

@@ -0,0 +1,3 @@
+from .main import cli
+
+__all__ = ["cli"]

claudesync-0.2.9/src/claudesync/cli/auth.py

@@ -0,0 +1,34 @@
+import click
+from claudesync.provider_factory import get_provider
+from ..utils import handle_errors
+
+
+@click.command()
+@click.argument("provider", required=False)
+@click.pass_obj
+@handle_errors
+def login(config, provider):
+    """Authenticate with an AI provider."""
+    providers = get_provider()
+    if not provider:
+        click.echo("Available providers:\n" + "\n".join(f"  - {p}" for p in providers))
+        return
+    if provider not in providers:
+        click.echo(
+            f"Error: Unknown provider '{provider}'. Available: {', '.join(providers)}"
+        )
+        return
+    provider_instance = get_provider(provider)
+    session_key = provider_instance.login()
+    config.set("session_key", session_key)
+    config.set("active_provider", provider)
+    click.echo("Logged in successfully.")
+
+
+@click.command()
+@click.pass_obj
+def logout(config):
+    """Log out from the current AI provider."""
+    for key in ["session_key", "active_provider", "active_organization_id"]:
+        config.set(key, None)
+    click.echo("Logged out successfully.")

claudesync-0.2.9/src/claudesync/cli/main.py

@@ -0,0 +1,60 @@
+import click
+from claudesync.config_manager import ConfigManager
+import click_completion
+import click_completion.core
+
+# Import commands from other CLI files
+from .auth import login, logout
+from .organization import organization
+from .project import project
+from .sync import ls, sync, schedule
+
+click_completion.init()
+
+
+@click.group()
+@click.pass_context
+def cli(ctx):
+    """ClaudeSync: Synchronize local files with ai projects."""
+    ctx.obj = ConfigManager()
+
+
+@cli.command()
+@click.argument(
+    "shell", required=False, type=click.Choice(["bash", "zsh", "fish", "powershell"])
+)
+def install_completion(shell):
+    """Install completion for the specified shell."""
+    if shell is None:
+        shell = click_completion.get_auto_shell()
+        click.echo("Shell is set to '%s'" % shell)
+    click_completion.install(shell=shell)
+    click.echo("Completion installed.")
+
+
+@cli.command()
+@click.pass_obj
+def status(config):
+    """Display current configuration status."""
+    for key in [
+        "active_provider",
+        "active_organization_id",
+        "active_project_id",
+        "active_project_name",
+        "local_path",
+        "log_level",
+    ]:
+        value = config.get(key)
+        click.echo(f"{key.replace('_', ' ').capitalize()}: {value or 'Not set'}")
+
+
+cli.add_command(login)
+cli.add_command(logout)
+cli.add_command(organization)
+cli.add_command(project)
+cli.add_command(ls)
+cli.add_command(sync)
+cli.add_command(schedule)
+
+if __name__ == "__main__":
+    cli()

claudesync-0.2.9/src/claudesync/cli/organization.py

@@ -0,0 +1,47 @@
+import click
+from ..utils import handle_errors, validate_and_get_provider
+
+
+@click.group()
+def organization():
+    """Manage ai organizations."""
+    pass
+
+
+@organization.command()
+@click.pass_obj
+@handle_errors
+def ls(config):
+    """List all available organizations."""
+    provider = validate_and_get_provider(config, require_org=False)
+    organizations = provider.get_organizations()
+    if not organizations:
+        click.echo("No organizations found.")
+    else:
+        click.echo("Available organizations:")
+        for idx, org in enumerate(organizations, 1):
+            click.echo(f"  {idx}. {org['name']} (ID: {org['id']})")
+
+
+@organization.command()
+@click.pass_obj
+@handle_errors
+def select(config):
+    """Set the active organization."""
+    provider = validate_and_get_provider(config, require_org=False)
+    organizations = provider.get_organizations()
+    if not organizations:
+        click.echo("No organizations found.")
+        return
+    click.echo("Available organizations:")
+    for idx, org in enumerate(organizations, 1):
+        click.echo(f"  {idx}. {org['name']} (ID: {org['id']})")
+    selection = click.prompt("Enter the number of the organization to select", type=int)
+    if 1 <= selection <= len(organizations):
+        selected_org = organizations[selection - 1]
+        config.set("active_organization_id", selected_org["id"])
+        click.echo(
+            f"Selected organization: {selected_org['name']} (ID: {selected_org['id']})"
+        )
+    else:
+        click.echo("Invalid selection. Please try again.")

claudesync-0.2.9/src/claudesync/cli/project.py

@@ -0,0 +1,122 @@
+import click
+from claudesync.exceptions import ProviderError
+from ..utils import (
+    handle_errors,
+    validate_and_get_provider,
+    validate_and_store_local_path,
+)
+
+
+@click.group()
+def project():
+    """Manage ai projects within the active organization."""
+    pass
+
+
+@project.command()
+@click.pass_obj
+@handle_errors
+def create(config):
+    """Create a new project in the active organization."""
+    provider = validate_and_get_provider(config)
+    active_organization_id = config.get("active_organization_id")
+
+    title = click.prompt("Enter the project title")
+    description = click.prompt("Enter the project description (optional)", default="")
+
+    try:
+        new_project = provider.create_project(
+            active_organization_id, title, description
+        )
+        click.echo(
+            f"Project '{new_project['name']}' (uuid: {new_project['uuid']}) has been created successfully."
+        )
+
+        config.set("active_project_id", new_project["uuid"])
+        config.set("active_project_name", new_project["name"])
+        click.echo(
+            f"Active project set to: {new_project['name']} (uuid: {new_project['uuid']})"
+        )
+
+        validate_and_store_local_path(config)
+
+    except ProviderError as e:
+        click.echo(f"Failed to create project: {str(e)}")
+
+
+@project.command()
+@click.pass_obj
+@handle_errors
+def archive(config):
+    """Archive an existing project."""
+    provider = validate_and_get_provider(config)
+    active_organization_id = config.get("active_organization_id")
+    projects = provider.get_projects(active_organization_id, include_archived=False)
+    if not projects:
+        click.echo("No active projects found.")
+        return
+    click.echo("Available projects to archive:")
+    for idx, project in enumerate(projects, 1):
+        click.echo(f"  {idx}. {project['name']} (ID: {project['id']})")
+    selection = click.prompt("Enter the number of the project to archive", type=int)
+    if 1 <= selection <= len(projects):
+        selected_project = projects[selection - 1]
+        if click.confirm(
+            f"Are you sure you want to archive '{selected_project['name']}'?"
+        ):
+            provider.archive_project(active_organization_id, selected_project["id"])
+            click.echo(f"Project '{selected_project['name']}' has been archived.")
+    else:
+        click.echo("Invalid selection. Please try again.")
+
+
+@project.command()
+@click.pass_obj
+@handle_errors
+def select(config):
+    """Set the active project for syncing."""
+    provider = validate_and_get_provider(config)
+    active_organization_id = config.get("active_organization_id")
+    projects = provider.get_projects(active_organization_id, include_archived=False)
+    if not projects:
+        click.echo("No active projects found.")
+        return
+    click.echo("Available projects:")
+    for idx, project in enumerate(projects, 1):
+        click.echo(f"  {idx}. {project['name']} (ID: {project['id']})")
+    selection = click.prompt("Enter the number of the project to select", type=int)
+    if 1 <= selection <= len(projects):
+        selected_project = projects[selection - 1]
+        config.set("active_project_id", selected_project["id"])
+        config.set("active_project_name", selected_project["name"])
+        click.echo(
+            f"Selected project: {selected_project['name']} (ID: {selected_project['id']})"
+        )
+
+        validate_and_store_local_path(config)
+    else:
+        click.echo("Invalid selection. Please try again.")
+
+
+@project.command()
+@click.option(
+    "-a",
+    "--all",
+    "show_all",
+    is_flag=True,
+    help="Include archived projects in the list",
+)
+@click.pass_obj
+@handle_errors
+def ls(config, show_all):
+    """List all projects in the active organization."""
+    provider = validate_and_get_provider(config)
+    active_organization_id = config.get("active_organization_id")
+    projects = provider.get_projects(active_organization_id, include_archived=show_all)
+    if not projects:
+        click.echo("No projects found.")
+    else:
+        click.echo("Remote projects:")
+        for project in projects:
+            status = " (Archived)" if project.get("archived_at") else ""
+            click.echo(f"  - {project['name']} (ID: {project['id']}){status}")