Question

What is the best/correct practice to specify version within your source code tree?
What I want is, for instance, to put VERSION file in the top level of the source tree and get the “version” function to read it.

There is a version section in the cabal file. Is it possible to read it from my source by “help” or “version” functions?
What is the correct practice of specifying the version in one place and making it available globaly?

P.S. Are there any functions in the Cabal library that allow you to pull any section from the cabal file and present it in your source? Then I could simply pull the version section from the cabal file.

— UPDATE —

Thank you Thomas for an nice piece of knowledge about the Pathes_x module.
Just wanted to add that, apparently, I don’t need to put anything into my cabal file. Everything just works without it. All I needed was to import the Pathes_X as you sugested.
Also, I needed to import Data.Version to get the showVersion function to properly format/print the Version data type. So at the end I get something like this:

import Paths_kvman
import Data.Version

runVersion _ = putStrLn ("Version: " ++ (showVersion version))

Now, all I need is to change the version number in the cabal file to propagade it all over my source. Exactly what I needed. Thanks.

Answer 1

Cabal automatically generates a module for each package named Paths_packagename. Just import this package and look at the version value it exports.

Edit: For example:

module Data.Blah where

import Paths_t

func :: IO ()
func = print version

And an example run:

> func
Version {versionBranch = [0,1], versionTags = []}

Be sure to put Paths_packagename in your Other-Modules section of the cabal file.