cloudfile

Cloud File CLI is a command-line utility for interacting with cloud-stored files. It allows users to materialize (download) or evict (remove the local copy while keeping the cloud entry) through platform-specific backends.

Usage

cloudfile [-v|--verbose] [-f|--force] <command> <file-path>
cloudfile [-v|--verbose] [-f|--force] copyfile <source-path> <destination-path>
cloudfile [-v|--verbose] [-f|--force] copydir <source-dir> <destination-path>

Commands

• materialize - Downloads the file from the cloud
• evict - Removes the local copy while retaining it in the cloud
• status - Prints evicted or materialized
• copyfile - Copies a file while preserving its cloud state If the destination path is a directory, the source filename is appended automatically.
• copydir - Copies a directory tree file-by-file while preserving each file's cloud state If the source ends in /, only the source directory contents are copied into the destination directory. If the source does not end in /, the source directory itself is copied. If the destination ends in /, the source directory name is appended automatically. If the destination does not end in /, the final destination path component becomes the new directory name.

Use -v or --verbose to print copy, materialize, and evict operations as they happen. Use -f or --force to overwrite destination files during copy operations. Without it, existing destination files are skipped.

Building and Installing

Ensure you have CMake installed before proceeding.

1. Clone the repository:

   git clone <repo-url>
   cd <repo-name>

2. Run the build script for your platform.

   On macOS or Linux:

   chmod +x scripts/build.sh
   ./scripts/build.sh

   On Windows PowerShell:

   ./scripts/build.ps1

Requirements

• CMake
• macOS with Clang/Xcode command line tools for the macOS backend
• Windows with a C++ toolchain and Cloud Files API support for the Windows backend