Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lue-bird/elm-docs-diff

compare versions of an elm API
https://github.com/lue-bird/elm-docs-diff

elm elm-diff semantic-versioning

Last synced: about 2 months ago
JSON representation

compare versions of an elm API

Awesome Lists containing this project

README

        

## elm-docs-diff

Compare versions of an API using their `docs.json`. It's both

- a [website](https://lue-bird.github.io/elm-docs-diff/) that allows you to select local `docs.json` files or fetch them online and show a nice diff
- an unopinionated package with `Elm...Diff` helpers for [packages, modules, declarations and types](https://dark.elm.dmy.fr/packages/elm/project-metadata-utils/latest/Elm-Docs)
in case you want to use an emulated `elm diff` in another context like [elm-review](https://dark.elm.dmy.fr/packages/jfmengels/elm-review/latest/) or [elm-posix](https://dark.elm.dmy.fr/packages/albertdahlin/elm-posix/latest/)

The idea is for this to be a more general `elm diff` to show changes between for example
- versions of a package that doesn't have a complete change log
- the original package and a fork or re-publish under a different name
- versions of private packages

## thanks
- rlefevre for [elm.dmy.fr](https://github.com/dmy/elm.dmy.fr) which the diff website uses as a proxy because it allows fetching package `docs.json`
- Rupert Smith for [elm-syntax-dsl](https://dark.elm.dmy.fr/packages/the-sett/elm-syntax-dsl/latest/) which the diff website uses to format changed declarations