Makefile

   1 .PHONY : all lexer sdpx lib exe doctest
   2 .PHONY : phony
   3
   4 CABALBUILD := cabal v2-build
   5 CABALRUN   := cabal v2-run
   6
   7 # default rules
   8
   9 all : exe lib
  10
  11 lib : $(LEXER_HS)
  12         $(CABALBUILD) Cabal:libs
  13
  14 exe : $(LEXER_HS)
  15         $(CABALBUILD) cabal-install:exes
  16
  17 # source generation: Lexer
  18
  19 LEXER_HS:=Cabal-syntax/src/Distribution/Fields/Lexer.hs
  20
  21 lexer : $(LEXER_HS)
  22
  23 $(LEXER_HS) : templates/Lexer.x
  24         alex --latin1 --ghc -o $@ $^
  25         cat -s $@ > Lexer.tmp
  26         mv Lexer.tmp $@
  27
  28 # source generation: SPDX
  29
  30 SPDX_LICENSE_HS:=Cabal-syntax/src/Distribution/SPDX/LicenseId.hs
  31 SPDX_EXCEPTION_HS:=Cabal-syntax/src/Distribution/SPDX/LicenseExceptionId.hs
  32
  33 spdx : $(SPDX_LICENSE_HS) $(SPDX_EXCEPTION_HS)
  34
  35 SPDX_LICENSE_VERSIONS:=3.0 3.2 3.6 3.9 3.10 3.16
  36
  37 $(SPDX_LICENSE_HS) : templates/SPDX.LicenseId.template.hs cabal-dev-scripts/src/GenUtils.hs cabal-dev-scripts/src/GenSPDX.hs license-list-data/licenses-3.0.json license-list-data/licenses-3.2.json
  38         cabal v2-run --builddir=dist-newstyle-meta --project-file=cabal.project.meta gen-spdx -- templates/SPDX.LicenseId.template.hs $(SPDX_LICENSE_VERSIONS:%=license-list-data/licenses-%.json) $(SPDX_LICENSE_HS)
  39
  40 $(SPDX_EXCEPTION_HS) : templates/SPDX.LicenseExceptionId.template.hs cabal-dev-scripts/src/GenUtils.hs cabal-dev-scripts/src/GenSPDXExc.hs license-list-data/exceptions-3.0.json license-list-data/exceptions-3.2.json
  41         cabal v2-run --builddir=dist-newstyle-meta --project-file=cabal.project.meta gen-spdx-exc -- templates/SPDX.LicenseExceptionId.template.hs $(SPDX_LICENSE_VERSIONS:%=license-list-data/exceptions-%.json) $(SPDX_EXCEPTION_HS)
  42
  43 # source generation: templates
  44
  45 TEMPLATE_MACROS:=Cabal/src/Distribution/Simple/Build/Macros/Z.hs
  46 TEMPLATE_PATHS:=Cabal/src/Distribution/Simple/Build/PathsModule/Z.hs
  47
  48 templates : phony $(TEMPLATE_MACROS) $(TEMPLATE_PATHS)
  49
  50 $(TEMPLATE_MACROS) : templates/cabal_macros.template.h cabal-dev-scripts/src/GenCabalMacros.hs
  51         cabal v2-run --builddir=dist-newstyle-meta --project-file=cabal.project.meta gen-cabal-macros -- $< $@
  52
  53 $(TEMPLATE_PATHS) : templates/Paths_pkg.template.hs cabal-dev-scripts/src/GenPathsModule.hs
  54         cabal v2-run --builddir=dist-newstyle-meta --project-file=cabal.project.meta gen-paths-module -- $< $@
  55
  56 # generated docs
  57
  58 buildinfo-fields-reference : phony
  59         cabal build --builddir=dist-newstyle-bi --project-file=cabal.project.buildinfo buildinfo-reference-generator
  60         $$(cabal-plan list-bin --builddir=dist-newstyle-bi buildinfo-reference-generator) buildinfo-reference-generator/template.zinza | tee $@
  61
  62 # analyse-imports
  63 analyse-imports : phony
  64         find Cabal-syntax/src Cabal/src cabal-install/src -type f -name '*.hs' | xargs cabal v2-run --builddir=dist-newstyle-meta --project-file=cabal.project.meta analyse-imports --
  65
  66 # ghcid
  67
  68 ghcid-lib :
  69         ghcid -c 'cabal v2-repl Cabal'
  70
  71 ghcid-cli :
  72         ghcid -c 'cabal v2-repl cabal-install'
  73
  74 # doctests (relies on .ghc.environment files)
  75
  76 doctest :
  77         doctest --fast Cabal-syntax/src Cabal/src
  78
  79 # This is not run as part of validate.sh (we need hackage-security, which is tricky to get).
  80 doctest-cli :
  81         doctest -D__DOCTEST__ --fast cabal-install/src cabal-install-solver/src cabal-install-solver/src-assertion
  82
  83 # tests
  84
  85 check-tests :
  86         $(CABALRUN) check-tests -- --cwd Cabal-tests ${TEST}
  87
  88 parser-tests :
  89         $(CABALRUN) parser-tests -- --cwd Cabal-tests ${TEST}
  90
  91 parser-tests-accept :
  92         $(CABALRUN) parser-tests -- --cwd Cabal-tests --accept ${TEST}
  93
  94 custom-setup-tests :
  95         $(CABALRUN) custom-setup-tests --
  96
  97 hackage-parsec-tests :
  98         $(CABALRUN) hackage-tests -- parsec +RTS -s -qg -I0 -A64M -N${THREADS} -RTS ${TEST}
  99
 100 hackage-roundtrip-tests :
 101         $(CABALRUN) hackage-tests -- roundtrip +RTS -s -qg -I0 -A64M -N${THREADS} -RTS ${TEST}
 102
 103 cabal-install-test:
 104         @which cabal-plan
 105         $(CABALBUILD) -j3 cabal-tests cabal
 106         rm -rf .ghc.environment.*
 107         cd cabal-testsuite && `cabal-plan list-bin cabal-tests` --with-cabal=`cabal-plan list-bin cabal` --hide-successes -j3 ${TEST}
 108
 109 # hackage-benchmarks (solver)
 110
 111 hackage-benchmarks-run:
 112         $(CABALBUILD) -j3 hackage-benchmark cabal
 113         rm -rf .ghc.environment.*
 114         $$(cabal-plan list-bin hackage-benchmark) --cabal1=cabal --cabal2=$$(cabal-plan list-bin cabal) --packages="hakyll servant-auth-server" --print-trials --concurrently
 115
 116
 117 # This doesn't run build, as you first need to test with cabal-install-test :)
 118 cabal-install-test-accept:
 119         @which cabal-plan
 120         rm -rf .ghc.environment.*
 121         cd cabal-testsuite && `cabal-plan list-bin cabal-tests` --with-cabal=`cabal-plan list-bin cabal` --hide-successes -j3 --accept ${TEST}
 122
 123 # Docker validation
 124
 125 # Use this carefully, on big machine you can say
 126 #
 127 #   make validate-via-docker-all -j4 -O
 128 #
 129 validate-via-docker-all : validate-via-docker-8.0.2
 130 validate-via-docker-all : validate-via-docker-8.2.2
 131 validate-via-docker-all : validate-via-docker-8.4.4
 132 validate-via-docker-all : validate-via-docker-8.6.5
 133 validate-via-docker-all : validate-via-docker-8.8.4
 134 validate-via-docker-all : validate-via-docker-8.10.4
 135
 136 validate-dockerfiles : .docker/validate-8.10.4.dockerfile
 137 validate-dockerfiles : .docker/validate-8.8.4.dockerfile
 138 validate-dockerfiles : .docker/validate-8.6.5.dockerfile
 139 validate-dockerfiles : .docker/validate-8.4.4.dockerfile
 140 validate-dockerfiles : .docker/validate-8.2.2.dockerfile
 141 validate-dockerfiles : .docker/validate-8.6.5.dockerfile
 142
 143 .docker/validate-%.dockerfile : .docker/validate.dockerfile.zinza cabal-dev-scripts/src/GenValidateDockerfile.hs
 144         cabal v2-run --builddir=dist-newstyle-meta --project-file=cabal.project.meta gen-validate-dockerfile -- $* $< $@
 145
 146 # This is good idea anyway
 147 # and we have a test relying on this limit being sufficiently small
 148 DOCKERARGS:=--ulimit nofile=1024:1024
 149
 150 validate-via-docker-8.0.2:
 151         docker build $(DOCKERARGS) -t cabal-validate:8.0.2 -f .docker/validate-8.0.2.dockerfile .
 152
 153 validate-via-docker-8.2.2:
 154         docker build $(DOCKERARGS) -t cabal-validate:8.2.2 -f .docker/validate-8.2.2.dockerfile .
 155
 156 validate-via-docker-8.4.4:
 157         docker build $(DOCKERARGS) -t cabal-validate:8.4.4 -f .docker/validate-8.4.4.dockerfile .
 158
 159 validate-via-docker-8.6.5:
 160         docker build $(DOCKERARGS) -t cabal-validate:8.6.5 -f .docker/validate-8.6.5.dockerfile .
 161
 162 validate-via-docker-8.8.4:
 163         docker build $(DOCKERARGS) -t cabal-validate:8.8.4 -f .docker/validate-8.8.4.dockerfile .
 164
 165 validate-via-docker-8.10.4:
 166         docker build $(DOCKERARGS) -t cabal-validate:8.10.4 -f .docker/validate-8.10.4.dockerfile .
 167
 168 validate-via-docker-old:
 169         docker build $(DOCKERARGS) -t cabal-validate:older -f .docker/validate-old.dockerfile .
 170
 171 # Weeder
 172 weeder :
 173         cabal build all --project-file=cabal.project.weeder
 174         weeder | less
 175
 176 # tags
 177 .PHONY : tags
 178 tags :
 179         hasktags -b Cabal-syntax/src Cabal/src Cabal-described/src cabal-install/src cabal-testsuite/src
 180
 181 # bootstrapping
 182 ##############################################################################
 183
 184 bootstrap-json-%: phony
 185         cabal v2-build --project=cabal.project.release --with-compiler=ghc-$* --dry-run cabal-install:exe:cabal
 186         cp dist-newstyle/cache/plan.json bootstrap/linux-$*.plan.json
 187         @# -v0 to avoid build output on stdout
 188         cd bootstrap && cabal v2-run -v0 cabal-bootstrap-gen -- linux-$*.plan.json \
 189                 | python3 -m json.tool > linux-$*.json
 190
 191 BOOTSTRAP_GHC_VERSIONS := 8.6.5 8.8.4 8.10.7 9.0.2 9.2.3
 192
 193 bootstrap-jsons: $(BOOTSTRAP_GHC_VERSIONS:%=bootstrap-json-%)
 194
 195 # documentation
 196 ##############################################################################
 197
 198 # TODO: when we have sphinx-build2 ?
 199 SPHINXCMD:=sphinx-build
 200 # Flag -n ("nitpick") warns about broken references
 201 # Flag -W turns warnings into errors
 202 # Flag --keep-going continues after errors
 203 SPHINX_FLAGS:=-n -W --keep-going -E
 204 SPHINX_HTML_OUTDIR:=dist-newstyle/doc/users-guide
 205 USERGUIDE_STAMP:=$(SPHINX_HTML_OUTDIR)/index.html
 206
 207 # do pip install every time so we have up to date requirements when we build
 208 users-guide: .python-sphinx-virtualenv $(USERGUIDE_STAMP)
 209 $(USERGUIDE_STAMP) : doc/*.rst
 210         mkdir -p $(SPHINX_HTML_OUTDIR)
 211         (. ./.python-sphinx-virtualenv/bin/activate && pip install -r doc/requirements.txt && $(SPHINXCMD) $(SPHINX_FLAGS) doc $(SPHINX_HTML_OUTDIR))
 212
 213 .python-sphinx-virtualenv:
 214         python3 -m venv .python-sphinx-virtualenv
 215         (. ./.python-sphinx-virtualenv/bin/activate)
 216
 217 # This goal is intended for manual invocation, always rebuilds.
 218 .PHONY: users-guide-requirements
 219 users-guide-requirements: doc/requirements.txt
 220
 221 .PHONY: doc/requirements.txt
 222 doc/requirements.txt: .python-sphinx-virtualenv
 223         . .python-sphinx-virtualenv/bin/activate \
 224           && make -C doc build-and-check-requirements