/usr/share/doc/libghc-cabal-file-th-doc/html/src/Distribution-PackageDescription-TH.html is in libghc-cabal-file-th-doc 0.2.3-6.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 | <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<!-- Generated by HsColour, http://code.haskell.org/~malcolm/hscolour/ -->
<title>Distribution/PackageDescription/TH.hs</title>
<link type='text/css' rel='stylesheet' href='hscolour.css' />
</head>
<body>
<pre><a name="line-1"></a><span class='hs-comment'>{-# LANGUAGE TypeSynonymInstances #-}</span>
<a name="line-2"></a><span class='hs-comment'>{-# LANGUAGE FlexibleInstances #-}</span>
<a name="line-3"></a><span class='hs-comment'>{-# LANGUAGE MultiParamTypeClasses #-}</span>
<a name="line-4"></a>
<a name="line-5"></a><span class='hs-comment'>-- | Utility functions for reading cabal file fields through template haskell.</span>
<a name="line-6"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>Distribution</span><span class='hs-varop'>.</span><span class='hs-conid'>PackageDescription</span><span class='hs-varop'>.</span><span class='hs-conid'>TH</span> <span class='hs-layout'>(</span>
<a name="line-7"></a> <span class='hs-comment'>-- * Template Haskell functions</span>
<a name="line-8"></a> <span class='hs-varid'>packageVariable</span><span class='hs-layout'>,</span>
<a name="line-9"></a> <span class='hs-varid'>packageVariableFrom</span><span class='hs-layout'>,</span>
<a name="line-10"></a> <span class='hs-comment'>-- * Cabal file data structures</span>
<a name="line-11"></a> <span class='hs-comment'>-- | The data structures for the cabal file are re-exported here for ease of use.</span>
<a name="line-12"></a> <span class='hs-conid'>PackageDescription</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span>
<a name="line-13"></a> <span class='hs-conid'>PackageIdentifier</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span>
<a name="line-14"></a> <span class='hs-conid'>Version</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span>
<a name="line-15"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-16"></a>
<a name="line-17"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Distribution</span><span class='hs-varop'>.</span><span class='hs-conid'>PackageDescription</span>
<a name="line-18"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Distribution</span><span class='hs-varop'>.</span><span class='hs-conid'>Package</span>
<a name="line-19"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Distribution</span><span class='hs-varop'>.</span><span class='hs-conid'>Version</span>
<a name="line-20"></a>
<a name="line-21"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Distribution</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span> <span class='hs-layout'>(</span><span class='hs-conid'>Text</span><span class='hs-layout'>,</span> <span class='hs-varid'>display</span><span class='hs-layout'>)</span>
<a name="line-22"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Distribution</span><span class='hs-varop'>.</span><span class='hs-conid'>Verbosity</span> <span class='hs-layout'>(</span><span class='hs-varid'>silent</span><span class='hs-layout'>)</span>
<a name="line-23"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Distribution</span><span class='hs-varop'>.</span><span class='hs-conid'>PackageDescription</span><span class='hs-varop'>.</span><span class='hs-conid'>Parse</span> <span class='hs-layout'>(</span><span class='hs-varid'>readPackageDescription</span><span class='hs-layout'>)</span>
<a name="line-24"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Directory</span> <span class='hs-layout'>(</span><span class='hs-varid'>getCurrentDirectory</span><span class='hs-layout'>,</span> <span class='hs-varid'>getDirectoryContents</span><span class='hs-layout'>)</span>
<a name="line-25"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>List</span> <span class='hs-layout'>(</span><span class='hs-varid'>isSuffixOf</span><span class='hs-layout'>)</span>
<a name="line-26"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Language</span><span class='hs-varop'>.</span><span class='hs-conid'>Haskell</span><span class='hs-varop'>.</span><span class='hs-conid'>TH</span> <span class='hs-layout'>(</span><span class='hs-conid'>Q</span><span class='hs-layout'>,</span> <span class='hs-conid'>Exp</span><span class='hs-layout'>,</span> <span class='hs-varid'>stringE</span><span class='hs-layout'>,</span> <span class='hs-varid'>runIO</span><span class='hs-layout'>)</span>
<a name="line-27"></a>
<a name="line-28"></a><a name="packageVariable"></a><span class='hs-comment'>-- | Renders the package variable specified by the function.</span>
<a name="line-29"></a><span class='hs-comment'>-- The cabal file interrogated is the first one that is found </span>
<a name="line-30"></a><span class='hs-comment'>-- in the current working directory.</span>
<a name="line-31"></a><span class='hs-definition'>packageVariable</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-conid'>PackageDescription</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Q</span> <span class='hs-conid'>Exp</span>
<a name="line-32"></a><span class='hs-definition'>packageVariable</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>renderField</span> <span class='hs-varid'>currentPackageDescription</span>
<a name="line-33"></a>
<a name="line-34"></a><a name="packageVariableFrom"></a><span class='hs-comment'>-- | Renders the package variable specified by the function, from a cabal file</span>
<a name="line-35"></a><span class='hs-comment'>-- and the given path.</span>
<a name="line-36"></a><span class='hs-definition'>packageVariableFrom</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>PackageDescription</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Q</span> <span class='hs-conid'>Exp</span>
<a name="line-37"></a><span class='hs-definition'>packageVariableFrom</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>renderField</span> <span class='hs-varop'>$</span> <span class='hs-varid'>fmap</span> <span class='hs-varid'>packageDescription</span> <span class='hs-layout'>(</span><span class='hs-varid'>readPackageDescription</span> <span class='hs-varid'>silent</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span>
<a name="line-38"></a>
<a name="line-39"></a><a name="renderField"></a><span class='hs-comment'>------</span>
<a name="line-40"></a><span class='hs-definition'>renderField</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>IO</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Q</span> <span class='hs-conid'>Exp</span>
<a name="line-41"></a><span class='hs-definition'>renderField</span> <span class='hs-varid'>pd</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>runIO</span> <span class='hs-varid'>pd</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>stringE</span> <span class='hs-varop'>.</span> <span class='hs-varid'>display</span> <span class='hs-varop'>.</span> <span class='hs-varid'>f</span>
<a name="line-42"></a>
<a name="line-43"></a><a name="currentPackageDescription"></a><span class='hs-definition'>currentPackageDescription</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>PackageDescription</span>
<a name="line-44"></a><span class='hs-definition'>currentPackageDescription</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>fmap</span> <span class='hs-varid'>packageDescription</span> <span class='hs-varop'>$</span> <span class='hs-keyword'>do</span>
<a name="line-45"></a> <span class='hs-varid'>dir</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>getCurrentDirectory</span>
<a name="line-46"></a> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>cabalFiles</span> <span class='hs-varid'>dir</span>
<a name="line-47"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>cs</span> <span class='hs-keyword'>of</span>
<a name="line-48"></a> <span class='hs-layout'>(</span><span class='hs-varid'>c</span><span class='hs-conop'>:</span><span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>readPackageDescription</span> <span class='hs-varid'>silent</span> <span class='hs-varid'>c</span>
<a name="line-49"></a> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>error</span> <span class='hs-varop'>$</span> <span class='hs-str'>"Couldn't find a cabal file in the current working directory ("</span> <span class='hs-varop'>++</span> <span class='hs-varid'>dir</span> <span class='hs-varop'>++</span> <span class='hs-str'>")"</span>
<a name="line-50"></a>
<a name="line-51"></a><a name="cabalFiles"></a><span class='hs-definition'>cabalFiles</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>FilePath</span><span class='hs-keyglyph'>]</span>
<a name="line-52"></a><span class='hs-definition'>cabalFiles</span> <span class='hs-varid'>dir</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-53"></a> <span class='hs-varid'>files</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>getDirectoryContents</span> <span class='hs-varid'>dir</span>
<a name="line-54"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-varid'>filter</span> <span class='hs-layout'>(</span><span class='hs-str'>".cabal"</span> <span class='hs-varop'>`isSuffixOf`</span><span class='hs-layout'>)</span> <span class='hs-varid'>files</span>
<a name="line-55"></a>
<a name="line-56"></a><span class='hs-comment'>{-
<a name="line-57"></a>
<a name="line-58"></a>Smart ways of getting the cabal file:
<a name="line-59"></a> * Get this module name, use TH.location and loc_module. Parse each
<a name="line-60"></a> cabal file in the cwd and look for references to this module
<a name="line-61"></a> in each thing.
<a name="line-62"></a>
<a name="line-63"></a>
<a name="line-64"></a> -}</span>
<a name="line-65"></a>
</pre></body>
</html>
|