pCloud API

gem "pcloud_api"

Pcloud::Client.configure(
  access_token: "your-pcloud-app-access-token",
  data_region: "EU",
  timeout_seconds: 8 # optional integer, defaults to 8 seconds if not specified
)

# Find files by file :id or :path:
Pcloud::File.find(1)
Pcloud::File.find_by(path: "/images/jack_the_cat.jpg")
# NOTES:
# - `find_by` can also be used with :id, though this will take precedence over
#   :path so pick only one or the other
# - Both `find` and `find_by` take an optional `recursive: true` argument which
#   will recursively load all the folders contents. NOTE: this may result in
#   long request times for folders with many items in them.

# Check if a file exists by :id
Pcloud::File.exists?(1)

# Upload a new file, rename if one already exists with this name:
Pcloud::File.upload(
  path: "/Jack",
  file: File.open("/Users/joshua/Downloads/jack_goes_swimming.mp4")
)

# Upload a file, force overwrite if a file already exists with this name:
Pcloud::File.upload!(
  path: "/Jack",
  file: File.open("/Users/joshua/Downloads/jack_goes_swimming.mp4")
)

# NOTE:
# The `upload` and `upload!` methods will allow you to specify either the :path
# or the :folder_id of the target parent directory, or you can choose to pass
# neither paramenter and your files will be placed in your root pCloud
# directory by default.

# Rename a file:
jack_goes_swimming.update(name: "That's one wet cat.mp4")

# Move a file by updating the :parent_folder_id:
jack_goes_swimming.update(parent_folder_id: 9000)

# Move a file by specifying the parent folder part of the path:
jack_goes_swimming.update(path: "/photos/") # NOTE: needs to start and end with slashes

# Move a file by specifying the entire new file path:
jack_goes_swimming.update(path: "/photos/jack_goes_swimming.mp4")

# Delete a file:
jack_goes_swimming.delete

# Get a link to download a file:
jack_goes_swimming.download_url

# Access the parent folder of a file:
jack_goes_swimming.parent_folder

# Find folders by folder :id or :path:
Pcloud::Folder.find(1)
Pcloud::Folder.find_by(path: "/images")
# NOTES:
# - `find_by` can also be used with :id, though this will take precedence over :path so pick only one or the other
# - When using :path the folder object will have a `path` value, when finding by :id, `path` will be `nil`

# Check if a folder exists by id
Pcloud::Folder.exists?(1)

# Create a new folder by :parent_folder_id and :name:
Pcloud::Folder.first_or_create(parent_folder_id: 9000, name: "jack")

# Create a new folder by :path (parent directory must already exist):
Pcloud::Folder.first_or_create(path: "/images/jack")

# Rename a folder:
jack_images.update(name: "Jack's Photo Library")

# Move a folder by updating the :parent_folder_id:
jack_images.update(parent_folder_id: 9000)

# Move a folder by specifying the parent folder part of the path:
jack_images.update(path: "/photos/")
# NOTES:
# - Partial paths must start and end with slashes
# - All refrenced parent directories in the path must already exist

# Move a folder by specifying the entire new file path:
jack_images.update(path: "/photos/images/jack")
# NOTE: All refrenced parent directories in the path must already exist

# Delete an empty folder:
jack_images.delete

# Recursively delete a folder and all its contents:
jack_images.delete!

# Access the parent folder of a folder:
jack_images.parent_folder

# Access the contents of a folder:
jack_images.contents

Pcloud::Client.execute("listrevisions", query: { fileid: 90000 })

Pcloud::File.upload(
  path: "/Jack",
  file: File.open(params[:file].path)
)

Pcloud::File.upload(
  folder_id: PCLOUD_FOLDER_ID,
  filename: LOCAL_DB_FILENAME,
  file: File.open("./#{LOCAL_DB_FILENAME}")
)

# NOTE: This will overwrite existing archive files for each day such that
#       there is only ever one database file stored per day.
Pcloud::Folder.find(PCLOUD_FOLDER_ID)
  .contents
  .filter { |item| item.is_a?(Pcloud::File) }
  .filter { |file| file.name.match?(PCLOUD_STATE_FILE_REGEX) }
  .each do |file|
    file.update(
      name: "#{file.created_at.strftime("%Y_%m_%d")}_#{file.name}",
      parent_folder_id: PCLOUD_ARCHIVE_FOLDER_ID
    )
  end

Pcloud::File.upload(
  folder_id: PCLOUD_FOLDER_ID,
  filename: LOCAL_DB_FILENAME,
  file: File.open("./#{LOCAL_DB_FILENAME}")
)

Pcloud::Folder.find(PCLOUD_FOLDER_ID)
  .contents
  .filter { |item| item.is_a?(Pcloud::File) }
  .filter { |file| file.name.match?(PCLOUD_STATE_FILE_REGEX) }
  .each do |state_file|
    filename = "./db/#{state_file.name}"
    # prompt if local file is newer than cloud state file
    if ::File.exist?(filename) && ::File.ctime(filename) > state_file.created_at
      puts "Local #{filename} is newer than the version in pCloud. Are you sure you want to overwrite the local file with an older copy? [Y/N]".red
      print "> ".red
      unless ["yes", "y"].include?($stdin.gets.chomp.downcase)
        puts "Skipping download of #{filename}...".yellow
        next
      end
    end
    # Only proceed with file download after confirmation or if cloud file is
    # not older than local file.
    ::File.open(filename, "w") do |file|
      file.binmode
      puts "Downloading #{filename} from pCloud...".yellow
      HTTParty.get(state_file.download_url, stream_body: true) do |fragment|
        file.write(fragment)
      end
    end
  end