A rough guide to the different releases of ConnectionKit. Please update this document if you change things on the server!


New to ConnectionKit?
You almost certainly want to get started with the newest release in the tags directory (1.2 at present). If you run into a problem, let us know on the mailing list and we should be able to get it fixed or point you towards a branch that fixes it.



tags > 1.0
This is the original codebase put together by Greg Hulands and used in a number of applications such as Sandvox 1.5.



tags > 1.1
Brian Amerige's work to bring better error handling to the APIs for use in Flow.

branches > 1.1
For ongoing development of the 1.1 API if needed.



tags > 1.2
An overhaul of the API for Sandvox 1.6.
- More flexible NSURL-style authentication
- Like NSURLConnection, connections are immutable, but created using a CKConnectionRequest object
- Use of digest-based HTTP authentication when available
- Removal of older upload and download API

tags > 1.2.1
Maintenance release.
- File connections can be created with file:///foo URLs
- Digest-based authentication for WebDAV downloads was downloading authorization prompt instead of the file
- Downloads or uploads queued to a CKSFTPConnection before it had authenticated by passphrase were causing the request for a passphrase to be ignored

tags > 1.2.2
Maintenance release.
- Handling servers which return a 550 code to FTP FEAT commands
- Snow Leopard build compatibility
- Uploading a file which does not exist fails with an error instead of an assertion

branches > 1.2
Ongoing maintenance of the 1.2 API. Will create 1.2.x tags as needed for releases. Any changes made here should also be merged onto the trunk.



trunk
Currently the 1.2 API plus a couple of internal changes:
- FTP operations are manipulated to use short relative paths so as to avoid exceeding the server's maximum path length
- CKFTPCommand and CKFTPReply classes to encapsulate the elements of an FTP conversation
Any changes made here should be merged back to the 1.2 branch if applicable.



branches > 2.0
- Unified framework/project naming to "ConnectionKit"
- Fresh start on the API to be vastly simplified and easier to manage operations & errors
- Brand new WebDAV system built atop CFHTTPStream giving us HTTPS support and no need to write our own HTTP code
- But still pretty experimental and no support for FTP/SFTP/S3 yet

branches > BrianWorkInProgress
- A branch used by Brian to keep large, incomplete changes in version control. _DO NOT_ use this branch.