⛽️ Differific - a fast and convenient diffing framework.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Differific.xcodeproj Migrate to version Swift 4.2 Sep 22, 2018
Example/DifferificDemo
Images
Info Initial commit Apr 26, 2018
Playground-iOS.playground Initial commit Apr 26, 2018
Playground-macOS.playground Initial commit Apr 26, 2018
Source Fix if statement Oct 5, 2018
Tests Improve user interface extensions Jul 5, 2018
bin Initial commit Apr 26, 2018
.gitignore Initial commit Apr 26, 2018
.swift-version Migrate to version Swift 4.2 Sep 22, 2018
.travis.yml Fix broken travis configuration Sep 22, 2018
CONTRIBUTING.md Initial commit Apr 26, 2018
Cartfile
Differific.podspec
LICENSE.md
README.md
circle.yml Initial commit Apr 26, 2018

README.md

Differific

CI Status Version Carthage Compatible License Platform Swift

Description

Differific Icon

Differific is a diffing tool that helps you compare Hashable objects using the Paul Heckel's diffing algorithm. Creating a changeset is seamless for all your diffing needs. The library also includes some convenience extensions to make life easier when updating data sources.

The library is based and highly influenced by Matias Cudich's (@mcudich) HeckelDiff library that aims to solve the same issue. Versions prior to 0.3.0 was based on DeepDiff. For more information about how the algorithm works and the performance of the algorithm, head over to DeepDiff. For the time being, both frameworks are very similar; this is subject to change when the frameworks evolve.

Features

  • 🍩Built-in extensions for updating table & collection views.
  • 🏎High performance.
  • 📱iOS support.
  • 💻macOS support.
  • 📺tvOS support.

Usage

Diffing two collections

let old = ["Foo", "Bar"]
let new = ["Foo", "Bar", "Baz"]
let manager = DiffManager()
let changes = manager.diff(old, new)

Updating a table or collection view

// uiElement is either your table view or collection view.
let old = dataSource.models
let new = newCollection
let changes = DiffManager().diff(old, new)
uiElement.reload(with: changes, before: { dataSource.models = new })

Installation

Differific is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'Differific'

Differific is also available through Carthage. To install just write into your Cartfile:

github "zenangst/Differific"

Differific can also be installed manually. Just download and drop Sources folders in your project.

Author

Contributing

We would love you to contribute to Differific, check the CONTRIBUTING file for more info.

License

Differific is available under the MIT license. See the LICENSE file for more info.