clay import

[nelsonpecora]

Importers:

• stdin → Clay
• Clay Site → Clay
• Clay Page → Clay
• Clay Component → Clay
• Files(s) → Clay

[nelsonpecora]

caolan/highland#36

[nelsonpecora]

If anyone wants to take a shot at multi-page importing, please make a PR. The platform team doesn't have enough bandwidth right now to do this.

[cperryk]

@nelsonpecora I'll submit a PR soon for it.

[cperryk]

Some takeaways from my powwow with Nelson:

• single page import should have a --published flag to import published versions of pages
• site import should by default only import drafts but should import published pages if --published flag is set
• site import should rely on the pages index instead of the /pages endpoint and get the most recently updated pages
• everything outside of what Amphora specifies as a reserved property of the page object (e.g. urlHistory, url, lastModified), can be assumed to be a component ref / list of component refs
• by default, single page import and site imports should not overwrite existing layouts -- only add new ones. Any layout that would otherwise be overwritten should be logged. Both commands should have a --overwrite-layouts option that overwrites layout.

I expect to be able to update my PR accordingly within the next few days.