Release 0.7.0.0

Author: TravisCardwell

.gitignore

@@ -1,6 +1,14 @@
 # project
 /build/
 
+# cabal
+cabal.project.local
+cabal.project.local~
+/dist-newstyle/
+
+# nix
+result*
+
 # stack
 .stack-work
 *.yaml.lock
@@ -9,10 +17,5 @@ stack-nix*
 # stan
 /.hie/
 
-# cabal
-cabal.project.local
-cabal.project.local~
-/dist-newstyle/
-
 # vi
 .*.swp

CHANGELOG.md

@@ -24,6 +24,16 @@ following conventions:
 
 [KaC]: <https://keepachangelog.com/en/1.0.0/>
 
+## 0.7.0.0 (2021-06-25)
+
+### Breaking
+
+* Fix `--help` when using `optparse-applicative` `0.16`
+
+### Non-Breaking
+
+* Refactor Nix configuration
+
 ## 0.6.0.0 (2021-05-27)
 
 ### Breaking

Makefile

@@ -105,6 +105,7 @@ clean-all: clean # clean package and remove artifacts
 > @rm -rf dist-newstyle
 > @rm -f *.yaml.lock
 > @rm -f cabal.project.local
+> @rm -f result*
 .PHONY: clean-all
 
 coverage: hr

app/LibOA.hs

@@ -11,7 +11,7 @@
 -- projects as required.  If the library grows to a substantial size or others
 -- with to use it, I will reconsider.
 --
