GDFileManagerKit

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #typescript #golang #go #android #deep-learning #docker #macos #java #cli #awesome-list

GDFileManagerKit

(★ 279)

A consistent iOS API for cloud file storage services including Dropbox and Google Drive.

File Explorer

Download Latest Version (.zip)

- - InfoPlist.strings
  - MainStoryboard_iPad.storyboard
  - MainStoryboard_iPhone.storyboard
- Default-568h@2x.png
- Default.png
- Default@2x.png
- FileToUpload.txt
- GDAppDelegate.h
- GDAppDelegate.m
- GDDetailViewController.h
- GDDetailViewController.m
- GDFileManagerExample-Info.plist
- GDFileManagerExample-Prefix.pch
- GDMasterViewController.h
- GDMasterViewController.m
- GDMasterViewController.storyboard
- main.m
- - contents.xcworkspacedata
- project.pbxproj
- - .xccurrentversion
- - .xccurrentversion
- _GDCoreDataFileNode.h
- _GDCoreDataFileNode.m
- _GDCoreDataMetadata.h
- _GDCoreDataMetadata.m
- _GDFileManagerCachedFile.h
- _GDFileManagerCachedFile.m
- _GDFileManagerPendingUpload.h
- _GDFileManagerPendingUpload.m
- AFHTTPRequestOperation+GDFileManager.h
- AFHTTPRequestOperation+GDFileManager.m
- AsyncSequentialEnumeration.h
- AsyncSequentialEnumeration.m
- dropbox-icon.png
- dropbox-icon@2x.png
- Dropbox.png
- Dropbox@2x.png
- FileBrowser.storyboard
- GDAbstractMetadataCache.h
- GDAbstractMetadataCache.m
- GDAbstractMetadataCache_Private.h
- GDAccessTokenClientCredential.h
- GDAccessTokenClientCredential.m
- GDAPIToken.h
- GDAPIToken.m
- GDClient.h
- GDClientCredential.h
- GDClientCredential.m
- GDClientManager.h
- GDClientManager.m
- GDCoreDataFileNode.h
- GDCoreDataFileNode.m
- GDCoreDataMetadata.h
- GDCoreDataMetadata.m
- GDCoreDataMetadataCache.h
- GDCoreDataMetadataCache.m
- GDCredentialManager.h
- GDCredentialManager.m
- GDCredentialManager_Private.h
- GDDictionaryBackedObject.h
- GDDictionaryBackedObject.m
- GDDiscardingMetadataCache.h
- GDDiscardingMetadataCache.m
- GDDispatchUtilities.h
- GDDropbox.h
- GDDropboxAccountInfo.h
- GDDropboxAccountInfo.m
- GDDropboxAPIToken.h
- GDDropboxAPIToken.m
- GDDropboxChunkedUploadOperation.h
- GDDropboxChunkedUploadOperation.m
- GDDropboxClient.h
- GDDropboxClient.m
- GDDropboxClientManager.h
- GDDropboxClientManager.m
- GDDropboxCredential.h
- GDDropboxCredential.m
- GDDropboxCredential_Private.h
- GDDropboxFileService.h
- GDDropboxFileService.m
- GDDropboxFileServiceSession.h
- GDDropboxFileServiceSession.m
- GDDropboxMetadata.h
- GDDropboxMetadata.m
- GDDropboxUploadState.h
- GDDropboxUploadState.m
- GDDropboxURLMetadata.h
- GDDropboxURLMetadata.m
- GDFileListViewController.h
- GDFileListViewController.m
- GDFileManager.h
- GDFileManager.m
- GDFileManager_Private.h
- GDFileManagerAlias.h
- GDFileManagerAlias.m
- GDFileManagerAlias_Private.h
- GDFileManagerCachedDownloadOperation.h
- GDFileManagerCachedDownloadOperation.m
- GDFileManagerCachedFile.h
- GDFileManagerCachedFile.m
- GDFileManagerConstants.h
- GDFileManagerDataCacheCoordinator.h
- GDFileManagerDataCacheCoordinator.m
- GDFileManagerDownloadOperation.h
- GDFileManagerDownloadOperation.m
- GDFileManagerDownloadOperation_Private.h
- GDFileManagerKit.h
- GDFileManagerPendingUpload.h
- GDFileManagerPendingUpload.m
- GDFileManagerPersistentUploadOperation.h
- GDFileManagerPersistentUploadOperation.m
- GDFileManagerPersistentUploadOperation_Private.h
- GDFileManagerResourceBundle.h
- GDFileManagerResourceBundle.m
- GDFileManagerUploadOperation.h
- GDFileManagerUploadOperation.m
- GDFileManagerUploadOperation_Private.h
- GDFileManagerUploadState.h
- GDFileManagerUploadState.m
- GDFileService.h
- GDFileService.m
- GDFileServiceManager+AutoRegistration.h
- GDFileServiceManager+AutoRegistration.m
- GDFileServiceManager.h
- GDFileServiceManager.m
- GDFileServiceSession.h
- GDFileServiceSession.m
- GDFileServiceSessionListController.h
- GDFileServiceSessionListController.m
- GDFileServiceViewController.h
- GDFileServiceViewController.m
- GDFileTreeNode.h
- GDFileTreeNode.m
- GDGoogleDrive.h
- GDGoogleDriveAccountInfo.h
- GDGoogleDriveAccountInfo.m
- GDGoogleDriveAPIToken.h
- GDGoogleDriveAPIToken.m
- GDGoogleDriveChange.h
- GDGoogleDriveChange.m
- GDGoogleDriveChunkedUploadOperation.h
- GDGoogleDriveChunkedUploadOperation.m
- GDGoogleDriveClient.h
- GDGoogleDriveClient.m
- GDGoogleDriveClientManager.h
- GDGoogleDriveClientManager.m
- GDGoogleDriveFileService.h
- GDGoogleDriveFileService.m
- GDGoogleDriveFileServiceSession.h
- GDGoogleDriveFileServiceSession.m
- GDGoogleDriveMetadata.h
- GDGoogleDriveMetadata.m
- GDGoogleDriveUploadState.h
- GDGoogleDriveUploadState.m
- GDGoogleDriveUploadState_Private.h
- GDGoogleDriveURLMetadata.h
- GDGoogleDriveURLMetadata.m
- GDHTTPClient.h
- GDHTTPClient.m
- GDHTTPOperation.h
- GDHTTPOperation.m
- GDImageCell.h
- GDImageCell.m
- GDImageCell.xib
- GDKeyboardDismissingNavigationController.h
- GDKeyboardDismissingNavigationController.m
- GDKeychainCredentialManager.h
- GDKeychainCredentialManager.m
- GDLayeredMetadataCache.h
- GDLayeredMetadataCache.m
- GDLocalFileService.h
- GDLocalFileService.m
- GDLocalFileServiceSession.h
- GDLocalFileServiceSession.m
- GDLocalURLMetadata.h
- GDLocalURLMetadata.m
- GDLoginFormViewController.h
- GDLoginFormViewController.m
- GDMetadataCache.h
- GDMultiMap.h
- GDMultiMap.m
- GDOAuth2Credential.h
- GDOAuth2Credential.m
- GDParentOperation.h
- GDParentOperation.m
- GDPersistentUploadDestination.h
- GDPersistentUploadDestination.m
- GDRemoteFileService.h
- GDRemoteFileService.m
- GDRemoteFileServiceSession.h
- GDRemoteFileServiceSession.m
- GDRetainingMetadataCache.h
- GDRetainingMetadataCache.m
- GDSugarSync.h
- GDSugarSyncAccountInfo.h
- GDSugarSyncAccountInfo.m
- GDSugarSyncAPIToken.h
- GDSugarSyncAPIToken.m
- GDSugarSyncClient.h
- GDSugarSyncClient.m
- GDSugarSyncClientManager.h
- GDSugarSyncClientManager.m
- GDSugarSyncCredential.h
- GDSugarSyncCredential.m
- GDSugarSyncDownloadOperation.h
- GDSugarSyncDownloadOperation.m
- GDSugarSyncFileService.h
- GDSugarSyncFileService.m
- GDSugarSyncFileServiceSession.h
- GDSugarSyncFileServiceSession.m
- GDSugarSyncMetadata.h
- GDSugarSyncMetadata.m
- GDSugarSyncUploadOperation.h
- GDSugarSyncUploadOperation.m
- GDSugarSyncUploadState.h
- GDSugarSyncUploadState.m
- GDSugarSyncUploadState_Private.h
- GDSugarSyncURLMetadata.h
- GDSugarSyncURLMetadata.m
- GDSugarSyncURLMetadata_Private.h
- GDURLMetadata.h
- GDURLMetadata.m
- GDURLMetadata_Private.h
- GDURLMetadataInternal.h
- GDURLUtilities.h
- GDURLUtilities.m
- GDWebDAV.h
- GDWebDAVClient.h
- GDWebDAVClient.m
- GDWebDAVClientManager.h
- GDWebDAVClientManager.m
- GDWebDAVCredential.h
- GDWebDAVCredential.m
- GDWebDAVFileService.h
- GDWebDAVFileService.m
- GDWebDAVFileServiceSession.h
- GDWebDAVFileServiceSession.m
- GDWebDAVMetadata.h
- GDWebDAVMetadata.m
- GDWebDAVUploadOperation.h
- GDWebDAVUploadOperation.m
- GDWebDAVURLMetadata.h
- GDWebDAVURLMetadata.m
- GDWebLoginController.h
- GDWebLoginController.m
- GDWebLoginController_Private.h
- GDWebLoginControllerDefaultDelegate.h
- GDWebLoginControllerDefaultDelegate.m
- GDWebLoginViewController.h
- GDWebLoginViewController.m
- google-drive-icon.png
- google-drive-icon@2x.png
- google-drive-icon@4x.png
- GoogleDrive.png
- GoogleDrive@2x.png
- local-icon.png
- local-icon@2x.png
- local-icon@4x.png
- sugarsync-icon.png
- sugarsync-icon@2x.png
- sugarsync-icon@4x.png
- SugarSync.png
- SugarSync@2x.png
- SugarSyncAccessTokenRequest.xml
- SugarSyncCopyFileRequest.xml
- SugarSyncCreateFileRequest.xml
- SugarSyncLoginForm.json
- SugarSyncRefreshTokenRequest.xml
- webdav-icon.png
- webdav-icon@2x.png
- WebDAV.graffle
- WebDAV.png
- WebDAV@2x.png
- WebDAVMetadataRequest.xml
- WebDAVServerForm.json
- AFOAuth2Client.podspec
.gitignore
CHANGES.md
GDFileManagerKit.podspec
LICENSE
Podfile
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# GDFileManagerKit

