remotefs

Changelog · Get started · Documentation

~ The Omni Filetransfer Client Library (and more!) ~

Developed by @veeso

Current version: 0.1.1 (09/12/2021)

About remotefs ☁️

remotefs is a library that provides a file system structure to work with all the most used file transfer protocols. This is achieved through a trait called RemoteFs which exposes methods to operate on the remote file system. Currently the library exposes a client for Sftp, Scp, Ftp and Aws-s3.

Why remotefs ❓

You might be wondering what's the reasons behind remotefs. The first reason is to provide an easy way to operate with multiple protocols at the same time. For example, in termscp, this came very handily to me. The second reason is that often, users need to implement just a simple client to operate on a remote file system, and they have to waste a lot of time in understanding how the protocol works just to achieve a single task.

With remotefs this is no more a problem: all you need is to configure the options to connect to the remote host and you're ready to deal with the remote file system, as it were mounted on your pc.

Features 🎁

• 📁 Different communication protocols
  • SFTP
  • SCP
  • FTP and FTPS
  • Aws S3
• ✔️ Configure what you need: you can enable only the client that you need
• 🤖 Easy to extend with new protocols
• 🚀 easy to setup
• 😄 no need to know how the underlying protocol works

Get started 🚀

First of all, add remotefs to your project dependencies:

toml remotefs = "^0.1.0"

by default, these features are enabled: ssh

these features are supported:

• aws-s3: enable Aws-s3 client
• ftp: enable Ftp client
• ssh: enable Ssh client
• no-log: disable logging. By default, this library will log via the log crate.

Requirements ❗

• Linux users:
  • Ssh
  • libssh
  • pkg-config
• BSD users:
  • Ssh
  • libssh
  • pkgconf

Remote file system 💾

As stated in the introduction, this library exposes a trait for each client called RemoteFs. This trait exposes several methods to operate on the remote file system, via the chosen client.

Let's briefly see which methods are available:

• connect: connect to the remote host.
• disconnect: disconnect from the remote host.
• is_connected: returns whether the client is connected to the remote host.
• append_file: append specified buffer to the specified file.
• append: open a file for append and returns a stream to write it.
• change_dir: change the working directory to provided path.
• copy: copy a file from the specified source path to the specified destination.
• create_dir: create a directory with the specified file mode at the specified path.
• create_file: create a file at a specified path with the specified content.
• create: create a file and returns a stream to write it.
• exec: Executes a shell command.
• exists: checks whether file at specified path exists.
• list_dir: get entries at the provided path.
• mov: move a file from the specified source path to the specified destination.
• open_file: open a file for reading and fill the specified buffer with the file content.
• open: open a file and returns a stream to read it.
• pwd: get working directory.
• removedirall: remove file/directory and all of its content.
• remove_dir: remove directory at the specified path. It fails if it is not an empty directory.
• remove_file: remove file at the specified path. It fails if it is not a file.
• setstat: set file metadata for file at the specified path.
• stat: get file information of file at the specified path.
• symlink: create a symlink at the specified path, pointing to the specified file.

Client compatibility table ✔️

The following table states the compatibility for each protocol client and the remote file system trait method.

Note: connect(), disconnect() and is_connected() MUST always be supported, and are so omitted in the table.

| Client/Method | Aws-S3 | Ftp | Scp | Sftp | |----------------|--------|-----|-----|------| | appendfile | No | Yes | No | Yes | | append | No | Yes | No | Yes | | changedir | Yes | Yes | Yes | Yes | | copy | No | No | Yes | Yes | | createdir | Yes | Yes | Yes | Yes | | createfile | Yes | Yes | Yes | Yes | | create | No | Yes | Yes | Yes | | exec | No | No | Yes | Yes | | exists | Yes | Yes | Yes | Yes | | listdir | Yes | Yes | Yes | Yes | | mov | No | Yes | Yes | Yes | | openfile | Yes | Yes | Yes | Yes | | open | No | Yes | Yes | Yes | | pwd | Yes | Yes | Yes | Yes | | removedirall | Yes | Yes | Yes | Yes | | removedir | Yes | Yes | Yes | Yes | | removefile | Yes | Yes | Yes | Yes | | setstat | No | No | Yes | Yes | | stat | Yes | Yes | Yes | Yes | | symlink | No | No | Yes | Yes |

Support the developer ☕

If you like remotefs and you're grateful for the work I've done, please consider a little donation 🥳

You can make a donation with one of these platforms:

Apps using remotefs 🚀

• termscp

Contributing and issues 🤝🏻

Contributions, bug reports, new features, and questions are welcome! 😉 If you have any questions or concerns, or you want to suggest a new feature, or you want just want to improve remotefs, feel free to open an issue or a PR.

Please follow our contributing guidelines

Changelog ⏳

View remotefs' changelog HERE

Powered by 💪

remotefs is powered by these aweseome projects:

• rust-s3
• ssh2-rs
• suppaftp
• whoami
• wildmatch

License 📃

remotefs is licensed under the MIT license.

You can read the entire license HERE