--- Revision: 2021-04-04
+-- Revision: 2021-06-24
 ------------------------------------------------------------------------------
 
 {-# LANGUAGE CPP #-}
@@ -42,6 +42,9 @@ import Data.Monoid ((<>))
 
 -- https://hackage.haskell.org/package/optparse-applicative
 import qualified Options.Applicative as OA
+#if MIN_VERSION_optparse_applicative (0,16,0)
+import qualified Options.Applicative.Builder.Internal as OABI
+#endif
 import qualified Options.Applicative.Common as OAC
 import qualified Options.Applicative.Types as OAT
 
@@ -59,6 +62,10 @@ helper :: OA.Parser (a -> a)
 helper = OA.option helpReader $ mconcat
     [ OA.short 'h'
     , OA.long "help"
+    , OA.value id
+    , OA.metavar ""
+    , OABI.noGlobal
+    , OA.noArgError (OA.ShowHelpText Nothing)
     , OA.help "show this help text"
     , OA.hidden
     ]

default.nix

@@ -1,35 +1,85 @@
+# Nix configuration for QueueSheet
+#
+# Usage:
+#
+# * Build QueueSheet with the default compiler:
+#
+#     $ nix-build
+#
+# * Build QueueSheet with a specific compiler version:
+#
+#     $ nix-build --argstr compiler ghc8104
+
+{ # This string argument specifies the compiler (example: "ghc8104").  When
+  # not specified, the default compiler (configured below) is used.
+  compiler ? null
+  # This path argument specifies the packages to use.  When not specified, a
+  # working revision for the selected compiler is used.  When a working
+  # revision for the selected compiler is not defined (below), the packages
+  # configured on the filesystem are used.
+, nixpkgs ? null
+  # This boolean argument is used by `shell.nix`.  When `True`, build tools
+  # are added to the derivation.
+, isShell ? false
+}:
+
 let
 
-  nixpkgsRev = "c92ca95afb5043bc6faa0d526460584eccff2277";
-  compilerVersion = "ghc8104";
+  # This string defines the default compiler version.
+  defaultCompiler = "ghc8104";
 
-  githubTarball = owner: repo: rev:
-    builtins.fetchTarball { url = "https://github.com/${owner}/${repo}/archive/${rev}.tar.gz"; };
+  # This set defines working revisions for supported compiler versions.
+  nixpkgsRevs = {
+    ghc8104 = "c92ca95afb5043bc6faa0d526460584eccff2277";
+    ghc884  = "c92ca95afb5043bc6faa0d526460584eccff2277";
+    # ghc865  = "2d9888f61c80f28b09d64f5e39d0ba02e3923057"; NOTE ginger broken
+    ghc844  = "6a80140fdf2157d1a5500a04c87033c0dcd6bf9b";
+    ghc822  = "6a80140fdf2157d1a5500a04c87033c0dcd6bf9b";
+  };
 
-  gitIgnore = pkgs.nix-gitignore.gitignoreSourcePure;
+  # This function fetches the specified nixpkgs revision.
+  nixpkgsTarball = rev:
+    builtins.fetchTarball {
+      url = "https://github.com/NixOS/nixpkgs/archive/${rev}.tar.gz";
+    };
 
-  config = {
-    packageOverrides = super: let self = super.pkgs; in rec {
-      haskell = super.haskell // {
-        packageOverrides = self: super: {
-          haskell-nix = super.callCabal2nix "haskell-nix" (gitIgnore [./.gitignore] ./.) {};
-        };
-      };
+  # This function fetches source from GitHub by tag.
+  githubTagTarball = owner: repo: tag:
+    builtins.fetchTarball {
+      url = "https://github.com/${owner}/${repo}/archive/refs/tags/${tag}.tar.gz";
     };
-  };
 
-  pkgs = import (githubTarball "NixOS" "nixpkgs" nixpkgsRev) { inherit config; };
-  compilerSet = pkgs.haskell.packages."${compilerVersion}";
+  # The compiler is explicitly specified or the default.
+  compiler' = if isNull compiler then defaultCompiler else compiler;
 
-in {
+  # Packages are explicitly specified, those for the revision defined for the
+  # selected compiler, or those configured on the filesystem.
+  pkgs = if isNull nixpkgs
+    then if nixpkgsRevs ? ${compiler'}
+      then import (nixpkgsTarball nixpkgsRevs.${compiler'}) {}
+      else import <nixpkgs> {}
+    else nixpkgs;
 
-  inherit pkgs;
+  # Git ignore functionality from a fixed `nixpkgs` revision is used.  Old
+  # revisions do not work, proably due to an API change.
+  gitIgnore = (
+    import (nixpkgsTarball nixpkgsRevs.ghc8104) {}
+  ).nix-gitignore.gitignoreSourcePure;
 
-  shell = compilerSet.shellFor {
-    packages = p: [p.haskell-nix];
-    buildInputs = with pkgs; [
-      compilerSet.cabal-install
-    ];
-  };
+in
 
-}
+  # Configure the development environment for the package using the selected
+  # packages and compiler.
+  pkgs.haskell.packages.${compiler'}.developPackage {
+    root = gitIgnore [./.gitignore] ./.;
+    name = "queue-sheet";
+    source-overrides = {
+      ttc = githubTagTarball "ExtremaIS" "ttc-haskell" "ttc-haskell-1.1.0.0";
+    };
+    modifier = drv:
+      if isShell
+        then pkgs.haskell.lib.addBuildTools drv
+          [ pkgs.cabal-install pkgs.texlive.combined.scheme-small
+          ]
+        else drv;
+  }

doc/queue-sheet.1

@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 2.9.1.1
+.\" Automatically generated by Pandoc 2.11.4
 .\"
-.TH "QUEUE-SHEET" "1" "" "queue-sheet-haskell 0.6.0.0 (2021-05-27)" "queue-sheet Manual"
+.TH "QUEUE-SHEET" "1" "" "queue-sheet-haskell 0.7.0.0 (2021-06-25)" "queue-sheet Manual"
 .nh
 .SH NAME
 .PP

project/release/queue-sheet-haskell-0.7.0.0.md

@@ -0,0 +1,32 @@
+# `queue-sheet-haskell` `0.7.0.0` Release Notes
+
+Date
+: 2021-06-25
+
+## Overview
+
+This release of Queue Sheet fixes a bug and makes changes to the [Nix][]
+configuration.  There are no changes to the Queue Sheet CLI.
+
+[Nix]: <https://nixos.org/>
+
+### Big Fix
+
+This release includes a fix for a bug that broke `--help` output.  The issue
+only affected builds using `optparse-applicative` `0.16`, so none of the
+published builds were affected.
+
+### Nix Configuration
+
+The Nix configuration now supports testing against the following GHC versions
+using known working `nixpkgs` revisions:
+
+* GHC 8.2.2
+* GHC 8.4.4
+* GHC 8.8.4
+* GHC 8.10.4
+
+Note that testing against the following GHC version using Nix is currently not
+working:
+
+* GHC 8.6.5, because `ginger` is marked as broken

queue-sheet.cabal

@@ -1,5 +1,5 @@
 name:           queue-sheet
-version:        0.6.0.0
+version:        0.7.0.0
 category:       Utils
 synopsis:       queue sheet utility
 description:

shell.nix

@@ -1 +1,23 @@
-(import ./default.nix).shell
+# Nix shell configuration for QueueSheet development
+#
+# Usage:
+#
+# * Run a Nix shell with the default compiler:
+#
+#     $ nix-shell
+#
+# * Run a Nix shell with a specific compiler version:
+#
+#     $ nix-shell --argstr compiler ghc8104
+
+{ # This string argument specifies the compiler (example: "ghc8104").  When
+  # not specified, the default compiler is used.
+  compiler ? null
+  # This path argument specifies the packages to use.  When not specified, a
+  # working revision for the selected compiler is used.  When a working
+  # revision for the selected compiler is not defined (below), the packages
+  # configured on the filesystem are used.
+, nixpkgs ? null
+}@args:
+
+import ./default.nix (args // { isShell = true; })

stack-8.10.4.yaml

@@ -1,7 +1,4 @@
-resolver: lts-17.13
+resolver: lts-18.0
 
 packages:
   - .
-
-extra-deps:
-  - ttc-0.4.0.0