# luacheck changelog

> Static analyzer and linter for Lua, detecting undefined globals and unused values.

- Vendor: luacheck
- Category: Developer Tools
- License: MIT
- Language: Lua
- Official site: https://github.com/lunarmodules/luacheck
- Tracked by: What's New (https://whatsnew.fyi/product/luacheck)
- Harvested from: GitHub (lunarmodules/luacheck)
- Entries below: 9 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

## Releases

### v1.2.0

- Date: 2024-05-24
- Version: v1.2.0
- Original notes: https://github.com/lunarmodules/luacheck/releases/tag/v1.2.0
- Permalink: https://whatsnew.fyi/product/luacheck/releases/v1.2.0

- **added** — Add builtin standards support for minetest
- **changed** — Memoize results to address speed regression from new feature in v0.26

###### Features

- Add builtin standards support for minetest (#108) — @BuckarooBanzay and @appgurueu

###### Performance

- Memoize results to addresses speed refression from new feature in v0.26 (#105) — @tomlau10

### v1.1.2

- Date: 2023-12-08
- Version: v1.1.2
- Original notes: https://github.com/lunarmodules/luacheck/releases/tag/v1.1.2
- Permalink: https://whatsnew.fyi/product/luacheck/releases/v1.1.2

- **added** — Support NO_COLOR environment variable
- **fixed** — Update SILE builtin with more allowed variables

###### Features

- Support NO_COLOR environment variable (#102) — @ligurio

###### Bug Fixes

- Update SILE builtin with more allowed variables — @alerque

### v1.1.1

- Date: 2023-06-10
- Version: v1.1.1
- Original notes: https://github.com/lunarmodules/luacheck/releases/tag/v1.1.1
- Permalink: https://whatsnew.fyi/product/luacheck/releases/v1.1.1

- **changed** — Update Löve standard to 11.4
- **fixed** — Correct compound operators to not crash on modifying upvalues
- **fixed** — Fix warning 582 (error prone negation) not applying to subexpressions

###### Features

- Update Löve standard to 11.4 (#95) — @RunningDroid
- Documentation improvements (#92 and #89) — @rcloran and @hramrach

###### Bug Fixes

- Correct compound operators to not crash on modifying upvalues (#96) — @arichard4
- Fix warning 582 (error prone negation) not applying to subexpressions (#94) — @appgurueu

### v1.1.0

- Date: 2022-12-19
- Version: v1.1.0
- Original notes: https://github.com/lunarmodules/luacheck/releases/tag/v1.1.0
- Permalink: https://whatsnew.fyi/product/luacheck/releases/v1.1.0

- **added** — Add builtin rule set for SILE globals
- **added** — Implement support for compound operators
- **fixed** — Correct circular reference detection visavis OpSet
- **fixed** — Remove unnecessary symbol from Playdate std

###### Features

- Add builtin rule set for SILE globals (#79) — @alerque
- Implement support for compound operators (#66) — @a2 & @arichard4

###### Bug Fixes

- Correct circular reference detection visavis OpSet — @arichard4
- Remove unnecessary symbol from Playdate std (#84) — @DidierMalenfant

### v1.0.0

- Date: 2022-08-24
- Version: v1.0.0
- Original notes: https://github.com/lunarmodules/luacheck/releases/tag/v1.0.0
- Permalink: https://whatsnew.fyi/product/luacheck/releases/v1.0.0

- **changed** — Follow semver guidelines for versioning going forward
- **changed** — Overhaul docker container to run on Lua 5.4
- **changed** — Store cached luacheck values per-version in case of changes
- **added** — Add set_default_std for ldoc
- **added** — Add builtin std option for Ldoc globals
- **added** — Add builtin std option for the Playdate SDK

###### Documentation

- [**breaking**] Follow semver guidelines, next release will be v1.x.y

###### Features

- Overhaul docker container to run on Lua 5.4
- Store cached luacheck values per-version in case of changes — @arichard4
- Set_default_std for ldoc
- Add builtin std option for Ldoc globals — @Aire-One
- Add builtin std option for the Playdate SDK — @DidierMalenfant

### v0.26.1

- Date: 2022-04-23
- Version: v0.26.1
- Original notes: https://github.com/lunarmodules/luacheck/releases/tag/v0.26.1
- Permalink: https://whatsnew.fyi/product/luacheck/releases/v0.26.1

- **fixed** — Exempt special builtin _ENV from 214 warning
- **added** — Default to caching in CWD when no home environment is available
- **added** — Add multi-thread support to container
- **changed** — Tweak warning message for 214 to be more explicit

###### Bug Fixes

- Exempt special builtin \_ENV from 214 warning

###### Features

- In case of no home environment, default to caching in CWD (#60)
- Add multi-thread support to container (#59)

###### Miscellaneous Tasks

- Tweak warning message for 214 to be more explicit

### v0.26.0

- Date: 2022-03-24
- Version: v0.26.0
- Original notes: https://github.com/lunarmodules/luacheck/releases/tag/v0.26.0
- Permalink: https://whatsnew.fyi/product/luacheck/releases/v0.26.0

- **added** — Add unused hint flag for function arguments starting with a single underscore
- **added** — Add warning 214 for using function arguments marked with unused hint
- **added** — Add hook to enable Luacheck for use in pre-commit
- **added** — Add warnings 581 and 582 to flag error-prone operator orders in negations
- **added** — Add Dockerfile implementation for containerized linter image
- **added** — Setup repository for use as a GitHub Action
- **fixed** — Don't mark variables as accessed if only references are circular
- **changed** — Make test suite Lua 5.4 compatible

###### New Features

* Add "unused hint" flag — @javierguerragiraldez
  Function arguments that start with a single underscore get an "unused hint".
  Leaving them unused doesn't result in a warning.
  Using them, on the other hand, is a new warning (№ 214).
* Add hook to enable Luacheck for use in pre-commit — @mblayman
* Warn on error-prone and unnecessary negations — @arichard4
  Two new warnings (№ 581 and 582) flag error-prone operator orders.
* Add Dockerfile implementation — @MartinBroers
  A 6.34MB containerized image with everything needed to run the linter.
  Build your own or pull prebuilt images from GHRC.
* Setup repository for use *as* a GitHub Action — @alerque
  Lint your repositories using GitHub Action workflows with just a single `uses:` step.

###### Fixes

* Don't mark variables as accessed if only references are circular — @arichard4
* Make test suite Lua 5.4 compatible — @alerque
* Correct small issues in documentation — various

###### Miscellaneous

* Overhaul CI workflows for testing, linting, building, and releasing — @alerque
* Update URLs and documentation reflecting new repository home — @lunarmodules

### 0.25.0

- Date: 2021-08-10
- Version: 0.25.0
- Original notes: https://github.com/lunarmodules/luacheck/releases/tag/0.25.0
- Permalink: https://whatsnew.fyi/product/luacheck/releases/0.25.0

- **added** — Add new values for CLI option --std: lua54 and lua54c
- **added** — Add lua54 standard library definitions
- **fixed** — Fix support for Lua 5.4 31-bit UTF-8 codepoints

###### New features

* New values for CLI option --std: lua54, lua54c
* New lua54 standard library definitions

###### Fixes

* Lua 5.4 allows 31bits utf8 codepoint

### 0.24.0

- Date: 2020-08-20
- Version: 0.24.0
- Original notes: https://github.com/lunarmodules/luacheck/releases/tag/0.24.0
- Permalink: https://whatsnew.fyi/product/luacheck/releases/0.24.0

- **changed** — Caching now uses files in a global directory instead of local .luacheckcache file, with default cache directory being %LOCALAPPDATA%\Luacheck\Cache on Windows, ~/Library/Caches/Luacheck on OS X/macOS, and $XDG_CACHE_HOME/luacheck or ~/.config/luacheck on other systems
- **fixed** — Parse Lua 5.4 attributes in local declarations
- **fixed** — Luacheck can now run with Lua 5.4
- **fixed** — Fixed randomize missing from busted set of standard globals
- **added** — Added additional table and thread definitions for ngx_lua
- **added** — Added additional match definition for busted

###### Changes

* Caching now uses files in a global directory instead of local
  `.luacheckcache` file. Default cache directory is
  `%LOCALAPPDATA%\Luacheck\Cache` on Windows,
  `~/Library/Caches/Luacheck` on OS X/macOS, and
  `$XDG_CACHE_HOME/luacheck` or `~/.config/luacheck` on other systems.

###### Fixes

* Fixes for using Luacheck with Lua 5.4:
  - Parse 5.4 attributes in `local` declarations (but ignores them for now)
  - Luacheck itself can also run with Lua 5.4
* Fixed `randomize` missing from `busted` set of standard globals (#183).
* Added additional `table` and `thread` definitions for `ngx_lua`.
* Added additional `match` definition for `busted`.

###### Miscellaneous

* Upgraded Windows binary components: Lua 5.3.4 -> 5.3.5,
  LuaFileSystem 1.6.3 -> 1.7.0.