Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xmartlabs/Ecno
Ecno is a task state manager built on top of UserDefaults in pure Swift 4.
https://github.com/xmartlabs/Ecno
ios once state swift task-manager tasks todolist tutorial userdefaults welcome
Last synced: 5 days ago
JSON representation
Ecno is a task state manager built on top of UserDefaults in pure Swift 4.
- Host: GitHub
- URL: https://github.com/xmartlabs/Ecno
- Owner: xmartlabs
- License: mit
- Created: 2016-09-13T18:02:27.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2020-03-23T13:02:43.000Z (over 4 years ago)
- Last Synced: 2024-11-14T18:19:26.918Z (28 days ago)
- Topics: ios, once, state, swift, task-manager, tasks, todolist, tutorial, userdefaults, welcome
- Language: Swift
- Homepage:
- Size: 61.5 KB
- Stars: 102
- Watchers: 38
- Forks: 10
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - Ecno - Ecno is a task state manager built on top of UserDefaults in pure Swift 3. (Tools / Web View)
- awesome-ios-star - Ecno - Ecno is a task state manager built on top of UserDefaults in pure Swift 3. (Tools / Web View)
README
By Xmartlabs SRL.
## Introduction
**Ecno** was inspired by [Once](https://github.com/jonfinerty/Once) Android library. It's a task state manager built on top of UserDefaults in pure Swift 4. This abstraction allows you to mark 'tasks' as done, 'to-do' and check for those states.
**Ecno** is ideal for:
* Show tutorials once within the application.
* Perform certain task periodically.
* Trigger a task based on a user action.
## Usage
First you need to initialize it:
```swift
Ecno.initialize()
```
> Note: you should initialize it when your app gets launched.
Then, you can check whether a task was done by:
```swift
if !Ecno.beenDone("task") {
//...
Ecno.markDone("task")
}
```
Also, you can check for specific requirements about a certain task:
```swift
if Ecno.beenDone("task", scope: .appSession, numberOfTimes: .moreThan(3)) {
// do stuff
}
```
or
```swift
if Ecno.beenDone("task", scope: .since(20.minutes), numberOfTimes: .lessThan(3)) {
// do stuff
}
```
Additionally, you can program a 'to do' task by:
```swift
Ecno.toDo("show banner", scope: .until(3.hours), info: ["name": "bannerName"])
```
and then query if you need to do that task:
```swift
if Ecno.needToDo("show banner") {
let info = Ecno.infoForToDo("show banner") // ["name": "bannerName"]
// ...
}
```
## Task
Any type conforming to the `Task` protocol. Since it would be the most common case, the `String` type already conforms to `Task`.
```swift
public protocol Task {
var tag: String { get }
}
```
## Scope
Scopes represents periods of time within the application.
* `.appInstall`
This period represents all times for the application.
* `.appVersion`
Period starting when the current version of the app was installed.
* `.appSession`
Period starting when the application was launched.
* `.since(TimeInterval)`
Period starting since `TimeInterval` time ago from now. For instance, `.since(2.days)`
* `.until(TimeInterval)`
Period valid until `TimeInterval` from now. For instance, `.until(3.hours)`. This should be useful to set a 'to do' task that expires.
## Functions
* `func toDo(_ task: Task, scope: Scope? = nil, info: [AnyHashable: Any]? = nil)`
Marks a task as 'to do' within a given scope, if it has already been marked as to do or been done within that scope then it will not be marked. If the scope is nil, then it will be marked as to do anyways.
* `func needToDo(_ task: Task) -> Bool`
Checks if a task is currently marked as 'to do'.
* `func infoForToDo(_ task: Task) -> [AnyHashable: Any]?`
Gets the info associated with a 'to do' task. (only if you provided it in the `toDo(...)` function)
* `func lastDone(_ task: Task) -> Date?`
Last done timestamp for a given task.
* `func beenDone(_ task: Task, scope: Scope = .appInstall, numberOfTimes: CountChecker = .moreThan(0)) -> Bool`
Checks if a task has been done with the given requirements.
* `func markDone(_ task: Task)`
Marks a task as done.
## Requirements
* iOS 8.0+
* Swift 4.0+
* Xcode 9.0+
## Getting involved
* If you **want to contribute** please feel free to **submit pull requests**.
* If you **have a feature request** please **open an issue**.
* If you **found a bug** or **need help** please **check older issues**
Before contribute check the [CONTRIBUTING](https://github.com/xmartlabs/Ecno/blob/master/CONTRIBUTING.md) file for more info.
If you use **Ecno** in your app We would love to hear about it! Drop us a line on [twitter](https://twitter.com/xmartlabs).
## Examples
Follow these 3 steps to run Example project:
* Clone Ecno repository
* Open Ecno workspace and run the *Example* project.
## Installation
#### CocoaPods
[CocoaPods](https://cocoapods.org/) is a dependency manager for Cocoa projects.
To install Ecno, simply add the following line to your Podfile:
```ruby
pod 'Ecno', '~> 3.0'
```
#### Carthage
[Carthage](https://github.com/Carthage/Carthage) is a simple, decentralized dependency manager for Cocoa.
To install Ecno, simply add the following line to your Cartfile:
```ogdl
github "xmartlabs/Ecno" ~> 3.0
```
## Author
* [Diego Ernst](https://github.com/dernster)
# Change Log
This can be found in the [CHANGELOG.md](CHANGELOG.md) file.