herms: A command-line manager for delicious kitchen recipes

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

HeRM's: a Haskell-based Recipe Manager for delicious kitchen recipes


[Skip to Readme]

Properties

Versions 1.8.1.2, 1.8.1.3, 1.8.1.4, 1.8.2.1, 1.8.2.2, 1.9.0.0, 1.9.0.2, 1.9.0.3, 1.9.0.4, 1.9.0.4
Change log changelog
Dependencies ansi-terminal (>=0.7.0 && <=0.8.1), base (>=4.8 && <5), brick (>=0.19 && <=0.39), directory (>=0.0), filepath (>=1.4 && <1.5), microlens (>=0.4 && <0.5), microlens-th (>=0.4 && <0.5), mtl (>=2.2.1 && <2.3), optparse-applicative (>=0.14 && <0.15), semigroups (>=0.18.3 && <0.19), split (>=0.2 && <0.3), vty (>=5.15 && <=5.23) [details]
License GPL-3.0-only
Author Jack Kiefer
Maintainer jack.c.kiefer@gmail.com
Category Culinary, CLI, Command Line Tool
Home page https://github.com/JackKiefer/herms
Source repo head: git clone https://github.com/JackKiefer/herms
Uploaded by JackKiefer at 2018-08-01T15:48:33Z

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees


Readme for herms-1.9.0.4

[back to package description]

Herm's

Hackage stackage LTSpackage Travis build

HeRM's: a Haskell-based Recipe Manager (yes, food recipes) for the command line.

Herm's Interface

Features

What's new:

Installation

At the moment, Herm's can only be installed via stack or cabal, but standalone binaries are in the works!

If you're interested developing/hacking Herm's instead of just using it, see Contributing.md instead.

stack update
stack install herms
Manually cloning and installing from source with Stack
git clone https://github.com/JackKiefer/herms
cd herms
stack update
stack install
Via Hackage and Cabal:

Note: Your mileage may vary with dependency resolution

cabal update
cabal install herms
Manually with Cabal:
git clone https://github.com/JackKiefer/herms
cd herms
cabal update
cabal install

Usage

Command-line interface

Herm's has a pretty intuitive interface for users familiar with other command-line programs!

Below is the exhaustive list of all commands and their functionalities. Take a gander!

Usage:

        herms list [-g|--group] [--tags TAGS]           list recipes
                   [--name-only ]

        herms add                                       add a new recipe (interactively)

        herms edit RECIPE_NAME                          edit a recipe

        herms import FILE_NAME                          import a recipe file
        
        herms export DESTINATION                        export recipes to DESTINATION

        herms remove RECIPE_NAMES                       remove the particular recipes

        herms view RECIPE_NAMES [-s|--serving INT]      view the particular recipes
                                [-t|--step]
                                [-c|--convert CONV_UNIT]

        herms shopping RECIPE_NAMES [-s|--serving INT] generate shopping list for particular recipes

        herms datadir                                  show locations of recipe and config files

Available options:

        -h|--help                                      Show this help text

        -v|--version                                   Show version

        RECIPE_NAME                                    index or Recipe name

        --sort SORT_ORDER                              'tags' to sort by tags

        -s|--serving INT                               specify serving size when viewing.
                                                       E.g., 'herms view -s 2 {recipe}' for two servings

        -t|--step                                      View recipe in "one-step-at-a-time" mode
                                                       (press enter between each direction)

        -g|--group                                     group recipes by tags

        --tags TAGS                                    show recipes with particular flags

        --name-only                                    only list recipes by name

        -c|--convert CONV_UNIT                         view the recipe converted to imperial or metric
                                                       E.g., 'herms view 2 -c imperial'

Configuring Herm's and managing recipe files

Herm's stores files in the following locations:

To see where these are stored on your system, run herms datadir.

config.hs is a pseudo-Haskell-source-code file with several options for configuring the behaviour of Herm's. It currently supports the following options:


In honor of Logan, Utah's greatest Breakfast & Brunch.

Herm's Inn