rclone-api 1.0.0__tar.gz → 1.0.2__tar.gz

rclone_api-1.0.2/.gitignore

@@ -0,0 +1,141 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+*.pyc
+
+# Generated commands
+/zcmds/bin/
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+prod_env/
+data/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+.activate.sh
+activate
+
+# Generated by mac
+**/.DS_Store
+uv.lock

rclone_api-1.0.2/.pylintrc

@@ -0,0 +1,2 @@
+[MESSAGES CONTROL]
+disable=missing-module-docstring,missing-class-docstring,missing-function-docstring,line-too-long,raise-missing-from,too-few-public-methods,too-many-return-statements,fixme,too-many-locals,too-many-branches,too-many-statements,too-many-arguments,too-many-instance-attributes,too-many-ancestors,too-many-lines,too-many-public-methods,too-many-boolean-expressions,too-many-locals,too-many-branches,too-many-statements,too-many-arguments,too-many-instance-attributes,too-many-ancestors,too-many-lines,too-many-public-methods,too-many-boolean-expressions,R0801

rclone_api-1.0.2/.vscode/launch.json

@@ -0,0 +1,44 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Python: Current File (Integrated Terminal)",
+            "type": "python",
+            "request": "launch",
+            "subProcess": true,
+            "program": "${file}",
+            "console": "integratedTerminal",
+            "justMyCode": false
+        },
+        {
+            "name": "Python: Remote Attach",
+            "type": "python",
+            "request": "attach",
+            "port": 5678,
+            "host": "localhost",
+            "pathMappings": [
+                {
+                    "localRoot": "${workspaceFolder}",
+                    "remoteRoot": "."
+                }
+            ]
+        },
+        {
+            "name": "Python: Module",
+            "type": "python",
+            "request": "launch",
+            "module": "enter-your-module-name-here",
+            "console": "integratedTerminal"
+        },
+        {
+            "name": "Python: Current File (External Terminal)",
+            "type": "python",
+            "request": "launch",
+            "program": "${file}",
+            "console": "externalTerminal"
+        }
+    ]
+}

rclone_api-1.0.2/.vscode/settings.json

@@ -0,0 +1,29 @@
+{
+    "python.autoComplete.extraPaths": [
+        "."
+    ],
+    "python.linting.pylintEnabled": true,
+    "python.linting.enabled": true,
+    "terminal.integrated.defaultProfile.windows": "Git Bash",
+    "terminal.integrated.profiles.windows": {
+        "Git Bash": {
+            "path": "C:\\Program Files\\Git\\bin\\bash.exe",
+            "args": ["--cd=."]
+        }
+    },
+    // adds activate virtualenv to terminal
+    "terminal.integrated.env.windows": {
+        "VIRTUAL_ENV": "${workspaceFolder}/venv"
+    },
+    "files.eol": "\n", // Unix
+    "editor.tabSize": 4,
+    "editor.insertSpaces": true,
+    "editor.detectIndentation": false,
+    "editor.formatOnSave": false,
+    "python.formatting.provider": "black",
+    "python.formatting.blackArgs": [
+    ],
+    "python.analysis.extraPaths": [
+        "."
+    ]
+}

rclone_api-1.0.2/.vscode/tasks.json

@@ -0,0 +1,41 @@
+{
+    // See https://go.microsoft.com/fwlink/?LinkId=733558
+    // for the documentation about the tasks.json format
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "Lint",
+            "type": "shell",
+            "command": ". ./activate.sh && ./lint.sh",
+            "group": "build",
+            "options": {
+                "cwd": "${workspaceRoot}"
+            },
+            "presentation": {
+                "echo": true,
+                "reveal": "always",
+                "focus": true,
+                "panel": "shared",
+                "clear": true
+            },
+            "problemMatcher": []
+        },
+        {
+            "label": "Tox",
+            "type": "shell",
+            "command": "tox",
+            "group": "build",
+            "options": {
+                "cwd": "${workspaceRoot}"
+            },
+            "presentation": {
+                "echo": true,
+                "reveal": "always",
+                "focus": true,
+                "panel": "shared",
+                "clear": true
+            },
+            "problemMatcher": []
+        },
+    ]
+}

