| CARVIEW |
cabal-file: Cabal file access
cabal-file is a small library on top of the 'hackage-security' library
for accessing the local Hackage repo index cache, and a command-line tool
cblfile which can diff .cabal versions, list package versions,
save a cabal file, and show metadata from the index. It uses
simple-cabal to display package dependency lists.
[Skip to Readme]
Downloads
- cabal-file-0.1.1.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] | 0.1.0, 0.1.1 |
|---|---|
| Change log | ChangeLog.md |
| Dependencies | base (<5), bytestring, Cabal (>=2.2), cabal-file, directory, extra, filepath, hackage-security, optparse-applicative, simple-cabal (>0.1), simple-cmd, simple-cmd-args (>=0.1.2), time [details] |
| Tested with | ghc ==8.4.4, ghc ==8.6.5, ghc ==8.8.4, ghc ==8.10.2 |
| License | BSD-3-Clause |
| Copyright | 2019-2020 Jens Petersen |
| Author | Jens Petersen |
| Maintainer | juhpetersen@gmail.com |
| Uploaded | by JensPetersen at 2020-11-13T16:42:22Z |
| Category | Distribution |
| Source repo | head: git clone https://github.com/juhp/cabal-file.git |
| Distributions | LTSHaskell:0.1.1, NixOS:0.1.1, Stackage:0.1.1 |
| Executables | cblfile |
| Downloads | 773 total (8 in the last 30 days) |
| Rating | (no votes yet) [estimated by Bayesian average] |
| Your Rating |
|
| Status | Docs available [build log] Last success reported on 2020-11-13 [all 1 reports] |
Readme for cabal-file-0.1.1
[back to package description]cabal-file
cabal-file is a library on top of the hackage-security library for accessing cabal files and versions, and also a small tool for getting and comparing .cabal files.
Since it accesses package and .cabal file data directly from the local Hackage repo cache index tar archive under ~/.cabal/ it is quite fast.
Usage
List all Hackage packages:
$ cblfile list | grep ghcide
ghcide
List versions of a package:
$ cblfile list pandoc
0.4
:
:
2.9.2.1
Diff .cabal files of package versions
$ cblfile diff pandoc 2.8 2.9.2.1
--- pandoc-2.8.cabal 2020-05-24 19:47:58.487921450 +0800
+++ pandoc-2.9.2.1.cabal 2020-05-24 19:47:58.487921450 +0800
@@ -1,10 +1,10 @@
name: pandoc
-version: 2.8
+version: 2.9.2.1
cabal-version: 2.0
:
:
Latest version of a package:
$ cblfile latest extra
1.7.1
Timestamp for the latest .cabal file (or for a specific version):
$ cblfile date dhall
2020-05-19 02:18:01 UTC
Save a .cabal file (latest or specific version)
$ cblfile get purescript
$ ls purescript.cabal
purescript.cabal
Check package source metadata:
$ cblfile metadata tls-1.5.4
Size: 150171
SHA256 Hash "ce42bfa581a50f62776581da4b86408ebb1a51bc6cb2f95ad0a2ac7caa19a437"
Depends output
cblfile depends outputs quite verbose package dependency lists.
Library
For library documentation see the Hackage.Index documentation.
For example usage see app/Cmds.hs.
Motivation
I originally wrote the depends command for displaying dependency information
about packages in a more friendly way.
Later, since hdiff is out of sync for some packages,
and I use it particularly for comparing versions of .cabal files,
I decided to create the diff command.
Realising I could pull .cabal files direct from the cabal index cache,
the rest of cabal-file flowed on from there.
Related
If you want full diffs of Hackage sources you can try out cabal-diff from cabal-extras.