https://github.com/crossr/pyrclone

https://github.com/crossr/pyrclone

Last synced: 25 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/crossr/pyrclone
• Owner: CrossR
• License: gpl-3.0
• Created: 2019-01-13T11:21:10.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2020-03-27T21:10:40.000Z (almost 5 years ago)
• Last Synced: 2024-11-08T17:57:30.516Z (3 months ago)
• Language: Python
• Size: 61.5 KB
• Stars: 1
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# pyRclone

A typed rClone interface for python.

Written to more easily express awkward logic, that would be a pain or not

(easily) possible on the command line.

A short example, to tidy up and half the number of backups is shown below.

The logic can be trivially expanded to instead say, parse the time stamp of

the backup out of the folder name, to allow different logic to be applied

depending on the age of a backup (do nothing if 1 month old, half is 2 months

old, remove every other after a year old etc).

```py

import json

import logging

import os

import sys

from pyrclone import Rclone, RcloneError, RcloneOutput

def main():

    # Setup rclone runner, and have it run in verbose and dry run mode.

    rclone: Rclone = Rclone()

    rclone.verbose_mode = True

    rclone.dry_run_mode = True

    # Attach a logger, for more immediate output, rather than just on command completion.

    rclone.logger.setLevel(logging.DEBUG)

    handler: logging.StreamHandler = logging.StreamHandler(sys.stdout)

    handler.setLevel(logging.DEBUG)

    formatter: logging.Formatter = logging.Formatter(

        "%(asctime)s - %(name)s - %(levelname)s - %(message)s"

    )

    handler.setFormatter(formatter)

    rclone.logger.addHandler(handler)

    # List all folders in backup directory to iterate over them.

    remote_path: str = "drive:PC/Backups"

    rclone_output: RcloneOutput = rclone.lsd(remote_path)

    # If we failed to run, stop.

    if rclone_output.return_code is not RcloneError.SUCCESS:

        print(rclone_output.error)

        return

    # lsd (and all other ls commands) will default to using lsjson.

    # Lets decode the JSON, and get a list of all our folders.

    backup_folders = []

    for folder in json.loads("".join(rclone_output.output)):

        backup_folders.append(f"{remote_path}/{folder['Path']}")

    # With our list of folders, lets delete every other folder, excluding these

    # useful ones.

    #

    # This could also be more indepth logic, such as using the modified timestamp

    # or the timestamp in the folder name to do logic to different backups of

    # varying age. This is allows the ease of scripting in Python to help, versus

    # confusing/verbose command line options and shell scripts.

    ignore_list = [

        "drive:PC/Backups/2017-09-18_WindowsUpdate",

        "drive:PC/Backups/2019-07-30_FlatMove",

        "drive:PC/Backups/2019-08-12_HDD-Swap",

    ]

    # Iterate over every other folder and delete if not in the ignore.

    #

    # Of course, right now we are in dry_run mode, so this won't do anything

    # except list what it would have done.

    for folder in backup_folders[1::2]:

        if folder in ignore_list:

            continue

        rclone.delete(folder)

if __name__ == "__main__":

    main()

```