{rclone_api-1.0.0/src/rclone_api.egg-info → rclone_api-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: rclone_api
-Version: 1.0.0
+Version: 1.0.2
 Summary: rclone api in python
 Home-page: https://github.com/zackees/rclone-api
 Maintainer: Zachary Vorhies

rclone_api-1.0.2/clean

@@ -0,0 +1,21 @@
+#!/bin/bash
+set -x
+
+rm -rf build
+rm -rf dist
+rm -rf venv
+rm -rf .venv
+
+rm -rf *.egg-info
+rm -rf .eggs
+rm -rf .tox
+rm -rf .cache
+rm -rf .pytest_cache
+rm -rf .mypy_cache
+rm -rf .coverage
+
+# remove all *.pyc files
+find . -name "*.pyc" -exec rm -rf {} \;
+# remove all *.egg files
+find . -name "*.egg" -exec rm -rf {} \;
+

rclone_api-1.0.2/install

@@ -0,0 +1,37 @@
+#!/bin/bash
+set -e
+
+# Check if UV is not found
+if ! command -v uv &> /dev/null; then
+  # If Darwin (macOS), use brew to install UV
+  if [[ "$OSTYPE" == "darwin"* ]]; then
+    brew install uv
+  else
+    # If it's Windows, use pip to install UV, else use pip3
+    if [[ "$OSTYPE" == "msys" ]]; then
+      pip install uv
+    else
+      pip3 install uv
+    fi
+  fi
+fi
+
+uv venv --python 3.11 --seed
+uv run pip install -e .
+
+# If requirements.testing.txt exists, then install it
+if [[ -f requirements.testing.txt ]]; then
+  uv run pip install -r requirements.testing.txt
+fi
+
+# If activate exists, delete it
+if [[ -f activate ]]; then
+  rm activate
+fi
+
+# If Windows, then symlink .venv/Scripts/activate to .venv/bin/activate
+if [[ "$OSTYPE" == "msys" ]]; then
+  ln -s .venv/Scripts/activate ./activate
+else
+  ln -s .venv/bin/activate ./activate
+fi

rclone_api-1.0.2/lint

@@ -0,0 +1,15 @@
+#!/bin/bash
+set -e
+
+echo Running ruff src
+uv run ruff check --fix src
+echo Running ruff tests
+uv run ruff check --fix tests
+echo Running black src tests
+uv run black src tests
+echo Running isort src tests
+uv run isort --profile black src tests
+echo Running mypy src
+uv run mypy src tests
+echo Linting complete!
+exit 0

{rclone_api-1.0.0 → rclone_api-1.0.2}/pyproject.toml

@@ -14,7 +14,7 @@ dependencies = [
 
 ]
 # Change this with the version number bump.
-version = "1.0.0"
+version = "1.0.2"
 
 [tool.setuptools]
 package-dir = {"" = "src"}

rclone_api-1.0.2/src/rclone_api/__init__.py

@@ -0,0 +1,4 @@
+from .rclone import File, Rclone
+from .types import Config, Remote
+
+__all__ = ["Rclone", "File", "Config", "Remote"]

rclone_api-1.0.2/src/rclone_api/file.py

@@ -0,0 +1,77 @@
+import json
+from typing import Any
+
+
+class File:
+    """Remote file dataclass."""
+
+    def __init__(
+        self,
+        path: str,
+        name: str,
+        size: int,
+        mime_type: str,
+        mod_time: str,
+        is_dir: bool,
+    ) -> None:
+        from rclone_api.rclone import Rclone
+
+        self.path = path
+        self.name = name
+        self.size = size
+        self.mime_type = mime_type
+        self.mod_time = mod_time
+        self.is_dir = is_dir
+        self.rclone: Rclone | None = None
+
+    def set_rclone(self, rclone: Any) -> None:
+        """Set the rclone object."""
+        from rclone_api.rclone import Rclone
+
+        assert isinstance(rclone, Rclone)
+        self.rclone = rclone
+
+    @staticmethod
+    def from_dict(data: dict) -> "File":
+        """Create a File from a dictionary."""
+        return File(
+            data["Path"],
+            data["Name"],
+            data["Size"],
+            data["MimeType"],
+            data["ModTime"],
+            data["IsDir"],
+            # data["IsBucket"],
+        )
+
+    @staticmethod
+    def from_array(data: list[dict]) -> list["File"]:
+        """Create a File from a dictionary."""
+        out: list[File] = []
+        for d in data:
+            file: File = File.from_dict(d)
+            out.append(file)
+        return out
+
+    @staticmethod
+    def from_json_str(json_str: str) -> list["File"]:
+        """Create a File from a JSON string."""
+        json_obj = json.loads(json_str)
+        if isinstance(json_obj, dict):
+            return [File.from_dict(json_obj)]
+        return File.from_array(json_obj)
+
+    def to_json(self) -> dict:
+        return {
+            "Path": self.path,
+            "Name": self.name,
+            "Size": self.size,
+            "MimeType": self.mime_type,
+            "ModTime": self.mod_time,
+            "IsDir": self.is_dir,
+            # "IsBucket": self.is_bucket,
+        }
+
+    def __str__(self) -> str:
+        out = self.to_json()
+        return json.dumps(out)

rclone_api-1.0.2/src/rclone_api/rclone.py

@@ -0,0 +1,43 @@
+"""
+Unit test file.
+"""
+
+import subprocess
+from pathlib import Path
+
+from rclone_api.file import File
+from rclone_api.types import Config, RcloneExec, Remote
+from rclone_api.util import get_rclone_exe
+
+
+class Rclone:
+    def __init__(
+        self, rclone_conf: Path | Config, rclone_exe: Path | None = None
+    ) -> None:
+        if isinstance(rclone_conf, Path):
+            if not rclone_conf.exists():
+                raise ValueError(f"Rclone config file not found: {rclone_conf}")
+        self._exec = RcloneExec(rclone_conf, get_rclone_exe(rclone_exe))
+
+    def _run(self, cmd: list[str]) -> subprocess.CompletedProcess:
+        return self._exec.execute(cmd)
+
+    def ls(self, path: str | Remote) -> list[File]:
+        cmd = ["lsjson", str(path)]
+        cp = self._run(cmd)
+        text = cp.stdout
+        out: list[File] = File.from_json_str(text)
+        for o in out:
+            o.set_rclone(self)
+        return out
+
+    def listremotes(self) -> list[Remote]:
+        cmd = ["listremotes"]
+        cp = self._run(cmd)
+        text: str = cp.stdout
+        tmp = text.splitlines()
+        tmp = [t.strip() for t in tmp]
+        # strip out ":" from the end
+        tmp = [t.replace(":", "") for t in tmp]
+        out = [Remote(name=t) for t in tmp]
+        return out

rclone_api-1.0.2/src/rclone_api/types.py

@@ -0,0 +1,34 @@
+import subprocess
+from dataclasses import dataclass
+from pathlib import Path
+
+
+@dataclass
+class Config:
+    """Rclone configuration dataclass."""
+
+    text: str
+
+
+@dataclass
+class RcloneExec:
+    """Rclone execution dataclass."""
+
+    rclone_config: Path | Config
+    rclone_exe: Path
+
+    def execute(self, cmd: list[str]) -> subprocess.CompletedProcess:
+        """Execute rclone command."""
+        from rclone_api.util import rclone_execute
+
+        return rclone_execute(cmd, self.rclone_config, self.rclone_exe)
+
+
+class Remote:
+    """Remote dataclass."""
+
+    def __init__(self, name: str) -> None:
+        self.name = name
+
+    def __str__(self) -> str:
+        return f"{self.name}:"

rclone_api-1.0.2/src/rclone_api/util.py

@@ -0,0 +1,49 @@
+import shutil
+import subprocess
+from pathlib import Path
+from tempfile import TemporaryDirectory
+
+from rclone_api.types import Config
+
+
+def get_rclone_exe(rclone_exe: Path | None) -> Path:
+    if rclone_exe is None:
+
+        rclone_which_path = shutil.which("rclone")
+        if rclone_which_path is None:
+            raise ValueError("rclone executable not found")
+        return Path(rclone_which_path)
+    return rclone_exe
+
+
+def rclone_execute(
+    cmd: list[str],
+    rclone_conf: Path | Config,
+    rclone_exe: Path,
+    verbose: bool = False,
+) -> subprocess.CompletedProcess:
+    print(subprocess.list2cmdline(cmd))
+    tempdir: TemporaryDirectory | None = None
+
+    try:
+        if isinstance(rclone_conf, Config):
+            tempdir = TemporaryDirectory()
+            tmpfile = Path(tempdir.name) / "rclone.conf"
+            tmpfile.write_text(rclone_conf.text, encoding="utf-8")
+            rclone_conf = tmpfile
+        cmd = (
+            [str(rclone_exe.resolve())] + ["--config", str(rclone_conf.resolve())] + cmd
+        )
+        if verbose:
+            cmd_str = subprocess.list2cmdline(cmd)
+            print(f"Running: {cmd_str}")
+        cp = subprocess.run(
+            cmd, capture_output=True, encoding="utf-8", check=True, shell=False
+        )
+        return cp
+    finally:
+        if tempdir:
+            try:
+                tempdir.cleanup()
+            except Exception as e:
+                print(f"Error cleaning up tempdir: {e}")

{rclone_api-1.0.0 → rclone_api-1.0.2/src/rclone_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: rclone_api
-Version: 1.0.0
+Version: 1.0.2
 Summary: rclone api in python
 Home-page: https://github.com/zackees/rclone-api
 Maintainer: Zachary Vorhies

{rclone_api-1.0.0 → rclone_api-1.0.2}/src/rclone_api.egg-info/SOURCES.txt

@@ -1,12 +1,26 @@
+.gitignore
+.pylintrc
 LICENSE
 MANIFEST.in
 README.md
+clean
+install
+lint
 pyproject.toml
 requirements.testing.txt
 setup.py
+test
+tox.ini
+upload_package.sh
+.vscode/launch.json
+.vscode/settings.json
+.vscode/tasks.json
 src/rclone_api/__init__.py
 src/rclone_api/cli.py
+src/rclone_api/file.py
 src/rclone_api/rclone.py
+src/rclone_api/types.py
+src/rclone_api/util.py
 src/rclone_api.egg-info/PKG-INFO
 src/rclone_api.egg-info/SOURCES.txt
 src/rclone_api.egg-info/dependency_links.txt

rclone_api-1.0.2/test

@@ -0,0 +1,5 @@
+#!/bin/bash
+
+set -e
+echo "Running unittests"
+uv run pytest -n auto tests -v

rclone_api-1.0.2/tox.ini

@@ -0,0 +1,24 @@
+# content of: tox.ini , put in same dir as setup.py
+[tox]
+envlist = py310
+
+[gh-actions]
+python =
+    3.10: py310
+
+[flake8]
+per-file-ignores = __init__.py:F401
+ignore = E501, E203, W503
+
+[testenv]
+# install pytest in the virtualenv where commands will be executed
+deps =
+    -r{toxinidir}/requirements.testing.txt
+commands =
+    # NOTE: you can run any command line tool here - not just tests
+    ruff src
+    ruff tests
+    flake8 src tests
+    pylint src tests
+    mypy src tests
+    pytest tests -n auto -vv

rclone_api-1.0.2/upload_package.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+set -e
+rm -rf build dist
+. ./activate
+pip install wheel twine
+echo "Building Source and Wheel (universal) distribution…"
+python setup.py sdist bdist_wheel --universal
+echo "Uploading the package to PyPI via Twine…"
+twine upload dist/* --verbose
+# echo Pushing git tags…

rclone_api-1.0.0/src/rclone_api/rclone.py

@@ -1,160 +0,0 @@
-"""
-Unit test file.
-"""
-
-import json
-import shutil
-import subprocess
-from dataclasses import dataclass
-from pathlib import Path
-from tempfile import TemporaryDirectory
-
-
-@dataclass
-class RcloneConfig:
-    """Rclone configuration dataclass."""
-
-    text: str
-
-
-def _rclone_execute(
-    cmd: list[str],
-    rclone_conf: Path | RcloneConfig,
-    rclone_exe: Path,
-    verbose: bool = False,
-) -> subprocess.CompletedProcess:
-    print(subprocess.list2cmdline(cmd))
-    tempdir: TemporaryDirectory | None = None
-
-    try:
-        if isinstance(rclone_conf, RcloneConfig):
-            tempdir = TemporaryDirectory()
-            tmpfile = Path(tempdir.name) / "rclone.conf"
-            tmpfile.write_text(rclone_conf.text, encoding="utf-8")
-            rclone_conf = tmpfile
-        cmd = (
-            [str(rclone_exe.resolve())] + ["--config", str(rclone_conf.resolve())] + cmd
-        )
-        if verbose:
-            cmd_str = subprocess.list2cmdline(cmd)
-            print(f"Running: {cmd_str}")
-        cp = subprocess.run(
-            cmd, capture_output=True, encoding="utf-8", check=True, shell=False
-        )
-        return cp
-    finally:
-        if tempdir:
-            try:
-                tempdir.cleanup()
-            except Exception as e:
-                print(f"Error cleaning up tempdir: {e}")
-
-
-@dataclass
-class RcloneExec:
-    """Rclone execution dataclass."""
-
-    rclone_config: Path | RcloneConfig
-    rclone_exe: Path
-
-    def execute(self, cmd: list[str]) -> subprocess.CompletedProcess:
-        """Execute rclone command."""
-        return _rclone_execute(cmd, self.rclone_config, self.rclone_exe)
-
-
-@dataclass
-class RemoteFile:
-    """Remote file dataclass."""
-
-    path: str
-    name: str
-    size: int
-    mime_type: str
-    mod_time: str
-    is_dir: bool
-    # is_bucket: bool
-
-    @staticmethod
-    def from_dict(data: dict) -> "RemoteFile":
-        """Create a RemoteFile from a dictionary."""
-        return RemoteFile(
-            data["Path"],
-            data["Name"],
-            data["Size"],
-            data["MimeType"],
-            data["ModTime"],
-            data["IsDir"],
-            # data["IsBucket"],
-        )
-
-    @staticmethod
-    def from_array(data: list[dict]) -> list["RemoteFile"]:
-        """Create a RemoteFile from a dictionary."""
-        out: list[RemoteFile] = []
-        for d in data:
-            file: RemoteFile = RemoteFile.from_dict(d)
-            out.append(file)
-        return out
-
-    @staticmethod
-    def from_json_str(json_str: str) -> list["RemoteFile"]:
-        """Create a RemoteFile from a JSON string."""
-        json_obj = json.loads(json_str)
-        if isinstance(json_obj, dict):
-            return [RemoteFile.from_dict(json_obj)]
-        return RemoteFile.from_array(json_obj)
-
-    def to_json(self) -> dict:
-        return {
-            "Path": self.path,
-            "Name": self.name,
-            "Size": self.size,
-            "MimeType": self.mime_type,
-            "ModTime": self.mod_time,
-            "IsDir": self.is_dir,
-            # "IsBucket": self.is_bucket,
-        }
-
-    def __str__(self) -> str:
-        out = self.to_json()
-        return json.dumps(out)
-
-
-def _get_rclone_exe(rclone_exe: Path | None) -> Path:
-    if rclone_exe is None:
-
-        rclone_which_path = shutil.which("rclone")
-        if rclone_which_path is None:
-            raise ValueError("rclone executable not found")
-        return Path(rclone_which_path)
-    return rclone_exe
-
-
-class Rclone:
-    def __init__(
-        self, rclone_conf: Path | RcloneConfig, rclone_exe: Path | None = None
-    ) -> None:
-        if isinstance(rclone_conf, Path):
-            if not rclone_conf.exists():
-                raise ValueError(f"Rclone config file not found: {rclone_conf}")
-        self._exec = RcloneExec(rclone_conf, _get_rclone_exe(rclone_exe))
-
-    def _run(self, cmd: list[str]) -> subprocess.CompletedProcess:
-        return self._exec.execute(cmd)
-
-    def ls(self, path: str) -> list[RemoteFile]:
-        cmd = ["lsjson", path]
-        cp = self._run(cmd)
-        text = cp.stdout
-        out: list[RemoteFile] = RemoteFile.from_json_str(text)
-        return out
-
-    def listremotes(self) -> list[str]:
-        cmd = ["listremotes"]
-        cp = self._run(cmd)
-        text = cp.stdout
-        out = text.splitlines()
-        out = [o.strip() for o in out]
-        # strip out ":" from the end
-        out = [o.replace(":", "") for o in out]
-        return out