.gitlab/generate-ci/flake.nix

+{
+  description = "GHC CI Generator";
+
+  inputs.flake-utils.url = "github:numtide/flake-utils";
+
+  outputs = { self, nixpkgs, flake-utils }:
+    flake-utils.lib.eachDefaultSystem (system:
+      let pkgs = nixpkgs.legacyPackages.${system}; in
+      {
+        packages = rec {
+          # The Haskell generator executable
+          generate-ci = pkgs.haskellPackages.callCabal2nix "generate-ci" ./. {};
+
+
+          # Wrapper scripts
+          generate-job-metadata = pkgs.runCommand "generate-job-metadata" {
+            nativeBuildInputs = with pkgs; [ makeWrapper ];
+          } ''
+            mkdir -p $out/bin
+            makeWrapper ${./generate-job-metadata} $out/bin/generate-job-metadata \
+              --prefix PATH : ${with pkgs; lib.makeBinPath [ generate-ci gitMinimal ]}
+          '';
+
+          generate-jobs = pkgs.runCommand "generate-jobs" {
+            nativeBuildInputs = with pkgs; [ makeWrapper ];
+          } ''
+            mkdir -p $out/bin
+            makeWrapper ${./generate-jobs} $out/bin/generate-jobs \
+              --prefix PATH : ${with pkgs; lib.makeBinPath [ generate-ci jq gitMinimal ]}
+          '';
+          default = generate-jobs;
+        };
+
+        apps = rec {
+          generate-jobs = flake-utils.lib.mkApp {
+            drv = self.packages.${system}.generate-jobs;
+          };
+
+          generate-job-metadata = flake-utils.lib.mkApp {
+            drv = self.packages.${system}.generate-job-metadata;
+          };
+
+          default = generate-jobs;
+        };
+      }
+    );
+}

.gitlab/generate-ci/generate-ci.cabal

+cabal-version:      3.0
+name:               generate-ci
+version:            0.1.0.0
+license:            BSD-3-Clause
+license-file:       LICENSE
+build-type:         Simple
+
+executable generate-ci
+    main-is:          gen_ci.hs
+    ghc-options:      -Wall
+    build-depends:    base,
+                      containers,
+                      bytestring,
+                      aeson >= 1.8.1
+    default-language: Haskell2010

.gitlab/generate-ci/generate-job-metadata

+#!/usr/bin/env bash
+
+set -e
+
+out_dir="$(git rev-parse --show-toplevel)/.gitlab"
+
+# Update job metadata for ghcup
+generate-ci metadata "$out_dir/jobs-metadata.json"
+echo "Updated $out_dir/jobs-metadata.json"

.gitlab/generate-ci/generate-jobs

+#!/usr/bin/env bash
+
+set -e
+
+out_dir="$(git rev-parse --show-toplevel)/.gitlab"
+
+tmp="$(mktemp)"
+generate-ci gitlab "$tmp"
+rm -f "$out_dir/jobs.yaml"
+echo "### THIS IS A GENERATED FILE, DO NOT MODIFY DIRECTLY" > "$out_dir/jobs.yaml"
+cat "$tmp" | jq >> "$out_dir/jobs.yaml"
+rm "$tmp"
+echo "Updated $out_dir/jobs.yaml"
+

.gitlab/generate-ci/hie.yaml

+cradle:
+  cabal:

.gitlab/hello.hs

