Zig

FTP Sync Download Tree w/ Must-Match Constraints

See more FTP Examples

Demonstrates how synchronize a directory tree in the download direction, but only for files matching a set of wildcard filenames.

Note: This example requires Chilkat v9.5.0.76 or greater.

Zig

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    const ftp = try chilkat.Ftp2.init();
    defer ftp.deinit();

    ftp.setHostname("ftp.something.com");
    ftp.setUsername("my_login");
    ftp.setPassword("my_password");

    // Connect and login to the FTP server.
    ftp.connect() catch {
        std.debug.print("{s}\n", .{try ftp.getLastErrorText(alloc)});
        return;
    };

    // Set the current remote directory to the root of
    // the tree to be downloaded.
    ftp.changeRemoteDir("/subDir1") catch {
        std.debug.print("{s}\n", .{try ftp.getLastErrorText(alloc)});
        return;
    };

    // Possible synchronization modes are:
    // mode=0: Download all files
    // mode=1: Download all files that do not exist on the local filesystem.
    // mode=2: Download newer or non-existant files.
    // mode=3: Download only newer files. If a file does not already exist on the local filesystem, it is not downloaded from the server..
    // mode=5: Download only missing files or files with size differences.
    // mode=6: Same as mode 5, but also download newer files.

    // This example will download all files, but only those files having filenames
    // that match *.gif and *.eml

    // Imagine our remote directory tree has these files and directories:

    //     accentedLatin1.txt
    //     accentedUtf8.txt
    //     alice.key
    //     anter_cert.pem
    //     chiliPepper.gif
    //     helloWorld.pdf
    //     abc/chiliPepper.gif
    //     abc/ghk/
    //     data/chiliPepper.gif
    //     data/xyz/dkimHtmlBody.txt
    //     data/xyz/dkimVerifyTest.eml
    //     data/xyz/emailForCreateDsn.eml
    //     text/frenchUtf8.txt
    //     text/helloWorld.txt
    //     text/PolishEmailBody.txt
    //     text/something/

    // Indicate that we only want to create auto-create local directories (if needed)
    // for the files that are actually downloaded.  If SyncCreateAllLocalDirs remains
    // true, then the corresponding local directory is created for each remote directory
    // traversed regardless of whether files within are downloaded.
    ftp.setSyncCreateAllLocalDirs(false);

    ftp.setSyncMustMatch("*.eml; *.gif");
    const mode = 0;
    ftp.syncLocalTree("c:/temp/subDir1", mode) catch {
        std.debug.print("{s}\n", .{try ftp.getLastErrorText(alloc)});
        return;
    };

    try ftp.disconnect();

    // Show the files downloaded.
    const st = try chilkat.StringTable.init();
    defer st.deinit();
    ftp.getSyncedFiles(st);

    const num_files = st.getCount();
    var i: i32 = 0;
    while (i < num_files) {
        std.debug.print("{s}\n", .{try st.stringAt(alloc, i)});
        i = i + 1;
    }

    // Output showing the files downloaded:

    // chiliPepper.gif
    // abc/chiliPepper.gif
    // data/chiliPepper.gif
    // data/xyz/dkimVerifyTest.eml
    // data/xyz/emailForCreateDsn.eml
}