Skip to content

⛽ Differific - a fast and convenient diffing framework.

License

Notifications You must be signed in to change notification settings

zenangst/Differific

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Dec 20, 2019
c5cd2d6 · Dec 20, 2019

History

95 Commits
Mar 26, 2019
Feb 15, 2019
Apr 29, 2018
Apr 26, 2018
Mar 2, 2019
Apr 26, 2018
Nov 25, 2019
Nov 5, 2019
Apr 26, 2018
Apr 26, 2018
Mar 26, 2019
Mar 26, 2019
Apr 26, 2018
Apr 26, 2018
Nov 25, 2019
Dec 20, 2019
Apr 28, 2018
Mar 3, 2019
Apr 26, 2018
Mar 3, 2019

Repository files navigation

Differific

CI Status Version Carthage Compatible codecov 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.
  • 🎩Customizable diffing.
  • 🏎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.