+{-# OPTIONS_GHC -Wall -Wno-missing-fields #-}
+
+import GHC.Unit.Types (stringToUnitId)
+import GHC hiding (parseModule)
+import GHC.Data.StringBuffer
+import GHC.Driver.Config.Parser
+import GHC.Parser
+import GHC.Parser.Lexer
+import GHC.Platform
+import GHC.Plugins
+import GHC.Settings
+import GHC.Settings.Config
+import System.Mem.Weak
+
+fakeSettings :: Settings
+fakeSettings =
+  Settings
+    { sGhcNameVersion =
+        GhcNameVersion
+          { ghcNameVersion_programName =
+              "ghc",
+            ghcNameVersion_projectVersion =
+              cProjectVersion
+          },
+      sFileSettings =
+        FileSettings {},
+      sToolSettings = ToolSettings {},
+      sTargetPlatform =
+        genericPlatform,
+      sPlatformMisc = PlatformMisc {},
+      sUnitSettings = UnitSettings { unitSettings_baseUnitId = stringToUnitId "base" }
+    }
+
+fakeDynFlags :: DynFlags
+fakeDynFlags = defaultDynFlags fakeSettings
+
+parse :: DynFlags -> String -> IO (Located (HsModule GhcPs))
+parse dflags src = do
+  let buf = stringToStringBuffer src
+  let loc = mkRealSrcLoc (mkFastString "Main.hs") 1 1
+  case unP parseModule (initParserState (initParserOpts dflags) buf loc) of
+    PFailed _ -> fail "parseModule failed"
+    POk _ rdr_module -> pure rdr_module
+
+main :: IO ()
+main = do
+  _ <- mkWeak runGhc runGhc Nothing
+  m <- parse fakeDynFlags "main = putStrLn \"hello world\""
+  putStrLn $ showSDoc fakeDynFlags $ ppr m

.gitlab/issue_templates/bug.md

-## Summary
-
-Write a brief description of the issue.
-
-## Steps to reproduce
-
-Please provide a set of concrete steps to reproduce the issue.
-
-## Expected behavior
-
-What do you expect the reproducer described above to do?
-
-## Environment
-
-* GHC version used: 
-
-Optional:
-
-* Operating System: 
-* System Architecture: 
-
-
-/label ~bug
-/label ~"needs triage"

.gitlab/issue_templates/default.md

+## Summary
+
+Please read the guidance in [https://gitlab.haskell.org/ghc/ghc/-/wikis/report-a-bug] and write a brief description of the issue.
+
+## Steps to reproduce
+
+Please provide a set of concrete steps to reproduce the issue.
+
+## Expected behavior
+
+What do you expect the reproducer described above to do?
+
+## Environment
+
+* GHC version used: 
+
+Optional:
+
+* Operating System: 
+* System Architecture: 
+
+
+/label ~bug
+/label ~"needs triage"

.gitlab/issue_templates/documentation_issue.md

+## Summary
+
+Location of documentation issue: (e.g. the Haddocks of `base`, the GHC user's guide)
+
+Write a brief description of the issue.
+
+
+## Proposed improvements or changes
+
+Feel free to propose changes, either concrete or abstract.
+
+
+## Environment
+
+* GHC version used (if appropriate): 
+
+
+
+/label ~bug
+/label ~documentation
+/label ~"needs triage"
+

.gitlab/issue_templates/feature_request.md

+<!--
+READ THIS FIRST: If the feature you are proposing changes the language that GHC accepts
+or adds any warnings to `-Wall`, it should be written as a [GHC Proposal](https://github.com/ghc-proposals/ghc-proposals/).
+Other features, appropriate for a GitLab feature request, include GHC API/plugin
+innovations, new low-impact compiler flags, or other similar additions to GHC.
+-->
+
 ## Motivation
 
 Briefly describe the problem your proposal solves and why this problem should

.gitlab/linters/check-cpp.py

-#!/usr/bin/env python3
-
-# A linter to warn for ASSERT macros which are separated from their argument
-# list by a space, which Clang's CPP barfs on
-
-from pathlib import Path
-from linter import run_linters, RegexpLinter
-
-linters = [
-    RegexpLinter(r'WARN\s+\(',
-                 message='CPP macros should not have a space between the macro name and their argument list'),
-    RegexpLinter(r'ASSERT\s+\(',
-                 message='CPP macros should not have a space between the macro name and their argument list'),
-    RegexpLinter(r'ASSERT2\s+\(',
-                 message='CPP macros should not have a space between the macro name and their argument list'),
-    RegexpLinter(r'#ifdef\s+',
-                 message='`#if defined(x)` is preferred to `#ifdef x`'),
-    RegexpLinter(r'#if\s+defined\s+',
-                 message='`#if defined(x)` is preferred to `#if defined x`'),
-    RegexpLinter(r'#ifndef\s+',
-                 message='`#if !defined(x)` is preferred to `#ifndef x`'),
-]
-
-for l in linters:
-    # Need do document rules!
-    l.add_path_filter(lambda path: path != Path('docs', 'coding-style.html'))
-    # Don't lint vendored code
-    l.add_path_filter(lambda path: not path.name == 'config.guess')
-
-if __name__ == '__main__':
-    run_linters(linters)

.gitlab/linters/check-makefiles.py

-#!/usr/bin/env python3
-
-"""
-Warn for use of `--interactive` inside Makefiles (#11468).
-
-Encourage the use of `$(TEST_HC_OPTS_INTERACTIVE)` instead of
-`$(TEST_HC_OPTS) --interactive -ignore-dot-ghci -v0`. It's too easy to
-forget one of those flags when adding a new test.
-"""
-
-from linter import run_linters, RegexpLinter
-
-linters = [
-    RegexpLinter(r'--interactive',
-                 message = "Warning: Use `$(TEST_HC_OPTS_INTERACTIVE)` instead of `--interactive -ignore-dot-ghci -v0`."
-                ).add_path_filter(lambda path: path.name == 'Makefile')
-]
-
-if __name__ == '__main__':
-    run_linters(linters,
-                subdir='testsuite')

.gitlab/linters/check-version-number.sh

-#!/usr/bin/env bash
-
-set -e
-
-grep -E -q '\[[0-9]+\.[0-9]+\.[0-9]+\]' configure.ac ||
-  ( echo "error: configure.ac: GHC version number must have three components."; exit 1 )

.gitlab/merge_request_templates/Default.md

+Thank you for your contribution to GHC!
+
+**Please read the checklist below to make sure your contribution fulfills these
+expectations. Also please answer the following question in your MR description:**
+
+**Where is the key part of this patch? That is, what should reviewers look at first?**
+
+Please take a few moments to address the following points:
+
+ * [ ] if your MR touches `base` (or touches parts of `ghc-internal` used
+   or re-exported by `base`) more substantially than just amending comments
+   or documentation, you likely need to raise a
+   [CLC proposal](https://github.com/haskell/core-libraries-committee#base-package)
+   before merging it.
+ * [ ] if your MR may break existing programs (e.g. causes the
+   compiler to reject programs), please describe the expected breakage and add
+   the ~"user-facing" label. This will run ghc/head.hackage> to characterise
+   the effect of your change on Hackage.
+ * [ ] ensure that your commits are either individually buildable or squashed
+ * [ ] ensure that your commit messages describe *what they do*
+   (referring to tickets using `#NNNN` syntax when appropriate)
+ * [ ] have added source comments describing your change. For larger changes you
+   likely should add a [Note][notes] and cross-reference it from the relevant
+   places.
+ * [ ] add a [testcase to the testsuite][adding test].
+ * [ ] updates the users guide if applicable
+ * [ ] mentions new features in the release notes for the next release
+
+If you have any questions don't hesitate to open your merge request and inquire
+in a comment. If your patch isn't quite done yet please do add prefix your MR
+title with `WIP:`.
+
+By default a minimal validation pipeline is run on each merge request, the ~full-ci
+label can be applied to perform additional validation checks if your MR affects a more
+unusual configuration.
+
+Once your change is ready please remove the `WIP:` tag and wait for review. If
+no one has offered a review in a few days then please leave a comment mentioning
+@triagers and apply the ~"Blocked on Review" label.
+
+[notes]: https://gitlab.haskell.org/ghc/ghc/wikis/commentary/coding-style#comments-in-the-source-code
+[adding test]: https://gitlab.haskell.org/ghc/ghc/wikis/building/running-tests/adding

.gitlab/merge_request_templates/Haddock.md

+Thank your for your contribution to Haddock!
+
+  * [ ] This MR relates to \<ticket number>
+  * [ ] I have read the [CONTRIBUTING](./utils/haddock/CONTRIBUTING.md) guide
+  * [ ] I have inserted a CHANGELOG entry if this warrants it
+  * [ ] I have squashed my commits
+  * [ ] I have added tests if necessary
+
+  * [ ] I have updated the documentation
+
+If you have any questions don't hesitate to open your merge request and inquire
+in a comment. If your patch isn't quite done yet please do add prefix your MR
+title with `Draft:`.
+
+Once your change is ready please remove the `Draft:` tag and wait for review. If
+no one has offered a review in a few days then please leave a comment mentioning
+@triagers and apply the ~"Blocked on Review" label.

.gitlab/merge_request_templates/backport-for-8.8.md

-Thank you for help in maintaining GHC's stable branch!
-
-Please take a few moments to verify the following:
-
- * [ ] the issue that this backport fixes is milestoned for the target release.
-
-If you have any questions don't hesitate to open your merge request and inquire
-in a comment.
-
-/label ~backport
-/milestone %8.8.1

.gitlab/merge_request_templates/merge-request.md

-Thank you for your contribution to GHC!
-
-Please take a few moments to verify that your commits fulfill the following:
-
- * [ ] are either individually buildable or squashed
- * [ ] have commit messages which describe *what they do*
-   (referring to [Notes][notes] and tickets using `#NNNN` syntax when
-   appropriate)
- * [ ] have added source comments describing your change. For larger changes you
-   likely should add a [Note][notes] and cross-reference it from the relevant
-   places.
- * [ ] add a [testcase to the
-   testsuite](https://gitlab.haskell.org/ghc/ghc/wikis/building/running-tests/adding).
- * [ ] if your MR affects library interfaces (e.g. changes `base`) please add
-   the ~"user facing" label.
-
-If you have any questions don't hesitate to open your merge request and inquire
-in a comment. If your patch isn't quite done yet please do add prefix your MR
-title with `WIP:`.
-
-[notes]: https://gitlab.haskell.org/ghc/ghc/wikis/commentary/coding-style#comments-in-the-source-code

.gitlab/prepare-system.sh

-#!/usr/bin/env bash
-# vim: sw=2 et
-set -euo pipefail
-
-fail() {
-  echo "ERROR: $*" >&2
-  exit 1
-}
-
-hackage_index_state="@1522046735"
-
-if [[ -z ${BUILD_SPHINX_HTML:-} ]]; then BUILD_SPHINX_HTML=YES; fi
-if [[ -z ${BUILD_SPHINX_PDF:-} ]]; then BUILD_SPHINX_PDF=YES; fi
-if [[ -z ${INTEGER_LIBRARY:-} ]]; then INTEGER_LIBRARY=integer-gmp; fi
-if [[ -z ${BUILD_FLAVOUR:-} ]]; then BUILD_FLAVOUR=perf; fi
-
-cat > mk/build.mk <<EOF
-V=1
-HADDOCK_DOCS=YES
-LATEX_DOCS=YES
-HSCOLOUR_SRCS=YES
-BUILD_SPHINX_HTML=$BUILD_SPHINX_HTML
-BUILD_SPHINX_PDF=$BUILD_SPHINX_PDF
-BeConservative=YES
-INTEGER_LIBRARY=$INTEGER_LIBRARY
-EOF
-
-cat <<EOF >> mk/build.mk
-BuildFlavour=$BUILD_FLAVOUR
-ifneq "\$(BuildFlavour)" ""
-include mk/flavours/\$(BuildFlavour).mk
-endif
-GhcLibHcOpts+=-haddock
-EOF
-
-case "$(uname)" in
-  Linux)
-    if [[ -n ${TARGET:-} ]]; then
-      if [[ $TARGET = FreeBSD ]]; then
-        # cross-compiling to FreeBSD
-        echo 'HADDOCK_DOCS = NO' >> mk/build.mk
-        echo 'WERROR=' >> mk/build.mk
-        # https://circleci.com/docs/2.0/env-vars/#interpolating-environment-variables-to-set-other-environment-variables
-        echo 'export PATH=/opt/ghc/bin:$PATH' >> $BASH_ENV
-      else
-        fail "TARGET=$target not supported"
-      fi
-    fi
-    ;;
-
-  Darwin)
-    if [[ -n ${TARGET:-} ]]; then
-      fail "uname=$(uname) not supported for cross-compilation"
-    fi
-    # It looks like we already have python2 here and just installing python3
-    # does not work.
-    brew upgrade python
-    brew install ghc cabal-install ncurses gmp
-
-    pip3 install sphinx
-    # PDF documentation disabled as MacTeX apparently doesn't include xelatex.
-    #brew cask install mactex
-
-    cabal update
-    cabal install --reinstall alex happy haddock hscolour --index-state=$hackage_index_state
-    # put them on the $PATH, don't fail if already installed
-    ln -s $HOME/.cabal/bin/alex /usr/local/bin/alex || true
-    ln -s $HOME/.cabal/bin/happy /usr/local/bin/happy || true
-    ln -s $HOME/.cabal/bin/HsColour /usr/local/bin/HsColour || true
-    echo "libraries/integer-gmp_CONFIGURE_OPTS += --configure-option=--with-intree-gmp" >> mk/build.mk
-    ;;
-  *)
-    fail "uname=$(uname) not supported"
-esac
-
-echo "================================================="
-echo "Build.mk:"
-echo ""
-cat mk/build.mk
-echo "================================================="