ghc-plugin-non-empty: GHC Plugin for non-empty lists

[ compiler-plugin, ghc, library, mpl ] [ Propose Tags ]

GHC Plugin for compile-time transformation of list literals to NonEmpty lists.

{-# OPTIONS_GHC -fplugin=GhcPluginNonEmpty #-}

import Data.List.NonEmpty (NonEmpty)

portsToListen :: NonEmpty Int
portsToListen = [8000, 8080, 8081]

See README.md for more details.


[Skip to Readme]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.0.0.0
Change log CHANGELOG.md
Dependencies base (>=4.16 && <4.17), ghc (>=9.2 && <9.3), syb (>=0.7 && <0.8) [details]
License MPL-2.0
Copyright 2022 Dmitrii Kovanikov
Author Dmitrii Kovanikov
Maintainer Dmitrii Kovanikov <kovanikov@gmail.com>
Category GHC, Compiler Plugin
Home page https://github.com/chshersh/ghc-plugin-non-empty
Bug tracker https://github.com/chshersh/ghc-plugin-non-empty/issues
Source repo head: git clone https://github.com/chshersh/ghc-plugin-non-empty.git
Uploaded by shersh at 2022-07-17T15:23:36Z
Distributions
Downloads 66 total (4 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs uploaded by user [build log]
All reported builds failed as of 2022-07-17 [all 2 reports]

Readme for ghc-plugin-non-empty-0.0.0.0

[back to package description]

ghc-plugin-non-empty

GitHub CI Hackage MPL-2.0 license

GHC Compiler Plugin for automatically converting list literals to the NonEmpty type from the Data.List.NonEmpty module in base.

This plugin checks statically defined list literals and transforms them into NonEmpty lists during compile time. In other words, it provides compile-time guarantees for non-emptiness checks and allows the following expression to type-check:

portsToListen :: NonEmpty Int
portsToListen = [8000, 8080, 8081]

Compare to usage without the plugin:

portsToListen :: NonEmpty Int
portsToListen = 8000 :| [8080, 8081]

ℹ️ DISCLAIMER: ghc-plugin-non-empty is developed and maintained in free time by volunteers. The development may continue for decades or may stop tomorrow. You can use GitHub Sponsorship to support the development of this project.

How to use?

ghc-plugin-non-empty is compatible with the following GHC versions — supported versions

In order to start using ghc-plugin-non-empty in your project, you'll need to set it up with these steps:

  1. Add the dependency on ghc-plugin-non-empty in your project's .cabal file. For this, you should modify the build-depends section according to the below section:

    build-depends:
      , base                 ^>= LATEST_SUPPORTED_BASE
      , ghc-plugin-non-empty ^>= LATEST_VERSION
    
  2. To use this package, refer to the below example.

    {-# OPTIONS_GHC -fplugin=GhcPluginNonEmpty #-}
    
    module Main (main) where
    
    import Data.List.NonEmpty (NonEmpty)
    
    exampleList :: NonEmpty Int
    exampleList = [100, 5, 74]
    
    main :: IO ()
    main = print exampleList
    

For contributors

Check CONTRIBUTING.md for contributing guidelines.

To build the project and run the tests, use cabal:

cabal build all
cabal test --enable-tests --test-show-details=direct