Added NSPredicate to searchFiles method

- public functions became open, now is overridable
- fixed urlCache documentation

.swift-version

@@ -0,0 +1 @@
+3.0

.travis.yml

@@ -0,0 +1,80 @@
+language: objective-c
+osx_image: xcode8.2
+xcode_project: $PROJECTNAME.xcodeproj
+env:
+  global: 
+  - PROJECT="$PROJECTNAME.xcodeproj"
+  - FRAMEWORK_NAME="$PROJECTNAME.framework"
+  - IOS_FRAMEWORK_SCHEME="$PROJECTNAME iOS"
+  - MACOS_FRAMEWORK_SCHEME="$PROJECTNAME OSX"
+  - TVOS_FRAMEWORK_SCHEME="$PROJECTNAME tvOS"
+  - IOS_SDK=iphonesimulator
+  - MACOS_SDK=macosx
+  - TVOS_SDK=appletvsimulator
+  matrix:
+    - DESTINATION="OS=10.2,name=iPad Air 2"        SCHEME="$IOS_FRAMEWORK_SCHEME"     SDK="$IOS_SDK"     RUN_TESTS="NO" BUILD_EXAMPLE="NO" POD="YES" CARTHAGEDEPLOY="NO"
+    - DESTINATION="OS=9.0,name=iPhone 6"           SCHEME="$IOS_FRAMEWORK_SCHEME"     SDK="$IOS_SDK"     RUN_TESTS="NO" BUILD_EXAMPLE="NO" POD="NO"  CARTHAGEDEPLOY="YES"
+    - DESTINATION="OS=8.1,name=iPhone 4S"          SCHEME="$IOS_FRAMEWORK_SCHEME"     SDK="$IOS_SDK"     RUN_TESTS="NO" BUILD_EXAMPLE="NO" POD="NO"  CARTHAGEDEPLOY="NO"
+
+    - DESTINATION="OS=10.1,name=Apple TV 1080p"    SCHEME="$TVOS_FRAMEWORK_SCHEME"    SDK="$TVOS_SDK"    RUN_TESTS="NO" BUILD_EXAMPLE="NO" POD="NO"  CARTHAGEDEPLOY="NO"
+    - DESTINATION="OS=10.0,name=Apple TV 1080p"    SCHEME="$TVOS_FRAMEWORK_SCHEME"    SDK="$TVOS_SDK"    RUN_TESTS="NO" BUILD_EXAMPLE="NO" POD="NO"  CARTHAGEDEPLOY="NO"
+
+    - DESTINATION="arch=x86_64"                    SCHEME="$MACOS_FRAMEWORK_SCHEME"   SDK="$MACOS_SDK"   RUN_TESTS="NO" BUILD_EXAMPLE="NO" POD="NO"  CARTHAGEDEPLOY="NO"
+before_install:
+  - gem install xcpretty --no-rdoc --no-ri --no-document --quiet
+  - gem install cocoapods --no-rdoc --no-ri --no-document --quiet
+  # - gem install xcpretty-travis-formatter
+
+script:
+  - set -o pipefail
+  - xcodebuild -version
+
+  # Build Example in Debug if specified
+  - if [ $BUILD_EXAMPLE == "YES" ]; then
+      xcodebuild -project "$WORKSPACE" -scheme "$EXAMPLE_SCHEME" -sdk "$SDK" -destination "$DESTINATION" -configuration Debug ONLY_ACTIVE_ARCH=NO build | xcpretty;
+    fi
+
+  # Build Framework in Debug and Run Tests if specified
+  - if [ $RUN_TESTS == "YES" ]; then
+      xcodebuild -project "$PROJECT" -scheme "$SCHEME" -sdk "$SDK" -destination "$DESTINATION" -configuration Debug ONLY_ACTIVE_ARCH=NO ENABLE_TESTABILITY=YES test | xcpretty;
+    else
+      xcodebuild -project "$PROJECT" -scheme "$SCHEME" -sdk "$SDK" -destination "$DESTINATION" -configuration Debug ONLY_ACTIVE_ARCH=NO build | xcpretty;
+    fi
+
+  # Build Framework in Release and Run Tests if specified
+  - if [ $RUN_TESTS == "YES" ]; then
+      xcodebuild -project "$PROJECT" -scheme "$SCHEME" -sdk "$SDK" -destination "$DESTINATION" -configuration Release ONLY_ACTIVE_ARCH=NO ENABLE_TESTABILITY=YES test | xcpretty;
+    else
+      xcodebuild -project "$PROJECT" -scheme "$SCHEME" -sdk "$SDK" -destination "$DESTINATION" -configuration Release ONLY_ACTIVE_ARCH=NO build | xcpretty;
+    fi
+
+  # Run `pod lib lint` if specified
+  - if [ $POD == "YES" ]; then
+      pod lib lint;
+    fi
+
+after_success:
+  # Run `pod trunk push` if specified
+  - if [ $POD == "YES" ] && [ -n "$TRAVIS_TAG" ]; then
+      pod trunk push;
+    fi
+
+#   - bash <(curl -s https://codecov.io/bash)
+before_deploy:
+  - if [ $CARTHAGEDEPLOY == "YES" ] && [ -n "$TRAVIS_TAG" ]; then
+      brew update;
+      brew outdated carthage || brew upgrade carthage;
+      carthage version;
+      carthage build --no-skip-current --verbose;
+      carthage archive $PROJECTNAME;
+    fi
+
+deploy:
+  provider: releases
+  api_key: "$GITHUBTOKEN"
+  file: $FRAMEWORK_NAME.zip
+  skip_cleanup: true
+  on:
+    repo: amosavian/$PROJECTNAME
+    tags: true
+    condition: "$CARTHAGEDEPLOY = YES"

FileProvider.podspec

@@ -16,8 +16,8 @@ Pod::Spec.new do |s|
   #
 
   s.name         = "FileProvider"
-  s.version      = "0.2.0"
-  s.summary      = "NSFileManager replacement for Local and Remote (WebDAV/Dropbox/SMB2) files on iOS and MacOS."
+  s.version      = "0.14.0"
+  s.summary      = "FileManager replacement for Local and Remote (WebDAV/Dropbox/OneDrive/SMB2) files on iOS and macOS."
 
   # This description is used to generate tags and improve search results.
   #   * Think: What does it do? Why did you write it? What is the focus?
@@ -26,8 +26,8 @@ Pod::Spec.new do |s|
   #   * Finally, don't worry about the indent, CocoaPods strips it!
   s.description  = <<-DESC
   					This Swift library provide a swifty way to deal with local and remote files 
-  					and directories in same way. For now Local and WebDAV providers are ready to use
-  					and SMB2, Dropbox, FTP and AmazonS3 is planned for future.
+  					and directories in same way. For now Local, WebDAV and Dropbox providers are ready to use.
+  				    SMB2, FTP and AmazonS3 is planned for future.
                    DESC
 
   s.homepage     = "https://github.com/amosavian/FileProvider"
@@ -73,7 +73,7 @@ Pod::Spec.new do |s|
   s.ios.deployment_target = "8.0"
   s.osx.deployment_target = "10.10"
   # s.watchos.deployment_target = "2.0"
-  # s.tvos.deployment_target = "9.0"
+  s.tvos.deployment_target = "9.0"
 
 
   # ――― Source Location ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
@@ -93,8 +93,8 @@ Pod::Spec.new do |s|
   #  Not including the public_header_files will make all headers public.
   #
 
-  s.source_files  = "Source/*.swift"
-  s.exclude_files = "Source/Exclude"
+  s.source_files  = "Sources/**/*.swift"
+  s.exclude_files = "Sources/Exclude"
 
   # s.public_header_files = "Classes/**/*.h"
 

FileProvider.xcodeproj/project.xcworkspace/contents.xcworkspacedata

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Workspace
+   version = "1.0">
+   <FileRef
+      location = "self:FileProvider.xcodeproj">
+   </FileRef>
+</Workspace>

FileProvider.xcodeproj/xcshareddata/xcschemes/FileProvider OSX.xcscheme

@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "0810"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "799396741D48B80D00086753"
+               BuildableName = "FileProvider.framework"
+               BlueprintName = "FileProvider OSX"
+               ReferencedContainer = "container:FileProvider.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+      </Testables>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "799396741D48B80D00086753"
+            BuildableName = "FileProvider.framework"
+            BlueprintName = "FileProvider OSX"
+            ReferencedContainer = "container:FileProvider.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "799396741D48B80D00086753"
+            BuildableName = "FileProvider.framework"
+            BlueprintName = "FileProvider OSX"
+            ReferencedContainer = "container:FileProvider.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

FileProvider.xcodeproj/xcshareddata/xcschemes/FileProvider iOS.xcscheme

@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "0810"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "799396661D48B7F600086753"
+               BuildableName = "FileProvider.framework"
+               BlueprintName = "FileProvider iOS"
+               ReferencedContainer = "container:FileProvider.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+      </Testables>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "799396661D48B7F600086753"
+            BuildableName = "FileProvider.framework"
+            BlueprintName = "FileProvider iOS"
+            ReferencedContainer = "container:FileProvider.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "799396661D48B7F600086753"
+            BuildableName = "FileProvider.framework"
+            BlueprintName = "FileProvider iOS"
+            ReferencedContainer = "container:FileProvider.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

FileProvider.xcodeproj/xcshareddata/xcschemes/FileProvider tvOS.xcscheme

@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "0810"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "799396811D48B82700086753"
+               BuildableName = "FileProvider.framework"
+               BlueprintName = "FileProvider tvOS"
+               ReferencedContainer = "container:FileProvider.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+      </Testables>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "799396811D48B82700086753"
+            BuildableName = "FileProvider.framework"
+            BlueprintName = "FileProvider tvOS"
+            ReferencedContainer = "container:FileProvider.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "799396811D48B82700086753"
+            BuildableName = "FileProvider.framework"
+            BlueprintName = "FileProvider tvOS"
+            ReferencedContainer = "container:FileProvider.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2016 Amir Abbas Mousavian
+Copyright (c) 2016-17 Amir Abbas Mousavian
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

Package.swift

@@ -0,0 +1,5 @@
+import PackageDescription
+
+let package = Package(
+    name: "FileProvider"
+)

Pod/Info-MacOS.plist

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>FMWK</string>
+	<key>CFBundleShortVersionString</key>
+	<string>${BUNDLE_VERSION_STRING}</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleVersion</key>
+	<string>$(CURRENT_PROJECT_VERSION)</string>
+	<key>NSPrincipalClass</key>
+	<string></string>
+</dict>
+</plist>

Pod/Info-iOS.plist

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>FMWK</string>
+	<key>CFBundleShortVersionString</key>
+	<string>${BUNDLE_VERSION_STRING}</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleVersion</key>
+	<string>$(CURRENT_PROJECT_VERSION)</string>
+	<key>NSPrincipalClass</key>
+	<string></string>
+</dict>
+</plist>

Pod/Info-tvOS.plist

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>FMWK</string>
+	<key>CFBundleShortVersionString</key>
+	<string>${BUNDLE_VERSION_STRING}</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleVersion</key>
+	<string>$(CURRENT_PROJECT_VERSION)</string>
+	<key>NSPrincipalClass</key>
+	<string></string>
+</dict>
+</plist>

README.md

@@ -1,64 +1,99 @@
-# FileProvider (experimental)
+![File Provider](fileprovider.png)
 
 >This Swift library provide a swifty way to deal with local and remote files and directories in a unified way.
 
 [![Swift Version][swift-image]][swift-url]
+[![Platform][platform-image]](#)
 [![License][license-image]][license-url]
-[![Platform](https://img.shields.io/badge/Platform-iOS%2C%20OSX-lightgray.svg)]()
-[![CocoaPods Compatible](https://img.shields.io/cocoapods/v/FileProvider.svg)](https://img.shields.io/cocoapods/v/FileProvider.svg)
-[![codebeat badge][codebeat-image]][codebeat-url]
+
+[![Release versin][release-image]][release-url]
+[![CocoaPods version](https://img.shields.io/cocoapods/v/FileProvider.svg)][cocoapods]
+[![Carthage compatible][carthage-image]](https://github.com/Carthage/Carthage)
+
+[![Build Status][travis-image]][travis-url]
+[![Codebeat Badge][codebeat-image]][codebeat-url]
+[![Cocoapods Docs][docs-image]][docs-url]
+[![Cocoapods Downloads][cocoapods-downloads]][cocoapods]
+[![Cocoapods Apps][cocoapods-apps]][cocoapods]
 
 <!--- 
-[![Build Status][travis-image]][travis-url]
-[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage) 
+[![codecov](https://codecov.io/gh/amosavian/FileProvider/branch/master/graph/badge.svg)](https://codecov.io/gh/amosavian/FileProvider) 
 ---> 
 
-This library provides implementaion of WebDav and SMB/CIFS (incomplete) and local files.
+This library provides implementaion of WebDav, Dropbox, OneDrive and SMB2 (incomplete) and local files.
 
 All functions are async calls and it wont block your main thread.
 
-Local and WebDAV providers are fully tested and can be used in production environment.
-
 ## Features
 
-- [x] **LocalFileProvider** a wrapper around `NSFileManager` with some additions like searching and reading a portion of file.
-- [x] **WebDAVFileProvider** WebDAV protocol is usual file transmission system on Macs.
-- [ ] **SMBFileProvider** SMB/CIFS and SMB2/3 are file and printer sharing protocol which is originated from IBM & Microsoft and SMB2/3 is now replacing AFP protocol on MacOS. I implemented data types and some basic functions but *main interface is not implemented yet!*
-- [ ] **DropboxFileProvider**
-- [ ] **FTPFileProvider**
-- [ ] **AmazonS3FileProvider**
+- [x] **LocalFileProvider** a wrapper around `FileManager` with some additions like searching and reading a portion of file.
+- [x] **CloudFileProvider** A wrapper around app's ubiquitous container to iCloud Drive in iOS 8+ API.
+- [x] **WebDAVFileProvider** WebDAV protocol is defacto file transmission standard, replaced FTP.
+- [x] **DropboxFileProvider** A wrapper around Dropbox Web API.
+    * For now it has limitation in uploading files up to 150MB.
+- [x] **OneDriveFileProvider** A wrapper around OneDrive REST API, works with `onedrive.com` and compatible (business) servers.
+    * For now it has limitation in uploading files up to 100MB.
+- [ ] **GoogleFileProvider** A wrapper around Goodle Drive REST API.
+- [ ] **AmazonS3FileProvider** Amazon storage backend. Used by many sites.
+- [ ] **SMBFileProvider** SMB2/3 introduced in 2006, which is a file and printer sharing protocol originated from Microsoft Windows and now is replacing AFP protocol on macOS.
+    * Data types and some basic functions are implemented but *main interface is not implemented yet!*.
+    * SMB1/CIFS is deprecated and very tricky to be implemented.
+- [ ] **FTPFileProvider** while deprecated in 1990s, it's still in use on some Web hosts.
 
 ## Requirements
 
-- **Swift 2.2**
+- **Swift 3.0 +**
 - iOS 8.0 , OSX 10.10
-- XCode 7.3
+- XCode 8.0
+
+Legacy version is available in swift-2 branch
 
 ## Installation
 
 ### Cocoapods / Carthage / Swift Package Manager
 
-FileProvider supports both CocoaPods. 
-
 Add this line to your pods file:
 
-	pod "FileProvider"
+```ruby
+pod "FileProvider"
+```
+
+Or add this to Cartfile:
+
+```
+github "amosavian/FileProvider"
+```
+
+Or to use in Swift Package Manager add this line in `Dependencies`:
+
+```swift
+.Package(url: "https://github.com/amosavian/FileProvider.git", majorVersion: 0, minorVersion: 12)
+```
+
+### Manually
 
-### Git
 To have latest updates with ease, use this command on terminal to get a clone:
 
-	git clone https://github.com/amosavian/FileProvider FileProvider
-	
+```bash
+git clone https://github.com/amosavian/FileProvider
+```
+
 You can update your library using this command in FileProvider folder:
 
-	git pull
+```bash
+git pull
+```
 
 if you have a git based project, use this command in your projects directory to add this project as a submodule to your project:
 
-	git submodule add https://github.com/amosavian/FileProvider FileProvider
+```bash
+git submodule add https://github.com/amosavian/FileProvider
+```
+Then you can do either:
 
-### Manually
-Copy Source folder to your project and Voila!
+* Copy Source folder to your project and Voila!
+
+* Drop `FileProvider.xcodeproj` to you Xcode workspace and add the framework to your Embeded Binaries in target.
 
 ## Usage
 
@@ -68,69 +103,94 @@ Each provider has a specific class which conforms to FileProvider protocol and s
 
 For LocalFileProvider if you want to deal with `Documents` folder
 
-	let documentsProvider = LocalFileProvider()
+```	swift
+let documentsProvider = LocalFileProvider()
 
-is equal to:
-	    
-	let documentPath = NSSearchPathForDirectoriesInDomains(NSSearchPathDirectory.DocumentDirectory, NSSearchPathDomainMask.UserDomainMask, true);
-	let documentsURL = NSURL(fileURLWithPath: documentPath);
-	let documentsProvider = LocalFileProvider(baseURL: documentsURL)
+// Equals with:
+let documentsProvider = LocalFileProvider(directory: .documentDirectory, domainMask: = .userDomainMask)
+
+// Equals with:
+let documentsURL = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first!
+let documentsProvider = LocalFileProvider(baseURL: documentsURL)
+```
+
+Also for using group shared container:
+
+```swift
+let documentsProvider = LocalFileProvider(sharedContainerId: "group.yourcompany.appContainer")
+// Replace your group identifier
+```
 
 You can't change the base url later. and all paths are related to this base url by default.
 
+To initialize an iCloud Container provider look at [here](https://medium.com/ios-os-x-development/icloud-drive-documents-1a46b5706fe1) to see how to update project settings then use below code, This will automatically manager creating Documents folder in container:
+
+```swift
+let documentsProvider = CloudFileProvider(containerId: nil)
+```
+
+
 For remote file providers authentication may be necessary:
 
-	let credential = NSURLCredential(user: "user", password: "pass", persistence: NSURLCredentialPersistence.Permanent)
-	let webdavProvider = WebDAVFileProvider(baseURL: "http://www.example.com/dav", credential: credential)
+```	swift
+let credential = URLCredential(user: "user", password: "pass", persistence: .permanent)
+let webdavProvider = WebDAVFileProvider(baseURL: URL(string: "http://www.example.com/dav")!, credential: credential)
+```
+
+* In case you want to connect non-secure servers for WebDAV (http) in iOS 9+ / macOS 10.11+ you should disable App Transport Security (ATS) according to [this guide.](https://gist.github.com/mlynch/284699d676fe9ed0abfa)
+
+* For Dropbox & OneDrive, user is clientID and password is Token which both must be retrieved via [OAuth2 API of Dropbox](https://www.dropbox.com/developers/reference/oauth-guide). There are libraries like [p2/OAuth2](https://github.com/p2/OAuth2) or [OAuthSwift](https://github.com/OAuthSwift/OAuthSwift) which can facilate the procedure to retrieve token. The latter is easier to use and prefered.
 	
 For interaction with UI, set delegate variable of `FileProvider` object
 
-You can use `absoluteURL()` method if provider to get direct access url (local or remote files) for some file systems which allows to do so (Dropbox doesn't support)
+You can use `url(of:)` method if provider to get direct access url (local or remote files) for some file systems which allows to do so (Dropbox doesn't support and returns path simply wrapped in URL)
 
 ### Delegates
 
 For updating User interface please consider using delegate method instead of completion handlers. Delegate methods are guaranteed to run in main thread to avoid bugs.
 
-It's simply tree method which indicated whether the operation failed, succeed and how much of operation has been done (suitable for uploading and downloading operations).
+It's simply three method which indicated whether the operation failed, succeed and how much of operation has been done (suitable for uploading and downloading operations).
 
 Your class should conforms `FileProviderDelegate` class:
 
-	override func viewDidLoad() {
-		documentsProvider.delegate = self
-	}
+```swift
+override func viewDidLoad() {
+	documentsProvider.delegate = self as FileProviderDelegate
+}
 	
-	func fileproviderSucceed(fileProvider: FileProvider, operation: FileOperation) {
-		switch operation {
-		case .Copy(source: let source, destination: let dest):
-			NSLog("\(source) copied to \(dest).")
-		case .Remove(path: let path):
-			NSLog("\(path) has been deleted.")
-		default:
-			break
-		}
-	}
-	
-    func fileproviderFailed(fileProvider: FileProvider, operation: FileOperation) {
-    	switch operation {
-		case .Copy(source: let source, destination: let dest):
-			NSLog("copy of \(source) failed.")
-		case .Remove(path: let path):
-			NSLog("\(path) can't be deleted.")
-		default:
-			break
-		}
-    }
-	
-    func fileproviderProgress(fileProvider: FileProvider, operation: FileOperation, progress: Float) {
-		switch operation {
-		case .Copy(source: let source, destination: let dest):
-			NSLog("Copy\(source) to \(dest): \(progress * 100) completed.")
-		default:
-			break
-		}
+func fileproviderSucceed(_ fileProvider: FileProviderOperations, operation: FileOperationType) {
+	switch operation {
+	case .copy(source: let source, destination: let dest):
+		print("\(source) copied to \(dest).")
+	case .remove(path: let path):
+		print("\(path) has been deleted.")
+	default:
+		print("\(operation.actionDescription) from \(operation.source!) to \(operation.destination) succeed")
 	}
+}
 
-**Note:** `fileproviderProgress()` delegate method is not called by `LocalFileProvider`. 
+func fileproviderFailed(_ fileProvider: FileProviderOperations, operation: FileOperationType) {
+    switch operation {
+	case .copy(source: let source, destination: let dest):
+		print("copy of \(source) failed.")
+	case .remove:
+		print("file can't be deleted.")
+	default:
+		print("\(operation.actionDescription) from \(operation.source!) to \(operation.destination) failed")
+	}
+}
+	
+func fileproviderProgress(_ fileProvider: FileProviderOperations, operation: FileOperationType, progress: Float) {
+	switch operation {
+	case .copy(source: let source, destination: let dest):
+		print("Copy\(source) to \(dest): \(progress * 100) completed.")
+	default:
+		break
+	}
+}
+```
+
+**Note:** `fileproviderProgress()` delegate method is not called by `LocalFileProvider` currently. 
 
 It's recommended to use completion handlers for error handling or result processing.
 
@@ -138,9 +198,9 @@ It's recommended to use completion handlers for error handling or result process
 
 You can also implement `FileOperationDelegate` protocol to control behaviour of file operation (copy, move/rename, remove and linking), and decide which files should be removed for example and which won't. 
 
-`fileProvider:shouldDoOperation:` method is called before doing a operation. You sould return `true` if you want to do operation or `false` if you want to stop that operation.
+`fileProvider(shouldDoOperation:)` method is called before doing a operation. You sould return `true` if you want to do operation or `false` if you want to stop that operation.
 
-`fileProvider:shouldProceedAfterError:operation:` will be called if an error occured during file operations. Return `true` if you want to continue operation on next files or `false` if you want stop operation further. Default value is false if you don't implement delegate.
+`fileProvider(shouldProceedAfterError:, operation:)` will be called if an error occured during file operations. Return `true` if you want to continue operation on next files or `false` if you want stop operation further. Default value is false if you don't implement delegate.
 
 **Note: these methods will be called for files in a directory and its subfolders recursively.**
 
@@ -150,123 +210,272 @@ There is a `FileObject` class which holds file attributes like size and creation
 
 For a single file:
 
-	documentsProvider.attributesOfItemAtPath(path: "/file.txt", completionHandler: {
-	    (attributes: LocalFileObject?, error: ErrorType?) -> Void} in
-		if let attributes = attributes {
-			print("File Size: \(attributes.size)")
-			print("Creation Date: \(attributes.createdDate)")
-			print("Modification Date: \(modifiedDate)")
-			print("Is Read Only: \(isReadOnly)")
-		}
-	)
+```swift
+documentsProvider.attributesOfItem(path: "/file.txt", completionHandler: {
+	attributes, error in
+	if let attributes = attributes {
+		print("File Size: \(attributes.size)")
+		print("Creation Date: \(attributes.creationDate)")
+		print("Modification Date: \(attributes.modifiedDate)")
+		print("Is Read Only: \(attributes.isReadOnly)")
+	}
+})
+```
 
 To get list of files in a directory:
 
-	documentsProvider.contentsOfDirectoryAtPath(path: "/", 	completionHandler: {
-	    (contents: [LocalFileObject], error: ErrorType?) -> Void} in
-		for file in contents {
-			print("Name: \(attributes.name)")
-			print("Size: \(attributes.size)")
-			print("Creation Date: \(attributes.createdDate)")
-			print("Modification Date: \(modifiedDate)")
-		}
-	)
+```swift
+documentsProvider.contentsOfDirectory(path: "/", completionHandler: {
+	contents, error in
+	for file in contents {
+		print("Name: \(attributes.name)")
+		print("Size: \(attributes.size)")
+		print("Creation Date: \(attributes.creationDate)")
+		print("Modification Date: \(attributes.modifiedDate)")
+	}
+})
+```
+
+To get size of strage and used/free space:
+
+```swift
+func storageProperties(completionHandler: { total, used in
+	print("Total Storage Space: \(total)")
+	print("Used Space: \(used)")
+	print("Free Space: \(total - used)")
+})
+```
+	
+* if this function is unavailable on provider or an error has been occurred, total space will be reported `-1` and used space `0`
 
 ### Change current directory
 
-	documentsProvider.currentPath = "/New Folder"
-	// now path is ~/Documents/New Folder
+```swift
+documentsProvider.currentPath = "/New Folder"
+// now path is ~/Documents/New Folder
+```
 	
-You can then pass "" (empty string) to contentsOfDirectoryAtPath method to list files in current directory.
+You can then pass "" (empty string) to `contentsOfDirectory` method to list files in current directory.
 
 ### Creating File and Folders
 
 Creating new directory:
 
-	documentsProvider.createFolder(folderName: "new folder", atPath: "/", completionHandler: nil)
+```swift
+documentsProvider.create(folder: "new folder", at: "/", completionHandler: { error in
+    if let error = error {
+        // Error handling here
+    } else {
+        // The operation succeed
+    }
+})
+```
 
-Creating new file from data stream:
+Creating new file from data:
 
-	let data = "hello world!".dataUsingEncoding(NSUTF8StringEncoding)
-	let file = FileObject(name: "old.txt", createdDate: NSDate(), modifiedDate: NSDate(), isHidden: false, isReadOnly: true)
-	documentsProvider.createFile(fileAttribs: file, atPath: "/", contents: data, completionHandler: nil)
+```swift
+let data = "hello world!".data(encoding: .utf8)
+documentsProvider.create(file: "newFile.txt", at: "/", contents: data, completionHandler: nil)
+```
 
 ### Copy and Move/Rename Files
 
 Copy file old.txt to new.txt in current path:
 
-	documentsProvider.copyItemAtPath(path: "new folder/old.txt", toPath: "new.txt", overwrite: false, completionHandler: nil)
+```swift
+documentsProvider.copyItem(path: "new folder/old.txt", to: "new.txt", overwrite: false, completionHandler: nil)
+```
 
 Move file old.txt to new.txt in current path:
 
-	documentsProvider.moveItemAtPath(path: "new folder/old.txt", toPath: "new.txt", overwrite: false, completionHandler: nil)
+```swift
+documentsProvider.moveItem(path: "new folder/old.txt", to: "new.txt", overwrite: false, completionHandler: nil)
+```
+
+**Note:** To have a consistent behavior, create intermediate directories first if necessary.
 
 ### Delete Files
 
-	documentsProvider.removeItemAtPath(path: "new.txt", completionHandler: nil)
+```swift
+documentsProvider.removeItem(path: "new.txt", completionHandler: nil)
+```
 
-***Caution:*** This method will delete directories with all it's content recursively.
+***Caution:*** This method will delete directories with all it's contents recursively.
 
-### Retrieve Content of File
+### Fetching Contents of File
 
-THere is two method for this purpose, one of them loads entire file into NSData and another can load a portion of file.
+There is two method for this purpose, one of them loads entire file into NSData and another can load a portion of file.
 
-	documentsProvider.contentsAtPath(path: "old.txt", completionHandler: {
-		(contents: NSData?, error: ErrorType?) -> Void
-		if let contents = contents {
-			print(String(data: contents, encoding: NSUTF8StringEncoding)) // "hello world!"
-		}
-	})
+```swift
+documentsProvider.contents(path: "old.txt", completionHandler: {
+	contents, error in
+	if let contents = contents {
+		print(String(data: contents, encoding: .utf8)) // "hello world!"
+	}
+})
+```
 	
-If you want to retrieve a portion of file you should can `contentsAtPath` method with offset and length arguments. Please note first byte of file has offset: 0.
+If you want to retrieve a portion of file you can use `contents` method with offset and length arguments. Please note first byte of file has offset: 0.
 
-	documentsProvider.contentsAtPath(path: "old.txt", offset: 2, length: 5, completionHandler: {
-		(contents: NSData?, error: ErrorType?) -> Void
-		if let contents = contents {
-			print(String(data: contents, encoding: NSUTF8StringEncoding)) // "llo w"
-		}
-	})
+```swift
+documentsProvider.contents(path: "old.txt", offset: 2, length: 5, completionHandler: {
+	contents, error in
+	if let contents = contents {
+		print(String(data: contents, encoding: .utf8)) // "llo w"
+	}
+})
+```
 
 ### Write Data To Files
 
-	let data = "What's up Newyork!".dataUsingEncoding(NSUTF8StringEncoding)
-	documentsProvider.writeContentsAtPath(path: "old.txt", contents data: data, atomically: true, completionHandler: nil)
+```swift
+let data = "What's up Newyork!".data(encoding: .utf8)
+documentsProvider.writeContents(path: "old.txt", content: data, atomically: true, completionHandler: nil)
+```
 
-### Monitoring FIle Changes
+### Undo Operations
+
+Providers conform to `FileProviderUndoable` can perform undo for **some** operations like moving/renaming, copying and creating (file or folder). **Now, only `LocalFileProvider` supports this feature.** To implement:
+
+```swift
+// To setup a new UndoManager:
+documentsProvider.setupUndoManager()
+// or if you have an UndoManager object already:
+documentsProvider.undoManager = self.undoManager
+
+// e.g.: To undo last operation manually:
+documentsProvider.undoManager?.undo()
+``` 
+
+You can also bind `UndoManager` object with view controller to use shake gesture and builtin undo support in iOS/macOS, add these code to your ViewController class like this sample code:
+
+```swift
+class ViewController: UIViewController
+    override var canBecomeFirstResponder: Bool {
+        return true
+    }
+    
+    override var undoManager: UndoManager? {
+        return (provider as? FileProvideUndoable)?.undoManager
+    }
+    
+    override func viewDidAppear(_ animated: Bool) {
+        super.viewDidAppear(animated)
+        // Your code here
+        UIApplication.shared.applicationSupportsShakeToEdit = true
+        self.becomeFirstResponder()
+    }
+    
+    override func viewWillDisappear(_ animated: Bool) {
+        super.viewWillDisappear(animated)
+        // Your code here
+        UIApplication.shared.applicationSupportsShakeToEdit = false
+        self.resignFirstResponder()
+    }
+    // The rest of your implementation
+}
+```
+
+### Operation Handle
+
+Creating/Copying/Deleting functions return a `OperationHandle` for remote operations. It provides operation type, progress and a `.cancel()` method which allows you to cancel operation in midst.
+
+It's not supported by native `(NS)FileManager` so `LocalFileProvider`, but this functionality will be added to future `PosixFileProvider` class.
+
+### Monitoring File Changes
 
 You can monitor updates in some file system (Local and SMB2), there is three methods in supporting provider you can use to register a handler, to unregister and to check whether it's being monitored or not. It's useful to find out when new files added or removed from directory and update user interface. The handler will be dispatched to main threads to avoid UI bugs with a 0.25 sec delay.
 
-	documentsProvider.registerNotifcation(provider.currentPath)
-	{
-		// calling functions to update UI 
-	}
+```swift
+// to register a new notification handler
+documentsProvider.registerNotifcation(path: provider.currentPath) {
+	// calling functions to update UI 
+}
 	
-	// To discontinue monitoring folders:
-	documentsProvider.unregisterNotifcation(provider.currentPath)
+// To discontinue monitoring folders:
+documentsProvider.unregisterNotifcation(path: provider.currentPath)
+```
 
 * **Please note** in LocalFileProvider it will also monitor changes in subfolders. This behaviour can varies according to file system specification.
 
+### Thumbnail and meta-information
+
+Providers which conform `ExtendedFileProvider` are able to generate thumbnail or provide file meta-information for images, media and pdf files.
+
+Local, OneDrive and Dropbox providers support this functionality.
+
+##### Thumbnails
+To check either file thumbnail is supported or not and fetch thumbnail, use (and modify) these example code:
+
+```swift
+let path = "/newImage.jpg"
+let thumbSize = CGSize(width: 64, height: 64)
+if documentsProvider.thumbnailOfFileSupported(path: path {
+    documentsProvider.thumbnailOfFile(path: file.path, dimension: thumbSize, completionHandler: { (image, error) in
+        DispatchQueue.main.async {
+            self.previewImage.image = image
+        }
+    }
+}
+```
+
+* Please note it won't cache generated images. if you don't do it yourself, it may hit you app's performance.
+
+##### Meta-informations
+
+To get meta-information like image/video taken date, location, dimension, etc., use (and modify) these example code:
+
+```swift
+if documentsProvider..propertiesOfFile(path: file.path, completionHandler: { (propertiesDictionary, keys, error) in
+    for key in keys {
+        print("\(key): \(propertiesDictionary[key])")
+    }
+}
+```
+
+* **Bonus:** You can modify/extend Local provider generator by setting `LocalFileInformationGenerator` static variables and methods
+
 ## Contribute
 
 We would love for you to contribute to **FileProvider**, check the `LICENSE` file for more info.
 
+Things to do:
+
+- [ ] Implement Test-case (XCTest)
+- [ ] Add Sample project for iOS
+- [ ] Add Sample project for macOS
+
+## Projects in use
+
+* [EDM - Browse and Receive Files](https://itunes.apple.com/us/app/edm-browse-and-receive-files/id948397575?ls=1&mt=8)
+* [File Manager - PDF Reader & Music Player](https://itunes.apple.com/us/app/file-manager-pdf-reader-music/id1017809685?ls=1&mt=8)
+
+If you used this library in your project, you can open an issue to inform us.
+
 ## Meta
 
-Amir-Abbas Mousavian  – [@amosavian](https://twitter.com/amosavian)
+Amir-Abbas Mousavian – [@amosavian](https://twitter.com/amosavian)
+
+Thanks to [Hootan Moradi](https://github.com/hoootan) for designing logo.
 
 Distributed under the MIT license. See `LICENSE` for more information.
 
-[https://github.com/yourname/github-link](https://github.com/dbader/)
+[https://github.com/amosavian/](https://github.com/amosavian/)
 
-[swift-image]:https://img.shields.io/badge/swift-2.2-green.svg
+[cocoapods]: https://cocoapods.org/pods/FileProvider
+[swift-image]: https://img.shields.io/badge/swift-3.0-orange.svg
 [swift-url]: https://swift.org/
-[license-image]: https://img.shields.io/badge/License-MIT-blue.svg
+[platform-image]: https://img.shields.io/cocoapods/p/FileProvider.svg
+[license-image]: https://img.shields.io/github/license/amosavian/FileProvider.svg
 [license-url]: LICENSE
 [codebeat-image]: https://codebeat.co/badges/7b359f48-78eb-4647-ab22-56262a827517
 [codebeat-url]: https://codebeat.co/projects/github-com-amosavian-fileprovider
-
-
-<!---
-[travis-image]: https://img.shields.io/travis/dbader/node-datadog-metrics/master.svg?style=flat-square
-[travis-url]: https://travis-ci.org/dbader/node-datadog-metrics
---->
+[travis-image]: https://img.shields.io/travis/amosavian/FileProvider/master.svg
+[travis-url]: https://travis-ci.org/amosavian/FileProvider
+[release-url]: https://github.com/amosavian/FileProvider/releases
+[release-image]: https://img.shields.io/github/release/amosavian/FileProvider.svg
+[carthage-image]: https://img.shields.io/badge/Carthage-compatible-4BC51D.svg
+[cocoapods-downloads]: https://img.shields.io/cocoapods/dt/FileProvider.svg
+[cocoapods-apps]: https://img.shields.io/cocoapods/at/FileProvider.svg
+[docs-image]: https://img.shields.io/cocoapods/metrics/doc-percent/FileProvider.svg
+[docs-url]: http://cocoadocs.org/docsets/FileProvider/

Source/AEXML.swift

@@ -1,492 +0,0 @@
-//
-// AEXML.swift
-//
-// Copyright (c) 2014 Marko Tadić <tadija@me.com> http://tadija.net
-//
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-//
-// The above copyright notice and this permission notice shall be included in all
-// copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-// SOFTWARE.
-//
-
-import Foundation
-
-// MARK: - AEXMLElement
-
-/**
-    This is base class for holding XML structure.
-
-    You can access its structure by using subscript like this: `element["foo"]["bar"]` which would
-    return `<bar></bar>` element from `<element><foo><bar></bar></foo></element>` XML as an `AEXMLElement` object.
-*/
-public class AEXMLElement {
-    
-    /// A type representing an error value that can be inside `error` property.
-    public enum Error: ErrorType {
-        case ElementNotFound
-        case RootElementMissing
-    }
-    
-    private struct Defaults {
-        static let name = String()
-        static let attributes = [String : String]()
-    }
-    
-    // MARK: Properties
-    
-    /// Every `AEXMLElement` should have its parent element instead of `AEXMLDocument` which parent is `nil`.
-    public private(set) weak var parent: AEXMLElement?
-    
-    /// Child XML elements.
-    public private(set) var children: [AEXMLElement] = [AEXMLElement]()
-    
-    /// XML Element name (defaults to empty string).
-    public var name: String
-    
-    /// XML Element value.
-    public var value: String?
-    
-    /// XML Element attributes (defaults to empty dictionary).
-    public var attributes: [String : String]
-    
-    /// Error value (`nil` if there is no error).
-    public var error: Error?
-    
-    /// String representation of `value` property (if `value` is `nil` this is empty String).
-    public var stringValue: String { return value ?? String() }
-    
-    /// Boolean representation of `value` property (if `value` is "true" or 1 this is `True`, otherwise `False`).
-    public var boolValue: Bool { return stringValue.lowercaseString == "true" || Int(stringValue) == 1 ? true : false }
-    
-    /// Integer representation of `value` property (this is **0** if `value` can't be represented as Integer).
-    public var intValue: Int { return Int(stringValue) ?? 0 }
-    
-    /// Double representation of `value` property (this is **0.00** if `value` can't be represented as Double).
-    public var doubleValue: Double { return (stringValue as NSString).doubleValue }
-    
-    // MARK: Lifecycle
-    
-    /**
-        Designated initializer - all parameters are optional.
-    
-        - parameter name: XML element name.
-        - parameter value: XML element value
-        - parameter attributes: XML element attributes
-    
-        - returns: An initialized `AEXMLElement` object.
-    */
-    public init(_ name: String? = nil, value: String? = nil, attributes: [String : String]? = nil) {
-        self.name = name ?? Defaults.name
-        self.value = value
-        self.attributes = attributes ?? Defaults.attributes
-    }
-    
-    // MARK: XML Read
-    
-    /// The first element with given name **(Empty element with error if not exists)**.
-    public subscript(key: String) -> AEXMLElement {
-        guard let
-            first = children.filter({ $0.name == key }).first
-        else {
-            let errorElement = AEXMLElement(key)
-            errorElement.error = Error.ElementNotFound
-            return errorElement
-        }
-        return first
-    }
-    
-    /// Returns all of the elements with equal name as `self` **(nil if not exists)**.
-    public var all: [AEXMLElement]? { return parent?.children.filter { $0.name == self.name } }
-    
-    /// Returns the first element with equal name as `self` **(nil if not exists)**.
-    public var first: AEXMLElement? { return all?.first }
-    
-    /// Returns the last element with equal name as `self` **(nil if not exists)**.
-    public var last: AEXMLElement? { return all?.last }
-    
-    /// Returns number of all elements with equal name as `self`.
-    public var count: Int { return all?.count ?? 0 }
-
-    private func allWithCondition(fulfillCondition: (element: AEXMLElement) -> Bool) -> [AEXMLElement]? {
-        var found = [AEXMLElement]()
-        if let elements = all {
-            for element in elements {
-                if fulfillCondition(element: element) {
-                    found.append(element)
-                }
-            }
-            return found.count > 0 ? found : nil
-        } else {
-            return nil
-        }
-    }
-    
-    /**
-        Returns all elements with given value.
-        
-        - parameter value: XML element value.
-        
-        - returns: Optional Array of found XML elements.
-    */
-    public func allWithValue(value: String) -> [AEXMLElement]? {
-        let found = allWithCondition { (element) -> Bool in
-            return element.value == value
-        }
-        return found
-    }
-    
-    /**
-        Returns all elements with given attributes.
-    
-        - parameter attributes: Dictionary of Keys and Values of attributes.
-    
-        - returns: Optional Array of found XML elements.
-    */
-    public func allWithAttributes(attributes: [String : String]) -> [AEXMLElement]? {
-        let found = allWithCondition { (element) -> Bool in
-            var countAttributes = 0
-            for (key, value) in attributes {
-                if element.attributes[key] == value {
-                    countAttributes += 1
-                }
-            }
-            return countAttributes == attributes.count
-        }
-        return found
-    }
-    
-    // MARK: XML Write
-    
-    /**
-        Adds child XML element to `self`.
-    
-        - parameter child: Child XML element to add.
-    
-        - returns: Child XML element with `self` as `parent`.
-    */
-    public func addChild(child: AEXMLElement) -> AEXMLElement {
-        child.parent = self
-        children.append(child)
-        return child
-    }
-    
-    /**
-        Adds child XML element to `self`.
-        
-        - parameter name: Child XML element name.
-        - parameter value: Child XML element value.
-        - parameter attributes: Child XML element attributes.
-        
-        - returns: Child XML element with `self` as `parent`.
-    */
-    public func addChild(name name: String, value: String? = nil, attributes: [String : String]? = nil) -> AEXMLElement {
-        let child = AEXMLElement(name, value: value, attributes: attributes)
-        return addChild(child)
-    }
-    
-    /// Removes `self` from `parent` XML element.
-    public func removeFromParent() {
-        parent?.removeChild(self)
-    }
-    
-    private func removeChild(child: AEXMLElement) {
-        if let childIndex = children.indexOf({ $0 === child }) {
-            children.removeAtIndex(childIndex)
-        }
-    }
-    
-    private var parentsCount: Int {
-        var count = 0
-        var element = self
-        while let parent = element.parent {
-            count += 1
-            element = parent
-        }
-        return count
-    }
-    
-    private func indentation(depth: Int) -> String {
-        var count = depth
-        var indent = String()
-        
-        while count > 0 {
-            indent += "\t"
-            count -= 1
-        }
-        
-        return indent
-    }
-    
-    /// Complete hierarchy of `self` and `children` in **XML** escaped and formatted String
-    public var xmlString: String {
-        var xml = String()
-        
-        // open element
-        xml += indentation(parentsCount - 1)
-        xml += "<\(name)"
-        
-        if attributes.count > 0 {
-            // insert attributes
-            for (key, value) in attributes {
-                xml += " \(key)=\"\(value.xmlEscaped)\""
-            }
-        }
-        
-        if value == nil && children.count == 0 {
-            // close element
-            xml += " />"
-        } else {
-            if children.count > 0 {
-                // add children
-                xml += ">\n"
-                for child in children {
-                    xml += "\(child.xmlString)\n"
-                }
-                // add indentation
-                xml += indentation(parentsCount - 1)
-                xml += "</\(name)>"
-            } else {
-                // insert string value and close element
-                xml += ">\(stringValue.xmlEscaped)</\(name)>"
-            }
-        }
-        
-        return xml
-    }
-    
-    /// Same as `xmlString` but without `\n` and `\t` characters
-    public var xmlStringCompact: String {
-        let chars = NSCharacterSet(charactersInString: "\n\t")
-        return xmlString.componentsSeparatedByCharactersInSet(chars).joinWithSeparator("")
-    }
-    
-}
-
-public extension String {
-    
-    /// String representation of self with XML special characters escaped.
-    public var xmlEscaped: String {
-        // we need to make sure "&" is escaped first. Not doing this may break escaping the other characters
-        var escaped = stringByReplacingOccurrencesOfString("&", withString: "&amp;", options: .LiteralSearch)
-        
-        // replace the other four special characters
-        let escapeChars = ["<" : "&lt;", ">" : "&gt;", "'" : "&apos;", "\"" : "&quot;"]
-        for (char, echar) in escapeChars {
-            escaped = escaped.stringByReplacingOccurrencesOfString(char, withString: echar, options: .LiteralSearch)
-        }
-        
-        return escaped
-    }
-    
-}
-
-// MARK: - AEXMLDocument
-
-/**
-    This class is inherited from `AEXMLElement` and has a few addons to represent **XML Document**.
-
-    XML Parsing is also done with this object.
-*/
-public class AEXMLDocument: AEXMLElement {
-    
-    private struct Defaults {
-        static let version = 1.0
-        static let encoding = "utf-8"
-        static let standalone = "no"
-        static let documentName = "AEXMLDocument"
-    }
-    
-    /// Default options used by NSXMLParser
-    public struct NSXMLParserOptions {
-        public var shouldProcessNamespaces = false
-        public var shouldReportNamespacePrefixes = false
-        public var shouldResolveExternalEntities = false
-        
-        public init() {}
-    }
-    
-    // MARK: Properties
-    
-    /// This is only used for XML Document header (default value is 1.0).
-    public let version: Double
-    
-    /// This is only used for XML Document header (default value is "utf-8").
-    public let encoding: String
-    
-    /// This is only used for XML Document header (default value is "no").
-    public let standalone: String
-    
-    /// Options for NSXMLParser (default values are `false`)
-    public let xmlParserOptions: NSXMLParserOptions
-    
-    /// Root (the first child element) element of XML Document **(Empty element with error if not exists)**.
-    public var root: AEXMLElement {
-        guard let rootElement = children.first else {
-            let errorElement = AEXMLElement()
-            errorElement.error = Error.RootElementMissing
-            return errorElement
-        }
-        return rootElement
-    }
-    
-    // MARK: Lifecycle
-    
-    /**
-        Designated initializer - Creates and returns XML Document object.
-    
-        - parameter version: Version value for XML Document header (defaults to 1.0).
-        - parameter encoding: Encoding value for XML Document header (defaults to "utf-8").
-        - parameter standalone: Standalone value for XML Document header (defaults to "no").
-        - parameter root: Root XML element for XML Document (defaults to `nil`).
-        - parameter xmlParserOptions: Options for NSXMLParser (defaults to `false` for all).
-    
-        - returns: An initialized XML Document object.
-    */
-    public init(version: Double = Defaults.version,
-                encoding: String = Defaults.encoding,
-                standalone: String = Defaults.standalone,
-                root: AEXMLElement? = nil,
-                xmlParserOptions: NSXMLParserOptions = NSXMLParserOptions())
-    {
-        // set document properties
-        self.version = version
-        self.encoding = encoding
-        self.standalone = standalone
-        self.xmlParserOptions = xmlParserOptions
-        
-        // init super with default name
-        super.init(Defaults.documentName)
-        
-        // document has no parent element
-        parent = nil
-        
-        // add root element to document (if any)
-        if let rootElement = root {
-            addChild(rootElement)
-        }
-    }
-    
-    /**
-        Convenience initializer - used for parsing XML data (by calling `loadXMLData:` internally).
-    
-        - parameter version: Version value for XML Document header (defaults to 1.0).
-        - parameter encoding: Encoding value for XML Document header (defaults to "utf-8").
-        - parameter standalone: Standalone value for XML Document header (defaults to "no").
-        - parameter xmlData: XML data to parse.
-        - parameter xmlParserOptions: Options for NSXMLParser (defaults to `false` for all).
-    
-        - returns: An initialized XML Document object containing parsed data. Throws error if data could not be parsed.
-    */
-    public convenience init(version: Double = Defaults.version,
-                            encoding: String = Defaults.encoding,
-                            standalone: String = Defaults.standalone,
-                            xmlData: NSData,
-                            xmlParserOptions: NSXMLParserOptions = NSXMLParserOptions()) throws
-    {
-        self.init(version: version, encoding: encoding, standalone: standalone, xmlParserOptions: xmlParserOptions)
-        try loadXMLData(xmlData)
-    }
-    
-    // MARK: Read XML
-    
-    /**
-        Creates instance of `AEXMLParser` (private class which is simple wrapper around `NSXMLParser`) 
-        and starts parsing the given XML data. Throws error if data could not be parsed.
-    
-        - parameter data: XML which should be parsed.
-    */
-    public func loadXMLData(data: NSData) throws {
-        children.removeAll(keepCapacity: false)
-        let xmlParser = AEXMLParser(xmlDocument: self, xmlData: data)
-        try xmlParser.parse()
-    }
-    
-    // MARK: Override
-    
-    /// Override of `xmlString` property of `AEXMLElement` - it just inserts XML Document header at the beginning.
-    public override var xmlString: String {
-        var xml =  "<?xml version=\"\(version)\" encoding=\"\(encoding)\" standalone=\"\(standalone)\"?>\n"
-        for child in children {
-            xml += child.xmlString
-        }
-        return xml
-    }
-    
-}
-
-// MARK: - AEXMLParser
-
-private class AEXMLParser: NSObject, NSXMLParserDelegate {
-    
-    // MARK: Properties
-    
-    let xmlDocument: AEXMLDocument
-    let xmlData: NSData
-    
-    var currentParent: AEXMLElement?
-    var currentElement: AEXMLElement?
-    var currentValue = String()
-    var parseError: NSError?
-    
-    // MARK: Lifecycle
-    
-    init(xmlDocument: AEXMLDocument, xmlData: NSData) {
-        self.xmlDocument = xmlDocument
-        self.xmlData = xmlData
-        currentParent = xmlDocument
-        super.init()
-    }
-    
-    // MARK: XML Parse
-    
-    func parse() throws {
-        let parser = NSXMLParser(data: xmlData)
-        parser.delegate = self
-        
-        parser.shouldProcessNamespaces = xmlDocument.xmlParserOptions.shouldProcessNamespaces
-        parser.shouldReportNamespacePrefixes = xmlDocument.xmlParserOptions.shouldReportNamespacePrefixes
-        parser.shouldResolveExternalEntities = xmlDocument.xmlParserOptions.shouldResolveExternalEntities
-        
-        let success = parser.parse()
-        if !success {
-            throw parseError ?? NSError(domain: "net.tadija.AEXML", code: 1, userInfo: nil)
-        }
-    }
-    
-    // MARK: NSXMLParserDelegate
-    
-    @objc func parser(parser: NSXMLParser, didStartElement elementName: String, namespaceURI: String?, qualifiedName qName: String?, attributes attributeDict: [String : String]) {
-        currentValue = String()
-        currentElement = currentParent?.addChild(name: elementName, attributes: attributeDict)
-        currentParent = currentElement
-    }
-    
-    @objc func parser(parser: NSXMLParser, foundCharacters string: String) {
-        currentValue += string
-        let newValue = currentValue.stringByTrimmingCharactersInSet(NSCharacterSet.whitespaceAndNewlineCharacterSet())
-        currentElement?.value = newValue == String() ? nil : newValue
-    }
-    
-    @objc func parser(parser: NSXMLParser, didEndElement elementName: String, namespaceURI: String?, qualifiedName qName: String?) {
-        currentParent = currentParent?.parent
-        currentElement = nil
-    }
-    
-    @objc func parser(parser: NSXMLParser, parseErrorOccurred parseError: NSError) {
-        self.parseError = parseError
-    }
-    
-}

Source/FileProvider.swift

@@ -1,332 +0,0 @@
-//
-//  FileProvider.swift
-//  FileProvider
-//
-//  Created by Amir Abbas Mousavian.
-//  Copyright © 2016 Mousavian. Distributed under MIT license.
-//
-
-import Foundation
-#if os(iOS)
-import UIKit
-public typealias ImageClass = UIImage
-#elseif os(OSX)
-import Cocoa
-public typealias ImageClass = NSImage
-#endif
-
-public enum FileType: String {
-    case Directory
-    case Regular
-    case SymbolicLink
-    case Socket
-    case CharacterSpecial
-    case BlockSpecial
-    case NamedPipe
-    case Unknown
-    
-    init(urlResourceTypeValue: String) {
-        switch urlResourceTypeValue {
-        case NSURLFileResourceTypeNamedPipe: self = .NamedPipe
-        case NSURLFileResourceTypeCharacterSpecial: self = .CharacterSpecial
-        case NSURLFileResourceTypeDirectory: self = .Directory
-        case NSURLFileResourceTypeBlockSpecial: self = .BlockSpecial
-        case NSURLFileResourceTypeRegular: self = .Regular
-        case NSURLFileResourceTypeSymbolicLink: self = .SymbolicLink
-        case NSURLFileResourceTypeSocket: self = .Socket
-        case NSURLFileResourceTypeUnknown: self = .Unknown
-        default: self = .Unknown
-        }
-    }
-    
-    init(fileTypeValue: String) {
-        switch fileTypeValue {
-        case NSFileTypeCharacterSpecial: self = .CharacterSpecial
-        case NSFileTypeDirectory: self = .Directory
-        case NSFileTypeBlockSpecial: self = .BlockSpecial
-        case NSFileTypeRegular: self = .Regular
-        case NSFileTypeSymbolicLink: self = .SymbolicLink
-        case NSFileTypeSocket: self = .Socket
-        case NSFileTypeUnknown: self = .Unknown
-        default: self = .Unknown
-        }
-    }
-}
-
-protocol FoundationErrorEnum {
-    init? (rawValue: Int)
-    var rawValue: Int { get }
-}
-
-extension NSURLError: FoundationErrorEnum {}
-extension NSCocoaError: FoundationErrorEnum {}
-
-public class FileObject {
-    let absoluteURL: NSURL?
-    let name: String
-    let path: String
-    let size: Int64
-    let createdDate: NSDate?
-    let modifiedDate: NSDate?
-    let fileType: FileType
-    let isHidden: Bool
-    let isReadOnly: Bool
-    
-    init(absoluteURL: NSURL?, name: String, path: String, size: Int64, createdDate: NSDate?, modifiedDate: NSDate?, fileType: FileType, isHidden: Bool, isReadOnly: Bool) {
-        self.absoluteURL = absoluteURL
-        self.name = name
-        self.path = path
-        self.size = size
-        self.createdDate = createdDate
-        self.modifiedDate = modifiedDate
-        self.fileType = fileType
-        self.isHidden = isHidden
-        self.isReadOnly = isReadOnly
-    }
-    
-    init(name: String, path: String, createdDate: NSDate?, modifiedDate: NSDate?, isHidden: Bool, isReadOnly: Bool) {
-        self.absoluteURL = nil
-        self.name = name
-        self.path = path
-        self.size = -1
-        self.createdDate = createdDate
-        self.modifiedDate = modifiedDate
-        self.fileType = .Regular
-        self.isHidden = isHidden
-        self.isReadOnly = isReadOnly
-    }
-    
-    var isDirectory: Bool {
-        return self.fileType == .Directory
-    }
-    
-    var isSymLink: Bool {
-        return self.fileType == .SymbolicLink
-    }
-}
-
-
-public typealias SimpleCompletionHandler = ((error: ErrorType?) -> Void)?
-
-public protocol FileProviderBasic: class {
-    var type: String { get }
-    var isPathRelative: Bool { get }
-    var baseURL: NSURL? { get }
-    var currentPath: String { get set }
-    var dispatch_queue: dispatch_queue_t { get set }
-    var delegate: FileProviderDelegate? { get set }
-    var credential: NSURLCredential? { get }
-    
-    /**
-     *
-    */
-    func contentsOfDirectoryAtPath(path: String, completionHandler: ((contents: [FileObject], error: ErrorType?) -> Void))
-    func attributesOfItemAtPath(path: String, completionHandler: ((attributes: FileObject?, error: ErrorType?) -> Void))
-}
-
-public protocol FileProviderOperations: FileProviderBasic {
-    var fileOperationDelegate : FileOperationDelegate? { get set }
-    
-    func createFolder(folderName: String, atPath: String, completionHandler: SimpleCompletionHandler)
-    func createFile(fileAttribs: FileObject, atPath: String, contents data: NSData?, completionHandler: SimpleCompletionHandler)
-    func moveItemAtPath(path: String, toPath: String, overwrite: Bool, completionHandler: SimpleCompletionHandler)
-    func copyItemAtPath(path: String, toPath: String, overwrite: Bool, completionHandler: SimpleCompletionHandler)
-    func removeItemAtPath(path: String, completionHandler: SimpleCompletionHandler)
-    
-    func copyLocalFileToPath(localFile: NSURL, toPath: String, completionHandler: SimpleCompletionHandler)
-    func copyPathToLocalFile(path: String, toLocalURL: NSURL, completionHandler: SimpleCompletionHandler)
-}
-
-public protocol FileProviderReadWrite: FileProviderBasic {
-    func contentsAtPath(path: String, completionHandler: ((contents: NSData?, error: ErrorType?) -> Void))
-    func contentsAtPath(path: String, offset: Int64, length: Int, completionHandler: ((contents: NSData?, error: ErrorType?) -> Void))
-    func writeContentsAtPath(path: String, contents data: NSData, atomically: Bool, completionHandler: SimpleCompletionHandler)
-    
-    func searchFilesAtPath(path: String, recursive: Bool, query: String, foundItemHandler: ((FileObject) -> Void)?, completionHandler: ((files: [FileObject], error: ErrorType?) -> Void))
-}
-
-public protocol FileProviderMonitor: FileProviderBasic {
-    func registerNotifcation(path: String, eventHandler: (() -> Void))
-    func unregisterNotifcation(path: String)
-    func isRegisteredForNotification(path: String) -> Bool
-}
-
-public protocol FileProvider: FileProviderBasic, FileProviderOperations, FileProviderReadWrite {
-    
-}
-
-extension FileProviderBasic {
-    var bareCurrentPath: String {
-        return currentPath.stringByTrimmingCharactersInSet(NSCharacterSet(charactersInString: ". /"))
-    }
-    
-    public func absoluteURL(path: String? = nil) -> NSURL {
-        let rpath: String
-        if let path = path {
-            rpath = path
-        } else {
-            rpath = self.currentPath
-        }
-        if isPathRelative, let baseURL = baseURL {
-            if rpath.hasPrefix("/") && baseURL.absoluteString.hasSuffix("/") {
-                var npath = rpath
-                npath.removeAtIndex(npath.startIndex)
-                return baseURL.URLByAppendingPathComponent(npath)
-            } else {
-                return baseURL.URLByAppendingPathComponent(rpath)
-            }
-        } else {
-            return NSURL(fileURLWithPath: rpath).URLByStandardizingPath!
-        }
-    }
-    
-    public func relativePathOf(url url: NSURL) -> String {
-        guard let baseURL = self.baseURL else { return url.absoluteString }
-        return url.URLByStandardizingPath!.absoluteString.stringByReplacingOccurrencesOfString(baseURL.absoluteString, withString: "/").stringByRemovingPercentEncoding!
-    }
-    
-    public func fileByUniqueName(filePath: String) -> String {
-        let fileUrl = NSURL(fileURLWithPath: filePath)
-        let dirPath = fileUrl.URLByDeletingLastPathComponent?.path ?? ""
-        guard let fileName = fileUrl.URLByDeletingPathExtension?.lastPathComponent else {
-            return filePath
-        }
-        let fileExt = fileUrl.pathExtension ?? ""
-        var result = fileName
-        let group = dispatch_group_create()
-        dispatch_group_enter(group)
-        self.contentsOfDirectoryAtPath(dirPath) { (contents, error) in
-            var bareFileName = fileName
-            let number = Int(fileName.componentsSeparatedByString(" ").filter {
-                !$0.stringByTrimmingCharactersInSet(NSCharacterSet.whitespaceAndNewlineCharacterSet()).isEmpty
-                }.last ?? "noname")
-            if let _ = number {
-                result = fileName.componentsSeparatedByString(" ").filter {
-                    !$0.stringByTrimmingCharactersInSet(NSCharacterSet.whitespaceAndNewlineCharacterSet()).isEmpty
-                    }.dropLast().joinWithSeparator(" ")
-                bareFileName = result
-            }
-            var i = number ?? 2
-            let similiar = contents.map {
-                $0.absoluteURL?.lastPathComponent ?? $0.name
-            }.filter {
-                $0.hasPrefix(result) && (!fileExt.isEmpty && $0.hasSuffix("." + fileExt))
-            }
-            while similiar.contains(result + (!fileExt.isEmpty ? "." + fileExt : "")) {
-                result = "\(bareFileName) \(i)"
-                i += 1
-            }
-            dispatch_group_leave(group)
-        }
-        dispatch_group_wait(group, DISPATCH_TIME_FOREVER)
-        let finalFile = result + (!fileExt.isEmpty ? "." + fileExt : "")
-        return (dirPath as NSString).stringByAppendingPathComponent(finalFile)
-    }
-    
-    internal func throwError(path: String, code: FoundationErrorEnum) -> NSError {
-        let fileURL = self.absoluteURL(path)
-        let domain: String
-        switch code {
-        case is NSURLError:
-            domain = NSURLErrorDomain
-        default:
-            domain = NSCocoaErrorDomain
-        }
-        return NSError(domain: domain, code: code.rawValue, userInfo: [NSURLErrorFailingURLErrorKey: fileURL, NSURLErrorFailingURLStringErrorKey: fileURL.absoluteString])
-    }
-    
-    internal func NotImplemented() {
-        assert(false, "method not implemented")
-    }
-    
-    internal func resolveRFCDate(httpDateString: String) -> NSDate? {
-        let dateFor: NSDateFormatter = NSDateFormatter()
-        dateFor.locale = NSLocale(localeIdentifier: "en_US")
-        dateFor.dateFormat = "EEE',' dd' 'MMM' 'yyyy HH':'mm':'ss zzz"
-        if let rfc1123 = dateFor.dateFromString(httpDateString) {
-            return rfc1123
-        }
-        dateFor.dateFormat = "EEEE',' dd'-'MMM'-'yy HH':'mm':'ss z"
-        if let rfc850 = dateFor.dateFromString(httpDateString) {
-            return rfc850
-        }
-        dateFor.dateFormat = "EEE MMM d HH':'mm':'ss yyyy"
-        if let asctime = dateFor.dateFromString(httpDateString) {
-            return asctime
-        }
-        //self.init()
-        return nil
-    }
-    
-    internal func jsonToDictionary(jsonString: String) -> [String: AnyObject]? {
-        guard let data = jsonString.dataUsingEncoding(NSUTF8StringEncoding) else {
-            return nil
-        }
-        if let dic = try? NSJSONSerialization.JSONObjectWithData(data, options: NSJSONReadingOptions()) as? [String: AnyObject] {
-            return dic
-        }
-        return nil
-    }
-    
-    internal func dictionaryToJSON(dictionary: [String: AnyObject]) -> String? {
-        if let data = try? NSJSONSerialization.dataWithJSONObject(dictionary, options: NSJSONWritingOptions()) {
-            return String(data: data, encoding: NSUTF8StringEncoding)
-        }
-        return nil
-    }
-}
-
-
-public protocol ExtendedFileProvider: FileProvider {
-    func thumbnailOfFileSupported(path: String) -> Bool
-    func propertiesOfFileSupported(path: String) -> Bool
-    func thumbnailOfFileAtPath(path: String, dimension: CGSize, completionHandler: ((image: ImageClass?, error: ErrorType?) -> Void))
-    func propertiesOfFileAtPath(path: String, completionHandler: ((propertiesDictionary: [String: AnyObject], keys: [String], error: ErrorType?) -> Void))
-}
-
-public enum FileOperation {
-    case Create (path: String)
-    case Copy   (source: String, destination: String)
-    case Move   (source: String, destination: String)
-    case Modify (path: String)
-    case Remove (path: String)
-    case Link   (link: String, target: String)
-    
-    var description: String {
-        switch self {
-        case .Create(path: _): return "Create"
-        case .Copy(source: _, destination: _): return "Copy"
-        case .Move(source: _, destination: _): return "Move"
-        case .Modify(path: _): return "Modify"
-        case .Remove(path: _): return "Remove"
-        case .Link(link: _, target: _): return "Link"
-        }
-    }
-    
-    var actionDescription: String {
-        switch self {
-        case .Create(path: _): return "Creating"
-        case .Copy(source: _, destination: _): return "Copying"
-        case .Move(source: _, destination: _): return "Moving"
-        case .Modify(path: _): return "Modifying"
-        case .Remove(path: _): return "Removing"
-        case .Link(link: _, target: _): return "Linking"
-        }
-    }
-    
-}
-
-public protocol FileProviderDelegate: class {
-    func fileproviderSucceed(fileProvider: FileProviderOperations, operation: FileOperation)
-    func fileproviderFailed(fileProvider: FileProviderOperations, operation: FileOperation)
-    func fileproviderProgress(fileProvider: FileProviderOperations, operation: FileOperation, progress: Float)
-}
-
-public protocol FileOperationDelegate: class {
-    
-    /// fileProvider(_:shouldOperate:) gives the delegate an opportunity to filter the file operation. Returning true from this method will allow the copy to happen. Returning false from this method causes the item in question to be skipped. If the item skipped was a directory, no children of that directory will be subject of the operation, nor will the delegate be notified of those children.
-    func fileProvider(fileProvider: FileProviderOperations, shouldDoOperation operation: FileOperation) -> Bool
-    
-    /// fileProvider:shouldProceedAfterError:copyingItemAtPath:toPath: gives the delegate an opportunity to recover from or continue copying after an error. If an error occurs, the error object will contain an ErrorType indicating the problem. The source path and destination paths are also provided. If this method returns true, the FileProvider instance will continue as if the error had not occurred. If this method returns false, the NSFileManager instance will stop copying, return false from copyItemAtPath:toPath:error: and the error will be provied there.
-    func fileProvider(fileProvider: FileProviderOperations, shouldProceedAfterError error: ErrorType, operation: FileOperation) -> Bool
-}

Source/LocalFileProvider.swift

@@ -1,492 +0,0 @@
-//
-//  LocalFileProvider.swift
-//  FileProvider
-//
-//  Created by Amir Abbas Mousavian.
-//  Copyright © 2016 Mousavian. Distributed under MIT license.
-//
-
-import Foundation
-
-public final class LocalFileObject: FileObject {
-    let allocatedSize: Int64
-    
-    init(absoluteURL: NSURL, name: String, path: String, size: Int64, allocatedSize: Int64, createdDate: NSDate?, modifiedDate: NSDate?, fileType: FileType, isHidden: Bool, isReadOnly: Bool) {
-        self.allocatedSize = allocatedSize
-        super.init(absoluteURL: absoluteURL, name: name, path: path, size: size, createdDate: createdDate, modifiedDate: modifiedDate, fileType: fileType, isHidden: isHidden, isReadOnly: isReadOnly)
-    }
-}
-
-public class LocalFileProvider: FileProvider, FileProviderMonitor {
-    public let type = "Local"
-    public var isPathRelative: Bool = true
-    public var baseURL: NSURL? = LocalFileProvider.defaultBaseURL()
-    public var currentPath: String = ""
-    public var dispatch_queue: dispatch_queue_t
-    public var operation_queue: dispatch_queue_t
-    public weak var delegate: FileProviderDelegate?
-    public let credential: NSURLCredential? = nil
-        
-    public let fileManager = NSFileManager()
-    public let opFileManager = NSFileManager()
-    private var fileProviderManagerDelegate: LocalFileProviderManagerDelegate? = nil
-    
-    init () {
-        dispatch_queue = dispatch_queue_create("FileProvider.\(type)", DISPATCH_QUEUE_CONCURRENT)
-        operation_queue = dispatch_queue_create("FileProvider.\(type).Operation", DISPATCH_QUEUE_SERIAL)
-        fileProviderManagerDelegate = LocalFileProviderManagerDelegate(provider: self)
-        opFileManager.delegate = fileProviderManagerDelegate
-    }
-    
-    init (baseURL: NSURL) {
-        self.baseURL = baseURL
-        dispatch_queue = dispatch_queue_create("FileProvider.\(type)", DISPATCH_QUEUE_CONCURRENT)
-        operation_queue = dispatch_queue_create("FileProvider.\(type).Operation", DISPATCH_QUEUE_SERIAL)
-        fileProviderManagerDelegate = LocalFileProviderManagerDelegate(provider: self)
-        opFileManager.delegate = fileProviderManagerDelegate
-    }
-    
-    private static func defaultBaseURL() -> NSURL {
-        let paths = NSSearchPathForDirectoriesInDomains(NSSearchPathDirectory.DocumentDirectory, NSSearchPathDomainMask.UserDomainMask, true);
-        return NSURL(fileURLWithPath: paths[0])
-    }
-    
-    public func contentsOfDirectoryAtPath(path: String, completionHandler: ((contents: [FileObject], error: ErrorType?) -> Void)) {
-        dispatch_async(dispatch_queue) {
-            do {
-                let contents = try self.fileManager.contentsOfDirectoryAtURL(self.absoluteURL(path), includingPropertiesForKeys: [NSURLNameKey, NSURLFileSizeKey, NSURLFileAllocatedSizeKey, NSURLCreationDateKey, NSURLContentModificationDateKey, NSURLIsHiddenKey, NSURLVolumeIsReadOnlyKey, NSFileGroupOwnerAccountName], options: NSDirectoryEnumerationOptions.SkipsSubdirectoryDescendants)
-                let filesAttributes = contents.map({ (fileURL) -> LocalFileObject in
-                    return self.attributesOfItemAtURL(fileURL)
-                })
-                completionHandler(contents: filesAttributes, error: nil)
-            } catch let e as NSError {
-                completionHandler(contents: [], error: e)
-            }
-        }
-    }
-    
-    internal func attributesOfItemAtURL(fileURL: NSURL) -> LocalFileObject {
-        var namev, sizev, allocated, filetypev, creationDatev, modifiedDatev, hiddenv, readonlyv: AnyObject?
-        _ = try? fileURL.getResourceValue(&namev, forKey: NSURLNameKey)
-        _ = try? fileURL.getResourceValue(&sizev, forKey: NSURLFileSizeKey)
-        _ = try? fileURL.getResourceValue(&allocated, forKey: NSURLFileAllocatedSizeKey)
-        _ = try? fileURL.getResourceValue(&creationDatev, forKey: NSURLCreationDateKey)
-        _ = try? fileURL.getResourceValue(&modifiedDatev, forKey: NSURLContentModificationDateKey)
-        _ = try? fileURL.getResourceValue(&filetypev, forKey: NSURLFileResourceTypeKey)
-        _ = try? fileURL.getResourceValue(&hiddenv, forKey: NSURLIsHiddenKey)
-        _ = try? fileURL.getResourceValue(&readonlyv, forKey: NSURLVolumeIsReadOnlyKey)
-        let path: String
-        if isPathRelative {
-            path = self.relativePathOf(url: fileURL)
-        } else {
-            path = fileURL.path!
-        }
-        let fileAttr = LocalFileObject(absoluteURL: fileURL, name: namev as! String, path: path, size: sizev?.longLongValue ?? -1, allocatedSize: allocated?.longLongValue ?? -1, createdDate: creationDatev as? NSDate, modifiedDate: modifiedDatev as? NSDate, fileType: FileType(urlResourceTypeValue: filetypev as? String ?? ""), isHidden: hiddenv?.boolValue ?? false, isReadOnly: readonlyv?.boolValue ?? false)
-        return fileAttr
-    }
-    
-    public func attributesOfItemAtPath(path: String, completionHandler: ((attributes: FileObject?, error: ErrorType?) -> Void)) {
-        dispatch_async(dispatch_queue) {
-            completionHandler(attributes: self.attributesOfItemAtURL(self.absoluteURL(path)), error: nil)
-        }
-    }
-    
-    public weak var fileOperationDelegate : FileOperationDelegate?
-    
-    public func createFolder(folderName: String, atPath: String, completionHandler: SimpleCompletionHandler) {
-        dispatch_async(operation_queue) {
-            do {
-                try self.opFileManager.createDirectoryAtURL(self.absoluteURL(atPath).URLByAppendingPathComponent(folderName), withIntermediateDirectories: true, attributes: [:])
-                completionHandler?(error: nil)
-                dispatch_async(dispatch_get_main_queue(), {
-                    self.delegate?.fileproviderSucceed(self, operation: .Create(path: (atPath as NSString).stringByAppendingPathComponent(folderName) + "/"))
-                })
-            } catch let e as NSError {
-                completionHandler?(error: e)
-                dispatch_async(dispatch_get_main_queue(), {
-                    self.delegate?.fileproviderFailed(self, operation: .Create(path: (atPath as NSString).stringByAppendingPathComponent(folderName) + "/"))
-                })
-            }
-        }
-    }
-    
-    public func createFile(fileAttribs: FileObject, atPath: String, contents data: NSData?, completionHandler: SimpleCompletionHandler) {
-        dispatch_async(operation_queue) {
-            let fileURL = self.absoluteURL(atPath).URLByAppendingPathComponent(fileAttribs.name)
-            var attributes = [String : AnyObject]()
-            if let createdDate = fileAttribs.createdDate {
-                attributes[NSFileCreationDate] = createdDate
-            }
-            if let modDate = fileAttribs.modifiedDate {
-                attributes[NSFileModificationDate] = modDate
-            }
-            if fileAttribs.isReadOnly {
-                attributes[NSFilePosixPermissions] = NSNumber(short: 365 /*555 o*/)
-            }
-            let success = self.opFileManager.createFileAtPath(fileURL.path!, contents: data, attributes: attributes)
-            if success {
-                do {
-                    try fileURL.setResourceValue(fileAttribs.isHidden, forKey: NSURLIsHiddenKey)
-                } catch _ {}
-                completionHandler?(error: nil)
-                dispatch_async(dispatch_get_main_queue(), {
-                    self.delegate?.fileproviderSucceed(self, operation: .Create(path: (atPath as NSString).stringByAppendingPathComponent(fileAttribs.name)))
-                })
-            } else {
-                completionHandler?(error: self.throwError(atPath, code: NSURLError.CannotCreateFile))
-                dispatch_async(dispatch_get_main_queue(), {
-                    self.delegate?.fileproviderFailed(self, operation: .Create(path: (atPath as NSString).stringByAppendingPathComponent(fileAttribs.name)))
-                })
-            }
-        }
-    }
-    
-    public func moveItemAtPath(path: String, toPath: String, overwrite: Bool = false, completionHandler: SimpleCompletionHandler) {
-        // FIXME: progress
-        dispatch_async(operation_queue) {
-            if !overwrite && self.fileManager.fileExistsAtPath(self.absoluteURL(toPath).path ?? "") {
-                completionHandler?(error: self.throwError(toPath, code: NSURLError.CannotMoveFile))
-                return
-            }
-            do {
-                try self.opFileManager.moveItemAtURL(self.absoluteURL(path), toURL: self.absoluteURL(toPath))
-                completionHandler?(error: nil)
-                dispatch_async(dispatch_get_main_queue(), {
-                    self.delegate?.fileproviderSucceed(self, operation: .Move(source: path, destination: toPath))
-                })
-            } catch let e as NSError {
-                completionHandler?(error: e)
-                dispatch_async(dispatch_get_main_queue(), {
-                    self.delegate?.fileproviderFailed(self, operation: .Move(source: path, destination: toPath))
-                })
-            }
-        }
-    }
-    
-    public func copyItemAtPath(path: String, toPath: String, overwrite: Bool = false, completionHandler: SimpleCompletionHandler) {
-        // FIXME: progress, for files > 100mb, monitor file by another thread, for dirs check copied items count
-        dispatch_async(operation_queue) {
-            if !overwrite && self.fileManager.fileExistsAtPath(self.absoluteURL(toPath).path ?? "") {
-                completionHandler?(error: self.throwError(toPath, code: NSURLError.CannotWriteToFile))
-                return
-            }
-            do {
-                try self.opFileManager.copyItemAtURL(self.absoluteURL(path), toURL: self.absoluteURL(toPath))
-                completionHandler?(error: nil)
-                dispatch_async(dispatch_get_main_queue(), {
-                    self.delegate?.fileproviderSucceed(self, operation: .Copy(source: path, destination: toPath))
-                })
-            } catch let e as NSError {
-                completionHandler?(error: e)
-                dispatch_async(dispatch_get_main_queue(), {
-                    self.delegate?.fileproviderFailed(self, operation: .Copy(source: path, destination: toPath))
-                })
-            }
-        }
-    }
-    
-    public func removeItemAtPath(path: String, completionHandler: SimpleCompletionHandler) {
-        dispatch_async(operation_queue) {
-            do {
-                try self.opFileManager.removeItemAtURL(self.absoluteURL(path))
-                completionHandler?(error: nil)
-                dispatch_async(dispatch_get_main_queue(), {
-                    self.delegate?.fileproviderSucceed(self, operation: .Remove(path: path))
-                })
-            } catch let e as NSError {
-                completionHandler?(error: e)
-                dispatch_async(dispatch_get_main_queue(), {
-                    self.delegate?.fileproviderFailed(self, operation: .Remove(path: path))
-                })
-            }
-        }
-    }
-    
-    public func copyLocalFileToPath(localFile: NSURL, toPath: String, completionHandler: SimpleCompletionHandler) {
-        dispatch_async(operation_queue) {
-            do {
-                try self.opFileManager.copyItemAtURL(localFile, toURL: self.absoluteURL(toPath))
-                completionHandler?(error: nil)
-                dispatch_async(dispatch_get_main_queue(), {
-                    self.delegate?.fileproviderSucceed(self, operation: .Copy(source: localFile.absoluteString, destination: toPath))
-                })
-            } catch let e as NSError {
-                completionHandler?(error: e)
-                dispatch_async(dispatch_get_main_queue(), {
-                    self.delegate?.fileproviderFailed(self, operation: .Copy(source: localFile.absoluteString, destination: toPath))
-                })
-            }
-        }
-    }
-    
-    public func copyPathToLocalFile(path: String, toLocalURL: NSURL, completionHandler: SimpleCompletionHandler) {
-        dispatch_async(operation_queue) {
-            do {
-                try self.opFileManager.copyItemAtURL(self.absoluteURL(path), toURL: toLocalURL)
-                completionHandler?(error: nil)
-                dispatch_async(dispatch_get_main_queue(), {
-                    self.delegate?.fileproviderSucceed(self, operation: .Copy(source: path, destination: toLocalURL.absoluteString))
-                })
-            } catch let e as NSError {
-                completionHandler?(error: e)
-                dispatch_async(dispatch_get_main_queue(), {
-                    self.delegate?.fileproviderFailed(self, operation: .Copy(source: path, destination: toLocalURL.absoluteString))
-                })
-            }
-        }
-    }
-    
-    public func contentsAtPath(path: String, completionHandler: ((contents: NSData?, error: ErrorType?) -> Void)) {
-        dispatch_async(dispatch_queue) {
-            let data = self.fileManager.contentsAtPath(self.absoluteURL(path).path!)
-            completionHandler(contents: data, error: nil)
-        }
-    }
-    
-    public func contentsAtPath(path: String, offset: Int64, length: Int, completionHandler: ((contents: NSData?, error: ErrorType?) -> Void)) {
-        // Unfortunatlely there is no method provided in NSFileManager to read a segment of file.
-        // So we have to fallback to POSIX provided methods
-        dispatch_async(dispatch_queue) {
-            let aPath = self.absoluteURL(path).path!
-            if self.attributesOfItemAtURL(self.absoluteURL(path)).isDirectory {
-                self.throwError(path, code: NSURLError.FileIsDirectory)
-            }
-            if !self.fileManager.fileExistsAtPath(aPath) {
-                self.throwError(path, code: NSURLError.FileDoesNotExist)
-            }
-            let fd_from = open(aPath, O_RDONLY)
-            if fd_from < 0 {
-                completionHandler(contents: nil, error: self.throwError(path, code: NSURLError.CannotOpenFile))
-            }
-            defer { precondition(close(fd_from) >= 0) }
-            lseek(fd_from, offset, SEEK_SET)
-            var buf = [UInt8](count: length, repeatedValue: 0)
-            let nread = read(fd_from, &buf, buf.count)
-            if nread < 0 { self.throwError(path, code: NSURLError.NoPermissionsToReadFile) }
-            if nread == 0 {
-                completionHandler(contents: nil, error: nil)
-            } else {
-                let data = NSData(bytesNoCopy: &buf, length: nread, freeWhenDone: true)
-                completionHandler(contents: data, error: nil)
-            }
-        }
-    }
-    
-    public func writeContentsAtPath(path: String, contents data: NSData, atomically: Bool, completionHandler: SimpleCompletionHandler) {
-        dispatch_async(operation_queue) {
-            data.writeToURL(self.absoluteURL(path), atomically: atomically)
-            dispatch_async(dispatch_get_main_queue(), {
-                self.delegate?.fileproviderSucceed(self, operation: .Modify(path: path))
-            })
-        }
-    }
-    
-    public func searchFilesAtPath(path: String, recursive: Bool, query: String, foundItemHandler: ((FileObject) -> Void)?, completionHandler: ((files: [FileObject], error: ErrorType?) -> Void)) {
-        dispatch_async(dispatch_queue) { 
-            let iterator = self.fileManager.enumeratorAtURL(self.absoluteURL(path), includingPropertiesForKeys: nil, options: recursive ? NSDirectoryEnumerationOptions() : .SkipsSubdirectoryDescendants) { (url, e) -> Bool in
-                completionHandler(files: [], error: e)
-                return true
-            }
-            var result = [LocalFileObject]()
-            while let fileURL = iterator?.nextObject() as? NSURL {
-                if fileURL.lastPathComponent?.lowercaseString.containsString(query.lowercaseString) ?? false {
-                    let fileObject = self.attributesOfItemAtURL(fileURL)
-                    result.append(self.attributesOfItemAtURL(fileURL))
-                    foundItemHandler?(fileObject)
-                }
-            }
-            completionHandler(files: result, error: nil)
-        }
-    }
-    
-    private var monitors = [LocalFolderMonitor]()
-    
-    public func registerNotifcation(path: String, eventHandler: (() -> Void)) {
-        self.unregisterNotifcation(path)
-        let absurl = self.absoluteURL(path)
-        var isdirv: AnyObject?
-        do {
-            try absurl.getResourceValue(&isdirv, forKey: NSURLIsDirectoryKey)
-        } catch _ {
-        }
-        if !(isdirv?.boolValue ?? false) {
-            return
-        }
-        let monitor = LocalFolderMonitor(url: absurl) {
-            eventHandler()
-        }
-        monitor.start()
-        monitors.append(monitor)
-    }
-    
-    public func unregisterNotifcation(path: String) {
-        var removedMonitor: LocalFolderMonitor?
-        for (i, monitor) in monitors.enumerate() {
-            if self.relativePathOf(url: monitor.url) == path {
-                removedMonitor = monitors.removeAtIndex(i)
-            }
-        }
-        removedMonitor?.stop()
-    }
-    
-    public func isRegisteredForNotification(path: String) -> Bool {
-        return monitors.map( { self.relativePathOf(url: $0.url) } ).contains(path)
-    }
-}
-
-extension LocalFileProvider {
-    public func createSymbolicLinkAtPath(path: String, withDestinationPath destPath: String, completionHandler: SimpleCompletionHandler) {
-        dispatch_async(operation_queue) {
-            do {
-                try self.opFileManager.createSymbolicLinkAtURL(self.absoluteURL(path), withDestinationURL: self.absoluteURL(destPath))
-                completionHandler?(error: nil)
-                dispatch_async(dispatch_get_main_queue(), {
-                    self.delegate?.fileproviderSucceed(self, operation: .Link(link: path, target: destPath))
-                })
-            } catch let e as NSError {
-                completionHandler?(error: e)
-                dispatch_async(dispatch_get_main_queue(), {
-                    self.delegate?.fileproviderFailed(self, operation: .Link(link: path, target: destPath))
-                })
-            }
-        }
-    }
-}
-
-class LocalFileProviderManagerDelegate: NSObject, NSFileManagerDelegate {
-    weak var provider: LocalFileProvider?
-    
-    init(provider: LocalFileProvider) {
-        self.provider = provider
-    }
-    
-    func fileManager(fileManager: NSFileManager, shouldCopyItemAtURL srcURL: NSURL, toURL dstURL: NSURL) -> Bool {
-        guard let provider = self.provider, delegate = provider.fileOperationDelegate else {
-            return true
-        }
-        let srcPath = provider.relativePathOf(url: srcURL)
-        let dstPath = provider.relativePathOf(url: dstURL)
-        return delegate.fileProvider(provider, shouldDoOperation: .Copy(source: srcPath, destination: dstPath))
-    }
-    
-    func fileManager(fileManager: NSFileManager, shouldMoveItemAtURL srcURL: NSURL, toURL dstURL: NSURL) -> Bool {
-        guard let provider = self.provider, delegate = provider.fileOperationDelegate else {
-            return true
-        }
-        let srcPath = provider.relativePathOf(url: srcURL)
-        let dstPath = provider.relativePathOf(url: dstURL)
-        return delegate.fileProvider(provider, shouldDoOperation: .Move(source: srcPath, destination: dstPath))
-    }
-    
-    func fileManager(fileManager: NSFileManager, shouldRemoveItemAtURL URL: NSURL) -> Bool {
-        guard let provider = self.provider, delegate = provider.fileOperationDelegate else {
-            return true
-        }
-        let path = provider.relativePathOf(url: URL)
-        return delegate.fileProvider(provider, shouldDoOperation: .Remove(path: path))
-    }
-    
-    func fileManager(fileManager: NSFileManager, shouldLinkItemAtURL srcURL: NSURL, toURL dstURL: NSURL) -> Bool {
-        guard let provider = self.provider, delegate = provider.fileOperationDelegate else {
-            return true
-        }
-        let srcPath = provider.relativePathOf(url: srcURL)
-        let dstPath = provider.relativePathOf(url: dstURL)
-        return delegate.fileProvider(provider, shouldDoOperation: .Link(link: srcPath, target: dstPath))
-    }
-    
-    func fileManager(fileManager: NSFileManager, shouldProceedAfterError error: NSError, copyingItemAtURL srcURL: NSURL, toURL dstURL: NSURL) -> Bool {
-        guard let provider = self.provider, delegate = provider.fileOperationDelegate else {
-            return false
-        }
-        let srcPath = provider.relativePathOf(url: srcURL)
-        let dstPath = provider.relativePathOf(url: dstURL)
-        return delegate.fileProvider(provider, shouldProceedAfterError: error, operation: .Copy(source: srcPath, destination: dstPath))
-    }
-    
-    func fileManager(fileManager: NSFileManager, shouldProceedAfterError error: NSError, movingItemAtURL srcURL: NSURL, toURL dstURL: NSURL) -> Bool {
-        guard let provider = self.provider, delegate = provider.fileOperationDelegate else {
-            return false
-        }
-        let srcPath = provider.relativePathOf(url: srcURL)
-        let dstPath = provider.relativePathOf(url: dstURL)
-        return delegate.fileProvider(provider, shouldProceedAfterError: error, operation: .Move(source: srcPath, destination: dstPath))
-    }
-    
-    func fileManager(fileManager: NSFileManager, shouldProceedAfterError error: NSError, removingItemAtURL URL: NSURL) -> Bool {
-        guard let provider = self.provider, delegate = provider.fileOperationDelegate else {
-            return false
-        }
-        let path = provider.relativePathOf(url: URL)
-        return delegate.fileProvider(provider, shouldProceedAfterError: error, operation: .Remove(path: path))
-    }
-    
-    func fileManager(fileManager: NSFileManager, shouldProceedAfterError error: NSError, linkingItemAtURL srcURL: NSURL, toURL dstURL: NSURL) -> Bool {
-        guard let provider = self.provider, delegate = provider.fileOperationDelegate else {
-            return false
-        }
-        let srcPath = provider.relativePathOf(url: srcURL)
-        let dstPath = provider.relativePathOf(url: dstURL)
-        return delegate.fileProvider(provider, shouldProceedAfterError: error, operation: .Link(link: srcPath, target: dstPath))
-    }
-}
-
-internal class LocalFolderMonitor {
-    private let source: dispatch_source_t
-    private let descriptor: CInt
-    private let qq: dispatch_queue_t = dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0)
-    private var state: Bool = false
-    private var monitoredTime: NSTimeInterval = NSDate().timeIntervalSinceReferenceDate
-    var url: NSURL
-    
-    /// Creates a folder monitor object with monitoring enabled.
-    init(url: NSURL, handler: ()->Void) {
-        self.url = url
-        descriptor = open(url.fileSystemRepresentation, O_EVTONLY)
-        
-        source = dispatch_source_create(
-            DISPATCH_SOURCE_TYPE_VNODE,
-            UInt(descriptor),
-            DISPATCH_VNODE_WRITE,
-            qq
-        )
-        // Folder monitoring is recursive and deep. Monitoring a root folder may be very costly
-        // We have a 0.2 second delay to ensure we wont call handler 1000s times when there is
-        // a huge file operation. This ensures app will work smoothly while this 250 milisec won't
-        // affect user experince much
-        let main_handler: ()->Void = {
-            if NSDate().timeIntervalSinceReferenceDate < self.monitoredTime + 0.2 {
-                return
-            }
-            self.monitoredTime = NSDate().timeIntervalSinceReferenceDate
-            dispatch_after(dispatch_time(DISPATCH_TIME_NOW, Int64(NSEC_PER_SEC) / 4), dispatch_get_main_queue(), {
-                handler()
-            })
-        }
-        dispatch_source_set_event_handler(source, main_handler)
-        dispatch_source_set_cancel_handler(source) {
-            close(self.descriptor)
-        }
-        start()
-    }
-    
-    /// Starts sending notifications if currently stopped
-    func start() {
-        if !state {
-            state = true
-            dispatch_resume(source)
-        }
-    }
-    
-    /// Stops sending notifications if currently enabled
-    func stop() {
-        if state {
-            state = false
-            dispatch_suspend(source)
-        }
-    }
-    
-    deinit {
-        dispatch_source_cancel(source)
-    }
-}

Source/SMBClient.swift

@@ -1,630 +0,0 @@
-//
-//  SMBTransmitter.swift
-//  FileProvider
-//
-//  Created by Amir Abbas Mousavian.
-//  Copyright © 2016 Mousavian. Distributed under MIT license.
-//
-
-import Foundation
-
-protocol SMBRequest {
-    func data() -> NSData
-}
-
-protocol SMBResponse {
-    init? (data: NSData)
-}
-
-internal func encode<T>(inout value: T) -> NSData {
-    return withUnsafePointer(&value) { p in
-        NSData(bytes: p, length: sizeofValue(value))
-    }
-}
-
-internal func decode<T>(data: NSData) -> T {
-    let pointer = UnsafeMutablePointer<T>.alloc(sizeof(T.Type))
-    data.getBytes(pointer, length: sizeof(T.Type))
-    
-    return pointer.move()
-}
-
-// This client implementation is for little-endian platform, namely x86, x64 & arm
-// For big-endian platforms like PowerPC, there must be a huge overhaul
-
-class SMBProtocolClient: TCPSocketClient {
-    var currentMessageID: UInt64 = 0
-    
-    func negotiateToSMB2() -> SMB2.NegotiateResponse? {
-        let smbHeader = SMB2.Header(command: .NEGOTIATE, creditRequestResponse: 126, messageId: messageId(), treeId: 0, sessionId: 0)
-        currentMessageID += 1
-        let negMessage = SMB2.NegotiateRequest(request: SMB2.NegotiateRequest.Header(capabilities: []))
-        SMBProtocolClient.createSMB2Message(smbHeader, message: negMessage)
-        do {
-            try self.send(data: nil)
-        } catch _ {
-            return nil
-        }
-        self.waitUntilResponse()
-        let response = try? SMBProtocolClient.digestSMB2Message(dataReceived)
-        return response??.message as? SMB2.NegotiateResponse
-    }
-    
-    func sessionSetupForSMB2() -> SMB2.SessionSetupResponse? {
-        return nil
-    }
-    
-    func messageId() -> UInt64 {
-        defer {
-            currentMessageID += 1
-        }
-        return currentMessageID
-    }
-    
-    // MARK: create and analyse messages
-    
-    class func determineSMBVersion(data: NSData) -> Float {
-        var smbverChar: Int8 = 0
-        data.getBytes(&smbverChar, length: 1)
-        let version = 0 - smbverChar
-        return Float(version)
-    }
-    
-    class func digestSMBMessage(data: NSData) throws -> (header: SMB1.Header, blocks: [(params: [UInt16], message: NSData?)]) {
-        guard data.length > 30 else {
-            throw NSURLError.BadServerResponse
-        }
-        var buffer = [UInt8](count: data.length, repeatedValue: 0)
-        guard determineSMBVersion(data) == 1 else {
-            throw SMBFileProviderError.IncompatibleHeader
-        }
-        let headersize = sizeof(SMB1.Header.self)
-        let header: SMB1.Header = decode(data)
-        var blocks = [(params: [UInt16], message: NSData?)]()
-        var offset = headersize
-        while offset < data.length {
-            let paramWords: [UInt16]
-            let paramWordsCount = Int(buffer[offset])
-            guard data.length > (paramWordsCount * 2 + offset) else {
-                throw SMBFileProviderError.IncorrectParamsLength
-            }
-            offset += sizeof(UInt8)
-            var rawParamWords = [UInt8](buffer[offset..<(offset + paramWordsCount * 2)])
-            let paramData = NSData(bytesNoCopy: &rawParamWords, length: rawParamWords.count)
-            paramWords = decode(paramData)
-            offset += paramWordsCount * 2
-            let messageBytesCountLittleEndian = [UInt8](buffer[offset...(offset + 1)])
-            let messageBytesCount = Int(UnsafePointer<UInt16>(messageBytesCountLittleEndian).memory)
-            offset += sizeof(UInt16)
-            guard data.length >= (offset + messageBytesCount) else {
-                throw SMBFileProviderError.IncorrectMessageLength
-            }
-            var rawMessage = [UInt8](buffer[offset..<(offset + messageBytesCount)])
-            offset += messageBytesCount
-            let message = NSData(bytes: &rawMessage, length: rawMessage.count)
-            blocks.append((params: paramWords, message: message))
-        }
-        return (header, blocks)
-    }
-    
-    class func digestSMB2Message(data: NSData) throws -> (header: SMB2.Header, message: SMBResponse?)? {
-        guard data.length > 65 else {
-            throw NSURLError.BadServerResponse
-        }
-        guard determineSMBVersion(data) == 2 else {
-            throw SMBFileProviderError.IncompatibleHeader
-        }
-        let headersize = sizeof(SMB2.Header.self)
-        let headerData = data.subdataWithRange(NSRange(location: 0, length: headersize))
-        let messageSize = data.length - headersize
-        let messageData = data.subdataWithRange(NSRange(location: headersize, length: messageSize))
-        let header: SMB2.Header = decode(headerData)
-        switch header.command {
-        case .NEGOTIATE:
-            return (header, SMB2.NegotiateResponse(data: messageData))
-        case .SESSION_SETUP:
-            return (header, SMB2.SessionSetupResponse(data: messageData))
-        case .LOGOFF:
-            return (header, SMB2.LogOff(data: messageData))
-        case .TREE_CONNECT:
-            return (header, SMB2.TreeConnectResponse(data: messageData))
-        case .TREE_DISCONNECT:
-            return (header, SMB2.TreeDisconnect(data: messageData))
-        case .CREATE:
-            return (header, SMB2.CreateResponse(data: messageData))
-        case .CLOSE:
-            return (header, SMB2.CloseResponse(data: messageData))
-        case .FLUSH:
-            return (header, SMB2.FlushResponse(data: messageData))
-        case .READ:
-            return (header, nil) // FIXME:
-        case .WRITE:
-            return (header, nil) // FIXME:
-        case .LOCK:
-            return (header, nil) // FIXME:
-        case .IOCTL:
-            return (header, nil)
-        case .CANCEL:
-            return (header, nil)
-        case .ECHO:
-            return (header, SMB2.Echo(data: messageData))
-        case .QUERY_DIRECTORY:
-            return (header, nil) // FIXME:
-        case .CHANGE_NOTIFY:
-            return (header, nil) // FIXME:
-        case .QUERY_INFO:
-            return (header, nil) // FIXME:
-        case .SET_INFO:
-            return (header, nil) // FIXME:
-        case .OPLOCK_BREAK:
-            return (header, nil) // FIXME:
-        case .INVALID:
-            throw SMBFileProviderError.InvalidCommand
-        }
-    }
-    
-    class func createSMBMessage(header: SMB1.Header, blocks: [(params: NSData?, message: NSData?)]) -> NSData {
-        var headerv = header
-        let result = NSMutableData(data: encode(&headerv))
-        for block in blocks {
-            var paramWordsCount = UInt8(block.params?.length ?? 0)
-            result.appendBytes(&paramWordsCount, length: sizeofValue(paramWordsCount))
-            if let params = block.params {
-                result.appendData(params)
-            }
-            var messageLen = UInt16(block.message?.length ?? 0)
-            result.appendBytes(&messageLen, length: sizeofValue(messageLen))
-            if let message = block.message {
-                result.appendData(message)
-            }
-        }
-        return result
-    }
-    
-    class func createSMB2Message(header: SMB2.Header, message: SMBRequest) -> NSData {
-        var headerv = header
-        let result = NSMutableData(data: encode(&headerv))
-        result.appendData(message.data())
-        return result
-    }
-}
-
-struct SMBTime {
-    var time: UInt64
-    
-    init(time: UInt64) {
-        self.time = time
-    }
-    
-    init(unixTime: UInt) {
-        self.time = (UInt64(unixTime) + 11644473600) * 10000000
-    }
-    
-    init(timeIntervalSince1970: NSTimeInterval) {
-        self.time = UInt64((timeIntervalSince1970 + 11644473600) * 10000000)
-    }
-    
-    init(date: NSDate) {
-        self.init(timeIntervalSince1970: date.timeIntervalSince1970)
-    }
-    
-    var unixTime: UInt {
-        return UInt(self.time / 10000000 - 11644473600)
-    }
-    
-    var date: NSDate {
-        return NSDate(timeIntervalSince1970: Double(self.time) / 10000000 - 11644473600)
-    }
-}
-
-protocol FileProviderSMBHeader {
-    var protocolID: UInt32 { get }
-    static var protocolConst: UInt32 { get }
-}
-
-// SMB/CIFS Types
-struct SMB1 {
-    struct Header { // 32 bytes
-        // header is always \u{ff}SMB
-        let protocolID: UInt32
-        static let protocolConst: UInt32 = 0x424d53ff
-        private var _command: UInt8
-        var command: Command {
-            get {
-                return Command(rawValue: _command) ?? .INVALID
-            }
-            set {
-                _command = newValue.rawValue
-            }
-        }
-        // error messages from the server to the client
-        private var _status: (UInt8, UInt8, UInt8, UInt8)
-        var error: (Class: UInt8, code: UInt16) {
-            get {
-                return (_status.0, UInt16(_status.2) + (UInt16(_status.3) << 8))
-            }
-            set {
-                _status = (newValue.Class, 0, UInt8(newValue.code & 0xff), UInt8(newValue.code >> 8))
-            }
-        }
-        var ntStatus: UInt32 {
-            get {
-                let statusLo = UInt32(_status.0) + UInt32(_status.1) << 8
-                let statusHi = UInt32(_status.2) + UInt32(_status.3) << 8
-                return statusHi << 16 + statusLo
-            }
-            set {
-                _status = (UInt8(newValue & 0xff), UInt8(newValue >> 8 & 0xff), UInt8(newValue >> 16 & 0xff), UInt8(newValue >> 24 & 0xff))
-            }
-        }
-        var flags: Flags
-        var flags2: Flags2
-        var pidHigh: UInt16
-        //  encryption key used for validating messages over connectionless transports
-        private var _securityKey: (UInt16, UInt16)
-        var securityKey: UInt32 {
-            get {
-                return UInt32(_securityKey.1) << 16 + UInt32(_securityKey.0)
-            }
-            set {
-                _securityKey = (UInt16(newValue & 0xffff), UInt16(newValue >> 16))
-            }
-        }
-        ///  Connection identifier
-        var securityCID: UInt16
-        ///  Identifier of the sequence of a message over connectionless transports
-        var securitySequenceNumber: UInt16
-        private var ununsed: UInt16
-        var treeId: UInt16
-        var pidLow: UInt16
-        var userId: UInt16
-        var multiplexId: UInt16
-        var pid: UInt32 {
-            get {
-                return UInt32(pidLow) + UInt32(pidHigh) << 16
-            }
-            set {
-                pidLow = UInt16(newValue & 0xffff)
-                pidHigh = UInt16(newValue >> 16)
-            }
-        }
-        
-        init(command: Command, ntStatus: UInt32 = 0, flags: Flags, flags2: Flags2 = [.LONG_NAMES, .ERR_STATUS, .UNICODE], securityKey: UInt32 = 0, securityCID: UInt16 = 0, securitySequenceNumber: UInt16 = 0, treeId: UInt16, pid: UInt32, userId: UInt16, multiplexId: UInt16) {
-            self.protocolID = Header.protocolConst
-            self._command = command.rawValue
-            _status = (UInt8(ntStatus & 0xff), UInt8(ntStatus >> 8 & 0xff), UInt8(ntStatus >> 16 & 0xff), UInt8(ntStatus >> 24 & 0xff))
-            self.flags = flags
-            self.flags2 = flags2
-            self._securityKey = (UInt16(securityKey & 0xffff), UInt16(securityKey >> 16))
-            self.securityCID = securityCID
-            self.securitySequenceNumber = securitySequenceNumber
-            self.ununsed = 0
-            self.treeId = treeId
-            self.pidLow = UInt16(pid & 0xffff)
-            self.pidHigh = UInt16(pid >> 16)
-            self.userId = userId
-            self.multiplexId = multiplexId
-        }
-    }
-    
-    struct Flags: OptionSetType {
-        let rawValue: UInt8
-        
-        init(rawValue: UInt8) {
-            self.rawValue = rawValue
-        }
-        /** This bit is set (1) in the NEGOTIATE (0x72) Response if the server supports
-         * LOCK_AND_READ (0x13) and WRITE_AND_UNLOCK (0x14) commands. */
-        static let LOCK_AND_READ_OK       = Flags(rawValue: 0x01)
-        static let BUF_AVAIL              = Flags(rawValue: 0x02)
-        static let CASE_INSENSITIVE       = Flags(rawValue: 0x08)
-        static let CANONICALIZED_PATHS    = Flags(rawValue: 0x10)
-        static let OPLOCK                 = Flags(rawValue: 0x20)
-        static let OPBATCH                = Flags(rawValue: 0x40)
-        /**  When on, this message is being sent from the server in response to a client request. */
-        static let REPLY                  = Flags(rawValue: 0x80)
-    }
-    
-    struct Flags2: OptionSetType {
-        let rawValue: UInt16
-        
-        init(rawValue: UInt16) {
-            self.rawValue = rawValue
-        }
-        /** Client: the message MAY contain long file names. */
-        static let LONG_NAMES             = Flags2(rawValue: 0x0001)
-        /** Client: the client is aware of extended attributes (EAs). */
-        static let EAS                    = Flags2(rawValue: 0x0002)
-        /** Client: the client is requesting signing (if signing is not yet active) or the message
-         * being sent is signed. This bit is used on the SMB header of an SESSION_SETUP_ANDX */
-        static let SMB_SECURITY_SIGNATURE = Flags2(rawValue: 0x0004)
-        ///  Reserved but not implemented.
-        static let IS_LONG_NAME           = Flags2(rawValue: 0x0040)
-        /** client aware of Extended Security negotiation */
-        static let EXT_SEC                = Flags2(rawValue:  0x0800)
-        /** any pathnames in this SMB SHOULD be resolved in the Distributed File System (DFS) */
-        static let DFS                    = Flags2(rawValue: 0x1000)
-        /**
-         * This flag is useful only on a read request. If the bit is set, then the client MAY read
-         * the file if the client does not have read permission but does have execute permission. */
-        static let PAGING_IO              = Flags2(rawValue:  0x2000) // READ_IF_EXECUTE
-        /**
-         * Client: the server MUST return errors as 32-bit NTSTATUS codes in the response
-         * Server: the Status field in the header is formatted as an NTSTATUS cod */
-        static let ERR_STATUS             = Flags2(rawValue: 0x4000)
-        /**
-         * Each field that contains a string in this SMB message MUST be encoded
-         * as an array of 16-bit Unicode characters */
-        static let UNICODE                = Flags2(rawValue: 0x8000)
-    }
-    
-    enum Command: UInt8 {
-        case CREATE_DIRECTORY       = 0x00
-        case DELETE_DIRECTORY       = 0x01
-        case OPEN                   = 0x02
-        case CREATE                 = 0x03
-        case CLOSE                  = 0x04
-        case FLUSH                  = 0x05
-        case DELETE                 = 0x06
-        case RENAME                 = 0x07
-        case QUERY_INFORMATION      = 0x08
-        case SET_INFORMATION        = 0x09
-        case READ                   = 0x0A
-        case WRITE                  = 0x0B
-        case LOCK_BYTE_RANGE        = 0x0C
-        case UNLOCK_BYTE_RANGE      = 0x0D
-        case CREATE_TEMPORARY       = 0x0E
-        case CREATE_NEW             = 0x0F
-        case CHECK_DIRECTORY        = 0x10
-        case PROCESS_EXIT           = 0x11
-        case SEEK                   = 0x12
-        case LOCK_AND_READ          = 0x13
-        case WRITE_AND_UNLOCK       = 0x14
-        case READ_RAW               = 0x1A
-        case READ_MPX               = 0x1B
-        case READ_MPX_SECONDARY     = 0x1C
-        case WRITE_RAW              = 0x1D
-        case WRITE_MPX              = 0x1E
-        case WRITE_COMPLETE         = 0x20
-        case SET_INFORMATION2       = 0x22
-        case QUERY_INFORMATION2     = 0x23
-        case LOCKING_ANDX           = 0x24
-        case TRANSACTION            = 0x25
-        case TRANSACTION_SECONDARY  = 0x26
-        case IOCTL                  = 0x27
-        case IOCTL_SECONDARY        = 0x28
-        case COPY                   = 0x29
-        case MOVE                   = 0x2A
-        case ECHO                   = 0x2B
-        case WRITE_AND_CLOSE        = 0x2C
-        case OPEN_ANDX              = 0x2D
-        case READ_ANDX              = 0x2E
-        case WRITE_ANDX             = 0x2F
-        case CLOSE_AND_TREE_DISC    = 0x31
-        case TRANSACTION2           = 0x32
-        case TRANSACTION2_SECONDARY = 0x33
-        case FIND_CLOSE2            = 0x34
-        case FIND_NOTIFY_CLOSE      = 0x35
-        case TREE_CONNECT           = 0x70
-        case TREE_DISCONNECT        = 0x71
-        case NEGOTIATE              = 0x72
-        case SESSION_SETUP_ANDX     = 0x73
-        case LOGOFF_ANDX            = 0x74
-        case TREE_CONNECT_ANDX      = 0x75
-        case QUERY_INFORMATION_DISK = 0x80
-        case SEARCH                 = 0x81
-        case FIND                   = 0x82
-        case FIND_UNIQUE            = 0x83
-        case NT_TRANSACT            = 0xA0
-        case NT_TRANSACT_SECONDARY  = 0xA1
-        case NT_CREATE_ANDX         = 0xA2
-        case NT_CANCEL              = 0xA4
-        case OPEN_PRINT_FILE        = 0xC0
-        case WRITE_PRINT_FILE       = 0xC1
-        case CLOSE_PRINT_FILE       = 0xC2
-        case GET_PRINT_QUEUE        = 0xC3
-        case READ_BULK              = 0xD8
-        case WRITE_BULK             = 0xD9
-        case WRITE_BULK_DATA        = 0xDA
-        case INVALID                = 0xFE
-    }
-}
-
-/// Error Types and Description
-
-enum NTStatus: UInt32, ErrorType, CustomStringConvertible {
-    case SUCCESS                        = 0x00000000
-    case NOT_IMPLEMENTED                = 0xC0000002
-    case INVALID_DEVICE_REQUEST         = 0xC0000010
-    case ILLEGAL_FUNCTION               = 0xC00000AF
-    case NO_SUCH_FILE                   = 0xC000000F
-    case NO_SUCH_DEVICE                 = 0xC000000E
-    case OBJECT_NAME_NOT_FOUND          = 0xC0000034
-    case OBJECT_PATH_INVALID            = 0xC0000039
-    case OBJECT_PATH_NOT_FOUND          = 0xC000003A
-    case OBJECT_PATH_SYNTAX_BAD         = 0xC000003B
-    case DFS_EXIT_PATH_FOUND            = 0xC000009B
-    case REDIRECTOR_NOT_STARTED         = 0xC00000FB
-    case TOO_MANY_OPENED_FILES          = 0xC000011F
-    case ACCESS_DENIED                  = 0xC0000022
-    case INVALID_LOCK_SEQUENCE          = 0xC000001E
-    case INVALID_VIEW_SIZE              = 0xC000001F
-    case ALREADY_COMMITTED              = 0xC0000021
-    case PORT_CONNECTION_REFUSED        = 0xC0000041
-    case THREAD_IS_TERMINATING          = 0xC000004B
-    case DELETE_PENDING                 = 0xC0000056
-    case PRIVILEGE_NOT_HELD             = 0xC0000061
-    case LOGON_FAILURE                  = 0xC000006D
-    case FILE_IS_A_DIRECTORY            = 0xC00000BA
-    case FILE_RENAMED                   = 0xC00000D5
-    case PROCESS_IS_TERMINATING         = 0xC000010A
-    case DIRECTORY_NOT_EMPTY            = 0xC0000101
-    case CANNOT_DELETE                  = 0xC0000121
-    case FILE_NOT_AVAILABLE             = 0xC0000467
-    case FILE_DELETED                   = 0xC0000123
-    case SMB_BAD_FID                    = 0x00060001
-    case INVALID_HANDLE                 = 0xC0000008
-    case OBJECT_TYPE_MISMATCH           = 0xC0000024
-    case PORT_DISCONNECTED              = 0xC0000037
-    case INVALID_PORT_HANDLE            = 0xC0000042
-    case FILE_CLOSED                    = 0xC0000128
-    case HANDLE_NOT_CLOSABLE            = 0xC0000235
-    case SECTION_TOO_BIG                = 0xC0000040
-    case TOO_MANY_PAGING_FILES          = 0xC0000097
-    case INSUFF_SERVER_RESOURCES        = 0xC0000205
-    case OS2_INVALID_ACCESS             = 0x000C0001
-    case ACCESS_DENIED_2                = 0xC00000CA
-    case DATA_ERROR                     = 0xC000009C
-    case NOT_SAME_DEVICE                = 0xC00000D4
-    case NO_MORE_FILES                  = 0x80000006
-    case NO_MORE_ENTRIES                = 0x8000001A
-    case UNSUCCESSFUL                   = 0xC0000001
-    case SHARING_VIOLATION              = 0xC0000043
-    case FILE_LOCK_CONFLICT             = 0xC0000054
-    case LOCK_NOT_GRANTED               = 0xC0000055
-    case END_OF_FILE                    = 0xC0000011
-    case NOT_SUPPORTED                  = 0xC00000BB
-    case OBJECT_NAME_COLLISION          = 0xC0000035
-    case INVALID_PARAMETER              = 0xC000000D
-    case OS2_INVALID_LEVEL              = 0x007C0001
-    case OS2_NEGATIVE_SEEK              = 0x00830001
-    case RANGE_NOT_LOCKED               = 0xC000007E
-    case OS2_NO_MORE_SIDS               = 0x00710001
-    case OS2_CANCEL_VIOLATION           = 0x00AD0001
-    case OS2_ATOMIC_LOCKS_NOT_SUPPORTED = 0x00AE0001
-    case INVALID_INFO_CLASS             = 0xC0000003
-    case INVALID_PIPE_STATE             = 0xC00000AD
-    case INVALID_READ_MODE              = 0xC00000B4
-    case OS2_CANNOT_COPY                = 0x010A0001
-    case STOPPED_ON_SYMLINK             = 0x8000002D
-    case INSTANCE_NOT_AVAILABLE         = 0xC00000AB
-    case PIPE_NOT_AVAILABLE             = 0xC00000AC
-    case PIPE_BUSY                      = 0xC00000AE
-    case PIPE_CLOSING                   = 0xC00000B1
-    case PIPE_EMPTY                     = 0xC00000D9
-    case PIPE_DISCONNECTED              = 0xC00000B0
-    case BUFFER_OVERFLOW                = 0x80000005
-    case MORE_PROCESSING_REQUIRED       = 0xC0000016
-    case EA_TOO_LARGE                   = 0xC0000050
-    case OS2_EAS_DIDNT_FIT              = 0x01130001
-    case EAS_NOT_SUPPORTED              = 0xC000004F
-    case EA_LIST_INCONSISTENT           = 0x80000014
-    case OS2_EA_ACCESS_DENIED           = 0x03E20001
-    case NOTIFY_ENUM_DIR                = 0x0000010C
-    case INVALID_SMB                    = 0x00010002
-    case WRONG_PASSWORD                 = 0xC000006A
-    case PATH_NOT_COVERED               = 0xC0000257
-    case NETWORK_NAME_DELETED           = 0xC00000C9
-    case SMB_BAD_TID                    = 0x00050002
-    case BAD_NETWORK_NAME               = 0xC00000CC
-    case BAD_DEVICE_TYPE                = 0xC00000CB
-    case SMB_BAD_COMMAND                = 0x00160002
-    case PRINT_QUEUE_FULL               = 0xC00000C6
-    case NO_SPOOL_SPACE                 = 0xC00000C7
-    case PRINT_CANCELLED                = 0xC00000C8
-    case UNEXPECTED_NETWORK_ERROR       = 0xC00000C4
-    case IO_TIMEOUT                     = 0xC00000B5
-    case REQUEST_NOT_ACCEPTED           = 0xC00000D0
-    case TOO_MANY_SESSIONS              = 0xC00000CE
-    case SMB_BAD_UID                    = 0x005B0002
-    case SMB_USE_MPX                    = 0x00FA0002
-    case SMB_USE_STANDARD               = 0x00FB0002
-    case SMB_CONTINUE_MPX               = 0x00FC0002
-    case ACCOUNT_DISABLED               = 0xC0000072
-    case ACCOUNT_EXPIRED                = 0xC0000193
-    case INVALID_WORKSTATION            = 0xC0000070
-    case INVALID_LOGON_HOURS            = 0xC000006F
-    case PASSWORD_EXPIRED               = 0xC0000071
-    case PASSWORD_MUST_CHANGE           = 0xC0000224
-    case SMB_NO_SUPPORT                 = 0xFFFF0002
-    case MEDIA_WRITE_PROTECTED          = 0xC00000A2
-    case NO_MEDIA_IN_DEVICE             = 0xC0000013
-    case INVALID_DEVICE_STATE           = 0xC0000184
-    case DATA_ERROR_2                   = 0xC000003E
-    case CRC_ERROR                      = 0xC000003F
-    case DISK_CORRUPT_ERROR             = 0xC0000032
-    case NONEXISTENT_SECTOR             = 0xC0000015
-    case DEVICE_PAPER_EMPTY             = 0x8000000E
-    case WRONG_VOLUME                   = 0xC0000012
-    case DISK_FULL                      = 0xC000007F
-    case BUFFER_TOO_SMALL               = 0xC0000023
-    case BAD_IMPERSONATION_LEVEL        = 0xC00000A5
-    case USER_SESSION_DELETED           = 0xC0000203
-    case NETWORK_SESSION_EXPIRED        = 0xC000035C
-    case SMB_TOO_MANY_UIDS              = 0xC000205A
-    
-    var description: String {
-        switch self {
-        case NOT_IMPLEMENTED, INVALID_DEVICE_REQUEST, ILLEGAL_FUNCTION:
-            return "Invalid Function."
-        case NO_SUCH_FILE, NO_SUCH_DEVICE, OBJECT_NAME_NOT_FOUND:
-            return "File not found."
-        case OBJECT_PATH_INVALID, OBJECT_PATH_NOT_FOUND, OBJECT_PATH_SYNTAX_BAD, DFS_EXIT_PATH_FOUND, REDIRECTOR_NOT_STARTED:
-            return "A component in the path prefix is not a directory."
-        case TOO_MANY_OPENED_FILES:
-            return "Too many open files. No FIDs are available."
-        case ACCESS_DENIED, INVALID_LOCK_SEQUENCE, INVALID_VIEW_SIZE, ALREADY_COMMITTED, PORT_CONNECTION_REFUSED, THREAD_IS_TERMINATING, DELETE_PENDING, PRIVILEGE_NOT_HELD, LOGON_FAILURE, FILE_IS_A_DIRECTORY, FILE_RENAMED, PROCESS_IS_TERMINATING, CANNOT_DELETE, FILE_DELETED:
-            return "Access denied."
-        case SMB_BAD_FID, INVALID_HANDLE, OBJECT_TYPE_MISMATCH, PORT_DISCONNECTED, INVALID_PORT_HANDLE, FILE_CLOSED, HANDLE_NOT_CLOSABLE:
-            return "Invalid FID."
-        case SECTION_TOO_BIG, TOO_MANY_PAGING_FILES, INSUFF_SERVER_RESOURCES:
-            return "Insufficient server memory to perform the requested operation."
-        case OS2_INVALID_ACCESS:
-            return "Invalid open mode."
-        case DATA_ERROR:
-            return "Bad data. (May be generated by IOCTL calls on the server.)"
-        case DIRECTORY_NOT_EMPTY:
-            return "Remove of directory failed because it was not empty."
-        case NOT_SAME_DEVICE:
-            return "A file system operation (such as a rename) across two devices was attempted."
-        case NO_MORE_FILES:
-            return "No (more) files found following a file search command."
-        case UNSUCCESSFUL:
-            return "General error."
-        case SHARING_VIOLATION:
-            return "Sharing violation. A requested open mode conflicts with the sharing mode of an existing file handle."
-        case FILE_LOCK_CONFLICT, LOCK_NOT_GRANTED:
-            return "A lock request specified an invalid locking mode, or conflicted with an existing file lock."
-        case END_OF_FILE:
-            return "Attempted to read beyond the end of the file."
-        case NOT_SUPPORTED:
-            return "This command is not supported by the server."
-        case OBJECT_NAME_COLLISION:
-            return "An attempt to create a file or directory failed because an object with the same pathname already exists."
-        case INVALID_PARAMETER:
-            return "A parameter supplied with the message is invalid."
-        case OS2_INVALID_LEVEL:
-            return "Invalid information level."
-        case OS2_NEGATIVE_SEEK:
-            return "An attempt was made to seek to a negative absolute offset within a file."
-        case RANGE_NOT_LOCKED:
-            return "The byte range specified in an unlock request was not locked."
-        case OS2_NO_MORE_SIDS:
-            return "Maximum number of searches has been exhausted."
-        case OS2_CANCEL_VIOLATION:
-            return "No lock request was outstanding for the supplied cancel region."
-        case OS2_ATOMIC_LOCKS_NOT_SUPPORTED:
-            return "The file system does not support atomic changes to the lock type."
-        case INVALID_INFO_CLASS, INVALID_PIPE_STATE, INVALID_READ_MODE:
-            return "Invalid named pipe."
-        case OS2_CANNOT_COPY:
-            return "The copy functions cannot be used."
-        case INSTANCE_NOT_AVAILABLE, PIPE_NOT_AVAILABLE, PIPE_BUSY:
-            return "All instances of the designated named pipe are busy."
-        case PIPE_CLOSING, PIPE_EMPTY:
-            return "The designated named pipe is in the process of being closed."
-        case PIPE_DISCONNECTED:
-            return "The designated named pipe exists, but there is no server process listening on the server side."
-        case BUFFER_OVERFLOW, MORE_PROCESSING_REQUIRED:
-            return "There is more data available to read on the designated named pipe."
-        case EA_TOO_LARGE, OS2_EAS_DIDNT_FIT:
-            return "Either there are no extended attributes, or the available extended attributes did not fit into the response."
-        case EAS_NOT_SUPPORTED:
-            return "The server file system does not support Extended Attributes."
-        case OS2_EA_ACCESS_DENIED:
-            return "Access to the extended attribute was denied."
-        default:
-            return ""
-        }
-    }
-}

Source/SMBFileProvider.swift

@@ -1,121 +0,0 @@
-//
-//  SambaFileProvider.swift
-//  FileProvider
-//
-//  Created by Amir Abbas Mousavian.
-//  Copyright © 2016 Mousavian. Distributed under MIT license.
-//
-
-import Foundation
-
-class SMBFileProvider: FileProvider, FileProviderMonitor {
-    var type: String = "Samba"
-    var isPathRelative: Bool = true
-    var baseURL: NSURL?
-    var currentPath: String = ""
-    var dispatch_queue: dispatch_queue_t
-    weak var delegate: FileProviderDelegate?
-    let credential: NSURLCredential?
-    
-    typealias FileObjectClass = FileObject
-    
-    init? (baseURL: NSURL, credential: NSURLCredential, afterInitialized: SimpleCompletionHandler) {
-        guard baseURL.scheme.lowercaseString == "smb" else {
-            return nil
-        }
-        self.baseURL = baseURL
-        dispatch_queue = dispatch_queue_create("FileProvider.\(type)", DISPATCH_QUEUE_CONCURRENT)
-        //let url = baseURL.absoluteString
-        self.credential = credential
-    }
-        
-    func contentsOfDirectoryAtPath(path: String, completionHandler: ((contents: [FileObjectClass], error: ErrorType?) -> Void)) {
-        NotImplemented()
-        dispatch_async(dispatch_queue) { 
-            
-        }
-    }
-    
-    func attributesOfItemAtPath(path: String, completionHandler: ((attributes: FileObjectClass?, error: ErrorType?) -> Void)) {
-        NotImplemented()
-    }
-    
-    weak var fileOperationDelegate: FileOperationDelegate?
-    
-    func createFolder(folderName: String, atPath: String, completionHandler: SimpleCompletionHandler) {
-        NotImplemented()
-    }
-    
-    func createFile(fileAttribs: FileObject, atPath: String, contents data: NSData?, completionHandler: SimpleCompletionHandler) {
-        NotImplemented()
-    }
-    
-    func moveItemAtPath(path: String, toPath: String, overwrite: Bool = false, completionHandler: SimpleCompletionHandler) {
-        NotImplemented()
-    }
-    
-    func copyItemAtPath(path: String, toPath: String, overwrite: Bool = false, completionHandler: SimpleCompletionHandler) {
-        NotImplemented()
-    }
-    
-    func removeItemAtPath(path: String, completionHandler: SimpleCompletionHandler) {
-        NotImplemented()
-    }
-    
-    func copyLocalFileToPath(localFile: NSURL, toPath: String, completionHandler: SimpleCompletionHandler) {
-        NotImplemented()
-    }
-    
-    func copyPathToLocalFile(path: String, toLocalURL: NSURL, completionHandler: SimpleCompletionHandler) {
-        NotImplemented()
-    }
-    
-    func contentsAtPath(path: String, completionHandler: ((contents: NSData?, error: ErrorType?) -> Void)) {
-        NotImplemented()
-    }
-    
-    func contentsAtPath(path: String, offset: Int64, length: Int, completionHandler: ((contents: NSData?, error: ErrorType?) -> Void)) {
-        NotImplemented()
-    }
-    
-    func writeContentsAtPath(path: String, contents data: NSData, atomically: Bool, completionHandler: SimpleCompletionHandler) {
-        NotImplemented()
-    }
-    
-    func searchFilesAtPath(path: String, recursive: Bool, query: String, foundItemHandler: ((FileObjectClass) -> Void)?, completionHandler: ((files: [FileObjectClass], error: ErrorType?) -> Void)) {
-        NotImplemented()
-    }
-    
-    func registerNotifcation(path: String, eventHandler: (() -> Void)) {
-        NotImplemented()
-    }
-    
-    func unregisterNotifcation(path: String) {
-        NotImplemented()
-    }
-    
-    func isRegisteredForNotification(path: String) -> Bool {
-        return false
-    }
-}
-
-// MARK: basic CIFS interactivity
-enum SMBFileProviderError: Int, ErrorType, CustomStringConvertible {
-    case BadHeader
-    case IncompatibleHeader
-    case IncorrectParamsLength
-    case IncorrectMessageLength
-    case InvalidCommand
-    
-    var description: String {
-        return "SMB message structure is invalid"
-    }
-}
-
-extension SMBFileProvider {
-    private func getPID() -> UInt32 {
-        return UInt32(NSProcessInfo.processInfo().processIdentifier)
-    }
-}
-
-

Source/TCPSocketClient.swift

@@ -1,249 +0,0 @@
-//
-//  SocketTransmitter.swift
-//  FileProvider
-//
-//  Created by Amir Abbas Mousavian.
-//  Copyright © 2016 Mousavian. Distributed under MIT license.
-//
-
-import Foundation
-
-public class TCPSocketClient: NSObject, NSStreamDelegate {
-    public static let ports = ["http": 80,
-                        "https": 443,
-                        "smb": 445,
-                        "ftp": 21,
-                        "sftp": 22,
-                        "sftp": 2121,
-                        "telnet": 23,
-                        "pop": 110,
-                        "smtp": 25,
-                        "imap": 143]
-    public static let securePorts =  ["https": 443,
-                               "smb": 445,
-                               "sftp": 22,
-                               "sftp": 2121,
-                               "telnet": 992,
-                               "pop": 995,
-                               "smtp": 465,
-                               "imap": 993]
-    
-    private var inputStream: NSInputStream?
-    private var outputStream: NSOutputStream?
-    private var dataToBeSent: NSMutableData = NSMutableData()
-    /// holds data received from server
-    public let dataReceived: NSMutableData = NSMutableData()
-    /// a url with valid scheme, dns or ip host and ports path and query sections will be neglected
-    public let baseURL: NSURL
-    /// a url with valid scheme, dns or ip host and ports path and query sections will be neglected
-    public let secureConnection: Bool
-    /// server's ports which is value between 1 to 65535
-    private let port: UInt32
-    private var open = false
-    
-    /**
-     * - parameter baseURL: a url with valid scheme, dns or ip host and ports
-     * path and query sections will be neglected
-     *
-     * **Note** Call `connect()` to establish connection
-     * - parameter secure: establishing connection using an SSL/TLS connection
-     */
-    
-    init?(baseURL: NSURL, secure: Bool = false) {
-        self.baseURL = baseURL
-        self.secureConnection = secure
-        let scheme = baseURL.scheme.lowercaseString
-        let defaultPort = secure ? UInt32(TCPSocketClient.securePorts[scheme] ?? 0) : UInt32(TCPSocketClient.ports[scheme] ?? 0)
-        self.port = baseURL.port?.unsignedIntValue ?? defaultPort
-        if self.port == 0 {
-            return nil
-        }
-    }
-    
-    deinit {
-        disconnect()
-    }
-
-    /**
-     * Establshes a connection to desired server
-     * - returns: A bool value which indicated there where no system error during
-     * creating connection
-     */
-    
-    public func connect() -> Bool {
-        guard let hostStr = baseURL.host else {
-            return false
-        }
-        var readStream : Unmanaged<CFReadStream>?
-        var writeStream : Unmanaged<CFWriteStream>?
-        let host : CFString = NSString(string: hostStr)
-        
-        CFStreamCreatePairWithSocketToHost(kCFAllocatorDefault, host, self.port, &readStream, &writeStream)
-        inputStream = readStream?.takeRetainedValue()
-        outputStream = writeStream?.takeRetainedValue()
-        
-        guard let inputStream = inputStream, outputStream = outputStream else {
-            return false
-        }
-        
-        inputStream.delegate = self
-        outputStream.delegate = self
-        
-        inputStream.scheduleInRunLoop(NSRunLoop.currentRunLoop(), forMode: NSDefaultRunLoopMode)
-        outputStream.scheduleInRunLoop(NSRunLoop.currentRunLoop(), forMode: NSDefaultRunLoopMode)
-        
-        if secureConnection {
-            inputStream.setProperty(NSStreamSocketSecurityLevelNegotiatedSSL, forKey: NSStreamSocketSecurityLevelKey)
-            outputStream.setProperty(NSStreamSocketSecurityLevelNegotiatedSSL, forKey: NSStreamSocketSecurityLevelKey)
-        }
-        
-        inputStream.open()
-        outputStream.open()
-        return true
-    }
-    
-    /**
-     * Terminates connection to the server
-     */
-    
-    public func disconnect() {
-        inputStream?.setValue(kCFBooleanTrue, forKey: kCFStreamPropertyShouldCloseNativeSocket as String)
-        outputStream?.setValue(kCFBooleanTrue, forKey: kCFStreamPropertyShouldCloseNativeSocket as String)
-        
-        self.inputStream?.close()
-        self.outputStream?.close()
-        
-        self.inputStream?.removeFromRunLoop(NSRunLoop.currentRunLoop(), forMode: NSDefaultRunLoopMode)
-        self.outputStream?.removeFromRunLoop(NSRunLoop.currentRunLoop(), forMode: NSDefaultRunLoopMode)
-        
-        self.inputStream?.delegate = nil
-        self.outputStream?.delegate = nil
-        
-        self.inputStream = nil
-        self.outputStream = nil
-    }
-    
-    public func stream(aStream: NSStream, handleEvent eventCode: NSStreamEvent) {
-        switch (eventCode) {
-        case NSStreamEvent.ErrorOccurred:
-            open = false
-        case NSStreamEvent.EndEncountered:
-            break
-        case NSStreamEvent.None:
-            break
-        case NSStreamEvent.OpenCompleted:
-            let activeStatus: [NSStreamStatus] = [.Open, .Reading, .Writing, .AtEnd]
-            open = activeStatus.contains(inputStream?.streamStatus ?? .NotOpen) && activeStatus.contains(outputStream?.streamStatus ?? .NotOpen)
-        case NSStreamEvent.HasBytesAvailable:
-            var buffer = [UInt8](count: 2048, repeatedValue: 0)
-            if ( aStream == inputStream) {
-                while (inputStream!.hasBytesAvailable ?? false) {
-                    let len = inputStream!.read(&buffer, maxLength: buffer.count)
-                    if len > 0 {
-                        dataReceived.appendBytes(&buffer, length: len)
-                    }
-                }
-            }
-        case NSStreamEvent.HasSpaceAvailable:
-            if aStream == outputStream {
-                do {
-                    try send(data: nil)
-                } catch _ {
-                    NSLog("Sending error")
-                }
-                
-            }
-        default:
-            break
-        }
-    }
-    
-    /**
-     * Sends data to server
-     * - parameter data: data which is intended to be sent to server
-     * - throws: NSURLError.NetworkConnectionLost in case of server disconnects disgracefully
-     */
-    
-    public func send(data data: NSData?) throws {
-        guard let outputStream = outputStream else {
-            return
-        }
-        if outputStream.hasSpaceAvailable ?? false {
-            if let data = data {
-                dataToBeSent.appendData(data)
-            }
-            
-            if dataToBeSent.length > 0 {
-                let bytesWritten = outputStream.write(UnsafePointer(dataToBeSent.bytes), maxLength: dataToBeSent.length) ?? -1
-                if bytesWritten > 0 {
-                    let range = NSRange(location: 0, length: bytesWritten)
-                    dataToBeSent.replaceBytesInRange(range, withBytes: nil, length: 0)
-                } else {
-                    throw NSError(domain: NSURLErrorDomain, code:  NSURLError.NetworkConnectionLost.rawValue, userInfo: nil)
-                }
-            }
-            //println("Sent the following")
-        } else { //steam busy
-            if let data = data {
-                dataToBeSent.appendData(data)
-            }
-        }
-    }
-    
-    /**
-     * Clears entire send and receive buffer
-     */
-    
-    public func flush() {
-        dataToBeSent.length = 0
-        dataReceived.length = 0
-    }
-    
-    /**
-     * Put's thread in sleep until all data is sent
-     * **Note:** Don't call this method from main thread
-     */
-    
-    internal func waitUntillDataSent() {
-        if NSThread.isMainThread() {
-            assert(false, "waitUntillDataSent() method can't be called from main thread")
-        }
-        while true {
-            if dataToBeSent.length == 0 {
-                break
-            }
-            
-            NSRunLoop.currentRunLoop().runUntilDate(NSDate(timeIntervalSinceNow: 0.1));
-            NSThread.sleepForTimeInterval(0.1)
-        }
-    }
-    
-    /**
-     * Put's thread in sleep until all response from server is loaded into tcp stack
-     * server response can be retrieved by `dataReceived` property
-     * **Note:** Don't call this method from main thread
-     * - returns: A Bool value indicates all response loaded from server successfullt
-    */
-    
-    internal func waitUntilResponse() -> Bool {
-        if NSThread.isMainThread() {
-            assert(false, "waitUntilResponse() method can't be called from main thread")
-        }
-        var finished = false
-        while !finished {
-            switch inputStream?.streamStatus ?? .Error {
-            case .AtEnd:
-                finished = true
-                return true
-            case .Closed, .Error:
-                return false
-            default:
-                finished = false
-            }
-            
-            NSRunLoop.currentRunLoop().runUntilDate(NSDate(timeIntervalSinceNow: 0.1));
-            NSThread.sleepForTimeInterval(0.1)
-        }
-        return false
-    }
-}

Source/WebDAVFileProvider.swift

@@ -1,553 +0,0 @@
-//
-//  WebDAVFileProvider.swift
-//  FileProvider
-//
-//  Created by Amir Abbas Mousavian.
-//  Copyright © 2016 Mousavian. Distributed under MIT license.
-//
-
-import Foundation
-
-public enum FileProviderWebDavErrorCode: Int {
-    case OK = 200
-    case Created = 201
-    case NoContent = 204
-    case MultiStatus = 207
-    case Forbidden = 403
-    case MethodNotAllowed = 405
-    case Conflict = 409
-    case PreconditionFailed = 412
-    case UnsupportedMediaType = 415
-    case Locked = 423
-    case FailedDependency = 424
-    case BadGateway = 502
-    case InsufficientStorage = 507
-}
-
-public struct FileProviderWebDavError: ErrorType, CustomStringConvertible {
-    let code: FileProviderWebDavErrorCode
-    let url: NSURL
-    
-    public var description: String {
-        switch code {
-        case .OK: return "OK"
-        case .Created: return "Created"
-        case .NoContent: return "No Content"
-        case .MultiStatus: return ""
-        case .Forbidden: return "Forbidden"
-        case .MethodNotAllowed: return "Method Not Allowed"
-        case .Conflict: return "Conflict"
-        case .PreconditionFailed: return "Precondition Failed"
-        case .UnsupportedMediaType: return "Unsupported Media Type"
-        case .Locked: return "Locked"
-        case .FailedDependency: return "Failed Dependency"
-        case .BadGateway: return "Bad Gateway"
-        case .InsufficientStorage: return "Insufficient Storage"
-        }
-    }
-}
-
-public final class WebDavFileObject: FileObject {
-    let contentType: String
-    let entryTag: String?
-    
-    init(absoluteURL: NSURL, name: String, path: String, size: Int64, contentType: String, createdDate: NSDate?, modifiedDate: NSDate?, fileType: FileType, isHidden: Bool, isReadOnly: Bool, entryTag: String?) {
-        self.contentType = contentType
-        self.entryTag = entryTag
-        super.init(absoluteURL: absoluteURL, name: name, path: path, size: size, createdDate: createdDate, modifiedDate: modifiedDate, fileType: fileType, isHidden: isHidden, isReadOnly: isReadOnly)
-    }
-}
-
-// Because this class uses NSURLSession, it's necessary to disable App Transport Security
-// in case of using this class with unencrypted HTTP connection.
-
-public class WebDAVFileProvider: NSObject,  FileProviderBasic {
-    public let type: String = "WebDAV"
-    public let isPathRelative: Bool = true
-    public let baseURL: NSURL?
-    public var currentPath: String = ""
-    public var dispatch_queue: dispatch_queue_t {
-        willSet {
-            assert(_session == nil, "It's not effective to change dispatch_queue property after session is initialized.")
-        }
-    }
-    public weak var delegate: FileProviderDelegate?
-    public let credential: NSURLCredential?
-    
-    private var _session: NSURLSession?
-    private var session: NSURLSession {
-        if _session == nil {
-            let queue = NSOperationQueue()
-            //queue.underlyingQueue = dispatch_queue
-            _session = NSURLSession(configuration: NSURLSessionConfiguration.defaultSessionConfiguration(), delegate: self, delegateQueue: queue)
-        }
-        return _session!
-    }
-    
-    init? (baseURL: NSURL, credential: NSURLCredential?) {
-        if  !["http", "https"].contains(baseURL.scheme.lowercaseString) {
-            return nil
-        }
-        self.baseURL = baseURL
-        dispatch_queue = dispatch_queue_create("FileProvider.\(type)", DISPATCH_QUEUE_CONCURRENT)
-        //let url = baseURL.absoluteString
-        self.credential = credential
-    }
-    
-    deinit {
-        _session?.invalidateAndCancel()
-    }
-    
-    public func contentsOfDirectoryAtPath(path: String, completionHandler: ((contents: [FileObject], error: ErrorType?) -> Void)) {
-        let url = absoluteURL(path)
-        let request = NSMutableURLRequest(URL: url)
-        request.HTTPMethod = "PROPFIND"
-        request.setValue(baseURL?.absoluteString, forHTTPHeaderField: "Host")
-        request.setValue("1", forHTTPHeaderField: "Depth")
-        request.setValue("text/xml; charset=\"utf-8\"", forHTTPHeaderField: "Content-Type")
-        request.HTTPBody = "<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n<D:propfind xmlns:D=\"DAV:\">\n<D:allprop/></D:propfind>".dataUsingEncoding(NSUTF8StringEncoding)
-        request.setValue(String(request.HTTPBody!.length), forHTTPHeaderField: "Content-Length")
-        let task = session.dataTaskWithRequest(request) { (data, response, error) in
-            if let data = data {
-                let xresponse = self.parseXMLResponse(data)
-                var fileObjects = [WebDavFileObject]()
-                for attr in xresponse {
-                    if attr.href.path == url.path {
-                        continue
-                    }
-                    fileObjects.append(self.mapToFileObject(attr))
-                }
-                completionHandler(contents: fileObjects, error: error)
-                return
-            }
-            completionHandler(contents: [], error: error)
-        }
-        task.resume()
-    }
-    
-    public func attributesOfItemAtPath(path: String, completionHandler: ((attributes: FileObject?, error: ErrorType?) -> Void)) {
-        let request = NSMutableURLRequest(URL: absoluteURL(path))
-        request.HTTPMethod = "PROPFIND"
-        request.setValue(baseURL?.absoluteString, forHTTPHeaderField: "Host")
-        request.setValue("1", forHTTPHeaderField: "Depth")
-        request.setValue("text/xml; charset=\"utf-8\"", forHTTPHeaderField: "Content-Type")
-        request.HTTPBody = "<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n<D:propfind xmlns:D=\"DAV:\">\n<D:allprop/></D:propfind>".dataUsingEncoding(NSUTF8StringEncoding)
-        request.setValue(String(request.HTTPBody!.length), forHTTPHeaderField: "Content-Length")
-        let task = session.dataTaskWithRequest(request) { (data, response, error) in
-            if let data = data {
-                let xresponse = self.parseXMLResponse(data)
-                if let attr = xresponse.first {
-                    completionHandler(attributes: self.mapToFileObject(attr), error: error)
-                    return
-                }
-            }
-            completionHandler(attributes: nil, error: error)
-        }
-        task.resume()
-    }
-    
-    public weak var fileOperationDelegate: FileOperationDelegate?
-}
-
-extension WebDAVFileProvider: FileProviderOperations {
-    public func createFolder(folderName: String, atPath: String, completionHandler: SimpleCompletionHandler) {
-        let session = NSURLSession(configuration: NSURLSessionConfiguration.defaultSessionConfiguration())
-        let url = absoluteURL((atPath as NSString).stringByAppendingPathComponent(folderName) + "/")
-        let request = NSMutableURLRequest(URL: url)
-        request.HTTPMethod = "MKCOL"
-        request.setValue(baseURL?.absoluteString, forHTTPHeaderField: "Host")
-        let task = session.dataTaskWithRequest(request) { (data, response, error) in
-            if let response = response as? NSHTTPURLResponse, let code = FileProviderWebDavErrorCode(rawValue: response.statusCode) where code != .OK {
-                completionHandler?(error: FileProviderWebDavError(code: code, url: url))
-                return
-            }
-            completionHandler?(error: error)
-            self.delegateNotify(.Create(path: (atPath as NSString).stringByAppendingPathComponent(folderName) + "/"), error: error)
-        }
-        task.resume()
-    }
-    
-    public func createFile(fileAttribs: FileObject, atPath path: String, contents data: NSData?, completionHandler: SimpleCompletionHandler) {
-        let request = NSMutableURLRequest(URL: absoluteURL(path))
-        request.HTTPMethod = "PUT"
-        let task = session.uploadTaskWithRequest(request, fromData: data) { (data, response, error) in
-            completionHandler?(error: error)
-            self.delegateNotify(.Create(path: (path as NSString).stringByAppendingPathComponent(fileAttribs.name)), error: error)
-        }
-        task.taskDescription = self.dictionaryToJSON(["type": "Create", "source": (path as NSString).stringByAppendingPathComponent(fileAttribs.name)])
-        task.resume()
-    }
-    
-    public func moveItemAtPath(path: String, toPath: String, overwrite: Bool = false, completionHandler: SimpleCompletionHandler) {
-        let session = NSURLSession(configuration: NSURLSessionConfiguration.defaultSessionConfiguration())
-        let url = absoluteURL(path)
-        let request = NSMutableURLRequest(URL: url)
-        request.HTTPMethod = "MOVE"
-        request.setValue(baseURL?.absoluteString, forHTTPHeaderField: "Host")
-        request.setValue(absoluteURL(path).absoluteString, forHTTPHeaderField: "Destination")
-        if !overwrite {
-            request.setValue("F", forHTTPHeaderField: "Overwrite")
-        }
-        let task = session.dataTaskWithRequest(request) { (data, response, error) in
-            if let response = response as? NSHTTPURLResponse, let code = FileProviderWebDavErrorCode(rawValue: response.statusCode) {
-                defer {
-                    self.delegateNotify(.Move(source: path, destination: toPath), error: error)
-                }
-                if code == .MultiStatus, let data = data {
-                    let xresponses = self.parseXMLResponse(data)
-                    for xresponse in xresponses {
-                        if xresponse.status >= 300 {
-                            completionHandler?(error: FileProviderWebDavError(code: code, url: url))
-                        }
-                    }
-                } else {
-                    completionHandler?(error: FileProviderWebDavError(code: code, url: url))
-                }
-                return
-            }
-            completionHandler?(error: error)
-        }
-        task.resume()
-    }
-    
-    public func copyItemAtPath(path: String, toPath: String, overwrite: Bool = false, completionHandler: SimpleCompletionHandler) {
-        let session = NSURLSession(configuration: NSURLSessionConfiguration.defaultSessionConfiguration())
-        let url = absoluteURL(path)
-        let request = NSMutableURLRequest(URL: url)
-        request.HTTPMethod = "COPY"
-        request.setValue(baseURL?.absoluteString, forHTTPHeaderField: "Host")
-        request.setValue(absoluteURL(path).absoluteString, forHTTPHeaderField: "Destination")
-        if !overwrite {
-            request.setValue("F", forHTTPHeaderField: "Overwrite")
-        }
-        let task = session.dataTaskWithRequest(request) { (data, response, error) in
-            if let response = response as? NSHTTPURLResponse, let code = FileProviderWebDavErrorCode(rawValue: response.statusCode) {
-                defer {
-                    self.delegateNotify(.Copy(source: path, destination: toPath), error: error)
-                }
-                if code == .MultiStatus, let data = data {
-                    let xresponses = self.parseXMLResponse(data)
-                    for xresponse in xresponses {
-                        if xresponse.status >= 300 {
-                            completionHandler?(error: FileProviderWebDavError(code: code, url: url))
-                        }
-                    }
-                } else {
-                    completionHandler?(error: FileProviderWebDavError(code: code, url: url))
-                }
-                return
-            }
-            completionHandler?(error: error)
-        }
-        task.resume()
-    }
-    
-    public func removeItemAtPath(path: String, completionHandler: SimpleCompletionHandler) {
-        let session = NSURLSession(configuration: NSURLSessionConfiguration.defaultSessionConfiguration())
-        let url = absoluteURL(path)
-        let request = NSMutableURLRequest(URL: url)
-        request.HTTPMethod = "DELETE"
-        request.setValue(baseURL?.absoluteString, forHTTPHeaderField: "Host")
-        let task = session.dataTaskWithRequest(request) { (data, response, error) in
-            if let response = response as? NSHTTPURLResponse, let code = FileProviderWebDavErrorCode(rawValue: response.statusCode) {
-                defer {
-                    self.delegateNotify(.Remove(path: path), error: error)
-                }
-                if code == .MultiStatus, let data = data {
-                    let xresponses = self.parseXMLResponse(data)
-                    for xresponse in xresponses {
-                        if xresponse.status >= 300 {
-                            completionHandler?(error: FileProviderWebDavError(code: code, url: url))
-                        }
-                    }
-                } else {
-                    completionHandler?(error: FileProviderWebDavError(code: code, url: url))
-                }
-                return
-            }
-            completionHandler?(error: error)
-        }
-        task.resume()
-    }
-    
-    public func copyLocalFileToPath(localFile: NSURL, toPath: String, completionHandler: SimpleCompletionHandler) {
-        let request = NSMutableURLRequest(URL: absoluteURL(toPath))
-        request.HTTPMethod = "PUT"
-        let task = session.uploadTaskWithRequest(request, fromFile: localFile) { (data, response, error) in
-            completionHandler?(error: error)
-            self.delegateNotify(.Move(source: localFile.absoluteString, destination: toPath), error: error)
-        }
-        task.taskDescription = self.dictionaryToJSON(["type": "Copy", "source": localFile.absoluteString, "dest": toPath])
-        task.resume()
-    }
-    
-    public func copyPathToLocalFile(path: String, toLocalURL: NSURL, completionHandler: SimpleCompletionHandler) {
-        let request = NSMutableURLRequest(URL: absoluteURL(path))
-        let task = session.downloadTaskWithRequest(request) { (sourceFileURL, response, error) in
-            if let sourceFileURL = sourceFileURL {
-                do {
-                    try NSFileManager.defaultManager().copyItemAtURL(sourceFileURL, toURL: toLocalURL)
-                } catch let e {
-                    completionHandler?(error: e)
-                    return
-                }
-            }
-            completionHandler?(error: error)
-        }
-        task.taskDescription = self.dictionaryToJSON(["type": "Copy", "source": path, "dest": toLocalURL.absoluteString])
-        task.resume()
-    }
-}
-
-extension WebDAVFileProvider: FileProviderReadWrite {
-    public func contentsAtPath(path: String, completionHandler: ((contents: NSData?, error: ErrorType?) -> Void)) {
-        let request = NSMutableURLRequest(URL: absoluteURL(path))
-        request.HTTPMethod = "GET"
-        let task = session.dataTaskWithRequest(request) { (data, response, error) in
-            completionHandler(contents: data, error: error)
-        }
-        task.resume()
-    }
-    
-    public func contentsAtPath(path: String, offset: Int64, length: Int, completionHandler: ((contents: NSData?, error: ErrorType?) -> Void)) {
-        let session = NSURLSession(configuration: NSURLSessionConfiguration.defaultSessionConfiguration())
-        let request = NSMutableURLRequest(URL: absoluteURL(path))
-        request.HTTPMethod = "GET"
-        request.setValue("bytes=\(offset)-\(offset + length)", forHTTPHeaderField: "Range")
-        let task = session.dataTaskWithRequest(request) { (data, response, error) in
-            completionHandler(contents: data, error: error)
-        }
-        task.resume()
-    }
-    
-    public func writeContentsAtPath(path: String, contents data: NSData, atomically: Bool = false, completionHandler: SimpleCompletionHandler) {
-        // FIXME: lock destination before writing process
-        let url = atomically ? absoluteURL(path).URLByAppendingPathExtension("tmp") : absoluteURL(path)
-        let request = NSMutableURLRequest(URL: url)
-        request.HTTPMethod = "PUT"
-        let task = session.uploadTaskWithRequest(request, fromData: data) { (data, response, error) in
-            defer {
-                self.delegateNotify(.Modify(path: path), error: error)
-            }
-            if atomically {
-                self.moveItemAtPath((path as NSString).stringByAppendingPathExtension("tmp")!, toPath: path, completionHandler: completionHandler)
-            }
-            if let error = error {
-                // If there is no error, completionHandler has been executed by move command
-                completionHandler?(error: error)
-            }
-        }
-        task.taskDescription = self.dictionaryToJSON(["type": "Modify", "source": path])
-        task.resume()
-    }
-    
-    public func searchFilesAtPath(path: String, recursive: Bool, query: String, foundItemHandler: ((FileObject) -> Void)?, completionHandler: ((files: [FileObject], error: ErrorType?) -> Void)) {
-        let url = absoluteURL(path)
-        let request = NSMutableURLRequest(URL: url)
-        request.HTTPMethod = "PROPFIND"
-        request.setValue(baseURL?.absoluteString, forHTTPHeaderField: "Host")
-        //request.setValue("1", forHTTPHeaderField: "Depth")
-        request.setValue("text/xml; charset=\"utf-8\"", forHTTPHeaderField: "Content-Type")
-        request.HTTPBody = "<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n<D:propfind xmlns:D=\"DAV:\">\n<D:allprop/></D:propfind>".dataUsingEncoding(NSUTF8StringEncoding)
-        request.setValue(String(request.HTTPBody!.length), forHTTPHeaderField: "Content-Length")
-        let task = session.dataTaskWithRequest(request) { (data, response, error) in
-            // FIXME: paginating results
-            if let data = data {
-                let xresponse = self.parseXMLResponse(data)
-                var fileObjects = [WebDavFileObject]()
-                for attr in xresponse {
-                    if let path = attr.href.path where !((path as NSString).lastPathComponent.containsString(query)) {
-                        continue
-                    }
-                    let fileObject = self.mapToFileObject(attr)
-                    fileObjects.append(fileObject)
-                    foundItemHandler?(fileObject)
-                }
-                completionHandler(files: fileObjects, error: error)
-                return
-            }
-            completionHandler(files: [], error: error)
-        }
-        task.resume()
-    }
-    
-    private func registerNotifcation(path: String, eventHandler: (() -> Void)) {
-        /* There is no unified api for monitoring WebDAV server content change/update
-         * Microsoft Exchange uses SUBSCRIBE method, Apple uses push notification system.
-         * while both is unavailable in a mobile platform.
-         * A messy approach is listing a directory with an interval period and compare
-         * with previous results
-         */
-    }
-    private func unregisterNotifcation(path: String) {
-        
-    }
-    // TODO: implements methods for lock mechanism
-}
-
-// MARK: WEBDAV XML response implementation
-
-internal extension WebDAVFileProvider {
-    struct DavResponse {
-        let href: NSURL
-        let hrefString: String
-        let status: Int?
-        let prop: [String: String]
-    }
-    
-    private func parseXMLResponse(response: NSData) -> [DavResponse] {
-        var result = [DavResponse]()
-        do {
-            let xml = try AEXMLDocument(xmlData: response)
-            var rootnode = xml.root
-            var responsetag = "response"
-            for node in rootnode.all ?? [] {
-                if node.name.lowercaseString.hasSuffix("multistatus") {
-                    rootnode = node
-                }
-            }
-            for node in rootnode.children ?? [] {
-                if node.name.lowercaseString.hasSuffix("response") {
-                    responsetag = node.name
-                    break
-                }
-            }
-            for responseNode in rootnode[responsetag].all ?? [] {
-                var hreftag = "href"
-                var statustag = "status"
-                var propstattag = "propstat"
-                for node in responseNode.children ?? [] {
-                    if node.name.lowercaseString.hasSuffix("href") {
-                        hreftag = node.name
-                    }
-                    if node.name.lowercaseString.hasSuffix("status") {
-                        statustag = node.name
-                    }
-                    if node.name.lowercaseString.hasSuffix("propstat") {
-                        propstattag = node.name
-                    }
-                }
-                let href = responseNode[hreftag].value
-                if let href = href, hrefURL = NSURL(string: href) {
-                    var status: Int?
-                    let statusDesc = (responseNode[statustag].stringValue).componentsSeparatedByString(" ")
-                    if statusDesc.count > 2 {
-                        status = Int(statusDesc[1])
-                    }
-                    var propDic = [String: String]()
-                    let propStatNode = responseNode[propstattag]
-                    for node in propStatNode.children ?? [] {
-                        if node.name.lowercaseString.hasSuffix("status") {
-                            statustag = node.name
-                            break
-                        }
-                    }
-                    let statusDesc2 = (propStatNode[statustag].stringValue).componentsSeparatedByString(" ")
-                    if statusDesc2.count > 2 {
-                        status = Int(statusDesc2[1])
-                    }
-                    var proptag = "prop"
-                    for tnode in propStatNode.children ?? [] {
-                        if tnode.name.lowercaseString.hasSuffix("prop") {
-                            proptag = tnode.name
-                        }
-                        break
-                    }
-                    for propItemNode in propStatNode[proptag].children ?? [] {
-                        propDic[propItemNode.name.componentsSeparatedByString(":").last!.lowercaseString] = propItemNode.value
-                        if propItemNode.name.hasSuffix("resourcetype") {
-                            if propItemNode.xmlStringCompact.containsString("collection") {
-                                propDic["getcontenttype"] = "httpd/unix-directory"
-                            }
-                        }
-                    }
-                    result.append(DavResponse(href: hrefURL, hrefString: href, status: status, prop: propDic))
-                }
-            }
-        } catch _ { 
-        }
-        return result
-    }
-    
-    private func mapToFileObject(davResponse: DavResponse) -> WebDavFileObject {
-        var href = davResponse.href
-        if href.baseURL == nil {
-            href = absoluteURL(href.path ?? "")
-        }
-        let name = davResponse.prop["displayname"] ?? (davResponse.hrefString.stringByRemovingPercentEncoding! as NSString).lastPathComponent
-        let size = Int64(davResponse.prop["getcontentlength"] ?? "-1") ?? NSURLSessionTransferSizeUnknown
-        let createdDate = self.resolveRFCDate(davResponse.prop["creationdate"] ?? "")
-        let modifiedDate = self.resolveRFCDate(davResponse.prop["getlastmodified"] ?? "")
-        let contentType = davResponse.prop["getcontenttype"] ?? "octet/stream"
-        let isDirectory = contentType == "httpd/unix-directory"
-        let entryTag = davResponse.prop["getetag"]
-        return WebDavFileObject(absoluteURL: href, name: name, path: href.path ?? name, size: size, contentType: contentType, createdDate: createdDate, modifiedDate: modifiedDate, fileType: isDirectory ? .Directory : .Regular, isHidden: false, isReadOnly: false, entryTag: entryTag)
-    }
-    
-    private func delegateNotify(operation: FileOperation, error: ErrorType?) {
-        dispatch_async(dispatch_get_main_queue(), {
-            if error == nil {
-                self.delegate?.fileproviderSucceed(self, operation: operation)
-            } else {
-                self.delegate?.fileproviderFailed(self, operation: operation)
-            }
-        })
-    }
-}
-
-// MARK: URLSession delegate
-extension WebDAVFileProvider: NSURLSessionDataDelegate, NSURLSessionDownloadDelegate {
-    public func URLSession(session: NSURLSession, downloadTask: NSURLSessionDownloadTask, didFinishDownloadingToURL location: NSURL) {
-        return
-    }
-    
-    public func URLSession(session: NSURLSession, task: NSURLSessionTask, didSendBodyData bytesSent: Int64, totalBytesSent: Int64, totalBytesExpectedToSend: Int64) {
-        guard let desc = task.taskDescription, let json = jsonToDictionary(desc) else {
-            return
-        }
-        guard let type = json["type"] as? String, let source = json["source"] as? String else {
-            return
-        }
-        let dest = json["dest"] as? String
-        let op : FileOperation
-        switch type {
-        case "Create":
-            op = .Create(path: source)
-        case "Copy":
-            guard let dest = dest else { return }
-            op = .Copy(source: source, destination: dest)
-        case "Move":
-            guard let dest = dest else { return }
-            op = .Move(source: source, destination: dest)
-        case "Modify":
-            op = .Modify(path: source)
-        case "Remove":
-            op = .Remove(path: source)
-        case "Link":
-            guard let dest = dest else { return }
-            op = .Link(link: source, target: dest)
-        default:
-            return
-        }
-        
-        let progress = Float(totalBytesSent) / Float(totalBytesExpectedToSend)
-        
-        self.delegate?.fileproviderProgress(self, operation: op, progress: progress)
-    }
-    
-    public func URLSession(session: NSURLSession, downloadTask: NSURLSessionDownloadTask, didWriteData bytesWritten: Int64, totalBytesWritten: Int64, totalBytesExpectedToWrite: Int64) {
-        guard let desc = downloadTask.taskDescription, let json = jsonToDictionary(desc), let source = json["source"] as? String, dest = json["dest"] as? String else {
-            return
-        }
-        
-        self.delegate?.fileproviderProgress(self, operation: .Copy(source: source, destination: dest), progress: Float(totalBytesWritten) / Float(totalBytesExpectedToWrite))
-    }
-    
-    public func URLSession(session: NSURLSession, task: NSURLSessionTask, didReceiveChallenge challenge: NSURLAuthenticationChallenge, completionHandler: (NSURLSessionAuthChallengeDisposition, NSURLCredential?) -> Void) {
-        completionHandler(NSURLSessionAuthChallengeDisposition.UseCredential, credential)
-    }
-    
-    public func URLSession(session: NSURLSession, didReceiveChallenge challenge: NSURLAuthenticationChallenge, completionHandler: (NSURLSessionAuthChallengeDisposition, NSURLCredential?) -> Void) {
-        completionHandler(NSURLSessionAuthChallengeDisposition.UseCredential, credential)
-    }
-}

Sources/AEXML/Document.swift

@@ -0,0 +1,128 @@
+//
+// Document.swift
+//
+// Copyright (c) 2014-2016 Marko Tadić <tadija@me.com> http://tadija.net
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+//
+
+import Foundation
+
+/**
+    This class is inherited from `AEXMLElement` and has a few addons to represent **XML Document**.
+
+    XML Parsing is also done with this object.
+*/
+internal class AEXMLDocument: AEXMLElement {
+    
+    // MARK: - Properties
+    
+    /// Root (the first child element) element of XML Document **(Empty element with error if not exists)**.
+    open var root: AEXMLElement {
+        guard let rootElement = children.first else {
+            let errorElement = AEXMLElement(name: "Error")
+            errorElement.error = AEXMLError.rootElementMissing
+            return errorElement
+        }
+        return rootElement
+    }
+    
+    open let options: AEXMLOptions
+    
+    // MARK: - Lifecycle
+    
+    /**
+        Designated initializer - Creates and returns new XML Document object.
+     
+        - parameter root: Root XML element for XML Document (defaults to `nil`).
+        - parameter options: Options for XML Document header and parser settings (defaults to `AEXMLOptions()`).
+    
+        - returns: Initialized XML Document object.
+    */
+    public init(root: AEXMLElement? = nil, options: AEXMLOptions = AEXMLOptions()) {
+        self.options = options
+        
+        let documentName = String(describing: AEXMLDocument.self)
+        super.init(name: documentName)
+        
+        // document has no parent element
+        parent = nil
+        
+        // add root element to document (if any)
+        if let rootElement = root {
+            _ = addChild(rootElement)
+        }
+    }
+    
+    /**
+        Convenience initializer - used for parsing XML data (by calling `loadXMLData:` internally).
+     
+        - parameter xmlData: XML data to parse.
+        - parameter options: Options for XML Document header and parser settings (defaults to `AEXMLOptions()`).
+    
+        - returns: Initialized XML Document object containing parsed data. Throws error if data could not be parsed.
+    */
+    public convenience init(xml: Data, options: AEXMLOptions = AEXMLOptions()) throws {
+        self.init(options: options)
+        try loadXML(xml)
+    }
+    
+    /**
+        Convenience initializer - used for parsing XML string (by calling `init(xmlData:options:)` internally).
+
+        - parameter xmlString: XML string to parse.
+        - parameter encoding: String encoding for creating `Data` from `xmlString` (defaults to `String.Encoding.utf8`)
+        - parameter options: Options for XML Document header and parser settings (defaults to `AEXMLOptions()`).
+
+        - returns: Initialized XML Document object containing parsed data. Throws error if data could not be parsed.
+    */
+    public convenience init(xml: String,
+                            encoding: String.Encoding = String.Encoding.utf8,
+                            options: AEXMLOptions = AEXMLOptions()) throws
+    {
+        guard let data = xml.data(using: encoding) else { throw AEXMLError.parsingFailed }
+        try self.init(xml: data, options: options)
+    }
+    
+    // MARK: - Parse XML
+    
+    /**
+        Creates instance of `AEXMLParser` (private class which is simple wrapper around `XMLParser`)
+        and starts parsing the given XML data. Throws error if data could not be parsed.
+    
+        - parameter data: XML which should be parsed.
+    */
+    open func loadXML(_ data: Data) throws {
+        children.removeAll(keepingCapacity: false)
+        let xmlParser = AEXMLParser(document: self, data: data)
+        try xmlParser.parse()
+    }
+    
+    // MARK: - Override
+    
+    /// Override of `xml` property of `AEXMLElement` - it just inserts XML Document header at the beginning.
+    open override var xml: String {
+        var xml =  "\(options.documentHeader.xmlString)\n"
+        for child in children {
+            xml += child.xml
+        }
+        return xml
+    }
+    
+}

Sources/AEXML/Element.swift

@@ -0,0 +1,285 @@
+//
+// Element.swift
+//
+// Copyright (c) 2014-2016 Marko Tadić <tadija@me.com> http://tadija.net
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+//
+
+import Foundation
+
+/**
+    This is base class for holding XML structure.
+
+    You can access its structure by using subscript like this: `element["foo"]["bar"]` which would
+    return `<bar></bar>` element from `<element><foo><bar></bar></foo></element>` XML as an `AEXMLElement` object.
+*/
+internal class AEXMLElement {
+    
+    // MARK: - Properties
+    
+    /// Every `AEXMLElement` should have its parent element instead of `AEXMLDocument` which parent is `nil`.
+    open internal(set) weak var parent: AEXMLElement?
+    
+    /// Child XML elements.
+    open internal(set) var children = [AEXMLElement]()
+    
+    /// XML Element name.
+    open var name: String
+    
+    /// XML Element value.
+    open var value: String?
+    
+    /// XML Element attributes.
+    open var attributes: [String : String]
+    
+    /// Error value (`nil` if there is no error).
+    open var error: AEXMLError?
+    
+    /// String representation of `value` property (if `value` is `nil` this is empty String).
+    open var string: String { return value ?? String() }
+    
+    /// Boolean representation of `value` property (if `value` is "true" or 1 this is `True`, otherwise `False`).
+    open var bool: Bool { return string.lowercased() == "true" || Int(string) == 1 ? true : false }
+    
+    /// Integer representation of `value` property (this is **0** if `value` can't be represented as Integer).
+    open var int: Int { return Int(string) ?? 0 }
+    
+    /// Double representation of `value` property (this is **0.00** if `value` can't be represented as Double).
+    open var double: Double { return Double(string) ?? 0.00 }
+    
+    // MARK: - Lifecycle
+    
+    /**
+        Designated initializer - all parameters are optional.
+    
+        - parameter name: XML element name.
+        - parameter value: XML element value (defaults to `nil`).
+        - parameter attributes: XML element attributes (defaults to empty dictionary).
+    
+        - returns: An initialized `AEXMLElement` object.
+    */
+    public init(name: String, value: String? = nil, attributes: [String : String] = [String : String]()) {
+        self.name = name
+        self.value = value
+        self.attributes = attributes
+    }
+    
+    // MARK: - XML Read
+    
+    /// The first element with given name **(Empty element with error if not exists)**.
+    open subscript(key: String) -> AEXMLElement {
+        guard let
+            first = children.first(where: { $0.name == key })
+        else {
+            let errorElement = AEXMLElement(name: key)
+            errorElement.error = AEXMLError.elementNotFound
+            return errorElement
+        }
+        return first
+    }
+    
+    /// Returns all of the elements with equal name as `self` **(nil if not exists)**.
+    open var all: [AEXMLElement]? { return parent?.children.filter { $0.name == self.name } }
+    
+    /// Returns the first element with equal name as `self` **(nil if not exists)**.
+    open var first: AEXMLElement? { return all?.first }
+    
+    /// Returns the last element with equal name as `self` **(nil if not exists)**.
+    open var last: AEXMLElement? { return all?.last }
+    
+    /// Returns number of all elements with equal name as `self`.
+    open var count: Int { return all?.count ?? 0 }
+
+    fileprivate func filter(withCondition condition: (AEXMLElement) -> Bool) -> [AEXMLElement]? {
+        guard let elements = all else { return nil }
+        
+        var found = [AEXMLElement]()
+        for element in elements {
+            if condition(element) {
+                found.append(element)
+            }
+        }
+        
+        return found.count > 0 ? found : nil
+    }
+    
+    /**
+        Returns all elements with given value.
+        
+        - parameter value: XML element value.
+        
+        - returns: Optional Array of found XML elements.
+    */
+    open func all(withValue value: String) -> [AEXMLElement]? {
+        let found = filter { (element) -> Bool in
+            return element.value == value
+        }
+        return found
+    }
+    
+    /**
+        Returns all elements with given attributes.
+    
+        - parameter attributes: Dictionary of Keys and Values of attributes.
+    
+        - returns: Optional Array of found XML elements.
+    */
+    open func all(withAttributes attributes: [String : String]) -> [AEXMLElement]? {
+        let found = filter { (element) -> Bool in
+            var countAttributes = 0
+            for (key, value) in attributes {
+                if element.attributes[key] == value {
+                    countAttributes += 1
+                }
+            }
+            return countAttributes == attributes.count
+        }
+        return found
+    }
+    
+    // MARK: - XML Write
+    
+    /**
+        Adds child XML element to `self`.
+    
+        - parameter child: Child XML element to add.
+    
+        - returns: Child XML element with `self` as `parent`.
+    */
+    @discardableResult open func addChild(_ child: AEXMLElement) -> AEXMLElement {
+        child.parent = self
+        children.append(child)
+        return child
+    }
+    
+    /**
+        Adds child XML element to `self`.
+        
+        - parameter name: Child XML element name.
+        - parameter value: Child XML element value (defaults to `nil`).
+        - parameter attributes: Child XML element attributes (defaults to empty dictionary).
+        
+        - returns: Child XML element with `self` as `parent`.
+    */
+    @discardableResult open func addChild(name: String,
+                       value: String? = nil,
+                       attributes: [String : String] = [String : String]()) -> AEXMLElement
+    {
+        let child = AEXMLElement(name: name, value: value, attributes: attributes)
+        return addChild(child)
+    }
+    
+    /// Removes `self` from `parent` XML element.
+    open func removeFromParent() {
+        parent?.removeChild(self)
+    }
+    
+    fileprivate func removeChild(_ child: AEXMLElement) {
+        if let childIndex = children.index(where: { $0 === child }) {
+            children.remove(at: childIndex)
+        }
+    }
+    
+    fileprivate var parentsCount: Int {
+        var count = 0
+        var element = self
+        
+        while let parent = element.parent {
+            count += 1
+            element = parent
+        }
+        
+        return count
+    }
+    
+    fileprivate func indent(withDepth depth: Int) -> String {
+        var count = depth
+        var indent = String()
+        
+        while count > 0 {
+            indent += "\t"
+            count -= 1
+        }
+        
+        return indent
+    }
+    
+    /// Complete hierarchy of `self` and `children` in **XML** escaped and formatted String
+    open var xml: String {
+        var xml = String()
+        
+        // open element
+        xml += indent(withDepth: parentsCount - 1)
+        xml += "<\(name)"
+        
+        if attributes.count > 0 {
+            // insert attributes
+            for (key, value) in attributes {
+                xml += " \(key)=\"\(value.xmlEscaped)\""
+            }
+        }
+        
+        if value == nil && children.count == 0 {
+            // close element
+            xml += " />"
+        } else {
+            if children.count > 0 {
+                // add children
+                xml += ">\n"
+                for child in children {
+                    xml += "\(child.xml)\n"
+                }
+                // add indentation
+                xml += indent(withDepth: parentsCount - 1)
+                xml += "</\(name)>"
+            } else {
+                // insert string value and close element
+                xml += ">\(string.xmlEscaped)</\(name)>"
+            }
+        }
+        
+        return xml
+    }
+    
+    /// Same as `xmlString` but without `\n` and `\t` characters
+    open var xmlCompact: String {
+        let chars = CharacterSet(charactersIn: "\n\t")
+        return xml.components(separatedBy: chars).joined(separator: "")
+    }
+    
+}
+
+public extension String {
+    
+    /// String representation of self with XML special characters escaped.
+    public var xmlEscaped: String {
+        // we need to make sure "&" is escaped first. Not doing this may break escaping the other characters
+        var escaped = replacingOccurrences(of: "&", with: "&amp;", options: .literal)
+        
+        // replace the other four special characters
+        let escapeChars = ["<" : "&lt;", ">" : "&gt;", "'" : "&apos;", "\"" : "&quot;"]
+        for (char, echar) in escapeChars {
+            escaped = escaped.replacingOccurrences(of: char, with: echar, options: .literal)
+        }
+        
+        return escaped
+    }
+    
+}

Sources/AEXML/Error.swift

@@ -0,0 +1,37 @@
+//
+// Error.swift
+//
+// Copyright (c) 2014-2016 Marko Tadić <tadija@me.com> http://tadija.net
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+//
+
+import Foundation
+
+/// A type representing error value that can be thrown or inside `error` property of `AEXMLElement`.
+internal enum AEXMLError: Error {
+    /// This will be inside `error` property of `AEXMLElement` when subscript is used for not-existing element.
+    case elementNotFound
+    
+    /// This will be inside `error` property of `AEXMLDocument` when there is no root element.
+    case rootElementMissing
+    
+    /// `AEXMLDocument` can throw this error on `init` or `loadXMLData` if parsing with `XMLParser` was not successful.
+    case parsingFailed
+}

Sources/AEXML/Options.swift

@@ -0,0 +1,52 @@
+//
+//  Options.swift
+//  AEXML
+//
+//  Created by Marko Tadic on 9/10/16.
+//  Copyright © 2016 AE. All rights reserved.
+//
+
+import Foundation
+
+/// Options used in `AEXMLDocument`
+internal struct AEXMLOptions {
+    
+    /// Values used in XML Document header
+    public struct DocumentHeader {
+        /// Version value for XML Document header (defaults to 1.0).
+        public var version = 1.0
+        
+        /// Encoding value for XML Document header (defaults to "utf-8").
+        public var encoding = "utf-8"
+        
+        /// Standalone value for XML Document header (defaults to "no").
+        public var standalone = "no"
+        
+        /// XML Document header
+        public var xmlString: String {
+            return "<?xml version=\"\(version)\" encoding=\"\(encoding)\" standalone=\"\(standalone)\"?>"
+        }
+    }
+    
+    /// Settings used by `Foundation.XMLParser`
+    public struct ParserSettings {
+        /// Parser reports the namespaces and qualified names of elements. (defaults to `false`)
+        public var shouldProcessNamespaces = false
+        
+        /// Parser reports the prefixes indicating the scope of namespace declarations. (defaults to `false`)
+        public var shouldReportNamespacePrefixes = false
+        
+        /// Parser reports declarations of external entities. (defaults to `false`)
+        public var shouldResolveExternalEntities = false
+    }
+    
+    /// Values used in XML Document header (defaults to `DocumentHeader()`)
+    public var documentHeader = DocumentHeader()
+    
+    /// Settings used by `Foundation.XMLParser` (defaults to `ParserSettings()`)
+    public var parserSettings = ParserSettings()
+    
+    /// Designated initializer - Creates and returns default `AEXMLOptions`.
+    public init() {}
+    
+}

Sources/AEXML/Parser.swift

@@ -0,0 +1,101 @@
+//
+// Parser.swift
+//
+// Copyright (c) 2014-2016 Marko Tadić <tadija@me.com> http://tadija.net
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+//
+
+import Foundation
+
+/// Simple wrapper around `Foundation.XMLParser`.
+internal class AEXMLParser: NSObject, XMLParserDelegate {
+    
+    // MARK: - Properties
+    
+    let document: AEXMLDocument
+    let data: Data
+    
+    var currentParent: AEXMLElement?
+    var currentElement: AEXMLElement?
+    var currentValue = String()
+    
+    var parseError: Error?
+    
+    // MARK: - Lifecycle
+    
+    init(document: AEXMLDocument, data: Data) {
+        self.document = document
+        self.data = data
+        currentParent = document
+        
+        super.init()
+    }
+    
+    // MARK: - API
+    
+    func parse() throws {
+        let parser = XMLParser(data: data)
+        parser.delegate = self
+        
+        parser.shouldProcessNamespaces = document.options.parserSettings.shouldProcessNamespaces
+        parser.shouldReportNamespacePrefixes = document.options.parserSettings.shouldReportNamespacePrefixes
+        parser.shouldResolveExternalEntities = document.options.parserSettings.shouldResolveExternalEntities
+        
+        let success = parser.parse()
+        
+        if !success {
+            guard let error = parseError else { throw AEXMLError.parsingFailed }
+            throw error
+        }
+    }
+    
+    // MARK: - XMLParserDelegate
+    
+    @objc func parser(_ parser: XMLParser,
+                      didStartElement elementName: String,
+                      namespaceURI: String?,
+                      qualifiedName qName: String?,
+                      attributes attributeDict: [String : String])
+    {
+        currentValue = String()
+        currentElement = currentParent?.addChild(name: elementName, attributes: attributeDict)
+        currentParent = currentElement
+    }
+    
+    @objc func parser(_ parser: XMLParser, foundCharacters string: String) {
+        currentValue += string
+        let newValue = currentValue.trimmingCharacters(in: CharacterSet.whitespacesAndNewlines)
+        currentElement?.value = newValue == String() ? nil : newValue
+    }
+    
+    @objc func parser(_ parser: XMLParser,
+                      didEndElement elementName: String,
+                      namespaceURI: String?,
+                      qualifiedName qName: String?)
+    {
+        currentParent = currentParent?.parent
+        currentElement = nil
+    }
+    
+    @objc func parser(_ parser: XMLParser, parseErrorOccurred parseError: Error) {
+        self.parseError = parseError
+    }
+    
+}

Sources/CloudFileProvider.swift

@@ -0,0 +1,804 @@
+//
+//  CloudFileProvider.swift
+//  FileProvider
+//
+//  Created by Amir Abbas Mousavian.
+//  Copyright © 2017 Mousavian. Distributed under MIT license.
+//
+
+import Foundation
+
+/**
+ Allows accessing to iCloud Drive stored files. Determine scope when initializing, to either access
+ to public documents folder or files stored as data.
+ 
+ To setup a functional iCloud container, please
+ [read this page](https://medium.com/ios-os-x-development/icloud-drive-documents-1a46b5706fe1).
+ */
+open class CloudFileProvider: LocalFileProvider {
+    /// An string to identify type of provider.
+    open override class var type: String { return "iCloudDrive" }
+    
+    /// Forces file operations to use `NSFileCoordinating`,
+    /// Actually this is readonly, and value is always true.
+    override open var isCoorinating: Bool {
+        get {
+            return true
+        }
+        set {
+            assert(true, "CloudFileProvider.isCoorinating can't be set")
+            return
+        }
+    }
+    
+    /// The fully-qualified container identifier for an iCloud container directory.
+    open fileprivate(set) var containerId: String?
+    
+    /// Scope of container, indicates user can manipulate data/files or not.
+    open fileprivate(set) var scope: UbiquitousScope
+    
+    /// Set this property to ignore initiations asserting to be on secondary thread
+    static open var asserting: Bool = true
+    
+    /**
+     Initializes the provider for the iCloud container associated with the specified identifier and 
+     establishes access to that container.
+     
+     - Important: Do not call this method from your app’s main thread. Because this method might take a nontrivial amount of time to set up iCloud and return the requested URL, you should always call it from a secondary thread.
+     
+     - Parameter containerId: The fully-qualified container identifier for an iCloud container directory. The string you specify must not contain wildcards and must be of the form `<TEAMID>.<CONTAINER>`, where `<TEAMID>` is your development team ID and `<CONTAINER>` is the bundle identifier of the container you want to access.\
+         The container identifiers for your app must be declared in the `com.apple.developer.ubiquity-container-identifiers` array of the `.entitlements` property list file in your Xcode project.\
+         If you specify nil for this parameter, this method uses the first container listed in the `com.apple.developer.ubiquity-container-identifiers` entitlement array.
+     - Parameter scope: Use `.documents` (default) to put documents that the user is allowed to access inside a Documents subdirectory. Otherwise use `.data` to store user-related data files that your app needs to share but that are not files you want the user to manipulate directly.
+    */
+    public init? (containerId: String?, scope: UbiquitousScope = .documents) {
+        assert(!CloudFileProvider.asserting || !Thread.isMainThread, "LocalFileProvider.init(containerId:) is not recommended to be executed on Main Thread.")
+        guard FileManager.default.ubiquityIdentityToken != nil else {
+            return nil
+        }
+        guard let ubiquityURL = FileManager.default.url(forUbiquityContainerIdentifier: containerId) else {
+            return nil
+        }
+        self.containerId = containerId
+        self.scope = scope
+        let baseURL: URL
+        if scope == .documents {
+            baseURL = ubiquityURL.appendingPathComponent("Documents/")
+        } else {
+            baseURL = ubiquityURL
+        }
+        
+        super.init(baseURL: baseURL)
+        self.isCoorinating = true
+        
+        dispatch_queue = DispatchQueue(label: "FileProvider.\(type(of: self).type)", attributes: .concurrent)
+        operation_queue = OperationQueue()
+        operation_queue.name = "FileProvider.\(type(of: self).type).Operation"
+        
+        fileManager.url(forUbiquityContainerIdentifier: containerId)
+        opFileManager.url(forUbiquityContainerIdentifier: containerId)
+        
+        try? fileManager.createDirectory(at: baseURL, withIntermediateDirectories: true)
+    }
+    
+    /**
+     Returns an Array of `FileObject`s identifying the the directory entries via asynchronous completion handler.
+     
+     If the directory contains no entries or an error is occured, this method will return the empty array.
+     
+     - Parameter path: path to target directory. If empty, `currentPath` value will be used.
+     - Parameter completionHandler: a closure with result of directory entries or error.
+         `contents`: An array of `FileObject` identifying the the directory entries.
+         `error`: Error returned by system.
+     */
+    open override func contentsOfDirectory(path: String, completionHandler: @escaping ((_ contents: [FileObject], _ error: Error?) -> Void)) {
+        // FIXME: create runloop for dispatch_queue, start query on it
+        dispatch_queue.async {
+            let pathURL = self.url(of: path)
+            
+            let query = NSMetadataQuery()
+            query.predicate = NSPredicate(format: "%K BEGINSWITH %@", NSMetadataItemPathKey, pathURL.path)
+            query.valueListAttributes = [NSMetadataItemURLKey, NSMetadataItemFSNameKey, NSMetadataItemPathKey, NSMetadataItemFSSizeKey, NSMetadataItemContentTypeTreeKey, NSMetadataItemFSCreationDateKey, NSMetadataItemFSContentChangeDateKey]
+            query.searchScopes = [self.scope.rawValue]
+            var finishObserver: NSObjectProtocol?
+            finishObserver = NotificationCenter.default.addObserver(forName: NSNotification.Name.NSMetadataQueryDidFinishGathering, object: query, queue: nil, using: { (notification) in
+                defer {
+                    query.stop()
+                    NotificationCenter.default.removeObserver(finishObserver!)
+                }
+                
+                guard let results = query.results as? [NSMetadataItem] else {
+                    return
+                }
+                
+                query.disableUpdates()
+                
+                var contents = [FileObject]()
+                for result in results {
+                    guard let attribs = result.values(forAttributes: [NSMetadataItemURLKey, NSMetadataItemFSNameKey, NSMetadataItemPathKey, NSMetadataItemFSSizeKey, NSMetadataItemContentTypeTreeKey, NSMetadataItemFSCreationDateKey, NSMetadataItemFSContentChangeDateKey]) else {
+                        continue
+                    }
+                    
+                    guard let url = (attribs[NSMetadataItemURLKey] as? URL)?.standardized, url.deletingLastPathComponent().path.trimmingCharacters(in: pathTrimSet) == pathURL.path.trimmingCharacters(in: pathTrimSet) else {
+                        continue
+                    }
+                    
+                    if let file = self.mapFileObject(attributes: attribs) {
+                        contents.append(file)
+                    }
+                }
+                
+                query.stop()
+                self.dispatch_queue.async {
+                    completionHandler(contents, nil)
+                }
+                
+            })
+            DispatchQueue.main.async {
+                if !query.start() {
+                    self.dispatch_queue.async {
+                        completionHandler([], self.throwError(path, code: CocoaError.fileReadNoPermission))
+                    }
+                }
+            }
+        }
+    }
+    
+    /// Please don't rely this function to get iCloud drive total and remaining capacity
+    /// - Important: iCloud Storage size and free space is unavailable, it returns local space
+    open override func storageProperties(completionHandler: (@escaping (_ total: Int64, _ used: Int64) -> Void)) {
+        super.storageProperties(completionHandler: completionHandler)
+    }
+    
+    /**
+     Returns a `FileObject` containing the attributes of the item (file, directory, symlink, etc.) at the path in question via asynchronous completion handler.
+     
+     If the directory contains no entries or an error is occured, this method will return the empty `FileObject`.
+     
+     - Parameter path: path to target directory. If empty, `currentPath` value will be used.
+     - Parameter completionHandler: a closure with result of directory entries or error.
+         `attributes`: A `FileObject` containing the attributes of the item.
+         `error`: Error returned by system.
+     */
+    open override func attributesOfItem(path: String, completionHandler: @escaping ((_ attributes: FileObject?, _ error: Error?) -> Void)) {
+        dispatch_queue.async {
+            let pathURL = self.url(of: path)
+            let query = NSMetadataQuery()
+            query.predicate = NSPredicate(format: "%K LIKE %@", NSMetadataItemPathKey, pathURL.path)
+            query.valueListAttributes = [NSMetadataItemURLKey, NSMetadataItemFSNameKey, NSMetadataItemPathKey, NSMetadataItemFSSizeKey, NSMetadataItemContentTypeTreeKey, NSMetadataItemFSCreationDateKey, NSMetadataItemFSContentChangeDateKey]
+            query.searchScopes = [self.scope.rawValue]
+            var finishObserver: NSObjectProtocol?
+            finishObserver = NotificationCenter.default.addObserver(forName: NSNotification.Name.NSMetadataQueryDidFinishGathering, object: query, queue: nil, using: { (notification) in
+                defer {
+                    query.stop()
+                    NotificationCenter.default.removeObserver(finishObserver!)
+                }
+                
+                query.disableUpdates()
+                
+                guard let result = (query.results as? [NSMetadataItem])?.first, let attribs = result.values(forAttributes: [NSMetadataItemURLKey, NSMetadataItemFSNameKey, NSMetadataItemPathKey, NSMetadataItemFSSizeKey, NSMetadataItemContentTypeTreeKey, NSMetadataItemFSCreationDateKey, NSMetadataItemFSContentChangeDateKey]) else {
+                    let error = self.throwError(path, code: CocoaError.fileNoSuchFile)
+                    self.dispatch_queue.async {
+                        completionHandler(nil, error)
+                    }
+                    return
+                }
+                
+                if let file = self.mapFileObject(attributes: attribs) {
+                    self.dispatch_queue.async {
+                        completionHandler(file, nil)
+                    }
+                } else {
+                    let noFileError = self.throwError(path, code: CocoaError.fileNoSuchFile)
+                    self.dispatch_queue.async {
+                        completionHandler(nil, noFileError)
+                    }
+                }
+            })
+            DispatchQueue.main.async {
+                if !query.start() {
+                    self.dispatch_queue.async {
+                        completionHandler(nil, self.throwError(path, code: CocoaError.fileReadNoPermission))
+                    }
+                }
+            }
+        }
+    }
+    
+    /**
+     Search files inside directory using query asynchronously.
+     
+     - Note: For now only it's limited to file names. `query` parameter may take `NSPredicate` format in near future.
+     
+     - Parameters:
+     - path: location of directory to start search
+     - recursive: Searching subdirectories of path
+     - query: Simple string of file name to be search (for now).
+     - foundItemHandler: Closure which is called when a file is found
+     - completionHandler: Closure which will be called after finishing search. Returns an arry of `FileObject` or error if occured.
+     */
+    open override func searchFiles(path: String, recursive: Bool, query: NSPredicate, foundItemHandler: ((FileObject) -> Void)?, completionHandler: @escaping ((_ files: [FileObject], _ error: Error?) -> Void)) {
+        
+        let mapDict: [String: String] = ["url": NSMetadataItemURLKey, "name": NSMetadataItemFSNameKey, "path": NSMetadataItemPathKey, "filesize": NSMetadataItemFSSizeKey, "modifiedDate": NSMetadataItemFSContentChangeDateKey, "creationDate": NSMetadataItemFSCreationDateKey, "contentType": NSMetadataItemContentTypeKey]
+        
+        func updateQueryKeys(_ queryComponent: NSPredicate) -> NSPredicate {
+            if let cQuery = queryComponent as? NSCompoundPredicate {
+                let newSub = cQuery.subpredicates.map { updateQueryKeys($0 as! NSPredicate) }
+                switch cQuery.compoundPredicateType {
+                case .and: return NSCompoundPredicate(andPredicateWithSubpredicates: newSub)
+                case .not: return NSCompoundPredicate(notPredicateWithSubpredicate: newSub[0])
+                case .or:  return NSCompoundPredicate(orPredicateWithSubpredicates: newSub)
+                }
+            } else if let cQuery = queryComponent as? NSComparisonPredicate {
+                var newLeft = cQuery.leftExpression
+                var newRight = cQuery.rightExpression
+                if newLeft.expressionType == .keyPath, let newKey = mapDict[newLeft.keyPath] {
+                    newLeft = NSExpression(forKeyPath: newKey)
+                }
+                if newRight.expressionType == .keyPath, let newKey = mapDict[newRight.keyPath] {
+                    newRight = NSExpression(forKeyPath: newKey)
+                }
+                if newLeft.expressionType == .keyPath, newLeft.keyPath == "type" {
+                    newRight = NSExpression(forConstantValue: newRight.constantValue as? String == "directory" ? "public.directory": "public.data")
+                }
+                if newRight.expressionType == .keyPath, newRight.keyPath == "type" {
+                    newLeft = NSExpression(forConstantValue: newLeft.constantValue as? String == "directory" ? "public.directory": "public.data")
+                }
+                return NSComparisonPredicate(leftExpression: newLeft, rightExpression: newRight, modifier: cQuery.comparisonPredicateModifier, type: cQuery.predicateOperatorType, options: cQuery.options)
+            } else {
+                return queryComponent
+            }
+        }
+        
+        dispatch_queue.async {
+            let pathURL = self.url(of: path)
+            let mdquery = NSMetadataQuery()
+            mdquery.predicate = NSPredicate(format: "(%K BEGINSWITH %@) && (\(updateQueryKeys(query).predicateFormat))", NSMetadataItemPathKey, pathURL.path)
+            mdquery.searchScopes = [self.scope.rawValue]
+            
+            var lastReportedCount = 0
+            
+            if let foundItemHandler = foundItemHandler {
+                var updateObserver: NSObjectProtocol?
+                
+                // FIXME: Remove this section as it won't work as expected on iCloud
+                updateObserver = NotificationCenter.default.addObserver(forName: .NSMetadataQueryGatheringProgress, object: mdquery, queue: nil, using: { (notification) in
+                    
+                    mdquery.disableUpdates()
+                    
+                    guard mdquery.resultCount > lastReportedCount else { return }
+                    
+                    for index in lastReportedCount..<mdquery.resultCount {
+                        guard let attribs = (mdquery.result(at: index) as? NSMetadataItem)?.values(forAttributes: [NSMetadataItemURLKey, NSMetadataItemFSNameKey, NSMetadataItemPathKey, NSMetadataItemFSSizeKey, NSMetadataItemContentTypeTreeKey, NSMetadataItemFSCreationDateKey, NSMetadataItemFSContentChangeDateKey]) else {
+                            continue
+                        }
+                        
+                        guard let url = (attribs[NSMetadataItemURLKey] as? URL)?.standardized, recursive || url.deletingLastPathComponent().path.trimmingCharacters(in: pathTrimSet) == pathURL.path.trimmingCharacters(in: pathTrimSet) else {
+                            continue
+                        }
+                        
+                        if let file = self.mapFileObject(attributes: attribs) {
+                            foundItemHandler(file)
+                        }
+                    }
+                    lastReportedCount = mdquery.resultCount
+                    
+                    mdquery.enableUpdates()
+                })
+            }
+            
+            var finishObserver: NSObjectProtocol?
+            finishObserver = NotificationCenter.default.addObserver(forName: .NSMetadataQueryDidFinishGathering, object: mdquery, queue: nil, using: { (notification) in
+                defer {
+                    mdquery.stop()
+                    NotificationCenter.default.removeObserver(finishObserver!)
+                }
+                
+                guard let results = mdquery.results as? [NSMetadataItem] else {
+                    return
+                }
+                
+                mdquery.disableUpdates()
+                
+                var contents = [FileObject]()
+                for result in results {
+                    guard let attribs = result.values(forAttributes: [NSMetadataItemURLKey, NSMetadataItemFSNameKey, NSMetadataItemPathKey, NSMetadataItemFSSizeKey, NSMetadataItemContentTypeTreeKey, NSMetadataItemFSCreationDateKey, NSMetadataItemFSContentChangeDateKey]) else {
+                        continue
+                    }
+                    
+                    guard let url = (attribs[NSMetadataItemURLKey] as? URL)?.standardized, recursive || url.deletingLastPathComponent().path.trimmingCharacters(in: pathTrimSet) == pathURL.path.trimmingCharacters(in: pathTrimSet) else {
+                        continue
+                    }
+                    
+                    if let file = self.mapFileObject(attributes: attribs) {
+                        contents.append(file)
+                    }
+                }
+                self.dispatch_queue.async {
+                    completionHandler(contents, nil)
+                }
+            })
+            
+            DispatchQueue.main.async {
+                if !mdquery.start() {
+                    self.dispatch_queue.async {
+                        completionHandler([], self.throwError(path, code: CocoaError.fileReadNoPermission))
+                    }
+                }
+            }
+        }
+    }
+    
+    open override func isReachable(completionHandler: @escaping (Bool) -> Void) {
+        dispatch_queue.async {
+            completionHandler(self.fileManager.ubiquityIdentityToken != nil)
+        }
+    }
+    
+    /**
+     Creates a new directory at the specified path asynchronously.
+     This will create any necessary intermediate directories.
+     
+     - Parameters:
+       - folder: Directory name.
+       - at: Parent path of new directory.
+       - completionHandler: If an error parameter was provided, a presentable `Error` will be returned.
+     - Returns: An `OperationHandle` to get progress or cancel progress. Doesn't work on `CloudFileProvider`.
+     */
+    @discardableResult
+    open override func create(folder folderName: String, at atPath: String, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        guard let r = super.create(folder: folderName, at: atPath, completionHandler: completionHandler) else { return nil }
+        return CloudOperationHandle(operationType: r.operationType, baseURL: self.baseURL)
+    }
+    
+    /**
+     Creates an new file with data passed to method asynchronously.
+     Returns error via completionHandler if file is already exists.
+     
+     - Parameters:
+       - file: New file name with extension separated by period.
+       - at: Parent path of new file.
+       - data: Data of new files. Pass nil or `Data()` to create empty file.
+       - completionHandler: If an error parameter was provided, a presentable `Error` will be returned.
+     - Returns: An `OperationHandle` to get progress or cancel progress. Doesn't work on `CloudFileProvider`.
+     */
+    @discardableResult
+    open override func create(file fileName: String, at atPath: String, contents data: Data?, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        guard let r = super.create(file: fileName, at: atPath, contents: data, completionHandler: completionHandler) else { return nil }
+        return CloudOperationHandle(operationType: r.operationType, baseURL: self.baseURL)
+    }
+    
+    /**
+     Moves a file or directory from `path` to designated path asynchronously.
+     When you want move a file, destination path should also consists of file name.
+     Either a new name or the old one.
+     
+     - Parameters:
+       - path: original file or directory path.
+       - to: destination path of file or directory, including file/directory name.
+       - overwrite: Destination file should be overwritten if file is already exists. **Default** is `false`.
+       - completionHandler: If an error parameter was provided, a presentable `Error` will be returned.
+     - Returns: An `OperationHandle` to get progress or cancel progress. Doesn't work on `CloudFileProvider`.
+     */
+    @discardableResult
+    open override func moveItem(path: String, to toPath: String, overwrite: Bool = false, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        guard let r = super.moveItem(path: path, to: toPath, overwrite: overwrite, completionHandler: completionHandler) else { return nil }
+        return CloudOperationHandle(operationType: r.operationType, baseURL: self.baseURL)
+    }
+    
+    /**
+     Copies a file or directory from `path` to designated path asynchronously.
+     When want copy a file, destination path should also consists of file name.
+     Either a new name or the old one.
+     
+     - Parameters:
+       - path: original file or directory path.
+       - to: destination path of file or directory, including file/directory name.
+       - overwrite: Destination file should be overwritten if file is already exists. **Default** is `false`.
+       - completionHandler: If an error parameter was provided, a presentable `Error` will be returned.
+     - Returns: An `OperationHandle` to get progress or cancel progress. Doesn't work on `CloudFileProvider`.
+     */
+    @discardableResult
+    open override func copyItem(path: String, to toPath: String, overwrite: Bool = false, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        guard let r = super.copyItem(path: path, to: toPath, overwrite: overwrite, completionHandler: completionHandler) else { return nil }
+        return CloudOperationHandle(operationType: r.operationType, baseURL: self.baseURL)
+    }
+    
+    /**
+     Removes the file or directory at the specified path.
+     
+     - Important: Due to a bug (race condition?) in Apple API, it takes about 3-5 seconds to update containing folder
+       list and triggering notification registered for directory while completion handler will run almost immediately.
+       It's your responsibility to workaourd this bug/feature and mark file as deleted in your software.
+     
+     - Parameters:
+       - path: file or directory path.
+       - completionHandler: If an error parameter was provided, a presentable `Error` will be returned.
+     - Returns: An `OperationHandle` to get progress or cancel progress. Doesn't work on `CloudFileProvider`.
+     
+     */
+    @discardableResult
+    open override func removeItem(path: String, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        guard let r = super.removeItem(path: path, completionHandler: completionHandler) else { return nil }
+        return CloudOperationHandle(operationType: r.operationType, baseURL: self.baseURL)
+    }
+    
+    /**
+     Uploads a file from local file url to designated path asynchronously.
+     Method will fail if source is not a local url with `file://` scheme.
+     
+     - Parameters:
+       - localFile: a file url to file.
+       - to: destination path of file, including file/directory name.
+       - overwrite: Destination file should be overwritten if file is already exists. **Default** is `false`.
+       - completionHandler: If an error parameter was provided, a presentable `Error` will be returned.
+     - Returns: An `OperationHandle` to get progress or cancel progress.
+     */
+    @discardableResult
+    open override func copyItem(localFile: URL, to toPath: String, overwrite: Bool, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        // TODO: Make use of overwrite parameter
+        let opType = FileOperationType.copy(source: localFile.absoluteString, destination: toPath)
+        operation_queue.addOperation {
+            let tempFolder: URL
+            if #available(iOS 10.0, macOS 10.12, tvOS 10.0, *) {
+                tempFolder = FileManager.default.temporaryDirectory
+            } else {
+                tempFolder = URL(fileURLWithPath: NSTemporaryDirectory())
+            }
+            let tmpFile = tempFolder.appendingPathComponent(UUID().uuidString)
+            
+            do {
+                try self.opFileManager.copyItem(at: localFile, to: tmpFile)
+                let toUrl = self.url(of: toPath)
+                try self.opFileManager.setUbiquitous(true, itemAt: tmpFile, destinationURL: toUrl)
+                completionHandler?(nil)
+                DispatchQueue.main.async(execute: {
+                    self.delegate?.fileproviderSucceed(self, operation: opType)
+                })
+            } catch let e {
+                if self.opFileManager.fileExists(atPath: tmpFile.path) {
+                    try? self.opFileManager.removeItem(at: tmpFile)
+                }
+                completionHandler?(e)
+                DispatchQueue.main.async(execute: {
+                    self.delegate?.fileproviderFailed(self, operation: opType)
+                })
+            }
+        }
+        return CloudOperationHandle(operationType: opType, baseURL: self.baseURL)
+    }
+    
+    /**
+     Download a file from `path` to designated local file url asynchronously.
+     Method will fail if destination is not a local url with `file://` scheme.
+     
+     - Parameters:
+       - path: original file or directory path.
+       - toLocalURL: destination local url of file, including file/directory name.
+       - completionHandler: If an error parameter was provided, a presentable `Error` will be returned.
+     - Returns: An `OperationHandle` to get progress or cancel progress.
+     */
+    @discardableResult
+    open override func copyItem(path: String, toLocalURL: URL, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.copy(source: path, destination: toLocalURL.absoluteString)
+        
+        do {
+            try self.opFileManager.startDownloadingUbiquitousItem(at: self.url(of: path))
+        } catch let e {
+            completionHandler?(e)
+            DispatchQueue.main.async(execute: {
+                self.delegate?.fileproviderFailed(self, operation: opType)
+            })
+            return nil
+        }
+        
+        guard let r = super.copyItem(path: path, toLocalURL: toLocalURL, completionHandler: completionHandler) else { return nil }
+        return CloudOperationHandle(operationType: r.operationType, baseURL: self.baseURL)
+    }
+    
+    /**
+     Retreives a `Data` object with the contents of the file asynchronously vis contents argument of completion handler.
+     If path specifies a directory, or if some other error occurs, data will be nil.
+     
+     - Parameters:
+       - path: Path of file.
+       - completionHandler: a closure with result of file contents or error.
+         `contents`: contents of file in a `Data` object.
+         `error`: Error returned by system.
+     - Returns: An `OperationHandle` to get progress or cancel progress.
+     */
+    @discardableResult
+    open override func contents(path: String, completionHandler: @escaping ((_ contents: Data?, _ error: Error?) -> Void)) -> OperationHandle? {
+        guard let r = super.contents(path: path, completionHandler: completionHandler) else { return nil }
+        return CloudOperationHandle(operationType: r.operationType, baseURL: self.baseURL)
+    }
+    
+    /**
+     Retreives a `Data` object with a portion contents of the file asynchronously vis contents argument of completion handler.
+     If path specifies a directory, or if some other error occurs, data will be nil.
+     
+     - Parameters:
+       - path: Path of file.
+       - offset: First byte index which should be read. **Starts from 0.**
+       - length: Bytes count of data. Pass `-1` to read until the end of file.
+       - completionHandler: a closure with result of file contents or error.
+         `contents`: contents of file in a `Data` object.
+         `error`: Error returned by system.
+     - Returns: An `OperationHandle` to get progress or cancel progress.
+     */
+    @discardableResult
+    open override func contents(path: String, offset: Int64, length: Int, completionHandler: @escaping ((_ contents: Data?, _ error: Error?) -> Void)) -> OperationHandle? {
+        guard let r = super.contents(path: path, offset: offset, length: length, completionHandler: completionHandler) else { return nil }
+        return CloudOperationHandle(operationType: r.operationType, baseURL: self.baseURL)
+    }
+    
+    /**
+     Write the contents of the `Data` to a location asynchronously.
+     
+     - Parameters:
+       - path: Path of target file.
+       - contents: Data to be written into file.
+       - overwrite: Destination file should be overwritten if file is already exists. Default is `false`.
+       - atomically: data will be written to a temporary file before writing to final location. Default is `false`.
+       - completionHandler: If an error parameter was provided, a presentable `Error` will be returned.
+     - Returns: An `OperationHandle` to get progress or cancel progress. Doesn't work on `LocalFileProvider`.
+     */
+    @discardableResult
+    open override func writeContents(path: String, contents data: Data, atomically: Bool, overwrite: Bool, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        guard let r = super.writeContents(path: path, contents: data, atomically: atomically, overwrite: overwrite, completionHandler: completionHandler) else { return nil }
+        return CloudOperationHandle(operationType: r.operationType, baseURL: self.baseURL)
+    }
+    
+    fileprivate var monitors = [String: (NSMetadataQuery, NSObjectProtocol)]()
+    
+    /**
+     Starts monitoring a path and its subpaths, including files and folders, for any change,
+     including copy, move/rename, content changes, etc.
+     To avoid thread congestion, `evetHandler` will be triggered with 0.2 seconds interval,
+     and has a 0.25 second delay, to ensure it's called after updates.
+     
+     - Note: this functionality is available only in `LocalFileProvider` and `CloudFileProvider`.
+     - Note: `eventHandler` is not called on main thread, for updating UI. dispatch routine to main thread.
+     - Important: `eventHandler` may be called if file is changed in recursive subpaths of registered path.
+     This may cause negative impact on performance if a root path is being monitored.
+     
+     - Parameters:
+       - path: path of directory.
+       - eventHandler: Closure executed after change, on a secondary thread.
+     */
+    open override func registerNotifcation(path: String, eventHandler: @escaping (() -> Void)) {
+        self.unregisterNotifcation(path: path)
+        let pathURL = self.url(of: path)
+        let query = NSMetadataQuery()
+        query.predicate = NSPredicate(format: "(%K BEGINSWITH %@)", NSMetadataItemPathKey, pathURL.path)
+        query.valueListAttributes = []
+        query.searchScopes = [self.scope.rawValue]
+        
+        let updateObserver = NotificationCenter.default.addObserver(forName: .NSMetadataQueryDidUpdate, object: query, queue: nil, using: { (notification) in
+            
+            query.disableUpdates()
+            
+            eventHandler()
+            
+            query.enableUpdates()
+        })
+        
+        DispatchQueue.main.async {
+            if query.start() {
+                self.monitors[path] = (query, updateObserver)
+            }
+        }
+    }
+    
+    /// Stops monitoring the path.
+    ///
+    /// - Parameter path: path of directory.
+    open override func unregisterNotifcation(path: String) {
+        guard let (query, observer) = monitors[path] else {
+            return
+        }
+        query.disableUpdates()
+        query.stop()
+        NotificationCenter.default.removeObserver(observer)
+        monitors.removeValue(forKey: path)
+    }
+    
+    /// Investigate either the path is registered for change notification or not.
+    ///
+    /// - Parameter path: path of directory.
+    /// - Returns: Directory is being monitored or not.
+    open override func isRegisteredForNotification(path: String) -> Bool {
+        return monitors[path] != nil
+    }
+    
+    open override func copy(with zone: NSZone? = nil) -> Any {
+        let copy = CloudFileProvider(containerId: self.containerId)
+        copy?.currentPath = self.currentPath
+        copy?.delegate = self.delegate
+        copy?.fileOperationDelegate = self.fileOperationDelegate
+        copy?.isPathRelative = self.isPathRelative
+        return copy as Any
+    }
+    
+    fileprivate func mapFileObject(attributes attribs: [String: Any]) -> FileObject? {
+        guard let url = (attribs[NSMetadataItemURLKey] as? URL)?.standardizedFileURL, let name = attribs[NSMetadataItemFSNameKey] as? String else {
+            return nil
+        }
+        
+        let path = self.relativePathOf(url: url)
+        let rpath = path.hasPrefix("/") ? path.substring(from: path.index(after: path.startIndex)) : path
+        let relativeUrl = URL(string: rpath, relativeTo: self.baseURL)
+        let file = FileObject(url: relativeUrl ?? url, name: name, path: path)
+        
+        file.size = (attribs[NSMetadataItemFSSizeKey] as? NSNumber)?.int64Value ?? -1
+        file.creationDate = attribs[NSMetadataItemFSCreationDateKey] as? Date
+        file.modifiedDate = attribs[NSMetadataItemFSContentChangeDateKey] as? Date
+        let isFolder = (attribs[NSMetadataItemContentTypeTreeKey] as? [String])?.contains("public.folder") ?? false
+        let isSymbolic = (attribs[NSMetadataItemContentTypeTreeKey] as? [String])?.contains("public.symlink") ?? false
+        file.type = isFolder ? .directory : (isSymbolic ? .symbolicLink : .regular)
+        
+        return file
+    }
+    
+    /// Removes local copy of file, but spares cloud copy/
+    /// - Parameter path: Path of file or directory to be remoed from local
+    /// - Parameter completionHandler: If an error parameter was provided, a presentable `Error` will be returned.
+    open func evictItem(path: String, completionHandler: SimpleCompletionHandler) {
+        operation_queue.addOperation {
+            do {
+                try self.opFileManager.evictUbiquitousItem(at: self.url(of: path))
+                completionHandler?(nil)
+            } catch let e {
+                completionHandler?(e)
+            }
+        }
+    }
+    
+    /**
+     Genrates a public url to a file to be shared with other users and can be downloaded without authentication.
+     
+     - Important: URL will be available for a limitied time, determined in `expiration` argument.
+     
+     - Parameters:
+     - to: path of file, including file/directory name.
+     - completionHandler: a closure with result of directory entries or error.
+     `link`: a url returned by Dropbox to share.
+     `attribute`: a `FileObject` containing the attributes of the item.
+     `expiration`: a `Date` object, determines when the public url will expires.
+     `error`: Error returned by Dropbox.
+     */
+    open func publicLink(to path: String, completionHandler: @escaping ((_ link: URL?, _ attribute: FileObject?, _ expiration: Date?, _ error: Error?) -> Void)) {
+        operation_queue.addOperation {
+            do {
+                var expiration: NSDate?
+                let url = try self.opFileManager.url(forPublishingUbiquitousItemAt: self.url(of: path), expiration: &expiration)
+                self.dispatch_queue.async {
+                    completionHandler(url, nil, expiration as Date?, nil)
+                }
+            } catch let e {
+                self.dispatch_queue.async {
+                    completionHandler(nil, nil, nil, e)
+                }
+            }
+        }
+    }
+}
+
+public enum UbiquitousScope: RawRepresentable {
+    /// Search all files not in the Documents directories of the app’s iCloud container directories.
+    /// Use this scope to store user-related data files that your app needs to share 
+    /// but that are not files you want the user to manipulate directly.
+    case data
+    /// Search all files in the Documents directories of the app’s iCloud container directories.
+    /// Put documents that the user is allowed to access inside a Documents subdirectory.
+    case documents
+    
+    public typealias RawValue = String
+    
+    public init? (rawValue: String) {
+        switch rawValue {
+        case NSMetadataQueryUbiquitousDataScope:
+            self = .data
+        case NSMetadataQueryUbiquitousDocumentsScope:
+            self = .documents
+        default:
+            return nil
+        }
+    }
+    
+    public var rawValue: String {
+        switch self {
+        case .data:
+            return NSMetadataQueryUbiquitousDataScope
+        case .documents:
+            return NSMetadataQueryUbiquitousDocumentsScope
+        }
+    }
+}
+
+open class CloudOperationHandle: OperationHandle {
+    public let baseURL: URL?
+    public let operationType: FileOperationType
+    
+    init (operationType: FileOperationType, baseURL: URL?) {
+        self.baseURL = baseURL
+        self.operationType = operationType
+    }
+    
+    private var sourceURL: URL? {
+        guard let source = operationType.source, let baseURL = baseURL else { return nil }
+        return source.hasPrefix("file://") ? URL(fileURLWithPath: source) : baseURL.appendingPathComponent(source)
+    }
+    
+    private var destURL: URL? {
+        guard let dest = operationType.destination, let baseURL = baseURL else { return nil }
+        return dest.hasPrefix("file://") ? URL(fileURLWithPath: dest) : baseURL.appendingPathComponent(dest)
+    }
+    
+    open var bytesSoFar: Int64 {
+        assert(!Thread.isMainThread, "Don't run \(#function) method on main thread")
+        
+        guard let url = destURL ?? sourceURL, let item = CloudOperationHandle.getMetadataItem(url: url) else { return 0 }
+        let downloaded = item.value(forAttribute: NSMetadataUbiquitousItemPercentDownloadedKey) as? Double ?? 0
+        let uploaded = item.value(forAttribute: NSMetadataUbiquitousItemPercentUploadedKey) as? Double ?? 0
+        guard let size = item.value(forAttribute: NSMetadataItemFSSizeKey) as? Int64 else { return -1 }
+        if (downloaded == 0 || downloaded == 100) && (uploaded > 0 && uploaded < 100) {
+            return Int64(uploaded * (Double(size) / 100))
+        } else if (uploaded == 0 || uploaded == 100) && (downloaded > 0 && downloaded < 100) {
+            return Int64(downloaded * (Double(size) / 100))
+        } else if uploaded == 100 || downloaded == 100 {
+            return size
+        }
+        return 0
+    }
+    
+    open var totalBytes: Int64 {
+        assert(!Thread.isMainThread, "Don't run \(#function) method on main thread")
+        guard let url = destURL ?? sourceURL, let item = CloudOperationHandle.getMetadataItem(url: url) else { return -1 }
+        return item.value(forAttribute: NSMetadataItemFSSizeKey) as? Int64 ?? -1
+    }
+    
+    open var inProgress: Bool {
+        guard let url = destURL ?? sourceURL, let item = CloudOperationHandle.getMetadataItem(url: url) else { return false }
+        let downloadStatus = item.value(forAttribute: NSMetadataUbiquitousItemDownloadingStatusKey) as? String ?? NSMetadataUbiquitousItemDownloadingStatusNotDownloaded
+        let isUploading = item.value(forAttribute: NSMetadataUbiquitousItemIsUploadingKey) as? Bool ?? false
+        return downloadStatus == NSMetadataUbiquitousItemDownloadingStatusCurrent || isUploading
+    }
+    
+    /// Not usable in local provider
+    open func cancel() -> Bool {
+        return false
+    }
+    
+    fileprivate static func getMetadataItem(url: URL) -> NSMetadataItem? {
+        let query = NSMetadataQuery()
+        query.predicate = NSPredicate(format: "(%K LIKE %@)", NSMetadataItemPathKey, url.path)
+        query.searchScopes = [NSMetadataQueryUbiquitousDocumentsScope, NSMetadataQueryUbiquitousDataScope]
+        
+        var item: NSMetadataItem?
+        
+        let group = DispatchGroup()
+        group.enter()
+        var finishObserver: NSObjectProtocol?
+        finishObserver = NotificationCenter.default.addObserver(forName: .NSMetadataQueryDidFinishGathering, object: query, queue: nil, using: { (notification) in
+            defer {
+                query.stop()
+                group.leave()
+                NotificationCenter.default.removeObserver(finishObserver!)
+            }
+            
+            if query.resultCount > 0 {
+                item = query.result(at: 0) as? NSMetadataItem
+            }
+            
+            query.disableUpdates()
+            
+        })
+        
+        DispatchQueue.main.async {
+            query.start()
+        }
+        _ = group.wait(timeout: DispatchTime.now() + 30)
+        return item
+    }
+}

Sources/DropboxFileProvider.swift

@@ -0,0 +1,568 @@
+
+//
+//  DropboxFileProvider.swift
+//  FileProvider
+//
+//  Created by Amir Abbas Mousavian.
+//  Copyright © 2016 Mousavian. Distributed under MIT license.
+//
+
+import Foundation
+import CoreGraphics
+
+/**
+ Allows accessing to Dropbox stored files. This provider doesn't cache or save files internally, however you can
+ set `useCache` and `cache` properties to use Foundation `NSURLCache` system.
+ 
+ - Note: Uploading files and data are limited to 150MB, for now.
+ */
+open class DropboxFileProvider: FileProviderBasicRemote {
+    open class var type: String { return "DropBox" }
+    open let isPathRelative: Bool
+    open let baseURL: URL?
+    open var currentPath: String
+    
+    /// Dropbox RPC API URL, which is equal with [https://api.dropboxapi.com/2/](https://api.dropboxapi.com/2/)
+    open let apiURL: URL
+    /// Dropbox contents download/upload API URL, which is equal with [https://content.dropboxapi.com/2/](https://content.dropboxapi.com/2/)
+    open let contentURL: URL
+    
+    open var dispatch_queue: DispatchQueue
+    open var operation_queue: OperationQueue {
+        willSet {
+            assert(_session == nil, "It's not effective to change dispatch_queue property after session is initialized.")
+        }
+    }
+    
+    open weak var delegate: FileProviderDelegate?
+    open let credential: URLCredential?
+    open private(set) var cache: URLCache?
+    public var useCache: Bool
+    public var validatingCache: Bool
+   
+    fileprivate var _session: URLSession?
+    fileprivate var sessionDelegate: SessionDelegate?
+    public var session: URLSession {
+        if _session == nil {
+            self.sessionDelegate = SessionDelegate(fileProvider: self, credential: credential)
+            let config = URLSessionConfiguration.default
+            config.urlCache = cache
+            config.requestCachePolicy = .returnCacheDataElseLoad
+            _session = URLSession(configuration: config, delegate: sessionDelegate as URLSessionDelegate?, delegateQueue: self.operation_queue)
+        }
+        return _session!
+    }
+    
+    /**
+     Initializer for Dropbox provider with given client ID and Token.
+     These parameters must be retrieved via [OAuth2 API of Dropbox](https://www.dropbox.com/developers/reference/oauth-guide).
+     
+     There are libraries like [p2/OAuth2](https://github.com/p2/OAuth2) or [OAuthSwift](https://github.com/OAuthSwift/OAuthSwift) which can facilate the procedure to retrieve token. 
+     The latter is easier to use and prefered. Also you can use [auth0/Lock](https://github.com/auth0/Lock.iOS-OSX) which provides graphical user interface.
+     
+     - Parameter credential: a `URLCredential` object with Client ID set as `user` and Token set as `password`.
+     - Parameter cache: A URLCache to cache downloaded files and contents.
+    */
+    public init(credential: URLCredential?, cache: URLCache? = nil) {
+        self.baseURL = nil
+        self.isPathRelative = true
+        self.currentPath = ""
+        self.useCache = false
+        self.validatingCache = true
+        self.cache = cache
+        self.credential = credential
+        
+        self.apiURL = URL(string: "https://api.dropboxapi.com/2/")!
+        self.contentURL = URL(string: "https://content.dropboxapi.com/2/")!
+        
+        dispatch_queue = DispatchQueue(label: "FileProvider.\(type(of: self).type)", attributes: .concurrent)
+        operation_queue = OperationQueue()
+        operation_queue.name = "FileProvider.\(type(of: self).type).Operation"
+
+    }
+    
+    deinit {
+        if fileProviderCancelTasksOnInvalidating {
+            _session?.invalidateAndCancel()
+        } else {
+            _session?.finishTasksAndInvalidate()
+        }
+    }
+    
+    open func contentsOfDirectory(path: String, completionHandler: @escaping ((_ contents: [FileObject], _ error: Error?) -> Void)) {
+        list(path) { (contents, cursor, error) in
+            completionHandler(contents, error)
+        }
+    }
+    
+    open func attributesOfItem(path: String, completionHandler: @escaping ((_ attributes: FileObject?, _ error: Error?) -> Void)) {
+        let url = URL(string: "files/get_metadata", relativeTo: apiURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "POST"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        request.setValue("application/json", forHTTPHeaderField: "Content-Type")
+        let requestDictionary: [String: AnyObject] = ["path": correctPath(path)! as NSString]
+        request.httpBody = dictionaryToJSON(requestDictionary)?.data(using: .utf8)
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var serverError: FileProviderDropboxError?
+            var fileObject: DropboxFileObject?
+            if let response = response as? HTTPURLResponse {
+                let code = FileProviderHTTPErrorCode(rawValue: response.statusCode)
+                serverError = code != nil ? FileProviderDropboxError(code: code!, path: path, errorDescription: String(data: data ?? Data(), encoding: .utf8)) : nil
+                if let data = data, let jsonStr = String(data: data, encoding: .utf8), let json = jsonToDictionary(jsonStr), let file = DropboxFileObject(json: json) {
+                    fileObject = file
+                }
+            }
+            completionHandler(fileObject, serverError ?? error)
+        }) 
+        task.resume()
+    }
+    
+    open func storageProperties(completionHandler: @escaping ((_ total: Int64, _ used: Int64) -> Void)) {
+        let url = URL(string: "users/get_space_usage", relativeTo: apiURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "POST"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var totalSize: Int64 = -1
+            var usedSize: Int64 = 0
+            if let data = data, let jsonStr = String(data: data, encoding: .utf8), let json = jsonToDictionary(jsonStr) {
+                totalSize = ((json["allocation"] as? NSDictionary)?["allocated"] as? NSNumber)?.int64Value ?? -1
+                usedSize = (json["used"] as? NSNumber)?.int64Value ?? 0
+            }
+            completionHandler(totalSize, usedSize)
+        }) 
+        task.resume()
+    }
+    
+    open func searchFiles(path: String, recursive: Bool, query: NSPredicate, foundItemHandler: ((FileObject) -> Void)?, completionHandler: @escaping ((_ files: [FileObject], _ error: Error?) -> Void)) {
+        var foundFiles = [DropboxFileObject]()
+        guard let queryStr = self.findNameQuery(query, key: "name") as? String else { return }
+        search(path, query: queryStr, foundItem: { (file) in
+            if query.evaluate(with: file.mapPredicate()) {
+                foundFiles.append(file)
+                foundItemHandler?(file)
+            }
+        }, completionHandler: { (error) in
+            completionHandler(foundFiles, error)
+        })
+    }
+    
+    open func isReachable(completionHandler: @escaping (Bool) -> Void) {
+        self.storageProperties { total, _ in
+            completionHandler(total > 0)
+        }
+    }
+    
+    open weak var fileOperationDelegate: FileOperationDelegate?
+}
+
+extension DropboxFileProvider: FileProviderOperations {
+    open func create(folder folderName: String, at atPath: String, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let path = (atPath as NSString).appendingPathComponent(folderName) + "/"
+        return doOperation(.create(path: path), completionHandler: completionHandler)
+    }
+    
+    open func create(file fileName: String, at path: String, contents data: Data?, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let filePath = (path as NSString).appendingPathComponent(fileName)
+        return self.writeContents(path: filePath, contents: data ?? Data(), completionHandler: completionHandler)
+    }
+    
+    open func moveItem(path: String, to toPath: String, overwrite: Bool, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        return doOperation(.move(source: path, destination: toPath), completionHandler: completionHandler)
+    }
+    
+    open func copyItem(path: String, to toPath: String, overwrite: Bool, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        return doOperation(.copy(source: path, destination: toPath), completionHandler: completionHandler)
+    }
+    
+    open func removeItem(path: String, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        return doOperation(.remove(path: path), completionHandler: completionHandler)
+    }
+    
+    fileprivate func doOperation(_ operation: FileOperationType, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        guard fileOperationDelegate?.fileProvider(self, shouldDoOperation: operation) ?? true == true else {
+            return nil
+        }
+        let url: String
+        guard let sourcePath = operation.source else { return nil }
+        let destPath = operation.destination
+        switch operation {
+        case .create:
+            url = "files/create_folder"
+        case .copy:
+            url = "files/copy"
+        case .move:
+            url = "files/move"
+        case .remove:
+            url = "files/delete"
+        default: // modify, link, fetch
+            return nil
+        }
+        var request = URLRequest(url: URL(string: url, relativeTo: apiURL)!)
+        request.httpMethod = "POST"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        request.setValue("application/json", forHTTPHeaderField: "Content-Type")
+        var requestDictionary = [String: AnyObject]()
+        if let dest = correctPath(destPath) as NSString? {
+            requestDictionary["from_path"] = correctPath(sourcePath) as NSString?
+            requestDictionary["to_path"] = dest
+        } else {
+            requestDictionary["path"] = correctPath(sourcePath) as NSString?
+        }
+        request.httpBody = dictionaryToJSON(requestDictionary)?.data(using: .utf8)
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var serverError: FileProviderDropboxError?
+            if let response = response as? HTTPURLResponse, response.statusCode >= 300, let code = FileProviderHTTPErrorCode(rawValue: response.statusCode) {
+                 serverError = FileProviderDropboxError(code: code, path: sourcePath, errorDescription: String(data: data ?? Data(), encoding: .utf8))
+            }
+            completionHandler?(serverError ?? error)
+            self.delegateNotify(operation, error: serverError ?? error)
+        })
+        task.taskDescription = operation.json
+        task.resume()
+        return RemoteOperationHandle(operationType: operation, tasks: [task])
+    }
+    
+    open func copyItem(localFile: URL, to toPath: String, overwrite: Bool, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.copy(source: localFile.absoluteString, destination: toPath)
+        guard fileOperationDelegate?.fileProvider(self, shouldDoOperation: opType) ?? true == true else {
+            return nil
+        }
+        return upload_simple(toPath, localFile: localFile, overwrite: overwrite, operation: opType, completionHandler: completionHandler)
+    }
+    
+    open func copyItem(path: String, toLocalURL destURL: URL, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.copy(source: path, destination: destURL.absoluteString)
+        guard fileOperationDelegate?.fileProvider(self, shouldDoOperation: opType) ?? true == true else {
+            return nil
+        }
+        let url = URL(string: "files/download", relativeTo: contentURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "GET"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        let requestDictionary: [String: AnyObject] = ["path": path as NSString]
+        let requestJson = dictionaryToJSON(requestDictionary) ?? ""
+        request.setValue(requestJson, forHTTPHeaderField: "Dropbox-API-Arg")
+        let task = session.downloadTask(with: request, completionHandler: { (cacheURL, response, error) in
+            guard let cacheURL = cacheURL, let httpResponse = response as? HTTPURLResponse , httpResponse.statusCode < 300 else {
+                let code = FileProviderHTTPErrorCode(rawValue: (response as? HTTPURLResponse)?.statusCode ?? -1)
+                let errorData : Data? = nil //Data(contentsOf:cacheURL) // TODO: Figure out how to get error response data for the error description
+                let serverError : FileProviderDropboxError? = code != nil ? FileProviderDropboxError(code: code!, path: path, errorDescription: String(data: errorData ?? Data(), encoding: .utf8)) : nil
+                completionHandler?(serverError ?? error)
+                return
+            }
+            do {
+                try FileManager.default.moveItem(at: cacheURL, to: destURL)
+                completionHandler?(nil)
+            } catch let e {
+                completionHandler?(e)
+            }
+        })
+        task.taskDescription = opType.json
+        task.resume()
+        return RemoteOperationHandle(operationType: opType, tasks: [task])
+    }
+}
+
+extension DropboxFileProvider: FileProviderReadWrite {
+    open func contents(path: String, offset: Int64, length: Int, completionHandler: @escaping ((_ contents: Data?, _ error: Error?) -> Void)) -> OperationHandle? {
+        if length == 0 || offset < 0 {
+            dispatch_queue.async {
+                completionHandler(Data(), nil)
+            }
+            return nil
+        }
+        
+        let opType = FileOperationType.fetch(path: path)
+        let url = URL(string: "files/download", relativeTo: contentURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "GET"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        if length > 0 {
+            request.setValue("bytes=\(offset)-\(offset + length - 1)", forHTTPHeaderField: "Range")
+        } else if offset > 0 && length < 0 {
+            request.setValue("bytes=\(offset)-", forHTTPHeaderField: "Range")
+        }
+        let requestDictionary: [String: AnyObject] = ["path": correctPath(path)! as NSString]
+        request.setValue(dictionaryToJSON(requestDictionary), forHTTPHeaderField: "Dropbox-API-Arg")
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var serverError: FileProviderDropboxError?
+            if let httpResponse = response as? HTTPURLResponse , httpResponse.statusCode >= 300, let code = FileProviderHTTPErrorCode(rawValue: httpResponse.statusCode) {
+                serverError = FileProviderDropboxError(code: code, path: path, errorDescription: String(data: data ?? Data(), encoding: .utf8))
+            }
+            let filedata = serverError ?? error == nil ? data : nil
+            completionHandler(filedata, serverError ?? error)
+        })
+        task.taskDescription = opType.json
+        task.resume()
+        return RemoteOperationHandle(operationType: opType, tasks: [task])
+    }
+    
+    public func writeContents(path: String, contents data: Data, atomically: Bool, overwrite: Bool, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.modify(path: path)
+        guard fileOperationDelegate?.fileProvider(self, shouldDoOperation: opType) ?? true == true else {
+            return nil
+        }
+        // FIXME: remove 150MB restriction
+        return upload_simple(path, data: data, overwrite: overwrite, operation: opType, completionHandler: completionHandler)
+    }
+    
+    /*
+    fileprivate func registerNotifcation(path: String, eventHandler: (() -> Void)) {
+        /* There is two ways to monitor folders changing in Dropbox. Either using webooks
+         * which means you have to implement a server to translate it to push notifications
+         * or using apiv2 list_folder/longpoll method. The second one is implemeted here.
+         * Tough webhooks are much more efficient, longpoll is much simpler to implement!
+         * You can implemnt your own webhook service and replace this method accordingly.
+         */
+        NotImplemented()
+    }
+    fileprivate func unregisterNotifcation(path: String) {
+        NotImplemented()
+    }
+    */
+    // TODO: Implement /get_account & /get_current_account
+}
+
+extension DropboxFileProvider {
+    /// *DEPRECATED:* Use `publicLink(to:, completionHandler: (URL?, DropboxFileObject?, Date?,  Error?))` function instead.
+    @available(*, deprecated, renamed: "publicLink(to:completionHandler:)", message: "Use publicLink(to:, completionHandler: (URL?, DropboxFileObject?, Date?,  Error?)) function instead.")
+    open func temporaryLink(to path: String, completionHandler: @escaping ((_ link: URL?, _ attribute: DropboxFileObject?, _ error: Error?) -> Void)) {
+        self.publicLink(to: path) { (url, file, _, error) in
+            completionHandler(url, file, error)
+        }
+    }
+    
+    /// *DEPRECATED:* Use `publicLink(to:, completionHandler: (URL?, DropboxFileObject?, Date?,  Error?))` function instead.
+    @available(*, deprecated, renamed: "publicLink(to:completionHandler:)", message: "Use publicLink(to:, completionHandler: (URL?, DropboxFileObject?, Date?,  Error?)) function instead.")
+    open func temporaryLink(to path: String, completionHandler: @escaping ((_ link: URL?, _ attribute: DropboxFileObject?, _ expiration: Date?, _ error: Error?) -> Void)) {
+        self.publicLink(to: path) { (url, file, expiration, error) in
+            completionHandler(url, file, expiration, error)
+        }
+    }
+    
+    /**
+     Genrates a public url to a file to be shared with other users and can be downloaded without authentication.
+     
+     - Important: URL will be available for a limitied time (4 hours according to Dropbox documentation).
+     
+     - Parameters:
+       - to: path of file, including file/directory name.
+       - completionHandler: a closure with result of directory entries or error.
+         `link`: a url returned by Dropbox to share.
+         `attribute`: a `FileObject` containing the attributes of the item.
+         `expiration`: a `Date` object, determines when the public url will expires.
+         `error`: Error returned by Dropbox.
+    */
+    open func publicLink(to path: String, completionHandler: @escaping ((_ link: URL?, _ attribute: DropboxFileObject?, _ expiration: Date?, _ error: Error?) -> Void)) {
+        let url = URL(string: "files/get_temporary_link", relativeTo: apiURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "POST"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        request.setValue("application/json", forHTTPHeaderField: "Content-Type")
+        let requestDictionary: [String: AnyObject] = ["path": correctPath(path)! as NSString]
+        request.httpBody = dictionaryToJSON(requestDictionary)?.data(using: .utf8)
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var serverError: FileProviderDropboxError?
+            var link: URL?
+            var fileObject: DropboxFileObject?
+            if let response = response as? HTTPURLResponse {
+                let code = FileProviderHTTPErrorCode(rawValue: response.statusCode)
+                serverError = code != nil ? FileProviderDropboxError(code: code!, path: path, errorDescription: String(data: data ?? Data(), encoding: .utf8)) : nil
+                if let data = data, let jsonStr = String(data: data, encoding: .utf8), let json = jsonToDictionary(jsonStr) {
+                    if let linkStr = json["link"] as? String {
+                        link = URL(string: linkStr)
+                    }
+                    if let attribDic = json["metadata"] as? [String: AnyObject] {
+                        fileObject = DropboxFileObject(json: attribDic)
+                    }
+                }
+            }
+            
+            let expiration: Date? = link != nil ? Date(timeIntervalSinceNow: 4 * 60 * 60) : nil
+            completionHandler(link, fileObject, expiration, serverError ?? error)
+        })
+        task.resume()
+    }
+    
+    /**
+     Downloads a file from remote url to designated path asynchronously.
+     
+     - Parameters:
+       - remoteURL: a valid remote url to file.
+       - to: Destination path of file, including file/directory name.
+       - completionHandler: a closure with result of directory entries or error.
+         `jobId`: Job ID returned by Dropbox to monitor the copy/download progress.
+         `attribute`: A `FileObject` containing the attributes of the item.
+         `error`: Error returned by Dropbox.
+     */
+    open func copyItem(remoteURL: URL, to toPath: String, completionHandler: @escaping ((_ jobId: String?, _ attribute: DropboxFileObject?, _ error: Error?) -> Void)) {
+        if remoteURL.isFileURL {
+            completionHandler(nil, nil, self.throwError(remoteURL.path, code: URLError.badURL))
+            return
+        }
+        let url = URL(string: "files/save_url", relativeTo: apiURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "POST"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        request.setValue("application/json", forHTTPHeaderField: "Content-Type")
+        let requestDictionary: [String: AnyObject] = ["path": correctPath(toPath)! as NSString, "url" : remoteURL.absoluteString as NSString]
+        request.httpBody = dictionaryToJSON(requestDictionary)?.data(using: .utf8)
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var serverError: FileProviderDropboxError?
+            var jobId: String?
+            var fileObject: DropboxFileObject?
+            if let response = response as? HTTPURLResponse {
+                let code = FileProviderHTTPErrorCode(rawValue: response.statusCode)
+                serverError = code != nil ? FileProviderDropboxError(code: code!, path: toPath, errorDescription: String(data: data ?? Data(), encoding: .utf8)) : nil
+                if let data = data, let jsonStr = String(data: data, encoding: .utf8), let json = jsonToDictionary(jsonStr) {
+                    jobId = json["async_job_id"] as? String
+                    if let attribDic = json["metadata"] as? [String: AnyObject] {
+                        fileObject = DropboxFileObject(json: attribDic)
+                    }
+                }
+            }
+            completionHandler(jobId, fileObject, serverError ?? error)
+        })
+        task.resume()
+    }
+    
+    /**
+     Copys a file from another user Dropbox storage to designated path asynchronously.
+     
+     - Parameters:
+       - reference: a valid reference string from another user via `copy_reference/get` REST method.
+       - to: Destination path of file, including file/directory name.
+       - completionHandler: If an error parameter was provided, a presentable `Error` will be returned.
+     */
+    open func copyItem(reference: String, to toPath: String, completionHandler: SimpleCompletionHandler) {
+        let url = URL(string: "files/copy_reference/save", relativeTo: apiURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "POST"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        request.setValue("application/json", forHTTPHeaderField: "Content-Type")
+        let requestDictionary: [String: AnyObject] = ["path": correctPath(toPath)! as NSString, "copy_reference" : reference as NSString]
+        request.httpBody = dictionaryToJSON(requestDictionary)?.data(using: .utf8)
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var serverError: FileProviderDropboxError?
+            if let response = response as? HTTPURLResponse {
+                let code = FileProviderHTTPErrorCode(rawValue: response.statusCode)
+                serverError = code != nil ? FileProviderDropboxError(code: code!, path: toPath, errorDescription: String(data: data ?? Data(), encoding: .utf8)) : nil
+            }
+            completionHandler?(serverError ?? error)
+        })
+        task.resume()
+    }
+}
+
+extension DropboxFileProvider: ExtendedFileProvider {
+    open func thumbnailOfFileSupported(path: String) -> Bool {
+        switch (path as NSString).pathExtension.lowercased() {
+        case "jpg", "jpeg", "gif", "bmp", "png", "tif", "tiff":
+            return true
+        case "doc", "docx", "docm", "xls", "xlsx", "xlsm":
+            return true
+        case  "ppt", "pps", "ppsx", "ppsm", "pptx", "pptm":
+            return true
+        case "rtf":
+            return true
+        default:
+            return false
+        }
+    }
+    
+    open func propertiesOfFileSupported(path: String) -> Bool {
+        let fileExt = (path as NSString).pathExtension.lowercased()
+        switch fileExt {
+        case "jpg", "jpeg", "bmp", "gif", "png", "tif", "tiff":
+            return true
+        /*case "mp3", "aac", "m4a":
+            return true*/
+        case "mp4", "mpg", "3gp", "mov", "avi":
+            return true
+        default:
+            return false
+        }
+    }
+        
+    /// Default value for dimension is 64x64, according to Dropbox documentation
+    open func thumbnailOfFile(path: String, dimension: CGSize?, completionHandler: @escaping ((_ image: ImageClass?, _ error: Error?) -> Void)) {
+        let url: URL
+        switch (path as NSString).pathExtension.lowercased() {
+        case "jpg", "jpeg", "gif", "bmp", "png", "tif", "tiff":
+            url = URL(string: "files/get_thumbnail", relativeTo: contentURL)!
+        case "doc", "docx", "docm", "xls", "xlsx", "xlsm":
+            fallthrough
+        case  "ppt", "pps", "ppsx", "ppsm", "pptx", "pptm":
+            fallthrough
+        case "rtf":
+            url = URL(string: "files/get_preview", relativeTo: contentURL)!
+        default:
+            return
+        }
+        var request = URLRequest(url: url)
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        var requestDictionary: [String: AnyObject] = ["path": path as NSString]
+        requestDictionary["format"] = "jpeg" as NSString
+        if let dimension = dimension {
+            requestDictionary["size"] = "w\(Int(dimension.width))h\(Int(dimension.height))" as NSString
+        }
+        request.setValue(dictionaryToJSON(requestDictionary), forHTTPHeaderField: "Dropbox-API-Arg")
+        let task = self.session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var image: ImageClass? = nil
+            if let r = response as? HTTPURLResponse, let result = r.allHeaderFields["Dropbox-API-Result"] as? String, let jsonResult = jsonToDictionary(result) {
+                if jsonResult["error"] != nil {
+                    completionHandler(nil, self.throwError(path, code: URLError.cannotDecodeRawData as FoundationErrorEnum))
+                }
+            }
+            if let data = data {
+                if DropboxFileProvider.dataIsPDF(data) {
+                    image = DropboxFileProvider.convertToImage(pdfData: data)
+                } else if let contentType = (response as? HTTPURLResponse)?.allHeaderFields["Content-Type"] as? String, contentType.contains("text/html") {
+                     // TODO: Implement converting html returned type of get_preview to image
+                } else {
+                    image = ImageClass(data: data)
+                }
+            }
+            completionHandler(image, error)
+        })
+        task.resume()
+    }
+    
+    open func propertiesOfFile(path: String, completionHandler: @escaping ((_ propertiesDictionary: [String : Any], _ keys: [String], _ error: Error?) -> Void)) {
+        let url = URL(string: "files/get_metadata", relativeTo: apiURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "POST"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        request.setValue("application/json", forHTTPHeaderField: "Content-Type")
+        let requestDictionary: [String: AnyObject] = ["path": correctPath(path)! as NSString, "include_media_info": NSNumber(value: true)]
+        request.httpBody = dictionaryToJSON(requestDictionary)?.data(using: .utf8)
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var serverError: FileProviderDropboxError?
+            var dic = [String: Any]()
+            var keys = [String]()
+            if let response = response as? HTTPURLResponse {
+                let code = FileProviderHTTPErrorCode(rawValue: response.statusCode)
+                serverError = code != nil ? FileProviderDropboxError(code: code!, path: path, errorDescription: String(data: data ?? Data(), encoding: .utf8)) : nil
+                if let data = data, let jsonStr = String(data: data, encoding: .utf8), let json = jsonToDictionary(jsonStr), let properties = json["media_info"] as? [String: Any] {
+                    (dic, keys) = self.mapMediaInfo(properties)
+                }
+            }
+            completionHandler(dic, keys, serverError ?? error)
+        })
+        task.resume()
+    }
+}
+
+extension DropboxFileProvider: FileProvider {
+    open func copy(with zone: NSZone? = nil) -> Any {
+        let copy = DropboxFileProvider(credential: self.credential, cache: self.cache)
+        copy.currentPath = self.currentPath
+        copy.delegate = self.delegate
+        copy.fileOperationDelegate = self.fileOperationDelegate
+        copy.useCache = self.useCache
+        copy.validatingCache = self.validatingCache
+        return copy
+    }
+}

Sources/DropboxHelper.swift

@@ -0,0 +1,268 @@
+//
+//  DropboxHelper.swift
+//  FileProvider
+//
+//  Created by Amir Abbas Mousavian.
+//  Copyright © 2016 Mousavian. Distributed under MIT license.
+//
+
+import Foundation
+
+/// Error returned by Dropbox server when trying to access or do operations on a file or folder.
+public struct FileProviderDropboxError: FileProviderHTTPError {
+    public let code: FileProviderHTTPErrorCode
+    public let path: String
+    public let errorDescription: String?
+}
+
+/// Containts path, url and attributes of a Dropbox file or resource.
+public final class DropboxFileObject: FileObject {
+    internal init(name: String, path: String) {
+        super.init(url: URL(string: path) ?? URL(string: "/")!, name: name, path: path)
+    }
+    
+    internal convenience init? (jsonStr: String) {
+        guard let json = jsonToDictionary(jsonStr) else { return nil }
+        self.init(json: json)
+    }
+    
+    internal convenience init? (json: [String: AnyObject]) {
+        guard let name = json["name"] as? String else { return nil }
+        guard let path = json["path_display"] as? String else { return nil }
+        self.init(name: name, path: path)
+        self.size = (json["size"] as? NSNumber)?.int64Value ?? -1
+        self.serverTime = resolve(dateString: json["server_modified"] as? String ?? "")
+        self.modifiedDate = resolve(dateString: json["client_modified"] as? String ?? "")
+        self.type = (json[".tag"] as? String) == "folder" ? .directory : .regular
+        self.isReadOnly = (json["sharing_info"]?["read_only"] as? NSNumber)?.boolValue ?? false
+        self.id = json["id"] as? String
+        self.rev = json["rev"] as? String
+    }
+    
+    /// The time contents of file has been modified on server, returns nil if not set
+    open internal(set) var serverTime: Date? {
+        get {
+            return allValues[.serverDate] as? Date
+        }
+        set {
+            allValues[.serverDate] = newValue
+        }
+    }
+    
+    /// The document identifier is a value assigned by the Dropbox to a file.
+    /// This value is used to identify the document regardless of where it is moved on a volume.
+    /// The identifier persists across system restarts.
+    open internal(set) var id: String? {
+        get {
+            return allValues[.documentIdentifierKey] as? String
+        }
+        set {
+            allValues[.documentIdentifierKey] = newValue
+        }
+    }
+    
+    /// The revision of file, which changes when a file contents are modified.
+    /// Changes to attributes or other file metadata do not change the identifier.
+    open internal(set) var rev: String? {
+        get {
+            return allValues[.generationIdentifierKey] as? String
+        }
+        set {
+            allValues[.generationIdentifierKey] = newValue
+        }
+    }
+}
+
+// codebeat:disable[ARITY]
+internal extension DropboxFileProvider {
+    func list(_ path: String, cursor: String? = nil, prevContents: [DropboxFileObject] = [], recursive: Bool = false, completionHandler: @escaping ((_ contents: [FileObject], _ cursor: String?, _ error: Error?) -> Void)) {
+        var requestDictionary = [String: AnyObject]()
+        let url: URL
+        if let cursor = cursor {
+            url = URL(string: "files/list_folder/continue", relativeTo: apiURL)!
+            requestDictionary["cursor"] = cursor as NSString?
+        } else {
+            url = URL(string: "files/list_folder", relativeTo: apiURL)!
+            requestDictionary["path"] = correctPath(path) as NSString?
+            requestDictionary["recursive"] = recursive as NSNumber?
+        }
+        var request = URLRequest(url: url)
+        request.httpMethod = "POST"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        request.setValue("application/json", forHTTPHeaderField: "Content-Type")
+        request.httpBody = dictionaryToJSON(requestDictionary)?.data(using: .utf8)
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var responseError: FileProviderDropboxError?
+            var files = prevContents
+            if let code = (response as? HTTPURLResponse)?.statusCode , code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                responseError = FileProviderDropboxError(code: rCode, path: path, errorDescription: String(data: data ?? Data(), encoding: .utf8))
+            }
+            if let data = data, let jsonStr = String(data: data, encoding: .utf8) {
+                let json = jsonToDictionary(jsonStr)
+                if let entries = json?["entries"] as? [AnyObject] , entries.count > 0 {
+                    for entry in entries {
+                        if let entry = entry as? [String: AnyObject], let file = DropboxFileObject(json: entry) {
+                            files.append(file)
+                        }
+                    }
+                    let ncursor = json?["cursor"] as? String
+                    let hasmore = (json?["has_more"] as? NSNumber)?.boolValue ?? false
+                    if hasmore {
+                        self.list(path, cursor: ncursor, prevContents: files, completionHandler: completionHandler)
+                        return
+                    }
+                }
+            }
+            completionHandler(files, nil, responseError ?? error)
+        })
+        task.taskDescription = FileOperationType.fetch(path: path).json
+        task.resume()
+    }
+    
+    func upload_simple(_ targetPath: String, data: Data, modifiedDate: Date = Date(), overwrite: Bool, operation: FileOperationType, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        if data.count > 150 * 1024 * 1024 {
+            let error = FileProviderDropboxError(code: .payloadTooLarge, path: targetPath, errorDescription: nil)
+            completionHandler?(error)
+            self.delegateNotify(.create(path: targetPath), error: error)
+            return nil
+        }
+        var requestDictionary = [String: AnyObject]()
+        let url: URL
+        url = URL(string: "files/upload", relativeTo: contentURL)!
+        requestDictionary["path"] = correctPath(targetPath) as NSString?
+        requestDictionary["mode"] = (overwrite ? "overwrite" : "add") as NSString
+        requestDictionary["client_modified"] = rfc3339utc(of: modifiedDate) as NSString
+        var request = URLRequest(url: url)
+        request.httpMethod = "POST"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        request.setValue("application/octet-stream", forHTTPHeaderField: "Content-Type")
+        request.setValue(dictionaryToJSON(requestDictionary), forHTTPHeaderField: "Dropbox-API-Arg")
+        request.httpBody = data
+        let task = session.uploadTask(with: request, from: data, completionHandler: { (data, response, error) in
+            var responseError: FileProviderDropboxError?
+            if let code = (response as? HTTPURLResponse)?.statusCode , code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                responseError = FileProviderDropboxError(code: rCode, path: targetPath, errorDescription: String(data: data ?? Data(), encoding: .utf8))
+            }
+            completionHandler?(responseError ?? error)
+            self.delegateNotify(.create(path: targetPath), error: responseError ?? error)
+        })
+        task.taskDescription = operation.json
+        task.resume()
+        return RemoteOperationHandle(operationType: operation, tasks: [task])
+    }
+    
+    func upload_simple(_ targetPath: String, localFile: URL, modifiedDate: Date = Date(), overwrite: Bool, operation: FileOperationType, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let size = (try? localFile.resourceValues(forKeys: [.fileSizeKey]))?.fileSize ?? -1
+        if size > 150 * 1024 * 1024 {
+            let error = FileProviderDropboxError(code: .payloadTooLarge, path: targetPath, errorDescription: nil)
+            completionHandler?(error)
+            self.delegateNotify(.create(path: targetPath), error: error)
+            return nil
+        }
+        var requestDictionary = [String: AnyObject]()
+        let url: URL
+        url = URL(string: "files/upload", relativeTo: contentURL)!
+        requestDictionary["path"] = correctPath(targetPath) as NSString?
+        requestDictionary["mode"] = (overwrite ? "overwrite" : "add") as NSString
+        requestDictionary["client_modified"] = rfc3339utc(of: modifiedDate) as NSString
+        var request = URLRequest(url: url)
+        request.httpMethod = "POST"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        request.setValue("application/octet-stream", forHTTPHeaderField: "Content-Type")
+        request.setValue(dictionaryToJSON(requestDictionary), forHTTPHeaderField: "Dropbox-API-Arg")
+        let task = session.uploadTask(with: request, fromFile: localFile, completionHandler: { (data, response, error) in
+            var responseError: FileProviderDropboxError?
+            if let code = (response as? HTTPURLResponse)?.statusCode , code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                responseError = FileProviderDropboxError(code: rCode, path: targetPath, errorDescription: String(data: data ?? Data(), encoding: .utf8))
+            }
+            completionHandler?(responseError ?? error)
+            self.delegateNotify(.create(path: targetPath), error: responseError ?? error)
+        })
+        task.taskDescription = operation.json
+        task.resume()
+        return RemoteOperationHandle(operationType: operation, tasks: [task])
+    }
+    
+    func search(_ startPath: String = "", query: String, start: Int = 0, maxResultPerPage: Int = 25, maxResults: Int = -1, foundItem:@escaping ((_ file: DropboxFileObject) -> Void), completionHandler: @escaping ((_ error: Error?) -> Void)) {
+        let url = URL(string: "files/search", relativeTo: apiURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "POST"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        request.setValue("application/json", forHTTPHeaderField: "Content-Type")
+        var requestDictionary: [String: AnyObject] = ["path": startPath as NSString]
+        requestDictionary["query"] = query as NSString
+        requestDictionary["start"] = start as NSNumber
+        requestDictionary["max_results"] = maxResultPerPage as NSNumber
+        request.httpBody = dictionaryToJSON(requestDictionary)?.data(using: .utf8)
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var responseError: FileProviderDropboxError?
+            if let code = (response as? HTTPURLResponse)?.statusCode , code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                responseError = FileProviderDropboxError(code: rCode, path: startPath, errorDescription: String(data: data ?? Data(), encoding: .utf8))
+            }
+            if let data = data, let jsonStr = String(data: data, encoding: .utf8) {
+                let json = jsonToDictionary(jsonStr)
+                if let entries = json?["matches"] as? [AnyObject] , entries.count > 0 {
+                    for entry in entries {
+                        if let entry = entry as? [String: AnyObject], let file = DropboxFileObject(json: entry) {
+                            foundItem(file)
+                        }
+                    }
+                    let rstart = json?["start"] as? Int
+                    let hasmore = (json?["more"] as? NSNumber)?.boolValue ?? false
+                    if hasmore, let rstart = rstart {
+                        self.search(startPath, query: query, start: rstart + entries.count, maxResultPerPage: maxResultPerPage, foundItem: foundItem, completionHandler: completionHandler)
+                    } else {
+                        completionHandler(responseError ?? error)
+                    }
+                    return
+                }
+            }
+            completionHandler(responseError ?? error)
+        }) 
+        task.resume()
+    }
+}
+// codebeat:enable[ARITY]
+
+internal extension DropboxFileProvider {
+    static let dateFormatter = DateFormatter()
+    static let decimalFormatter = NumberFormatter()
+    
+    func mapMediaInfo(_ json: [String: Any]) -> (dictionary: [String: Any], keys: [String]) {
+        var dic = [String: Any]()
+        var keys = [String]()
+        if let dimensions = json["dimensions"] as? [String: Any], let height = dimensions["height"] as? UInt64, let width = dimensions["width"] as? UInt64 {
+            keys.append("Dimensions")
+            dic["Dimensions"] = "\(width)x\(height)"
+        }
+        if let location = json["location"] as? [String: Any], let latitude = location["latitude"] as? Double, let longitude = location["longitude"] as? Double {
+            
+            DropboxFileProvider.decimalFormatter.numberStyle = .decimal
+            DropboxFileProvider.decimalFormatter.maximumFractionDigits = 5
+            keys.append("Location")
+            let latStr = DropboxFileProvider.decimalFormatter.string(from: NSNumber(value: latitude))
+            let longStr = DropboxFileProvider.decimalFormatter.string(from: NSNumber(value: longitude))
+            dic["Location"] = "\(latStr), \(longStr)"
+        }
+        if let timeTakenStr = json["time_taken"] as? String, let timeTaken = resolve(dateString: timeTakenStr) {
+            keys.append("Date taken")
+            DropboxFileProvider.dateFormatter.dateFormat = "yyyy-MM-dd HH:mm:ss"
+            dic["Date taken"] = DropboxFileProvider.dateFormatter.string(from: timeTaken)
+        }
+        if let duration = json["duration"] as? UInt64 {
+            keys.append("Duration")
+            dic["Duration"] = DropboxFileProvider.formatshort(interval: TimeInterval(duration))
+        }
+        return (dic, keys)
+    }
+    
+    func delegateNotify(_ operation: FileOperationType, error: Error?) {
+        DispatchQueue.main.async(execute: {
+            if error == nil {
+                self.delegate?.fileproviderSucceed(self, operation: operation)
+            } else {
+                self.delegate?.fileproviderFailed(self, operation: operation)
+            }
+        })
+    }
+}

Sources/ExtendedLocalFileProvider.swift

@@ -0,0 +1,487 @@
+//
+//  ExtendedLocalFileProvider.swift
+//  FileProvider
+//
+//  Created by Amir Abbas Mousavian.
+//  Copyright © 2017 Mousavian. Distributed under MIT license.
+//
+
+import Foundation
+import ImageIO
+import CoreGraphics
+import AVFoundation
+
+extension LocalFileProvider: ExtendedFileProvider {
+    public func thumbnailOfFileSupported(path: String) -> Bool {
+        switch (path as NSString).pathExtension.lowercased() {
+        case LocalFileInformationGenerator.imageThumbnailExtensions:
+            return true
+        case LocalFileInformationGenerator.audioThumbnailExtensions:
+            return true
+        case LocalFileInformationGenerator.videoThumbnailExtensions:
+            return true
+        case LocalFileInformationGenerator.pdfThumbnailExtensions:
+            return true
+        case LocalFileInformationGenerator.officeThumbnailExtensions:
+            return true
+        case LocalFileInformationGenerator.customThumbnailExtensions:
+            return true
+        default:
+            return false
+        }
+    }
+    
+    public func propertiesOfFileSupported(path: String) -> Bool {
+        let fileExt = (path as NSString).pathExtension.lowercased()
+        switch fileExt {
+        case LocalFileInformationGenerator.imagePropertiesExtensions:
+            return LocalFileInformationGenerator.imageProperties != nil
+        case LocalFileInformationGenerator.audioPropertiesExtensions:
+            return LocalFileInformationGenerator.audioProperties != nil
+        case LocalFileInformationGenerator.videoPropertiesExtensions:
+            return LocalFileInformationGenerator.videoProperties != nil
+        case LocalFileInformationGenerator.pdfPropertiesExtensions:
+            return LocalFileInformationGenerator.pdfProperties != nil
+        case LocalFileInformationGenerator.archivePropertiesExtensions:
+            return LocalFileInformationGenerator.archiveProperties != nil
+        case LocalFileInformationGenerator.officePropertiesExtensions:
+            return LocalFileInformationGenerator.officeProperties != nil
+        case LocalFileInformationGenerator.customPropertiesExtensions:
+            return LocalFileInformationGenerator.customProperties != nil
+
+        default:
+            return false
+        }
+    }
+    
+    public func thumbnailOfFile(path: String, dimension: CGSize? = nil, completionHandler: @escaping ((_ image: ImageClass?, _ error: Error?) -> Void)) {
+        let dimension = dimension ?? CGSize(width: 64, height: 64)
+        (dispatch_queue).async {
+            var thumbnailImage: ImageClass? = nil
+            // Check cache
+            let fileURL = self.url(of: path)
+            // Create Thumbnail and cache
+            switch fileURL.pathExtension.lowercased() {
+            case LocalFileInformationGenerator.videoThumbnailExtensions:
+                thumbnailImage = LocalFileInformationGenerator.videoThumbnail(fileURL)
+            case LocalFileInformationGenerator.audioThumbnailExtensions:
+                thumbnailImage = LocalFileInformationGenerator.audioThumbnail(fileURL)
+            case LocalFileInformationGenerator.imageThumbnailExtensions:
+                thumbnailImage = LocalFileInformationGenerator.imageThumbnail(fileURL)
+            case LocalFileInformationGenerator.pdfThumbnailExtensions:
+                thumbnailImage = LocalFileInformationGenerator.pdfThumbnail(fileURL)
+            case LocalFileInformationGenerator.officeThumbnailExtensions:
+                thumbnailImage = LocalFileInformationGenerator.officeThumbnail(fileURL)
+            case LocalFileInformationGenerator.customThumbnailExtensions:
+                thumbnailImage = LocalFileInformationGenerator.customThumbnail(fileURL)
+            default:
+                completionHandler(nil, nil)
+                return
+            }
+            
+            if let image = thumbnailImage {
+                let scaledImage = LocalFileProvider.scaleDown(image: image, toSize: dimension)
+                completionHandler(scaledImage, nil)
+            }
+        }
+    }
+    
+    public func propertiesOfFile(path: String, completionHandler: @escaping ((_ propertiesDictionary: [String: Any], _ keys: [String], _ error: Error?) -> Void)) {
+        (dispatch_queue).async {
+            let fileExt = (path as NSString).pathExtension.lowercased()
+            var getter: ((_ fileURL: URL) -> (prop: [String: Any], keys: [String]))?
+            switch fileExt {
+            case LocalFileInformationGenerator.imagePropertiesExtensions:
+                getter = LocalFileInformationGenerator.imageProperties
+             case LocalFileInformationGenerator.audioPropertiesExtensions:
+                getter = LocalFileInformationGenerator.audioProperties
+            case LocalFileInformationGenerator.videoPropertiesExtensions:
+                getter = LocalFileInformationGenerator.videoProperties
+            case LocalFileInformationGenerator.pdfPropertiesExtensions:
+                getter = LocalFileInformationGenerator.pdfProperties
+            case LocalFileInformationGenerator.archivePropertiesExtensions:
+                getter = LocalFileInformationGenerator.archiveProperties
+            case LocalFileInformationGenerator.officePropertiesExtensions:
+                getter = LocalFileInformationGenerator.officeProperties
+            case LocalFileInformationGenerator.customPropertiesExtensions:
+                getter = LocalFileInformationGenerator.customProperties
+            default:
+                break
+            }
+            
+            var dic = [String: Any]()
+            var keys = [String]()
+            if let getterMethod = getter {
+                (dic, keys) = getterMethod(self.url(of: path))
+            }
+            
+            completionHandler(dic, keys, nil)
+        }
+    }
+}
+
+/// Holds supported file types and thumbnail/properties generator for specefied type of file
+public struct LocalFileInformationGenerator {
+    /// Image extensions supportes for thumbnail.
+    ///
+    /// Default: `["jpg", "jpeg", "gif", "bmp", "png", "tif", "tiff", "ico"]`
+    static public var imageThumbnailExtensions: [String]  = ["jpg", "jpeg", "gif", "bmp", "png", "tif", "tiff", "ico"]
+    
+    /// Audio and music extensions supportes for thumbnail.
+    ///
+    /// Default: `["mp3", "aac", "m4a"]`
+    static public var audioThumbnailExtensions: [String]  = ["mp3", "aac", "m4a"]
+    
+    /// Video extensions supportes for thumbnail.
+    ///
+    /// Default: `["mov", "mp4", "m4v", "mpg", "mpeg"]`
+    static public var videoThumbnailExtensions: [String]  = ["mov", "mp4", "m4v", "mpg", "mpeg"]
+    
+    /// Portable document file extensions supportes for thumbnail.
+    ///
+    /// Default: `["pdf"]`
+    static public var pdfThumbnailExtensions: [String]    = ["pdf"]
+    
+    /// Office document extensions supportes for thumbnail.
+    ///
+    /// Default: `empty`
+    static public var officeThumbnailExtensions: [String] = []
+    
+    /// Custom document extensions supportes for thumbnail.
+    ///
+    /// Default: `empty`
+    static public var customThumbnailExtensions: [String] = []
+
+    
+    /// Image extensions supportes for properties.
+    ///
+    /// Default: `["jpg", "jpeg", "gif", "bmp", "png", "tif", "tiff"]`
+    static public var imagePropertiesExtensions: [String]   = ["jpg", "jpeg", "bmp", "gif", "png", "tif", "tiff"]
+    
+    /// Audio and music extensions supportes for properties.
+    ///
+    /// Default: `["mp3", "aac", "m4a", "caf"]`
+    static public var audioPropertiesExtensions: [String]   = ["mp3", "aac", "m4a", "caf"]
+    
+    /// Video extensions supportes for properties.
+    ///
+    /// Default: `["mp4", "mpg", "3gp", "mov", "avi"]`
+    static public var videoPropertiesExtensions: [String]   = ["mp4", "mpg", "3gp", "mov", "avi"]
+    
+    /// Portable document file extensions supportes for properties.
+    ///
+    /// Default: `["pdf"]`
+    static public var pdfPropertiesExtensions: [String]     = ["pdf"]
+    
+    /// Archive extensions (like zip) supportes for properties.
+    ///
+    /// Default: `empty`
+    static public var archivePropertiesExtensions: [String] = []
+    
+    /// Office document extensions supportes for properties.
+    ///
+    /// Default: `empty`
+    static public var officePropertiesExtensions: [String]  = []
+    
+    /// Custom document extensions supportes for properties.
+    ///
+    /// Default: `empty`
+    static public var customPropertiesExtensions: [String]  = []
+    
+    /// Thumbnail generator closure for image files.
+    static public var imageThumbnail: (_ fileURL: URL) -> ImageClass? = { fileURL in
+        return ImageClass(contentsOfFile: fileURL.path)
+    }
+    
+    /// Thumbnail generator closure for audio and music files.
+    static public var audioThumbnail: (_ fileURL: URL) -> ImageClass? = { fileURL in
+        let playerItem = AVPlayerItem(url: fileURL)
+        let metadataList = playerItem.asset.commonMetadata
+        for item in metadataList {
+            if item.commonKey == AVMetadataCommonKeyArtwork {
+                if let data = item.dataValue {
+                    return ImageClass(data: data)
+                }
+            }
+        }
+        return nil
+    }
+    
+    /// Thumbnail generator closure for video files.
+    static public var videoThumbnail: (_ fileURL: URL) -> ImageClass? = { fileURL in
+        let asset = AVAsset(url: fileURL)
+        let assetImgGenerate = AVAssetImageGenerator(asset: asset)
+        assetImgGenerate.appliesPreferredTrackTransform = true
+        let time = CMTimeMake(asset.duration.value / 3, asset.duration.timescale)
+        if let cgImage = try? assetImgGenerate.copyCGImage(at: time, actualTime: nil) {
+            #if os(macOS)
+            return ImageClass(cgImage: cgImage, size: .zero)
+            #else
+            return ImageClass(cgImage: cgImage)
+            #endif
+        }
+        return nil
+    }
+    
+    /// Thumbnail generator closure for portable document files files.
+    static public var pdfThumbnail: (_ fileURL: URL) -> ImageClass? = { fileURL in
+        guard let data = try? Data(contentsOf: fileURL) else { return nil }
+        return LocalFileProvider.convertToImage(pdfData: data)
+    }
+    
+    /// Thumbnail generator closure for office document files.
+    /// - Note: No default implementation is avaiable
+    static public var officeThumbnail: (_ fileURL: URL) -> ImageClass? = { fileURL in
+        return nil
+    }
+    
+    /// Thumbnail generator closure for custom type of files.
+    /// - Note: No default implementation is avaiable
+    static public var customThumbnail: (_ fileURL: URL) -> ImageClass? = { fileURL in
+        return nil
+    }
+    
+    /// Properties generator closure for image files.
+    static public var imageProperties: ((_ fileURL: URL) -> (prop: [String: Any], keys: [String]))? = { fileURL in
+        var dic = [String: Any]()
+        var keys = [String]()
+        
+        func add(key: String, value: Any?) {
+            if let value = value {
+                keys.append(key)
+                dic[key] = value
+            }
+        }
+        
+        func simplify(_ top:Int64, _ bottom:Int64) -> (newTop:Int, newBottom:Int) {
+            var x = top
+            var y = bottom
+            while (y != 0) {
+                let buffer = y
+                y = x % y
+                x = buffer
+            }
+            let hcfVal = x
+            let newTopVal = top/hcfVal
+            let newBottomVal = bottom/hcfVal
+            return(Int(newTopVal), Int(newBottomVal))
+        }
+        
+        guard let cgDataRef = CGImageSourceCreateWithURL(fileURL as CFURL, nil), let cfImageDict = CGImageSourceCopyPropertiesAtIndex(cgDataRef, 0, nil) else {
+            return (dic, keys)
+        }
+        let imageDict = cfImageDict as NSDictionary
+        let tiffDict = imageDict[kCGImagePropertyTIFFDictionary as String] as? NSDictionary ?? [:]
+        let exifDict = imageDict[kCGImagePropertyExifDictionary as String] as? NSDictionary ?? [:]
+        if let pixelWidth = imageDict.object(forKey: kCGImagePropertyPixelWidth) as? NSNumber, let pixelHeight = imageDict.object(forKey: kCGImagePropertyPixelHeight) as? NSNumber {
+            add(key: "Dimensions", value: "\(pixelWidth)x\(pixelHeight)")
+        }
+        
+        add(key: "DPI", value: imageDict[kCGImagePropertyDPIWidth as String])
+        add(key: "Device make", value: tiffDict[kCGImagePropertyTIFFMake as String])
+        add(key: "Device model", value: tiffDict[kCGImagePropertyTIFFModel as String])
+        add(key: "Lens model", value: exifDict[kCGImagePropertyExifLensModel as String])
+        add(key: "Artist", value: tiffDict[kCGImagePropertyTIFFArtist as String] as? String)
+        if let cr = tiffDict[kCGImagePropertyTIFFCopyright as String] as? String , !cr.isEmpty {
+            add(key: "Copyright", value: cr)
+
+        }
+        if let date = tiffDict[kCGImagePropertyTIFFDateTime as String] as? String , !date.isEmpty {
+            add(key: "Date taken", value: date)
+        }
+        if let latitude = tiffDict[kCGImagePropertyGPSLatitude as String] as? NSNumber, let longitude = tiffDict[kCGImagePropertyGPSLongitude as String] as? NSNumber {
+            add(key: "Location", value: "\(latitude), \(longitude)")
+        }
+        add(key: "Color space", value: imageDict[kCGImagePropertyColorModel as String])
+        add(key: "Focal length", value: exifDict[kCGImagePropertyExifFocalLength as String])
+        add(key: "F number", value: exifDict[kCGImagePropertyExifFNumber as String])
+        add(key: "Exposure program", value: exifDict[kCGImagePropertyExifExposureProgram as String])
+        
+        if let exp = exifDict[kCGImagePropertyExifExposureTime as String] as? NSNumber {
+            let expfrac = simplify(Int64(exp.doubleValue * 10_000_000_000_000), 10_000_000_000_000)
+            add(key: "Exposure time", value: "\(expfrac.newTop)/\(expfrac.newBottom)")
+        }
+        if let iso = exifDict[kCGImagePropertyExifISOSpeedRatings as String] as? NSArray , iso.count > 0 {
+            add(key: "ISO speed", value: iso[0])
+        }
+        return (dic, keys)
+    }
+    
+    /// Properties generator closure for audio and music files.
+    static var audioProperties: ((_ fileURL: URL) -> (prop: [String: Any], keys: [String]))? = { fileURL in
+        var dic = [String: Any]()
+        var keys = [String]()
+        
+        func add(key: String, value: Any?) {
+            if let value = value {
+                keys.append(key)
+                dic[key] = value
+            }
+        }
+        
+        func makeDescription(_ key: String?) -> String? {
+            guard let key = key else {
+                return nil
+            }
+            guard let regex = try? NSRegularExpression(pattern: "([a-z])([A-Z])" , options: NSRegularExpression.Options()) else {
+                return nil
+            }
+            let newKey = regex.stringByReplacingMatches(in: key, options: NSRegularExpression.MatchingOptions(), range: NSMakeRange(0, (key as NSString).length) , withTemplate: "$1 $2")
+            return newKey.capitalized
+        }
+        
+        if FileManager.default.fileExists(atPath: fileURL.path) {
+            let playerItem = AVPlayerItem(url: fileURL)
+            let metadataList = playerItem.asset.commonMetadata
+            for item in metadataList {
+                if let description = makeDescription(item.commonKey) {
+                    if let value = item.stringValue {
+                        keys.append(description)
+                        dic[description] = value
+                    }
+                }
+            }
+            if let ap = try? AVAudioPlayer(contentsOf: fileURL) {
+                add(key: "Duration", value: LocalFileProvider.formatshort(interval: ap.duration))
+                add(key: "Bitrate", value: ap.settings[AVSampleRateKey] as? Int)
+            }
+        }
+        return (dic, keys)
+    }
+    
+    /// Properties generator closure for video files.
+    static public var videoProperties: ((_ fileURL: URL) -> (prop: [String: Any], keys: [String]))? = { fileURL in
+        var dic = [String: Any]()
+        var keys = [String]()
+        
+        func add(key: String, value: Any?) {
+            if let value = value {
+                keys.append(key)
+                dic[key] = value
+            }
+        }
+        
+        if let audioprops = LocalFileInformationGenerator.audioProperties?(fileURL) {
+            dic = audioprops.prop
+            keys = audioprops.keys
+            dic.removeValue(forKey: "Duration")
+            if let index = keys.index(of: "Duration") {
+                keys.remove(at: index)
+            }
+        }
+        let asset = AVURLAsset(url: fileURL, options: nil)
+        let videoTracks = asset.tracks(withMediaType: AVMediaTypeVideo)
+        if videoTracks.count > 0 {
+            var bitrate: Float = 0
+            let width = Int(videoTracks[0].naturalSize.width)
+            let height = Int(videoTracks[0].naturalSize.height)
+            add(key: "Dimensions", value: "\(width)x\(height)")
+            var duration: Int64 = 0
+            for track in videoTracks {
+                duration += track.timeRange.duration.timescale > 0 ? track.timeRange.duration.value / Int64(track.timeRange.duration.timescale) : 0
+                bitrate += track.estimatedDataRate
+            }
+            add(key: "Duration", value: LocalFileProvider.formatshort(interval: TimeInterval(duration)))
+            add(key: "Video Bitrate", value: "\(Int(ceil(bitrate / 1000))) kbps")
+        }
+        let audioTracks = asset.tracks(withMediaType: AVMediaTypeAudio)
+        // dic["Audio channels"] = audioTracks.count
+        var bitrate: Float = 0
+        for track in audioTracks {
+            bitrate += track.estimatedDataRate
+        }
+        add(key: "Audio Bitrate", value: "\(Int(ceil(bitrate / 1000))) kbps")
+        return (dic, keys)
+    }
+    
+    /// Properties generator closure for protable documents files.
+    static public var pdfProperties: ((_ fileURL: URL) -> (prop: [String: Any], keys: [String]))? = { fileURL in
+        var dic = [String: Any]()
+        var keys = [String]()
+        
+        func add(key: String, value: Any?) {
+            if let value = value {
+                keys.append(key)
+                dic[key] = value
+            }
+        }
+        
+        func getKey(_ key: String, from dict: CGPDFDictionaryRef) -> String? {
+            var cfValue: CGPDFStringRef? = nil
+            if (CGPDFDictionaryGetString(dict, key, &cfValue)), let value = CGPDFStringCopyTextString(cfValue!) {
+                return value as String
+            }
+            return nil
+        }
+        
+        func convertDate(_ date: String) -> Date? {
+            var dateStr = date
+            if dateStr.hasPrefix("D:") {
+                dateStr = date.substring(from: date.characters.index(date.startIndex, offsetBy: 2))
+            }
+            let dateFormatter = DateFormatter()
+            dateFormatter.dateFormat = "yyyyMMddHHmmssTZD"
+            if let result = dateFormatter.date(from: dateStr) {
+                return result
+            }
+            dateFormatter.dateFormat = "yyyyMMddHHmmss"
+            if let result = dateFormatter.date(from: dateStr) {
+                return result
+            }
+            return nil
+        }
+        
+        if let data = try? Data(contentsOf: fileURL), let provider = CGDataProvider(data: data as CFData), let reference = CGPDFDocument(provider), let dict = reference.info {
+            if let title = getKey("Title", from: dict), !title.isEmpty {
+                add(key: "Title", value: title)
+            }
+            if let author = getKey("Author", from: dict), !author.isEmpty {
+                add(key: "Author", value: author)
+            }
+            if let subject = getKey("Subject", from: dict), !subject.isEmpty {
+                add(key: "Subject", value: subject)
+            }
+            var majorVersion: Int32 = 0
+            var minorVersion: Int32 = 0
+            reference.getVersion(majorVersion: &majorVersion, minorVersion: &minorVersion)
+            if majorVersion > 0 {
+                add(key: "Version", value:  String(majorVersion) + "." + String(minorVersion))
+            }
+            add(key: "Pages", value: reference.numberOfPages)
+            
+            if reference.numberOfPages > 0, let pageRef = reference.page(at: 1) {
+                let size = pageRef.getBoxRect(CGPDFBox.mediaBox).size
+                add(key: "Resolution", value: "\(Int(size.width))x\(Int(size.height))")
+            }
+            if let creator = getKey("Creator", from: dict), !creator.isEmpty {
+                add(key: "Content creator", value: creator)
+            }
+            if let creationDateString = getKey("CreationDate", from: dict) {
+                add(key: "Creation date", value: convertDate(creationDateString))
+            }
+            if let modifiedDateString = getKey("ModDate", from: dict) {
+                add(key: "Modified date", value: convertDate(modifiedDateString))
+            }
+            add(key: "Security", value: reference.isEncrypted ? "Present" : "None")
+            add(key: "Allows printing", value: reference.allowsPrinting ? "Yes" : "No")
+            add(key: "Allows copying", value: reference.allowsCopying ? "Yes" : "No")
+        }
+        return (dic, keys)
+    }
+    
+    /// Properties generator closure for video files.
+    /// - Note: No default implementation is avaiable
+    static public var archiveProperties: ((_ fileURL: URL) -> (prop: [String: Any], keys: [String]))? = nil
+    
+    /// Properties generator closure for office doument files.
+    /// - Note: No default implementation is avaiable
+    static public var officeProperties: ((_ fileURL: URL) -> (prop: [String: Any], keys: [String]))? = nil
+    
+    /// Properties generator closure for custom type of files.
+    /// - Note: No default implementation is avaiable
+    static public var customProperties: ((_ fileURL: URL) -> (prop: [String: Any], keys: [String]))? = nil
+}
+
+fileprivate func ~=<T : Equatable>(array: [T], value: T) -> Bool {
+    return array.contains(value)
+}

Sources/FPSStreamTask.swift

@@ -0,0 +1,508 @@
+//
+//  FPSStreamTask.swift
+//  FileProvider
+//
+//  Created by Amir Abbas Mousavian.
+//  Copyright © 2016 Mousavian. Distributed under MIT license.
+//
+
+import Foundation
+
+private var lasttaskIdAssociated = 1_000_000_000
+
+
+/// This class is a replica of NSURLSessionStreamTask with same api for iOS 7/8
+/// while it will fallback to NSURLSessionStreamTask in iOS 9.
+internal class FPSStreamTask: URLSessionTask, StreamDelegate {
+    fileprivate var inputStream: InputStream?
+    fileprivate var outputStream: OutputStream?
+    
+    fileprivate var dispatch_queue: DispatchQueue!
+    internal var _underlyingSession: URLSession
+    fileprivate var streamDelegate: FPSStreamDelegate? {
+        return (_underlyingSession.delegate as? FPSStreamDelegate)
+    }
+    fileprivate var _taskIdentifier: Int
+    
+    @available(iOS 9.0, OSX 10.11, *)
+    static var streamTasks = [Int: URLSessionStreamTask]()
+    
+    @available(iOS 9.0, OSX 10.11, *)
+    internal var _underlyingTask: URLSessionStreamTask? {
+        return FPSStreamTask.streamTasks[_taskIdentifier]
+    }
+    
+    open override var taskIdentifier: Int {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            return _underlyingTask!.taskIdentifier
+        } else {
+            return _taskIdentifier
+        }
+    }
+    
+    fileprivate var _state: URLSessionTask.State = .suspended
+    override open var state: URLSessionTask.State {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            return _underlyingTask!.state
+        } else {
+            return _state
+        }
+    }
+    
+    override open var originalRequest: URLRequest? {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            return _underlyingTask!.originalRequest
+        } else {
+            return nil
+        }
+    }
+    
+    override open var currentRequest: URLRequest? {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            return _underlyingTask!.currentRequest
+        } else {
+            return nil
+        }
+    }
+    
+    fileprivate var _countOfBytesSent: Int64 = 0
+    fileprivate var _countOfBytesRecieved: Int64 = 0
+    
+    override open var countOfBytesSent: Int64 {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            return _underlyingTask!.countOfBytesSent
+        } else {
+            return _countOfBytesSent
+        }
+    }
+    
+    override open var countOfBytesReceived: Int64 {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            return _underlyingTask!.countOfBytesReceived
+        } else {
+            return _countOfBytesRecieved
+        }
+    }
+    
+    override open var countOfBytesExpectedToSend: Int64 {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            return _underlyingTask!.countOfBytesExpectedToSend
+        } else {
+            return Int64(dataToBeSent.length)
+        }
+    }
+    
+    override open var countOfBytesExpectedToReceive: Int64 {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            return _underlyingTask!.countOfBytesExpectedToReceive
+        } else {
+            return Int64(dataReceived.length)
+        }
+    }
+    
+    override public init() {
+        fatalError("Use NSURLSession.fpstreamTask() method")
+    }
+    
+    var host: (hostname: String, port: Int)?
+    var service: NetService?
+    
+    internal init(session: URLSession, host: String, port: Int) {
+        self._underlyingSession = session
+        if #available(iOS 9.0, OSX 10.11, *) {
+            let task = session.streamTask(withHostName: host, port: port)
+            self._taskIdentifier = task.taskIdentifier
+            FPSStreamTask.streamTasks[_taskIdentifier] = task
+        } else {
+            lasttaskIdAssociated += 1
+            self._taskIdentifier = lasttaskIdAssociated
+            self.host = (host, port)
+            self.dispatch_queue = DispatchQueue(label: "FSPStreamTask", attributes: DispatchQueue.Attributes.concurrent)
+        }
+    }
+    
+    internal init(session: URLSession, netService: NetService) {
+        self._underlyingSession = session
+        if #available(iOS 9.0, OSX 10.11, *) {
+            let task = session.streamTask(with: netService)
+            self._taskIdentifier = task.taskIdentifier
+            FPSStreamTask.streamTasks[_taskIdentifier] = task
+        } else {
+            lasttaskIdAssociated += 1
+            self._taskIdentifier = lasttaskIdAssociated
+            self.service = netService
+            self.dispatch_queue = DispatchQueue(label: "FSPStreamTask", attributes: DispatchQueue.Attributes.concurrent)
+        }
+    }
+    
+    override open func cancel() {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            _underlyingTask!.cancel()
+        } else {
+            self._state = .canceling
+            inputStream?.setValue(kCFBooleanTrue, forKey: kCFStreamPropertyShouldCloseNativeSocket as String)
+            outputStream?.setValue(kCFBooleanTrue, forKey: kCFStreamPropertyShouldCloseNativeSocket as String)
+            
+            self.inputStream?.close()
+            self.outputStream?.close()
+            
+            self.inputStream?.remove(from: RunLoop.current, forMode: RunLoopMode.defaultRunLoopMode)
+            self.outputStream?.remove(from: RunLoop.current, forMode: RunLoopMode.defaultRunLoopMode)
+            
+            self.inputStream?.delegate = nil
+            self.outputStream?.delegate = nil
+            
+            self.inputStream = nil
+            self.outputStream = nil
+            
+            self._state = .completed
+            self._countOfBytesSent = 0
+            self._countOfBytesRecieved = 0
+        }
+    }
+    
+    var _error: Error? = nil
+    override open var error: Error? {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            return _underlyingTask!.error
+        } else {
+            return _error
+        }
+    }
+    
+    override open func suspend() {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            _underlyingTask!.suspend()
+        } else {
+            self._state = .suspended
+        }
+    }
+    
+    override open func resume() {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            _underlyingTask!.resume()
+        } else {
+            var readStream : Unmanaged<CFReadStream>?
+            var writeStream : Unmanaged<CFWriteStream>?
+            
+            if inputStream == nil || outputStream == nil {
+                if let host = host {
+                    let hostRef: CFString = NSString(string: host.hostname)
+                    CFStreamCreatePairWithSocketToHost(kCFAllocatorDefault, hostRef, UInt32(host.port), &readStream, &writeStream)
+                } else if let service = service {
+                    let cfnetService = CFNetServiceCreate(kCFAllocatorDefault, service.domain as CFString, service.type as CFString, service.name as CFString, Int32(service.port))
+                    CFStreamCreatePairWithSocketToNetService(kCFAllocatorDefault, cfnetService.takeRetainedValue(), &readStream, &writeStream)
+                }
+                
+                inputStream = readStream?.takeRetainedValue()
+                outputStream = writeStream?.takeRetainedValue()
+                guard let inputStream = inputStream, let outputStream = outputStream else {
+                    return
+                }
+                streamDelegate?.urlSession?(self._underlyingSession, streamTask: self, didBecome: inputStream, outputStream: outputStream)
+            }
+            
+            guard let inputStream = inputStream, let outputStream = outputStream else {
+                return
+            }
+            
+            inputStream.delegate = self
+            outputStream.delegate = self
+            
+            dispatch_queue.sync(execute: { 
+                inputStream.schedule(in: RunLoop.current, forMode: RunLoopMode.defaultRunLoopMode)
+                outputStream.schedule(in: RunLoop.current, forMode: RunLoopMode.defaultRunLoopMode)
+            })
+            
+            inputStream.open()
+            outputStream.open()
+            
+            _state = .running
+        }
+    }
+    
+    fileprivate let dataToBeSent: NSMutableData = NSMutableData()
+    fileprivate let dataReceived: NSMutableData = NSMutableData()
+    
+    /* Read minBytes, or at most maxBytes bytes and invoke the completion
+     * handler on the sessions delegate queue with the data or an error.
+     * If an error occurs, any outstanding reads will also fail, and new
+     * read requests will error out immediately.
+     */
+    open func readData(OfMinLength minBytes: Int, maxLength maxBytes: Int, timeout: TimeInterval, completionHandler: @escaping (Data?, Bool, NSError?) -> Void) {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            _underlyingTask!.readData(ofMinLength: minBytes, maxLength: maxBytes, timeout: timeout, completionHandler: completionHandler as! (Data?, Bool, Error?) -> Void)
+        } else {
+            guard let inputStream = inputStream else {
+                return
+            }
+            var timedOut: Bool = false
+            dispatch_queue.async {
+                if timeout > 0 {
+                    self.dispatch_queue.asyncAfter(deadline: DispatchTime.now() + Double(Int64(timeout * 1_000_000_000)) / Double(NSEC_PER_SEC), execute: {
+                        timedOut = true
+                        completionHandler(nil, inputStream.streamStatus == .atEnd, inputStream.streamError as NSError?)
+                    })
+                }
+                while (self.dataReceived.length == 0 || self.dataReceived.length < minBytes) && !timedOut {
+                    RunLoop.current.run(until: Date(timeIntervalSinceNow: 0.1));
+                    Thread.sleep(forTimeInterval: 0.1)
+                }
+                let dR = NSMutableData()
+                if self.dataReceived.length > maxBytes {
+                    let range = NSRange(location: 0, length: maxBytes - 1)
+                    dR.append(self.dataReceived.subdata(with: range))
+                    self.dataReceived.replaceBytes(in: range, withBytes: nil, length: 0)
+                } else {
+                    dR.append(self.dataReceived as Data)
+                    self.dataReceived.length = 0
+                }
+                completionHandler(dR as Data, inputStream.streamStatus == .atEnd, inputStream.streamError as NSError?)
+            }
+        }
+    }
+    
+    /* Write the data completely to the underlying socket.  If all the
+     * bytes have not been written by the timeout, a timeout error will
+     * occur.  Note that invocation of the completion handler does not
+     * guarantee that the remote side has received all the bytes, only
+     * that they have been written to the kernel. */
+    open func writeData(_ data: Data, timeout: TimeInterval, completionHandler: @escaping (Error?) -> Void) {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            _underlyingTask!.write(data, timeout: timeout, completionHandler: completionHandler)
+        } else {
+            guard let outputStream = outputStream else {
+                return
+            }
+            var timedOut: Bool = false
+            dispatch_queue.async {
+                if timeout > 0 {
+                    self.dispatch_queue.asyncAfter(deadline: DispatchTime.now() + Double(Int64(timeout * 1_000_000_000)) / Double(NSEC_PER_SEC), execute: {
+                        timedOut = true
+                        completionHandler(self._error)
+                    })
+                }
+                
+                self.dataToBeSent.append(data)
+                while !outputStream.hasSpaceAvailable && !timedOut {
+                    RunLoop.current.run(until: Date(timeIntervalSinceNow: 0.1));
+                    Thread.sleep(forTimeInterval: 0.1)
+                }
+                if self.dataToBeSent.length > 0 {
+                    let bytesWritten = outputStream.write(self.dataToBeSent.bytes.bindMemory(to: UInt8.self, capacity: self.dataToBeSent.length), maxLength: self.dataToBeSent.length) 
+                    if bytesWritten > 0 {
+                        let range = NSRange(location: 0, length: bytesWritten)
+                        self.dataToBeSent.replaceBytes(in: range, withBytes: nil, length: 0)
+                        self._countOfBytesSent += bytesWritten
+                        completionHandler(nil)
+                    } else {
+                        self._error = outputStream.streamError
+                        completionHandler(outputStream.streamError)
+                    }
+                }
+            }
+        }
+    }
+    
+    /* -captureStreams completes any already enqueued reads
+     * and writes, and then invokes the
+     * URLSession:streamTask:didBecomeInputStream:outputStream: delegate
+     * message. When that message is received, the task object is
+     * considered completed and will not receive any more delegate
+     * messages. */
+    open func captureStreams() {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            _underlyingTask!.captureStreams()
+        } else {
+            guard let outputStream = outputStream, let inputStream = inputStream else {
+                return
+            }
+            dispatch_queue.async {
+                self.write(false)
+                while inputStream.streamStatus != .atEnd {
+                    RunLoop.current.run(until: Date(timeIntervalSinceNow: 0.1));
+                    Thread.sleep(forTimeInterval: 0.1)
+                }
+                self.streamDelegate?.urlSession?(self._underlyingSession, streamTask: self, didBecome: inputStream, outputStream: outputStream)
+            }
+        }
+    }
+    
+    /* Enqueue a request to close the write end of the underlying socket.
+     * All outstanding IO will complete before the write side of the
+     * socket is closed.  The server, however, may continue to write bytes
+     * back to the client, so best practice is to continue reading from
+     * the server until you receive EOF.
+     */
+    open func closeWrite() {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            _underlyingTask!.closeWrite()
+        } else {
+            dispatch_queue.async(execute: { 
+                self.write(true)
+            })
+        }
+    }
+    
+    fileprivate func write(_ close: Bool) {
+        guard let outputStream = outputStream else {
+            return
+        }
+        while self.dataToBeSent.length > 0 {
+            let bytesWritten = outputStream.write(self.dataToBeSent.bytes.bindMemory(to: UInt8.self, capacity: self.dataToBeSent.length), maxLength: self.dataToBeSent.length) 
+            if bytesWritten > 0 {
+                let range = NSRange(location: 0, length: bytesWritten)
+                self.dataToBeSent.replaceBytes(in: range, withBytes: nil, length: 0)
+                self._countOfBytesSent += bytesWritten
+            } else {
+                self._error = outputStream.streamError as NSError?
+            }
+            if self.dataToBeSent.length == 0 {
+                break
+            }
+            RunLoop.current.run(until: Date(timeIntervalSinceNow: 0.1));
+            Thread.sleep(forTimeInterval: 0.1)
+        }
+        if close {
+            outputStream.close()
+            self.streamDelegate?.urlSession?(self._underlyingSession, writeClosedFor: self)
+        }
+    }
+    
+    /* Enqueue a request to close the read side of the underlying socket.
+     * All outstanding IO will complete before the read side is closed.
+     * You may continue writing to the server.
+     */
+    open func closeRead() {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            _underlyingTask!.closeRead()
+        } else {
+            guard let inputStream = inputStream else {
+                return
+            }
+            dispatch_queue.async {
+                while inputStream.streamStatus != .atEnd {
+                    RunLoop.current.run(until: Date(timeIntervalSinceNow: 0.1));
+                    Thread.sleep(forTimeInterval: 0.1)
+                }
+                inputStream.close()
+                self.streamDelegate?.urlSession?(self._underlyingSession, readClosedFor: self)
+            }
+        }
+    }
+    
+    /*
+     * Begin encrypted handshake.  The hanshake begins after all pending
+     * IO has completed.  TLS authentication callbacks are sent to the
+     * session's -URLSession:task:didReceiveChallenge:completionHandler:
+     */
+    open func startSecureConnection() {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            _underlyingTask!.startSecureConnection()
+        } else {
+            inputStream!.setProperty(StreamSocketSecurityLevel.negotiatedSSL.rawValue, forKey: .socketSecurityLevelKey)
+            outputStream!.setProperty(StreamSocketSecurityLevel.negotiatedSSL.rawValue, forKey: .socketSecurityLevelKey)
+        }
+    }
+    
+    /*
+     * Cleanly close a secure connection after all pending secure IO has
+     * completed.
+     */
+    open func stopSecureConnection() {
+        if #available(iOS 9.0, OSX 10.11, *) {
+            _underlyingTask!.stopSecureConnection()
+        } else {
+            inputStream!.setProperty(StreamSocketSecurityLevel.none.rawValue, forKey: .socketSecurityLevelKey)
+            outputStream!.setProperty(StreamSocketSecurityLevel.none.rawValue, forKey: .socketSecurityLevelKey)
+        }
+    }
+    
+    open func stream(_ aStream: Stream, handle eventCode: Stream.Event) {
+        switch (eventCode) {
+        case Stream.Event.errorOccurred:
+            self._error = aStream.streamError as NSError?
+            streamDelegate?.urlSession?(_underlyingSession, task: self, didCompleteWithError: error)
+        case Stream.Event.endEncountered:
+            break
+        case Stream.Event():
+            break
+        case Stream.Event.openCompleted:
+            break
+        case Stream.Event.hasBytesAvailable:
+            var buffer = [UInt8](repeating: 0, count: 2048)
+            if (aStream == inputStream) {
+                while (inputStream!.hasBytesAvailable) {
+                    let len = inputStream!.read(&buffer, maxLength: buffer.count)
+                    if len > 0 {
+                        dataReceived.append(&buffer, length: len)
+                        self._countOfBytesRecieved += len
+                    }
+                }
+            }
+        case Stream.Event.hasSpaceAvailable:
+            break
+        default:
+            break
+        }
+    }
+}
+
+internal extension URLSession {
+    /* Creates a bidirectional stream task to a given host and port.
+     */
+    func fpstreamTaskWithHostName(_ hostname: String, port: Int) -> FPSStreamTask {
+        return FPSStreamTask(session: self, host: hostname, port: port)
+    }
+    
+    /* Creates a bidirectional stream task with an NSNetService to identify the endpoint.
+     * The NSNetService will be resolved before any IO completes.
+     */
+    func fpstreamTaskWithNetService(_ service: NetService) -> FPSStreamTask {
+        return fpstreamTaskWithNetService(service)
+    }
+}
+
+@objc
+internal protocol FPSStreamDelegate : URLSessionTaskDelegate {
+    
+    
+    /* Indiciates that the read side of a connection has been closed.  Any
+     * outstanding reads complete, but future reads will immediately fail.
+     * This may be sent even when no reads are in progress. However, when
+     * this delegate message is received, there may still be bytes
+     * available.  You only know that no more bytes are available when you
+     * are able to read until EOF. */
+    @objc optional func urlSession(_ session: URLSession, readClosedFor streamTask: FPSStreamTask)
+    
+    
+    /* Indiciates that the write side of a connection has been closed.
+     * Any outstanding writes complete, but future writes will immediately
+     * fail.
+     */
+    @objc optional func urlSession(_ session: URLSession, writeClosedFor streamTask: FPSStreamTask)
+    
+    
+    /* A notification that the system has determined that a better route
+     * to the host has been detected (eg, a wi-fi interface becoming
+     * available.)  This is a hint to the delegate that it may be
+     * desirable to create a new task for subsequent work.  Note that
+     * there is no guarantee that the future task will be able to connect
+     * to the host, so callers should should be prepared for failure of
+     * reads and writes over any new interface. */
+    @objc optional func urlSession(_ session: URLSession, betterRouteDiscoveredFor streamTask: FPSStreamTask)
+    
+    
+    /* The given task has been completed, and unopened NSInputStream and
+     * NSOutputStream objects are created from the underlying network
+     * connection.  This will only be invoked after all enqueued IO has
+     * completed (including any necessary handshakes.)  The streamTask
+     * will not receive any further delegate messages.
+     */
+    @objc optional func urlSession(_ session: URLSession, streamTask: FPSStreamTask, didBecome inputStream: InputStream, outputStream: OutputStream)
+}
+
+private let ports: [String: Int] = ["http": 80, "https": 443, "smb": 445,"ftp": 21,"ftps": 22, "sftp": 2121,
+                                    "telnet": 23, "pop": 110, "smtp": 25, "imap": 143]
+private let securePorts: [String: Int] =  ["https": 443, "smb": 445, "ftps": 22, "sftp": 2121,
+                                           "telnet": 992, "pop": 995, "smtp": 465, "imap": 993]

Sources/FileObject.swift

@@ -0,0 +1,361 @@
+//
+//  FileProvider.swift
+//  FileProvider
+//
+//  Created by Amir Abbas Mousavian.
+//  Copyright © 2016 Mousavian. Distributed under MIT license.
+//
+
+import Foundation
+
+/// Containts path, url and attributes of a file or resource.
+open class FileObject: Equatable {
+    /// A `Dictionary` contains file information,  using `URLResourceKey` keys.
+    open internal(set) var allValues: [URLResourceKey: Any]
+    
+    internal init(allValues: [URLResourceKey: Any]) {
+        self.allValues = allValues
+    }
+    
+    internal init(url: URL, name: String, path: String) {
+        self.allValues = [URLResourceKey: Any]()
+        self.url = url
+        self.name = name
+        self.path = path
+    }
+    
+    /// url to access the resource, not supported by Dropbox provider
+    @available(*, deprecated, renamed: "url", message: "Use url.absoluteURL instead.")
+    open var absoluteURL: URL? {
+        return url?.absoluteURL
+    }
+    
+    /// URL to access the resource, can be a relative URL against base URL.
+    /// not supported by Dropbox provider.
+    open internal(set) var url: URL? {
+        get {
+            return allValues[.fileURL] as? URL
+        }
+        set {
+            allValues[.fileURL] = newValue
+        }
+    }
+    
+    /// Name of the file, usually equals with the last path component
+    open internal(set) var name: String {
+        get {
+            return allValues[.nameKey] as! String
+        }
+        set {
+            allValues[.nameKey] = newValue
+        }
+    }
+    
+    /// Relative path of file object
+    open internal(set) var path: String {
+        get {
+            return allValues[.pathKey] as! String
+        }
+        set {
+            allValues[.pathKey] = newValue
+        }
+    }
+    
+    /// Size of file on disk, return -1 for directories.
+    open internal(set) var size: Int64 {
+        get {
+            return allValues[.fileSizeKey] as? Int64 ?? -1
+        }
+        set {
+            allValues[.fileSizeKey] = newValue
+        }
+    }
+    
+    /// The time contents of file has been created, returns nil if not set
+    open internal(set) var creationDate: Date? {
+        get {
+            return allValues[.creationDateKey] as? Date
+        }
+        set {
+            allValues[.creationDateKey] = newValue
+        }
+    }
+    
+    /// The time contents of file has been modified, returns nil if not set
+    open internal(set) var modifiedDate: Date? {
+        get {
+            return allValues[.contentModificationDateKey] as? Date
+        }
+        set {
+            allValues[.contentModificationDateKey] = newValue
+        }
+    }
+    
+    /// return resource type of file, usually directory, regular or symLink
+    open internal(set) var type: URLFileResourceType? {
+        get {
+            return allValues[.fileResourceTypeKey] as? URLFileResourceType
+        }
+        set {
+            allValues[.fileResourceTypeKey] = newValue
+        }
+    }
+    
+    /// **OBSOLETED:** Use `type` property instead.
+    @available(*, obsoleted: 1.0, renamed: "type", message: "Use type property instead.")
+    open var fileType: URLFileResourceType? {
+        return self.type
+    }
+    
+    /// File is hidden either because begining with dot or filesystem flags
+    /// Setting this value on a file begining with dot has no effect
+    open internal(set) var isHidden: Bool {
+        get {
+            return allValues[.isHiddenKey] as? Bool ?? false
+        }
+        set {
+            allValues[.isHiddenKey] = newValue
+        }
+    }
+    
+    /// File can not be written
+    open internal(set) var isReadOnly: Bool {
+        get {
+            return !(allValues[.isWritableKey] as? Bool ?? true)
+        }
+        set {
+            allValues[.isWritableKey] = !newValue
+        }
+    }
+    
+    /// File is a Directory
+    open var isDirectory: Bool {
+        return self.type == .directory
+    }
+    
+    /// File is a normal file
+    open var isRegularFile: Bool {
+        return self.type == .regular
+    }
+    
+    /// File is a Symbolic link
+    open var isSymLink: Bool {
+        return self.type == .symbolicLink
+    }
+    
+    /// Check `FileObject` equality
+    public static func ==(lhs: FileObject, rhs: FileObject) -> Bool {
+        if rhs === lhs {
+            return true
+        }
+        if type(of: lhs) != type(of: rhs) {
+            return false
+        }
+        if let rurl = rhs.url, let lurl = lhs.url {
+            return rurl == lurl
+        }
+        return rhs.path == lhs.path && rhs.size == lhs.size && rhs.modifiedDate == lhs.modifiedDate
+    }
+    
+    internal  func mapPredicate() -> [String: Any] {
+        let mapDict: [URLResourceKey: String] = [.fileURL: "url", .nameKey: "name", .pathKey: "path", .fileSizeKey: "filesize", .creationDateKey: "creationDate",
+                                                 .contentModificationDateKey: "modifiedDate", .isHiddenKey: "isHidden", .isWritableKey: "isWritable", .serverDate: "serverDate", .entryTag: "entryTag", .mimeType: "mimeType"]
+        let typeDict: [URLFileResourceType: String] = [.directory: "directory", .regular: "regular", .symbolicLink: "symbolicLink", .unknown: "unknown"]
+        var result = [String: Any]()
+        for (key, value) in allValues {
+            if let convertkey = mapDict[key] {
+                result[convertkey] = value
+            }
+        }
+        result["eTag"] = result["entryTag"]
+        result["isReadOnly"] = self.isReadOnly
+        result["isDirectory"] = self.isDirectory
+        result["isRegularFile"] = self.isRegularFile
+        result["isSymLink"] = self.isSymLink
+        result["type"] = typeDict[self.type ?? .unknown] ?? "unknown"
+        return result
+    }
+}
+
+internal func resolve(dateString: String) -> Date? {
+    let dateFor: DateFormatter = DateFormatter()
+    dateFor.locale = Locale(identifier: "en_US")
+    dateFor.dateFormat = "yyyy'-'MM'-'dd'T'HH':'mm':'ssZ"
+    if let rfc3339 = dateFor.date(from: dateString) {
+        return rfc3339
+    }
+    dateFor.dateFormat = "EEE',' dd' 'MMM' 'yyyy HH':'mm':'ss z"
+    if let rfc1123 = dateFor.date(from: dateString) {
+        return rfc1123
+    }
+    dateFor.dateFormat = "EEEE',' dd'-'MMM'-'yy HH':'mm':'ss z"
+    if let rfc850 = dateFor.date(from: dateString) {
+        return rfc850
+    }
+    dateFor.dateFormat = "EEE MMM d HH':'mm':'ss yyyy"
+    if let asctime = dateFor.date(from: dateString) {
+        return asctime
+    }
+    
+    return nil
+}
+
+internal func rfc3339utc(of date:Date) -> String {
+    let fm = DateFormatter()
+    fm.dateFormat = "yyyy'-'MM'-'dd'T'HH':'mm':'ss'Z'"
+    fm.timeZone = TimeZone(identifier:"UTC")
+    fm.locale = Locale(identifier:"en_US_POSIX")
+    return fm.string(from:date)
+}
+
+/// Sorting FileObject array by given criteria, **not thread-safe**
+public struct FileObjectSorting {
+    
+    /// Determines sort kind by which item of File object
+    public enum SortType {
+        /// Sorting by default Finder (case-insensitive) behavior
+        case name
+        /// Sorting by case-sensitive form of file name
+        case nameCaseSensitive
+        /// Sorting by case-in sensitive form of file name
+        case nameCaseInsensitive
+        /// Sorting by file type
+        case `extension`
+        /// Sorting by file modified date
+        case modifiedDate
+        /// Sorting by file creation date
+        case creationDate
+        /// Sorting by file modified date
+        case size
+        
+        /// all sort types
+        static var allItems: [SortType] {
+            return [.name, .nameCaseSensitive, .nameCaseInsensitive, .extension,
+                    .modifiedDate,.creationDate, .size]
+        }
+    }
+    
+    public let sortType: SortType
+    /// puts A before Z, default is true
+    public let ascending: Bool
+    /// puts directories on top, regardless of other attributes, default is false
+    public let isDirectoriesFirst: Bool
+    
+    public static let nameAscending = FileObjectSorting(type: .name, ascending: true)
+    public static let nameDesceding = FileObjectSorting(type: .name, ascending: false)
+    public static let sizeAscending = FileObjectSorting(type: .size, ascending: true)
+    public static let sizeDesceding = FileObjectSorting(type: .size, ascending: false)
+    public static let extensionAscending = FileObjectSorting(type: .extension, ascending: true)
+    public static let extensionDesceding = FileObjectSorting(type: .extension, ascending: false)
+    public static let modifiedAscending = FileObjectSorting(type: .modifiedDate, ascending: true)
+    public static let modifiedDesceding = FileObjectSorting(type: .modifiedDate, ascending: false)
+    public static let createdAscending = FileObjectSorting(type: .creationDate, ascending: true)
+    public static let createdDesceding = FileObjectSorting(type: .creationDate, ascending: false)
+    
+    /// Initializes a `FileObjectSorting` allows to sort an `Array` of `FileObject`.
+    ///
+    /// - Parameters:
+    ///   - type: Determines to sort based on which file property.
+    ///   - ascending: `true` of resulting `Array` is ascending
+    ///   - isDirectoriesFirst: Puts directoris on the top of resulting `Array`.
+    public init (type: SortType, ascending: Bool = true, isDirectoriesFirst: Bool = false) {
+        self.sortType = type
+        self.ascending = ascending
+        self.isDirectoriesFirst = isDirectoriesFirst
+    }
+    
+    /// Sorts array of `FileObject`s by criterias set in properties
+    public func sort(_ files: [FileObject]) -> [FileObject] {
+        return files.sorted {
+            if isDirectoriesFirst {
+                if ($0.isDirectory) && !($1.isDirectory) {
+                    return true
+                }
+                if !($0.isDirectory) && ($1.isDirectory) {
+                    return false
+                }
+            }
+            switch sortType {
+            case .name:
+                return ($0.name).localizedStandardCompare($1.name) == (ascending ? .orderedAscending : .orderedDescending)
+            case .nameCaseSensitive:
+                return ($0.name).localizedCompare($1.name) == (ascending ? .orderedAscending : .orderedDescending)
+            case .nameCaseInsensitive:
+                return ($0.name).localizedCaseInsensitiveCompare($1.name) == (ascending ? .orderedAscending : .orderedDescending)
+            case .extension:
+                let kind1 = $0.isDirectory ? "folder" : ($0.path as NSString).pathExtension
+                let kind2 = $1.isDirectory ? "folder" : ($1.path as NSString).pathExtension
+                return kind1.localizedCaseInsensitiveCompare(kind2) == (ascending ? .orderedAscending : .orderedDescending)
+            case .modifiedDate:
+                let fileMod1 = $0.modifiedDate ?? Date.distantPast
+                let fileMod2 = $1.modifiedDate ?? Date.distantPast
+                return ascending ? fileMod1 < fileMod2 : fileMod1 > fileMod2
+            case .creationDate:
+                let fileCreation1 = $0.creationDate ?? Date.distantPast
+                let fileCreation2 = $1.creationDate ?? Date.distantPast
+                return ascending ? fileCreation1 < fileCreation2 : fileCreation1 > fileCreation2
+            case .size:
+                return ascending ? $0.size < $1.size : $0.size > $1.size
+            }
+        }
+    }
+}
+
+extension Array where Element: FileObject {
+    /// Returns a sorted array of `FileObject`s by criterias set in properties.
+    public func sort(by type: FileObjectSorting.SortType, ascending: Bool = true, isDirectoriesFirst: Bool = false) -> [Element] {
+        let sorting = FileObjectSorting(type: type, ascending: ascending, isDirectoriesFirst: isDirectoriesFirst)
+        return sorting.sort(self) as! [Element]
+    }
+    
+    /// Sorts array of `FileObject`s by criterias set in properties
+    public mutating func sorted(by type: FileObjectSorting.SortType, ascending: Bool = true, isDirectoriesFirst: Bool = false) {
+        self = self.sort(by: type, ascending: ascending, isDirectoriesFirst: isDirectoriesFirst)
+    }
+}
+
+extension URLFileResourceType {
+    /// Returns corresponding `URLFileResourceType` of a `FileAttributeType` value
+    public init(fileTypeValue: FileAttributeType) {
+        switch fileTypeValue {
+        case FileAttributeType.typeCharacterSpecial: self = .characterSpecial
+        case FileAttributeType.typeDirectory: self = .directory
+        case FileAttributeType.typeBlockSpecial: self = .blockSpecial
+        case FileAttributeType.typeRegular: self = .regular
+        case FileAttributeType.typeSymbolicLink: self = .symbolicLink
+        case FileAttributeType.typeSocket: self = .socket
+        case FileAttributeType.typeUnknown: self = .unknown
+        default: self = .unknown
+        }
+    }
+}
+
+internal extension URLResourceKey {
+    static let fileURL = URLResourceKey(rawValue: "NSURLFileURLKey")
+    static let serverDate = URLResourceKey(rawValue: "NSURLServerDateKey")
+    static let entryTag = URLResourceKey(rawValue: "NSURLEntryTagKey")
+    static let mimeType = URLResourceKey(rawValue: "NSURLMIMETypeIdentifierKey")
+}
+
+internal extension URL {
+    var uw_scheme: String {
+        return self.scheme ?? ""
+    }
+}
+
+internal func jsonToDictionary(_ jsonString: String) -> [String: AnyObject]? {
+    guard let data = jsonString.data(using: .utf8) else {
+        return nil
+    }
+    if let dic = try? JSONSerialization.jsonObject(with: data, options: JSONSerialization.ReadingOptions()) as? [String: AnyObject] {
+        return dic
+    }
+    return nil
+}
+
+internal func dictionaryToJSON(_ dictionary: [String: AnyObject]) -> String? {
+    if let data = try? JSONSerialization.data(withJSONObject: dictionary, options: JSONSerialization.WritingOptions()) {
+        return String(data: data, encoding: .utf8)
+    }
+    return nil
+}

Sources/FileProvider.h

@@ -0,0 +1,38 @@
+//
+//  FileProvider iOS.h
+//  FileProvider iOS
+//
+//  Created by Amir Abbas Mousavian on 5/6/95.
+//
+//
+
+#import <TargetConditionals.h>
+
+#if TARGET_OS_IPHONE || TARGET_IPHONE_SIMULATOR
+#import <UIKit/UIKit.h>
+//! Project version number for FileProvider iOS.
+FOUNDATION_EXPORT double FileProvider_iOSVersionNumber;
+//! Project version string for FileProvider iOS.
+FOUNDATION_EXPORT const unsigned char FileProvider_iOSVersionString[];
+
+#elif defined TARGET_OS_TV
+#import <UIKit/UIKit.h>
+//! Project version number for FileProvider tvOS.
+FOUNDATION_EXPORT double FileProvider_tvOSVersionNumber;
+//! Project version string for FileProvider tvOS.
+FOUNDATION_EXPORT const unsigned char FileProvider_tvOSVersionString[];
+
+#elif defined TARGET_OS_MAC
+#import <Cocoa/Cocoa.h>
+//! Project version number for FileProvider OSX.
+FOUNDATION_EXPORT double FileProvider_OSXVersionNumber;
+//! Project version string for FileProvider OSX.
+FOUNDATION_EXPORT const unsigned char FileProvider_OSXVersionString[];
+
+#else
+// Unsupported platform
+#endif
+
+// In this header, you should import all the public headers of your framework using statements like #import <FileProvider_iOS/PublicHeader.h>
+
+

Sources/LocalFileProvider.swift

@@ -0,0 +1,594 @@
+//
+//  LocalFileProvider.swift
+//  FileProvider
+//
+//  Created by Amir Abbas Mousavian.
+//  Copyright © 2016 Mousavian. Distributed under MIT license.
+//
+
+import Foundation
+
+/**
+ This provider class allows interacting with local files placed in user disk. It also allows an
+ easy way to use `NSFileCoordintaing` to coordinate read and write when neccessary.
+ 
+ it uses `FileManager` foundation class with some additions like searching and reading a portion of file.
+ */
+open class LocalFileProvider: FileProvider, FileProviderMonitor, FileProvideUndoable {
+    open class var type: String { return "Local" }
+    open var isPathRelative: Bool
+    open fileprivate(set) var baseURL: URL?
+    open var currentPath: String
+    open var dispatch_queue: DispatchQueue
+    open var operation_queue: OperationQueue
+    open weak var delegate: FileProviderDelegate?
+    open internal(set) var credential: URLCredential?
+    
+    /// Underlying `FileManager` object for listing and metadata fetching.
+    open private(set) var fileManager = FileManager()
+    /// Underlying `FileManager` object for operationa like copying, moving, etc.
+    open private(set) var opFileManager = FileManager()
+    fileprivate var fileProviderManagerDelegate: LocalFileProviderManagerDelegate? = nil
+    
+    open var undoManager: UndoManager? = nil
+    
+    /**
+     Forces file operations to use `NSFileCoordinating`, should be set `true` if:
+     - Files are on ubiquity (iCloud) container.
+     - Multiple processes are accessing same file, recommended when accessing a shared/public 
+     user document in macOS and when using app extensions in iOS/tvOS (shared container).
+     
+     By default it's `true` when using iCloud or shared container (App Group) initializers,
+     otherwise it's `false` to accelerate operations.
+    */
+    open var isCoorinating: Bool
+    
+    /**
+     Initializes provider for the specified common directory in the requested domains.
+     default values are `directory: .documentDirectory, domainMask: .userDomainMask`.
+     
+     - Parameters:
+       - directory: The search path directory. The supported values are described in `FileManager.SearchPathDirectory`.
+       - domainMask: The file system domain to search. The value for this parameter is one or more of the constants described in `FileManager.SearchPathDomainMask`.
+    */
+    public convenience init (directory: FileManager.SearchPathDirectory = .documentDirectory, domainMask: FileManager.SearchPathDomainMask = .userDomainMask) {
+        self.init(baseURL: FileManager.default.urls(for: directory, in: domainMask).first!)
+    }
+    
+    /**
+     Failable initializer for the specified shared container directory, allows data and files to be shared among app
+     and extensions regarding sandbox requirements. Container ID is same with app group specified in project `Capabilities`
+     tab under `App Group` item. If you don't have enough privilage to access container or the app group imply does't exist,
+     initialing will fail.
+     default values are `directory: .documentDirectory`.
+    
+     - Parameters:
+       - sharedContainerId: Same with `App Group` identifier defined in project settings.
+       - directory: The search path directory. The supported values are described in `FileManager.SearchPathDirectory`.
+    */
+    public convenience init? (sharedContainerId: String, directory: FileManager.SearchPathDirectory = .documentDirectory) {
+        guard let baseURL = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: sharedContainerId) else {
+            return nil
+        }
+        
+        var finalBaseURL = baseURL
+        
+        switch directory {
+        case .documentDirectory:
+            finalBaseURL = baseURL.appendingPathComponent("Documents")
+        case .libraryDirectory:
+            finalBaseURL = baseURL.appendingPathComponent("Library")
+        case .cachesDirectory:
+            finalBaseURL = baseURL.appendingPathComponent("Library/Caches")
+        case .applicationSupportDirectory:
+            finalBaseURL = baseURL.appendingPathComponent("Library/Application support")
+        default:
+            break
+        }
+        
+        self.init(baseURL: finalBaseURL)
+        self.isCoorinating = true
+        
+        try? fileManager.createDirectory(at: finalBaseURL, withIntermediateDirectories: true)
+    }
+    
+    /// Initializes provider for the specified local URL.
+    ///
+    /// - Parameter baseURL: Local URL location for base directory.
+    public init (baseURL: URL) {
+        guard baseURL.isFileURL else {
+            fatalError("Cannot initialize a Local provider from remote URL.")
+        }
+        self.baseURL = baseURL
+        self.isPathRelative = true
+        self.currentPath = ""
+        self.credential = nil
+        self.isCoorinating = false
+        
+        dispatch_queue = DispatchQueue(label: "FileProvider.\(type(of: self).type)", attributes: .concurrent)
+        operation_queue = OperationQueue()
+        operation_queue.name = "FileProvider.\(type(of: self).type).Operation"
+        
+        fileProviderManagerDelegate = LocalFileProviderManagerDelegate(provider: self)
+        opFileManager.delegate = fileProviderManagerDelegate
+        
+    }
+    
+    /// **DEPRECATED:** No longer is in use and overriding this method has no effect anymore.
+    @available(*, deprecated, message: "Overriding this method has no effect anymore.")
+    open class func defaultBaseURL() -> URL {
+        return FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first!
+    }
+    
+    open func contentsOfDirectory(path: String, completionHandler: @escaping ((_ contents: [FileObject], _ error: Error?) -> Void)) {
+        dispatch_queue.async {
+            do {
+                let contents = try self.fileManager.contentsOfDirectory(at: self.url(of: path), includingPropertiesForKeys: nil, options: .skipsSubdirectoryDescendants)
+                let filesAttributes = contents.flatMap({ (fileURL) -> LocalFileObject? in
+                    let path = self.relativePathOf(url: fileURL)
+                    return LocalFileObject(fileWithPath: path, relativeTo: self.baseURL)
+                })
+                completionHandler(filesAttributes, nil)
+            } catch let e {
+                completionHandler([], e)
+            }
+        }
+    }
+    
+    open func attributesOfItem(path: String, completionHandler: @escaping ((_ attributes: FileObject?, _ error: Error?) -> Void)) {
+        dispatch_queue.async {
+            completionHandler(LocalFileObject(fileWithPath: path, relativeTo: self.baseURL), nil)
+        }
+    }
+    
+    open func storageProperties(completionHandler: (@escaping (_ total: Int64, _ used: Int64) -> Void)) {
+        let values = try? baseURL?.resourceValues(forKeys: [.volumeTotalCapacityKey, .volumeAvailableCapacityKey])
+        let totalSize = Int64(values??.volumeTotalCapacity ?? -1)
+        let freeSize = Int64(values??.volumeAvailableCapacity ?? 0)
+        completionHandler(totalSize, totalSize - freeSize)
+    }
+    
+    open func searchFiles(path: String, recursive: Bool, query: NSPredicate, foundItemHandler: ((FileObject) -> Void)?, completionHandler: @escaping ((_ files: [FileObject], _ error: Error?) -> Void)) {
+        dispatch_queue.async {
+            let iterator = self.fileManager.enumerator(at: self.url(of: path), includingPropertiesForKeys: nil, options: recursive ? [] : [.skipsSubdirectoryDescendants, .skipsPackageDescendants]) { (url, e) -> Bool in
+                completionHandler([], e)
+                return true
+            }
+            var result = [LocalFileObject]()
+            while let fileURL = iterator?.nextObject() as? URL {
+                let path = self.relativePathOf(url: fileURL)
+                if let fileObject = LocalFileObject(fileWithPath: path, relativeTo: self.baseURL), query.evaluate(with: fileObject.mapPredicate()) {
+                    result.append(fileObject)
+                    foundItemHandler?(fileObject)
+                }
+            }
+            completionHandler(result, nil)
+        }
+    }
+    
+    open func isReachable(completionHandler: @escaping (Bool) -> Void) {
+        dispatch_queue.async {
+            completionHandler(self.fileManager.isReadableFile(atPath: self.baseURL!.path))
+        }
+    }
+    
+    open weak var fileOperationDelegate : FileOperationDelegate?
+    
+    @discardableResult
+    open func create(folder folderName: String, at atPath: String, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.create(path: (atPath as NSString).appendingPathComponent(folderName) + "/")
+        return self.doOperation(opType, completionHandler: completionHandler)
+    }
+    
+    @discardableResult
+    open func create(file fileName: String, at atPath: String, contents data: Data?, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let fileName = fileName.trimmingCharacters(in: CharacterSet(charactersIn: "/"))
+        let path = (atPath as NSString).appendingPathComponent(fileName)
+        let opType = FileOperationType.create(path: path)
+        
+        return self.doOperation(opType, data: data, atomically: true, completionHandler: completionHandler)
+    }
+    
+    @discardableResult
+    open func moveItem(path: String, to toPath: String, overwrite: Bool = false, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.move(source: path, destination: toPath)
+
+        if !overwrite && self.fileManager.fileExists(atPath: self.url(of: toPath).path) {
+            completionHandler?(self.throwError(toPath, code: CocoaError.fileWriteFileExists as FoundationErrorEnum))
+            return nil
+        }
+        
+        return self.doOperation(opType, completionHandler: completionHandler)
+    }
+    
+    @discardableResult
+    open func copyItem(path: String, to toPath: String, overwrite: Bool = false, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.copy(source: path, destination: toPath)
+        
+        if !overwrite && self.fileManager.fileExists(atPath: self.url(of: toPath).path) {
+            self.dispatch_queue.async {
+                completionHandler?(self.throwError(toPath, code: CocoaError.fileWriteFileExists as FoundationErrorEnum))
+            }
+            return nil
+        }
+        
+        return self.doOperation(opType, completionHandler: completionHandler)
+    }
+    
+    @discardableResult
+    open func removeItem(path: String, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.remove(path: path)
+        return self.doOperation(opType, completionHandler: completionHandler)
+    }
+    
+    @discardableResult
+    open func copyItem(localFile: URL, to toPath: String, overwrite: Bool, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        if !overwrite && self.fileManager.fileExists(atPath: self.url(of: toPath).path) {
+            self.dispatch_queue.async {
+                completionHandler?(self.throwError(toPath, code: CocoaError.fileWriteFileExists as FoundationErrorEnum))
+            }
+            return nil
+        }
+        let opType = FileOperationType.copy(source: localFile.absoluteString, destination: toPath)
+        return self.doOperation(opType, forUploading: true, completionHandler: completionHandler)
+    }
+    
+    @discardableResult
+    open func copyItem(path: String, toLocalURL: URL, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.copy(source: path, destination: toLocalURL.absoluteString)
+        return self.doOperation(opType, completionHandler: completionHandler)
+    }
+    
+    dynamic func doSimpleOperation(_ box: UndoBox) {
+        guard let _ = self.undoManager else { return }
+        _ = self.doOperation(box.undoOperation) { (_) in
+            return
+        }
+    }
+    
+    @discardableResult
+    fileprivate func doOperation(_ opType: FileOperationType, data: Data? = nil, atomically: Bool = false, forUploading: Bool = false, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        
+        func urlofpath(path: String) -> URL {
+            if path.hasPrefix("file://") {
+                let removedSchemePath = path.replacingOccurrences(of: "file://", with: "", options: .anchored)
+                let pDecodedPath = removedSchemePath.removingPercentEncoding ?? removedSchemePath
+                return URL(fileURLWithPath: pDecodedPath)
+            } else {
+                return self.url(of: path)
+            }
+        }
+        
+        guard let sourcePath = opType.source else { return nil }
+        let destPath = opType.destination
+        let source: URL = urlofpath(path: sourcePath)
+        
+        let dest: URL?
+        if let destPath = destPath {
+            dest = urlofpath(path: destPath)
+        } else {
+            dest = nil
+        }
+        
+        if let undoManager = self.undoManager, let undoOp = self.undoOperation(for: opType) {
+            let undoBox = UndoBox(provider: self, operation: opType, undoOperation: undoOp)
+            undoManager.beginUndoGrouping()
+            undoManager.registerUndo(withTarget: self, selector: #selector(LocalFileProvider.doSimpleOperation(_:)), object: undoBox)
+            undoManager.setActionName(opType.actionDescription)
+            undoManager.endUndoGrouping()
+        }
+        
+        var successfulSecurityScopedResourceAccess = false
+        
+        let operationHandler: (URL, URL?) -> Void = { source, dest in
+            do {
+                switch opType {
+                case .create:
+                    if sourcePath.hasSuffix("/") {
+                        try self.opFileManager.createDirectory(at: source, withIntermediateDirectories: true, attributes: [:])
+                    } else {
+                        try data?.write(to: source, options: Data.WritingOptions.atomic)
+                    }
+                case .modify:
+                    try data?.write(to: source, options: atomically ? [.atomic] : [])
+                case .copy:
+                    guard let dest = dest else { return }
+                    try self.opFileManager.copyItem(at: source, to: dest)
+                case .move:
+                    guard let dest = dest else { return }
+                    try self.opFileManager.moveItem(at: source, to: dest)
+                case.remove:
+                    try self.opFileManager.removeItem(at: source)
+                default:
+                    return
+                }
+                if successfulSecurityScopedResourceAccess {
+                    source.stopAccessingSecurityScopedResource()
+                }
+                
+                self.dispatch_queue.async {
+                    completionHandler?(nil)
+                }
+                DispatchQueue.main.async {
+                    self.delegate?.fileproviderSucceed(self, operation: opType)
+                }
+            } catch let e {
+                if successfulSecurityScopedResourceAccess {
+                    source.stopAccessingSecurityScopedResource()
+                }
+                self.dispatch_queue.async {
+                    completionHandler?(e)
+                }
+                DispatchQueue.main.async {
+                    self.delegate?.fileproviderFailed(self, operation: opType)
+                }
+            }
+        }
+        
+        if isCoorinating {
+            successfulSecurityScopedResourceAccess = source.startAccessingSecurityScopedResource()
+            var intents = [NSFileAccessIntent]()
+            switch opType {
+            case .create, .modify:
+                intents.append(NSFileAccessIntent.writingIntent(with: source, options: .forReplacing))
+            case .copy:
+                guard let dest = dest else { return nil }
+                intents.append(NSFileAccessIntent.readingIntent(with: source, options: forUploading ? .forUploading : .withoutChanges))
+                intents.append(NSFileAccessIntent.writingIntent(with: dest, options: .forReplacing))
+            case .move:
+                guard let dest = dest else { return nil }
+                intents.append(NSFileAccessIntent.writingIntent(with: source, options: .forMoving))
+                intents.append(NSFileAccessIntent.writingIntent(with: dest, options: .forReplacing))
+            case .remove:
+                intents.append(NSFileAccessIntent.writingIntent(with: source, options: .forDeleting))
+            default:
+                return nil
+            }
+            self.coordinated(intents: intents, completionHandler: operationHandler, errorHandler: { error in
+                self.dispatch_queue.async {
+                    completionHandler?(error)
+                }
+                DispatchQueue.main.async {
+                    self.delegate?.fileproviderFailed(self, operation: opType)
+                }
+            })
+        } else {
+            operation_queue.addOperation {
+                operationHandler(source, dest)
+            }
+        }
+        
+        return LocalOperationHandle(operationType: opType, baseURL: self.baseURL)
+    }
+    
+    @discardableResult
+    open func contents(path: String, completionHandler: @escaping ((_ contents: Data?, _ error: Error?) -> Void)) -> OperationHandle? {
+        let opType = FileOperationType.fetch(path: path)
+        let url = self.url(of: path)
+        
+        let operationHandler: (URL) -> Void = { url in
+            do {
+                let data = try Data(contentsOf: url)
+                self.dispatch_queue.async {
+                    completionHandler(data, nil)
+                }
+            } catch let e {
+                self.dispatch_queue.async {
+                    completionHandler(nil, e)
+                }
+            }
+        }
+        
+        if isCoorinating {
+            let intent = NSFileAccessIntent.readingIntent(with: url, options: .withoutChanges)
+            coordinated(intents: [intent], completionHandler: operationHandler, errorHandler: { error in
+                self.dispatch_queue.async {
+                    completionHandler(nil, error)
+                }
+                DispatchQueue.main.async {
+                    self.delegate?.fileproviderFailed(self, operation: opType)
+                }
+            })
+        } else {
+            dispatch_queue.async {
+                operationHandler(url)
+            }
+        }
+        
+        return LocalOperationHandle(operationType: opType, baseURL: self.baseURL)
+    }
+    
+    @discardableResult
+    open func contents(path: String, offset: Int64, length: Int, completionHandler: @escaping ((_ contents: Data?, _ error: Error?) -> Void)) -> OperationHandle? {
+        if length == 0 || offset < 0 {
+            dispatch_queue.async {
+                completionHandler(Data(), nil)
+            }
+            return nil
+        }
+        
+        if offset == 0 && length < 0 {
+            return self.contents(path: path, completionHandler: completionHandler)
+        }
+        
+        let opType = FileOperationType.fetch(path: path)
+        let url = self.url(of: path)
+        
+        let operationHandler: (URL) -> Void = { url in
+            guard let handle = FileHandle(forReadingAtPath: url.path) else {
+                self.dispatch_queue.async {
+                    completionHandler(nil, self.throwError(path, code: CocoaError.fileNoSuchFile as FoundationErrorEnum))
+                }
+                return
+            }
+            
+            defer {
+                handle.closeFile()
+            }
+            
+            let size = LocalFileObject(fileWithURL: url)?.size ?? -1
+            guard size > offset else {
+                self.dispatch_queue.async {
+                    completionHandler(nil, self.throwError(path, code: CocoaError.fileReadTooLarge as FoundationErrorEnum))
+                }
+                return
+            }
+            handle.seek(toFileOffset: UInt64(offset))
+            guard Int64(handle.offsetInFile) == offset else {
+                self.dispatch_queue.async {
+                    completionHandler(nil, self.throwError(path, code: CocoaError.fileReadTooLarge as FoundationErrorEnum))
+                }
+                return
+            }
+            
+            let data = handle.readData(ofLength: length)
+            
+            self.dispatch_queue.async {
+                completionHandler(data, nil)
+            }
+        }
+        
+        if isCoorinating {
+            let intent = NSFileAccessIntent.readingIntent(with: url, options: .withoutChanges)
+            coordinated(intents: [intent], completionHandler: operationHandler, errorHandler: { error in
+                completionHandler(nil, error)
+                DispatchQueue.main.async {
+                    self.delegate?.fileproviderFailed(self, operation: opType)
+                }
+            })
+        } else {
+            dispatch_queue.async {
+                operationHandler(url)
+            }
+        }
+        
+        return LocalOperationHandle(operationType: opType, baseURL: self.baseURL)
+    }
+    
+    @discardableResult
+    open func writeContents(path: String, contents data: Data, atomically: Bool, overwrite: Bool, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.modify(path: path)
+        return self.doOperation(opType, data: data, atomically: atomically, completionHandler: completionHandler)
+    }
+    
+    fileprivate var monitors = [LocalFolderMonitor]()
+    
+    open func registerNotifcation(path: String, eventHandler: @escaping (() -> Void)) {
+        self.unregisterNotifcation(path: path)
+        let dirurl = self.url(of: path)
+        let isdir = (try? dirurl.resourceValues(forKeys: [.isDirectoryKey]).isDirectory ?? false) ?? false
+        if !isdir {
+            return
+        }
+        let monitor = LocalFolderMonitor(url: dirurl) {
+            eventHandler()
+        }
+        monitor.start()
+        monitors.append(monitor)
+    }
+    
+    open func unregisterNotifcation(path: String) {
+        var removedMonitor: LocalFolderMonitor?
+        for (i, monitor) in monitors.enumerated() {
+            if self.relativePathOf(url: monitor.url) == path {
+                removedMonitor = monitors.remove(at: i)
+                break
+            }
+        }
+        removedMonitor?.stop()
+    }
+    
+    open func isRegisteredForNotification(path: String) -> Bool {
+        return monitors.map( { self.relativePathOf(url: $0.url) } ).contains(path.trimmingCharacters(in: CharacterSet(charactersIn: "/")))
+    }
+    
+    open func copy(with zone: NSZone? = nil) -> Any {
+        let copy = LocalFileProvider(baseURL: self.baseURL!)
+        copy.currentPath = self.currentPath
+        copy.isPathRelative = self.isPathRelative
+        copy.undoManager = self.undoManager
+        copy.isCoorinating = self.isCoorinating
+        copy.delegate = self.delegate
+        copy.fileOperationDelegate = self.fileOperationDelegate
+        return copy
+    }
+}
+
+public extension LocalFileProvider {
+    /**
+     Creates a symbolic link at the specified path that points to an item at the given path.
+     This method does not traverse symbolic links contained in destURL, making it possible 
+     to create symbolic links to locations that do not yet exist. 
+     Also, if the final path component in url is a symbolic link, that link is not followed.
+    
+     - Parameters:
+       - path: The file path at which to create the new symbolic link. The last component of the path issued as the name of the link.
+       - destPath: The path that contains the item to be pointed to by the link. In other words, this is the destination of the link.
+       - completionHandler: If an error parameter was provided, a presentable `Error` will be returned.
+    */
+    public func create(symbolicLink path: String, withDestinationPath destPath: String, completionHandler: SimpleCompletionHandler) {
+        operation_queue.addOperation {
+            do {
+                try self.opFileManager.createSymbolicLink(at: self.url(of: path), withDestinationURL: self.url(of: destPath))
+                completionHandler?(nil)
+                DispatchQueue.main.async {
+                    self.delegate?.fileproviderSucceed(self, operation: .link(link: path, target: destPath))
+                }
+            } catch let e {
+                completionHandler?(e)
+                DispatchQueue.main.async {
+                    self.delegate?.fileproviderFailed(self, operation: .link(link: path, target: destPath))
+                }
+            }
+        }
+    }
+    
+    /// Returns the path of the item pointed to by a symbolic link.
+    ///
+    /// - Parameters:
+    ///   - path: The path of a file or directory.
+    ///   - completionHandler: Returns destination url of given symbolic link, or an `Error` object if it fails.
+    public func destination(ofSymbolicLink path: String, completionHandler: @escaping (_ url: URL?, _ error: Error?) -> Void) {
+        dispatch_queue.async {
+            do {
+                let destPath = try self.opFileManager.destinationOfSymbolicLink(atPath: self.url(of: path).path)
+                let destUrl = URL(fileURLWithPath: destPath)
+                completionHandler(destUrl, nil)
+            } catch let e{
+                completionHandler(nil, e)
+            }
+        }
+    }
+}
+
+internal extension LocalFileProvider {
+    func coordinated(intents: [NSFileAccessIntent], completionHandler: @escaping (_ url: URL) -> Void, errorHandler: ((_ error: Error) -> Void)? = nil) {
+        let coordinator = NSFileCoordinator(filePresenter: nil)
+        coordinator.coordinate(with: intents, queue: operation_queue) { (error) in
+            if let error = error {
+                errorHandler?(error)
+                return
+            }
+            completionHandler(intents[0].url)
+        }
+    }
+    
+    func coordinated(intents: [NSFileAccessIntent], moving: Bool = false, completionHandler: @escaping (_ sourceUrl: URL, _ destURL: URL?) -> Void, errorHandler:  ((_ error: Error) -> Void)? = nil) {
+        let coordinator = NSFileCoordinator(filePresenter: nil)
+        coordinator.coordinate(with: intents, queue: operation_queue) { (error) in
+            if let error = error {
+                errorHandler?(error)
+                return
+            }
+            let newSource: URL = intents[0].url
+            let newDest: URL? = intents.count > 1 ? intents[1].url : nil
+            if moving, let newDest = newDest {
+                coordinator.item(at: newSource, willMoveTo: newDest)
+            }
+            completionHandler(newSource, newDest)
+            if moving, let newDest = newDest {
+                coordinator.item(at: newSource, didMoveTo: newDest)
+            }
+        }
+    }
+}

Sources/LocalHelper.swift

@@ -0,0 +1,342 @@
+//
+//  LocalFileProvider.swift
+//  FileProvider
+//
+//  Created by Amir Abbas Mousavian.
+//  Copyright © 2016 Mousavian. Distributed under MIT license.
+//
+
+import Foundation
+
+/// Containts path, url and attributes of a local file or resource.
+public final class LocalFileObject: FileObject {
+    internal override init(url: URL, name: String, path: String) {
+        super.init(url: url, name: name, path: path)
+    }
+    
+    /// Initiates a `LocalFileObject` with attributes of file in path.
+    public convenience init? (fileWithPath path: String, relativeTo relativeURL: URL?) {
+        var fileURL: URL?
+        var rpath = path.replacingOccurrences(of: relativeURL?.path ?? "", with: "", options: .anchored)
+        if relativeURL != nil && rpath.hasPrefix("/") {
+            rpath.remove(at: rpath.startIndex)
+        }
+        if rpath.isEmpty {
+            fileURL = relativeURL
+        } else {
+            if #available(iOS 9.0, macOS 10.11, tvOS 9.0, *) {
+                fileURL = URL(fileURLWithPath: rpath, relativeTo: relativeURL)
+            } else {
+                fileURL = URL(string: rpath, relativeTo: relativeURL)
+            }
+        }
+        if let fileURL = fileURL {
+            self.init(fileWithURL: fileURL)
+        } else {
+            return nil
+        }
+    }
+    
+    /// Initiates a `LocalFileObject` with attributes of file in url.
+    public convenience init?(fileWithURL fileURL: URL) {
+        do {
+            let values = try fileURL.resourceValues(forKeys: [.nameKey, .fileSizeKey, .fileAllocatedSizeKey, .creationDateKey, .contentModificationDateKey, .fileResourceTypeKey, .isHiddenKey, .isWritableKey, .typeIdentifierKey, .generationIdentifierKey, .documentIdentifierKey])
+            let path = fileURL.relativePath.hasPrefix("/") ? fileURL.relativePath : "/" + fileURL.relativePath
+            
+            self.init(url: fileURL, name: values.name ?? fileURL.lastPathComponent, path: path)
+            for (key, value) in values.allValues {
+                self.allValues[key] = value
+            }
+        } catch {
+            return nil
+        }
+    }
+    
+    /// The total size allocated on disk for the file
+    open internal(set) var allocatedSize: Int64 {
+        get {
+            return allValues[.fileAllocatedSizeKey] as? Int64 ?? 0
+        }
+        set {
+            allValues[.fileAllocatedSizeKey] = Int(exactly: newValue) ?? Int.max
+        }
+    }
+    
+    /// The document identifier is a value assigned by the kernel/system to a file or directory. 
+    /// This value is used to identify the document regardless of where it is moved on a volume. 
+    /// The identifier persists across system restarts.
+    open internal(set) var id: Int? {
+        get {
+            return allValues[.documentIdentifierKey] as? Int
+        }
+        set {
+            allValues[.documentIdentifierKey] = newValue
+        }
+    }
+    
+    /// The revision of file, which changes when a file contents are modified. 
+    /// Changes to attributes or other file metadata do not change the identifier.
+    open var rev: String? {
+        get {
+            let data = allValues[.generationIdentifierKey] as? Data
+            return data?.map { String(format: "%02hhx", $0) }.joined()
+        }
+    }
+}
+
+internal final class LocalFolderMonitor {
+    fileprivate let source: DispatchSourceFileSystemObject
+    fileprivate let descriptor: CInt
+    fileprivate let qq: DispatchQueue = DispatchQueue.global(qos: .default)
+    fileprivate var state: Bool = false
+    fileprivate var monitoredTime: TimeInterval = Date().timeIntervalSinceReferenceDate
+    var url: URL
+    
+    /// Creates a folder monitor object with monitoring enabled.
+    init(url: URL, handler: @escaping ()->Void) {
+        self.url = url
+        descriptor = open((url as NSURL).fileSystemRepresentation, O_EVTONLY)
+        source = DispatchSource.makeFileSystemObjectSource(fileDescriptor: descriptor, eventMask: DispatchSource.FileSystemEvent.write, queue: qq)
+        // Folder monitoring is recursive and deep. Monitoring a root folder may be very costly
+        // We have a 0.2 second delay to ensure we wont call handler 1000s times when there is
+        // a huge file operation. This ensures app will work smoothly while this 250 milisec won't
+        // affect user experince much
+        let main_handler: ()->Void = {
+            if Date().timeIntervalSinceReferenceDate < self.monitoredTime + 0.2 {
+                return
+            }
+            self.monitoredTime = Date().timeIntervalSinceReferenceDate
+            DispatchQueue.main.asyncAfter(deadline: DispatchTime.now() + 0.25, execute: {
+                handler()
+            })
+        }
+        source.setEventHandler(handler: main_handler)
+        source.setCancelHandler {
+            close(self.descriptor)
+        }
+        start()
+    }
+    
+    /// Starts sending notifications if currently stopped
+    func start() {
+        if !state {
+            state = true
+            source.resume()
+        }
+    }
+    
+    /// Stops sending notifications if currently enabled
+    func stop() {
+        if state {
+            state = false
+            source.suspend()
+        }
+    }
+    
+    deinit {
+        source.cancel()
+    }
+}
+
+internal class LocalFileProviderManagerDelegate: NSObject, FileManagerDelegate {
+    weak var provider: LocalFileProvider?
+    
+    init(provider: LocalFileProvider) {
+        self.provider = provider
+    }
+    
+    func fileManager(_ fileManager: FileManager, shouldCopyItemAt srcURL: URL, to dstURL: URL) -> Bool {
+        guard let provider = self.provider, let delegate = provider.fileOperationDelegate else {
+            return true
+        }
+        let srcPath = provider.relativePathOf(url: srcURL)
+        let dstPath = provider.relativePathOf(url: dstURL)
+        return delegate.fileProvider(provider, shouldDoOperation: .copy(source: srcPath, destination: dstPath))
+    }
+    
+    func fileManager(_ fileManager: FileManager, shouldMoveItemAt srcURL: URL, to dstURL: URL) -> Bool {
+        guard let provider = self.provider, let delegate = provider.fileOperationDelegate else {
+            return true
+        }
+        let srcPath = provider.relativePathOf(url: srcURL)
+        let dstPath = provider.relativePathOf(url: dstURL)
+        return delegate.fileProvider(provider, shouldDoOperation: .move(source: srcPath, destination: dstPath))
+    }
+    
+    func fileManager(_ fileManager: FileManager, shouldRemoveItemAt URL: URL) -> Bool {
+        guard let provider = self.provider, let delegate = provider.fileOperationDelegate else {
+            return true
+        }
+        let path = provider.relativePathOf(url: URL)
+        return delegate.fileProvider(provider, shouldDoOperation: .remove(path: path))
+    }
+    
+    func fileManager(_ fileManager: FileManager, shouldLinkItemAt srcURL: URL, to dstURL: URL) -> Bool {
+        guard let provider = self.provider, let delegate = provider.fileOperationDelegate else {
+            return true
+        }
+        let srcPath = provider.relativePathOf(url: srcURL)
+        let dstPath = provider.relativePathOf(url: dstURL)
+        return delegate.fileProvider(provider, shouldDoOperation: .link(link: srcPath, target: dstPath))
+    }
+    
+    func fileManager(_ fileManager: FileManager, shouldProceedAfterError error: Error, copyingItemAt srcURL: URL, to dstURL: URL) -> Bool {
+        guard let provider = self.provider, let delegate = provider.fileOperationDelegate else {
+            return false
+        }
+        let srcPath = provider.relativePathOf(url: srcURL)
+        let dstPath = provider.relativePathOf(url: dstURL)
+        return delegate.fileProvider(provider, shouldProceedAfterError: error, operation: .copy(source: srcPath, destination: dstPath))
+    }
+    
+    func fileManager(_ fileManager: FileManager, shouldProceedAfterError error: Error, movingItemAt srcURL: URL, to dstURL: URL) -> Bool {
+        guard let provider = self.provider, let delegate = provider.fileOperationDelegate else {
+            return false
+        }
+        let srcPath = provider.relativePathOf(url: srcURL)
+        let dstPath = provider.relativePathOf(url: dstURL)
+        return delegate.fileProvider(provider, shouldProceedAfterError: error, operation: .move(source: srcPath, destination: dstPath))
+    }
+    
+    func fileManager(_ fileManager: FileManager, shouldProceedAfterError error: Error, removingItemAt URL: URL) -> Bool {
+        guard let provider = self.provider, let delegate = provider.fileOperationDelegate else {
+            return false
+        }
+        let path = provider.relativePathOf(url: URL)
+        return delegate.fileProvider(provider, shouldProceedAfterError: error, operation: .remove(path: path))
+    }
+    
+    func fileManager(_ fileManager: FileManager, shouldProceedAfterError error: Error, linkingItemAt srcURL: URL, to dstURL: URL) -> Bool {
+        guard let provider = self.provider, let delegate = provider.fileOperationDelegate else {
+            return false
+        }
+        let srcPath = provider.relativePathOf(url: srcURL)
+        let dstPath = provider.relativePathOf(url: dstURL)
+        return delegate.fileProvider(provider, shouldProceedAfterError: error, operation: .link(link: srcPath, target: dstPath))
+    }
+}
+
+/// Local operation handling is limited. Please don't use as much as possible.
+open class LocalOperationHandle: OperationHandle {
+    public let baseURL: URL
+    public let operationType: FileOperationType
+    
+    init (operationType: FileOperationType, baseURL: URL?) {
+        self.baseURL = baseURL ?? URL(fileURLWithPath: "/")
+        self.operationType = operationType
+    }
+    
+    private var sourceURL: URL? {
+        guard let source = operationType.source else { return nil }
+        return source.hasPrefix("file://") ? URL(fileURLWithPath: source) : baseURL.appendingPathComponent(source)
+    }
+    
+    private var destURL: URL? {
+        guard let dest = operationType.destination else { return nil }
+        return dest.hasPrefix("file://") ? URL(fileURLWithPath: dest) : baseURL.appendingPathComponent(dest)
+    }
+    
+    /// Caution: may put pressure on CPU, may have latency
+    open var bytesSoFar: Int64 {
+        assert(!Thread.isMainThread, "Don't run \(#function) method on main thread")
+        switch operationType {
+        case .modify:
+            guard let url = sourceURL, url.isFileURL else { return 0 }
+            if url.fileIsDirectory {
+                return iterateDirectory(url, deep: true).totalsize
+            } else {
+                return url.fileSize
+            }
+        case .copy, .move:
+            guard let url = destURL, url.isFileURL else { return 0 }
+            if url.fileIsDirectory {
+                return iterateDirectory(url, deep: true).totalsize
+            } else {
+                return url.fileSize
+            }
+        default:
+            return 0
+        }
+        
+    }
+    
+    /// Caution: may put pressure on CPU, may have latency
+    open var totalBytes: Int64 {
+        assert(!Thread.isMainThread, "Don't run \(#function) method on main thread")
+        switch operationType {
+        case .copy, .move:
+            guard let url = sourceURL, url.isFileURL else { return 0 }
+            if url.fileIsDirectory {
+                return iterateDirectory(url, deep: true).totalsize
+            } else {
+                return url.fileSize
+            }
+        default:
+            return 0
+        }
+    }
+    
+    /// Not usable in local provider
+    open var inProgress: Bool {
+        return false
+    }
+    
+    /// Not usable in local provider
+    open func cancel() -> Bool{
+        return false
+    }
+    
+    func iterateDirectory(_ pathURL: URL, deep: Bool) -> (folders: Int, files: Int, totalsize: Int64) {
+        var folders = 0
+        var files = 0
+        var totalsize: Int64 = 0
+        let keys: [URLResourceKey] = [.isDirectoryKey, .fileSizeKey]
+        let enumOpt: FileManager.DirectoryEnumerationOptions = !deep ? [.skipsSubdirectoryDescendants, .skipsPackageDescendants] : []
+        
+        let fp = FileManager()
+        let filesList = fp.enumerator(at: pathURL, includingPropertiesForKeys: keys, options: enumOpt, errorHandler: nil)
+        while let fileURL = filesList?.nextObject() as? URL {
+            do {
+                let values = try fileURL.resourceValues(forKeys: [.isDirectoryKey, .fileSizeKey])
+                let isdir = values.isDirectory ?? false
+                let size = Int64(values.fileSize ?? 0)
+                if isdir {
+                    folders += 1
+                } else {
+                    files += 1
+                }
+                totalsize += size
+            } catch _ {
+            }
+        }
+        
+        return (folders, files, totalsize)
+        
+    }
+}
+
+class UndoBox: NSObject {
+    weak var provider: FileProvideUndoable?
+    let operation: FileOperationType
+    let undoOperation: FileOperationType
+    
+    init(provider: FileProvideUndoable, operation: FileOperationType, undoOperation: FileOperationType) {
+        self.provider = provider
+        self.operation = operation
+        self.undoOperation = undoOperation
+    }
+}
+
+internal extension URL {
+    var fileIsDirectory: Bool {
+        return (try? self.resourceValues(forKeys: [.isDirectoryKey]))?.isDirectory ?? false
+    }
+    
+    var fileSize: Int64 {
+        return Int64((try? self.resourceValues(forKeys: [.fileSizeKey]))?.fileSize ?? -1)
+    }
+    
+    var fileExists: Bool {
+        return self.isFileURL && FileManager.default.fileExists(atPath: self.path)
+    }
+}

Sources/OneDriveFileProvide.swift

@@ -0,0 +1,443 @@
+
+//
+//  OneDriveFileProvider.swift
+//  FileProvider
+//
+//  Created by Amir Abbas Mousavian.
+//  Copyright © 2017 Mousavian. Distributed under MIT license.
+//
+
+import Foundation
+import CoreGraphics
+
+/**
+ Allows accessing to OneDrive stored files, either hosted on Microsoft servers or business coprporate one.
+ This provider doesn't cache or save files internally, however you can set `useCache` and `cache` properties
+ to use Foundation `NSURLCache` system.
+ 
+ - Note: Uploading files and data are limited to 100MB, for now.
+ */
+open class OneDriveFileProvider: FileProviderBasicRemote {
+    open class var type: String { return "OneDrive" }
+    open let isPathRelative: Bool
+    open let baseURL: URL?
+    /// OneDrive server url, equals with unwrapped `baseURL`
+    open var serverURL: URL { return baseURL! }
+    /// Drive name for user, default is `root`. Changing its value will effect on new operations.
+    open var drive: String
+    /// Generated storage url from server url and drive name
+    open var driveURL: URL {
+        return URL(string: "/drive/\(drive):/", relativeTo: baseURL)!
+    }
+    open var currentPath: String
+    
+    open var dispatch_queue: DispatchQueue
+    open var operation_queue: OperationQueue {
+        willSet {
+            assert(_session == nil, "It's not effective to change dispatch_queue property after session is initialized.")
+        }
+    }
+    
+    open weak var delegate: FileProviderDelegate?
+    open let credential: URLCredential?
+    open private(set) var cache: URLCache?
+    public var useCache: Bool
+    public var validatingCache: Bool
+   
+    fileprivate var _session: URLSession?
+    fileprivate var sessionDelegate: SessionDelegate?
+    public var session: URLSession {
+        if _session == nil {
+            self.sessionDelegate = SessionDelegate(fileProvider: self, credential: credential)
+            let queue = OperationQueue()
+            //queue.underlyingQueue = dispatch_queue
+            let config = URLSessionConfiguration.default
+            config.urlCache = cache
+            config.requestCachePolicy = .returnCacheDataElseLoad
+            _session = URLSession(configuration: config, delegate: sessionDelegate as URLSessionDelegate?, delegateQueue: queue)
+        }
+        return _session!
+    }
+    
+    /**
+     Initializer for Onedrive provider with given client ID and Token.
+     These parameters must be retrieved via [Authentication for the OneDrive API](https://dev.onedrive.com/auth/readme.htm).
+     
+     There are libraries like [p2/OAuth2](https://github.com/p2/OAuth2) or [OAuthSwift](https://github.com/OAuthSwift/OAuthSwift) which can facilate the procedure to retrieve token.
+     The latter is easier to use and prefered. Also you can use [auth0/Lock](https://github.com/auth0/Lock.iOS-OSX) which provides graphical user interface.
+     
+     - Parameters:
+       - credential: a `URLCredential` object with Client ID set as `user` and Token set as `password`.
+       - serverURL: server url, Set it if you are trying to connect OneDrive Business server, otherwise leave it
+         `nil` to connect to OneDrive Personal uses.
+       - drive: drive name for user on server, default value is `root`.
+       - cache: A URLCache to cache downloaded files and contents.
+     */
+    public init(credential: URLCredential?, serverURL: URL? = nil, drive: String = "root", cache: URLCache? = nil) {
+        let baseURL = serverURL ?? URL(string: "https://api.onedrive.com/")!
+        self.baseURL = baseURL.path.hasSuffix("/") ? baseURL : baseURL.appendingPathComponent("")
+        self.drive = drive
+        self.isPathRelative = true
+        self.currentPath = ""
+        self.useCache = false
+        self.validatingCache = true
+        self.cache = cache
+        self.credential = credential
+        dispatch_queue = DispatchQueue(label: "FileProvider.\(type(of: self).type)", attributes: .concurrent)
+        operation_queue = OperationQueue()
+        operation_queue.name = "FileProvider.\(type(of: self).type).Operation"
+    }
+    
+    deinit {
+        if fileProviderCancelTasksOnInvalidating {
+            _session?.invalidateAndCancel()
+        } else {
+            _session?.finishTasksAndInvalidate()
+        }
+    }
+    
+    open func contentsOfDirectory(path: String, completionHandler: @escaping ((_ contents: [FileObject], _ error: Error?) -> Void)) {
+        list(path) { (contents, cursor, error) in
+            completionHandler(contents, error)
+        }
+    }
+    
+    open func attributesOfItem(path: String, completionHandler: @escaping ((_ attributes: FileObject?, _ error: Error?) -> Void)) {
+        let url = URL(string: escaped(path: path), relativeTo: driveURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "GET"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var serverError: FileProviderOneDriveError?
+            var fileObject: OneDriveFileObject?
+            if let response = response as? HTTPURLResponse {
+                let code = FileProviderHTTPErrorCode(rawValue: response.statusCode)
+                serverError = code != nil ? FileProviderOneDriveError(code: code!, path: path, errorDescription: String(data: data ?? Data(), encoding: .utf8)) : nil
+                if let data = data, let jsonStr = String(data: data, encoding: .utf8), let json = jsonToDictionary(jsonStr), let file = OneDriveFileObject(baseURL: self.baseURL, drive: self.drive, json: json) {
+                    fileObject = file
+                }
+            }
+            completionHandler(fileObject, serverError ?? error)
+        }) 
+        task.resume()
+    }
+    
+    open func storageProperties(completionHandler: @escaping ((_ total: Int64, _ used: Int64) -> Void)) {
+        let url = URL(string: "/drive/root", relativeTo: baseURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "GET"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var totalSize: Int64 = -1
+            var usedSize: Int64 = 0
+            if let data = data, let jsonStr = String(data: data, encoding: .utf8), let json = jsonToDictionary(jsonStr) {
+                totalSize = (json["total"] as? NSNumber)?.int64Value ?? -1
+                usedSize = (json["used"] as? NSNumber)?.int64Value ?? 0
+            }
+            completionHandler(totalSize, usedSize)
+        }) 
+        task.resume()
+    }
+    
+    open func searchFiles(path: String, recursive: Bool, query: NSPredicate, foundItemHandler: ((FileObject) -> Void)?, completionHandler: @escaping ((_ files: [FileObject], _ error: Error?) -> Void)) {
+        var foundFiles = [OneDriveFileObject]()
+        var queryStr: String?
+        queryStr = self.findNameQuery(query, key: "name") as? String ?? self.findNameQuery(query, key: nil) as? String
+        guard let finalQueryStr = queryStr else { return }
+        search(path, query: finalQueryStr, foundItem: { (file) in
+            if query.evaluate(with: file.mapPredicate()) {
+                foundFiles.append(file)
+                foundItemHandler?(file)
+            }
+        }, completionHandler: { (error) in
+            completionHandler(foundFiles, error)
+        })
+    }
+    
+    open func isReachable(completionHandler: @escaping (Bool) -> Void) {
+        let url = URL(string: "/drive/root", relativeTo: baseURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "HEAD"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            let status = (response as? HTTPURLResponse)?.statusCode ?? 400
+            completionHandler(status == 200)
+        })
+        task.resume()
+    }
+    
+    open weak var fileOperationDelegate: FileOperationDelegate?
+}
+
+extension OneDriveFileProvider: FileProviderOperations {
+    
+    
+    open func create(folder folderName: String, at atPath: String, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let path = (atPath as NSString).appendingPathComponent(folderName) + "/"
+        return doOperation(.create(path: path), completionHandler: completionHandler)
+    }
+    
+    open func create(file fileName: String, at path: String, contents data: Data?, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let filePath = (path as NSString).appendingPathComponent(fileName)
+        return self.writeContents(path: filePath, contents: data ?? Data(), completionHandler: completionHandler)
+    }
+    
+    open func moveItem(path: String, to toPath: String, overwrite: Bool, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        return doOperation(.move(source: path, destination: toPath), completionHandler: completionHandler)
+    }
+    
+    open func copyItem(path: String, to toPath: String, overwrite: Bool, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        return doOperation(.copy(source: path, destination: toPath), completionHandler: completionHandler)
+    }
+    
+    open func removeItem(path: String, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        return doOperation(.remove(path: path), completionHandler: completionHandler)
+    }
+    
+    fileprivate func doOperation(_ operation: FileOperationType, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        guard fileOperationDelegate?.fileProvider(self, shouldDoOperation: operation) ?? true == true else {
+            return nil
+        }
+        guard let sourcePath = operation.source else { return nil }
+        let destPath = operation.destination
+        var request = URLRequest(url: URL(string: sourcePath, relativeTo: driveURL)!)
+        switch operation {
+        case .create:
+            request.httpMethod = "CREATE"
+        case .copy:
+            request.httpMethod = "POST"
+        case .move:
+            request.httpMethod = "PATCH"
+        case .remove:
+            request.httpMethod = "DELETE"
+        default: // modify, link, fetch
+            return nil
+        }
+        
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        var requestDictionary = [String: AnyObject]()
+        if let dest = correctPath(destPath) as NSString? {
+            request.setValue("application/json", forHTTPHeaderField: "Content-Type")
+            requestDictionary["parentReference"] = ("/drive/\(drive):" + dest.deletingLastPathComponent) as NSString
+            requestDictionary["name"] = dest.lastPathComponent as NSString
+            request.httpBody = dictionaryToJSON(requestDictionary)?.data(using: .utf8)
+        }
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var serverError: FileProviderOneDriveError?
+            if let response = response as? HTTPURLResponse, response.statusCode >= 300, let code = FileProviderHTTPErrorCode(rawValue: response.statusCode) {
+                 serverError = FileProviderOneDriveError(code: code, path: sourcePath, errorDescription: String(data: data ?? Data(), encoding: .utf8))
+            }
+            completionHandler?(serverError ?? error)
+            self.delegateNotify(operation, error: serverError ?? error)
+        })
+        task.taskDescription = operation.json
+        task.resume()
+        return RemoteOperationHandle(operationType: operation, tasks: [task])
+    }
+    
+    open func copyItem(localFile: URL, to toPath: String, overwrite: Bool, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.copy(source: localFile.absoluteString, destination: toPath)
+        guard fileOperationDelegate?.fileProvider(self, shouldDoOperation: opType) ?? true == true else {
+            return nil
+        }
+        return upload_simple(toPath, localFile: localFile, overwrite: overwrite, operation: opType, completionHandler: completionHandler)
+    }
+    
+    open func copyItem(path: String, toLocalURL destURL: URL, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.copy(source: path, destination: destURL.absoluteString)
+        guard fileOperationDelegate?.fileProvider(self, shouldDoOperation: opType) ?? true == true else {
+            return nil
+        }
+        let url = URL(string: escaped(path: path) + ":/content", relativeTo: driveURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "GET"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        let task = session.downloadTask(with: request, completionHandler: { (cacheURL, response, error) in
+            guard let cacheURL = cacheURL, let httpResponse = response as? HTTPURLResponse , httpResponse.statusCode < 300 else {
+                let code = FileProviderHTTPErrorCode(rawValue: (response as? HTTPURLResponse)?.statusCode ?? -1)
+                let errorData : Data? = nil //Data(contentsOf:cacheURL) // TODO: Figure out how to get error response data for the error description
+                let serverError : FileProviderOneDriveError? = code != nil ? FileProviderOneDriveError(code: code!, path: path, errorDescription: String(data: errorData ?? Data(), encoding: .utf8)) : nil
+                completionHandler?(serverError ?? error)
+                return
+            }
+            do {
+                try FileManager.default.moveItem(at: cacheURL, to: destURL)
+                completionHandler?(nil)
+            } catch let e {
+                completionHandler?(e)
+            }
+        })
+        task.taskDescription = opType.json
+        task.resume()
+        return RemoteOperationHandle(operationType: opType, tasks: [task])
+    }
+}
+
+extension OneDriveFileProvider: FileProviderReadWrite {
+    open func contents(path: String, offset: Int64, length: Int, completionHandler: @escaping ((_ contents: Data?, _ error: Error?) -> Void)) -> OperationHandle? {
+        if length == 0 || offset < 0 {
+            dispatch_queue.async {
+                completionHandler(Data(), nil)
+            }
+            return nil
+        }
+        
+        let opType = FileOperationType.fetch(path: path)
+        let url =  URL(string: escaped(path: path) + ":/content", relativeTo: driveURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "GET"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        if length > 0 {
+            request.setValue("bytes=\(offset)-\(offset + length - 1)", forHTTPHeaderField: "Range")
+        } else if offset > 0 && length < 0 {
+            request.setValue("bytes=\(offset)-", forHTTPHeaderField: "Range")
+        }
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var serverError: FileProviderOneDriveError?
+            if let httpResponse = response as? HTTPURLResponse , httpResponse.statusCode >= 300, let code = FileProviderHTTPErrorCode(rawValue: httpResponse.statusCode) {
+                serverError = FileProviderOneDriveError(code: code, path: path, errorDescription: String(data: data ?? Data(), encoding: .utf8))
+            }
+            let filedata = serverError ?? error == nil ? data : nil
+            completionHandler(filedata, serverError ?? error)
+        })
+        task.taskDescription = opType.json
+        task.resume()
+        return RemoteOperationHandle(operationType: opType, tasks: [task])
+    }
+    
+    open func writeContents(path: String, contents data: Data, atomically: Bool, overwrite: Bool, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.modify(path: path)
+        guard fileOperationDelegate?.fileProvider(self, shouldDoOperation: opType) ?? true == true else {
+            return nil
+        }
+        // FIXME: remove 150MB restriction
+        return upload_simple(path, data: data, overwrite: overwrite, operation: opType, completionHandler: completionHandler)
+    }
+    
+    fileprivate func registerNotifcation(path: String, eventHandler: (() -> Void)) {
+        /* There is two ways to monitor folders changing in OneDrive. Either using webooks
+         * which means you have to implement a server to translate it to push notifications
+         * or using apiv2 list_folder/longpoll method. The second one is implemeted here.
+         * Tough webhooks are much more efficient, longpoll is much simpler to implement!
+         * You can implemnt your own webhook service and replace this method accordingly.
+         */
+        NotImplemented()
+    }
+    fileprivate func unregisterNotifcation(path: String) {
+        NotImplemented()
+    }
+    
+    /**
+     Genrates a public url to a file to be shared with other users and can be downloaded without authentication.
+     
+     - Parameters:
+       - to: path of file, including file/directory name.
+       - completionHandler: a closure with result of directory entries or error.
+         `link`: a url returned by OneDrive to share.
+         `attribute`: `nil` for OneDrive.
+         `expiration`: `nil` for OneDrive, as it doesn't expires.
+         `error`: Error returned by OneDrive.
+     */
+    open func publicLink(to path: String, completionHandler: @escaping ((_ link: URL?, _ attribute: OneDriveFileObject?, _ expiration: Date?, _ error: Error?) -> Void)) {
+        let url =  URL(string: escaped(path: path) + ":/action.createLink", relativeTo: driveURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "POST"
+        let requestDictionary: [String: AnyObject] = ["type": "view" as NSString]
+        request.httpBody = dictionaryToJSON(requestDictionary)?.data(using: .utf8)
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var serverError: FileProviderOneDriveError?
+            var link: URL?
+            if let response = response as? HTTPURLResponse {
+                let code = FileProviderHTTPErrorCode(rawValue: response.statusCode)
+                serverError = code != nil ? FileProviderOneDriveError(code: code!, path: path, errorDescription: String(data: data ?? Data(), encoding: .utf8)) : nil
+                if let data = data, let jsonStr = String(data: data, encoding: .utf8), let json = jsonToDictionary(jsonStr) {
+                    if let linkDic = json["link"] as? NSDictionary, let linkStr = linkDic["webUrl"] as? String {
+                        link = URL(string: linkStr)
+                    }
+                }
+            }
+            
+            completionHandler(link, nil, nil, serverError ?? error)
+        })
+        task.resume()
+    }
+}
+
+
+extension OneDriveFileProvider: ExtendedFileProvider {
+    open func thumbnailOfFileSupported(path: String) -> Bool {
+        return true
+    }
+    
+    open func propertiesOfFileSupported(path: String) -> Bool {
+        let fileExt = (path as NSString).pathExtension.lowercased()
+        switch fileExt {
+        case "jpg", "jpeg", "bmp", "gif", "png", "tif", "tiff":
+            return true
+        case "mp3", "aac", "m4a", "wma":
+            return true
+        case "mp4", "mpg", "3gp", "mov", "avi", "wmv":
+            return true
+        default:
+            return false
+        }
+    }
+    
+    open func thumbnailOfFile(path: String, dimension: CGSize?, completionHandler: @escaping ((_ image: ImageClass?, _ error: Error?) -> Void)) {
+        let url: URL
+        if let dimension = dimension {
+            url = URL(string: escaped(path: path) + ":/thumbnails/0/=c\(dimension.width)x\(dimension.height)/content", relativeTo: driveURL)!
+        } else {
+            url = URL(string: escaped(path: path) + ":/thumbnails/0/small/content", relativeTo: driveURL)!
+        }
+        
+        var request = URLRequest(url: url)
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        let task = self.session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var image: ImageClass? = nil
+            if let code = (response as? HTTPURLResponse)?.statusCode , code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                let responseError = FileProviderOneDriveError(code: rCode, path: path, errorDescription: String(data: data ?? Data(), encoding: .utf8))
+                completionHandler(nil, responseError)
+                return
+            }
+            if let data = data {
+                image = ImageClass(data: data)
+            }
+            completionHandler(image, error)
+        })
+        task.resume()
+    }
+    
+    open func propertiesOfFile(path: String, completionHandler: @escaping ((_ propertiesDictionary: [String : Any], _ keys: [String], _ error: Error?) -> Void)) {
+        let url = URL(string: escaped(path: path), relativeTo: driveURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "GET"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var serverError: FileProviderOneDriveError?
+            var dic = [String: Any]()
+            var keys = [String]()
+            if let response = response as? HTTPURLResponse {
+                let code = FileProviderHTTPErrorCode(rawValue: response.statusCode)
+                serverError = code != nil ? FileProviderOneDriveError(code: code!, path: path, errorDescription: String(data: data ?? Data(), encoding: .utf8)) : nil
+                if let data = data, let jsonStr = String(data: data, encoding: .utf8), let json = jsonToDictionary(jsonStr) {
+                    (dic, keys) = self.mapMediaInfo(json)
+                }
+            }
+            completionHandler(dic, keys, serverError ?? error)
+        })
+        task.resume()
+    }
+}
+
+extension OneDriveFileProvider: FileProvider {
+    open func copy(with zone: NSZone? = nil) -> Any {
+        let copy = OneDriveFileProvider(credential: self.credential, serverURL: self.baseURL, drive: self.drive, cache: self.cache)
+        copy.currentPath = self.currentPath
+        copy.delegate = self.delegate
+        copy.fileOperationDelegate = self.fileOperationDelegate
+        copy.useCache = self.useCache
+        copy.validatingCache = self.validatingCache
+        return copy
+    }
+}

Sources/OneDriveHelper.swift

@@ -0,0 +1,299 @@
+//
+//  OneDriveHelper.swift
+//  FileProvider
+//
+//  Created by Amir Abbas Mousavian.
+//  Copyright © 2017 Mousavian. Distributed under MIT license.
+//
+
+import Foundation
+
+/// Error returned by OneDrive server when trying to access or do operations on a file or folder.
+public struct FileProviderOneDriveError: FileProviderHTTPError {
+    public let code: FileProviderHTTPErrorCode
+    public let path: String
+    public let errorDescription: String?
+}
+
+/// Containts path, url and attributes of a OneDrive file or resource.
+public final class OneDriveFileObject: FileObject {
+    internal init(baseURL: URL?, name: String, path: String) {
+        var rpath = path
+        if path.hasPrefix("/") {
+            rpath.remove(at: rpath.startIndex)
+        }
+        let url = URL(string: rpath, relativeTo: baseURL) ?? URL(string: path)!
+        super.init(url: url, name: name, path: path)
+    }
+    
+    internal convenience init? (baseURL: URL?, drive: String, jsonStr: String) {
+        guard let json = jsonToDictionary(jsonStr) else { return nil }
+        self.init(baseURL: baseURL, drive: drive, json: json)
+    }
+    
+    internal convenience init? (baseURL: URL?, drive: String, json: [String: AnyObject]) {
+        guard let name = json["name"] as? String else { return nil }
+        guard let path = (json["parentReference"] as? NSDictionary)?["path"] as? String else { return nil }
+        let lPath = path.replacingOccurrences(of: "/drive/\(drive):", with: "/", options: .anchored, range: nil)
+        self.init(baseURL: baseURL, name: name, path: lPath)
+        self.size = (json["size"] as? NSNumber)?.int64Value ?? -1
+        self.modifiedDate = resolve(dateString: json["lastModifiedDateTime"] as? String ?? "")
+        self.creationDate = resolve(dateString: json["createdDateTime"] as? String ?? "")
+        self.type = (json["folder"] as? String) != nil ? .directory : .regular
+        self.id = json["id"] as? String
+        self.entryTag = json["eTag"] as? String
+    }
+    
+    /// The document identifier is a value assigned by the OneDrive to a file.
+    /// This value is used to identify the document regardless of where it is moved on a volume.
+    /// The identifier persists across system restarts.
+    open internal(set) var id: String? {
+        get {
+            return allValues[.documentIdentifierKey] as? String
+        }
+        set {
+            allValues[.documentIdentifierKey] = newValue
+        }
+    }
+    
+    /// MIME type of file contents returned by OneDrive server.
+    open internal(set) var contentType: String {
+        get {
+            return allValues[.mimeType] as? String ?? ""
+        }
+        set {
+            allValues[.mimeType] = newValue
+        }
+    }
+    
+    /// HTTP E-Tag, can be used to mark changed files.
+    open internal(set) var entryTag: String? {
+        get {
+            return allValues[.entryTag] as? String
+        }
+        set {
+            allValues[.entryTag] = newValue
+        }
+    }
+}
+
+// codebeat:disable[ARITY]
+internal extension OneDriveFileProvider {
+    func list(_ path: String, cursor: String? = nil, prevContents: [OneDriveFileObject] = [], completionHandler: @escaping ((_ contents: [FileObject], _ cursor: String?, _ error: Error?) -> Void)) {
+        let url: URL
+        if let cursor = cursor {
+            url = URL(string: cursor)!
+        } else {
+            url = URL(string: escaped(path: path), relativeTo: driveURL)!
+        }
+        var request = URLRequest(url: url)
+        request.httpMethod = "GET"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var responseError: FileProviderOneDriveError?
+            var files = prevContents
+            if let code = (response as? HTTPURLResponse)?.statusCode , code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                responseError = FileProviderOneDriveError(code: rCode, path: path, errorDescription: String(data: data ?? Data(), encoding: .utf8))
+            }
+            if let data = data, let jsonStr = String(data: data, encoding: .utf8) {
+                let json = jsonToDictionary(jsonStr)
+                if let entries = json?["value"] as? [AnyObject] , entries.count > 0 {
+                    for entry in entries {
+                        if let entry = entry as? [String: AnyObject], let file = OneDriveFileObject(baseURL: self.baseURL, drive: self.drive, json: entry) {
+                            files.append(file)
+                        }
+                    }
+                    let ncursor = json?["@odata.nextLink"] as? String
+                    let hasmore = ncursor != nil
+                    if hasmore {
+                        self.list(path, cursor: ncursor, prevContents: files, completionHandler: completionHandler)
+                        return
+                    }
+                }
+            }
+            completionHandler(files, nil, responseError ?? error)
+        })
+        task.taskDescription = FileOperationType.fetch(path: path).json
+        task.resume()
+    }
+    
+    func upload_simple(_ targetPath: String, data: Data, modifiedDate: Date = Date(), overwrite: Bool, operation: FileOperationType, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        if data.count > 100 * 1024 * 1024 {
+            let error = FileProviderOneDriveError(code: .payloadTooLarge, path: targetPath, errorDescription: nil)
+            completionHandler?(error)
+            self.delegateNotify(.create(path: targetPath), error: error)
+            return nil
+        }
+        let queryStr = overwrite ? "" : "?@name.conflictBehavior=fail"
+        let url = URL(string: escaped(path: targetPath) + ":/content" + queryStr, relativeTo: driveURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "PUT"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        request.setValue("application/octet-stream", forHTTPHeaderField: "Content-Type")
+        request.httpBody = data
+        let task = session.uploadTask(with: request, from: data, completionHandler: { (data, response, error) in
+            var responseError: FileProviderOneDriveError?
+            if let code = (response as? HTTPURLResponse)?.statusCode , code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                responseError = FileProviderOneDriveError(code: rCode, path: targetPath, errorDescription: String(data: data ?? Data(), encoding: .utf8))
+            }
+            completionHandler?(responseError ?? error)
+            self.delegateNotify(.create(path: targetPath), error: responseError ?? error)
+        })
+        task.taskDescription = operation.json
+        task.resume()
+        return RemoteOperationHandle(operationType: operation, tasks: [task])
+    }
+    
+    func upload_simple(_ targetPath: String, localFile: URL, modifiedDate: Date = Date(), overwrite: Bool, operation: FileOperationType, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let size = (try? localFile.resourceValues(forKeys: [.fileSizeKey]))?.fileSize ?? -1
+        if size > 100 * 1024 * 1024 {
+            let error = FileProviderOneDriveError(code: .payloadTooLarge, path: targetPath, errorDescription: nil)
+            completionHandler?(error)
+            self.delegateNotify(.create(path: targetPath), error: error)
+            return nil
+        }
+        let queryStr = overwrite ? "" : "?@name.conflictBehavior=fail"
+        let url = URL(string: escaped(path: targetPath) + ":/content" + queryStr, relativeTo: driveURL)!
+        var request = URLRequest(url: url)
+        request.httpMethod = "PUT"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        request.setValue("application/octet-stream", forHTTPHeaderField: "Content-Type")
+        let task = session.uploadTask(with: request, fromFile: localFile, completionHandler: { (data, response, error) in
+            var responseError: FileProviderOneDriveError?
+            if let code = (response as? HTTPURLResponse)?.statusCode , code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                responseError = FileProviderOneDriveError(code: rCode, path: targetPath, errorDescription: String(data: data ?? Data(), encoding: .utf8))
+            }
+            completionHandler?(responseError ?? error)
+            self.delegateNotify(.create(path: targetPath), error: responseError ?? error)
+        })
+        task.taskDescription = operation.json
+        task.resume()
+        return RemoteOperationHandle(operationType: operation, tasks: [task])
+    }
+    
+    func search(_ startPath: String = "", query: String, next: String? = nil, foundItem:@escaping ((_ file: OneDriveFileObject) -> Void), completionHandler: @escaping ((_ error: Error?) -> Void)) {
+        let url: URL
+        if let next = next {
+            url = URL(string: next)!
+        } else if self.escaped(path: startPath) == "" {
+            url = URL(string: "/drive/\(drive)/view.search?q=\(query)", relativeTo: baseURL)!
+        } else {
+            url = URL(string: "\(escaped(path: startPath))/view.search?q=\(query)", relativeTo: driveURL)!
+        }
+        var request = URLRequest(url: url)
+        request.httpMethod = "GET"
+        request.setValue("Bearer \(credential?.password ?? "")", forHTTPHeaderField: "Authorization")
+        
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var responseError: FileProviderOneDriveError?
+            if let code = (response as? HTTPURLResponse)?.statusCode , code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                responseError = FileProviderOneDriveError(code: rCode, path: startPath, errorDescription: String(data: data ?? Data(), encoding: .utf8))
+            }
+            if let data = data, let jsonStr = String(data: data, encoding: .utf8) {
+                let json = jsonToDictionary(jsonStr)
+                if let entries = json?["value"] as? [AnyObject] , entries.count > 0 {
+                    for entry in entries {
+                        if let entry = entry as? [String: AnyObject], let file = OneDriveFileObject(baseURL: self.baseURL, drive: self.drive, json: entry) {
+                            foundItem(file)
+                        }
+                    }
+                    let next = json?["@odata.nextLink"] as? String
+                    let hasmore = next != nil
+                    if hasmore, let next = next {
+                        self.search(startPath, query: query, next: next, foundItem: foundItem, completionHandler: completionHandler)
+                    } else {
+                        completionHandler(responseError ?? error)
+                    }
+                    return
+                }
+            }
+            completionHandler(responseError ?? error)
+        }) 
+        task.resume()
+    }
+}
+// codebeat:enable[ARITY]
+
+internal extension OneDriveFileProvider {
+    static let dateFormatter = DateFormatter()
+    static let decimalFormatter = NumberFormatter()
+    
+    func mapMediaInfo(_ json: [String: Any]) -> (dictionary: [String: Any], keys: [String]) {
+        
+        func spaceCamelCase(_ text: String) -> String {
+            var newString: String = ""
+            
+            let upperCase = CharacterSet.uppercaseLetters
+            for scalar in text.unicodeScalars {
+                if upperCase.contains(scalar) {
+                    newString.append(" ")
+                }
+                let character = Character(scalar)
+                newString.append(character)
+            }
+            
+            return newString.capitalized
+        }
+        
+        var dic = [String: Any]()
+        var keys = [String]()
+        
+        func add(key: String, value: Any?) {
+            if let value = value {
+                keys.append(key)
+                dic[key] = value
+            }
+        }
+        
+        if let parent = json["image"] as? [String: Any] ?? json["video"] as? [String: Any], let height = parent["height"] as? UInt64, let width = parent["width"] as? UInt64 {
+            add(key: "Dimensions", value: "\(width)x\(height)")
+        }
+        if let location = json["location"] as? [String: Any], let latitude = location["latitude"] as? Double, let longitude = location["longitude"] as? Double {
+            OneDriveFileProvider.decimalFormatter.numberStyle = .decimal
+            OneDriveFileProvider.decimalFormatter.maximumFractionDigits = 5
+            let latStr = OneDriveFileProvider.decimalFormatter.string(from: NSNumber(value: latitude))
+            let longStr = OneDriveFileProvider.decimalFormatter.string(from: NSNumber(value: longitude))
+            add(key: "Location", value: "\(latStr), \(longStr)")
+        }
+        if let parent = json["image"] as? [String: Any] ?? json["video"] as? [String: Any], let duration = parent["duration"] as? UInt64 {
+            add(key: "Duration", value: OneDriveFileProvider.formatshort(interval: TimeInterval(duration) / 1000))
+        }
+        if let timeTakenStr = json["takenDateTime"] as? String, let timeTaken = resolve(dateString: timeTakenStr) {
+            OneDriveFileProvider.dateFormatter.dateFormat = "yyyy-MM-dd HH:mm:ss"
+            add(key: "Date taken", value:  OneDriveFileProvider.dateFormatter.string(from: timeTaken))
+        }
+        
+        if let photo = json["photo"] as? [String: Any] {
+            add(key: "Device make", value: photo["cameraMake"] as? String)
+            add(key: "Device model", value: photo["cameraModel"] as? String)
+            add(key: "focalLength", value: photo["focalLength"] as? Double)
+            add(key: "fNumber", value: photo["fNumber"] as? Double)
+            if let expNom = photo["exposureNumerator"] as? Double, let expDen = photo["exposureDenominator"] as? Double {
+                add(key: "Exposure time", value: "\(Int(expNom))/\(Int(expDen))")
+            }
+            add(key: "ISO speed", value: photo["iso"] as? Int64)
+        }
+        
+        if let audio = json["audio"] as? [String: Any] {
+            for (key, value) in audio {
+                if key == "bitrate" || key == "isVariableBitrate" { continue }
+                let casedKey = spaceCamelCase(key)
+                add(key: casedKey, value: value)
+            }
+        }
+        
+        add(key: "Bitrate", value: (json["video"] as? NSDictionary)?["bitrate"] as? Int)
+        
+        return (dic, keys)
+    }
+    
+    func delegateNotify(_ operation: FileOperationType, error: Error?) {
+        DispatchQueue.main.async(execute: {
+            if error == nil {
+                self.delegate?.fileproviderSucceed(self, operation: operation)
+            } else {
+                self.delegate?.fileproviderFailed(self, operation: operation)
+            }
+        })
+    }
+}

Sources/RemoteSession.swift

@@ -0,0 +1,313 @@
+//
+//  SessionDelegate.swift
+//  FileProvider
+//
+//  Created by Amir Abbas Mousavian.
+//  Copyright © 2016 Mousavian. Distributed under MIT license.
+//
+
+import Foundation
+
+/// Allows to get progress or cancel an in-progress operation, for remote, `URLSession` based providers.
+open class RemoteOperationHandle: OperationHandle {
+    
+    internal var tasks: [Weak<URLSessionTask>]
+    
+    open private(set) var operationType: FileOperationType
+    
+    init(operationType: FileOperationType, tasks: [URLSessionTask]) {
+        self.operationType = operationType
+        self.tasks = tasks.map { Weak<URLSessionTask>($0) }
+    }
+    
+    internal func add(task: URLSessionTask) {
+        tasks.append(Weak<URLSessionTask>(task))
+    }
+    
+    private func reape() {
+        self.tasks = tasks.filter { $0.value != nil }
+    }
+    
+    open var bytesSoFar: Int64 {
+        return tasks.reduce(0) {
+            if let task = $1.value as? URLSessionUploadTask {
+                return $0 + task.countOfBytesSent
+            } else {
+                return $0 + ($1.value?.countOfBytesReceived ?? 0)
+            }
+        }
+    }
+    
+    open var totalBytes: Int64 {
+        return tasks.reduce(0) {
+            if let task = $1.value as? URLSessionUploadTask {
+                return $0 + task.countOfBytesExpectedToSend
+            } else {
+                return $0 + ($1.value?.countOfBytesExpectedToReceive ?? 0)
+            }
+        }
+    }
+    
+    open func cancel() -> Bool {
+        var canceled = false
+        for taskbox in tasks {
+            taskbox.value?.cancel()
+            canceled = true
+        }
+        return canceled
+    }
+    
+    open var inProgress: Bool {
+        return tasks.reduce(false) { $0 || $1.value?.state ?? .canceling == .running }
+    }
+}
+
+/// A protocol defines properties for errors returned by HTTP/S based providers.
+/// Including Dropbox, OneDrive and WebDAV.
+public protocol FileProviderHTTPError: Error, CustomStringConvertible {
+    /// HTTP status code returned for error by server.
+    var code: FileProviderHTTPErrorCode { get }
+    /// Path of file/folder casued that error
+    var path: String { get }
+    /// Contents returned by server as error description
+    var errorDescription: String? { get }
+}
+
+extension FileProviderHTTPError {
+    public var description: String {
+        return code.description
+    }
+}
+
+class SessionDelegate: NSObject, URLSessionDataDelegate, URLSessionDownloadDelegate {
+    
+    weak var fileProvider: FileProvider?
+    var credential: URLCredential?
+    
+    var finishDownloadHandler: ((_ session: Foundation.URLSession, _ downloadTask: URLSessionDownloadTask, _ didFinishDownloadingToURL: URL) -> Void)?
+    var didSendDataHandler: ((_ session: Foundation.URLSession, _ task: URLSessionTask, _ bytesSent: Int64, _ totalBytesSent: Int64, _ totalBytesExpectedToSend: Int64) -> Void)?
+    var didReceivedData: ((_ session: Foundation.URLSession, _ downloadTask: URLSessionDownloadTask, _ bytesWritten: Int64, _ totalBytesWritten: Int64, _ totalBytesExpectedToWrite: Int64) -> Void)?
+    
+    init(fileProvider: FileProvider, credential: URLCredential?) {
+        self.fileProvider = fileProvider
+        self.credential = credential
+    }
+    
+    // codebeat:disable[ARITY]
+    func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didFinishDownloadingTo location: URL) {
+        self.finishDownloadHandler?(session, downloadTask, location)
+        return
+    }
+    
+    func urlSession(_ session: URLSession, task: URLSessionTask, didSendBodyData bytesSent: Int64, totalBytesSent: Int64, totalBytesExpectedToSend: Int64) {
+        self.didSendDataHandler?(session, task, bytesSent, totalBytesSent, totalBytesExpectedToSend)
+        
+        guard let desc = task.taskDescription, let json = jsonToDictionary(desc) else {
+            return
+        }
+        guard let type = json["type"] as? String, let source = json["source"] as? String else {
+            return
+        }
+        let dest = json["dest"] as? String
+        let op : FileOperationType
+        switch type {
+        case "Create":
+            op = .create(path: source)
+        case "Copy":
+            guard let dest = dest else { return }
+            op = .copy(source: source, destination: dest)
+        case "Move":
+            guard let dest = dest else { return }
+            op = .move(source: source, destination: dest)
+        case "Modify":
+            op = .modify(path: source)
+        case "Remove":
+            op = .remove(path: source)
+        case "Link":
+            guard let dest = dest else { return }
+            op = .link(link: source, target: dest)
+        default:
+            return
+        }
+        
+        let progress = Float(totalBytesSent) / Float(totalBytesExpectedToSend)
+        
+        fileProvider?.delegate?.fileproviderProgress(fileProvider!, operation: op, progress: progress)
+    }
+    
+    func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didWriteData bytesWritten: Int64, totalBytesWritten: Int64, totalBytesExpectedToWrite: Int64) {
+        self.didReceivedData?(session, downloadTask, bytesWritten, totalBytesWritten, totalBytesExpectedToWrite)
+        
+        guard let desc = downloadTask.taskDescription, let json = jsonToDictionary(desc), let source = json["source"] as? String, let dest = json["dest"] as? String else {
+            return
+        }
+        
+        fileProvider?.delegate?.fileproviderProgress(fileProvider!, operation: .copy(source: source, destination: dest), progress: Float(totalBytesWritten) / Float(totalBytesExpectedToWrite))
+    }
+    
+    func urlSession(_ session: URLSession, task: URLSessionTask, didReceive challenge: URLAuthenticationChallenge, completionHandler: @escaping (URLSession.AuthChallengeDisposition, URLCredential?) -> Void) {
+        let deposition: Foundation.URLSession.AuthChallengeDisposition = credential != nil ? .useCredential : .performDefaultHandling
+        completionHandler(deposition, credential)
+    }
+    
+    func urlSession(_ session: URLSession, didReceive challenge: URLAuthenticationChallenge, completionHandler: @escaping (URLSession.AuthChallengeDisposition, URLCredential?) -> Void) {
+        let deposition: Foundation.URLSession.AuthChallengeDisposition = credential != nil ? .useCredential : .performDefaultHandling
+        completionHandler(deposition, credential)
+    }
+}
+
+/// HTTP status codes as an enum.
+public enum FileProviderHTTPErrorCode: Int, CustomStringConvertible {
+    /// `Continue` informational status with HTTP code 100
+    case `continue` = 100
+    /// `Switching Protocols` informational status with HTTP code 101
+    case switchingProtocols = 101
+    /// `Processing` informational status with HTTP code 102
+    case processing = 102
+    /// `OK` success status with HTTP code 200
+    case ok = 200
+    /// `Created` success status with HTTP code 201
+    case created = 201
+    /// `Accepted` success status with HTTP code 202
+    case accepted = 202
+    /// `Non Authoritative Information` success status with HTTP code 203
+    case nonAuthoritativeInformation = 203
+    /// `No Content` success status with HTTP code 204
+    case noContent = 204
+    /// `ResetcContent` success status with HTTP code 205
+    case resetContent = 205
+    /// `Partial Content` success status with HTTP code 206
+    case partialContent = 206
+    /// `Multi Status` success status with HTTP code 207
+    case multiStatus = 207
+    /// `Already Reported` success status with HTTP code 208
+    case alreadyReported = 208
+    /// `IM Used` success status with HTTP code 226
+    case imUsed = 226
+    /// `Multiple Choices` redirection status with HTTP code 300
+    case multipleChoices = 300
+    /// `Moved Permanently` redirection status with HTTP code 301
+    case movedPermanently = 301
+    /// `Found` redirection status with HTTP code 302
+    case found = 302
+    /// `See Other` redirection status with HTTP code 303
+    case seeOther = 303
+    /// `Not Modified` redirection status with HTTP code 304
+    case notModified = 304
+    /// `Use Proxy` redirection status with HTTP code 305
+    case useProxy = 305
+    /// `Switch Proxy` redirection status with HTTP code 306
+    case switchProxy = 306
+    /// `Temporary Redirect` redirection status with HTTP code 307
+    case temporaryRedirect = 307
+    /// `Permanent Redirect` redirection status with HTTP code 308
+    case permanentRedirect = 308
+    /// `Bad Request` client error status with HTTP code 400
+    case badRequest = 400
+    /// `Unauthorized` client error status with HTTP code 401
+    case unauthorized = 401
+    /// `Payment Required` client error status with HTTP code 402
+    case paymentRequired = 402
+    /// `Forbidden` client error status with HTTP code 403
+    case forbidden = 403
+    /// `Not Found` client error status with HTTP code 404
+    case notFound = 404
+    /// `Method Not Allowed` client error status with HTTP code 405
+    case methodNotAllowed = 405
+    /// `Not Acceptable` client error status with HTTP code 406
+    case notAcceptable = 406
+    /// `Proxy Authentication Required` client error status with HTTP code 407
+    case proxyAuthenticationRequired = 407
+    /// `Request Timeout` client error status with HTTP code 408
+    case requestTimeout = 408
+    /// `Conflict` client error status with HTTP code 409
+    case conflict = 409
+    /// `Gone` client error status with HTTP code 410
+    case gone = 410
+    /// `Length Required` client error status with HTTP code 411
+    case lengthRequired = 411
+    /// `Precondition Failed` client error status with HTTP code 412
+    case preconditionFailed = 412
+    /// `Payload Too Large` client error status with HTTP code 413
+    case payloadTooLarge = 413
+    /// `URI Too Long` client error status with HTTP code 414
+    case uriTooLong = 414
+    /// `Unsupported Media Type` status with HTTP code 415
+    case unsupportedMediaType = 415
+    /// `Range Not Satisfiable` client error status with HTTP code 416
+    case rangeNotSatisfiable = 416
+    /// `Expectation Failed` client error status with HTTP code 417
+    case expectationFailed = 417
+    /// `Misdirected Request` client error status with HTTP code 421
+    case misdirectedRequest = 421
+    /// `Unprocessable Entity` client error status with HTTP code 422
+    case unprocessableEntity = 422
+    /// `Locked` client error status with HTTP code 423
+    case locked = 423
+    /// `Failed Dependency` client error status with HTTP code 424
+    case failedDependency = 424
+    /// `Unordered Collection` client error status with HTTP code 425
+    case unorderedCollection = 425
+    /// `Upgrade Required` client error status with HTTP code 426
+    case upgradeRequired = 426
+    /// `Precondition Required` client error status with HTTP code 428
+    case preconditionRequired = 428
+    /// `Too Many Requests` client error status with HTTP code 429
+    case tooManyRequests = 429
+    /// `Request Header Fields Too Large` client error status with HTTP code 431
+    case requestHeaderFieldsTooLarge = 431
+    /// `Unavailable For Legal Reasons` client error status with HTTP code 451
+    case unavailableForLegalReasons = 451
+    /// `Internal Server Error` server error status with HTTP code 500
+    case internalServerError = 500
+    /// `Bad Gateway` server error status with HTTP code 502
+    case badGateway = 502
+    /// `Service Unavailable` server error status with HTTP code 503
+    case serviceUnavailable = 503
+    /// `Gateway Timeout` server error status with HTTP code 504
+    case gatewayTimeout = 504
+    /// `HTTP Version Not Supported` server error status with HTTP code 505
+    case httpVersionNotSupported = 505
+    /// `Variant Also Negotiates` server error status with HTTP code 506
+    case variantAlsoNegotiates = 506
+    /// `Insufficient Storage` server error status with HTTP code 507
+    case insufficientStorage = 507
+    /// `Loop Detected` server error status with HTTP code 508
+    case loopDetected = 508
+    /// `Bandwidth Limit Exceeded` server error status with HTTP code 509
+    case bandwidthLimitExceeded = 509
+    /// `Not Extended` server error status with HTTP code 510
+    case notExtended = 510
+    /// `Network Authentication Required` server error status with HTTP code 511
+    case networkAuthenticationRequired = 511
+    
+    fileprivate static let status1xx: [Int: String] = [100: "Continue", 101: "Switching Protocols", 102: "Processing"]
+    fileprivate static let status2xx: [Int: String] = [200: "OK", 201: "Created", 202: "Accepted", 203: "Non-Authoritative Information", 204: "No Content", 205: "Reset Content", 206: "Partial Content", 207: "Multi-Status", 208: "Already Reported", 226: "IM Used"]
+    fileprivate static let status3xx: [Int: String] = [300: "Multiple Choices", 301: "Moved Permanently", 302: "Found", 303: "See Other", 304: "Not Modified", 305: "Use Proxy", 306: "Switch Proxy", 307: "Temporary Redirect", 308: "Permanent Redirect"]
+    fileprivate static let status4xx: [Int: String] = [400: "Bad Request", 401: "Unauthorized/Expired Session", 402: "Payment Required", 403: "Forbidden", 404: "Not Found", 405: "Method Not Allowed", 406: "Not Acceptable", 407: "Proxy Authentication Required", 408: "Request Timeout", 409: "Conflict", 410: "Gone", 411: "Length Required", 412: "Precondition Failed", 413: "Payload Too Large", 414: "URI Too Long", 415: "Unsupported Media Type", 416: "Range Not Satisfiable", 417: "Expectation Failed", 421: "Misdirected Request", 422: "Unprocessable Entity", 423: "Locked", 424: "Failed Dependency", 425: "Unordered Collection", 426: "Upgrade Required", 428: "Precondition Required", 429: "Too Many Requests", 431: "Request Header Fields Too Large", 451: "Unavailable For Legal Reasons"]
+    fileprivate static let status5xx: [Int: String] = [500: "Internal Server Error", 501: "Not Implemented", 502: "Bad Gateway", 503: "Service Unavailable", 504: "Gateway Timeout", 505: "HTTP Version Not Supported", 506: "Variant Also Negotiates", 507: "Insufficient Storage", 508: "Loop Detected", 509: "Bandwidth Limit Exceeded", 510: "Not Extended", 511: "Network Authentication Required"]
+    
+    public var description: String {
+        switch self.rawValue {
+        case 100...102: return FileProviderHTTPErrorCode.status1xx[self.rawValue]!
+        case 200...208, 226: return FileProviderHTTPErrorCode.status2xx[self.rawValue]!
+        case 300...308: return FileProviderHTTPErrorCode.status3xx[self.rawValue]!
+        case 400...417, 421...426: fallthrough
+        case 428, 429, 431, 451: return FileProviderHTTPErrorCode.status4xx[self.rawValue]!
+        case 500...511: return FileProviderHTTPErrorCode.status5xx[self.rawValue]!
+        default: return typeDescription
+        }
+    }
+    
+    /// Description of status based on first digit which indicated fail or success.
+    public var typeDescription: String {
+        switch self.rawValue {
+        case 100...199: return "Informational"
+        case 200...299: return "Success"
+        case 300...399: return "Redirection"
+        case 400...499: return "Client Error"
+        case 500...599: return "Server Error"
+        default: return "Unknown Error"
+        }
+    }
+}

Sources/SMBClient.swift

@@ -0,0 +1,236 @@
+//
+//  SMBTransmitter.swift
+//  FileProvider
+//
+//  Created by Amir Abbas Mousavian.
+//  Copyright © 2016 Mousavian. Distributed under MIT license.
+//
+
+import Foundation
+
+// This client implementation is for little-endian platform, namely x86, x64 & arm
+// For big-endian platforms like PowerPC, there must be a huge overhaul
+
+protocol SMBProtocolClientDelegate: class {
+    func receivedResponse(client: SMB2ProtocolClient, response: SMBResponse, for: SMBRequest)
+}
+
+class SMB2ProtocolClient: FPSStreamTask {
+    var timeout: TimeInterval = 30
+    
+    private(set) var lastMessageID: UInt64 = 0
+    private(set) var sessionId: UInt64 = 0
+    private func messageId() -> UInt64 {
+        defer {
+            lastMessageID += 1
+        }
+        return lastMessageID
+    }
+    
+    private(set) var establishedTrees = Array<SMB2.TreeConnectResponse>()
+    private(set) var requestStack = [Int: SMBRequest]()
+    private(set) var responseStack = [Int: SMBResponse]()
+    
+    weak var delegate: SMBProtocolClientDelegate?
+    
+    func sendNegotiate(completionHandler: SimpleCompletionHandler) -> UInt64 {
+        let mId = messageId()
+        let smbHeader = SMB2.Header(command: .NEGOTIATE, creditRequestResponse: UInt16(126), messageId: mId, treeId: UInt32(0), sessionId: UInt64(0))
+        let msg = SMB2.NegotiateRequest()
+        let data = createSMB2Message(header: smbHeader, message: msg)
+        self.writeData(data, timeout: 0, completionHandler: { (e) in
+            completionHandler?(e)
+        })
+        return mId
+    }
+    
+    func sendSessionSetup(completionHandler: SimpleCompletionHandler) -> UInt64 {
+        let mId = messageId()
+        let credit = UInt16(sessionId > 0 ? 124 : 125)
+        let smbHeader = SMB2.Header(command: SMB2.Command.SESSION_SETUP, creditRequestResponse: credit, messageId: mId, treeId: UInt32(0), sessionId: sessionId)
+        let msg = SMB2.SessionSetupRequest(singing: [])
+        let data = createSMB2Message(header: smbHeader, message: msg)
+        self.writeData(data, timeout: 0, completionHandler: { (e) in
+            if self.sessionId == 0 {
+                self.readData(OfMinLength: 64, maxLength: 65536, timeout: self.timeout, completionHandler: { (data, eof, e2) in
+                    // TODO: set session id
+                    completionHandler?(e2 ?? e)
+                })
+            }
+        })
+        return mId
+    }
+    
+    func sendTreeConnect(completionHandler: SimpleCompletionHandler) -> UInt64 {
+        let req = self.currentRequest ?? self.originalRequest
+        guard let url = req?.url, let host = url.host else {
+            return 0
+        }
+        let mId = messageId()
+        let smbHeader = SMB2.Header(command: .TREE_CONNECT, creditRequestResponse: 123, messageId: mId, treeId: 0, sessionId: sessionId)
+        var share = ""
+        let cmp = url.pathComponents
+        if cmp.count > 0 {
+            share = cmp[0]
+        }
+        let tcHeader = SMB2.TreeConnectRequest.Header(flags: [])
+        let msg = SMB2.TreeConnectRequest(header: tcHeader, host: host, share: share)
+        let data = createSMB2Message(header: smbHeader, message: msg!)
+        self.writeData(data, timeout: 0, completionHandler: { (e) in
+            completionHandler?(e)
+            
+        })
+        return mId
+    }
+    
+    func sendTreeDisconnect(id treeId: UInt32, completionHandler: SimpleCompletionHandler) -> UInt64 {
+        let mId = messageId()
+        let smbHeader = SMB2.Header(command: .TREE_DISCONNECT, creditRequestResponse: 111, messageId: mId, treeId: treeId, sessionId: sessionId)
+        let msg = SMB2.TreeDisconnect()
+        let data = createSMB2Message(header: smbHeader, message: msg)
+        self.writeData(data, timeout: 0, completionHandler: { (e) in
+            completionHandler?(e)
+        })
+        return mId
+    }
+    
+    func sendLogoff(id treeId: UInt32, completionHandler: SimpleCompletionHandler) -> UInt64 {
+        let mId = messageId()
+        let smbHeader = SMB2.Header(command: .LOGOFF, creditRequestResponse: 0, messageId: mId, treeId: 0, sessionId: sessionId)
+        let msg = SMB2.LogOff()
+        let data = createSMB2Message(header: smbHeader, message: msg)
+        self.writeData(data, timeout: 0, completionHandler: { (e) in
+            completionHandler?(e)
+        })
+        return mId
+    }
+    
+    func reset() {
+        
+    }
+}
+
+// MARK: create and analyse messages
+extension SMB2ProtocolClient {
+    func determineSMBVersion(_ data: Data) -> Float {
+        let smbverChar: Int8 = Int8(bitPattern: data.first ?? 0)
+        let version = 0 - smbverChar
+        return Float(version)
+    }
+    
+    func digestSMBMessage(_ data: Data) throws -> (header: SMB1.Header, blocks: [(params: [UInt16], message: Data?)]) {
+        guard data.count > 30 else {
+            throw URLError(.badServerResponse)
+        }
+        var buffer = [UInt8](repeating: 0, count: data.count)
+        guard determineSMBVersion(data) == 1 else {
+            throw SMBFileProviderError.incompatibleHeader
+        }
+        let headersize = MemoryLayout<SMB1.Header>.size
+        let header: SMB1.Header = data.scanValue()!
+        var blocks = [(params: [UInt16], message: Data?)]()
+        var offset = headersize
+        while offset < data.count {
+            let paramWords: [UInt16]
+            let paramWordsCount = Int(buffer[offset])
+            guard data.count > (paramWordsCount * 2 + offset) else {
+                throw SMBFileProviderError.incorrectParamsLength
+            }
+            offset += MemoryLayout<UInt8>.size
+            var rawParamWords = [UInt8](buffer[offset..<(offset + paramWordsCount * 2)])
+            let paramData = Data(bytesNoCopy: UnsafeMutablePointer<UInt8>(&rawParamWords), count: rawParamWords.count, deallocator: .free)
+            paramWords = paramData.scanValue()!
+            offset += paramWordsCount * 2
+            let messageBytesCount = Int(UInt16(buffer[0]) + UInt16(buffer[1]) << 8)
+            offset += MemoryLayout<UInt16>.size
+            guard data.count >= (offset + messageBytesCount) else {
+                throw SMBFileProviderError.incorrectMessageLength
+            }
+            let rawMessage = [UInt8](buffer[offset..<(offset + messageBytesCount)])
+            offset += messageBytesCount
+            let message = Data(bytes: rawMessage)
+            blocks.append((params: paramWords, message: message))
+        }
+        return (header, blocks)
+    }
+    
+    func digestSMB2Message(_ data: Data) throws -> SMBResponse? {
+        guard data.count > 65 else {
+            throw URLError(.badServerResponse)
+        }
+        guard determineSMBVersion(data) == 2 else {
+            throw SMBFileProviderError.incompatibleHeader
+        }
+        let headersize = MemoryLayout<SMB2.Header>.size
+        let headerData = data.subdata(in: 0..<headersize)
+        let messageSize = data.count - headersize
+        let messageData = data.subdata(in: headersize..<(headersize + messageSize))
+        let header: SMB2.Header = headerData.scanValue()!
+        switch header.command {
+        case .NEGOTIATE:
+            return (header, SMB2.NegotiateResponse(data: messageData))
+        case .SESSION_SETUP:
+            return (header, SMB2.SessionSetupResponse(data: messageData))
+        case .LOGOFF:
+            return (header, SMB2.LogOff(data: messageData))
+        case .TREE_CONNECT:
+            return (header, SMB2.TreeConnectResponse(data: messageData))
+        case .TREE_DISCONNECT:
+            return (header, SMB2.TreeDisconnect(data: messageData))
+        case .CREATE:
+            return (header, SMB2.CreateResponse(data: messageData))
+        case .CLOSE:
+            return (header, SMB2.CloseResponse(data: messageData))
+        case .FLUSH:
+            return (header, SMB2.FlushResponse(data: messageData))
+        case .READ:
+            return (header, SMB2.ReadRespone(data: messageData))
+        case .WRITE:
+            return (header, SMB2.WriteResponse(data: messageData))
+        case .LOCK:
+            return (header, SMB2.LockResponse(data: messageData))
+        case .IOCTL:
+            return (header, SMB2.IOCtlResponse(data: messageData))
+        case .CANCEL:
+            return (header, nil)
+        case .ECHO:
+            return (header, SMB2.Echo(data: messageData))
+        case .QUERY_DIRECTORY:
+            return (header, SMB2.QueryDirectoryResponse(data: messageData))
+        case .CHANGE_NOTIFY:
+            return (header, SMB2.ChangeNotifyResponse(data: messageData))
+        case .QUERY_INFO:
+            return (header, SMB2.QueryInfoResponse(data: messageData))
+        case .SET_INFO:
+            return (header, SMB2.SetInfoResponse(data: messageData))
+        case .OPLOCK_BREAK:
+            return (header, nil) // FIXME:
+        case .INVALID:
+            throw SMBFileProviderError.invalidCommand
+        }
+    }
+    
+    func createSMBMessage(header: SMB1.Header, blocks: [(params: Data?, message: Data?)]) -> Data {
+        var result = Data(value: header)
+        for block in blocks {
+            var paramWordsCount = UInt8(block.params?.count ?? 0)
+            result.append(&paramWordsCount, count: MemoryLayout.size(ofValue: paramWordsCount))
+            if let params = block.params {
+                result.append(params)
+            }
+            var messageLen = UInt16(block.message?.count ?? 0)
+            let b = UnsafeBufferPointer(start: &messageLen, count: MemoryLayout.size(ofValue: messageLen))
+            result.append(b)
+            if let message = block.message {
+                result.append(message)
+            }
+        }
+        return result
+    }
+    
+    func createSMB2Message(header: SMB2.Header, message: SMBRequestBody) -> Data {
+        var result = Data(value: header)
+        result.append(message.data())
+        return result
+    }
+}

Sources/SMBFileProvider.swift

@@ -0,0 +1,147 @@
+//
+//  SambaFileProvider.swift
+//  FileProvider
+//
+//  Created by Amir Abbas Mousavian.
+//  Copyright © 2016 Mousavian. Distributed under MIT license.
+//
+
+import Foundation
+
+class SMBFileProvider: FileProvider, FileProviderMonitor {
+    open class var type: String { return "SMB" }
+    open var isPathRelative: Bool = true
+    open var baseURL: URL?
+    open var currentPath: String = ""
+    open var dispatch_queue: DispatchQueue
+    open var operation_queue: OperationQueue
+    open weak var delegate: FileProviderDelegate?
+    open let credential: URLCredential?
+    
+    public typealias FileObjectClass = FileObject
+    
+    public init? (baseURL: URL, credential: URLCredential, afterInitialized: SimpleCompletionHandler) {
+        guard baseURL.uw_scheme.lowercased() == "smb" else {
+            return nil
+        }
+        self.baseURL = baseURL.appendingPathComponent("")
+        dispatch_queue = DispatchQueue(label: "FileProvider.\(type(of: self).type)", attributes: .concurrent)
+        operation_queue = OperationQueue()
+        operation_queue.name = "FileProvider.\(type(of: self).type).Operation"
+        
+        self.credential = credential
+    }
+        
+    open func contentsOfDirectory(path: String, completionHandler: @escaping ((_ contents: [FileObjectClass], _ error: Error?) -> Void)) {
+        NotImplemented()
+    }
+    
+    open func attributesOfItem(path: String, completionHandler: @escaping ((_ attributes: FileObjectClass?, _ error: Error?) -> Void)) {
+        NotImplemented()
+    }
+    
+    open func storageProperties(completionHandler: @escaping ((_ total: Int64, _ used: Int64) -> Void)) {
+        NotImplemented()
+    }
+    
+    func isReachable(completionHandler: @escaping (Bool) -> Void) {
+        NotImplemented()
+    }
+    
+    open weak var fileOperationDelegate: FileOperationDelegate?
+    
+    open func create(folder folderName: String, at atPath: String, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        NotImplemented()
+        return nil
+    }
+    
+    open func create(file fileName: String, at atPath: String, contents data: Data?, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        NotImplemented()
+        return nil
+    }
+    
+    open func moveItem(path: String, to toPath: String, overwrite: Bool = false, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        NotImplemented()
+        return nil
+    }
+    
+    open func copyItem(path: String, to toPath: String, overwrite: Bool = false, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        NotImplemented()
+        return nil
+    }
+    
+    open func removeItem(path: String, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        NotImplemented()
+        return nil
+    }
+    
+    open func copyItem(localFile: URL, to toPath: String, overwrite: Bool, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        NotImplemented()
+        return nil
+    }
+    
+    open func copyItem(path: String, toLocalURL: URL, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        NotImplemented()
+        return nil
+    }
+    
+    open func contents(path: String, completionHandler: @escaping ((_ contents: Data?, _ error: Error?) -> Void)) -> OperationHandle? {
+        NotImplemented()
+        return nil
+    }
+    
+    open func contents(path: String, offset: Int64, length: Int, completionHandler: @escaping ((_ contents: Data?, _ error: Error?) -> Void)) -> OperationHandle? {
+        NotImplemented()
+        return nil
+    }
+    
+    open func writeContents(path: String, contents data: Data, atomically: Bool, overwrite: Bool, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        NotImplemented()
+        return nil
+    }
+    
+    open func searchFiles(path: String, recursive: Bool, query: NSPredicate, foundItemHandler:((FileObjectClass) -> Void)?, completionHandler: @escaping ((_ files: [FileObjectClass], _ error: Error?) -> Void)) {
+        NotImplemented()
+    }
+    
+    open func registerNotifcation(path: String, eventHandler: @escaping (() -> Void)) {
+        NotImplemented()
+    }
+    
+    open func unregisterNotifcation(path: String) {
+        NotImplemented()
+    }
+    
+    open func isRegisteredForNotification(path: String) -> Bool {
+        return false
+    }
+    
+    open func copy(with zone: NSZone? = nil) -> Any {
+        let copy = SMBFileProvider(baseURL: self.baseURL!, credential: self.credential!, afterInitialized: { _ in })!
+        copy.currentPath = self.currentPath
+        copy.delegate = self.delegate
+        copy.fileOperationDelegate = self.fileOperationDelegate
+        return copy
+    }
+}
+
+// MARK: basic CIFS interactivity
+enum SMBFileProviderError: Int, Error, CustomStringConvertible {
+    case badHeader
+    case incompatibleHeader
+    case incorrectParamsLength
+    case incorrectMessageLength
+    case invalidCommand
+    
+    public var description: String {
+        return "SMB message structure is invalid"
+    }
+}
+
+private extension SMBFileProvider {
+    func getPID() -> UInt32 {
+        return UInt32(ProcessInfo.processInfo.processIdentifier)
+    }
+}
+
+

Sources/SMBTypes/CIFSTypes.swift

@@ -0,0 +1,217 @@
+//
+//  CIFSTypes.swift
+//  ExtDownloader
+//
+//  Created by Amir Abbas Mousavian on 4/30/95.
+//  Copyright © 1395 Mousavian. All rights reserved.
+//
+
+import Foundation
+
+// SMB/CIFS Types
+struct SMB1 {
+    struct Header { // 32 bytes
+        // header is always \u{ff}SMB
+        let protocolID: UInt32
+        static let protocolConst: UInt32 = 0x424d53ff
+        fileprivate var _command: UInt8
+        var command: Command {
+            get {
+                return Command(rawValue: _command) ?? .INVALID
+            }
+            set {
+                _command = newValue.rawValue
+            }
+        }
+        // error messages from the server to the client
+        fileprivate var _status: (UInt8, UInt8, UInt8, UInt8)
+        var error: (Class: UInt8, code: UInt16) {
+            get {
+                return (_status.0, UInt16(_status.2) + (UInt16(_status.3) << 8))
+            }
+            set {
+                _status = (newValue.Class, 0, UInt8(newValue.code & 0xff), UInt8(newValue.code >> 8))
+            }
+        }
+        var ntStatus: UInt32 {
+            get {
+                let statusLo = UInt32(_status.0) + UInt32(_status.1) << 8
+                let statusHi = UInt32(_status.2) + UInt32(_status.3) << 8
+                return statusHi << 16 + statusLo
+            }
+            set {
+                _status = (UInt8(newValue & 0xff), UInt8(newValue >> 8 & 0xff), UInt8(newValue >> 16 & 0xff), UInt8(newValue >> 24 & 0xff))
+            }
+        }
+        var flags: Flags
+        var flags2: Flags2
+        var pidHigh: UInt16
+        //  encryption key used for validating messages over connectionless transports
+        fileprivate var _securityKey: (UInt16, UInt16)
+        var securityKey: UInt32 {
+            get {
+                return UInt32(_securityKey.1) << 16 + UInt32(_securityKey.0)
+            }
+            set {
+                _securityKey = (UInt16(newValue & 0xffff), UInt16(newValue >> 16))
+            }
+        }
+        ///  Connection identifier
+        var securityCID: UInt16
+        ///  Identifier of the sequence of a message over connectionless transports
+        var securitySequenceNumber: UInt16
+        fileprivate var ununsed: UInt16
+        var treeId: UInt16
+        var pidLow: UInt16
+        var userId: UInt16
+        var multiplexId: UInt16
+        var pid: UInt32 {
+            get {
+                return UInt32(pidLow) + UInt32(pidHigh) << 16
+            }
+            set {
+                pidLow = UInt16(newValue & 0xffff)
+                pidHigh = UInt16(newValue >> 16)
+            }
+        }
+        
+        init(command: Command, treeId: UInt16, pid: UInt32, userId: UInt16, multiplexId: UInt16, flags: Flags, flags2: Flags2 = [.LONG_NAMES, .ERR_STATUS, .UNICODE], ntStatus: UInt32 = 0, securityKey: UInt32 = 0, securityCID: UInt16 = 0, securitySequenceNumber: UInt16 = 0) {
+            self.protocolID = Header.protocolConst
+            self._command = command.rawValue
+            _status = (UInt8(ntStatus & 0xff), UInt8(ntStatus >> 8 & 0xff), UInt8(ntStatus >> 16 & 0xff), UInt8(ntStatus >> 24 & 0xff))
+            self.flags = flags
+            self.flags2 = flags2
+            self._securityKey = (UInt16(securityKey & 0xffff), UInt16(securityKey >> 16))
+            self.securityCID = securityCID
+            self.securitySequenceNumber = securitySequenceNumber
+            self.ununsed = 0
+            self.treeId = treeId
+            self.pidLow = UInt16(pid & 0xffff)
+            self.pidHigh = UInt16(pid >> 16)
+            self.userId = userId
+            self.multiplexId = multiplexId
+        }
+    }
+    
+    struct Flags: OptionSet {
+        let rawValue: UInt8
+        
+        init(rawValue: UInt8) {
+            self.rawValue = rawValue
+        }
+        /** This bit is set (1) in the NEGOTIATE (0x72) Response if the server supports
+         * LOCK_AND_READ (0x13) and WRITE_AND_UNLOCK (0x14) commands. */
+        static let LOCK_AND_READ_OK       = Flags(rawValue: 0x01)
+        static let BUF_AVAIL              = Flags(rawValue: 0x02)
+        static let CASE_INSENSITIVE       = Flags(rawValue: 0x08)
+        static let CANONICALIZED_PATHS    = Flags(rawValue: 0x10)
+        static let OPLOCK                 = Flags(rawValue: 0x20)
+        static let OPBATCH                = Flags(rawValue: 0x40)
+        /**  When on, this message is being sent from the server in response to a client request. */
+        static let REPLY                  = Flags(rawValue: 0x80)
+    }
+    
+    struct Flags2: OptionSet {
+        let rawValue: UInt16
+        
+        init(rawValue: UInt16) {
+            self.rawValue = rawValue
+        }
+        /** Client: the message MAY contain long file names. */
+        static let LONG_NAMES             = Flags2(rawValue: 0x0001)
+        /** Client: the client is aware of extended attributes (EAs). */
+        static let EAS                    = Flags2(rawValue: 0x0002)
+        /** Client: the client is requesting signing (if signing is not yet active) or the message
+         * being sent is signed. This bit is used on the SMB header of an SESSION_SETUP_ANDX */
+        static let SMB_SECURITY_SIGNATURE = Flags2(rawValue: 0x0004)
+        ///  Reserved but not implemented.
+        static let IS_LONG_NAME           = Flags2(rawValue: 0x0040)
+        /** client aware of Extended Security negotiation */
+        static let EXT_SEC                = Flags2(rawValue:  0x0800)
+        /** any pathnames in this SMB SHOULD be resolved in the Distributed File System (DFS) */
+        static let DFS                    = Flags2(rawValue: 0x1000)
+        /**
+         * This flag is useful only on a read request. If the bit is set, then the client MAY read
+         * the file if the client does not have read permission but does have execute permission. */
+        static let PAGING_IO              = Flags2(rawValue:  0x2000) // READ_IF_EXECUTE
+        /**
+         * Client: the server MUST return errors as 32-bit NTSTATUS codes in the response
+         * Server: the Status field in the header is formatted as an NTSTATUS cod */
+        static let ERR_STATUS             = Flags2(rawValue: 0x4000)
+        /**
+         * Each field that contains a string in this SMB message MUST be encoded
+         * as an array of 16-bit Unicode characters */
+        static let UNICODE                = Flags2(rawValue: 0x8000)
+    }
+    
+    enum Command: UInt8 {
+        case CREATE_DIRECTORY       = 0x00
+        case DELETE_DIRECTORY       = 0x01
+        case OPEN                   = 0x02
+        case CREATE                 = 0x03
+        case CLOSE                  = 0x04
+        case FLUSH                  = 0x05
+        case DELETE                 = 0x06
+        case RENAME                 = 0x07
+        case QUERY_INFORMATION      = 0x08
+        case SET_INFORMATION        = 0x09
+        case READ                   = 0x0A
+        case WRITE                  = 0x0B
+        case LOCK_BYTE_RANGE        = 0x0C
+        case UNLOCK_BYTE_RANGE      = 0x0D
+        case CREATE_TEMPORARY       = 0x0E
+        case CREATE_NEW             = 0x0F
+        case CHECK_DIRECTORY        = 0x10
+        case PROCESS_EXIT           = 0x11
+        case SEEK                   = 0x12
+        case LOCK_AND_READ          = 0x13
+        case WRITE_AND_UNLOCK       = 0x14
+        case READ_RAW               = 0x1A
+        case READ_MPX               = 0x1B
+        case READ_MPX_SECONDARY     = 0x1C
+        case WRITE_RAW              = 0x1D
+        case WRITE_MPX              = 0x1E
+        case WRITE_COMPLETE         = 0x20
+        case SET_INFORMATION2       = 0x22
+        case QUERY_INFORMATION2     = 0x23
+        case LOCKING_ANDX           = 0x24
+        case TRANSACTION            = 0x25
+        case TRANSACTION_SECONDARY  = 0x26
+        case IOCTL                  = 0x27
+        case IOCTL_SECONDARY        = 0x28
+        case COPY                   = 0x29
+        case MOVE                   = 0x2A
+        case ECHO                   = 0x2B
+        case WRITE_AND_CLOSE        = 0x2C
+        case OPEN_ANDX              = 0x2D
+        case READ_ANDX              = 0x2E
+        case WRITE_ANDX             = 0x2F
+        case CLOSE_AND_TREE_DISC    = 0x31
+        case TRANSACTION2           = 0x32
+        case TRANSACTION2_SECONDARY = 0x33
+        case FIND_CLOSE2            = 0x34
+        case FIND_NOTIFY_CLOSE      = 0x35
+        case TREE_CONNECT           = 0x70
+        case TREE_DISCONNECT        = 0x71
+        case NEGOTIATE              = 0x72
+        case SESSION_SETUP_ANDX     = 0x73
+        case LOGOFF_ANDX            = 0x74
+        case TREE_CONNECT_ANDX      = 0x75
+        case QUERY_INFORMATION_DISK = 0x80
+        case SEARCH                 = 0x81
+        case FIND                   = 0x82
+        case FIND_UNIQUE            = 0x83
+        case NT_TRANSACT            = 0xA0
+        case NT_TRANSACT_SECONDARY  = 0xA1
+        case NT_CREATE_ANDX         = 0xA2
+        case NT_CANCEL              = 0xA4
+        case OPEN_PRINT_FILE        = 0xC0
+        case WRITE_PRINT_FILE       = 0xC1
+        case CLOSE_PRINT_FILE       = 0xC2
+        case GET_PRINT_QUEUE        = 0xC3
+        case READ_BULK              = 0xD8
+        case WRITE_BULK             = 0xD9
+        case WRITE_BULK_DATA        = 0xDA
+        case INVALID                = 0xFE
+    }
+}

Sources/SMBTypes/SMB2DataTypes.swift

@@ -0,0 +1,97 @@
+//
+//  SMB2DataTypes.swift
+//  ExtDownloader
+//
+//  Created by Amir Abbas Mousavian on 4/30/95.
+//  Copyright © 1395 Mousavian. All rights reserved.
+//
+
+import Foundation
+
+protocol SMBRequestBody {
+    func data() -> Data
+}
+
+extension SMBRequestBody {
+    func data() -> Data {
+        return Data(value: self)
+    }
+}
+
+protocol SMBResponseBody {
+    init? (data: Data)
+}
+
+extension SMBResponseBody {
+    init? (data: Data) {
+        if let v: Self = data.scanValue() {
+            self = v
+        } else {
+            return nil
+        }
+    }
+}
+
+typealias SMBRequest = (header: SMB2.Header, body: SMBRequestBody?)
+typealias SMBResponse = (header: SMB2.Header, body: SMBResponseBody?)
+
+protocol IOCtlRequestProtocol: SMBRequestBody {}
+protocol IOCtlResponseProtocol: SMBResponseBody {}
+
+
+struct SMBTime {
+    var time: Int64
+    
+    init(time: Int64) {
+        self.time = time
+    }
+    
+    init(unixTime: UInt) {
+        self.time = (Int64(unixTime) + 11644473600) * 10000000
+    }
+    
+    init(timeIntervalSince1970: TimeInterval) {
+        self.time = Int64((timeIntervalSince1970 + 11644473600) * 10000000)
+    }
+    
+    init(date: Date) {
+        self.init(timeIntervalSince1970: date.timeIntervalSince1970)
+    }
+    
+    var unixTime: UInt {
+        return UInt(self.time / 10000000 - 11644473600)
+    }
+    
+    var date: Date {
+        return Date(timeIntervalSince1970: Double(self.time) / 10000000 - 11644473600)
+    }
+}
+
+extension Data {
+    init<T>(value: T) {
+        var value = value
+        self = Data(buffer: UnsafeBufferPointer(start: &value, count: 1))
+    }
+    
+    func scanValue<T>() -> T? {
+        guard MemoryLayout<T>.size <= self.count else { return nil }
+        return self.withUnsafeBytes { $0.pointee }
+    }
+    
+    func scanValue<T>(start: Int) -> T? {
+        let length = MemoryLayout<T>.size
+        guard self.count >= start + length else { return nil }
+        return self.subdata(in: start..<start+length).withUnsafeBytes { $0.pointee }
+    }
+    
+    func scanString(start: Int = 0, length: Int, encoding: String.Encoding) -> String? {
+        guard self.count >= start + length else { return nil }
+        return String(data: self.subdata(in: start..<start+length), encoding: encoding)
+    }
+    
+    static func mapMemory<T, U>(from: T) -> U? {
+        guard MemoryLayout<T>.size >= MemoryLayout<U>.size else { return nil }
+        let data = Data(value: from)
+        return data.scanValue()
+    }
+}

Sources/SMBTypes/SMB2FileHandle.swift

@@ -0,0 +1,426 @@
+//
+//  SMB2CreateClose.swift
+//  ExtDownloader
+//
+//  Created by Amir Abbas Mousavian on 4/30/95.
+//  Copyright © 1395 Mousavian. All rights reserved.
+//
+
+import Foundation
+
+extension SMB2 {
+    // MARK: SMB2 Create
+    
+    struct CreateRequest: SMBRequestBody {
+        let header: CreateRequest.Header
+        let name: String?
+        let contexts: [CreateContext]
+        
+        init (header: CreateRequest.Header, name: String? = nil, contexts: [CreateContext] = []) {
+            self.header = header
+            self.name = name
+            self.contexts = contexts
+        }
+        
+        func data() -> Data {
+            var header = self.header
+            var offset = 0x78 //UInt16(sizeof(SMB2.Header.self) + sizeof(CreateContext.Header.self) - 1)
+            var body = Data()
+            if let name = self.name, let nameData = name.data(using: .utf16) {
+                header.nameOffset = UInt16(offset)
+                header.nameLength = UInt16(nameData.count)
+                offset += nameData.count
+                body.append(nameData)
+            }
+            if contexts.count > 0 {
+                // TODO: Context CreateRequest implementation, 8 bit allign offset
+                header.contextOffset = UInt32(offset)
+                
+                
+                header.contextLength = 0
+                //result.appendData(nameData)
+            }
+            var result = Data(value: header)
+            result.append(body)
+            return result
+        }
+        
+        struct Header {
+            let size: UInt16
+            fileprivate let securityFlags: UInt8
+            fileprivate var _requestedOplockLevel: UInt8
+            var requestedOplockLevel: OplockLevel {
+                get {
+                    return OplockLevel(rawValue: _requestedOplockLevel)!
+                }
+                set {
+                    _requestedOplockLevel = newValue.rawValue
+                }
+            }
+            fileprivate var _impersonationLevel: UInt32
+            var impersonationLevel: ImpersonationLevel {
+                get {
+                    return ImpersonationLevel(rawValue: _impersonationLevel)!
+                }
+                set {
+                    _impersonationLevel = newValue.rawValue
+                }
+            }
+            fileprivate let flags: UInt64
+            fileprivate let reserved: UInt64
+            let access: FileAccessMask
+            let fileAttributes: FileAttributes
+            let shareAccess: ShareAccess
+            fileprivate var _desposition: UInt32
+            var desposition: CreateDisposition {
+                get {
+                    return CreateDisposition(rawValue: _desposition)!
+                }
+                set {
+                    _desposition = newValue.rawValue
+                }
+            }
+            let options: CreateOptions
+            var nameOffset: UInt16
+            var nameLength: UInt16
+            var contextOffset: UInt32
+            var contextLength: UInt32
+            
+            init(requestedOplockLevel: OplockLevel = .NONE, impersonationLevel: ImpersonationLevel = .anonymous, access: FileAccessMask = [.GENERIC_ALL], fileAttributes: FileAttributes = [], shareAccess: ShareAccess = [.READ], desposition: CreateDisposition = .OPEN_IF, options: CreateOptions = []) {
+                self.size = 57
+                self.securityFlags = 0
+                self._requestedOplockLevel = requestedOplockLevel.rawValue
+                self._impersonationLevel = impersonationLevel.rawValue
+                self.flags = 0
+                self.reserved = 0
+                self.access = access
+                self.fileAttributes = fileAttributes
+                self.shareAccess = shareAccess
+                self._desposition = desposition.rawValue
+                self.options = options
+                self.nameOffset = 0
+                self.nameLength = 0
+                self.contextOffset = 0
+                self.contextLength = 0
+            }
+        }
+        
+        struct CreateOptions: OptionSet {
+            let rawValue: UInt32
+            
+            init(rawValue: UInt32) {
+                self.rawValue = rawValue
+            }
+            
+            static let DIRECTORY_FILE               = CreateOptions(rawValue: 0x00000001)
+            static let WRITE_THROUGH                = CreateOptions(rawValue: 0x00000002)
+            static let SEQUENTIAL_ONLY              = CreateOptions(rawValue: 0x00000004)
+            static let NO_INTERMEDIATE_BUFFERING    = CreateOptions(rawValue: 0x00000008)
+            static let NON_DIRECTORY_FILE           = CreateOptions(rawValue: 0x00000040)
+            static let NO_EA_KNOWLEDGE              = CreateOptions(rawValue: 0x00000200)
+            static let RANDOM_ACCESS                = CreateOptions(rawValue: 0x00000800)
+            static let DELETE_ON_CLOSE              = CreateOptions(rawValue: 0x00001000)
+            static let OPEN_BY_FILE_ID              = CreateOptions(rawValue: 0x00002000)
+            static let OPEN_FOR_BACKUP_INTENT       = CreateOptions(rawValue: 0x00004000)
+            static let NO_COMPRESSION               = CreateOptions(rawValue: 0x00008000)
+            static let OPEN_REPARSE_POINT           = CreateOptions(rawValue: 0x00200000)
+            static let OPEN_NO_RECALL               = CreateOptions(rawValue: 0x00400000)
+            fileprivate static let SYNCHRONOUS_IO_ALERT         = CreateOptions(rawValue: 0x00000010)
+            fileprivate static let SYNCHRONOUS_IO_NONALERT      = CreateOptions(rawValue: 0x00000020)
+            fileprivate static let COMPLETE_IF_OPLOCKED         = CreateOptions(rawValue: 0x00000100)
+            fileprivate static let REMOTE_INSTANCE              = CreateOptions(rawValue: 0x00000400)
+            fileprivate static let OPEN_FOR_FREE_SPACE_QUERY    = CreateOptions(rawValue: 0x00800000)
+            fileprivate static let OPEN_REQUIRING_OPLOCK        = CreateOptions(rawValue: 0x00010000)
+            fileprivate static let DISALLOW_EXCLUSIVE           = CreateOptions(rawValue: 0x00020000)
+            fileprivate static let RESERVE_OPFILTER             = CreateOptions(rawValue: 0x00100000)
+        }
+        
+        enum CreateDisposition: UInt32 {
+            /// If the file already exists, supersede it. Otherwise, create the file.
+            case SUPERSEDE      = 0x00000000
+            /// If the file already exists, return success; otherwise, fail the operation.
+            case OPEN           = 0x00000001
+            /// If the file already exists, fail the operation; otherwise, create the file.
+            case CREATE         = 0x00000002
+            /// Open the file if it already exists; otherwise, create the file.
+            case OPEN_IF        = 0x00000003
+            /// Overwrite the file if it already exists; otherwise, fail the operation.
+            case OVERWRITE      = 0x00000004
+            /// Overwrite the file if it already exists; otherwise, create the file.
+            case OVERWRITE_IF   = 0x00000005
+        }
+        
+        enum ImpersonationLevel: UInt32 {
+            case anonymous = 0x00000000
+            case identification = 0x00000001
+            case impersonation = 0x00000002
+            case delegate = 0x00000003
+        }
+    }
+    
+    struct CreateResponse: SMBResponseBody {
+        struct Header {
+            let size: UInt16
+            fileprivate let _oplockLevel: UInt8
+            var oplockLevel: OplockLevel {
+                return OplockLevel(rawValue: _oplockLevel)!
+            }
+            fileprivate let reserved: UInt32
+            let creationTime: SMBTime
+            let lastAccessTime: SMBTime
+            let lastWriteTime: SMBTime
+            let changeTime: SMBTime
+            let allocationSize: UInt64
+            let endOfFile: UInt64
+            let fileAttributes: FileAttributes
+            fileprivate let reserved2: UInt32
+            let fileId: FileId
+            let contextsOffset: UInt32
+            let ContextsLength: UInt32
+        }
+        
+        let header: CreateResponse.Header
+        let contexts: [CreateContext]
+        
+        init? (data: Data) {
+            guard data.count >= MemoryLayout<CreateResponse.Header>.size else {
+                return nil
+            }
+            self.header = data.scanValue()!
+            if self.header.contextsOffset > 0 {
+                var contexts = [CreateContext]()
+                var contextOffset = Int(self.header.contextsOffset) - MemoryLayout<SMB2.Header>.size
+                while contextOffset > 0 {
+                    guard contextOffset < data.count else {
+                        self.contexts = contexts
+                        return
+                    }
+                    while contextOffset > 0, let context: CreateContext = data.scanValue(start: contextOffset) {
+                        contexts.append(context)
+                        contextOffset = Int(context.header.next) - MemoryLayout<SMB2.Header>.size
+                    }
+                }
+                self.contexts = contexts
+            } else {
+                self.contexts = []
+            }
+        }
+    }
+    
+    struct CreateContext {
+        struct Header {
+            var next: UInt32
+            let nameOffset: UInt16
+            let nameLength: UInt16
+            fileprivate let reserved: UInt16
+            let dataOffset: UInt16
+            let dataLength: UInt32
+        }
+        
+        var header: CreateContext.Header
+        let buffer: Data
+        
+        init(name: ContextNames, data: Data) {
+            let nameData = (name.rawValue).data(using: .utf16) ?? Data()
+            self.header = CreateContext.Header(next: 0, nameOffset: 32, nameLength: UInt16(nameData.count), reserved: 0, dataOffset: UInt16(nameData.count), dataLength: UInt32(data.count))
+            self.buffer = data
+        }
+        
+        init(name: UUID, data: Data) {
+            let uuid = name.uuid
+            var nameData = Data(value: uuid)
+            self.header = CreateContext.Header(next: 0, nameOffset: 32, nameLength: UInt16(nameData.count), reserved: 0, dataOffset: UInt16(nameData.count), dataLength: UInt32(data.count))
+            self.buffer = data
+        }
+        
+        init? (data: Data) {
+            let headersize = MemoryLayout<Header>.size
+            guard data.count > headersize else {
+                return nil
+            }
+            self.header = data.scanValue()!
+            self.buffer = data.subdata(in: headersize..<data.count)
+        }
+        
+        func data() -> Data {
+            var result = Data(value: header)
+            result.append(buffer)
+            return result
+        }
+        
+        enum ContextNames: String {
+            /// Request Create Context: Extended attributes
+            case EA_BUFFER = "ExtA"
+            /// Request Create Context: Security descriptor
+            case SD_BUFFER = "SecD"
+            /// Request & Response Create Context: Open to be durable
+            case DURABLE_HANDLE = "DHnQ"
+            case DURABLE_HANDLE_RESPONSE_V2 = "DH2Q"
+            /// Request Create Context: Reconnect to a durable open after being disconnected
+            case DURABLE_HANDLE_RECONNECT = "DHnC"
+            /// Request Create Context: Required allocation size of the newly created file
+            case ALLOCATION_SIZE = "AISi"
+            /// Request & Response Create Context: Maximal access information
+            case QUERY_MAXIMAL_ACCESS = "MxAc"
+            case TIMEWARP_TOKEN = "TWrp"
+            /// Response Create Context: DiskID of the open file in a volume.
+            case QUERY_ON_DISK_ID = "QFid"
+            /// Response Create Context: A lease. This value is only supported for the SMB 2.1 and 3.x dialect family.
+            case LEASE = "RqLs"
+        }
+    }
+    
+    enum OplockLevel: UInt8 {
+        case NONE = 0x00
+        case LEVEL_II = 0x01
+        case EXCLUSIVE = 0x08
+        case BATCH = 0x09
+        case LEASE = 0xFF
+    }
+    
+    struct ShareAccess: OptionSet {
+        let rawValue: UInt32
+        
+        init(rawValue: UInt32) {
+            self.rawValue = rawValue
+        }
+        
+        static let READ     = ShareAccess(rawValue: 0x00000001)
+        static let WRITE    = ShareAccess(rawValue: 0x00000002)
+        static let DELETE   = ShareAccess(rawValue: 0x00000004)
+    }
+    
+    struct FileAccessMask: OptionSet {
+        let rawValue: UInt32
+        
+        init(rawValue: UInt32) {
+            self.rawValue = rawValue
+        }
+        
+        // File and Printer/Pipe Accesses
+        static let FILE_READ_DATA = FileAccessMask(rawValue: 0x00000001)
+        static let FILE_WRITE_DATA = FileAccessMask(rawValue: 0x00000002)
+        static let FILE_APPEND_DATA = FileAccessMask(rawValue: 0x00000004)
+        static let FILE_EXECUTE = FileAccessMask(rawValue: 0x00000020)
+        // Directory
+        static let FILE_LIST_DIRECTORY = FileAccessMask(rawValue: 0x00000001)
+        static let FILE_ADD_FILE = FileAccessMask(rawValue: 0x00000002)
+        static let FILE_ADD_SUBDIRECTORY = FileAccessMask(rawValue: 0x00000004)
+        static let FILE_TRAVERSE = FileAccessMask(rawValue: 0x00000020)
+        // Generic
+        static let FILE_READ_EA = FileAccessMask(rawValue: 0x00000008)
+        static let FILE_WRITE_EA = FileAccessMask(rawValue: 0x00000010)
+        static let FILE_DELETE_CHILD = FileAccessMask(rawValue: 0x00000040)
+        static let FILE_READ_ATTRIBUTES = FileAccessMask(rawValue: 0x00000080)
+        static let FILE_WRITE_ATTRIBUTES = FileAccessMask(rawValue: 0x00000100)
+        static let DELETE = FileAccessMask(rawValue: 0x00010000)
+        static let READ_CONTROL = FileAccessMask(rawValue: 0x00020000)
+        static let WRITE_DAC = FileAccessMask(rawValue: 0x00040000)
+        static let WRITE_OWNER = FileAccessMask(rawValue: 0x00080000)
+        static let SYNCHRONIZE = FileAccessMask(rawValue: 0x00100000)
+        static let ACCESS_SYSTEM_SECURITY = FileAccessMask(rawValue: 0x01000000)
+        static let MAXIMUM_ALLOWED = FileAccessMask(rawValue: 0x02000000)
+        static let GENERIC_ALL = FileAccessMask(rawValue: 0x10000000)
+        static let GENERIC_EXECUTE = FileAccessMask(rawValue: 0x20000000)
+        static let GENERIC_WRITE = FileAccessMask(rawValue: 0x40000000)
+        static let GENERIC_READ = FileAccessMask(rawValue: 0x80000000)
+    }
+    
+    struct FileAttributes: OptionSet {
+        let rawValue: UInt32
+        
+        init(rawValue: UInt32) {
+            self.rawValue = rawValue
+        }
+        
+        static let READONLY             = FileAttributes(rawValue: 0x00000001)
+        static let HIDDEN               = FileAttributes(rawValue: 0x00000002)
+        static let SYSTEM               = FileAttributes(rawValue: 0x00000004)
+        static let DIRECTORY            = FileAttributes(rawValue: 0x00000010)
+        static let ARCHIVE              = FileAttributes(rawValue: 0x00000020)
+        static let NORMAL               = FileAttributes(rawValue: 0x00000080)
+        static let TEMPORARY            = FileAttributes(rawValue: 0x00000100)
+        static let SPARSE_FILE          = FileAttributes(rawValue: 0x00000200)
+        static let REPARSE_POINT        = FileAttributes(rawValue: 0x00000400)
+        static let COMPRESSED           = FileAttributes(rawValue: 0x00000800)
+        static let OFFLINE              = FileAttributes(rawValue: 0x00001000)
+        static let NOT_CONTENT_INDEXED  = FileAttributes(rawValue: 0x00002000)
+        static let ENCRYPTED            = FileAttributes(rawValue: 0x00004000)
+        static let INTEGRITY_STREAM     = FileAttributes(rawValue: 0x00008000)
+        static let NO_SCRUB_DATA        = FileAttributes(rawValue: 0x00020000)
+    }
+    
+    struct FileId {
+        let persistent: UInt64
+        let volatile: UInt64
+    }
+    
+    // MARK: SMB2 Close
+    
+    struct CloseRequest: SMBRequestBody {
+        let size: UInt16
+        let flags: CloseFlags
+        fileprivate let reserved2: UInt32
+        let filePersistantId: UInt64
+        let fileVolatileId: UInt64
+        
+        init(filePersistantId: UInt64, fileVolatileId: UInt64) {
+            self.size = 24
+            self.filePersistantId = filePersistantId
+            self.fileVolatileId = fileVolatileId
+            self.flags = []
+            self.reserved2 = 0
+        }
+    }
+    
+    struct CloseResponse: SMBResponseBody {
+        let size: UInt16
+        let flags: CloseFlags
+        fileprivate let reserved: UInt32
+        let creationTime: SMBTime
+        let lastAccessTime: SMBTime
+        let lastWriteTime: SMBTime
+        let changeTime: SMBTime
+        let allocationSize: UInt64
+        let endOfFile: UInt64
+        let fileAttributes: FileAttributes
+    }
+    
+    struct CloseFlags: OptionSet {
+        let rawValue: UInt16
+        
+        init(rawValue: UInt16) {
+            self.rawValue = rawValue
+        }
+        
+        static let POSTQUERY_ATTRIB = Flags(rawValue: 0x0001)
+    }
+    
+    // MARK: SMB2 Flush
+    
+    struct FlushRequest: SMBRequestBody {
+        let size: UInt16
+        fileprivate let reserved: UInt16
+        fileprivate let reserved2: UInt32
+        let filePersistantId: UInt64
+        let fileVolatileId: UInt64
+        
+        init(filePersistantId: UInt64, fileVolatileId: UInt64) {
+            self.size = 24
+            self.filePersistantId = filePersistantId
+            self.fileVolatileId = fileVolatileId
+            self.reserved = 0
+            self.reserved2 = 0
+        }
+    }
+    
+    struct FlushResponse: SMBResponseBody {
+        let size: UInt16
+        let reserved: UInt16
+        
+        init() {
+            self.size = 4
+            self.reserved = 0
+        }
+    }
+}

Sources/SMBTypes/SMB2FileOperation.swift

@@ -0,0 +1,228 @@
+//
+//  SMB2FileOperation.swift
+//  ExtDownloader
+//
+//  Created by Amir Abbas Mousavian on 4/30/95.
+//  Copyright © 1395 Mousavian. All rights reserved.
+//
+
+import Foundation
+
+extension SMB2 {
+    // MARK: SMB2 Read
+    
+    struct ReadRequest: SMBRequestBody {
+        let size: UInt16
+        fileprivate let padding: UInt8
+        let flags: ReadRequest.Flags
+        let length: UInt32
+        let offset: UInt64
+        let fileId: FileId
+        let minimumLength: UInt32
+        fileprivate let _channel: UInt32
+        var channel: Channel {
+            return Channel(rawValue: _channel) ?? .NONE
+        }
+        let remainingBytes: UInt32
+        fileprivate let channelInfoOffset: UInt16
+        fileprivate let channelInfoLength: UInt16
+        fileprivate let channelBuffer: UInt8
+        
+        init (fileId: FileId, offset: UInt64, length: UInt32, flags: ReadRequest.Flags = [], minimumLength: UInt32 = 0, remainingBytes: UInt32 = 0, channel: Channel = .NONE) {
+            self.size = 49
+            self.padding = 0
+            self.flags = flags
+            self.length = length
+            self.offset = offset
+            self.fileId = fileId
+            self.minimumLength = minimumLength
+            self._channel = channel.rawValue
+            self.remainingBytes = remainingBytes
+            self.channelInfoOffset = 0
+            self.channelInfoLength = 0
+            self.channelBuffer = 0
+        }
+        
+        struct Flags: OptionSet {
+            let rawValue: UInt8
+            
+            init(rawValue: UInt8) {
+                self.rawValue = rawValue
+            }
+            
+            static let UNBUFFERED = Flags(rawValue: 0x01)
+        }
+    }
+    
+    struct ReadRespone: SMBResponseBody {
+        struct Header {
+            let size: UInt16
+            let offset: UInt8
+            fileprivate let reserved: UInt8
+            let length: UInt32
+            let remaining: UInt32
+            fileprivate let reserved2: UInt32
+            
+        }
+        let header: ReadRespone.Header
+        let buffer: Data
+        
+        init?(data: Data) {
+            guard data.count > 16 else {
+                return nil
+            }
+            self.header = data.scanValue()!
+            let headersize = MemoryLayout<Header>.size
+            self.buffer = data.subdata(in: headersize..<data.count)
+        }
+    }
+    
+    enum Channel: UInt32 {
+        case NONE                   = 0x00000000
+        case RDMA_V1                = 0x00000001
+        case RDMA_V1_INVALIDATE     =  0x00000002
+    }
+    
+    // MARK: SMB2 Write
+    
+    struct WriteRequest: SMBRequestBody {
+        let header: WriteRequest.Header
+        let channelInfo: ChannelInfo?
+        let fileData: Data
+        
+        struct Header {
+            let size: UInt16
+            let dataOffset: UInt16
+            let length: UInt32
+            let offset: UInt64
+            let fileId: FileId
+            fileprivate let _channel: UInt32
+            var channel: Channel {
+                return Channel(rawValue: _channel) ?? .NONE
+            }
+            let remainingBytes: UInt32
+            let channelInfoOffset: UInt16
+            let channelInfoLength: UInt16
+            let flags: WriteRequest.Flags
+        }
+        
+        // codebeat:disable[ARITY]
+        init(fileId: FileId, offset: UInt64, remainingBytes: UInt32 = 0, data: Data, channel: Channel = .NONE, channelInfo: ChannelInfo? = nil, flags: WriteRequest.Flags = []) {
+            var channelInfoOffset: UInt16 = 0
+            var channelInfoLength: UInt16 = 0
+            if channel != .NONE, let _ = channelInfo {
+                channelInfoOffset = UInt16(MemoryLayout<SMB2.Header>.size + MemoryLayout<WriteRequest.Header>.size)
+                channelInfoLength = UInt16(MemoryLayout<SMB2.ChannelInfo>.size)
+            }
+            let dataOffset = UInt16(MemoryLayout<SMB2.Header>.size + MemoryLayout<WriteRequest.Header>.size) + channelInfoLength
+            self.header = WriteRequest.Header(size: UInt16(49), dataOffset: dataOffset, length: UInt32(data.count), offset: offset, fileId: fileId, _channel: channel.rawValue, remainingBytes: remainingBytes, channelInfoOffset: channelInfoOffset, channelInfoLength: channelInfoLength, flags: flags)
+            self.channelInfo = channelInfo
+            self.fileData = data
+        }
+        // codebeat:enable[ARITY]
+        
+        func data() -> Data {
+            var result = Data(value: self.header)
+            if let channelInfo = channelInfo {
+                result.append(channelInfo.data())
+            }
+            result.append(fileData)
+            return result
+        }
+        
+        struct Flags: OptionSet {
+            let rawValue: UInt32
+            
+            init(rawValue: UInt32) {
+                self.rawValue = rawValue
+            }
+            
+            static let THROUGH      = Flags(rawValue: 0x00000001)
+            static let UNBUFFERED   = Flags(rawValue: 0x00000002)
+        }
+    }
+    
+    struct WriteResponse: SMBResponseBody {
+        let size: UInt16
+        fileprivate let reserved: UInt16
+        let writtenBytes: UInt32
+        fileprivate let remaining: UInt32
+        fileprivate let channelInfoOffset: UInt16
+        fileprivate let channelInfoLength: UInt16
+    }
+    
+    struct ChannelInfo: SMBRequestBody {
+        let offset: UInt64
+        let token: UInt32
+        let length: UInt32
+    }
+    
+    // MARK: SMB2 Lock
+    
+    struct LockElement: SMBRequestBody {
+        let offset: UInt64
+        let length: UInt64
+        let flags: LockElement.Flags
+        fileprivate let reserved: UInt32
+        
+        struct Flags: OptionSet {
+            let rawValue: UInt32
+            
+            init(rawValue: UInt32) {
+                self.rawValue = rawValue
+            }
+            
+            static let SHARED_LOCK      = Flags(rawValue: 0x00000001)
+            static let EXCLUSIVE_LOCK   = Flags(rawValue: 0x00000002)
+            static let UNLOCK           = Flags(rawValue: 0x00000004)
+            static let FAIL_IMMEDIATELY = Flags(rawValue: 0x00000010)
+        }
+    }
+    
+    struct LockRequest: SMBRequestBody {
+        let header: LockRequest.Header
+        let locks: [LockElement]
+        
+        init(fileId: FileId,locks: [LockElement], lockSequenceNumber : Int8 = 0, lockSequenceIndex: UInt32 = 0) {
+            self.header = LockRequest.Header(size: 48, lockCount: UInt16(locks.count), lockSequence: UInt32(lockSequenceNumber << 28) + lockSequenceIndex, fileId: fileId)
+            self.locks = locks
+        }
+        
+        func data() -> Data {
+            var result = Data(value: header)
+            for lock in locks {
+                result.append(Data(value: lock))
+            }
+            return result
+        }
+        
+        struct Header {
+            let size: UInt16
+            fileprivate let lockCount: UInt16
+            let lockSequence: UInt32
+            let fileId : FileId
+        }
+    }
+    
+    struct LockResponse: SMBResponseBody {
+        let size: UInt16
+        let reserved: UInt16
+        
+        init() {
+            self.size = 4
+            self.reserved = 0
+        }
+    }
+    
+    // MARK: SMB2 Cancel
+    
+    struct CancelRequest: SMBRequestBody {
+        let size: UInt16
+        let reserved: UInt16
+        
+        init() {
+            self.size = 4
+            self.reserved = 0
+        }
+    }
+}

Sources/SMBTypes/SMB2IOCtl.swift

@@ -0,0 +1,356 @@
+//
+//  SMB2IOCtl.swift
+//  ExtDownloader
+//
+//  Created by Amir Abbas Mousavian on 4/30/95.
+//  Copyright © 1395 Mousavian. All rights reserved.
+//
+
+import Foundation
+
+extension SMB2 {
+    // MARK: SMB2 IOCTL
+    
+    /**
+     * IOCtl usage is usually limited in SMB to pipe requests and duplicating file inside server
+     */
+    
+    struct IOCtlRequest: SMBRequestBody {
+        let header: Header
+        let requestData:  IOCtlRequestProtocol?
+        
+        init(fileId: FileId ,ctlCode: IOCtlCode, requestData: IOCtlRequestProtocol?, flags: IOCtlRequest.Flags = []) {
+            let offset = requestData != nil ? UInt32(MemoryLayout<SMB2.Header>.size + MemoryLayout<IOCtlRequest.Header>.size) : 0
+            self.header = Header(size: 57, reserved: 0, _ctlCode: ctlCode.rawValue, fileId: fileId, inputOffset: offset, inputCount: UInt32((requestData?.data().count ?? 0)), maxInputResponse: 0, outputOffset: offset, outputCount: 0, maxOutputResponse: UInt32(Int32.max), flags: flags, reserved2: 0)
+            self.requestData = requestData
+        }
+        
+        func data() -> Data {
+            var result = Data(value: self.header)
+            if let reqData = requestData?.data() {
+                result.append(reqData)
+            }
+            return result
+        }
+        
+        struct Header {
+            let size: UInt16
+            fileprivate let reserved: UInt16
+            fileprivate let _ctlCode: UInt32
+            var ctlCode: IOCtlCode {
+                return IOCtlCode(rawValue: _ctlCode)!
+            }
+            let fileId: FileId
+            let inputOffset: UInt32
+            let inputCount: UInt32
+            let maxInputResponse: UInt32
+            let outputOffset: UInt32
+            let outputCount: UInt32
+            let maxOutputResponse: UInt32
+            let flags: IOCtlRequest.Flags
+            fileprivate let reserved2: UInt32
+        }
+        
+        struct Flags: OptionSet {
+            let rawValue: UInt32
+            
+            init(rawValue: UInt32) {
+                self.rawValue = rawValue
+            }
+            
+            static let IOCTL = Flags(rawValue: 0x00000000)
+            static let FSCTL = Flags(rawValue: 0x00000001)
+        }
+    }
+    
+    struct IOCtlResponse: SMBResponseBody {
+        let header: Header
+        let responseData:  IOCtlResponseProtocol?
+        
+        init?(data: Data) {
+            self.header = data.scanValue()!
+            let endRange = Int(self.header.outputOffset - 64) + Int(self.header.outputCount)
+            let response = data.subdata(in: Int(self.header.outputOffset - 64)..<endRange)
+            switch self.header.ctlCode {
+            case .SRV_COPYCHUNK, .SRV_COPYCHUNK_WRITE:
+                self.responseData = IOCtlResponseData.SrvCopyChunk(data: response)
+            case .SRV_ENUMERATE_SNAPSHOTS:
+                self.responseData = IOCtlResponseData.SrvSnapshots(data: response)
+            case .SRV_REQUEST_RESUME_KEY:
+                self.responseData = IOCtlResponseData.ResumeKey(data: response)
+            case .SRV_READ_HASH:
+                self.responseData = IOCtlResponseData.ReadHash(data: response)
+            case .QUERY_NETWORK_INTERFACE_INFO:
+                self.responseData = IOCtlResponseData.NetworkInterfaceInfo(data: response)
+            case .VALIDATE_NEGOTIATE_INFO:
+                self.responseData = IOCtlResponseData.ValidateNegotiateInfo(data: response)
+            default:
+                self.responseData = nil
+            }
+        }
+        
+        struct Header {
+            let size: UInt16
+            fileprivate let reserved: UInt16
+            fileprivate let _ctlCode: UInt32
+            var ctlCode: IOCtlCode {
+                return IOCtlCode(rawValue: _ctlCode)!
+            }
+            let fileId: FileId
+            let inputOffset: UInt32
+            let inputCount: UInt32
+            let outputOffset: UInt32
+            let outputCount: UInt32
+            fileprivate let flags: UInt32
+            fileprivate let reserved2: UInt32
+        }
+    }
+    
+    enum IOCtlCode: UInt32 {
+        case DFS_GET_REFERRALS              = 0x00060194
+        case DFS_GET_REFERRALS_EX           = 0x000601B0
+        case SET_REPARSE_POINT              = 0x000900A4
+        case FILE_LEVEL_TRIM                = 0x00098208
+        case PIPE_PEEK                      = 0x0011400C
+        case PIPE_WAIT                      = 0x00110018
+        /// PIPE_TRANSCEIVE is valid only on a named pipe with mode set to FILE_PIPE_MESSAGE_MODE.
+        case PIPE_TRANSCEIVE                = 0x0011C017
+        /// Get ResumeKey used by the client to uniquely identify the source file in an FSCTL_SRV_COPYCHUNK or FSCTL_SRV_COPYCHUNK_WRITE request.
+        case SRV_REQUEST_RESUME_KEY         = 0x00140078
+        /// Get all the revision time-stamps that are associated with the Tree Connect share in which the open resides
+        case SRV_ENUMERATE_SNAPSHOTS        = 0x00144064
+        /// Reads a chunk of file for performing server side copy operations.
+        case SRV_COPYCHUNK                  = 0x001440F2
+        /// Retrieve data from the Content Information File associated with a specified file, not valid for the SMB 2.0.2 dialect.
+        case SRV_READ_HASH                  = 0x001441BB
+        /// Writes the chunk of file for performing server side copy operations.
+        case SRV_COPYCHUNK_WRITE            = 0x001480F2
+        /// Request resiliency for a specified open file, not valid for the SMB 2.0.2 dialect.
+        case LMR_REQUEST_RESILIENCY         = 0x001401D4
+        /// Get server network interface info e.g. link speed and socket address information
+        case QUERY_NETWORK_INTERFACE_INFO   = 0x001401FC
+        /// Request validation of a previous SMB 2 NEGOTIATE, valid for SMB 3.0 and SMB 3.0.2 dialects.
+        case VALIDATE_NEGOTIATE_INFO        = 0x00140204
+    }
+    
+    struct IOCtlRequestData {
+        struct CopyChunk: IOCtlRequestProtocol {
+            let sourceKey: (UInt64, UInt64, UInt64)
+            let chunkCount: UInt32
+            let chunks: [Chunk]
+            
+            func data() -> Data {
+                var result = Data(value: sourceKey)
+                result.append(Data(value: chunkCount))
+                let reserved: UInt32 = 0
+                result.append(Data(value: reserved))
+                return Data()
+            }
+            
+            struct Chunk {
+                let sourceOffset: UInt64
+                let targetOffset: UInt64
+                let length: UInt32
+                fileprivate let reserved: UInt32
+            }
+        }
+        
+        struct ReadHash: IOCtlRequestProtocol {
+            let _hashType: UInt32
+            var hashType: IOCtlHashType {
+                return IOCtlHashType(rawValue: _hashType) ?? .PEER_DIST
+            }
+            let _hashVersion: UInt32
+            var hashVersion: IOCtlHashVersion {
+                return IOCtlHashVersion(rawValue: _hashVersion) ?? .VER_1
+            }
+            let _hashRetrievalType: UInt32
+            var hashRetrievalType: IOCtlHashRetrievalType {
+                return IOCtlHashRetrievalType(rawValue: _hashRetrievalType) ?? .FILE_BASED
+            }
+            let length: UInt32
+            let offset: UInt64
+            
+            init(offset: UInt64, length: UInt32, hashType: IOCtlHashType = .PEER_DIST, hashVersion: IOCtlHashVersion = .VER_1, hashRetrievalType: IOCtlHashRetrievalType = .FILE_BASED) {
+                self._hashType = hashType.rawValue
+                self._hashVersion = hashVersion.rawValue
+                self._hashRetrievalType = hashRetrievalType.rawValue
+                self.length = length
+                self.offset = offset
+            }
+        }
+        
+        struct ResilencyRequest: IOCtlRequestProtocol {
+            let timeout: UInt32
+            fileprivate let reserved: UInt32
+            
+            /// The requested time the server holds the file open after a disconnect before releasing it. This time is in milliseconds.
+            init(timeout: UInt32) {
+                self.timeout = timeout
+                self.reserved = 0
+            }
+        }
+        
+        struct ValidateNegotiateInfo: IOCtlRequestProtocol {
+            let header: ValidateNegotiateInfo.Header
+            let dialects: [UInt16]
+            
+            init(dialects: [UInt16], guid: uuid_t, capabilities: IOCtlCapabilities, securityMode: UInt16) {
+                self.header = Header(capabilities: capabilities, guid: guid, securityMode: securityMode, dialectCount: UInt16(dialects.count))
+                self.dialects = dialects
+            }
+            
+            func data() -> Data {
+                var result = Data(value: self.header)
+                dialects.forEach { result.append(Data(value: $0)) }
+                return result
+            }
+            
+            struct Header {
+                let capabilities: IOCtlCapabilities
+                /// Client's GUID
+                let guid: uuid_t
+                let securityMode: UInt16
+                let dialectCount: UInt16
+            }
+        }
+    }
+    
+    struct IOCtlResponseData {
+        // SRV_COPYCHUNK, SRV_COPYCHUNK_WRITE
+        struct SrvCopyChunk: IOCtlResponseProtocol {
+            let chunksCount: UInt32
+            let chunksBytesWritten: UInt32
+            let totalBytesWriiten: UInt32
+        }
+        
+        // SRV_ENUMERATE_SNAPSHOTS
+        struct SrvSnapshots: IOCtlResponseProtocol {
+            let count: UInt32
+            let returnedCount: UInt32
+            let snapshots: [SMBTime]
+            
+            init?(data: Data) {
+                guard data.count > 8 else { return nil }
+                self.count = data.scanValue()!
+                self.returnedCount = data.scanValue(start: 4)!
+                //let size: UInt32 = decode(data.subdataWithRange(NSRange(location: 8, length: 4)))
+                var snapshots = [SMBTime]()
+                let dateFormatter = DateFormatter()
+                dateFormatter.dateFormat = "'@GMT-'yyyy'.'MM'.'dd'-'HH'.'mm'.'ss"
+                for i in 0..<Int(returnedCount) {
+                    let offset = 24 + i * 48
+                    if data.count < offset + 48 {
+                        return nil
+                    }
+                    let datestring = data.scanString(start: offset, length: 48, encoding: .utf16)
+                    if let datestring = datestring, let date = dateFormatter.date(from: datestring) {
+                        snapshots.append(SMBTime(date: date))
+                    }
+                }
+                self.snapshots = snapshots
+            }
+        }
+        
+        struct ResumeKey: IOCtlResponseProtocol {
+            let key: (UInt64, UInt64, UInt64)
+            fileprivate let contextLength: UInt32
+            fileprivate let context: UInt32
+        }
+        
+        struct ReadHash: IOCtlResponseProtocol {
+            // TODO: Implement IOCTL READ_HASH
+        }
+        
+        struct NetworkInterfaceInfo: IOCtlResponseProtocol {
+            let items: [NetworkInterfaceInfo.Item]
+            
+            init?(data: Data) {
+                var items = [Item]()
+                var offset = 0
+                while let item: Item = data.scanValue(start: offset) {
+                    items.append(item)
+                    offset += MemoryLayout<Item>.size
+                }
+                self.items = items
+            }
+            
+            struct Item {
+                /// The offset, in bytes, from the beginning of this structure to the beginning of a subsequent 8-byte aligned network interface.
+                let next: UInt32
+                /// specifies the network interface index.
+                let ifIndex: UInt32
+                let capability: IOCtlCapabilities
+                fileprivate let reserved: UInt32
+                /// Speed of the network interface in bits per second
+                let linkSpeed: UInt64
+                fileprivate let sockaddrStorage:
+                (UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
+                UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
+                UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
+                UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
+                UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
+                UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
+                UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
+                UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
+                UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
+                UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
+                UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
+                UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
+                UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
+                UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
+                UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
+                UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8)
+                var family: sa_family_t {
+                    return sockaddrStorage.1
+                }
+                
+                static let ipv4: sa_family_t = 0x02
+                static let ipv6: sa_family_t = 0x17
+                
+                var sockaddr: sockaddr_in {
+                    return Data.mapMemory(from: self.sockaddrStorage)!
+                }
+                
+                var sockaddr6: sockaddr_in6 {
+                     return Data.mapMemory(from: self.sockaddrStorage)!
+                }
+            }
+        }
+        
+        struct ValidateNegotiateInfo: IOCtlResponseProtocol {
+            let capabilities: IOCtlCapabilities
+            let guid: uuid_t
+            let securityMode: UInt16
+            fileprivate let _dialect: UInt16
+            var dialect: (major: Int, minor: Int) {
+                return (major: Int(_dialect & 0xFF), minor: Int(_dialect >> 8))
+            }
+        }
+    }
+    
+    struct IOCtlCapabilities: OptionSet {
+        let rawValue: UInt32
+        
+        init(rawValue: UInt32) {
+            self.rawValue = rawValue
+        }
+        
+        static let RSS_CAPABLE  = IOCtlCapabilities(rawValue: 0x00000001)
+        static let RDMA_CAPABLE = IOCtlCapabilities(rawValue: 0x00000002)
+    }
+    
+    enum IOCtlHashType: UInt32 {
+        case PEER_DIST = 0x00000001
+    }
+    
+    enum IOCtlHashVersion: UInt32 {
+        case VER_1 = 0x00000001
+        case VER_2 = 0x00000002
+    }
+    
+    enum IOCtlHashRetrievalType: UInt32 {
+        case HASH_BASED = 0x00000001
+        case FILE_BASED = 0x00000002
+    }
+}

Sources/SMBTypes/SMB2Notification.swift

@@ -0,0 +1,133 @@
+//
+//  SMB2Notification.swift
+//  FileProvider
+//
+//  Created by Amir Abbas Mousavian on 5/18/95.
+//
+//
+
+import Foundation
+
+extension SMB2 {
+    // MARK: SMB2 Change Notify
+    
+    struct ChangeNotifyRequest: SMBRequestBody {
+        let size: UInt16
+        let flags: ChangeNotifyRequest.Flags
+        let outputBufferLength: UInt32
+        let fileId: FileId
+        let completionFilters: CompletionFilter
+        fileprivate let reserved: UInt32
+        
+        init(fileId: FileId, completionFilters: CompletionFilter, flags: ChangeNotifyRequest.Flags = [], outputBufferLength: UInt32 = 65535) {
+            self.size = 32
+            self.flags = flags
+            self.outputBufferLength = outputBufferLength
+            self.fileId = fileId
+            self.completionFilters = completionFilters
+            self.reserved = 0
+        }
+        
+        struct Flags: OptionSet {
+            let rawValue: UInt16
+            
+            init(rawValue: UInt16) {
+                self.rawValue = rawValue
+            }
+            
+            static let WATCH_TREE = Flags(rawValue: 0x0001)
+        }
+        
+        struct CompletionFilter: OptionSet {
+            let rawValue: UInt32
+            
+            init(rawValue: UInt32) {
+                self.rawValue = rawValue
+            }
+            
+            /// The client is notified if a file-name changes.
+            static let FILE_NAME    = CompletionFilter(rawValue: 0x00000001)
+            /// The client is notified if a directory name changes.
+            static let DIR_NAME     = CompletionFilter(rawValue: 0x00000002)
+            /// The client is notified if a file's attributes change.
+            static let ATTRIBUTES   = CompletionFilter(rawValue: 0x00000004)
+            /// The client is notified if a file's size changes.
+            static let SIZE         = CompletionFilter(rawValue: 0x00000008)
+            /// The client is notified if the last write time of a file changes.
+            static let LAST_WRITE   = CompletionFilter(rawValue: 0x00000010)
+            /// The client is notified if the last access time of a file changes.
+            static let LAST_ACCESS  = CompletionFilter(rawValue: 0x00000020)
+            /// The client is notified if the creation time of a file changes.
+            static let CREATION     = CompletionFilter(rawValue: 0x00000040)
+            /// The client is notified if a file's extended attributes (EAs) change.
+            static let EA           = CompletionFilter(rawValue: 0x00000080)
+            /// The client is notified of a file's access control list (ACL) settings change.
+            static let SECURITY     = CompletionFilter(rawValue: 0x00000100)
+            /// The client is notified if a named stream is added to a file.
+            static let STREAM_NAME  = CompletionFilter(rawValue: 0x00000200)
+            /// The client is notified if the size of a named stream is changed.
+            static let STREAM_SIZE  = CompletionFilter(rawValue: 0x00000400)
+            /// The client is notified if a named stream is modified.
+            static let STREAM_WRITE = Flags(rawValue: 0x00000800)
+            
+            static let all = CompletionFilter(rawValue: 0x00000FFF)
+            static let list: CompletionFilter = [.FILE_NAME, .DIR_NAME]
+        }
+    }
+    
+    struct ChangeNotifyResponse: SMBResponseBody {
+        let notifications: [(action: FileNotifyAction, fileName: String)]
+        
+        init?(data: Data) {
+            let maxLoop = 1000
+            var i = 0
+            var result = [(action: FileNotifyAction, fileName: String)]()
+            
+            var offset = 0
+            while i < maxLoop {
+                let nextOffset: UInt32 = data.scanValue(start: offset) ?? 0
+                let actionValue: UInt32 = data.scanValue(start: offset + 4) ?? 0
+                guard let action = FileNotifyAction(rawValue: actionValue) else {
+                    continue
+                }
+                
+                let fileNameLen = Int(data.scanValue(start: offset + 8) as UInt32? ?? 0)
+                let fileName = data.scanString(start: offset + 12, length: fileNameLen, encoding: .utf16) ?? ""
+                result.append((action: action, fileName: fileName))
+                
+                offset += Int(nextOffset)
+                if nextOffset == 0 {
+                    break
+                }
+                i += 1
+            }
+            
+            self.notifications = result
+        }
+    }
+    
+    enum FileNotifyAction: UInt32 {
+        /// The file was added to the directory.
+        case ADDED = 0x00000001
+        /// The file was removed from the directory.
+        case REMOVED = 0x00000002
+        /// The file was modified. This can be a change to the data or attributes of the file.
+        case MODIFIED = 0x00000003
+        /// The file was renamed, and this is the old name. If the new name resides outside of the directory being monitored, the client will not receive the FILE_ACTION_RENAMED_NEW_NAME bit value.
+        case RENAMED_OLD_NAME = 0x00000004
+        /// The file was renamed, and this is the new name. If the old name resides outside of the directory being monitored, the client will not receive the FILE_ACTION_RENAME_OLD_NAME bit value.
+        case RENAMED_NEW_NAME = 0x00000005
+        /// The file was added to a named stream.
+        case ADDED_STREAM = 0x00000006
+        /// The file was removed from the named stream.
+        case REMOVED_STREAM = 0x00000007
+        /// The file was modified. This can be a change to the data or attributes of the file.
+        case MODIFIED_STREAM = 0x00000008
+        /// An object ID was removed because the file the object ID referred to was deleted. This notification is only sent when the directory being monitored is the special directory "\$Extend\$ObjId:$O:$INDEX_ALLOCATION".
+        case REMOVED_BY_DELETE = 0x00000009
+        /// An attempt to tunnel object ID information to a file being created or renamed failed because the object ID is in use by another file on the same volume. This notification is only sent when the directory being monitored is the special directory "\$Extend\$ObjId:$O:$INDEX_ALLOCATION".
+        case NOT_TUNNELLED = 0x0000000A
+        /// An attempt to tunnel object ID information to a file being renamed failed because the file already has an object ID. This notification is only sent when the directory being monitored is the special directory "\$Extend\$ObjId:$O:$INDEX_ALLOCATION".
+        case TUNNELLED_ID_COLLISION = 0x0000000B
+    }
+}

Sources/SMBTypes/SMB2Query.swift

@@ -0,0 +1,325 @@
+//
+//  SMB2Query.swift
+//  ExtDownloader
+//
+//  Created by Amir Abbas Mousavian on 4/31/95.
+//  Copyright © 1395 Mousavian. All rights reserved.
+//
+
+import Foundation
+
+extension SMB2 {
+    // MARK: SMB2 Query Directory
+    
+    struct QueryDirectoryRequest: SMBRequestBody {
+        let header: QueryDirectoryRequest.Header
+        let searchPattern: String?
+        
+        /// - **bufferLength:** maximum number of bytes the server is allowed to return which is the same as maxTransactSize returned by negotiation.
+        /// - **searchPattern:** can hold wildcards or be nil if all entries should be returned.
+        /// - **fileIndex:** The byte offset within the directory, indicating the position at which to resume the enumeration.
+        init(fileId: FileId, infoClass: FileInformationEnum, flags: Flags, bufferLength: UInt32 = 65535, searchPattern: String? = nil, fileIndex: UInt32 = 0) {
+            assert(FileInformationEnum.queryDirectory.contains(infoClass), "Invalid FileInformationClass used for QueryDirectoryRequest")
+            let searchPatternOffset = searchPattern != nil ? MemoryLayout<SMB2.Header>.size + MemoryLayout<QueryDirectoryRequest.Header>.size : 0
+            let nflags = flags.intersection(fileIndex > 0 ? [.INDEX_SPECIFIED] : [])
+            let searchPatternLength = searchPattern?.data(using: .utf16)?.count ?? 0
+            self.header = Header(size: 53, infoClass: infoClass, flags: nflags, fileIndex: fileIndex, fileId: fileId, searchPatternOffset: UInt8(searchPatternOffset), searchPatternLength: UInt8(searchPatternLength), bufferLength: bufferLength)
+            self.searchPattern = searchPattern
+        }
+        
+        func data() -> Data {
+            var result = Data(value: header)
+            if let patternData = searchPattern?.data(using: .utf16) {
+                result.append(patternData)
+            }
+            return result
+        }
+        
+        struct Header {
+            let size: UInt8
+            let infoClass: FileInformationEnum
+            let flags: QueryDirectoryRequest.Flags
+            let fileIndex: UInt32
+            let fileId: FileId
+            let searchPatternOffset: UInt8
+            let searchPatternLength: UInt8
+            let bufferLength: UInt32
+        }
+        
+        struct Flags: OptionSet {
+            let rawValue: UInt8
+            
+            init(rawValue: UInt8) {
+                self.rawValue = rawValue
+            }
+            
+            static let RESTART_SCANS        = Flags(rawValue: 0x01)
+            static let RETURN_SINGLE_ENTRY  = Flags(rawValue: 0x02)
+            static let INDEX_SPECIFIED      = Flags(rawValue: 0x04)
+            static let REOPEN               = Flags(rawValue: 0x10)
+        }
+    }
+    
+    struct QueryDirectoryResponse: SMBResponseBody {
+        let buffer: Data
+        
+        func parseAs(type: FileInformationEnum) -> [(header: SMB2FilesInformationHeader, fileName: String)] {
+            var offset = 0
+            var result = [(header: SMB2FilesInformationHeader, fileName: String)]()
+            while true {
+                let header: SMB2FilesInformationHeader
+                switch type {
+                case .fileDirectoryInformation:
+                    header = buffer.scanValue(start: offset) as FileDirectoryInformationHeader!
+                case .fileFullDirectoryInformation:
+                    header = buffer.scanValue(start: offset) as FileFullDirectoryInformationHeader!
+                case .fileIdFullDirectoryInformation:
+                    header = buffer.scanValue(start: offset) as FileIdFullDirectoryInformationHeader!
+                case .fileBothDirectoryInformation:
+                    header = buffer.scanValue(start: offset) as FileBothDirectoryInformationHeader!
+                case .fileIdBothDirectoryInformation:
+                    header = buffer.scanValue(start: offset) as FileIdBothDirectoryInformationHeader!
+                case .fileNamesInformation:
+                    header = buffer.scanValue(start: offset) as FileNamesInformationHeader!
+                default:
+                    return []
+                }
+                let headersize = MemoryLayout.size(ofValue: header)
+                let fileName = buffer.scanString(start: headersize, length: Int(header.fileNameLength), encoding: .utf16) ?? ""
+                result.append((header: header, fileName: fileName))
+                if header.nextEntryOffset == 0 {
+                    break
+                }
+                offset += Int(header.nextEntryOffset)
+            }
+            return result
+        }
+        
+        init? (data: Data) {
+            let offset = Int(data.scanValue(start: 2) as UInt16!)
+            let length = Int(data.scanValue(start: 4) as UInt32!)
+            guard data.count > offset + length else {
+                return nil
+            }
+            self.buffer = data.subdata(in: offset..<(offset + length))
+        }
+    }
+    
+    // MARK: SMB2 Query Info
+    
+    struct QueryInfoRequest: SMBRequestBody {
+        let header: Header
+        let buffer: Data?
+        
+        init(fileId: FileId, infoClass: FileInformationEnum, outputBufferLength: UInt32 = 65535) {
+            self.header = Header(size: 41, infoType: 1, infoClass: infoClass.rawValue, outputBufferLength: outputBufferLength, inputBufferOffset: 0, reserved: 0, inputBufferLength: 0, additionalInformation: [], flags: [], fileId: fileId)
+            self.buffer = nil
+        }
+        
+        init(fileId: FileId, extendedAttributes: [String], flags: Flags = [], outputBufferLength: UInt32 = 65535) {
+            var buffer = Data()
+            for ea in extendedAttributes {
+                guard let strData = ea.data(using: .ascii) else {
+                    continue
+                }
+                let strLength = UInt8(strData.count)
+                let nextOffset = UInt32(4 + 1 + strData.count)
+                var data = Data(value: nextOffset)
+                data.append(Data(value: strLength))
+                data.append(strData)
+                data.count += 1
+                let padSize = (data.count) % 4
+                data.count += padSize
+                buffer.append(data as Data)
+            }
+            
+            let bufferOffset = UInt16(MemoryLayout<SMB2.Header>.size + MemoryLayout<QueryInfoRequest.Header>.size)
+            self.header = Header(size: 41, infoType: 1, infoClass: FileInformationEnum.fileFullEaInformation.rawValue, outputBufferLength: outputBufferLength, inputBufferOffset: bufferOffset, reserved: 0, inputBufferLength: UInt32(buffer.count), additionalInformation: [], flags: flags, fileId: fileId)
+            self.buffer = buffer as Data
+        }
+        
+        init(fileId: FileId, infoClass: FileSystemInformationEnum, outputBufferLength: UInt32 = 65535) {
+            self.header = Header(size: 41, infoType: 2, infoClass: infoClass.rawValue, outputBufferLength: outputBufferLength, inputBufferOffset: 0, reserved: 0, inputBufferLength: 0, additionalInformation: [], flags: [], fileId: fileId)
+            self.buffer = nil
+        }
+        
+        init(fileId: FileId, securityInfo: FileSecurityInfo, outputBufferLength: UInt32 = 65535) {
+            self.header = Header(size: 41, infoType: 3, infoClass: 0, outputBufferLength: outputBufferLength, inputBufferOffset: 0, reserved: 0, inputBufferLength: 0, additionalInformation: securityInfo, flags: [], fileId: fileId)
+            self.buffer = nil
+        }
+        
+        // TODO: Implement QUOTA_INFO init
+        
+        func data() -> Data {
+            var result = Data(value: header)
+            if let buffer = buffer {
+                result.append(buffer)
+            }
+            return result
+        }
+        
+        struct Header {
+            let size: UInt16
+            let infoType: UInt8
+            let infoClass: UInt8
+            let outputBufferLength: UInt32
+            let inputBufferOffset: UInt16
+            fileprivate let reserved: UInt16
+            let inputBufferLength: UInt32
+            let additionalInformation: FileSecurityInfo
+            let flags: QueryInfoRequest.Flags
+            let fileId: FileId
+        }
+        
+        struct Flags: OptionSet {
+            let rawValue: UInt32
+            
+            init(rawValue: UInt32) {
+                self.rawValue = rawValue
+            }
+            
+            static let RESTART_SCAN         = Flags(rawValue: 0x00000001)
+            static let RETURN_SINGLE_ENTRY  = Flags(rawValue: 0x00000002)
+            static let INDEX_SPECIFIED      = Flags(rawValue: 0x00000004)
+        }
+    }
+    
+    struct QueryInfoResponse: SMBResponseBody {
+        let buffer: Data
+        
+        init?(data: Data) {
+            let structSize: UInt16 = data.scanValue()!
+            guard structSize == 9 else {
+                return nil
+            }
+            
+            /*let offsetData = data.subdataWithRange(NSRange(location: 2, length: 2))
+            let offset: UInt16 = decode(offsetData)*/
+            
+            let length = Int(data.scanValue(start: 4) as UInt32!)
+            
+            guard data.count >= 8 + length else {
+                return nil
+            }
+            
+            self.buffer = data.subdata(in: 8..<(8 + length))
+        }
+        
+        var asAccessInformation: FileAccessInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asAlignmentInformation: FileAlignmentInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asAllInformation: (header: FileAllInformationHeader, name: String) {
+            let header: FileAllInformationHeader = buffer.scanValue()!
+            let headersize = MemoryLayout<FileAllInformationHeader>.size
+            let name = buffer.scanString(start: headersize, length: Int(header.nameLength), encoding: .utf16) ?? ""
+            return (header, name)
+        }
+        
+        var asAlternateNameInformation: String {
+            return buffer.scanString(start: 0, length: buffer.count, encoding: .utf16) ?? ""
+        }
+        
+        var asAttributeTagInformation: FileAttributeTagInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asBasicInformation: FileBasicInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asCompressionInformation: FileCompressionInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asEaInformation: FileEaInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asFullEaInformation: FileFullEaInformation {
+            // TODO:
+            return FileFullEaInformation()
+        }
+        
+        var asInternalInformation: FileInternalInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asModeInformation: FileModeInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asNetworkOpenInformation: FileNetworkOpenInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asPipeInformation: FilePipeInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asPipeLocalInformation: FilePipeLocalInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asPipeRemoteInformation: FilePipeRemoteInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asPositionInformation: FilePositionInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asStandardInformation: FileStandardInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asStreamInformation: (header: FileStreamInformationHeader, name: String) {
+            let header: FileStreamInformationHeader = buffer.scanValue()!
+            let headersize = MemoryLayout<FileStreamInformationHeader>.size
+            let name = buffer.scanString(start: headersize, length: Int(header.streamNameLength), encoding: .utf16) ?? ""
+            return (header, name)
+        }
+        
+        var asFsVolumeInformation: (header: FileFsVolumeInformationHeader, name: String) {
+            let header: FileFsVolumeInformationHeader = buffer.scanValue()!
+            let headersize = MemoryLayout<FileFsVolumeInformationHeader>.size
+            let name = buffer.scanString(start: headersize, length: Int(header.labelLength), encoding: .utf16) ?? ""
+            return (header, name)
+        }
+        
+        var asFsSizeInformation: FileFsSizeInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asFsDeviceInformation: FileFsDeviceInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asFsAttributeInformation: (header: FileFsAttributeInformationHeader, name: String) {
+            let header: FileFsAttributeInformationHeader = buffer.scanValue()!
+            let headersize = MemoryLayout<FileFsAttributeInformationHeader>.size
+            let name = buffer.scanString(start: headersize, length: Int(header.nameLength), encoding: .utf16) ?? ""
+            return (header, name)
+        }
+        
+        var asFsControlInformation: FileFsControlInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asFsFullSizeInformation: FileFsFullSizeInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asFsObjectIdInformation: FileFsObjectIdInformation {
+            return buffer.scanValue()!
+        }
+        
+        var asFsSectorSizeInformation: FileFsSectorSizeInformation {
+            return buffer.scanValue()!
+        }
+    }
+}

Sources/SMBTypes/SMB2QueryTypes.swift

@@ -0,0 +1,597 @@
+//
+//  SMB2QueryTypes.swift
+//  FileProvider
+//
+//  Created by Amir Abbas Mousavian on 5/19/95.
+//
+//
+
+import Foundation
+
+protocol SMB2FilesInformationHeader: SMBResponseBody {
+    var nextEntryOffset: UInt32 { get }
+    var fileIndex: UInt32 { get }
+    var fileNameLength : UInt32 { get }
+}
+
+extension SMB2 {
+    enum FileInformationEnum: UInt8 {
+        case none = 0x00
+        case fileDirectoryInformation = 0x01
+        case fileFullDirectoryInformation = 0x02
+        case fileBothDirectoryInformation = 0x03
+        case fileBasicInformation = 0x04
+        case fileStandardInformation = 0x05
+        case fileInternalInformation = 0x06
+        case fileEaInformation = 0x07
+        case fileAccessInformation = 0x08
+        case fileNameInformation = 0x09
+        case fileRenameInformation = 0x0A
+        case fileLinkInformation = 0x0B
+        case fileNamesInformation = 0x0C
+        case fileDispositionInformation = 0x0D
+        case filePositionInformation = 0x0E
+        case fileFullEaInformation = 0x0F
+        case fileModeInformation = 0x10
+        case fileAlignmentInformation = 0x11
+        case fileAllInformation = 0x12
+        case fileAllocationInformation = 0x13
+        case fileEndOfFileInformation = 0x14
+        case fileAlternateNameInformation = 0x15
+        case fileStreamInformation = 0x16
+        case filePipeInformation = 0x17
+        case filePipeLocalInformation = 0x18
+        case filePipeRemoteInformation = 0x19
+        case fileMailslotQueryInformation = 0x1A
+        case fileMailslotSetInformation = 0x1B
+        case fileCompressionInformation = 0x1C
+        case fileObjectIdInformation = 0x1D
+        case fileCompletionInformation = 0x1E
+        case fileMoveClusterInformation = 0x1F
+        case fileQuotaInformation = 0x20
+        case fileReparsePointInformation = 0x21
+        case fileNetworkOpenInformation = 0x22
+        case fileAttributeTagInformation = 0x23
+        case fileTrackingInformation = 0x24
+        case fileIdBothDirectoryInformation = 0x25
+        case fileIdFullDirectoryInformation = 0x26
+        case fileValidDataLengthInformation = 0x27
+        case fileShortNameInformation = 0x28
+        case fileIoCompletionNotificationInformation = 0x29
+        case fileIoStatusBlockRangeInformation = 0x2A
+        case fileIoPriorityHintInformation = 0x2B
+        case fileSfioReserveInformation = 0x2C
+        case fileSfioVolumeInformation = 0x2D
+        case fileHardLinkInformation = 0x2E
+        case fileProcessIdsUsingFileInformation = 0x2F
+        case fileNormalizedNameInformation = 0x30
+        case fileNetworkPhysicalNameInformation = 0x31
+        case fileIdGlobalTxDirectoryInformation = 0x32
+        case fileIsRemoteDeviceInformation = 0x33
+        case fileUnusedInformation = 0x34
+        case fileNumaNodeInformation = 0x35
+        case fileStandardLinkInformation = 0x36
+        case fileRemoteProtocolInformation = 0x37
+        case fileRenameInformationBypassAccessCheck = 0x38
+        case fileLinkInformationBypassAccessCheck = 0x39
+        case fileVolumeNameInformation = 0x3A
+        case fileIdInformation = 0x3B
+        case fileIdExtdDirectoryInformation = 0x3C
+        case fileReplaceCompletionInformation = 0x3D
+        case fileHardLinkFullIdInformation = 0x3E
+        case fileIdExtdBothDirectoryInformation = 0x3F
+        case fileMaximumInformation = 0x40
+        
+        static let  queryDirectory: [FileInformationEnum] = [.fileDirectoryInformation, .fileFullDirectoryInformation, .fileIdFullDirectoryInformation, .fileBothDirectoryInformation, .fileIdBothDirectoryInformation, .fileNamesInformation]
+        
+        static let queryInfoFile: [FileInformationEnum] = [.fileAccessInformation, .fileAlignmentInformation, .fileAllInformation, .fileAlternateNameInformation, .fileAttributeTagInformation, .fileBasicInformation, .fileCompressionInformation, fileEaInformation, .fileFullEaInformation, .fileInternalInformation, .fileModeInformation, .fileNetworkOpenInformation, .filePipeInformation, .filePipeLocalInformation, .filePipeRemoteInformation, .filePositionInformation, .fileStandardInformation, .fileStreamInformation]
+    }
+    
+    enum FileSystemInformationEnum: UInt8 {
+        case none = 0
+        case fileFsAttributeInformation
+        case fileFsControlInformation
+        case fileFsDeviceInformation
+        case fileFsFullSizeInformation
+        case fileFsObjectIdInformation
+        case fileFsSectorSizeInformation
+        case fileFsSizeInformation
+        case fileFsVolumeInformation
+    }
+    
+    struct FileSecurityInfo: OptionSet {
+        let rawValue: UInt32
+        
+        init(rawValue: UInt32) {
+            self.rawValue = rawValue
+        }
+        
+        static let OWNER        = FileSecurityInfo(rawValue: 0x00000001)
+        static let GROUP        = FileSecurityInfo(rawValue: 0x00000002)
+        static let DACL         = FileSecurityInfo(rawValue: 0x00000004)
+        static let SACL         = FileSecurityInfo(rawValue: 0x00000008)
+        static let LABEL        = FileSecurityInfo(rawValue: 0x00000010)
+        static let ATTRIBUTE    = FileSecurityInfo(rawValue: 0x00000020)
+        static let SCOPE        = FileSecurityInfo(rawValue: 0x00000040)
+        static let BACKUP       = FileSecurityInfo(rawValue: 0x00010000)
+    }
+    
+    struct FileDirectoryInformationHeader: SMB2FilesInformationHeader {
+        let nextEntryOffset: UInt32
+        let fileIndex: UInt32
+        let creationTime: SMBTime
+        let lastAccesTime: SMBTime
+        let lastWriteTime: SMBTime
+        let changeTime: SMBTime
+        let fileSize: UInt64
+        let allocationSize: UInt64
+        let fileAttributes: FileAttributes
+        let fileNameLength : UInt32
+    }
+    
+    struct FileFullDirectoryInformationHeader: SMB2FilesInformationHeader {
+        let nextEntryOffset: UInt32
+        let fileIndex: UInt32
+        let creationTime: SMBTime
+        let lastAccesTime: SMBTime
+        let lastWriteTime: SMBTime
+        let changeTime: SMBTime
+        let fileSize: UInt64
+        let allocationSize: UInt64
+        let fileAttributes: FileAttributes
+        let fileNameLength : UInt32
+        let extendedAttributesSize: UInt32
+    }
+    
+    struct FileIdFullDirectoryInformationHeader: SMB2FilesInformationHeader {
+        let nextEntryOffset: UInt32
+        let fileIndex: UInt32
+        let creationTime: SMBTime
+        let lastAccesTime: SMBTime
+        let lastWriteTime: SMBTime
+        let changeTime: SMBTime
+        let fileSize: UInt64
+        let allocationSize: UInt64
+        let fileAttributes: FileAttributes
+        let fileNameLength : UInt32
+        let extendedAttributesSize: UInt32
+        fileprivate let reserved: UInt32
+        let fileId: FileId
+    }
+    
+    struct FileBothDirectoryInformationHeader: SMB2FilesInformationHeader {
+        let nextEntryOffset: UInt32
+        let fileIndex: UInt32
+        let creationTime: SMBTime
+        let lastAccesTime: SMBTime
+        let lastWriteTime: SMBTime
+        let changeTime: SMBTime
+        let fileSize: UInt64
+        let allocationSize: UInt64
+        let fileAttributes: FileAttributes
+        let fileNameLength : UInt32
+        let extendedAttributesSize: UInt32
+        fileprivate let shortNameLen: UInt8
+        fileprivate let reserved: UInt8
+        fileprivate let _shortName: FileShortNameType
+        var shortName: String? {
+            var data = Data(value: _shortName)
+            data.count = Int(shortNameLen)
+            return String(data: data, encoding: .utf16)
+        }
+    }
+    
+    struct FileIdBothDirectoryInformationHeader: SMB2FilesInformationHeader {
+        let nextEntryOffset: UInt32
+        let fileIndex: UInt32
+        let creationTime: SMBTime
+        let lastAccesTime: SMBTime
+        let lastWriteTime: SMBTime
+        let changeTime: SMBTime
+        let fileSize: Int64
+        let allocationSize: Int64
+        let fileAttributes: FileAttributes
+        let fileNameLength : UInt32
+        let extendedAttributesSize: UInt32
+        fileprivate let shortNameLen: UInt8
+        fileprivate let reserved: UInt8
+        fileprivate let _shortName: FileShortNameType
+        var shortName: String? {
+            var data = Data(value: _shortName)
+            data.count = Int(shortNameLen)
+            return String(data: data, encoding: .utf16)
+        }
+        fileprivate let reserved2: UInt16
+        let fileId : FileId
+    }
+    
+    struct FileNamesInformationHeader: SMB2FilesInformationHeader {
+        let nextEntryOffset: UInt32
+        let fileIndex: UInt32
+        let fileNameLength : UInt32
+    }
+    
+    typealias FileShortNameType = (UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
+        UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
+        UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8)
+    
+    struct FileAccessInformation {
+        let accessMask: FileAccessMask
+    }
+    
+    struct FileAlignmentInformation {
+        fileprivate let _alignment: UInt32
+        var alignmentLength: UInt32 {
+            return _alignment + 1
+        }
+    }
+    
+    struct FileAllInformationHeader {
+        let basic: FileBasicInformation
+        let standard: FileStandardInformation
+        let `internal`: FileInternalInformation
+        let ea: FileEaInformation
+        let access: FileAccessInformation
+        let position: FilePositionInformation
+        let mode: FileModeInformation
+        let alignment: FileAlignmentInformation
+        let nameLength: UInt32
+    }
+        
+    struct FileAttributeTagInformation {
+        let fileAttributes: FileAttributes
+        let reparseTag: UInt32
+    }
+    
+    struct FileBasicInformation {
+        let creationTime: SMBTime
+        let lastAccesTime: SMBTime
+        let lastWriteTime: SMBTime
+        let changeTime: SMBTime
+        let fileAttributes: FileAttributes
+        fileprivate let reserved: UInt32 = 0
+    }
+    
+    struct FileCompressionInformation {
+        let compressedFileSize: Int64
+        let compressionFormat: UInt16
+        static let COMPRESSION_FORMAT_LZNT1 = 0x0002
+        let compressionUnitShift: UInt8
+        let chunkShift: UInt8
+        let clusterShift: UInt8
+        fileprivate let reserved: (UInt8, UInt16)
+    }
+    
+    struct FileEaInformation {
+        let eaSize: UInt32
+    }
+    
+    struct FileFullEaInformation {
+        // TODO
+    }
+    
+    struct FileInternalInformation {
+        let indexNumber: UInt64
+    }
+    
+    struct FileModeInformation {
+        let mode: Mode
+        
+        struct Mode: OptionSet {
+            let rawValue: UInt32
+            
+            init(rawValue: UInt32) {
+                self.rawValue = rawValue
+            }
+            
+            static let FILE_WRITE_THROUGH               = Mode(rawValue: 0x00000002)
+            static let FILE_SEQUENTIAL_ONLY             = Mode(rawValue: 0x00000004)
+            static let FILE_NO_INTERMEDIATE_BUFFERING   = Mode(rawValue: 0x00000008)
+            static let FILE_SYNCHRONOUS_IO_ALERT        = Mode(rawValue: 0x00000010)
+            static let FILE_SYNCHRONOUS_IO_NONALERT     = Mode(rawValue: 0x00000020)
+            static let FILE_DELETE_ON_CLOSE             = Mode(rawValue: 0x00001000)
+        }
+    }
+    
+    struct FileNetworkOpenInformation {
+        let creationTime: SMBTime
+        let lastAccesTime: SMBTime
+        let lastWriteTime: SMBTime
+        let changeTime: SMBTime
+        let fileAttributes: FileAttributes
+        fileprivate let reserved: UInt32
+    }
+    
+    struct FilePipeInformation {
+        fileprivate let _readMode: UInt32
+        var readMode: ReadMode {
+            return ReadMode(rawValue: _readMode) ?? .BYTE_STREAM_MODE
+        }
+        fileprivate let _completionMode: UInt32
+        var completionMode: CompletionMode {
+            return CompletionMode(rawValue: _completionMode) ?? .QUEUE_OPERATION
+        }
+        
+        enum ReadMode: UInt32 {
+            case BYTE_STREAM_MODE   = 0x00000000
+            case MESSAGE_MODE       = 0x00000001
+        }
+        
+        enum CompletionMode: UInt32 {
+            case QUEUE_OPERATION    = 0x00000000
+            case COMPLETE_OPERATION = 0x00000001
+        }
+    }
+    
+    struct FilePipeLocalInformation {
+        fileprivate let _namedPipeType: UInt32
+        var namedPipeType: Type {
+            return Type(rawValue: _namedPipeType) ?? .BYTE_STREAM_TYPE
+        }
+        fileprivate let _namedPipeConfiguration: UInt32
+        var namedPipeConfiguration: Configuration {
+            return Configuration(rawValue: _namedPipeConfiguration) ?? .INBOUND
+        }
+        let maximumInstances: UInt32
+        let currentInstances: UInt32
+        let inboundQuota: UInt32
+        let readDataAvailable: UInt32
+        let outboundQuota: UInt32
+        let writeQuotaAvailable: UInt32
+        fileprivate let _namedPipeState: UInt32
+        var namedPipeState: State {
+            return State(rawValue: _namedPipeState) ?? .DISCONNECTED_STATE
+        }
+        fileprivate let _namedPipeEnd: UInt32
+        var namedPipeEnd: End {
+            return End(rawValue: _namedPipeEnd) ?? .CLIENT_END
+        }
+        
+        enum `Type`: UInt32 {
+            case BYTE_STREAM_TYPE   = 0x00000000
+            case MESSAGE_TYPE       = 0x00000001
+        }
+        
+        enum Configuration: UInt32 {
+            case INBOUND        = 0x00000000
+            case OUTBOUND       = 0x00000001
+            case FULL_DUPLEX    = 0x00000002
+        }
+        
+        enum State: UInt32 {
+            case DISCONNECTED_STATE = 0x00000001
+            case LISTENING_STATE    = 0x00000002
+            case CONNECTED_STATE    = 0x00000003
+            case CLOSING_STATE      = 0x00000004
+        }
+        
+        enum End: UInt32 {
+            case CLIENT_END = 0x00000000
+            case SERVER_END = 0x00000001
+        }
+    }
+    
+    struct FilePipeRemoteInformation {
+        let collectDataTime: SMBTime
+        let maximumCollectionCount: UInt32
+    }
+    
+    struct FilePositionInformation {
+        let currentByteOffset: Int64
+    }
+    
+    struct FileStandardInformation {
+        let allocationSize: Int64
+        let fileSize: Int64
+        let numberOfLinks: UInt32
+        let deletePending: Bool
+        let directory: Bool
+        fileprivate let reserved: UInt16
+    }
+    
+    struct FileStreamInformationHeader {
+        let nextEntryOffset: UInt32
+        let streamNameLength: UInt32
+        let streamSize: Int64
+        let streamAllocationSize: Int64
+    }
+    
+    struct FileFsVolumeInformationHeader {
+        let creationTime: SMBTime
+        let serial: UInt32
+        let labelLength: UInt32
+        let supportObjects: Bool
+        let reserved: UInt8
+    }
+    
+    struct FileFsSizeInformation {
+        let totalAllocationUnits: Int64
+        let availableAllocationUnits: Int64
+        let sectorsPerAllocationUnit: UInt32
+        let bytesPerSector: UInt32
+    }
+    
+    struct FileFsDeviceInformation {
+        fileprivate let _deviceType: UInt32
+        var deviceType: DeviceType {
+            return DeviceType(rawValue: _deviceType) ?? .DISK
+        }
+        let charactristics: Charactristics
+        
+        enum DeviceType: UInt32 {
+            case CD_ROM = 0x00000002
+            case DISK = 0x00000007
+        }
+        
+        struct Charactristics: OptionSet {
+            let rawValue: UInt32
+            
+            init(rawValue: UInt32) {
+                self.rawValue = rawValue
+            }
+            
+            /// Storage device supports removable media. For example, drivers for JAZ drive devices specify this characteristic, but drivers for PCMCIA flash disks do not.
+            static let REMOVABLE_MEDIA  = Charactristics(rawValue: 0x00000001)
+            /// Indicates that the device cannot be written to.
+            static let READ_ONLY_DEVICE = Charactristics(rawValue: 0x00000002)
+            /// Indicates that the device is a floppy disk device.
+            static let FLOPPY_DISKETTE = Charactristics(rawValue: 0x00000004)
+            /// Indicates that the device supports write-once media.
+            static let WRITE_ONCE_MEDIA = Charactristics(rawValue: 0x00000008)
+            /// ndicates that the volume is for a remote file system like SMB or CIFS.
+            static let REMOTE_DEVICE  = Charactristics(rawValue: 0x00000010)
+            /// Indicates that a file system is mounted on the device.
+            static let DEVICE_IS_MOUNTED = Charactristics(rawValue: 0x00000020)
+            /// Indicates that the volume does not directly reside on storage media, but resides on some other type of media (memory for example).
+            static let VIRTUAL_VOLUME = Charactristics(rawValue: 0x00000040)
+            /// By default, volumes do not check the ACL associated with the volume, but instead use the ACLs associated with individual files on the volume. When this flag is set the volume ACL is also checked.
+            static let DEVICE_SECURE_OPEN = Charactristics(rawValue: 0x00000100)
+            /// Indicates that the device object is part of a Terminal Services device stack.
+            static let TS_DEVICE = Charactristics(rawValue: 0x00001000)
+            /// ndicates that a web-based Distributed Authoring and Versioning (WebDAV) file system is mounted on the device.
+            static let WEBDAV_DEVICE = Charactristics(rawValue: 0x00002000)
+            /// The IO Manager normally performs a full security check for traverse access on every file open when the client is an appcontainer.  Setting of this flag bypasses this enforced traverse access check if the client token already has traverse privileges.
+            static let PORTABLE_DEVICE = Charactristics(rawValue: 0x0004000)
+            /// Indicates that the given device resides on a portable bus like USB or Firewire and that the entire device (not just the media) can be removed from the system.
+            static let DEVICE_ALLOW_APPCONTAINER_TRAVERSAL = Charactristics(rawValue: 0x00020000)
+        }
+    }
+    
+    struct FileFsAttributeInformationHeader {
+        let attributes: Attributes
+        let maximumFileNameLength: Int32
+        let nameLength: UInt32
+        
+        struct Attributes: OptionSet {
+            let rawValue: UInt32
+            
+            init(rawValue: UInt32) {
+                self.rawValue = rawValue
+            }
+            
+            /// The file system supports case-sensitive file names when looking up (searching for) file names in a directory.
+            static let CASE_SENSITIVE_SEARCH = Attributes(rawValue: 0x00000001)
+            /// The file system preserves the case of file names when it places a name on disk.
+            static let CASE_PRESERVED_NAMES = Attributes(rawValue: 0x00000002)
+            /// The file system supports Unicode in file and directory names. This flag applies only to file and directory names; the file system neither restricts nor interprets the bytes of data within a file.
+            static let UNICODE_ON_DISK = Attributes(rawValue: 0x00000004)
+            /// The file system preserves and enforces access control lists (ACLs).
+            static let PERSISTENT_ACLS = Attributes(rawValue: 0x00000008)
+            /// The file volume supports file-based compression. This flag is incompatible with the FILE_VOLUME_IS_COMPRESSED flag.
+            static let FILE_COMPRESSION = Attributes(rawValue: 0x00000010)
+            /// The file system supports per-user quotas.
+            static let VOLUME_QUOTAS = Attributes(rawValue: 0x00000020)
+            /// The file system supports sparse files.
+            static let SUPPORTS_SPARSE_FILES = Attributes(rawValue: 0x00000040)
+            /// The file system supports reparse points.
+            static let SUPPORTS_REPARSE_POINTS = Attributes(rawValue: 0x00000080)
+            /// The file system supports remote storage.
+            static let REMOTE_STORAGE = Attributes(rawValue: 0x00000100)
+            /// The specified volume is a compressed volume. This flag is incompatible with the FILE_FILE_COMPRESSION flag.
+            static let IS_COMPRESSED = Attributes(rawValue: 0x00008000)
+            /// The file system supports object identifiers.
+            static let OBJECT_IDS = Attributes(rawValue: 0x00010000)
+            /// The file system supports the Encrypted File System (EFS).
+            static let ENCRYPTION = Attributes(rawValue: 0x00020000)
+            /// The file system supports named streams. (aka. Resource Fork on MacOS)
+            static let NAMED_STREAMS = Attributes(rawValue: 0x00040000)
+            /// If set, the volume has been mounted in read-only mode.
+            static let READ_ONLY_VOLUME = Attributes(rawValue: 0x00080000)
+            /// The underlying volume is write once. (aka tapes)
+            static let SEQUENTIAL_WRITE_ONCE = Attributes(rawValue: 0x00100000)
+            /// The volume supports transactions.
+            static let SUPPORTS_TRANSACTIONS = Attributes(rawValue: 0x00200000)
+            /// The file system supports hard linking files.
+            static let SUPPORTS_HARD_LINKS = Attributes(rawValue: 0x00400000)
+            /// The file system persistently stores Extended Attribute information per file.
+            static let SUPPORTS_EXTENDED_ATTRIBUTES = Attributes(rawValue: 0x00800000)
+            /// The file system supports opening a file by FileID or ObjectID.
+            static let SUPPORTS_OPEN_BY_FILE_ID = Attributes(rawValue: 0x01000000)
+            /// The file system implements a USN change journal.
+            static let USN_JOURNAL = Attributes(rawValue: 0x02000000)
+            /// The file system supports integrity streams.
+            static let SUPPORT_INTEGRITY_STREAMS = Attributes(rawValue: 0x04000000)
+            /// The file system supports sharing logical clusters between files on the same volume. The file system reallocates on writes to shared clusters. Indicates that FSCTL_DUPLICATE_EXTENTS_TO_FILE is a supported operation.
+            static let SUPPORTS_BLOCK_REFCOUNTING = Attributes(rawValue: 0x08000000)
+            /// The file system tracks whether each cluster of a file contains valid data (either from explicit file writes or automatic zeros) or invalid data (has not yet been written to or zeroed).
+            static let SUPPORTS_SPARSE_VDL = Attributes(rawValue: 0x10000000)
+        }
+    }
+    
+    struct FileFsControlInformation {
+        let freeSpaceStartFiltering: Int64
+        let freeSpaceThreshold: Int64
+        let freeSpaceStopFiltering: Int64
+        let defaultQuotaThreshold: UInt64
+        let defaultQuotaLimit: UInt64
+        let flags: Flags
+        fileprivate let padding: UInt32 = 0
+        
+        struct Flags: OptionSet {
+            let rawValue: UInt32
+            
+            init(rawValue: UInt32) {
+                self.rawValue = rawValue
+            }
+            
+            /// Quotas are tracked on the volume, but they are not enforced. Tracked quotas enable reporting on the file system space used by system users. If both this flag and FILE_VC_QUOTA_ENFORCE are specified, FILE_VC_QUOTA_ENFORCE is ignored.
+            static let QUOTA_TRACK = Flags(rawValue: 0x00000001)
+            /// Quotas are tracked and enforced on the volume.
+            static let QUOTA_ENFORCE = Flags(rawValue: 0x00000002)
+            /// Content indexing is disabled.
+            static let CONTENT_INDEX_DISABLED = Flags(rawValue: 0x00000008)
+            /// An event log entry will be created when the user exceeds his or her assigned quota warning threshold.
+            static let LOG_QUOTA_THRESHOLD = Flags(rawValue: 0x00000010)
+            /// An event log entry will be created when the user exceeds the assigned disk quota limit.
+            static let LOG_QUOTA_LIMIT = Flags(rawValue: 0x00000020)
+            /// An event log entry will be created when the volume's free space threshold is exceeded.
+            static let LOG_VOLUME_THRESHOLD = Flags(rawValue: 0x00000040)
+            /// An event log entry will be created when the volume's free space limit is exceeded.
+            static let LOG_VOLUME_LIMIT = Flags(rawValue: 0x00000080)
+            /// The quota information for the volume is incomplete because it is corrupt, or the system is in the process of rebuilding the quota information.
+            static let QUOTAS_INCOMPLETE = Flags(rawValue: 0x00000100)
+            /// The file system is rebuilding the quota information for the volume.
+            static let QUOTAS_REBUILDING = Flags(rawValue: 0x00000200)
+        }
+    }
+    
+    struct FileFsFullSizeInformation {
+        let totalAllocationUnits: Int64
+        let callerAvailableAllocationUnits: Int64
+        let actualAvailableAllocationUnits: Int64
+        let sectorsPerAllocationUnit: UInt32
+        let bytesPerSector: UInt32
+    }
+    
+    struct FileFsObjectIdInformation {
+        let objectId: uuid_t
+        let extendedInfo: (UInt64, UInt64, UInt64, UInt64, UInt64, UInt64)
+    }
+    
+    struct FileFsSectorSizeInformation {
+        let logicalBytesPerSector: UInt32
+        let physicalBytesPerSectorForAtomicity: UInt32
+        let physicalBytesPerSectorForPerformance: UInt32
+        let effectivePhysicalBytesPerSectorForAtomicity: UInt32
+        let flags: Flags
+        let byteOffsetForSectorAlignment: UInt32
+        let byteOffsetForPartitionAlignment: UInt32
+        
+        struct Flags: OptionSet {
+            let rawValue: UInt32
+            
+            init(rawValue: UInt32) {
+                self.rawValue = rawValue
+            }
+            
+            /// When set, this flag indicates that the first physical sector of the device is aligned with the first logical sector. When not set, the first physical sector of the device is misaligned with the first logical sector.
+            static let ALIGNED_DEVICE = Flags(rawValue: 0x00000001)
+            /// When set, this flag indicates that the partition is aligned to physical sector boundaries on the storage device.
+            static let PARTITION_ALIGNED_ON_DEVICE = Flags(rawValue: 0x00000002)
+            /// When set, the device reports that it does not incur a seek penalty (this typically indicates that the device does not have rotating media, such as flash-based disks).
+            static let NO_SEEK_PENALTY = Flags(rawValue: 0x00000008)
+            /// When set, the device supports TRIM operations, either T13 (ATA) TRIM or T10 (SCSI/SAS) UNMAP.
+            static let TRIM_ENABLED = Flags(rawValue: 0x00000010)
+        }
+    }
+}

Sources/SMBTypes/SMB2Session.swift

@@ -0,0 +1,311 @@
+//
+//  SMB2NegotiationTypes.swift
+//  ExtDownloader
+//
+//  Created by Amir Abbas Mousavian on 4/30/95.
+//  Copyright © 1395 Mousavian. All rights reserved.
+//
+
+import Foundation
+
+extension SMB2 {
+    // MARK: SMB2 Negotiating
+    
+    struct NegotiateRequest: SMBRequestBody {
+        let header: NegotiateRequest.Header
+        let dialects: [UInt16]
+        let contexts: [(type: NegotiateContextType, data: Data)]
+        
+        init(header: NegotiateRequest.Header, dialects: [UInt16] = [0x0202], contexts: [(type: NegotiateContextType, data: Data)] = []) {
+            self.header = header
+            self.dialects = dialects
+            self.contexts = contexts
+        }
+        
+        init(dialects: [UInt16] = [0x0202], contexts: [(type: NegotiateContextType, data: Data)] = [],capabilities: GlobalCapabilities = [], clientStartTime: SMBTime? = nil, guid: uuid_t? = nil, signing: NegotiateSinging = [.ENABLED]) {
+            self.header = Header(capabilities: capabilities, clientStartTime: clientStartTime, guid: guid, signing: signing)
+            self.dialects = dialects
+            self.contexts = contexts
+        }
+        
+        func data() -> Data {
+            var header = self.header
+            header.dialectCount = UInt16(dialects.count)
+            var dialectData = Data()
+            for dialect in dialects {
+                var dialect = dialect
+                dialectData.append(UnsafeBufferPointer(start: &dialect, count: 2))
+            }
+            let pad = ((1024 - dialectData.count) % 8)
+            dialectData.count += pad
+            header.contextOffset = UInt32(MemoryLayout<NegotiateRequest.Header>.size) + UInt32(dialectData.count)
+            header.contextCount = UInt16(contexts.count)
+            
+            var contextData = Data()
+            for context in contexts {
+                contextData.append(Data(value: context.type.rawValue))
+                contextData.count += 4
+                contextData.append(Data(value: UInt16(context.data.count)))
+            }
+            var result = Data(value: header)
+            result.append(dialectData as Data)
+            result.append(contextData as Data)
+            return result
+        }
+        
+        struct Header {
+            var size: UInt16
+            var dialectCount: UInt16
+            let signing: NegotiateSinging
+            fileprivate let reserved: UInt16
+            let capabilities: GlobalCapabilities
+            let guid: uuid_t
+            var contextOffset: UInt32
+            var contextCount: UInt16
+            fileprivate let reserved2: UInt16
+            var clientStartTime: SMBTime {
+                let time = Int64(contextOffset) + (Int64(contextCount) << 32) + (Int64(contextCount) << 48)
+                return SMBTime(time: time)
+            }
+            
+            init(capabilities: GlobalCapabilities, clientStartTime: SMBTime? = nil, guid: uuid_t? = nil, signing: NegotiateSinging = [.ENABLED]) {
+                self.size = 36
+                self.dialectCount = 0
+                self.signing = signing
+                self.reserved = 0
+                self.capabilities = capabilities
+                self.guid = guid ?? (0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0)
+                if let clientStartTime = clientStartTime {
+                    let time = clientStartTime.time
+                    self.contextOffset = UInt32(time & 0xffffffff)
+                    self.contextCount = UInt16(time & 0x0000ffff00000000 >> 32)
+                    self.reserved2 = UInt16(time >> 48)
+                } else {
+                    self.contextOffset = 0
+                    self.contextCount = 0
+                    self.reserved2 = 0
+                }
+            }
+        }
+    }
+    
+    struct NegotiateResponse: SMBResponseBody {
+        let header: NegotiateResponse.Header
+        let buffer: Data?
+        let contexts: [(type: NegotiateContextType, data: Data)]
+        
+        init? (data: Data) {
+            guard data.count >= 64 else {
+                return nil
+            }
+            self.header = data.scanValue()!
+            if Int(header.size) != 65 {
+                return nil
+            }
+            let bufOffset = Int(self.header.bufferOffset) - MemoryLayout<SMB2.Header>.size
+            let bufLen = Int(self.header.bufferLength)
+            if bufOffset > 0 && bufLen > 0 && data.count >= bufOffset + bufLen {
+                self.buffer = data.subdata(in: bufOffset..<(bufOffset + bufLen))
+            } else {
+                self.buffer = nil
+            }
+            let contextCount = Int(self.header.contextCount)
+            let contextOffset = Int(self.header.contextOffset) - MemoryLayout<SMB2.Header>.size
+            if  contextCount > 0 &&  contextOffset > 0 {
+                // TODO: NegotiateResponse context support for SMB3
+                self.contexts = []
+            } else {
+                self.contexts = []
+            }
+        }
+        
+        struct Header {
+            let size: UInt16
+            let singing: NegotiateSinging
+            let dialect: UInt16
+            let contextCount: UInt16
+            let serverGuid: uuid_t
+            let capabilities: GlobalCapabilities
+            let maxTransactSize: UInt32
+            let maxReadSize: UInt32
+            let maxWriteSize: UInt32
+            let systemTime: SMBTime
+            let serverStartTime: SMBTime
+            let bufferOffset: UInt16
+            let bufferLength: UInt16
+            let contextOffset: UInt32
+        }
+    }
+    
+    struct NegotiateSinging: OptionSet {
+        let rawValue: UInt16
+        
+        init(rawValue: UInt16) {
+            self.rawValue = rawValue
+        }
+        static let ENABLED   = NegotiateSinging(rawValue: 0x0001)
+        static let REQUIRED  = NegotiateSinging(rawValue: 0x0002)
+    }
+    
+    struct NegotiateContextType: OptionSet {
+        let rawValue: UInt16
+        
+        init(rawValue: UInt16) {
+            self.rawValue = rawValue
+        }
+        static let PREAUTH_INTEGRITY_CAPABILITIES   = NegotiateContextType(rawValue: 0x0001)
+        static let ENCRYPTION_CAPABILITIES          = NegotiateContextType(rawValue: 0x0002)
+    }
+    
+    struct GlobalCapabilities: OptionSet {
+        let rawValue: UInt32
+        
+        init(rawValue: UInt32) {
+            self.rawValue = rawValue
+        }
+        static let DFS                  = GlobalCapabilities(rawValue: 0x00000001)
+        static let LEASING              = GlobalCapabilities(rawValue: 0x00000002)
+        static let LARGE_MTU            = GlobalCapabilities(rawValue: 0x00000004)
+        static let MULTI_CHANNEL        = GlobalCapabilities(rawValue: 0x00000008)
+        static let PERSISTENT_HANDLES   = GlobalCapabilities(rawValue: 0x00000010)
+        static let DIRECTORY_LEASING    = GlobalCapabilities(rawValue: 0x00000020)
+        static let ENCRYPTION           = GlobalCapabilities(rawValue: 0x00000040)
+    }
+    
+    // MARK: SMB2 Session Setup
+    
+    struct SessionSetupRequest: SMBRequestBody {
+        let header: SessionSetupRequest.Header
+        let buffer: Data?
+        
+        init(header: SessionSetupRequest.Header, buffer: Data) {
+            self.header = header
+            self.buffer = buffer
+        }
+        
+        init(sessionId: UInt64 = 0, flags: SessionSetupRequest.Flags = [], singing: SessionSetupSinging = [.ENABLED], capabilities: GlobalCapabilities = [], securityData: Data? = nil) {
+            self.header = Header(sessionId: sessionId, flags: flags, singing: singing, capabilities: capabilities)
+            self.buffer = securityData
+        }
+        
+        func data() -> Data {
+            var header = self.header
+            header.bufferOffset = UInt16(MemoryLayout<SMB2.Header>.size + MemoryLayout<SessionSetupRequest.Header>.size)
+            header.bufferLength = UInt16(buffer?.count ?? 0)
+            var result = Data(value: header)
+            if let buffer = self.buffer {
+                result.append(buffer)
+            }
+            return result
+        }
+        
+        struct Header {
+            let size: UInt16
+            let flags: SessionSetupRequest.Flags
+            let signing: SessionSetupSinging
+            let capabilities: GlobalCapabilities
+            fileprivate let channel: UInt32
+            var bufferOffset: UInt16
+            var bufferLength: UInt16
+            let sessionId: UInt64
+            
+            init(sessionId: UInt64, flags: SessionSetupRequest.Flags = [], singing: SessionSetupSinging, capabilities: GlobalCapabilities) {
+                self.size = 25
+                self.flags = flags
+                self.signing = singing
+                self.capabilities = capabilities
+                self.channel = 0
+                self.bufferOffset = 0
+                self.bufferLength = 0
+                self.sessionId = sessionId
+            }
+        }
+        
+        /// Works the client implements the SMB 3.x dialect family
+        struct Flags: OptionSet {
+            let rawValue: UInt8
+            
+            init(rawValue: UInt8) {
+                self.rawValue = rawValue
+            }
+            
+            static let BINDING = NegotiateSinging(rawValue: 0x01)
+        }
+    }
+    
+    struct SessionSetupResponse: SMBResponseBody {
+        let header: SessionSetupResponse.Header
+        let buffer: Data?
+        
+        init? (data: Data) {
+            guard data.count >= 64 else {
+                return nil
+            }
+            self.header = data.scanValue()!
+            if Int(header.size) != 9 {
+                return nil
+            }
+            let bufOffset = Int(self.header.bufferOffset) - MemoryLayout<SMB2.Header>.size
+            let bufLen = Int(self.header.bufferLength)
+            if bufOffset > 0 && bufLen > 0 && data.count >= bufOffset + bufLen {
+                self.buffer = data.subdata(in: bufOffset..<(bufOffset + bufLen))
+            } else {
+                self.buffer = nil
+            }
+        }
+        
+        struct Header {
+            let size: UInt16
+            let flags: SessionSetupResponse.Flags
+            let bufferOffset: UInt16
+            let bufferLength: UInt16
+        }
+        
+        struct Flags: OptionSet {
+            let rawValue: UInt16
+            
+            init(rawValue: UInt16) {
+                self.rawValue = rawValue
+            }
+            
+            static let IS_GUEST     = Flags(rawValue: 0x0001)
+            static let IS_NULL      = Flags(rawValue: 0x0002)
+            static let ENCRYPT_DATA = Flags(rawValue: 0x0004)
+        }
+    }
+    
+    struct SessionSetupSinging: OptionSet {
+        let rawValue: UInt8
+        
+        init(rawValue: UInt8) {
+            self.rawValue = rawValue
+        }
+        
+        static let ENABLED   = SessionSetupSinging(rawValue: 0x01)
+        static let REQUIRED  = SessionSetupSinging(rawValue: 0x02)
+    }
+    
+    // MARK: SMB2 Log off
+    
+    struct LogOff: SMBRequestBody, SMBResponseBody {
+        let size: UInt16
+        let reserved: UInt16
+        
+        init() {
+            self.size = 4
+            self.reserved = 0
+        }
+    }
+    
+    // MARK: SMB2 Echo
+    
+    struct Echo: SMBRequestBody, SMBResponseBody {
+        let size: UInt16
+        let reserved: UInt16
+        
+        init() {
+            self.size = 4
+            self.reserved = 0
+        }
+    }
+}

Sources/SMBTypes/SMB2SetInfo.swift

@@ -0,0 +1,42 @@
+//
+//  SMB2SetInfo.swift
+//  ExtDownloader
+//
+//  Created by Amir Abbas Mousavian on 4/31/95.
+//  Copyright © 1395 Mousavian. All rights reserved.
+//
+
+import Foundation
+
+extension SMB2 {
+    // MARK: SMB2 Set Info
+    struct SetInfoRequest: SMBRequestBody {
+        let header: Header
+        let buffer: Data?
+        
+        func data() -> Data {
+            var result = Data(value: header)
+            result.append(buffer ?? Data())
+            return result 
+        }
+        
+        struct Header {
+            let size: UInt16 = 33
+            let infoType: UInt8
+            fileprivate let infoClass: UInt8
+            let bufferLength: UInt32
+            let bufferOffset: UInt16
+            fileprivate let reserved: UInt16
+            let securityInfo: FileSecurityInfo
+            let fileId: FileId
+        }
+    }
+    
+    struct SetInfoResponse: SMBResponseBody {
+        let size: UInt16
+        
+        init() {
+            self.size = 2
+        }
+    }
+}

Sources/SMBTypes/SMB2Tree.swift

@@ -0,0 +1,136 @@
+//
+//  SMB2Tree.swift
+//  ExtDownloader
+//
+//  Created by Amir Abbas Mousavian on 4/30/95.
+//  Copyright © 1395 Mousavian. All rights reserved.
+//
+
+import Foundation
+
+extension SMB2 {
+    // MARK: SMB2 Tree Connect
+    
+    struct TreeConnectRequest: SMBRequestBody {
+        let header: TreeConnectRequest.Header
+        let buffer: Data?
+        var path: String {
+            return ""
+        }
+        var share: String {
+            return ""
+        }
+        
+        init? (header: TreeConnectRequest.Header, host: String, share: String) {
+            guard !host.contains("/") && !share.contains("/") else {
+                return nil
+            }
+            self.header = header
+            let path = "\\\\\(host)\\\(share)"
+            self.buffer = path.data(using: .utf16)
+        }
+        
+        func data() -> Data {
+            var header = self.header
+            header.pathOffset = UInt16(MemoryLayout<SMB2.Header>.size + MemoryLayout<TreeConnectRequest.Header>.size)
+            header.pathLength = UInt16(buffer?.count ?? 0)
+            var result = Data(value: header)
+            if let buffer = self.buffer {
+                result.append(buffer)
+            }
+            return result
+        }
+        
+        struct Header {
+            let size: UInt16
+            let flags: TreeConnectRequest.Flags
+            var pathOffset: UInt16
+            var pathLength: UInt16
+            
+            init(flags: TreeConnectRequest.Flags) {
+                self.size = 9
+                self.flags = flags
+                self.pathOffset = 0
+                self.pathLength = 0
+            }
+        }
+        
+        struct Flags: OptionSet {
+            let rawValue: UInt16
+            
+            init(rawValue: UInt16) {
+                self.rawValue = rawValue
+            }
+            
+            static let SHAREFLAG_CLUSTER_RECONNECT = Flags(rawValue: 0x0001)
+        }
+    }
+    
+    struct TreeConnectResponse: SMBResponseBody {
+        let size: UInt16  // = 16
+        fileprivate let _type: UInt8
+        var type: ShareType {
+            return ShareType(rawValue: _type) ?? .UNKNOWN
+        }
+        fileprivate let reserved: UInt8
+        let flags: TreeConnectResponse.ShareFlags
+        let capabilities: TreeConnectResponse.Capabilities
+        let maximalAccess: FileAccessMask
+        
+        enum ShareType: UInt8 {
+            case UNKNOWN  = 0x00
+            case DISK     = 0x01
+            case PIPE     = 0x02
+            case PRINT    = 0x03
+        }
+        
+        struct ShareFlags: OptionSet {
+            let rawValue: UInt32
+            
+            init(rawValue: UInt32) {
+                self.rawValue = rawValue
+            }
+            
+            static let DFS                          = ShareFlags(rawValue: 0x00000001)
+            static let DFS_ROOT                     = ShareFlags(rawValue: 0x00000002)
+            static let MANUAL_CACHING               = ShareFlags(rawValue: 0x00000000)
+            static let AUTO_CACHING                 = ShareFlags(rawValue: 0x00000010)
+            static let VDO_CACHING                  = ShareFlags(rawValue: 0x00000020)
+            static let NO_CACHING                   = ShareFlags(rawValue: 0x00000030)
+            static let RESTRICT_EXCLUSIVE_OPENS     = ShareFlags(rawValue: 0x00000100)
+            static let FORCE_SHARED_DELETE          = ShareFlags(rawValue: 0x00000200)
+            static let ALLOW_NAMESPACE_CACHING      = ShareFlags(rawValue: 0x00000400)
+            static let ACCESS_BASED_DIRECTORY_ENUM  = ShareFlags(rawValue: 0x00000800)
+            static let FORCE_LEVELII_OPLOCK         = ShareFlags(rawValue: 0x00001000)
+            static let ENABLE_HASH_V1               = ShareFlags(rawValue: 0x00002000)
+            static let ENABLE_HASH_V2               = ShareFlags(rawValue: 0x00004000)
+            static let ENCRYPT_DATA                 = ShareFlags(rawValue: 0x00008000)
+        }
+        
+        struct Capabilities: OptionSet {
+            let rawValue: UInt32
+            
+            init(rawValue: UInt32) {
+                self.rawValue = rawValue
+            }
+            
+            static let DFS                      = Capabilities(rawValue: 0x00000008)
+            static let CONTINUOUS_AVAILABILITY  = Capabilities(rawValue: 0x00000010)
+            static let SCALEOUT                 = Capabilities(rawValue: 0x00000020)
+            static let CLUSTER                  = Capabilities(rawValue: 0x00000040)
+            static let ASYMMETRIC               = Capabilities(rawValue: 0x00000080)
+        }
+    }
+    
+    // MARK: SMB2 Tree Disconnect
+    
+    struct TreeDisconnect: SMBRequestBody, SMBResponseBody {
+        let size: UInt16
+        let reserved: UInt16
+        
+        init() {
+            self.size = 4
+            self.reserved = 0
+        }
+    }
+}

Sources/SMBTypes/SMB2Types.swift

@@ -0,0 +1,139 @@
+//
+//  SMB2Types.swift
+//  FileProvider
+//
+//  Created by Amir Abbas Mousavian.
+//  Copyright © 2016 Mousavian. Distributed under MIT license.
+//
+
+import Foundation
+
+protocol FileProviderSMBHeader {
+    var protocolID: UInt32 { get }
+    static var protocolConst: UInt32 { get }
+}
+
+// SMB2 Types
+struct SMB2 {
+    struct Header: FileProviderSMBHeader { // 64 bytes
+        // header is always \u{fe}SMB
+        let protocolID: UInt32
+        static let protocolConst: UInt32 = 0x424d53fe
+        let size: UInt16
+        let creditCharge: UInt16
+        // error messages from the server to the client
+        let status: UInt32
+        enum StatusSeverity: UInt8 {
+            case success = 0, information, warning, error
+        }
+        var statusDetails: (severity: StatusSeverity, customer: Bool, facility: UInt16, code: UInt16) {
+            let severity = StatusSeverity(rawValue: UInt8(status >> 30))!
+            return (severity, status & 0x20000000 != 0, UInt16((status & 0x0FFF0000) >> 16), UInt16(status & 0x0000FFFF))
+        }
+        fileprivate let _command: UInt16
+        var command: Command {
+            get {
+                return Command(rawValue: _command) ?? .INVALID
+            }
+        }
+        let creditRequestResponse: UInt16
+        let flags: Flags
+        var nextCommand: UInt32
+        let messageId: UInt64
+        fileprivate let reserved: UInt32
+        let treeId: UInt32
+        var asyncId: UInt64 {
+            get {
+                return UInt64(reserved) + (UInt64(treeId) << 32)
+            }
+        }
+        let sessionId: UInt64
+        let signature: (UInt64, UInt64)
+        
+        // codebeat:disable[ARITY]
+        init(command: Command, status: NTStatus = .SUCCESS, creditCharge: UInt16 = 0, creditRequestResponse: UInt16, flags: Flags = [], nextCommand: UInt32 = 0, messageId: UInt64, treeId: UInt32, sessionId: UInt64, signature: (UInt64, UInt64) = (0, 0)) {
+            self.protocolID = type(of: self).protocolConst
+            self.size = 64
+            self.status = status.rawValue
+            self._command = command.rawValue
+            self.creditCharge = creditCharge
+            self.creditRequestResponse = creditRequestResponse
+            self.flags = flags
+            self.nextCommand = nextCommand
+            self.messageId = messageId
+            self.reserved = 0
+            self.treeId = treeId
+            self.sessionId = sessionId
+            self.signature = signature
+        }
+        
+        init(asyncCommand: Command, status: NTStatus = .SUCCESS, creditCharge: UInt16 = 0, creditRequestResponse: UInt16, flags: Flags = [.ASYNC_COMMAND], nextCommand: UInt32 = 0, messageId: UInt64, asyncId: UInt64, sessionId: UInt64, signature: (UInt64, UInt64) = (0, 0)) {
+            self.protocolID = type(of: self).protocolConst
+            self.size = 64
+            self.status = status.rawValue
+            self._command = asyncCommand.rawValue
+            self.creditCharge = creditCharge
+            self.creditRequestResponse = creditRequestResponse
+            self.flags = flags.union([Flags.ASYNC_COMMAND])
+            self.nextCommand = nextCommand
+            self.messageId = messageId
+            self.reserved = UInt32(asyncId & 0xffffffff)
+            self.treeId = UInt32(asyncId >> 32)
+            self.sessionId = sessionId
+            self.signature = signature
+        }
+        // codebeat:enable[ARITY]
+    }
+    
+    struct Flags: OptionSet {
+        var rawValue: UInt32
+        
+        init(rawValue: UInt32) {
+            self.rawValue = rawValue
+        }
+        
+        var priorityMask: UInt8 {
+            get {
+                return UInt8((rawValue & Flags.PRIORITY_MASK.rawValue)  >> 4)
+            }
+            set {
+                rawValue = (rawValue & 0xffffff8f) | (UInt32(newValue & 0x7) << 4)
+            }
+        }
+        
+        static let SERVER_TO_REDIR       = Flags(rawValue: 0x00000001)
+        static let ASYNC_COMMAND         = Flags(rawValue: 0x00000002)
+        static let RELATED_OPERATIONS    = Flags(rawValue: 0x00000004)
+        static let SIGNED                = Flags(rawValue: 0x00000008)
+        fileprivate static let PRIORITY_MASK = Flags(rawValue: 0x00000070)
+        static let DFS_OPERATIONS        = Flags(rawValue: 0x10000000)
+        static let REPLAY_OPERATION      = Flags(rawValue: 0x20000000)
+    }
+    
+    enum Command: UInt16 {
+        case NEGOTIATE              = 0x0000
+        case SESSION_SETUP          = 0x0001
+        case LOGOFF                 = 0x0002
+        case TREE_CONNECT           = 0x0003
+        case TREE_DISCONNECT        = 0x0004
+        case CREATE                 = 0x0005
+        case CLOSE                  = 0x0006
+        case FLUSH                  = 0x0007
+        case READ                   = 0x0008
+        case WRITE                  = 0x0009
+        case LOCK                   = 0x000A
+        case IOCTL                  = 0x000B
+        case CANCEL                 = 0x000C
+        case ECHO                   = 0x000D
+        case QUERY_DIRECTORY        = 0x000E
+        case CHANGE_NOTIFY          = 0x000F
+        case QUERY_INFO             = 0x0010
+        case SET_INFO               = 0x0011
+        case OPLOCK_BREAK           = 0x0012
+        case INVALID                = 0xFFFF
+    }
+    
+    // MARK: SMB2 Oplock Break
+    
+    
+}

Sources/SMBTypes/SMBErrorType.swift

@@ -0,0 +1,208 @@
+//
+//  SMBErrorType.swift
+//  ExtDownloader
+//
+//  Created by Amir Abbas Mousavian on 4/30/95.
+//  Copyright © 1395 Mousavian. All rights reserved.
+//
+
+import Foundation
+
+/// Error Types and Description
+
+enum NTStatus: UInt32, Error, CustomStringConvertible {
+    case SUCCESS                        = 0x00000000
+    case NOT_IMPLEMENTED                = 0xC0000002
+    case INVALID_DEVICE_REQUEST         = 0xC0000010
+    case ILLEGAL_FUNCTION               = 0xC00000AF
+    case NO_SUCH_FILE                   = 0xC000000F
+    case NO_SUCH_DEVICE                 = 0xC000000E
+    case OBJECT_NAME_NOT_FOUND          = 0xC0000034
+    case OBJECT_PATH_INVALID            = 0xC0000039
+    case OBJECT_PATH_NOT_FOUND          = 0xC000003A
+    case OBJECT_PATH_SYNTAX_BAD         = 0xC000003B
+    case DFS_EXIT_PATH_FOUND            = 0xC000009B
+    case REDIRECTOR_NOT_STARTED         = 0xC00000FB
+    case TOO_MANY_OPENED_FILES          = 0xC000011F
+    case ACCESS_DENIED                  = 0xC0000022
+    case INVALID_LOCK_SEQUENCE          = 0xC000001E
+    case INVALID_VIEW_SIZE              = 0xC000001F
+    case ALREADY_COMMITTED              = 0xC0000021
+    case PORT_CONNECTION_REFUSED        = 0xC0000041
+    case THREAD_IS_TERMINATING          = 0xC000004B
+    case DELETE_PENDING                 = 0xC0000056
+    case PRIVILEGE_NOT_HELD             = 0xC0000061
+    case LOGON_FAILURE                  = 0xC000006D
+    case FILE_IS_A_DIRECTORY            = 0xC00000BA
+    case FILE_RENAMED                   = 0xC00000D5
+    case PROCESS_IS_TERMINATING         = 0xC000010A
+    case DIRECTORY_NOT_EMPTY            = 0xC0000101
+    case CANNOT_DELETE                  = 0xC0000121
+    case FILE_NOT_AVAILABLE             = 0xC0000467
+    case FILE_DELETED                   = 0xC0000123
+    case SMB_BAD_FID                    = 0x00060001
+    case INVALID_HANDLE                 = 0xC0000008
+    case OBJECT_TYPE_MISMATCH           = 0xC0000024
+    case PORT_DISCONNECTED              = 0xC0000037
+    case INVALID_PORT_HANDLE            = 0xC0000042
+    case FILE_CLOSED                    = 0xC0000128
+    case HANDLE_NOT_CLOSABLE            = 0xC0000235
+    case SECTION_TOO_BIG                = 0xC0000040
+    case TOO_MANY_PAGING_FILES          = 0xC0000097
+    case INSUFF_SERVER_RESOURCES        = 0xC0000205
+    case OS2_INVALID_ACCESS             = 0x000C0001
+    case ACCESS_DENIED_2                = 0xC00000CA
+    case DATA_ERROR                     = 0xC000009C
+    case NOT_SAME_DEVICE                = 0xC00000D4
+    case NO_MORE_FILES                  = 0x80000006
+    case NO_MORE_ENTRIES                = 0x8000001A
+    case UNSUCCESSFUL                   = 0xC0000001
+    case SHARING_VIOLATION              = 0xC0000043
+    case FILE_LOCK_CONFLICT             = 0xC0000054
+    case LOCK_NOT_GRANTED               = 0xC0000055
+    case END_OF_FILE                    = 0xC0000011
+    case NOT_SUPPORTED                  = 0xC00000BB
+    case OBJECT_NAME_COLLISION          = 0xC0000035
+    case INVALID_PARAMETER              = 0xC000000D
+    case OS2_INVALID_LEVEL              = 0x007C0001
+    case OS2_NEGATIVE_SEEK              = 0x00830001
+    case RANGE_NOT_LOCKED               = 0xC000007E
+    case OS2_NO_MORE_SIDS               = 0x00710001
+    case OS2_CANCEL_VIOLATION           = 0x00AD0001
+    case OS2_ATOMIC_LOCKS_NOT_SUPPORTED = 0x00AE0001
+    case INVALID_INFO_CLASS             = 0xC0000003
+    case INVALID_PIPE_STATE             = 0xC00000AD
+    case INVALID_READ_MODE              = 0xC00000B4
+    case OS2_CANNOT_COPY                = 0x010A0001
+    case STOPPED_ON_SYMLINK             = 0x8000002D
+    case INSTANCE_NOT_AVAILABLE         = 0xC00000AB
+    case PIPE_NOT_AVAILABLE             = 0xC00000AC
+    case PIPE_BUSY                      = 0xC00000AE
+    case PIPE_CLOSING                   = 0xC00000B1
+    case PIPE_EMPTY                     = 0xC00000D9
+    case PIPE_DISCONNECTED              = 0xC00000B0
+    case BUFFER_OVERFLOW                = 0x80000005
+    case MORE_PROCESSING_REQUIRED       = 0xC0000016
+    case EA_TOO_LARGE                   = 0xC0000050
+    case OS2_EAS_DIDNT_FIT              = 0x01130001
+    case EAS_NOT_SUPPORTED              = 0xC000004F
+    case EA_LIST_INCONSISTENT           = 0x80000014
+    case OS2_EA_ACCESS_DENIED           = 0x03E20001
+    case NOTIFY_ENUM_DIR                = 0x0000010C
+    case INVALID_SMB                    = 0x00010002
+    case WRONG_PASSWORD                 = 0xC000006A
+    case PATH_NOT_COVERED               = 0xC0000257
+    case NETWORK_NAME_DELETED           = 0xC00000C9
+    case SMB_BAD_TID                    = 0x00050002
+    case BAD_NETWORK_NAME               = 0xC00000CC
+    case BAD_DEVICE_TYPE                = 0xC00000CB
+    case SMB_BAD_COMMAND                = 0x00160002
+    case PRINT_QUEUE_FULL               = 0xC00000C6
+    case NO_SPOOL_SPACE                 = 0xC00000C7
+    case PRINT_CANCELLED                = 0xC00000C8
+    case UNEXPECTED_NETWORK_ERROR       = 0xC00000C4
+    case IO_TIMEOUT                     = 0xC00000B5
+    case REQUEST_NOT_ACCEPTED           = 0xC00000D0
+    case TOO_MANY_SESSIONS              = 0xC00000CE
+    case SMB_BAD_UID                    = 0x005B0002
+    case SMB_USE_MPX                    = 0x00FA0002
+    case SMB_USE_STANDARD               = 0x00FB0002
+    case SMB_CONTINUE_MPX               = 0x00FC0002
+    case ACCOUNT_DISABLED               = 0xC0000072
+    case ACCOUNT_EXPIRED                = 0xC0000193
+    case INVALID_WORKSTATION            = 0xC0000070
+    case INVALID_LOGON_HOURS            = 0xC000006F
+    case PASSWORD_EXPIRED               = 0xC0000071
+    case PASSWORD_MUST_CHANGE           = 0xC0000224
+    case SMB_NO_SUPPORT                 = 0xFFFF0002
+    case MEDIA_WRITE_PROTECTED          = 0xC00000A2
+    case NO_MEDIA_IN_DEVICE             = 0xC0000013
+    case INVALID_DEVICE_STATE           = 0xC0000184
+    case DATA_ERROR_2                   = 0xC000003E
+    case CRC_ERROR                      = 0xC000003F
+    case DISK_CORRUPT_ERROR             = 0xC0000032
+    case NONEXISTENT_SECTOR             = 0xC0000015
+    case DEVICE_PAPER_EMPTY             = 0x8000000E
+    case WRONG_VOLUME                   = 0xC0000012
+    case DISK_FULL                      = 0xC000007F
+    case BUFFER_TOO_SMALL               = 0xC0000023
+    case BAD_IMPERSONATION_LEVEL        = 0xC00000A5
+    case USER_SESSION_DELETED           = 0xC0000203
+    case NETWORK_SESSION_EXPIRED        = 0xC000035C
+    case SMB_TOO_MANY_UIDS              = 0xC000205A
+    
+    public var description: String {
+        switch self {
+        case .NOT_IMPLEMENTED, .INVALID_DEVICE_REQUEST, .ILLEGAL_FUNCTION:
+            return "Invalid Function."
+        case .NO_SUCH_FILE, .NO_SUCH_DEVICE, .OBJECT_NAME_NOT_FOUND:
+            return "File not found."
+        case .OBJECT_PATH_INVALID, .OBJECT_PATH_NOT_FOUND, .OBJECT_PATH_SYNTAX_BAD, .DFS_EXIT_PATH_FOUND, .REDIRECTOR_NOT_STARTED:
+            return "A component in the path prefix is not a directory."
+        case .TOO_MANY_OPENED_FILES:
+            return "Too many open files. No FIDs are available."
+        case .ACCESS_DENIED, .INVALID_LOCK_SEQUENCE, .INVALID_VIEW_SIZE, .ALREADY_COMMITTED, .PORT_CONNECTION_REFUSED, .THREAD_IS_TERMINATING, .DELETE_PENDING, .PRIVILEGE_NOT_HELD, .LOGON_FAILURE, .FILE_IS_A_DIRECTORY, .FILE_RENAMED, .PROCESS_IS_TERMINATING, .CANNOT_DELETE, .FILE_DELETED:
+            return "Access denied."
+        case .SMB_BAD_FID, .INVALID_HANDLE, .OBJECT_TYPE_MISMATCH, .PORT_DISCONNECTED, .INVALID_PORT_HANDLE, .FILE_CLOSED, .HANDLE_NOT_CLOSABLE:
+            return "Invalid FID."
+        case .SECTION_TOO_BIG, .TOO_MANY_PAGING_FILES, .INSUFF_SERVER_RESOURCES:
+            return "Insufficient server memory to perform the requested operation."
+        case .OS2_INVALID_ACCESS:
+            return "Invalid open mode."
+        case .DATA_ERROR:
+            return "Bad data. (May be generated by IOCTL calls on the server.)"
+        case .DIRECTORY_NOT_EMPTY:
+            return "Remove of directory failed because it was not empty."
+        case .NOT_SAME_DEVICE:
+            return "A file system operation (such as a rename) across two devices was attempted."
+        case .NO_MORE_FILES:
+            return "No (more) files found following a file search command."
+        case .UNSUCCESSFUL:
+            return "General error."
+        case .SHARING_VIOLATION:
+            return "Sharing violation. A requested open mode conflicts with the sharing mode of an existing file handle."
+        case .FILE_LOCK_CONFLICT, .LOCK_NOT_GRANTED:
+            return "A lock request specified an invalid locking mode, or conflicted with an existing file lock."
+        case .END_OF_FILE:
+            return "Attempted to read beyond the end of the file."
+        case .NOT_SUPPORTED:
+            return "This command is not supported by the server."
+        case .OBJECT_NAME_COLLISION:
+            return "An attempt to create a file or directory failed because an object with the same pathname already exists."
+        case .INVALID_PARAMETER:
+            return "A parameter supplied with the message is invalid."
+        case .OS2_INVALID_LEVEL:
+            return "Invalid information level."
+        case .OS2_NEGATIVE_SEEK:
+            return "An attempt was made to seek to a negative absolute offset within a file."
+        case .RANGE_NOT_LOCKED:
+            return "The byte range specified in an unlock request was not locked."
+        case .OS2_NO_MORE_SIDS:
+            return "Maximum number of searches has been exhausted."
+        case .OS2_CANCEL_VIOLATION:
+            return "No lock request was outstanding for the supplied cancel region."
+        case .OS2_ATOMIC_LOCKS_NOT_SUPPORTED:
+            return "The file system does not support atomic changes to the lock type."
+        case .INVALID_INFO_CLASS, .INVALID_PIPE_STATE, .INVALID_READ_MODE:
+            return "Invalid named pipe."
+        case .OS2_CANNOT_COPY:
+            return "The copy functions cannot be used."
+        case .INSTANCE_NOT_AVAILABLE, .PIPE_NOT_AVAILABLE, .PIPE_BUSY:
+            return "All instances of the designated named pipe are busy."
+        case .PIPE_CLOSING, .PIPE_EMPTY:
+            return "The designated named pipe is in the process of being closed."
+        case .PIPE_DISCONNECTED:
+            return "The designated named pipe exists, but there is no server process listening on the server side."
+        case .BUFFER_OVERFLOW, .MORE_PROCESSING_REQUIRED:
+            return "There is more data available to read on the designated named pipe."
+        case .EA_TOO_LARGE, .OS2_EAS_DIDNT_FIT:
+            return "Either there are no extended attributes, or the available extended attributes did not fit into the response."
+        case .EAS_NOT_SUPPORTED:
+            return "The server file system does not support Extended Attributes."
+        case .OS2_EA_ACCESS_DENIED:
+            return "Access to the extended attribute was denied."
+        default:
+            return ""
+        }
+    }
+}

Sources/WebDAVFileProvider.swift

@@ -0,0 +1,637 @@
+//
+//  WebDAVFileProvider.swift
+//  FileProvider
+//
+//  Created by Amir Abbas Mousavian.
+//  Copyright © 2016 Mousavian. Distributed under MIT license.
+//
+
+import Foundation
+
+/**
+ Allows accessing to WebDAV server files. This provider doesn't cache or save files internally, however you can
+ set `useCache` and `cache` properties to use Foundation `NSURLCache` system.
+ 
+ WebDAV system supported by many cloud services including [Box.net](https://www.box.com/home) 
+ and [Yandex disk](https://disk.yandex.com) and [ownCloud](https://owncloud.org).
+ 
+ - Important: Because this class uses `URLSession`, it's necessary to disable App Transport Security
+     in case of using this class with unencrypted HTTP connection.
+     [Read this to know how](http://iosdevtips.co/post/121756573323/ios-9-xcode-7-http-connect-server-error).
+*/
+open class WebDAVFileProvider: FileProviderBasicRemote {
+    open class var type: String { return "WebDAV" }
+    open let isPathRelative: Bool
+    open let baseURL: URL?
+    open var currentPath: String
+    
+    open var dispatch_queue: DispatchQueue
+    open var operation_queue: OperationQueue {
+        willSet {
+            assert(_session == nil, "It's not effective to change dispatch_queue property after session is initialized.")
+        }
+    }
+    
+    public weak var delegate: FileProviderDelegate?
+    open let credential: URLCredential?
+    open private(set) var cache: URLCache?
+    public var useCache: Bool
+    public var validatingCache: Bool
+    
+    fileprivate var _session: URLSession?
+    fileprivate var sessionDelegate: SessionDelegate?
+    public var session: URLSession {
+        if _session == nil {
+            self.sessionDelegate = SessionDelegate(fileProvider: self, credential: credential)
+            let queue = OperationQueue()
+            //queue.underlyingQueue = dispatch_queue
+            let config = URLSessionConfiguration.default
+            config.urlCache = cache
+            config.requestCachePolicy = .returnCacheDataElseLoad
+            _session = URLSession(configuration: config, delegate: sessionDelegate as URLSessionDownloadDelegate?, delegateQueue: queue)
+        }
+        return _session!
+    }
+    
+    /**
+     Initializes WebDAV provider.
+     
+     - Parameters:
+       - baseURL: Location of WebDAV server.
+       - credential: An `URLCredential` object with `user` and `password`.
+       - cache: A URLCache to cache downloaded files and contents.
+    */
+    public init? (baseURL: URL, credential: URLCredential?, cache: URLCache? = nil) {
+        if  !["http", "https"].contains(baseURL.uw_scheme.lowercased()) {
+            return nil
+        }
+        self.baseURL = baseURL.path.hasSuffix("/") ? baseURL : baseURL.appendingPathComponent("")
+        self.isPathRelative = true
+        self.currentPath = ""
+        self.useCache = false
+        self.validatingCache = true
+        self.cache = cache
+        self.credential = credential
+        dispatch_queue = DispatchQueue(label: "FileProvider.\(type(of: self).type)", attributes: .concurrent)
+        operation_queue = OperationQueue()
+        operation_queue.name = "FileProvider.\(type(of: self).type).Operation"
+    }
+    
+    deinit {
+        if fileProviderCancelTasksOnInvalidating {
+            _session?.invalidateAndCancel()
+        } else {
+            _session?.finishTasksAndInvalidate()
+        }
+    }
+    
+    open func contentsOfDirectory(path: String, completionHandler: @escaping ((_ contents: [FileObject], _ error: Error?) -> Void)) {
+        let opType = FileOperationType.fetch(path: path)
+        let url = self.url(of: path).appendingPathComponent("")
+        var request = URLRequest(url: url)
+        request.httpMethod = "PROPFIND"
+        request.setValue("1", forHTTPHeaderField: "Depth")
+        request.setValue("text/xml; charset=\"utf-8\"", forHTTPHeaderField: "Content-Type")
+        request.httpBody = "<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n<D:propfind xmlns:D=\"DAV:\">\n<D:allprop/></D:propfind>".data(using: .utf8)
+        request.setValue(String(request.httpBody!.count), forHTTPHeaderField: "Content-Length")
+        runDataTask(with: request, operationHandle: RemoteOperationHandle(operationType: opType, tasks: []), completionHandler: { (data, response, error) in
+            var responseError: FileProviderWebDavError?
+            if let code = (response as? HTTPURLResponse)?.statusCode , code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                responseError = FileProviderWebDavError(code: rCode, path: path, errorDescription: String(data: data ?? Data(), encoding: .utf8), url: url)
+            }
+            var fileObjects = [WebDavFileObject]()
+            if let data = data {
+                let xresponse = DavResponse.parse(xmlResponse: data, baseURL: self.baseURL)
+                for attr in xresponse where attr.href != url {
+                    if attr.href.path == url.path {
+                        continue
+                    }
+                    fileObjects.append(WebDavFileObject(attr))
+                }
+            }
+            completionHandler(fileObjects, responseError ?? error)
+        })
+    }
+    
+    open func attributesOfItem(path: String, completionHandler: @escaping ((_ attributes: FileObject?, _ error: Error?) -> Void)) {
+        let url = self.url(of: path)
+        var request = URLRequest(url: url)
+        request.httpMethod = "PROPFIND"
+        request.setValue("1", forHTTPHeaderField: "Depth")
+        request.setValue("text/xml; charset=\"utf-8\"", forHTTPHeaderField: "Content-Type")
+        request.httpBody = "<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n<D:propfind xmlns:D=\"DAV:\">\n<D:allprop/></D:propfind>".data(using: .utf8)
+        request.setValue(String(request.httpBody!.count), forHTTPHeaderField: "Content-Length")
+        runDataTask(with: request, completionHandler: { (data, response, error) in
+            var responseError: FileProviderWebDavError?
+            if let code = (response as? HTTPURLResponse)?.statusCode, code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                responseError = FileProviderWebDavError(code: rCode, path: path, errorDescription: String(data: data ?? Data(), encoding: .utf8), url: url)
+            }
+            if let data = data {
+                let xresponse = DavResponse.parse(xmlResponse: data, baseURL: self.baseURL)
+                if let attr = xresponse.first {
+                    completionHandler(WebDavFileObject(attr), responseError ?? error)
+                    return
+                }
+            }
+            completionHandler(nil, responseError ?? error)
+        })
+    }
+    
+    open func storageProperties(completionHandler: @escaping ((_ total: Int64, _ used: Int64) -> Void)) {
+        // Not all WebDAV clients implements RFC2518 which allows geting storage quota.
+        // In this case you won't get error. totalSize is NSURLSessionTransferSizeUnknown
+        // and used space is zero.
+        guard let baseURL = baseURL else {
+            return
+        }
+        var request = URLRequest(url: baseURL)
+        request.httpMethod = "PROPFIND"
+        request.setValue("0", forHTTPHeaderField: "Depth")
+        request.setValue("text/xml; charset=\"utf-8\"", forHTTPHeaderField: "Content-Type")
+        request.httpBody = "<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n<D:propfind xmlns:D=\"DAV:\">\n<D:prop><D:quota-available-bytes/><D:quota-used-bytes/></D:prop>\n</D:propfind>".data(using: .utf8)
+        request.setValue(String(request.httpBody!.count), forHTTPHeaderField: "Content-Length")
+        runDataTask(with: request, completionHandler: { (data, response, error) in
+            var totalSize: Int64 = -1
+            var usedSize: Int64 = 0
+            if let data = data {
+                let xresponse = DavResponse.parse(xmlResponse: data, baseURL: self.baseURL)
+                if let attr = xresponse.first {
+                    totalSize = Int64(attr.prop["quota-available-bytes"] ?? "") ?? -1
+                    usedSize = Int64(attr.prop["quota-used-bytes"] ?? "") ?? 0
+                }
+            }
+            completionHandler(totalSize, usedSize)
+        })
+    }
+    
+    open func searchFiles(path: String, recursive: Bool, query: NSPredicate, foundItemHandler: ((FileObject) -> Void)?, completionHandler: @escaping ((_ files: [FileObject], _ error: Error?) -> Void)) {
+        let url = self.url(of: path)
+        var request = URLRequest(url: url)
+        request.httpMethod = "PROPFIND"
+        //request.setValue("1", forHTTPHeaderField: "Depth")
+        request.setValue("text/xml; charset=\"utf-8\"", forHTTPHeaderField: "Content-Type")
+        request.httpBody = "<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n<D:propfind xmlns:D=\"DAV:\">\n<D:allprop/></D:propfind>".data(using: .utf8)
+        runDataTask(with: request, completionHandler: { (data, response, error) in
+            // FIXME: paginating results
+            var responseError: FileProviderWebDavError?
+            if let code = (response as? HTTPURLResponse)?.statusCode , code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                responseError = FileProviderWebDavError(code: rCode, path: path, errorDescription: String(data: data ?? Data(), encoding: .utf8), url: url)
+            }
+            if let data = data {
+                let xresponse = DavResponse.parse(xmlResponse: data, baseURL: self.baseURL)
+                var fileObjects = [WebDavFileObject]()
+                for attr in xresponse {
+                    let fileObject = WebDavFileObject(attr)
+                    if !query.evaluate(with: fileObject.mapPredicate()) {
+                        continue
+                    }
+                    
+                    fileObjects.append(fileObject)
+                    foundItemHandler?(fileObject)
+                }
+                completionHandler(fileObjects, responseError ?? error)
+                return
+            }
+            completionHandler([], responseError ?? error)
+        })
+    }
+    
+    open func isReachable(completionHandler: @escaping (Bool) -> Void) {
+        var request = URLRequest(url: baseURL!)
+        request.httpMethod = "PROPFIND"
+        request.setValue("0", forHTTPHeaderField: "Depth")
+        request.setValue("text/xml; charset=\"utf-8\"", forHTTPHeaderField: "Content-Type")
+        request.httpBody = "<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n<D:propfind xmlns:D=\"DAV:\">\n<D:prop><D:quota-available-bytes/><D:quota-used-bytes/></D:prop>\n</D:propfind>".data(using: .utf8)
+        request.setValue(String(request.httpBody!.count), forHTTPHeaderField: "Content-Length")
+        runDataTask(with: request, completionHandler: { (data, response, error) in
+            let status = (response as? HTTPURLResponse)?.statusCode ?? 400
+            completionHandler(status < 300)
+        })
+    }
+    
+    open weak var fileOperationDelegate: FileOperationDelegate?
+}
+
+extension WebDAVFileProvider: FileProviderOperations {
+    @discardableResult
+    open func create(folder folderName: String, at atPath: String, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.create(path: (atPath as NSString).appendingPathComponent(folderName) + "/")
+        guard fileOperationDelegate?.fileProvider(self, shouldDoOperation: opType) ?? true == true else {
+            return nil
+        }
+        let url = self.url(of: atPath).appendingPathComponent(folderName, isDirectory: true)
+        var request = URLRequest(url: url)
+        request.httpMethod = "MKCOL"
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var responseError: FileProviderWebDavError?
+            if let code = (response as? HTTPURLResponse)?.statusCode , code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                responseError = FileProviderWebDavError(code: rCode, path: url.relativePath, errorDescription: String(data: data ?? Data(), encoding: .utf8), url: url)
+            }
+            completionHandler?(responseError ?? error)
+            self.delegateNotify(opType, error: responseError ?? error)
+        })
+        task.taskDescription = opType.json
+        task.resume()
+        return RemoteOperationHandle(operationType: opType, tasks: [task])
+    }
+    
+    @discardableResult
+    open func create(file fileName: String, at path: String, contents data: Data?, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.create(path: (path as NSString).appendingPathComponent(fileName))
+        guard fileOperationDelegate?.fileProvider(self, shouldDoOperation: opType) ?? true == true else {
+            return nil
+        }
+        let url = self.url(of: path).appendingPathComponent(fileName)
+        var request = URLRequest(url: url)
+        request.httpMethod = "PUT"
+        let task = session.uploadTask(with: request, from: data, completionHandler: { (data, response, error) in
+            var responseError: FileProviderWebDavError?
+            if let code = (response as? HTTPURLResponse)?.statusCode , code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                responseError = FileProviderWebDavError(code: rCode, path: path, errorDescription: String(data: data ?? Data(), encoding: .utf8), url: url)
+            }
+            completionHandler?(responseError ?? error)
+            self.delegateNotify(opType, error: responseError ?? error)
+        })
+        task.taskDescription = opType.json
+        task.resume()
+        return RemoteOperationHandle(operationType: opType, tasks: [task])
+    }
+    
+    @discardableResult
+    open func moveItem(path: String, to toPath: String, overwrite: Bool = false, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.move(source: path, destination: toPath)
+        guard fileOperationDelegate?.fileProvider(self, shouldDoOperation: opType) ?? true == true else {
+            return nil
+        }
+        return self.doOperation(operation: opType, overwrite: overwrite, completionHandler: completionHandler)
+    }
+    
+    @discardableResult
+    open func copyItem(path: String, to toPath: String, overwrite: Bool = false, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.copy(source: path, destination: toPath)
+        guard fileOperationDelegate?.fileProvider(self, shouldDoOperation: opType) ?? true == true else {
+            return nil
+        }
+        return self.doOperation(operation: opType, overwrite: overwrite, completionHandler: completionHandler)
+    }
+    
+    @discardableResult
+    open func removeItem(path: String, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.remove(path: path)
+        guard fileOperationDelegate?.fileProvider(self, shouldDoOperation: opType) ?? true == true else {
+            return nil
+        }
+        return self.doOperation(operation: opType, completionHandler: completionHandler)
+    }
+    
+    func doOperation(operation opType: FileOperationType, overwrite: Bool? = nil, completionHandler: SimpleCompletionHandler) -> OperationHandle?  {
+        let source = opType.source!
+        let sourceURL = self.url(of: source)
+        var request = URLRequest(url: sourceURL)
+        if let dest = opType.destination {
+            request.setValue(url(of:dest).absoluteString, forHTTPHeaderField: "Destination")
+        }
+        switch opType {
+        case .copy:
+            request.httpMethod = "COPY"
+        case .move:
+            request.httpMethod = "MOVE"
+        case .remove:
+            request.httpMethod = "DELETE"
+        default:
+            return nil
+        }
+        
+        if let overwrite = overwrite, !overwrite {
+            request.setValue("F", forHTTPHeaderField: "Overwrite")
+        }
+        let task = session.dataTask(with: request, completionHandler: { (data, response, error) in
+            var responseError: FileProviderWebDavError?
+            if let response = response as? HTTPURLResponse, let code = FileProviderHTTPErrorCode(rawValue: response.statusCode) {
+                if response.statusCode >= 300  {
+                    responseError = FileProviderWebDavError(code: code, path: source, errorDescription: String(data: data ?? Data(), encoding: .utf8), url: sourceURL)
+                }
+                if code == .multiStatus, let data = data {
+                    let xresponses = DavResponse.parse(xmlResponse: data, baseURL: self.baseURL)
+                    for xresponse in xresponses where (xresponse.status ?? 0) >= 300 {
+                        let error = FileProviderWebDavError(code: code, path: source, errorDescription: String(data: data, encoding: .utf8), url: sourceURL)
+                        completionHandler?(error)
+                    }
+                }
+            }
+            if (response as? HTTPURLResponse)?.statusCode ?? 0 != FileProviderHTTPErrorCode.multiStatus.rawValue {
+                completionHandler?(responseError ?? error)
+            }
+            
+            self.delegateNotify(opType, error: responseError ?? error)
+        })
+        task.taskDescription = opType.json
+        task.resume()
+        return RemoteOperationHandle(operationType: opType, tasks: [task])
+    }
+    
+    @discardableResult
+    open func copyItem(localFile: URL, to toPath: String, overwrite: Bool, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.copy(source: localFile.absoluteString, destination: toPath)
+        guard fileOperationDelegate?.fileProvider(self, shouldDoOperation: opType) ?? true == true else {
+            return nil
+        }
+        let url = self.url(of:toPath)
+        var request = URLRequest(url: url)
+        if !overwrite {
+            request.setValue("F", forHTTPHeaderField: "Overwrite")
+        }
+        request.httpMethod = "PUT"
+        let task = session.uploadTask(with: request, fromFile: localFile, completionHandler: { (data, response, error) in
+            var responseError: FileProviderWebDavError?
+            if let code = (response as? HTTPURLResponse)?.statusCode , code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                responseError = FileProviderWebDavError(code: rCode, path: toPath, errorDescription: String(data: data ?? Data(), encoding: .utf8), url: url)
+            }
+            completionHandler?(responseError ?? error)
+            self.delegateNotify(opType, error: responseError ?? error)
+        }) 
+        task.taskDescription = opType.json
+        task.resume()
+        return RemoteOperationHandle(operationType: opType, tasks: [task])
+    }
+    
+    @discardableResult
+    open func copyItem(path: String, toLocalURL: URL, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.copy(source: path, destination: toLocalURL.absoluteString)
+        guard fileOperationDelegate?.fileProvider(self, shouldDoOperation: opType) ?? true == true else {
+            return nil
+        }
+        let url = self.url(of:path)
+        let request = URLRequest(url: url)
+        let task = session.downloadTask(with: request, completionHandler: { (sourceFileURL, response, error) in
+            var responseError: FileProviderWebDavError?
+            if let code = (response as? HTTPURLResponse)?.statusCode , code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                responseError = FileProviderWebDavError(code: rCode, path: path, errorDescription: nil, url: url)
+            }
+            if let sourceFileURL = sourceFileURL {
+                do {
+                    try FileManager.default.copyItem(at: sourceFileURL, to: toLocalURL)
+                } catch let e {
+                    completionHandler?(e)
+                    return
+                }
+            }
+            completionHandler?(responseError ?? error)
+            self.delegateNotify(opType, error: responseError ?? error)
+        }) 
+        task.taskDescription = opType.json
+        task.resume()
+        return RemoteOperationHandle(operationType: opType, tasks: [task])
+    }
+}
+
+extension WebDAVFileProvider: FileProviderReadWrite {
+    @discardableResult
+    open func contents(path: String, offset: Int64, length: Int, completionHandler: @escaping ((_ contents: Data?, _ error: Error?) -> Void)) -> OperationHandle? {
+        if length == 0 || offset < 0 {
+            dispatch_queue.async {
+                completionHandler(Data(), nil)
+            }
+            return nil
+        }
+        
+        let opType = FileOperationType.fetch(path: path)
+        let url = self.url(of: path)
+        var request = URLRequest(url: url)
+        request.httpMethod = "GET"
+        if length > 0 {
+            request.setValue("bytes=\(offset)-\(offset + length - 1)", forHTTPHeaderField: "Range")
+        } else if offset > 0 && length < 0 {
+            request.setValue("bytes=\(offset)-", forHTTPHeaderField: "Range")
+        }
+        let handle = RemoteOperationHandle(operationType: opType, tasks: [])
+        runDataTask(with: request, operationHandle: handle, completionHandler: { (data, response, error) in
+            var responseError: FileProviderWebDavError?
+            if let code = (response as? HTTPURLResponse)?.statusCode , code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                responseError = FileProviderWebDavError(code: rCode, path: path, errorDescription: String(data: data ?? Data(), encoding: .utf8), url: url)
+            }
+            completionHandler(data, responseError ?? error)
+        })
+        return handle
+    }
+    
+    @discardableResult
+    open func writeContents(path: String, contents data: Data, atomically: Bool, overwrite: Bool, completionHandler: SimpleCompletionHandler) -> OperationHandle? {
+        let opType = FileOperationType.modify(path: path)
+        guard fileOperationDelegate?.fileProvider(self, shouldDoOperation: opType) ?? true == true else {
+            return nil
+        }
+        // FIXME: lock destination before writing process
+        let url = atomically ? self.url(of: path).appendingPathExtension("tmp") : self.url(of: path)
+        var request = URLRequest(url: url)
+        request.httpMethod = "PUT"
+        if !overwrite {
+            request.setValue("F", forHTTPHeaderField: "Overwrite")
+        }
+        let task = session.uploadTask(with: request, from: data, completionHandler: { (data, response, error) in
+            var responseError: FileProviderWebDavError?
+            if let code = (response as? HTTPURLResponse)?.statusCode , code >= 300, let rCode = FileProviderHTTPErrorCode(rawValue: code) {
+                responseError = FileProviderWebDavError(code: rCode, path: path, errorDescription: String(data: data ?? Data(), encoding: .utf8), url: self.url(of: path))
+            }
+            defer {
+                self.delegateNotify(opType, error: responseError ?? error)
+            }
+            if let error = error {
+                completionHandler?(error)
+                return
+            }
+            if atomically {
+                self.moveItem(path: (path as NSString).appendingPathExtension("tmp")!, to: path, completionHandler: completionHandler)
+            }
+        }) 
+        task.taskDescription = opType.json
+        task.resume()
+        return RemoteOperationHandle(operationType: opType, tasks: [task])
+    }
+    
+    /*
+    fileprivate func registerNotifcation(path: String, eventHandler: (() -> Void)) {
+        /* There is no unified api for monitoring WebDAV server content change/update
+         * Microsoft Exchange uses SUBSCRIBE method, Apple uses push notification system.
+         * while both is unavailable in a mobile platform.
+         * A messy approach is listing a directory with an interval period and compare
+         * with previous results
+         */
+        NotImplemented()
+    }
+    fileprivate func unregisterNotifcation(path: String) {
+        NotImplemented()
+    }*/
+    // TODO: implements methods for lock mechanism
+}
+
+extension WebDAVFileProvider: FileProvider {
+    open func copy(with zone: NSZone? = nil) -> Any {
+        let copy = WebDAVFileProvider(baseURL: self.baseURL!, credential: self.credential, cache: self.cache)!
+        copy.currentPath = self.currentPath
+        copy.delegate = self.delegate
+        copy.fileOperationDelegate = self.fileOperationDelegate
+        copy.useCache = self.useCache
+        copy.validatingCache = self.validatingCache
+        return copy
+    }
+}
+
+// MARK: WEBDAV XML response implementation
+
+internal extension WebDAVFileProvider {
+    fileprivate func delegateNotify(_ operation: FileOperationType, error: Error?) {
+        DispatchQueue.main.async(execute: {
+            if error == nil {
+                self.delegate?.fileproviderSucceed(self, operation: operation)
+            } else {
+                self.delegate?.fileproviderFailed(self, operation: operation)
+            }
+        })
+    }
+}
+
+struct DavResponse {
+    let href: URL
+    let hrefString: String
+    let status: Int?
+    let prop: [String: String]
+    
+    init? (_ node: AEXMLElement, baseURL: URL?) {
+        
+        func removeSlash(_ str: String) -> String {
+            if str.hasPrefix("/") {
+                return str.substring(from: str.index(after: str.startIndex))
+            } else {
+                return str
+            }
+        }
+        
+        // find node names with namespace
+        var hreftag = "href"
+        var statustag = "status"
+        var propstattag = "propstat"
+        for node in node.children {
+            if node.name.lowercased().hasSuffix("href") {
+                hreftag = node.name
+            }
+            if node.name.lowercased().hasSuffix("status") {
+                statustag = node.name
+            }
+            if node.name.lowercased().hasSuffix("propstat") {
+                propstattag = node.name
+            }
+        }
+        
+        guard let hrefString = node[hreftag].value else { return nil }
+        
+        // trying to figure out relative path out of href
+        let hrefAbsolute = URL(string: hrefString, relativeTo: baseURL)?.absoluteString ?? hrefString
+        let relativePath = hrefAbsolute.replacingOccurrences(of: baseURL?.absoluteString ?? "", with: "", options: .anchored, range: nil)
+        let hrefURL = URL(string: removeSlash(relativePath), relativeTo: baseURL) ?? baseURL
+        
+        guard let href = hrefURL?.standardized else { return nil }
+        
+        // reading status and properties
+        var status: Int?
+        let statusDesc = (node[statustag].string).components(separatedBy: " ")
+        if statusDesc.count > 2 {
+            status = Int(statusDesc[1])
+        }
+        var propDic = [String: String]()
+        let propStatNode = node[propstattag]
+        for node in propStatNode.children where node.name.lowercased().hasSuffix("status"){
+            statustag = node.name
+            break
+        }
+        let statusDesc2 = (propStatNode[statustag].string).components(separatedBy: " ")
+        if statusDesc2.count > 2 {
+            status = Int(statusDesc2[1])
+        }
+        var proptag = "prop"
+        for tnode in propStatNode.children where tnode.name.lowercased().hasSuffix("prop") {
+            proptag = tnode.name
+            break
+        }
+        for propItemNode in propStatNode[proptag].children {
+            propDic[propItemNode.name.components(separatedBy: ":").last!.lowercased()] = propItemNode.value
+            if propItemNode.name.hasSuffix("resourcetype") && propItemNode.xml.contains("collection") {
+                propDic["getcontenttype"] = "httpd/unix-directory"
+            }
+        }
+        self.href = href
+        self.hrefString = hrefString
+        self.status = status
+        self.prop = propDic
+    }
+    
+    static func parse(xmlResponse: Data, baseURL: URL?) -> [DavResponse] {
+        var result = [DavResponse]()
+        do {
+            let xml = try AEXMLDocument(xml: xmlResponse)
+            var rootnode = xml.root
+            var responsetag = "response"
+            for node in rootnode.all ?? [] where node.name.lowercased().hasSuffix("multistatus") {
+                rootnode = node
+            }
+            for node in rootnode.children where node.name.lowercased().hasSuffix("response") {
+                responsetag = node.name
+                break
+            }
+            for responseNode in rootnode[responsetag].all ?? [] {
+                if let davResponse = DavResponse(responseNode, baseURL: baseURL) {
+                    result.append(davResponse)
+                }
+            }
+        } catch _ {
+        }
+        return result
+    }
+}
+
+/// Containts path, url and attributes of a WebDAV file or resource.
+public final class WebDavFileObject: FileObject {
+    internal init(_ davResponse: DavResponse) {
+        let href = davResponse.href
+        let name = davResponse.prop["displayname"] ?? (davResponse.hrefString.removingPercentEncoding! as NSString).lastPathComponent
+        let relativePath = href.relativePath
+        let path = relativePath.hasPrefix("/") ? relativePath : ("/" + relativePath)
+        super.init(url: href, name: name, path: path)
+        self.size = Int64(davResponse.prop["getcontentlength"] ?? "-1") ?? NSURLSessionTransferSizeUnknown
+        self.creationDate = resolve(dateString: davResponse.prop["creationdate"] ?? "")
+        self.modifiedDate = resolve(dateString: davResponse.prop["getlastmodified"] ?? "")
+        self.contentType = davResponse.prop["getcontenttype"] ?? "octet/stream"
+        self.isHidden = (Int(davResponse.prop["ishidden"] ?? "0") ?? 0) > 0
+        self.type = self.contentType == "httpd/unix-directory" ? .directory : .regular
+        self.entryTag = davResponse.prop["getetag"]
+    }
+    
+    /// MIME type of the file.
+    open internal(set) var contentType: String {
+        get {
+            return allValues[.mimeType] as? String ?? ""
+        }
+        set {
+            allValues[.mimeType] = newValue
+        }
+    }
+    
+    /// HTTP E-Tag, can be used to mark changed files.
+    open internal(set) var entryTag: String? {
+        get {
+            return allValues[.entryTag] as? String
+        }
+        set {
+            allValues[.entryTag] = newValue
+        }
+    }
+}
+
+/// Error returned by WebDAV server when trying to access or do operations on a file or folder.
+public struct FileProviderWebDavError: FileProviderHTTPError {
+    public let code: FileProviderHTTPErrorCode
+    public let path: String
+    public let errorDescription: String?
+    /// URL of resource caused error.
+    public let url: URL
+}