Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cornerAnt/Digger
Digger is a lightweight download framework that requires only one line of code to complete the file download task
https://github.com/cornerAnt/Digger
breakpoints digger download file ios large mp4 swift url urlsession video
Last synced: 7 days ago
JSON representation
Digger is a lightweight download framework that requires only one line of code to complete the file download task
- Host: GitHub
- URL: https://github.com/cornerAnt/Digger
- Owner: cornerAnt
- License: mit
- Created: 2017-11-01T12:54:27.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2021-05-05T11:02:34.000Z (over 3 years ago)
- Last Synced: 2024-04-24T19:04:55.139Z (8 months ago)
- Topics: breakpoints, digger, download, file, ios, large, mp4, swift, url, urlsession, video
- Language: Swift
- Size: 2.57 MB
- Stars: 545
- Watchers: 16
- Forks: 73
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - Digger - Digger is a lightweight download framework that requires only one line of code to complete the file download task. (Networking / Video)
- awesome-ios-star - Digger - Digger is a lightweight download framework that requires only one line of code to complete the file download task. (Networking / Video)
README
[](https://cocoapods.org/pods/Digger)
[](https://github.com/Carthage/Carthage)
[](LICENSE)
[中文说明](https://github.com/cornerAnt/Digger/blob/master/CN_README.md)
Digger is a lightweight download framework that requires only one line of code to complete the file download task.
Based on URLSession, pure Swift language implementation, support chain syntax call, real-time download progress, real-time download speed, breakpoint download.
The user forces the app to be shut down, for example by sliding off the app.
Digger can still resume downloading tasks.
## Features:
- Large file download
- Multi thread Download
- Thread safety
- Breakpoint downloading
- Controllable concurrency
## Requirements"
- iOS 8.0+
- Xcode 9.0+
- Swift 4.0+
## Installation
### CocoaPods
Add to your Podfile:
```ruby
pod 'Digger'
```
### Carthage
Add to your Cartfile:
```
github "cornerAnt/Digger"
```
## Usage
###Basic:
Download a file in the Digger directory under the sandbox's Caches
```swift
let url = "http://example.com/digger.mp4"
Digger.download(url)
```
Choose different callbacks depending on your needs
```swift
Digger.download(url)
.progress(nil)
.speed(nil)
.completion(nil)
```
```swift
let url = "http://example.com/digger.mp4"
Digger.download(url)
.progress({ (progresss) in
print(progresss.fractionCompleted)
})
.speed({ (speed) in
print(speed)
})
.completion { (result) in
switch result {
case .success(let url):
print(url)
case .failure(let error):
print(error)
}
}
}
```
Config yourself
```swift
/// Start the task at once,default is true
DiggerManager.shared.startDownloadImmediately = false
/// maxConcurrentTasksCount,deault is 3
DiggerManager.shared.maxConcurrentTasksCount = 4
/// request timeout,deault is 100
DiggerManager.shared.timeout = 150
/// allowsCellularAccess,deault is true
DiggerManager.shared.allowsCellularAccess = false
/// loglevel,deault is high
/*
***************DiggerLog****************
file : ExampleController.swift
method : viewDidLoad()
line : [31]:
info : digger log
*/
// If you want to close,set the level to be .none
DiggerManager.shared.logLevel = .none
// MARK:- DiggerCache
/// In the sandbox cactes directory, custom your cache directory
DiggerCache.cachesDirectory = "Directory"
/// Delete all downloaded files
DiggerCache.cleanDownloadFiles()
/// Delete all temporary download files
DiggerCache.cleanDownloadTempFiles()
/// Get the system's available memory size
_ = DiggerCache.systemFreeSize()
/// Get the size of the downloaded file
_ = DiggerCache.downloadedFilesSize()
/// Get the path to all downloaded files
_ = DiggerCache.pathsOfDownloadedfiles
}
```
## Contributing
1. Fork
2. Commit changes to a branch in your fork
3. Push your code and make a pull request
## License
Digger is Copyright (c) 2017 cornerAnt and released as open source under the attached [MIT License](LICENSE).