#backup #deduplication #encryption #restic #library #early-stage

rustic_backend

rustic_backend - library for supporting various backends in rustic-rs

7 unstable releases (3 breaking)

0.4.2 Oct 24, 2024
0.4.1 Oct 3, 2024
0.3.0 Sep 23, 2024
0.2.1 Sep 6, 2024
0.1.0 Aug 10, 2023

#569 in Filesystem

Download history 42/week @ 2024-07-15 91/week @ 2024-07-22 21/week @ 2024-07-29 19/week @ 2024-08-05 114/week @ 2024-08-12 285/week @ 2024-08-19 83/week @ 2024-08-26 500/week @ 2024-09-02 268/week @ 2024-09-09 239/week @ 2024-09-16 704/week @ 2024-09-23 1281/week @ 2024-09-30 490/week @ 2024-10-07 332/week @ 2024-10-14 786/week @ 2024-10-21 215/week @ 2024-10-28

1,859 downloads per month
Used in rustic-rs

Apache-2.0 OR MIT

1MB
15K SLoC

Library for supporting various backends in rustic

About

This library is a part of the rustic project and provides a set of backends for the rustic_core library. It is used to interact with various storage backends, such as rclone, rest, and in general opendal.

The goal of this library is to provide a unified interface for interacting with various backends, so that the rustic_core library can be used to interact with them in a consistent way.

Note: rustic_backend is in an early development stage and its API is subject to change in the next releases. If you want to give feedback on that, please open an issue.

Contact

You can ask questions in the Discussions or have a look at the FAQ.

Contact Where?
Issue Tracker GitHub Issues
Discord Discord
Discussions GitHub Discussions

Usage

Add this to your Cargo.toml:

[dependencies]
rustic_backend = "*"

Crate features

This crate exposes a few features for controlling dependency usage:

  • cli - Enables support for CLI features by enabling merge and clap features. This feature is disabled by default.

  • clap - Enables a dependency on the clap crate and enables parsing from the commandline. This feature is disabled by default.

  • merge - Enables support for merging multiple values into one, which enables the conflate dependency. This is needed for parsing commandline arguments and merging them into one (e.g. config). This feature is disabled by default.

  • opendal - Enables support for the opendal backend. This feature is enabled by default.

  • rclone - Enables support for the rclone backend. This feature is enabled by default.

  • rest - Enables support for the rest backend. This feature is enabled by default.

Usage & Examples

Due to being a support crate for rustic_core, there are no examples here. Please check the examples in the rustic_core crate.

Contributing

Found a bug? Open an issue!

Got an idea for an improvement? Don't keep it to yourself!

Please make sure, that you read the contribution guide.

Minimum Rust version policy

This crate's minimum supported rustc version is 1.76.0.

The current policy is that the minimum Rust version required to use this crate can be increased in minor version updates. For example, if crate 1.0 requires Rust 1.20.0, then crate 1.0.z for all values of z will also require Rust 1.20.0 or newer. However, crate 1.y for y > 0 may require a newer minimum version of Rust.

In general, this crate will be conservative with respect to the minimum supported version of Rust.

License

Licensed under either of:

Dependencies

~47–64MB
~1M SLoC