hledger/Makefile

950 lines
31 KiB
Makefile
Raw Normal View History

2009-01-25 12:00:57 +03:00
# hledger project makefile
2008-12-10 21:43:14 +03:00
# ghc 6.12 executables need a locale
#export LANG=en_US.UTF-8
2012-10-22 01:09:24 +04:00
# command to run during "make prof" and "make heap"
2012-10-22 01:24:06 +04:00
PROFCMD=bin/hledgerprof balance -f data/1000x1000x10.journal >/dev/null
PROFCMD=bin/hledgerprof -f test-wf.csv print
2012-10-08 20:52:49 +04:00
#PROFRTSFLAGS=-p
PROFRTSFLAGS=-P
# command to run during "make coverage"
COVCMD=test
COVCMD=-f test-wf.csv print
# executables to run during "make simplebench". They should be on the path
2010-05-23 01:24:07 +04:00
# or in the current directory. hledger executables for benchmarking should
# generally be the standard optimised cabal build, constrained to parsec 2.
BENCHEXES=hledger-0.18 hledger-0.19 hledger-0.20 ledger-3.0-20130215
2009-06-03 00:37:34 +04:00
# misc. tools
2011-06-13 23:50:10 +04:00
BROWSE=google-chrome
BROWSE=open -a 'Google Chrome'
2011-06-13 23:50:10 +04:00
VIEWHTML=$(BROWSE)
VIEWPS=$(BROWSE)
VIEWPDF=$(BROWSE)
PRINT=lpr
GHC=ghc
HADDOCK=haddock
# used for make auto, http://joyful.com/repos/searchpath
SP=sp
PACKAGES=\
hledger-lib \
hledger \
hledger-web
INCLUDEPATHS=\
-ihledger-lib \
-ihledger \
-ihledger-web \
-ihledger-web/app
MAIN=hledger/hledger-cli.hs
# all source files in the project (plus a few strays like Setup.hs & hlint.hs)
SOURCEFILES:= \
hledger/*hs \
hledger/Hledger/*hs \
2010-12-06 00:14:45 +03:00
hledger/Hledger/*/*hs \
hledger-*/*hs \
2010-09-24 06:06:58 +04:00
hledger-*/Hledger/*hs \
2012-11-17 05:26:08 +04:00
hledger-*/Hledger/*/*hs \
hledger-web/app/*.hs \
2012-11-20 01:48:19 +04:00
hledger-web/Handler/*.hs \
2013-04-20 01:55:36 +04:00
hledger-web/Hledger/*.hs \
2012-11-17 05:26:08 +04:00
hledger-web/Settings/*.hs
# a more careful list suitable for for haddock
2011-08-19 22:39:13 +04:00
HADDOCKSOURCEFILES:= \
hledger-lib/Hledger.hs \
hledger-lib/Hledger/*hs \
hledger-lib/Hledger/*/*hs \
2011-07-19 05:00:08 +04:00
hledger/Hledger/*hs \
2011-08-08 02:14:14 +04:00
hledger/Hledger/*/*hs \
# hledger-web/Hledger/*hs \
# hledger-web/Hledger/*/*hs \
# hledger-web/app/*.hs \
# hledger-web/Settings/*.hs
CABALFILES:= \
hledger/hledger.cabal \
hledger-*/*.cabal
2011-06-04 21:01:45 +04:00
WEBFILES:= \
2011-09-13 02:45:02 +04:00
hledger-web/static/*.js \
hledger-web/static/*.css
2011-06-04 21:01:45 +04:00
2012-03-11 22:39:26 +04:00
DOCFILES:= \
*.md
2012-10-22 01:09:24 +04:00
# files which should be updated when the version changes
VERSIONSENSITIVEFILES=\
$(CABALFILES) \
MANUAL.md \
# DOWNLOAD.md \
2012-10-22 01:09:24 +04:00
# file(s) which require recompilation for a build to have an up-to-date version string
VERSIONSOURCEFILE=hledger/Hledger/Cli/Version.hs
# master file defining the current release/build version
VERSIONFILE=VERSION
# two or three-part version string, whatever's in VERSION
VERSION:=$(shell cat $(VERSIONFILE))
# the number of commits since the last tag
2013-04-08 22:31:24 +04:00
PATCHLEVEL:=$(shell git describe --long | awk -F - '{print $$2}')
# the number of commits since the last_release tag
#PATCHLEVEL:=$(shell git rev-list last_release..HEAD | wc -l)
2012-10-22 01:09:24 +04:00
# build flags
2012-11-16 22:49:00 +04:00
WARNINGS:=-W -fwarn-tabs -fno-warn-unused-do-bind -fno-warn-name-shadowing #-fwarn-orphans -fwarn-simple-patterns -fwarn-monomorphism-restriction
# For ghc-only dev builds of hledger-web: enable the language
# extensions specified in hledger-web.cabal, except for some which are
# not compatible with hledger-lib and hledger, or little-used; those
# are enabled with source file pragmas instead. Note: compilation
# warnings and errors might differ between ghc-only and cabal builds.
2012-11-16 22:49:00 +04:00
WEBLANGEXTS:=\
-XCPP \
-XMultiParamTypeClasses \
-XOverloadedStrings \
-XQuasiQuotes \
-XRecordWildCards \
-XTemplateHaskell \
# -XNoImplicitPrelude \
# -XTypeFamilies \
# -XGADTs \
# -XGeneralizedNewtypeDeriving \
# -XFlexibleContexts \
# -XEmptyDataDecls \
2012-11-24 00:49:17 +04:00
# -XNoMonomorphismRestriction
PREFERMACUSRLIBFLAGS=-L/usr/lib
2012-10-08 20:52:49 +04:00
GHCMEMFLAGS= #+RTS -M200m -RTS
CABALMACROSFLAGS=-optP-include -optPhledger/dist/build/autogen/cabal_macros.h
BUILDFLAGS1:=-rtsopts $(WARNINGS) $(INCLUDEPATHS) $(PREFERMACUSRLIBFLAGS) $(GHCMEMFLAGS) $(CABALMACROSFLAGS) -DPATCHLEVEL=$(PATCHLEVEL) -DDEVELOPMENT
BUILDFLAGS:=$(BUILDFLAGS1) -DVERSION='"$(VERSION)dev"'
2012-10-22 01:09:24 +04:00
PROFBUILDFLAGS:=-prof -fprof-auto -osuf hs_p
# sp needs different quoting:
AUTOBUILDFLAGS:=$(BUILDFLAGS1) -DVERSION='\"$(VERSION)dev\"' # $(PROFBUILDFLAGS)
LINUXRELEASEBUILDFLAGS:=-DMAKE $(WARNINGS) $(INCLUDEPATHS) -O2 -static -optl-static -optl-pthread
2010-12-11 01:07:52 +03:00
MACRELEASEBUILDFLAGS:=-DMAKE $(WARNINGS) $(INCLUDEPATHS) $(PREFERMACUSRLIBFLAGS) -O2 # -optl-L/usr/lib
#WINDOWSRELEASEBUILDFLAGS:=-DMAKE $(WARNINGS) $(INCLUDEPATHS)
2009-06-03 00:37:34 +04:00
AUTOBUILD=$(SP) --no-exts --no-default-map $(GHC) -O0 $(GHCMEMFLAGS)
2012-04-03 21:12:47 +04:00
2012-10-22 01:09:24 +04:00
# get an accurate binary filename for the current source and platform, slow but reliable. Avoid := here.
BINARYFILENAME=$(shell touch $(VERSIONSOURCEFILE); runhaskell -ihledger -ihledger-lib $(MAIN) --binary-filename)
# some other thing for linux binary filenames
RELEASEBINARYSUFFIX=$(shell echo "-$(VERSION)-`uname`-`arch`" | tr '[:upper:]' '[:lower:]')
TIME:=$(shell date +"%Y%m%d%H%M")
2010-05-24 03:45:12 +04:00
2010-12-11 01:00:42 +03:00
2012-10-22 01:09:24 +04:00
defaulttarget: bin/hledgerdev
######################################################################
# BUILDING
2012-01-29 22:36:51 +04:00
# cabal install all hledger PACKAGES and dependencies in the proper order
# (or, as many as possible)
2012-03-05 11:23:35 +04:00
EXTRAINSTALLARGS=
2012-01-29 22:36:51 +04:00
install:
2012-03-05 11:23:35 +04:00
cabal install $(patsubst %,./%,$(PACKAGES)) $(EXTRAINSTALLARGS)
2012-01-29 22:36:51 +04:00
2012-03-05 11:23:35 +04:00
# run a cabal command in all hledger package dirs
allcabal%:
for p in $(PACKAGES); do (echo doing cabal $* in $$p; cd $$p; cabal $*; echo); done
2012-01-29 22:36:51 +04:00
# # run a command in all hledger package dirs
# all%:
# for p in $(PACKAGES); do (echo doing $* in $$p; cd $$p; $*); done
# auto-recompile and run (something, eg --help or unit tests) whenever a module changes
auto: auto---version
2012-05-14 23:24:03 +04:00
auto-%: sp
$(AUTOBUILD) $(MAIN) -o bin/hledgerdev $(AUTOBUILDFLAGS) --run $*
autoweb: sp link-web-dirs
$(AUTOBUILD) hledger-web/app/main.hs -o bin/hledger-webdev $(AUTOBUILDFLAGS) $(WEBLANGEXTS) --run -B --port 5001 --base-url http://localhost:5001 -f webtest.j
2012-11-16 22:49:00 +04:00
link-web-dirs: config messages static templates
config:
ln -sf hledger-web/$@
messages:
ln -sf hledger-web/$@
static:
ln -sf hledger-web/$@
templates:
ln -sf hledger-web/$@
2010-11-13 03:07:20 +03:00
2011-08-08 02:18:54 +04:00
# check for sp and explain how to get it if not found.
sp:
@/usr/bin/env which sp >/dev/null || \
2012-03-12 00:16:45 +04:00
(echo '"sp" is required for auto-compilation. darcs get http://joyful.com/darcsden/simon/searchpath, make it (cabal install-ing any needed packages) and add it to your PATH'; exit 1)
# force a compile even if binary exists, since we don't specify dependencies for these
2012-10-22 01:24:06 +04:00
.PHONY: bin/hledgerdev bin/hledgerprof bin/hledgeropt bin/hledger-webdev
2011-03-13 02:30:57 +03:00
# build hledger binary as quickly as possible
bin/hledgerdev:
$(GHC) $(MAIN) -o bin/hledgerdev $(BUILDFLAGS)
2010-11-29 04:15:08 +03:00
# build a GHC-version-specific hledger binary without disturbing with other GHC version builds
bin/hledgerdev.ghc-%: $(SOURCEFILES)
ghc-$* $(MAIN) -o $@ $(BUILDFLAGS) -outputdir .ghc-$*
# build hledger with the main supported GHC versions
bin/hledgerdev.ghcall: \
bin/hledgerdev.ghc-7.6.1 \
bin/hledgerdev.ghc-7.4.1 \
bin/hledgerdev.ghc-7.2.2 \
bin/hledgerdev.ghc-7.0.4 \
# bin/hledgerdev.ghc-6.12.3 \
# build the fastest binary we can
2012-10-08 20:52:49 +04:00
bin/hledgeropt:
$(GHC) $(MAIN) -o $@ $(BUILDFLAGS) -O2 # -fvia-C # -fexcess-precision -optc-O3 -optc-ffast-math
2010-11-29 04:15:08 +03:00
# build the time profiling binary. cabal install --reinstall -p some libs may be required.
2012-10-22 01:24:06 +04:00
bin/hledgerprof:
$(GHC) $(BUILDFLAGS) $(PROFBUILDFLAGS) $(MAIN) -o $@
2011-09-13 04:10:00 +04:00
# build the heap profiling binary for coverage reports and heap profiles.
# Keep these .o files separate from the regular ones.
hledgerhpc:
$(GHC) $(MAIN) -fhpc -o bin/hledgerhpc -outputdir .hledgerhpcobjs $(BUILDFLAGS)
2010-11-29 04:15:08 +03:00
# build other executables quickly
bin/hledger-webdev: link-web-dirs
2012-11-20 03:18:22 +04:00
$(GHC) -o $@ $(BUILDFLAGS) $(WEBLANGEXTS) hledger-web/app/main.hs
bin/hledger-web-production:
2012-11-20 03:18:22 +04:00
$(GHC) -o $@ $(BUILDFLAGS) $(WEBLANGEXTS) hledger-web/app/main.hs
# build portable releaseable binaries for gnu/linux
linuxbinaries: linuxbinary-hledger \
linuxbinary-hledger-web
@echo 'Please check the binaries look portable, then make compressbinaries:'
-file bin/*`arch`
2012-10-22 01:09:24 +04:00
# work around for inconsistently-named (why ?) hledger/hledger-cli.hs
linuxbinary-hledger:
$(GHC) hledger/hledger-cli.hs -o bin/$*$(RELEASEBINARYSUFFIX) $(LINUXRELEASEBUILDFLAGS)
2012-10-22 01:09:24 +04:00
2010-12-11 01:00:42 +03:00
linuxbinary-%:
$(GHC) $*/$*.hs -o bin/$*$(RELEASEBINARYSUFFIX) $(LINUXRELEASEBUILDFLAGS)
2010-12-11 01:00:42 +03:00
2011-04-23 02:57:00 +04:00
macbinaries: macbinary-hledger \
macbinary-hledger-web
2011-04-23 02:57:00 +04:00
@echo 'Please check the binaries are portable, then make compressbinaries'
otool -L bin/*`arch`
2011-04-23 02:57:00 +04:00
# build a deployable mac binary for the specified hledger package, munging
# the link command to use only standard osx libs. Specifically we link
# without the non-standard GMP framework, which causes no apparent harm.
# Clunky, does the link twice.
macbinary-%:
BINARY=`echo $(BINARYFILENAME) | sed -e 's/hledger/$*/'` ; \
LINKCMD=`$(GHC) -v $*/$*.hs $(MACRELEASEBUILDFLAGS) -o bin/$$BINARY 2>&1 | egrep "bin/gcc.*bin/$$BINARY"` ; \
2011-04-23 02:57:00 +04:00
PORTABLELINKCMD=`echo $$LINKCMD | sed -e 's/ -framework GMP//'` ; \
echo $$PORTABLELINKCMD; $$PORTABLELINKCMD
# Run this on a windows machine or in a wine session, and probably in a
# separate copy of the repo (hledger-win).
# Builds and gather deployable binaries for windows, if cygwin tools are
# present and all packages are buildable. Otherwise, cabal install each
# package and gather the binaries by hand.
windowsbinaries: install
cp ~/.cabal/bin/hledger.exe bin/`echo $(BINARYFILENAME) | dos2unix`
-cp ~/.cabal/bin/hledger-web.exe bin/`echo $(BINARYFILENAME) | sed -e 's/hledger/hledger-web/' | dos2unix`
2011-04-23 02:57:00 +04:00
@echo 'Please check the binaries are portable, then make compressbinaries'
ls -l bin/*`arch`
2011-09-27 00:51:09 +04:00
# One way to get a wine command prompt
wine:
wineconsole cmd.exe &
compressbinaries:
2011-04-23 02:57:00 +04:00
cd bin; for f in *-windows-*.exe ; do echo zipping $$f; rm -f $$f.zip; zip $$f.zip $$f; done
# for f in bin/*-{linux,mac-}* ; do echo gzipping $$f; gzip -q $$f >$$f.gz; done
# gzip bin/*`arch`
# build the standalone unit test runner. Requires test-framework, which
# may not work on windows.
tools/unittest: tools/unittest.hs
$(GHC) -threaded -O2 tools/unittest.hs
# build the doctest runner
tools/doctest: tools/doctest.hs
$(GHC) tools/doctest.hs
# build the simple benchmark runner. Requires html and tabular.
tools/simplebench: tools/simplebench.hs
$(GHC) tools/simplebench.hs
# build the criterion-based benchmark runner. Requires criterion.
tools/criterionbench: tools/criterionbench.hs
$(GHC) tools/criterionbench.hs
# build the progression-based benchmark runner. Requires progression.
tools/progressionbench: tools/progressionbench.hs
$(GHC) tools/progressionbench.hs
# build the generatejournal tool
tools/generatejournal: tools/generatejournal.hs
$(GHC) tools/generatejournal.hs
######################################################################
# TESTING
######################################################################
# DOCUMENTATION
######################################################################
# RELEASING
# set up this repo copy for previewing a release:
# ensure download links work
set-up-rc-repo:
cd site/_site; ln -s ../download
2011-04-23 02:57:00 +04:00
checkdeps packdeps:
for p in $(PACKAGES); do packdeps $$p/$$p.cabal; done
######################################################################
# MISCELLANEOUS
######################################################################
# OLD PRE PKG SPLIT
######################################################################
######################################################################
# TESTING
2012-03-30 00:41:47 +04:00
SHELLTEST=shelltest
2009-06-28 07:17:02 +04:00
test: codetest
# quick code tests - run all the time
2009-06-28 07:17:02 +04:00
codetest: unittest functest
2009-06-28 07:17:02 +04:00
# moderate pre-commit tests - run before record or before send/push, your choice
2009-09-23 19:00:24 +04:00
committest: hlinttest unittest doctest functest haddocktest warningstest quickcabaltest
2009-06-28 07:17:02 +04:00
# thorough pre-release tests - run before release
# consider hiding dev-build symlinks in Hledger/ first
releasetest: Clean unittest doctest functest warningstest fullcabaltest haddocktest
2009-06-28 07:17:02 +04:00
2009-09-23 19:00:24 +04:00
hlinttest hlint:
2009-09-23 21:56:15 +04:00
hlint --hint=hlint --report=hlint.html $(SOURCEFILES)
2009-06-28 07:17:02 +04:00
# run unit tests
unittest: unittest-builtin
2009-06-28 07:17:02 +04:00
unittest-builtin: bin/hledgerdev
@echo unit tests:
@(bin/hledgerdev test \
2010-09-06 03:24:34 +04:00
&& echo $@ PASSED) || echo $@ FAILED
unittest-%: bin/hledgerdev
@echo unit tests:
@(bin/hledgerdev test $* \
&& echo $@ PASSED) || echo $@ FAILED
# XXX doesn't rebuild on hledger source changes
2009-06-28 07:17:02 +04:00
unittest-standalone: tools/unittest
@echo unit tests (standalone):
2009-06-28 07:17:02 +04:00
@(tools/unittest \
2010-09-06 03:24:34 +04:00
&& echo $@ PASSED) || echo $@ FAILED
2009-06-28 07:17:02 +04:00
# run unit tests without waiting for compilation
unittest-interpreted:
@echo "unit tests (interpreted)":
@(run$(GHC) $(MAIN) test \
2010-09-06 03:24:34 +04:00
&& echo $@ PASSED) || echo $@ FAILED
# run functional tests, requires shelltestrunner >= 0.9 from hackage
# 16 threads sometimes gives "commitAndReleaseBuffer: resource vanished (Broken pipe)" here but seems harmless
functest: bin/hledgerdev
@echo functional tests:
($(SHELLTEST) tests -- --threads=16 --hide-successes \
2010-09-06 03:24:34 +04:00
&& echo $@ PASSED) || echo $@ FAILED
# run unit and functional tests with a specific GHC version
# some functional tests (add, include, read-csv..) have bin/hledgerdev hard coded - might need to symlink it
test-ghc-%: # bin/hledgerdev.ghc-$*
@echo; echo testing hledger built with ghc-$*
@(echo unit tests: \
&& bin/hledgerdev.ghc-$* test \
&& echo functional tests: \
&& $(SHELLTEST) tests -w bin/hledgerdev.ghc-$* -- --threads=16 --hide-successes \
&& echo $@ PASSED) || echo $@ FAILED
# run unit and functional tests with main supported GHC versions
test-ghcall: bin/hledgerdev.ghcall \
2012-10-08 20:52:49 +04:00
test-ghc-7.6.1 \
2012-03-30 00:41:47 +04:00
test-ghc-7.4.1 \
test-ghc-7.2.2 \
test-ghc-7.0.4 \
2012-10-08 20:52:49 +04:00
# test-ghc-6.12.3 \
# run doc tests
DOCTESTFILES=\
hledger/Hledger/Cli/Tests.hs
doctest: tools/doctest
@for f in $(DOCTESTFILES); do \
(tools/doctest $$f && echo $@ PASSED) || echo $@ FAILED ; done
2009-03-15 11:47:23 +03:00
# make sure we have no haddock errors
haddocktest:
2011-08-19 23:58:56 +04:00
@(make --quiet haddock \
2010-09-06 03:24:34 +04:00
&& echo $@ PASSED) || echo $@ FAILED
2010-12-11 01:09:32 +03:00
# needs updating
# make sure the normal build has no warnings
warningstest:
@(make -s clean \
&& make --no-print-directory -s hledgernowarnings \
2010-09-06 03:24:34 +04:00
&& echo $@ PASSED) || echo $@ FAILED
2011-04-18 11:26:58 +04:00
# make sure cabal is reasonably happy
quickcabaltest:
@(make --no-print-directory allcabalclean allcabalcheck allcabalconfigure \
&& echo $@ PASSED) || echo $@ FAILED
2010-12-11 01:09:32 +03:00
2009-06-28 07:17:02 +04:00
# make sure cabal is happy in all possible ways
2011-04-18 11:26:58 +04:00
fullcabaltest:
2011-04-22 23:04:47 +04:00
(for p in $(PACKAGES); do (echo "testing $$p package" && cd $$p && cabal clean && cabal check && cabal install && cabal sdist && cabal upload dist/$$p-$(VERSION).tar.gz --check -v3); done \
2011-04-18 11:26:58 +04:00
&& echo $@ PASSED) || echo $@ FAILED
# run simple performance benchmarks without saving results
2010-05-23 01:24:07 +04:00
# Requires some commands defined in bench.tests and some BENCHEXES defined above.
quickbench: samplejournals bench.tests tools/simplebench
tools/simplebench -v -fbench.tests $(BENCHEXES)
2010-05-23 01:24:07 +04:00
@rm -f benchresults.*
# run simple performance benchmarks and archive results
2009-12-12 05:25:27 +03:00
# Requires some commands defined in bench.tests and some BENCHEXES defined above.
2012-10-22 01:09:24 +04:00
bench: samplejournals bench.tests tools/simplebench
tools/simplebench -v -fbench.tests $(BENCHEXES) | tee profs/$(TIME).bench
2009-06-03 00:37:34 +04:00
@rm -f benchresults.*
@(cd profs; rm -f latest.bench; ln -s $(TIME).bench latest.bench)
2008-12-10 23:46:18 +03:00
# run criterion benchmark tests and save graphical results
criterionbench: samplejournals tools/criterionbench
tools/criterionbench -t png -k png
# run progression benchmark tests and save graphical results
progressionbench: samplejournals tools/progressionbench
tools/progressionbench -- -t png -k png
# generate and archive an execution profile
2012-10-22 01:24:06 +04:00
prof: samplejournals bin/hledgerprof
@echo "Profiling: $(PROFCMD)"
2012-10-08 20:52:49 +04:00
-$(PROFCMD) +RTS $(PROFRTSFLAGS) -RTS
2012-10-22 01:24:06 +04:00
mv hledgerprof.prof profs/$(TIME).prof
(cd profs; rm -f latest*.prof; ln -s $(TIME).prof latest.prof)
# generate, archive, simplify and display an execution profile
viewprof: prof
tools/simplifyprof.hs profs/latest.prof
# generate and display an execution profile, don't save or simplify
2012-10-22 01:24:06 +04:00
quickprof: samplejournals bin/hledgerprof
@echo "Profiling: $(PROFCMD)"
2012-10-08 20:52:49 +04:00
-$(PROFCMD) +RTS $(PROFRTSFLAGS) -RTS
2012-10-22 01:24:06 +04:00
echo; cat hledgerprof.prof
# generate and archive a graphical heap profile
2012-10-22 01:24:06 +04:00
heap: samplejournals bin/hledgerprof
@echo "Profiling heap with: $(PROFCMD)"
$(PROFCMD) +RTS -hc -RTS
2012-10-22 01:24:06 +04:00
mv hledgerprof.hp profs/$(TIME).hp
(cd profs; rm -f latest.hp; ln -s $(TIME).hp latest.hp; \
2009-05-30 00:42:42 +04:00
hp2ps $(TIME).hp; rm -f latest.ps; ln -s $(TIME).ps latest.ps; rm -f *.aux)
viewheap: heap
2010-02-26 03:24:04 +03:00
$(VIEWPS) profs/latest.ps
# generate and display a graphical heap profile, don't save
2012-10-22 01:24:06 +04:00
quickheap: samplejournals bin/hledgerprof
@echo "Profiling heap with: $(PROFCMD)"
$(PROFCMD) +RTS -hc -RTS
2012-10-22 01:24:06 +04:00
hp2ps hledgerprof.hp
$(VIEWPS) hledger.ps
# display a code coverage text report from running hledger COVCMD
2012-11-16 22:49:00 +04:00
quickcoverage: hledgerhpc
@echo "Generating code coverage text report for hledger command: $(COVCMD)"
tools/runhledgerhpc "report" $(COVCMD)
# generate a code coverage html report from running hledger COVCMD
coverage: samplejournals hledgerhpc
@echo "Generating code coverage html report for hledger command: $(COVCMD)"
tools/runhledgerhpc "markup --destdir=profs/coverage" $(COVCMD)
cd profs/coverage; rm -f index.html; ln -s hpc_index.html index.html
# view the last html code coverage report
viewcoverage:
2010-02-26 03:24:04 +03:00
$(VIEWHTML) profs/coverage/index.html
# get a debug prompt
ghci:
ghci $(INCLUDEPATHS) $(MAIN)
2012-11-24 00:49:17 +04:00
ghciweb:
2013-04-20 01:55:36 +04:00
ghci $(BUILDFLAGS) $(WEBLANGEXTS) hledger-web/app/main.hs
2012-11-24 00:49:17 +04:00
# generate standard sample journals
2012-10-13 23:47:39 +04:00
samplejournals: data/sample.journal data/100x100x10.journal data/1000x1000x10.journal data/1000x10000x10.journal data/10000x1000x10.journal data/10000x10000x10.journal data/100000x1000x10.journal
data/sample.journal:
true # XXX should probably regenerate this
data/100x100x10.journal: tools/generatejournal
tools/generatejournal 100 100 10 >$@
data/1000x1000x10.journal: tools/generatejournal
tools/generatejournal 1000 1000 10 >$@
2012-10-13 23:47:39 +04:00
data/1000x10000x10.journal: tools/generatejournal
tools/generatejournal 1000 10000 10 >$@
data/10000x1000x10.journal: tools/generatejournal
tools/generatejournal 10000 1000 10 >$@
2012-10-13 23:47:39 +04:00
data/10000x10000x10.journal: tools/generatejournal
tools/generatejournal 10000 10000 10 >$@
data/100000x1000x10.journal: tools/generatejournal
tools/generatejournal 100000 1000 10 >$@
######################################################################
2009-06-02 23:54:45 +04:00
# DOCUMENTATION
2009-07-15 01:51:10 +04:00
# Documentation source files are UPPERCASE files in the top directory.
# site/ contains both html generated from these (UPPERCASE.html) and
# revision-controlled resource files (everything else). site/api
2009-07-15 01:51:10 +04:00
# contains only generated files.
2009-06-02 23:54:45 +04:00
cleandocs:
rm -rf site/[A-Z]*.html site/api/*
2009-06-02 23:54:45 +04:00
# rebuild all docs
docs: site codedocs
2010-05-17 18:33:05 +04:00
# build the hledger.org website
# Requires hakyll (cabal install hakyll)
2010-05-21 22:19:00 +04:00
.PHONY: site
site: site/site
cd site; ./site build
2013-04-06 23:39:35 +04:00
cleansite: site/site cleanoldsource
cd site; ./site clean
2010-05-17 18:33:05 +04:00
previewsite: site/site
cd site; ./site preview
2013-04-06 23:39:35 +04:00
site/site: site/site.hs oldsource
cd site; $(GHC) site.hs $(PREFERMACUSRLIBFLAGS)
2010-05-17 18:33:05 +04:00
2011-08-28 22:03:20 +04:00
autosite:
cd site; $(AUTOBUILD) site.hs -o site $(PREFERMACUSRLIBFLAGS) --run preview
2010-05-17 18:33:05 +04:00
viewsite: site
2010-05-21 22:19:00 +04:00
$(VIEWHTML) site/_site/index.html
2013-04-06 23:39:35 +04:00
# ensure some old doc versions are in place:
2013-06-02 19:57:44 +04:00
oldsource: site/0.20 site/0.19 site/0.18
site/0.20:
git archive --prefix site/0.20/ tags/0.20 '*.md' | tar xf -
2013-04-06 23:39:35 +04:00
site/0.19:
git archive --prefix site/0.19/ tags/0_19_3 '*.md' | tar xf -
site/0.18:
git archive --prefix site/0.18/ tags/0_18_2 '*.md' | tar xf -
cleanoldsource:
cd site; rm -rf 0.19 0.18
# generate html versions of docs (and the hledger.org website)
# work around pandoc not handling full rst image directive
2010-05-17 18:33:05 +04:00
# html:
# for d in $(DOCFILES); do $(PANDOC) --toc -s -H site/header.html -A site/footer.html -r rst $$d >site/$$d.html; done
# cd site && ln -sf ../SCREENSHOTS && $(RST2HTML) SCREENSHOTS >SCREENSHOTS.html && rm -f SCREENSHOTS
# cd site; rm -f index.html; ln -s README.html index.html; rm -f profs; ln -s ../profs
2010-02-26 03:23:44 +03:00
pdf: docspdf codepdf
2009-06-14 01:37:06 +04:00
2009-06-02 23:54:45 +04:00
# generate pdf versions of main docs
# docspdf:
# -for d in $(DOCFILES); do (cd site && ln -sf ../$$d && pandoc $$d -w pdf && rm -f $$d); done
# format all code as a pdf for offline reading
2011-09-02 05:00:53 +04:00
ENSCRIPT=enscript -q --header='$$n|$$D{%+}|Page $$% of $$=' --highlight=haskell --line-numbers --font=Courier6 --color -o-
codepdf:
$(ENSCRIPT) --pretty-print=makefile hledger.cabal >cabal.ps
$(ENSCRIPT) --pretty-print=makefile Makefile >make.ps
$(ENSCRIPT) --pretty-print=haskell $(SOURCEFILES) >haskell.ps
cat cabal.ps make.ps haskell.ps | ps2pdf - >code.pdf
# view all docs and code as pdf
PDFS=site/{README,README2,MANUAL,NEWS,CONTRIBUTORS,SCREENSHOTS}.pdf code.pdf
viewall: pdf
2010-02-26 03:24:04 +03:00
$(VIEWPDF) $(PDFS)
# print all docs and code for offline reading
printall: pdf
2010-02-26 03:24:04 +03:00
$(PRINT) $(PDFS)
# push latest docs etc. and update the hledger.org site
2010-05-17 18:33:05 +04:00
pushdocs: push
2010-07-19 02:22:11 +04:00
ssh simon@joyful.com 'make -C/repos/hledger docs'
2011-04-22 20:16:31 +04:00
# dump all executables' command line help into files for review
EXES=hledger hledger-vty hledger-web
2011-04-22 20:16:31 +04:00
savehelp:
for e in $(EXES); do $$e --help >.HELP_$$e; done
# generate api & other code docs
codedocs: haddock hscolour coverage #sourcegraph #hoogle
#http://www.haskell.org/haddock/doc/html/invoking.html
#$(subst -D,--optghc=-D,$(DEFINEFLAGS))
HADDOCKFLAGS= --no-warnings --prologue .haddockprologue \
--optghc='-optP-include' --optghc='-optPhledger/dist/build/autogen/cabal_macros.h'
#--optghc='-hide-package monads-tf'
.haddocksynopsis: hledger/hledger.cabal
grep synopsis $< | sed -e 's/synopsis: *//' >$@
.haddockprologue: hledger/hledger.cabal
cat $< | perl -ne 'print if (/^description:/../^$$/)' | sed -e 's/^description: *//' >$@
printf "\nThis haddock covers all hledger-* packages, for individual package haddocks see hackage.\n" >>$@
# generate api docs for the whole project
2012-03-07 20:05:04 +04:00
# we define HADDOCK to disable cabal-file-th code which requires a cabal file in the current dir
2011-10-20 00:00:08 +04:00
haddock: .haddockprologue
$(HADDOCK) $(HADDOCKFLAGS) --title "hledger-* API docs" \
-o site/api \
--html \
--source-module=src/%{MODULE/./-}.html \
--source-entity=src/%{MODULE/./-}.html#%N \
2011-08-19 22:39:13 +04:00
$(HADDOCKSOURCEFILES)
# browse the api docs
viewhaddock:
2012-03-30 03:38:36 +04:00
$(VIEWHTML) site/api/frames.html
# http://www.cs.york.ac.uk/fp/darcs/hscolour/
HSCOLOUR=HsColour -css
hscolour: site/api/src site/api/src/hscolour.css
2011-08-19 22:39:13 +04:00
for f in $(HADDOCKSOURCEFILES); do \
$(HSCOLOUR) -anchor $$f -osite/api/src/`echo $$f | sed -e's%[^/]*/%%' | sed -e's%/%-%g' | sed -e's%\.hs$$%.html%'` ; \
done
site/api/src/hscolour.css: site/api/src
$(HSCOLOUR) -print-css >site/api/src/hscolour.css
2011-06-06 23:06:26 +04:00
site/api/src:
mkdir -p site/api/src
2011-06-06 23:06:26 +04:00
sourcegraph:
for p in $(PACKAGES); do (cd $$p; SourceGraph $$p.cabal); done
2012-05-14 23:24:03 +04:00
patchdeps:
darcs2dot > patchdeps.dot && dot -Tpng -O patchdeps.dot
# # generate external api docs for each package
# allhaddock: allcabalhaddock\ --hyperlink-source\ --executables
# # generate internal code docs for each package
# allhaddockinternal: allcabalhaddock\ --hyperlink-source\ --executables\ --internal
# # generate hoogle indices for each package
# allhoogle: allcabalhaddock\ --hoogle\ --executables
#set up the hoogle web interface
## We munge haddock and hoogle into a rough but useful framed layout.
## For this to work the hoogle cgi must be built with base target "main".
## XXX move the framed index building into haddock: ?
# sed -i -e 's%^></HEAD%><base target="main"></HEAD%' site/api/modules-index.html ; \
# cp site/api-frames.html site/api/index.html ; \
# # cp site/hoogle-small.html site/api
#
#uses a hoogle source tree configured with --datadir=., patched to fix haddock urls/target frame
# HOOGLESRC=/usr/local/src/hoogle
# HOOGLE=$(HOOGLESRC)/dist/build/hoogle/hoogle
# HOOGLEVER=`$(HOOGLE) --version |tail -n 1 | sed -e 's/Version /hoogle-/'`
# hoogle: hoogleindex
# if test -f $(HOOGLE) ; then \
# cd site/api && \
# rm -f $(HOOGLEVER) && \
# ln -s . $(HOOGLEVER) && \
# cp -r $(HOOGLESRC)/src/res/ . && \
# cp -p $(HOOGLE) index.cgi && \
# touch log.txt && chmod 666 log.txt ; \
# else \
# echo "Could not find $(HOOGLE) in the hoogle source tree" ; \
# fi
#
#generate a hoogle index
# hoogleindex:
# $(HADDOCK) $(HADDOCKFLAGS) -o site/api --hoogle $(MAIN) && \
# cd site/api && \
# hoogle --convert=main.txt --output=default.hoo
######################################################################
# RELEASING
2009-01-25 11:09:09 +03:00
2009-12-11 01:43:23 +03:00
# Version numbering. See also VERSION and Version.hs.
#
# hledger's version number appears in:
# hledger --version
# hledger's cabal file
# darcs tags
# hackage tarball filenames
# hackage pages
#
2009-12-11 01:43:23 +03:00
# Some old version numbering goals:
# 1 automation, robustness, simplicity, platform independence
# 2 cabal versions must be all-numeric
# 3 release versions can be concise (without extra .0's)
# 4 releases should have a corresponding darcs tag
# 5 development builds should have a precise version appearing in --version
# 6 development builds should generate cabal packages with non-confusing versions
# 7 there should be a way to mark builds/releases as alpha or beta
# 8 it should be easy to darcs get the .0 release even after bugfix releases
# 9 avoid unnecessary compiling and linking
# 10 minimise rcs noise and syncing issues (commits, unrecorded changes)
#
2009-12-11 01:43:23 +03:00
# Current policy:
#
# - We follow http://haskell.org/haskellwiki/Package_versioning_policy
#
# - The full release version is ma.jor.minor, where minor is 0 for a
# normal release or 1..n for bugfix releases.
#
# - The elided release version is ma.jor when minor is 0. We use it for
# hackage releases when possible, trusting it doesn't cause trouble..
#
# - The build version is ma.jor.minor+patches, where patches is the number
# of patches applied in the current repo since the last release tag.
#
# - The release tag in the repo is the full release version.
#
# - hledger --version shows the release version or build version as
# appropriate.
#
2009-12-12 05:35:09 +03:00
# - The VERSION file must be updated manually before a release.
#
# - "make simplebench" depends on version numbers in BENCHEXES, these also
2009-12-12 05:35:09 +03:00
# must be updated manually.
#
# - "make" updates the version in most other places, and defines PATCHES.
# Note "cabal build" should also do this but doesn't yet.
#
# - "make release" additionally records the main version number-affected
# files, and tags the repo with the release tag.
2009-12-12 05:55:59 +03:00
# Build a release, tag the repo, prepare a cabal package
# First update VERSION. Eg:
# a normal release: echo 0.7 >VERSION; make release
2009-12-12 23:40:54 +03:00
# a bugfix release: echo 0.7.1 >VERSION; make release
release: releasetest setandrecordversion tagrelease
2009-12-12 05:55:59 +03:00
# Upload the latest cabal package and update hledger.org
2010-12-11 01:09:32 +03:00
upload: allcabalsdist hackageupload pushdocs
2009-12-12 05:55:59 +03:00
releaseandupload: release upload
2010-07-10 17:09:49 +04:00
# update the version number in local files, and prompt to record changes
# in these files. Triggered by "make release".
2011-04-18 11:26:58 +04:00
setandrecordversion: setversion
darcs record -m "bump version" $(VERSIONFILE) $(VERSIONSENSITIVEFILES)
2010-07-10 17:09:49 +04:00
# update the version string in local files. This should be run immediately
# after editing the VERSION file.
2010-07-10 17:09:49 +04:00
setversion: $(VERSIONSENSITIVEFILES)
# re-update version string even if it seems unchanged
Setversion:
touch $(VERSIONFILE); make setversion
hledger-lib/hledger-lib.cabal: $(VERSIONFILE)
perl -p -e "s/(^ *version:) *.*/\1 $(VERSION)/" -i $@
hledger/hledger.cabal: $(VERSIONFILE)
perl -p -e "s/(^ *version:) *.*/\1 $(VERSION)/" -i $@
perl -p -e "s/(^[ ,]*hledger-lib *[>=]=) *.*/\1 $(VERSION)/" -i $@
2012-10-22 01:09:24 +04:00
perl -p -e "s/(-DVERSION=\")[^\"]+/\$${1}$(VERSION)/" -i $@
hledger-web/hledger-web.cabal: $(VERSIONFILE)
perl -p -e "s/(^ *version:) *.*/\1 $(VERSION)/" -i $@
perl -p -e "s/(^[ ,]*hledger *[>=]=) *.*/\1 $(VERSION)/" -i $@
perl -p -e "s/(^[ ,]*hledger-lib *[>=]=) *.*/\1 $(VERSION)/" -i $@
2012-10-22 01:09:24 +04:00
perl -p -e "s/(-DVERSION=\")[^\"]+/\$${1}$(VERSION)/" -i $@
MANUAL.md: $(VERSIONFILE)
perl -p -e "s/(^Version:) +[0-9.]+/\1 $(VERSION)/" -i $@
DOWNLOAD.md: $(VERSIONFILE)
2011-04-18 11:26:58 +04:00
perl -p -e "s/hledger(|-chart|-web|-vty)-[0-9.]+-/hledger\1-$(VERSION)-/g" -i $@
2010-07-25 02:08:54 +04:00
tagrelease:
2013-06-24 19:05:34 +04:00
git tag -a $(VERSION)
# display a hackage upload command reminder
hackageupload:
2012-11-17 08:31:38 +04:00
for p in $(PACKAGES); do cabal upload $$p/dist/$$p-$(VERSION).tar.gz -v2; done
2013-01-11 17:32:42 +04:00
hackageupload-dry:
for p in $(PACKAGES); do cabal upload $$p/dist/$$p-$(VERSION).tar.gz -v2; done
# send unpushed patches to the mail list
send:
darcs send http://joyful.com/repos/hledger --to=hledger@googlegroups.com --edit-description
# push patches and anything else pending to the public server
2011-04-23 02:57:00 +04:00
push: pushprofs # pushlatestbinary
2010-07-19 02:22:11 +04:00
darcs push simon@joyful.com:/repos/hledger
2008-10-18 08:34:41 +04:00
# pull anything pending from the public server
pull: pullprofs
2010-07-19 02:22:11 +04:00
darcs pull -a simon@joyful.com:/repos/hledger
2012-10-22 01:09:24 +04:00
RSYNC=rsync
# push any new profiles and benchmark results to the public site
# beware, results will vary depending on which machine generated them
pushprofs:
2012-10-22 01:09:24 +04:00
$(RSYNC) -azP profs/ simon@joyful.com:/repos/hledger/profs/
# fetch any new profiles and benchmark results from the public site
pullprofs:
2012-10-22 01:09:24 +04:00
$(RSYNC) -azP simon@joyful.com:/repos/hledger/profs/ profs/
# compress the just-built platform binary. make hledgerPLATFORM first. Use
# the win variant on windows.
compressbinary:
gzip -9 bin/$(BINARYFILENAME)
compressbinarywin:
cd bin; zip -9 $(BINARYFILENAME).zip $(BINARYFILENAME)
# push the last-updated platform binary to the public download directory
2011-04-23 02:57:00 +04:00
pushlatestbinary:
2012-09-28 21:35:07 +04:00
cd bin; $(RSYNC) -aP `ls -t | head -2` simon@joyful.com:/repos/hledger/site/download/
# show project stats useful for release notes
2011-09-02 05:00:53 +04:00
showreleasestats stats: \
showreleasedays \
showunreleasedchangecount \
showloc \
showtestcount \
showunittestcoverage \
showreleaseauthors \
showunreleasedcodechanges \
showunpushedchanges
# simplebench
# showerrors
FROMTAG=.
showreleasedays:
@echo Days since last release:
@tools/dayssincetag.hs $(FROMTAG) | head -1 | cut -d' ' -f-1
@echo
2011-04-18 11:26:58 +04:00
showunreleasedchangecount:
@echo Commits since last release:
@darcs changes --from-tag $(FROMTAG) --count
2011-04-18 11:26:58 +04:00
@echo
2009-01-21 01:27:32 +03:00
showreleaseauthors:
@echo Patch authors since last release:
@darcs changes --from-tag $(FROMTAG) |grep '^\w' |cut -c 31- |sort |uniq
@echo
2011-08-19 22:39:58 +04:00
showloc sloccount:
@echo Current lines of code including tests:
@sloccount `ls $(SOURCEFILES)` | grep haskell:
@echo
showtestcount:
@echo "Unit tests:"
@hledger test 2>&1 | cut -d' ' -f2
@echo "Functional tests:"
@make --no-print functest | egrep '^ Total' | awk '{print $$2}'
@echo
showunittestcoverage:
@echo Unit test coverage:
@make --no-print quickcoverage | grep 'expressions'
@echo
# showerrors:
# @echo Known errors:
2012-02-23 18:47:10 +04:00
# @awk '/^** errors/, /^** / && !/^** errors/' NOTES.org | grep '^\*\*\* ' | tail +1
# @echo
2012-10-22 01:09:24 +04:00
showunpushedchanges showunpushed:
@echo "Changes not yet pushed upstream (to `darcs show repo | grep 'Default Remote' | cut -c 17-`):"
2010-07-19 02:22:11 +04:00
@-darcs push simon@joyful.com:/repos/hledger --dry-run | grep '*' | tac
@echo
2012-10-22 01:09:24 +04:00
showunreleasedcodechanges showunreleased showchanges:
@echo "hledger code changes since last release:"
@darcs changes --from-tag $(FROMTAG) --matches "not (name docs: or name doc: or name site: or name tools:)" | grep '*'
@echo
showcodechanges:
@echo "hledger code changes:"
@darcs changes --matches "not (name docs: or name site: or name tools:)" | egrep '^ +(\*|tagged)'
@echo
######################################################################
# MISCELLANEOUS
# fix permissions (eg after darcs get)
fixperms:
chmod +x tools/* $(MAIN) hledger-*/Main.hs
tag: emacstags
emacstags:
2012-03-11 22:39:26 +04:00
-@rm -f TAGS; hasktags -e $(SOURCEFILES) $(WEBFILES) $(CABALFILES) $(DOCFILES) Makefile
clean:
2012-01-30 08:30:41 +04:00
rm -rf `find . -name "*.o" -o -name "*.hi" -o -name "*~" -o -name "darcs-amend-record*" -o -name "*-darcs-backup*" | grep -v .virthualenv`
2012-03-30 00:41:47 +04:00
cleanbin:
rm -f bin/hledgerdev bin/hledgerdev.ghc*
2012-03-30 00:41:47 +04:00
Clean: clean cleanbin cleandocs
rm -f TAGS tags
2008-10-03 11:40:28 +04:00
-include Makefile.local