• About
• Screenshots
• Import-Export

Poet’s Corner Version 2.0 October 12, 2022 by Rick Aurbach www.aurbach.com/PoetsCorner rlaurb@icloud.com

On iCloud and Data Backup

As of version 2.0, Poet's Corner maintains a backup copy of your data in your personal (and private) iCloud account. This copy is used to maintain synchronization between your Apple devices (iPhone, iPad and Macintosh).

This automatic backup makes the Import/Export functions of Poets Corner much less important. However, there we have left them in the program just in case you need them.

Exporting Data

You can use the Export Data function on the Settings Panel (tap the "gear" icon) to create an export file.

Export files can be saved with either the .poetry file type or the .json file type. The file contents are identical, regardless of the file type. However, the .poetry file type will be opened exclusively by Poet's Corner, while the .json file type can be opened by any application that understands JSON data.

Importing Data

Poet's Corner can open and process (properly formatted) files with the .poetry file extension.

• You can tap on a .poetry file in the Files application to import its contents into Poet's Corner.
• You can tap on an attacked .poetry file in Mail or iMessage to import its contents as well.

Each poem and quotation in a .poetry file contains a unique identifier, which is used to prevent duplicate entries if you import the same items more than once.

The .poetry File Format

For techies only

A .poetry file is a simple JSON file with a custom file extension. The easiest way to understand the format is to examime an exported example. But we'll document the file here.

• "application" key
  The value of this key is "Poets Corner".
• "schemaVersion" key
  Currently the value of this key is "2".
• "exportDate" key
  This key contains the date the file was created (format is mmm dd, yyyy).
• "content" key
  This is an array of items, one for each poem or quotation. Each element of the array has the following format:
  • "category" key
    Vaiid values of this key are "poem" and "quotation".
  • "id" key
    This field is a text representation of a UUID for the item. UUIDs are used to uniquely identify the items and are used during import to prevent duplicates. Strictly speaking, UUIDs are optional; if you don't include one, a new UUID will be assigned to the item. However, the ability of Poet's Corner to prevent duplicate entries during import will be lost.
  • "added" key
    This field is the ISO8601 string representation of the date the item was added to the Poet's Corner.
  • "content" key
    This is the actual content of the poem or quotation. Line endings are encoded as "\n" and all spacing in the item should be carefully preserved.