.github/tl_packages

@@ -0,0 +1,56 @@
+# The test framework itself
+#
+luatex
+#
+# Required to build formats
+#
+latex-bin
+luahbtex
+platex
+uplatex
+tex
+xetex
+# Requirements for the tests
+amsfonts
+etex-pkg
+#
+# Support for typesetting the docs
+#
+alphalph
+atbegshi
+atveryend
+amsmath
+bigintcalc
+bitset
+booktabs
+ec
+colortbl
+csquotes
+enumitem
+etexcmds
+fancyvrb
+gettitlestring
+graphics
+hologo
+hycolor
+iftex
+intcalc
+kvdefinekeys
+kvsetkeys
+l3packages
+letltxmacro
+listings
+ltxcmds
+makeindex
+needspace
+oberdiek
+pdfescape
+pdftexcmds
+psnfss
+refcount
+rerunfilecheck
+hyperref
+titlesec
+tools
+underscore
+uniquecounter

.github/workflows/deploy.yaml

@@ -0,0 +1,54 @@
+name: Create release
+
+# We create releases for all new tags
+on:
+  push:
+    tags:
+      - "*"
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    name: Build release
+    environment: Release
+    steps:
+      # Boilerplate
+      - name: Checkout repository
+        uses: actions/checkout@v2
+      # GitHub Actions don't regenerate the test if the key doesn't change, so
+      # we integrate a random UUID into the key to keep them different.
+      # DO NOT CHANGE THIS
+      - name: Generate unique ID
+        id: get-id
+        run: |
+          echo -n ::set-output name=id::
+          cat /proc/sys/kernel/random/uuid
+      # Actually load the cache. Since we never reuse the key, we need restore-keys
+      # to indicate the prefix of our caches. This loads the newest cache with this
+      # prefix in the key.
+      #
+      # If we want to force regeneration of the cache, increase the number after
+      # *both* instances of "texlive-v"
+      - name: Load cache
+        uses: actions/cache@v2
+        with:
+          path: ~/texlive
+          key: texlive-v0-${{ steps.get-id.outputs.id }}
+          restore-keys: texlive-v0-
+      # We need Ghostscript for XeTeX tests.
+      - run: sudo apt-get install ghostscript
+      - name: Install TeX Live
+        uses: zauguin/install-texlive@v1
+        with:
+          # List the required TeX Live packages in a separate file to allow reuse in
+          # different workflows.
+          package_file: .github/tl_packages
+      - name: Run l3build
+        run: texlua l3build.lua ctan -H --show-log-on-error
+      # Now create the release (this only runs if the previous steps were successful)
+      - name: Create GitHub release
+        uses: ncipollo/release-action@880be3d0a71bc0fa98db60201d2cbdc27324f547
+        id: release
+        with:
+          artifacts: "build/distrib/ctan/*.zip"
+          token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/main.yaml

@@ -0,0 +1,45 @@
+name: Automated testing
+
+on:
+  push:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  l3build:
+    runs-on: ubuntu-latest
+    steps:
+      # Boilerplate
+      - name: Checkout repository
+        uses: actions/checkout@v2
+      # GitHub Actions don't regenerate the test if the key doesn't change, so
+      # we integrate a random UUID into the key to keep them different.
+      # DO NOT CHANGE THIS
+      - name: Generate unique ID
+        id: get-id
+        run: |
+          echo -n ::set-output name=id::
+          cat /proc/sys/kernel/random/uuid
+      # Actually load the cache. Since we never reuse the key, we need restore-keys
+      # to indicate the prefix of our caches. This loads the newest cache with this
+      # prefix in the key.
+      #
+      # If we want to force regeneration of the cache, increase the number after
+      # *both* instances of "texlive-v"
+      - name: Load cache
+        uses: actions/cache@v2
+        with:
+          path: ~/texlive
+          key: texlive-v0-${{ steps.get-id.outputs.id }}
+          restore-keys: texlive-v0-
+      # We need Ghostscript for XeTeX tests.
+      - run: sudo apt-get install ghostscript
+      - name: Install TeX Live
+        uses: zauguin/install-texlive@v1
+        with:
+          # List the required TeX Live packages in a separate file to allow reuse in
+          # different workflows.
+          package_file: .github/tl_packages
+      - name: Run l3build
+        run: texlua l3build.lua ctan -H --show-log-on-error

