Handle clean read-only (re-)syncs of Seafile libraries to mirror them

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for mxmehl from gravatar.com mxmehl

Unverified details

These details have not been verified by PyPI
Meta
Classifiers
Report project as malware

Project description

Seafile Mirror

REUSE status The latest version of reuse can be found on PyPI. Information on what versions of Python the tool supports can be found on PyPI.

A Python tool to handle clean read-only (re-)syncs of Seafile libraries with the intention to mirror them.

Overview

If you have Seafile libraries, you may want to back them up in a safe place automatically.

One option is to snapshot/backup the whole server on which the library is stored. However, in some situations, this may not be feasible or even not possible.

This is why this repository offers a different way: you can define one or multiple Seafile libraries that shall be downloaded to a local directory. These libraries can belong to the same or a different user, and even on different Seafile servers!

Features

  • Download/sync defined libraries in customisable intervals
  • De-sync libaries immediately after they have been downloaded to avoid sync errors
  • Allow to force-re-sync a library even if its re-sync interval hasn't reached yet
  • Extensive informative and error logging
  • Created with automation in mind so you can run it in cronjobs or systemd triggers
  • Deal with the numerous caveats of seaf-cli and Seafile in general

Install

The tool depends on the following applications:

You can install the latest release via pip3 install seafile-mirror.

The tool is executable by seafile-mirror. The --help flag informs you about the required and available commands.

There is also an Ansible role that takes care of installing the tool via pipx, setting up a systemd service, and running it daily.

To keep the Seafile daemon that is required for seafile-cli running in the background, check out this exemplary systemd service.

Configuration

Configuration is done in a YAML file called seafile_mirror.conf.yaml. You can find an example here.

If that configuration file resides in the same location your current working directory, you should provide --configdir ./.

Logging and caching

The tool creates seafile_mirror.log in addition to the log to the standard output in the configuration directory. With -v you can print DEBUG messages that will help you in case of problems.

It also caches the current status of synced libraries and their latest full download in the file .seafile_mirror.db.json. Do not delete this file unless you don't mind that the tool will re-sync all libraries in the next run.

Contribute and Development

Contributions are welcome! The development is easiest with uv: uv sync and uv run seafile-mirror will get you started.

License

Apache-2.0, Copyright Max Mehl

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for mxmehl from gravatar.com mxmehl

Unverified details

These details have not been verified by PyPI
Meta
Classifiers

Release history Release notifications | RSS feed

This version

0.2.3

0.2.2

0.2.0

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

seafile_mirror-0.2.3.tar.gz (8.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

seafile_mirror-0.2.3-py3-none-any.whl (11.3 kB view details)

Uploaded Python 3

File details

Details for the file seafile_mirror-0.2.3.tar.gz.

File metadata

  • Download URL: seafile_mirror-0.2.3.tar.gz
  • Upload date:
  • Size: 8.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for seafile_mirror-0.2.3.tar.gz
Algorithm Hash digest
SHA256 ef9b122424a416af7d7dc4d204d99aa1a68a30cd213dbae066d949e01900d4fc
MD5 c8fcf57e48b2a6fc981771b396367cb2
BLAKE2b-256 f7ab2818d713ad333af44cb44f443c6dd37b7257298364f6aaab46a0d201cc0f

See more details on using hashes here.

Provenance

The following attestation bundles were made for seafile_mirror-0.2.3.tar.gz:

Publisher: publish.yaml on mxmehl/seafile-mirror

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file seafile_mirror-0.2.3-py3-none-any.whl.

File metadata

  • Download URL: seafile_mirror-0.2.3-py3-none-any.whl
  • Upload date:
  • Size: 11.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for seafile_mirror-0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 56e813a57311acdddb4295dbe2b9350b4329d6b07b2abab616f4c7ceb77e1281
MD5 fdb27a54784eb1bd522db0cfa02f9769
BLAKE2b-256 139efba2dd4f428d12b083ab7e8d59b5003277057ef107f41979a609c3946846

See more details on using hashes here.

Provenance

The following attestation bundles were made for seafile_mirror-0.2.3-py3-none-any.whl:

Publisher: publish.yaml on mxmehl/seafile-mirror

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page