setop 0.1.0.0 → 0.1.0.1

raw patch · 4 files changed

+116/−105 lines, 4 filesPVP ok

version bump matches the API change (PVP)

API changes (from Hackage documentation)

Files

CHANGELOG.md +4/−0
README.md +109/−0
README.org +0/−103
setop.cabal +3/−2

+ CHANGELOG.md view

@@ -0,0 +1,4 @@+# Version 0.1.0.0 (31 Dec 2017)++- Initial Commit+- Support for Union, Difference, Intersection, Symmetric Difference (Disjunction)

+ README.md view

@@ -0,0 +1,109 @@+# Setop: Perform set operations on files++[![build](https://img.shields.io/travis/fmind/setop.svg)](https://travis-ci.org/fmind/setop)+[![hackage](https://img.shields.io/hackage/v/setop.svg)](https://hackage.haskell.org/package/setop)+[![hackage-deps](https://img.shields.io/hackage-deps/v/setop.svg)](https://hackage.haskell.org/package/setop)+[![license](https://img.shields.io/github/license/mashape/apistatus.svg)](https://github.com/fmind/setop/blob/master/LICENSE.txt)+ 	+## Rationale++[Set operations](https://en.wikipedia.org/wiki/Set_(mathematics)#Basic_operations) are a convenient solution to common problems:++- create a list of tasks without duplicates (set union)+- filter tasks done out of tasks to do (set difference)+- find common elements in a database (set intersection)+- and remove theses elements (set symmetric difference)++Setop helps you run these set operations on your files.++## Usage++Let's introduce two line-separated files: `A.txt` and `B.txt`.++`A.txt` contains all numbers from 0 to 5 included+```text+0+1+2+3+4+5+```++`B.txt` contains all even numbers from 0 to 8 included+```text+0+2+4+6+8+```++### Set Union (U/Union):++```bash+$ setop A.txt U B.txt+0+1+2+3+4+5+6+8+```++### Set Difference (D/Diff):++```bash+$ setop A.txt D B.txt+1+3+5+```++### Set Intersection (I/Inter):++```bash+$ setop A.txt I B.txt+0+2+4+```++### Set Symmetric Difference (J/Disj):++```bash+$ setop A.txt J B.txt+1+3+5+6+8+```++### Reading A.txt from STDIN:++```bash+$ cat A.txt | setop STDIN Diff B.txt+0+2+4+```++### Reading B.txt from STDIN:++```bash+$ cat B.txt | setop A.txt Disj STDIN+1+3+5+6+8+```++## Notes++- the resulting set is __sorted in ascending order__+- some set operations are __not commutative__ (e.g. A Diff B /= B Diff A)+- Setop is based on [optparse-applicative](https://github.com/pcapriotti/optparse-applicative) and supports [bash/fish/zsh completions](https://github.com/pcapriotti/optparse-applicative#bash-zsh-and-fish-completions)

− README.org

@@ -1,103 +0,0 @@-* Setop: Perform set operations on files-** Rationale--[[https://en.wikipedia.org/wiki/Set_(mathematics)#Basic_operations][Set operations]] are a convenient solution to common problems:--- create a list of tasks without duplicates (set union)-- filter tasks done out of tasks to do (set difference)-- find common elements in a database (set intersection)-- and remove theses elements (set symmetric difference)--Setop helps you run these set operations on your files.--** Usage--Let's introduce two line-separated files: =A.txt= and =B.txt=.--=A.txt= contains all numbers from 0 to 5 included-#+BEGIN_EXAMPLE-0-1-2-3-4-5-#+END_EXAMPLE--=B.txt= contains all even numbers from 0 to 8 included-#+BEGIN_EXAMPLE-0-2-4-6-8-#+END_EXAMPLE--*** Set Union (U/Union):--#+BEGIN_SRC bash-$ setop A.txt U B.txt-0-1-2-3-4-5-6-8-#+END_SRC`--*** Set Difference (D/Diff):--#+BEGIN_SRC bash-$ setop A.txt D B.txt-1-3-5-#+END_SRC`--*** Set Intersection (I/Inter):--#+BEGIN_SRC bash-$ setop A.txt I B.txt-0-2-4-#+END_SRC`--*** Set Symmetric Difference (J/Disj):--#+BEGIN_SRC bash-$ setop A.txt J B.txt-1-3-5-6-8-#+END_SRC`--*** Reading A.txt from STDIN:--#+BEGIN_SRC bash-$ cat A.txt | setop STDIN Diff B.txt-0-2-4-#+END_SRC`--*** Reading B.txt from STDIN:--#+BEGIN_SRC bash-$ cat B.txt | setop A.txt Disj STDIN-1-3-5-6-8-#+END_SRC`--** Notes--- the resulting set is *sorted in ascending order*-- some set operations are *not commutative* (e.g. A Diff B /= B Diff A)-- Setop is based on [[https://github.com/pcapriotti/optparse-applicative][optparse-applicative]] and supports [[https://github.com/pcapriotti/optparse-applicative#bash-zsh-and-fish-completions][bash/fish/zsh completions]]

setop.cabal view

@@ -1,5 +1,5 @@ name:                  setop-version:               0.1.0.0+version:               0.1.0.1 synopsis:              Perform set operations on files. description:           Find more information on the project homepage. author:                Médéric Hurier <fmind@users.noreply.github.com>@@ -9,7 +9,8 @@ bug-reports:           https://github.com/fmind/setop/issues license:               MIT license-file:          LICENSE.txt-extra-source-files:    README.org+extra-source-files:    README.md+                       CHANGELOG.md category:              Tools tested-with:           GHC build-type:            Simple