.gitignore

@@ -1,5 +1,20 @@
-build/
-*.pdf
+build/*
+
 *.zip
-!testfiles/*.pdf
 
+*.pdf
+!*/testfiles/*.pdf
+
+*.*~
+
+*.aux
+*.bbl
+*.glo
+*.gz
+*.hd
+*.idx
+*.ilg
+*.ind
+*.log
+*.out
+*.toc

CHANGELOG.md

@@ -7,6 +7,114 @@ this project uses date-based 'snapshot' version identifiers.
 
 ## [Unreleased]
 
+### Changed
+- Documentation improvements
+
+## [2021-08-28]
+
+### Fixed
+- Creation of zip files on Windows
+- Only match filename and not full path for `exefiles`
+
+## [2021-08-27]
+
+### Added
+- Add the `--show-saves` flag for `l3build check` to generate a list of
+  `l3build save` commands to regenerate all failing tests
+
+### Changed
+- No longer call an external program to generate `zip` files and generate
+  them directly instead. This disables the options `zipexe` and `zipopts`.
+- Copy TDS-style zip files to main dir
+
+## [2021-05-06]
+
+### Fixed
+- Issue when running PDF-based tests
+
+## [2021-05-05]
+
+### Changed
+- Normalise Lua function calls (issue #127) - may require `.tlg` update
+- LuaTeX from TL'21 is no longer 'off by one' in log files - may require
+  `.tlg` update
+
+### Fixed
+- Installation now supports deeper directory levels (issue #182)
+- The `texmfhome` directory is now created before use if required
+- Crash caused by yyyy-mm-dd epoch format
+
+### Removed
+- Support for use as `texlua build.lua <target>`
+
+## [2020-06-04]
+
+### Added
+- Store 'raw' PDF files when testing using PDFs, to allow further checks
+  with e.g. PDF validators
+
+## [2020-03-25]
+
+### Changed
+- Exclude `sourcefiles` entries from file clean-up
+- Adjust defaults for TeX Live 2020 LuaHBTeX usage
+
+## [2020-03-16]
+
+### Changed
+- Suppress PDF compression in DVI route
+- Suppress PDF ID data in DVI route
+- Default to `dvips` for (p)TeX
+- Refinement of `/ID` line suppression
+
+## [2020-03-13]
+
+### Changed
+- Refinement of PDF test normalisation
+
+## [2020-03-12]
+
+### Added
+- Option `ps2pdfopt`
+
+### Changed
+- Normalise `/ID` lines in PDF comparisons
+- Normalise `%%` lines in PDF comparisons
+
+### Fixed
+- Enable `cleandir()` recursively
+- Install files after *all* directory cleaning/creation
+
+## [2020-02-21]
+
+### Changed
+- Avoid temporary file when unpacking
+
+### Deprecated
+- `os_yes`: use `io.popen(...,w)` instead
+
+## [2020-02-17]
+
+### Added
+- Variable `textfiledir`
+- Table `specialtypesetting` and support data
+
+### Changed
+- Documentation improvements
+
+### Fixed
+- When `checkruns` > 1 and `recordstatus=true`, testing code would crash
+  (issue #90)
+
+## [2020-02-03]
+
+### Changed
+- Normalise out DVI header lines
+
+### Fixed
+- Allow announcement field to be empty
+  (with a warning this suppresses the CTAN announcement)
+
 ## [2020-01-14]
 
 ### Fixed
@@ -402,9 +510,21 @@ this project uses date-based 'snapshot' version identifiers.
 
 ### Removed
 - Rationalise short option names: removed `-d`, `-E`, `-r`
-- Target `cmdcheck`: specific to LaTeX3 kernel work
-
-[Unreleased]: https://github.com/latex3/l3build/compare/2020-01-14...HEAD
+- Target `cmdcheck`: specific to LaTeX kernel work
+
+[Unreleased]: https://github.com/latex3/l3build/compare/2021-08-28...HEAD
+[2021-08-28]: https://github.com/latex3/l3build/compare/2021-08-27...2021-08-28
+[2021-08-27]: https://github.com/latex3/l3build/compare/2021-05-06...2021-08-27
+[2021-05-06]: https://github.com/latex3/l3build/compare/2021-05-05...2021-05-06
+[2021-05-05]: https://github.com/latex3/l3build/compare/2020-06-04...2021-05-05
+[2020-06-04]: https://github.com/latex3/l3build/compare/2020-03-25...2020-06-04
+[2020-03-25]: https://github.com/latex3/l3build/compare/2020-03-16...2020-03-25
+[2020-03-16]: https://github.com/latex3/l3build/compare/2020-03-13...2020-03-16
+[2020-03-13]: https://github.com/latex3/l3build/compare/2020-03-12...2020-03-13
+[2020-03-12]: https://github.com/latex3/l3build/compare/2020-02-21...2020-03-12
+[2020-02-21]: https://github.com/latex3/l3build/compare/2020-02-17...2020-02-21
+[2020-02-17]: https://github.com/latex3/l3build/compare/2020-02-03...2020-02-17
+[2020-02-03]: https://github.com/latex3/l3build/compare/2020-01-14...2020-02-03
 [2020-01-14]: https://github.com/latex3/l3build/compare/2019-11-27...2020-01-14
 [2019-11-27]: https://github.com/latex3/l3build/compare/2019-11-01...2019-11-27
 [2019-11-01]: https://github.com/latex3/l3build/compare/2019-10-02...2019-11-01

CONTRIBUTING.md

@@ -1,5 +1,5 @@
 Thanks for considering contributing to `l3build`: feedback, fixes and ideas are
-all useful. Here, we ([The LaTeX3 Project](https://www.latex-project.org)) have
+all useful. Here, we ([The LaTeX Project](https://www.latex-project.org)) have
 collected together a few pointers to help things along.
 
 ## Bugs

README.md

@@ -1,7 +1,7 @@
-l3build: a testing and building system for LaTeX3
+l3build: a testing and building system for LaTeX
 =================================================
 
-Release 2020-01-14
+Release 2021-08-28
 
 Overview
 --------
@@ -14,23 +14,23 @@ high-quality LaTeX code by providing:
 
 The bundle consists of a Lua script to run the tasks and a
 `.tex` file which provides the testing environment. These were
-originally developed for supporting LaTeX3 development but
+originally developed for supporting LaTeX development but
 are designed such that they can be readily used by others. Full
 documentation is provided.
 
 Issues
 ------
 
-The issue tracker for LaTeX3 is currently located
+The issue tracker for LaTeX is currently located
 [on GitHub](https://github.com/latex3/l3build/issues).
 
 Development team
 ----------------
 
-The LaTeX kernel is developed by [The LaTeX3 Project](https://latex-project.org).
+The LaTeX kernel is developed by [The LaTeX Project](https://latex-project.org).
 
 -----
 
-<p>Copyright (C) 2014-2020 The LaTeX3 Project <br />
+<p>Copyright (C) 2014-2021 The LaTeX Project <br />
 <a href="http://latex-project.org/">http://latex-project.org/</a> <br />
 All rights reserved.</p>

build.lua

@@ -1,6 +1,6 @@
 #!/usr/bin/env texlua
 
--- Build script for LaTeX3 "l3build" files
+-- Build script for LaTeX "l3build" files
 
 -- Identify the bundle and module
 module = "l3build"
@@ -11,11 +11,13 @@ checkconfigs = {"build", "config-pdf", "config-plain"}
 checkdeps    = { }
 checkengines = {"pdftex", "xetex", "luatex", "ptex", "uptex"}
 cleanfiles   = {"*.pdf", "*.tex", "*.zip"}
+exefiles     = {"l3build.lua"}
 installfiles = {"regression-test.tex"}
 packtdszip   = true
 scriptfiles  = {"l3build*.lua"}
 scriptmanfiles = {"l3build.1"}
 sourcefiles  = {"*.dtx", "l3build*.lua", "*.ins"}
+typesetruns  = 4
 typesetcmds  = "\\AtBeginDocument{\\DisableImplementation}"
 unpackdeps   = { }
 tagfiles     = {"l3build.1", "l3build.dtx", "*.md", "l3build.lua"}

examples/Bundle-Flat/README.md

@@ -10,6 +10,6 @@ in the build script for each module.
 
 -----
 
-Copyright (C) 2014-2017 The LaTeX3 Project <br />
+Copyright (C) 2014-2017,2021 The LaTeX Project <br />
 <http://latex-project.org/> <br />
 All rights reserved.