iot-ftps-client

This package is a wrapper around the ftplib protocol to provide a synchronous client for interacting with FTPS servers from IoT edge devices.

Official Documentation | Source code | Package PyPI

Table of Contents

• Versioning
• Getting Started
  • Prerequisites
  • Basic Examples

Versioning

This repository adheres to Semantic Versioning. It will be maintained through the CHANGELOG.md and in GitHub Releases. It's important to note that you must maintain the version with your releases in iot/ftps/client/_version.py, otherwise a new package version will fail to get published.

Getting Started

This section provides basic examples with the iot-ftps-client.

Prerequisites

• Python 3.7 or later is required to use this package.

Basic Examples

1. Install via pip:

   pip install iot-ftps-client
   

2. Import and say hello:

   from iot.ftps.client import __version__
   
   
   print(f"hello world from iot-ftps-client version: {__version__}")
   

3. Basic usage:

   import tempfile
   
   from iot.ftps.client import IoTFTPSClient
   
   # instantiate client
   ftps_client = IoTFTPSClient(
       ftps_host="myServerIP",
       ftps_port=990,
       ftps_user="myServerUsername",
       ftps_pass="myServerPass***",
       ssl_implicit=True,
   )
   
   # print info w/ repr
   print(f"{ftps_client.__repr__()}")
   
   # download blob to tempfile
   temp_file = tempfile.NamedTemporaryFile()
   download_result = ftps_client.download_file(
       source="path/to/blob.txt",
       dest=temp_file.name,
   )
   if not download_result:
       print("unable to download file")
       temp_file.close()
       raise
   
   # upload tempfile to blob
   upload_result = ftps_client.upload_file(
       source=temp_file.name,
       dest="path/to/new/blob.txt",
   )
   if not upload_result:
       print("unable to upload file")
       temp_file.close()
       raise
   
   # clean-up local memory
   temp_file.close()