| CARVIEW |
hls-alternate-number-format-plugin: Provide Alternate Number Formats plugin for Haskell Language Server
Please see the README on GitHub at https://github.com/haskell/haskell-language-server#readme
[Skip to Readme]
Downloads
- hls-alternate-number-format-plugin-2.6.0.0.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
For package maintainers and hackage trustees
Candidates
| Versions [RSS] | 1.0.1.0, 1.1.0.0, 1.2.0.0, 1.3.0.0, 1.3.0.1, 2.0.0.0, 2.0.0.1, 2.1.0.0, 2.2.0.0, 2.3.0.0, 2.4.0.0, 2.5.0.0, 2.6.0.0 |
|---|---|
| Dependencies | aeson, base (>=4.12 && <5), containers, extra, ghc-boot-th, ghcide (==2.6.0.0), hie-compat, hls-graph, hls-plugin-api (==2.6.0.0), lens, lsp (>=2.3.0.0 && <2.4), mtl, regex-tdfa, syb, text, unordered-containers [details] |
| License | Apache-2.0 |
| Author | Nick Suchecki |
| Maintainer | nicksuchecki@gmail.com |
| Uploaded | by hls_team at 2024-01-15T16:12:36Z |
| Category | Development |
| Source repo | head: git clone https://github.com/haskell/haskell-language-server.git |
| Distributions | Arch:2.2.0.0 |
| Reverse Dependencies | 1 direct, 0 indirect [details] |
| Downloads | 3811 total (46 in the last 30 days) |
| Rating | (no votes yet) [estimated by Bayesian average] |
| Your Rating |
|
| Status | Docs available [build log] Last success reported on 2024-01-15 [all 1 reports] |
Readme for hls-alternate-number-format-plugin-2.6.0.0
[back to package description]Alternate Number Format Plugin
The alternate number format plugin provides alternative formatting for Numeric Literals in source code.
These can be any numeric literal such as 123, 0x45 or any of the other numeric formats.
The Code Action will provide all possible formatting suggestions (and when required insert the associated Language Extension)
Setup
The plugin requires no extra setup to work. Simply place your cursor on top of a literal and invoke the codeAction command for your editor.
Demo
Currently Supported GHC Extensions:
BinaryLiteralsHexFloatLiteralsNumDecimalLiterals
Design
The plugin is relatively simple, it traverses a files source contents using the GHC API. As it encounters Literals (of the type HsExpr with the constructor of either HsLit or HsOverLit), it will construct an internal Literal datatype that has additional information for use to generate suggestions.
Currently, the traversal is done in the file, Literal.hs, using the package SYB for most of the heavy lifting.
To generate suggestions, the plugin leverages the Numeric package which provides a multitude of conversion functions to and from strings/numerics.
Known Quirks
- Anything that produces a bad Source Span (i.e. can't be easily replaced by an edit) is ignored as well.
Changelog
1.0.0.0
- First Release
1.0.1.0
- Dependency upgrades
1.0.1.1
- Buildable with GHC 9.2
1.0.2.0
- Test Suite upgraded for 9.2 semantics (GHC2021)
- Fix SYB parsing with GHC 9.2
1.1.0.0
- Provide ALL possible formats as suggestions
- Insert Language Extensions when needed