124 lines
4.0 KiB
Plaintext
124 lines
4.0 KiB
Plaintext
|
|
hledger-api(1) hledger User Manuals hledger-api(1)
|
|
|
|
|
|
|
|
NAME
|
|
hledger-api - web API server for the hledger accounting tool
|
|
|
|
SYNOPSIS
|
|
hledger-api [OPTIONS]
|
|
hledger-api --swagger
|
|
hledger api -- [OPTIONS]
|
|
|
|
DESCRIPTION
|
|
hledger is a cross-platform program for tracking money, time, or any
|
|
other commodity, using double-entry accounting and a simple, editable
|
|
file format. hledger is inspired by and largely compatible with
|
|
ledger(1).
|
|
|
|
hledger-api is a simple web API server, intended to support client-side
|
|
web apps operating on hledger data. It comes with a series of simple
|
|
client-side app examples, which drive its evolution.
|
|
|
|
Like hledger, it reads data from one or more files in hledger journal,
|
|
timeclock, timedot, or CSV format specified with -f, or $LEDGER_FILE,
|
|
or $HOME/.hledger.journal (on windows, perhaps
|
|
C:/Users/USER/.hledger.journal). For more about this see hledger(1),
|
|
hledger_journal(5) etc.
|
|
|
|
The server listens on IP address 127.0.0.1, accessible only to local
|
|
requests, by default. You can change this with --host, eg
|
|
--host 0.0.0.0 to listen on all addresses. Note there is no other
|
|
access control, so you will need to hide hledger-api behind an authen-
|
|
ticating proxy if you want to restrict access. You can change the TCP
|
|
port (default: 8001) with -p PORT.
|
|
|
|
If invoked as hledger-api --swagger, instead of starting a server the
|
|
API docs will be printed in Swagger 2.0 format.
|
|
|
|
OPTIONS
|
|
Note: if invoking hledger-api as a hledger subcommand, write -- before
|
|
options as shown above.
|
|
|
|
-d --static-dir=DIR
|
|
serve files from a different directory (default: .)
|
|
|
|
-p --port=PORT
|
|
use a different TCP port (default: 8001)
|
|
|
|
--swagger
|
|
print API docs in Swagger 2.0 format, and exit
|
|
|
|
hledger general options:
|
|
|
|
-h show general usage (or after COMMAND, the command's usage)
|
|
|
|
--help show the current program's manual as plain text (or after an
|
|
add-on COMMAND, the add-on's manual)
|
|
|
|
--man show the current program's manual with man
|
|
|
|
--info show the current program's manual with info
|
|
|
|
--version
|
|
show version
|
|
|
|
--debug[=N]
|
|
show debug output (levels 1-9, default: 1)
|
|
|
|
-f FILE --file=FILE
|
|
use a different input file. For stdin, use -
|
|
|
|
--rules-file=RULESFILE
|
|
Conversion rules file to use when reading CSV (default:
|
|
FILE.rules)
|
|
|
|
--alias=OLD=NEW
|
|
display accounts named OLD as NEW
|
|
|
|
-I --ignore-assertions
|
|
ignore any failing balance assertions in the journal
|
|
|
|
ENVIRONMENT
|
|
LEDGER_FILE The journal file path when not specified with -f. Default:
|
|
~/.hledger.journal (on windows, perhaps C:/Users/USER/.hledger.jour-
|
|
nal).
|
|
|
|
FILES
|
|
Reads data from one or more files in hledger journal, timeclock, time-
|
|
dot, or CSV format specified with -f, or $LEDGER_FILE, or
|
|
$HOME/.hledger.journal (on windows, perhaps
|
|
C:/Users/USER/.hledger.journal).
|
|
|
|
BUGS
|
|
The need to precede options with -- when invoked from hledger is awk-
|
|
ward.
|
|
|
|
|
|
|
|
REPORTING BUGS
|
|
Report bugs at http://bugs.hledger.org (or on the #hledger IRC channel
|
|
or hledger mail list)
|
|
|
|
|
|
AUTHORS
|
|
Simon Michael <simon@joyful.com> and contributors
|
|
|
|
|
|
COPYRIGHT
|
|
Copyright (C) 2007-2016 Simon Michael.
|
|
Released under GNU GPL v3 or later.
|
|
|
|
|
|
SEE ALSO
|
|
hledger(1), hledger-ui(1), hledger-web(1), hledger-api(1),
|
|
hledger_csv(5), hledger_journal(5), hledger_timeclock(5), hledger_time-
|
|
dot(5), ledger(1)
|
|
|
|
http://hledger.org
|
|
|
|
|
|
|
|
hledger-api dev January 2017 hledger-api(1)
|