[![Version](http://cocoapod-badges.herokuapp.com/v/GDFileManagerKit/badge.png)](http://cocoadocs.org/docsets/GDFileManagerKit)
[![Platform](http://cocoapod-badges.herokuapp.com/p/GDFileManagerKit/badge.png)](http://cocoadocs.org/docsets/GDFileManagerKit)

Fed up with different/inconsistent/non-existent SDKs for cloud file storage services?  Try GDFileManagerKit! GDFileManagerKit lets you access Dropbox, Google Drive, SugarSync and WebDAV with a consistent, NSFileManager-like API.

Features of GDFileManagerKit include:

* Persistent cached file metadata.  Old metadata is re-validated where possible making API calls more efficient.
* Cached file downloads.
* Chunked upload / downloads where available for reliability in intermittently connected environments.
* Copy/Delete/Move file operations.
* Aliases to keep track of files if the user moves / renames them remotely (requires a file service that supports persistent file identifiers like Google Drive or SugarSync).

GDFileManagerKit is currently beta-quality software, but I am using it in my app [PocketBib].  See my [blog post][blog-post] for details.

## Screenshots

File service list.  To add an account, tap the 'plus' button.
[![FileServiceList](http://www.grahamdennis.me/images/gdfilemanagerkit/file-service-list-small.png)](http://www.grahamdennis.me/images/gdfilemanagerkit/file-service-list.png)

Adding an account...

[![AddAccount](http://www.grahamdennis.me/images/gdfilemanagerkit/add-account-small.png)](http://www.grahamdennis.me/images/gdfilemanagerkit/add-account.png)

Downloading a file. (To upload a test file, tap the 'plus' button in the left navigation bar).

[![DownloadingFile](http://www.grahamdennis.me/images/gdfilemanagerkit/downloading-file-small.png)](http://www.grahamdennis.me/images/gdfilemanagerkit/downloading-file.png)

## Usage

Get the contents of a directory:

[[GDFileManager sharedManager] getContentsOfDirectoryAtURL:url success:^(NSArray *contents) {
        for (GDURLMetadata *metadata in contents) {
            NSLog(@"Found %@ called \"%@\"", [metadata isDirectory] ? @"folder" : @"file", metadata.filename);
        }
    
    } failure:^(NSError *error) {
        NSLog(@"error: %@", error);
    }];

Check the local cache for the file, download it if it has been updated, and cache the result:

GDFileManager *fileManager = [GDFileManager new];
    GDFileManagerDownloadOperation *downloadOperation = [fileManager cachedDownloadOperationFromSourceURL:url
                                                                       success:^(NSURL *localURL, GDURLMetadata *metadata) {
                                                                           NSLog(@"success: %@; metadata = %@", localURL, metadata);
                                                                       } failure:^(NSError *error) {
                                                                           if ([[error domain] isEqualToString:NSURLErrorDomain] && [error code] == NSURLErrorCancelled) {
                                                                           } else
                                                                               NSLog(@"download failed: %@", error);
                                                                       }];
    [fileManager enqueueFileManagerOperation:downloadOperation];

To set your Dropbox API key:

[GDDropboxAPIToken registerTokenWithKey:@"<dropbox_key>"
                                     secret:@"<dropbox_secret>"
                                       root:GDDropboxRootDropbox]; // This token has access to the entire dropbox folder

See the included `GDFileManagerExample` for more examples.  To run the demo app, run `pod install`, and then open `GDFileManagerExample.xcworkspace` and build.

## Requirements

iOS 5.0+, uses a number of external libraries including AFNetworking 1.x, SSKeychain, AFOAuth2Client.

## Installation

GDFileManagerKit is available through [CocoaPods](http://cocoapods.org), to install
it simply add the following line to your `Podfile`:

pod "GDFileManagerKit"

## Author

Graham Dennis, graham@grahamdennis.me

## License

GDFileManagerKit is available under the MIT license. See the LICENSE file for more info.  If you require a non-attribution license, please contact me at graham@grahamdennis.me

[PocketBib]: http://itunes.apple.com/app/pocketbib-for-bibtex-bibdesk/id524521749?ls=1&mt=8
[blog-post]: http://www.grahamdennis.me/blog/2013/10/12/gdfilemanagerkit-a-consistent-ios-api-for-cloud-file-storage-services/

GDFileManagerKit

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

GDFileManagerKit

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README