beancounterp - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

beancounter - Công cụ theo dõi hiệu suất danh mục đầu tư chứng khoán

TỔNG HỢP

beancounter [tùy chọn] lệnh [command_arguments ...]

HÀNG

addindex index args thêm (các) cổ phiếu vào chỉ số thị trường 'indx'
addportfolio sym: nb: fx: type: o: pp: pd ...
thêm 'nb' cổ phiếu của công ty có ký hiệu 'sym'
được liệt kê bằng đơn vị tiền tệ 'fx' cho
danh mục đầu tư với 'loại' và 'chủ sở hữu' tùy chọn
thông tin, giá mua 'pp' và ngày 'pd';
xem bên dưới để biết một ví dụ hoàn chỉnh
allreports kết hợp báo cáo trong ngày, trạng thái và rủi ro
addstock arg ... thêm (các) cổ phiếu có biểu tượng arg vào cơ sở dữ liệu
báo cáo tiến bộ về lợi nhuận chưa thực hiện từ mức thấp
backpopulate arg ... điền vào dữ liệu lịch sử cho (các) cổ phiếu nhất định
kiểm tra kết nối db kiểm tra nếu kết nối với db có thể được thiết lập
dailyjob kết hợp cập nhật, báo cáo trong ngày, trạng thái + rủi ro
báo cáo dayendreport báo cáo p / l thay đổi so với ngày hôm trước
hủy kích hoạt biểu tượng ... đặt (các) cổ phiếu không hoạt động trong bảng stockinfo
xóa arg ... xóa (các) cổ phiếu đã cho khỏi cơ sở dữ liệu
killdb xóa cơ sở dữ liệu BeanCounter
fxbackpopulate arg ... điền vào dữ liệu lịch sử cho (ies) tiền tệ
dữ liệu danh mục đầu tư danh mục đầu tư
plreport chạy báo cáo p / l danh mục đầu tư rel. đến bất kỳ ngày nào
trích dẫn arg ... báo cáo dữ liệu hiện tại cho (các) cổ phiếu nhất định
báo cáo thoái lui các khoản lỗ chưa thực hiện từ mức cao (rút tiền)
rủi ro hiển thị một báo cáo rủi ro danh mục đầu tư
split arg ... split-điều chỉnh lịch sử giá và danh mục đầu tư
báo cáo tóm tắt tình trạng trạng thái cho danh mục đầu tư
cập nhật cập nhật cơ sở dữ liệu với dữ liệu trong ngày
bảo hành hiển thị câu lệnh GNU GPL ngắn

LỰA CHỌN

--help hãy hiển thị sự trợ giúp này
--verbose hoạt động chi tiết hơn, gỡ lỗi
--date ngày báo cáo cho ngày này (hôm nay)
- ngày cập nhật liên quan đến ngày này (hôm qua)
--currency fx đặt tiền nội tệ
--restrict sql áp đặt hạn chế SQL
--extrafx fx1, fx2, ... các loại tiền tệ bổ sung để tải
- ngàyforceupdate buộc db phải lưu trữ thông tin giá mới với ngày
Tệp --rcfile sử dụng tệp cấu hình khác
- [no] fxupdate thực thi / ngăn chặn cập nhật FX, mặc định là cập nhật
- [không] cam kết thực thi / ngăn chặn cập nhật cơ sở dữ liệu, mặc định là cam kết
- [no] Equityupdate thực thi / ngăn chặn cập nhật Equity, mặc định là update
- [không] sử dụng ubcfx / bỏ qua FX từ trường Sauder của UBC, bỏ qua mặc định
--splitby arg chia lịch sử chứng khoán + vị trí theo yếu tố này [2]
- hệ thống dbsystem sử dụng hệ thống phụ trợ db, mặc định là PostgreSQL
--dbname name sử dụng db name, mặc định là beancounter

MÔ TẢ

người bán đậu thu thập và phân tích dữ liệu thị trường chứng khoán để đánh giá hiệu quả hoạt động của danh mục đầu tư. Nó
có một số phương thức hoạt động. Chế độ chính đầu tiên là thu thập dữ liệu: cả dữ liệu hiện tại
(ví dụ: giá đóng cửa cuối ngày) và dữ liệu giá lịch sử (để điền lại cơ sở dữ liệu)
có thể được truy xuất cả tự động và hiệu quả với bộ nhớ cục bộ tiếp theo trong một
hệ thống cơ sở dữ liệu quan hệ (một trong hai PostgreSQL, MySQL or SQLite) mặc dù bất kỳ hệ thống nào khác
với một ODBC trình điều khiển có thể được sử dụng). Chế độ chính thứ hai là phân tích dữ liệu nơi lưu trữ
dữ liệu được đánh giá để cung cấp thông tin về hiệu suất. Một số loại báo cáo soạn trước là
đã có sẵn.

Dữ liệu được truy xuất rất hiệu quả trong một truy vấn hàng loạt duy nhất trên mỗi Yahoo! máy chủ từ
Yahoo! Các trang web tài chính sử dụng mô-đun Finance :: YahooQuote (trong đó phiên bản 0.18 hoặc mới hơn là
cần hỗ trợ proxy). Hỗ trợ tồn tại cho Bắc Mỹ (tức là Hoa Kỳ và Canada), Châu Âu
(tức là Châu lục cũng như Vương quốc Anh), một số thị trường chứng khoán Châu Á, Úc và
New Zealand.

người bán đậu có thể tổng hợp sự thay đổi về giá trị cho toàn bộ danh mục đầu tư theo thời gian tùy ý
đường chân trời (được cung cấp dữ liệu lịch sử đã được thu thập hoặc đã được phổ biến lại).
Sử dụng quy trình phân tích ngày tháng mạnh mẽ có sẵn cho Perl (nhờ Ngày :: Thao tác
), bạn có thể chỉ cần nói 'từ sáu tháng trước đến hôm nay' (xem ví dụ bên dưới).

người bán đậu đã được viết và thử nghiệm trên Linux. Nó sẽ chạy dưới bất kỳ Unix tiêu chuẩn nào
miễn là các mô-đun Perl bắt buộc được cài đặt, miễn là phần phụ trợ cơ sở dữ liệu
tìm.

VÍ DỤ

cập nhật beancounter - cập nhật ngay hôm nay

Điều này cập nhật cơ sở dữ liệu: nó mở rộng dữ liệu thời gian (chẳng hạn như
mở, thấp, cao, đóng, âm lượng) với dữ liệu cho ngày hiện tại,
và ghi đè dữ liệu tĩnh (chẳng hạn như vốn, giá / thu nhập, ...)
với dữ liệu hiện tại. Tất cả các cổ phiếu có trong cơ sở dữ liệu đều được cập nhật
(trừ khi đối số --restricts hướng dẫn khác). Các
- tùy chọnforceupdate cho phép chương trình sửa các ngày không chính xác
được trả lại từ Yahoo! (điều này xảy ra thường xuyên), nhưng
hãy cẩn thận để sửa chữa cho điều này vào ngày lễ. Lưu ý rằng
đối số - hạn chế sẽ được áp dụng cho bảng danh mục đầu tư,
trong khi lựa chọn tổng thể đến từ bảng stockinfo.

danh mục bổ sung Beancounter IBM:100:USD:401k:joe:90.25:20000320 \
SPY: 50: USD: ira: joe: 142.25: 20000620

Điều này bổ sung IBM vào danh mục đầu tư 401k của Joe, cũng như SP500
'Nhện' vào danh mục đầu tư IRA của anh ấy. Các cổ phiếu cũng được thêm vào
bảng thông tin chứng khoán chung thông qua lệnh gọi ngầm của stockinfo
chỉ huy.

phụ gia beancounter LNUX RHAT COR.TO

Điều này thêm ba công ty Linux này vào cơ sở dữ liệu mà không cần thêm
chúng vào bất kỳ danh mục đầu tư cụ thể nào.

Beancounter backpopulate --prevdate '1 năm trước' \
--date 'Friday 1 week ago' IBM MSFT HWP

Điều này phổ biến cơ sở dữ liệu với giá lịch sử cho ba
các công ty phần cứng. Lưu ý cách đặc tả ngày rất chung chung
nhờ mô-đun Date :: Manip bên dưới.

Beancounter fxbackpopulate --prevdate '1 năm trước' \
- ngày 'thứ sáu 1 tuần trước' CAD EUR GBP

Điều này phổ biến cơ sở dữ liệu với giá lịch sử cho những
ba loại tiền tệ. Lưu ý cách đặc tả ngày rất chung chung
nhờ mô-đun Date :: Manip bên dưới.

Thật không may, Yahoo! là một chút đầu xương trong việc thực hiện nó
tỷ giá hối đoái lịch sử - những tỷ giá này chỉ được lưu trữ ở hai số thập phân
độ chính xác, giống như giá cổ phiếu. Thật không may, quy ước là
sử dụng ít nhất bốn nếu không phải sáu. Vì thông tin hạn chế,
rủi ro từ các thay đổi ngoại hối sẽ bị đánh giá thấp.

Beancounter plreport --prevdate '1 tháng trước' --date 'hôm nay' \
--restriction "owner = 'joe'"

Điều này tính toán lãi hoặc lỗ của danh mục đầu tư trong tháng trước. Nó
cũng áp đặt hạn chế cơ sở dữ liệu rằng chỉ những cổ phiếu thuộc sở hữu của
'joe' phải được bao gồm.

trạng thái beancounter - hạn chế "type = '401k'"

Điều này hiển thị báo cáo trạng thái danh mục đầu tư với hạn chế là chỉ
cổ phiếu từ tài khoản '401k' sẽ được bao gồm.

nguy cơ beancounter --prevdate "6 tháng trước"

Điều này cho thấy một báo cáo rủi ro danh mục đầu tư. Thử này mô tả
tổn thất hợp lý về mặt thống kê chỉ nên vượt quá 1
100 lần (xem bên dưới để biết thêm chi tiết).

beancounter dailyjob - ngày hôm nay cập nhật

Chạy một 'công việc' hoàn chỉnh: cập nhật cơ sở dữ liệu, hiển thị lãi / lỗ cuối ngày
báo cáo, hiển thị báo cáo trạng thái danh mục đầu tư và hiển thị báo cáo rủi ro. bên trong
chế độ cập nhật, ghi đè ngày có thể sai do Yahoo!
với ngày hiện tại.

tách beancount --splitby 3 --prevdate 1990-01-01 ABC CDE

Phân tách điều chỉnh các cổ phiếu (giả định) ABC và CDE theo một yếu tố
của ba: dữ liệu giá trong cơ sở dữ liệu được chia cho ba, khối lượng
tăng 3 và tương tự, trong danh mục đầu tư cổ phiếu được tăng
và chi phí được giảm xuống. Ngày mặc định là --prevdate và --date
mà có thể cần điều chỉnh.

Tutorial

Một vài đoạn văn sau đây sẽ minh họa việc sử dụng người bán đậu. Chúng tôi sẽ thiết lập hai
tài khoản hư cấu cho hai anh em Bob và Bill (để chúng tôi có thể minh họa 'chủ sở hữu'
cột). Giá dưới đây là hoàn toàn hư cấu, cũng như danh mục đầu tư.

Chúng tôi cho rằng người bán đậu được cài đặt và setup_beancount lệnh đã được
chạy. Sau đó, chúng tôi có thể tạo danh mục đầu tư hai cổ phiếu (phần cứng máy tính) cho Bob như sau:

Beancounter addportfolio SPY:50:USD:401k:bob:142.25:20000620 \
IBM: 100: USD: 401k: bob: 90.25: 20000320

Ở đây, chúng tôi chỉ định rằng 100 cổ phiếu của SPY và IBM, được định giá bằng Đô la Mỹ, là của Bob
danh mục đầu tư được gắn thẻ là tài khoản hưu trí 401k. Giá mua (hư cấu)
và ngày cũng được đưa ra.

Giả sử rằng Bill thích thiết bị mạng hơn và anh ta có tài khoản môi giới
ở Canada:

danh mục bổ sung Beancounter CSCO:100:USD:spec:bill:78.00:19990817 \
NT.TO:200:CAD:spec:bill:cad:90.25:20000212

Bây giờ chúng ta có thể phổ biến lại cơ sở dữ liệu từ năm 1998 trở đi cho cả bốn cổ phiếu:

Beancounter backpopulate --prevdate 19980101 CSCO IBM NT.TO SPY

Với dữ liệu lịch sử đã có, bây giờ chúng tôi so sánh danh mục đầu tư của Bob sẽ hoạt động như thế nào
trong 18 tháng qua:

Beancounter plreport --prevdate '18 tháng trước' \
--restriction "owner = 'bob'"

Lưu ý cách chúng tôi sử dụng dấu ngoặc kép để bảo vệ các đối số và cách hạn chế SQL
chứa một trích dẫn đơn lẻ khác xung quanh chuỗi ký tự.

Chúng tôi cũng có thể xem xét hoạt động của Bill vào ngày giao dịch gần đây nhất:

beancounter dayendreport --restrict "owner = 'bill'"

hoặc trạng thái của các khoản nắm giữ và giá trị tương ứng của chúng:

beancounter dayendreport --restrict "owner = 'bill'"

Tương tự, một báo cáo rủi ro có thể được chạy trên danh mục đầu tư này theo

nguy cơ beancounter --restriction "owner = 'bill'"

MORE CHI TIẾT COMMAND MÔ TẢ

thêm danh mục đầu tư là lệnh 'nhập vị trí' quan trọng nhất. Cũng như các lệnh khác,
một số đối số có thể được đưa ra cùng một lúc. Đối với mỗi trong số này, các bản ghi được tách biệt
sử dụng dấu hai chấm và chỉ định, theo thứ tự, ký hiệu cổ phiếu, số lượng cổ phiếu nắm giữ, đơn vị tiền tệ,
loại tài khoản, chủ tài khoản, giá mua và ngày mua. Chỉ ba cái đầu tiên
các đối số là bắt buộc, các đối số khác là tùy chọn. Đang thực thi thêm danh mục đầu tư ngầm hiểu
thi hành phụ gia. Cột loại tài khoản có thể được sử dụng để chỉ định liệu tài khoản có,
ví dụ: một tài khoản hưu trí được bảo vệ thuế, hoặc nó có thể được sử dụng để biểu thị việc môi giới
công ty được tổ chức tại.

báo cáo truy xuất (các) trích dẫn gần đây nhất. Điều này rất hữu ích cho các chứng khoán kém thanh khoản
có thể đã không giao dịch vào ngày hôm đó, hoặc nếu một ngày lễ xảy ra, hoặc nếu có dữ liệu
tại Yahoo !. Hai ngày có thể được chỉ định để xác định khoảng thời gian mà
lãi hoặc lỗ được tính toán. Điều này sẽ không thành công nếu dữ liệu giá (hoặc dữ liệu tiền tệ trong trường hợp
dữ liệu chứng khoán nước ngoài) không có sẵn cho một trong hai ngày đó. Điều này có thể
hạn chế đối với cổ phiếu nước ngoài mà chúng ta không thể phổ biến trở lại do thiếu dữ liệu công khai
nguồn cho báo giá tiền tệ lịch sử. Các loại tiền tệ chính có thể được lấy từ Yahoo !, nhưng
chỉ tới hai phân số thập phân.

báo cáo trong ngày tương tự như báo cáo nhưng luôn trong khoảng thời gian một ngày. Nó cũng sử dụng
chỉ một bản ghi ngày bằng cách tính toán hiệu suất với dữ liệu 'đóng trước đó'.

tình trạng hiển thị số tiền nắm giữ, tổng giá trị vị thế, lợi nhuận hàng năm theo tỷ lệ phần trăm
và giữ khoảng thời gian tính bằng ngày. Lưu ý rằng lợi nhuận hàng năm có thể xuất hiện quá mức nếu,
ví dụ: lợi nhuận mười ngày từ một cổ phiếu đã mua gần đây được ngoại suy thành thời gian hàng năm
thời gian.

nguy cơ hiển thị một báo cáo rủi ro danh mục đầu tư mô tả khoản lỗ hợp lý về mặt thống kê,
chỉ nên vượt quá 1 trong số 100 lần. Nói cách khác, ước tính tổn thất có
mức độ nguy cấp 99%. Mức độ rủi ro này được ước tính thông qua hai phương pháp. Đầu tiên là không
tham số và giả định không có mô hình hoặc phân phối cụ thể; nó tính toán 1% ngũ phân vị của
phân phối lợi nhuận và hiển thị nó cũng như giá trị tài sản tương ứng bị rủi ro.
Phương pháp thứ hai sử dụng cách tiếp cận Giá trị-rủi ro (VaR) tiêu chuẩn. Điều này sử dụng 1%
giá trị tới hạn của Phân phối chuẩn và mặc nhiên giả định phân phối chuẩn cho
lợi nhuận. Nhìn thấy "http://www.gloriamundi.org"để giới thiệu thêm và tham khảo. Nếu
phân phối chuẩn là hoàn toàn đúng, cả hai số đo sẽ trùng khớp. Một lớn
sự khác biệt giữa hai ước tính sẽ chỉ ra rằng phân phối lợi nhuận có thể là
khá không bình thường. Một quan điểm khác về mức độ rủi ro của một vị trí nhất định được cung cấp bởi
cột cuối cùng với tiêu đề 'margVaR'. Nó cho thấy Giá trị rủi ro cận biên. VaR biên
thường được định nghĩa là mức đóng góp rủi ro của vị thế nhất định vào tổng danh mục đầu tư,
và được tính bằng sự khác biệt trong VaR của danh mục đầu tư đầy đủ và VaR của một
nếu không thì danh mục đầu tư giống hệt nhau với vị thế đã cho bị loại bỏ. Lưu ý rằng tính toán
VaR biên khá chậm (theo bậc O (n ^ 3)].

thoái lui hiển thị một báo cáo 'rút lui'. Rút vốn thường được định nghĩa là phần trăm tổn thất
so với mức cao trước đó. Khoảng thời gian mặc định được sử dụng, nhưng có thể được thay đổi bằng
--ngày và --prevdate tùy chọn. Khoảng thời gian mặc định cũng được điều chỉnh cho việc nắm giữ thực tế
khoảng thời gian. Nói cách khác, nếu một cổ phiếu đã được giữ trong hai tháng, thì chỉ trong hai tháng đó là
được sử dụng thay vì mặc định là sáu tháng - nhưng nếu các tháng trước đã được chọn qua
--prevdate sau đó nó được sử dụng. Đối với các vị thế bán, phân tích được đảo ngược và liên quan đến
mức thấp trước đó. Báo cáo hiển thị từng cổ phiếu, số lượng cổ phiếu nắm giữ, hiện tại
giá cả và giá trị nắm giữ. Hai cột tiếp theo hiển thị giá tối đa đạt được trong
khoảng thời gian được kiểm tra và phần trăm suy giảm liên quan đến nó. Cột cuối cùng hiển thị
khoản lỗ chưa thực hiện so với giá tối đa trong kỳ. Tổng số cổ phần
giá trị, phần trăm suy giảm và tổn thất chưa thực hiện cũng được hiển thị.

thăng tiến ngược lại với rút lui - nó tính toán lợi nhuận chưa thực hiện liên quan đến
giá tối thiểu trong kỳ. Thảo luận trong đoạn trước áp dụng `nhưng
đảo ngược '.

danh mục đầu tư chỉ cần liệt kê nội dung của bảng danh mục đầu tư. Một hạn chế SQL có thể
áp đặt.

thêm chỉ mục thêm cổ phiếu vào bảng chỉ số. Hiện tại, không có phân tích nào khác đề cập đến vấn đề này
bảng.

phụ gia thêm cổ phiếu vào cơ sở dữ liệu. Từ đó, dữ liệu sẽ được truy xuất cho
(các) biểu tượng và được lưu trữ trong cơ sở dữ liệu bất cứ khi nào cập nhật lệnh được thực hiện.

dân cư trở lại điền vào cơ sở dữ liệu với giá lịch sử cho các ký hiệu và ngày nhất định
khoảng thời gian. Lưu ý rằng điều này hoạt động tốt cho cổ phiếu và quỹ tương hỗ. Tùy chọn không có lịch sử
dữ liệu được lưu trữ. Tiền tệ được lưu trữ với độ chính xác hạn chế như đã nêu ở trên.

trích dẫn chỉ đơn giản là hiển thị báo giá cho (các) ký hiệu đã cho.

cập nhật cập nhật cơ sở dữ liệu với báo giá cho tất cả các cổ phiếu trong ngày nhất định. Không có đầu ra là
được tạo ra, làm cho lệnh phù hợp với cron chấp hành.

Công việc hằng ngày là một trình bao bọc tiện lợi đơn giản xung quanh cập nhật, báo cáo trong ngày, tình trạng và nguy cơ,

báo cáo tất cả là một trình bao bọc tiện lợi khác xung quanh báo cáo trong ngày, tình trạng và nguy cơ.

tắt sẽ đặt cột hoạt động trong stockinfo cho (các) biểu tượng đã cho thành false
do đó ngăn cản mọi cập nhật thêm của (các) biểu tượng. Dữ liệu hiện có cho (các) ký hiệu là
giữ lại. Sử dụng điều này khi cổ phiếu được mua lại, bị hủy niêm yết hoặc bạn chỉ muốn ngừng theo dõi
nó - nhưng không muốn xóa dữ liệu lịch sử.

chia điều chỉnh cơ sở dữ liệu giá và danh mục đầu tư nắm giữ để tách cổ phiếu. Các
hệ số mặc định là 2, điều này có thể được điều chỉnh bằng tùy chọn --chia theo. Các đối số ngày tháng
có thể được thiết lập với --prevdate và --ngày.

xóa loại bỏ các ký hiệu đã cho khỏi cơ sở dữ liệu.

Destdb xóa cơ sở dữ liệu BeanCounter.

kiểm tra kết nối chỉ cần mở và đóng xử lý cơ sở dữ liệu và trả về một
mã thoát mà sau đó có thể được kiểm tra. Điều này được sử dụng trong setup_beancount chỉ huy.

sự bảo đảm hiển thị một tuyên bố ngắn gọn về Giấy phép Công cộng GNU.

MORE CHI TIẾT TÙY CHỌN MÔ TẢ

--tiền tệ có thể được sử dụng để chọn một nhà tiền tệ. Thay vì có tất cả các giá trị
được chuyển đổi sang đơn vị tiền tệ mặc định, đơn vị tiền tệ đã chọn sẽ được sử dụng.

--ngày cho phép chọn một ngày tham chiếu khác. Điều này sau đó sẽ được sử dụng bởi các lệnh
làm việc vào một ngày hoặc khoảng thời gian ngày, chẳng hạn như báo cáo, báo cáo trong ngày, dân cư trở lại,
fxbackpopulation or tình trạng. --prevdate cho phép chọn một ngày bắt đầu khác để trở lại
tính toán hoặc thu thập dữ liệu.

--sự hạn chế có thể được sử dụng để hạn chế lựa chọn cơ sở dữ liệu. Đối số phải hợp lệ
một phần của câu lệnh SQL hợp lệ theo nghĩa là các cột và toán tử hiện có phải
được tuyển dụng. Đối số cho tùy chọn này sẽ được hoàn thành với một và. SQL
hạn chế điển hình sẽ là trên các yếu tố của danh mục đầu tư bảng bao gồm
cột biểu tượng, Lượt chia sẻ, tiền tệ, kiểu, chủ sở hữu, chi phí và ngày. Một ví dụ đơn giản sẽ là
tiền tệ = 'CAD'. Lưu ý rằng điều này phải được bảo vệ bằng dấu ngoặc kép "I trên dòng lệnh.

--extrafx cho phép thu thập dữ liệu về tỷ giá tiền tệ bổ sung ngoài tỷ giá tự động
được chọn như cổ phiếu được liệt kê trong đó. Một ví dụ điển hình sẽ là đối với một nhà đầu tư châu Âu
muốn chuyển đổi từ đồng EUR trong đó cổ phiếu được liệt kê thành một trong các thành viên
tiền tệ mà người bán đậu sẽ không còn truy xuất nữa vì cổ phiếu không còn được liệt kê trong
những cái này.

--forceupdate cho phép ghi đè một ngày có khả năng sai trong bản cập nhật cơ sở dữ liệu.
Thật không may, có vẻ như Yahoo! đôi khi báo cáo giá chính xác với một
ngày không chính xác chẳng hạn như ngày hôm trước. Trong trường hợp như vậy, tùy chọn này, cùng với một
đối số chẳng hạn như 'hôm nay' có thể ghi đè lên điểm dữ liệu ngày xấu và tránh một lỗ hổng trong
cơ sở dữ liệu. Nhược điểm của phương pháp này là nó sẽ "nhân đôi" dữ liệu trước đó trong
trường hợp của một ngày lễ, hoặc ngay cả khi nó được chạy vào cuối tuần. Một so sánh thông minh hơn một chút
đối với dữ liệu được lưu trữ trước đó có thể ngăn chặn điều đó, nhưng sẽ phức tạp hơn để triển khai.

--rcfile cho phép chỉ định một tệp tài nguyên khác với mặc định ~ / .beancounterrc.

--dbsystem cho phép chuyển sang một cơ sở dữ liệu phụ trợ khác. Mặc định là PostgreSQL nhưng
MySQL và SQLite cũng được hỗ trợ. Vì SQLite, mặc định bây giờ là phiên bản 3. * nhưng
phiên bản trước - không tương thích song song - cũng được hỗ trợ với đối số
'SQLite2'.

--dbname cho phép chuyển sang cơ sở dữ liệu thay thế. Giá trị mặc định là 'beancounter'. Cái này có thể
hữu ích để thử nghiệm các tính năng mới.

--fxupdate là một công tắc boolean để cập nhật trước tỷ giá hối đoái trong quá trình 'cập nhật'. Các
mặc định là 'true' nhưng '--nofxupdate' có thể được sử dụng để ngăn cập nhật nước ngoài
tỷ giá hối đoái.

Tương tự, --cập nhật công bằng là một chuyển đổi boolean sang enforece hoặc chặn các bản cập nhật của Equity
(tức là cổ phiếu) dữ liệu trong quá trình 'cập nhật'. Mặc định là 'true' nhưng '--noequityupdate' có thể là
được sử dụng để ngăn chặn việc cập nhật tỷ giá hối đoái.

--ubcfx là một công tắc boolean để sử dụng dịch vụ tỷ giá hối đoái 'PACIFIC' từ Trường Sauder tại
UBC. Điều này rất hữu ích khi dịch vụ tỷ giá hối đoái mặc định tại Yahoo! là thất thường, hoặc không đáng tin cậy.
Trong khi máy chủ PACIFIC cung cấp nhiều loại tỷ giá hối đoái hơn, Yahoo! vẫn có thể
hữu ích vì nó có thể cung cấp nhiều cột hơn (mở / cao / thấp). Tuy nhiên, trong hầu hết năm 2005,
Yahoo! không đáng tin cậy đối với tỷ giá hối đoái và không cung cấp tỷ giá hối đoái lịch sử
dữ liệu. Mặt khác, dịch vụ UBC không chạy vào các ngày lễ của Canada nên nó không thể
thực sự là máy chủ thay thế đầy đủ. Đóng góp cho việc thu thập dữ liệu mới, có thể thông qua
www.oanda.com sẽ được chào đón.

--chia theo có thể được sử dụng để đặt hệ số phân chia cổ phiếu khác với giá trị mặc định là 2.

--tổ chức có thể được sử dụng để trỏ đến máy chứa cơ sở dữ liệu PostgreSQL hoặc MySQL. Các
máy có thể được điều khiển từ xa, hoặc nó có thể là máy thực tế người bán đậu đang chạy. Nếu một
tên máy chủ được cung cấp, kết nối tcp / ip được sử dụng. Nếu không có tên máy chủ nào được cung cấp, giá trị mặc định
của 'localhost' ngụ ý rằng các kết nối ổ cắm cục bộ được sử dụng có thể dễ dàng hơn
sử dụng cho người dùng cơ sở dữ liệu quảng cáo ít kinh nghiệm hơn.

Cũng thế, --làm là một công tắc boolean để ngăn chặn các bản cập nhật cơ sở dữ liệu thực tế nếu bị phủ định
--không cam kết đã được chọn. Điều này hữu ích chủ yếu trong các ngữ cảnh gỡ lỗi.

Sản phẩm --dài dòng và --gỡ lỗi công tắc có thể được sử dụng để gỡ lỗi thử nghiệm và --Cứu giúp
kích hoạt hiển thị thông báo trợ giúp.

WELFARE TỔNG QUAN

Phần sau trình bày chi tiết một số tùy chọn cấu hình và cơ sở dữ liệu.

DATABASE YÊU CẦU
người bán đậu hiện tại phụ thuộc vào PostgreSQL, MySQL, SQLite (phiên bản 2 hoặc 3) hoặc bất kỳ
cơ sở dữ liệu khác có sẵn trình điều khiển ODBC (mặc dù các bảng bắt buộc sẽ
phải tạo thủ công trong trường hợp ODBC). Tuy nhiên, một chương trình phụ trợ DB khác có thể được thêm vào được cung cấp
có sẵn các trình điều khiển Perl DBI phù hợp. Đối với PostgreSQL, MySQL và SQLite,
setup_beancount script có thể tạo và khởi tạo cơ sở dữ liệu, tạo thành các bảng cần thiết
và điền vào chúng bằng một số dữ liệu ví dụ. Nó là một điểm khởi đầu cho những sửa đổi cục bộ.

Kết nối với cơ sở dữ liệu được thực hiện thông qua một chức năng chuyên dụng trong BeanCounter.pm
mô-đun, thay đổi sẽ chỉ được thực hiện ở đó. Khi viết bài này, Perl DBI (Các
giao diện độc lập với cơ sở dữ liệu cho Perl) được sử dụng cùng với các trình điều khiển DBI cho PostgreSQL,
MySQL, SQLite và ODBC. Các cổng cho Oracle, Sybase, ... được khuyến khích.

CẤU HÌNH FILE
Một tệp cấu hình ~ / .beancounterrc được đọc nếu tìm thấy. Nó hiện hỗ trợ
tùy chọn sau:

tiền tệ để xác định mức nắm giữ tiền nội tệ và lãi / lỗ phải
chuyển đổi
chủ nhà để chỉ định máy chủ cơ sở dữ liệu mà trên đó đậu truy cập cơ sở dữ liệu cư trú (đây là
chỉ cần thiết cho kết nối thay thế thông qua trình điều khiển DBI-Pg trong trường hợp DBI-ODBC không
đã sử dụng)
người sử dụng để chỉ định userid cho kết nối cơ sở dữ liệu; Nếu cần thiết. Nếu không được chỉ định,
id người dùng hiện tại được sử dụng.
passwd để chỉ định mật khẩu cho kết nối cơ sở dữ liệu, nếu cần.
hệ thống db để chọn một chương trình phụ trợ cơ sở dữ liệu, ví dụ: để chuyển từ PostgreSQL sang MySQL hoặc SQLite
hoặc SQLite2 (định dạng trước của SQLite).
tên cơ sở dữ liệu để chọn một tên cơ sở dữ liệu mặc định khác với tên mặc định của 'beancounter'
Proxy để chỉ định địa chỉ của máy chủ proxy tường lửa nếu cần một máy chủ để kết nối với
Internet.
tường lửa để chỉ định kết hợp firewallid: firewallpasswd, nếu cần.
tỷ lệ là một công tắc để bật hoặc tắt kết nối ODBC
DSN sử dụng tên nguồn dữ liệu khác khi ODBC được sử dụng
Một tệp ví dụ ví dụ.beancounterrc lẽ ra phải đi kèm với các nguồn (hoặc
Gói Debian); vui lòng tham khảo tệp này để biết thêm ví dụ.

ODBC CẤU HÌNH
Hiện đã có một số hệ thống ODBC dành cho Linux / Unix. Sau ~ / .odbc.ini
làm việc với iODBC thư viện và PostgreSQL Trình điều khiển ODBC trên hệ thống Debian GNU / Linux của tôi:

[Nguồn dữ liệu ODBC]
beancounter = Cơ sở dữ liệu BeanCounter

[máy đếm đậu]
Trình điều khiển = /usr/lib/libpsqlodbc.so
Cơ sở dữ liệu = beancounter
Tên máy chủ = máy chủ cục bộ

[ODBC]
Cài đặtDir = / Usr / lib

Ngoài ra, unixODBC thư viện có thể được sử dụng với lược đồ sau cho
/etc/odbcinst.ini (Hoặc ~ / .odbcinst.ini) để xác định các trình điều khiển cơ sở dữ liệu Postgres

[PostgreSQL]
Mô tả = Trình điều khiển ODBC PostgreSQL cho Linux và Windows
Trình điều khiển = /usr/lib/postgresql/lib/libodbcpsql.so
Thiết lập = /usr/lib/odbc/libodbcpsqlS.so
Gỡ lỗi = 0
Nhật ký giao tiếp = 0
Sử dụng tệp = 1

sau đó /etc/odbc.ini (Hoặc ~ / .odbc.ini) có thể được sử dụng để xác định các nguồn dữ liệu thực tế như
sau:

[PostgreSQL]
Mô tả = PostgreSQL template1
Trình điều khiển = PostgreSQL
Trace = Không
TraceFile = /tmp/odbc.log
Cơ sở dữ liệu = template1
Tên máy chủ = máy chủ cục bộ
Tên người dùng =
Mật khẩu =
Cổng = 5432
Giao thức = 6.4
ReadOnly = Có
RowVersoning = Không
ShowSystemTables = Không
ShowOidColumn = Không
FakeOidIndex = Không
Cài đặt kết nối =

[máy đếm đậu]
Mô tả = Beancounter DB (Postgresql)
Trình điều khiển = Postgresql
Trace = Không
Tệp theo dõi =
Cơ sở dữ liệu = beancounter
Tên máy chủ = some.db.host.com
Tên người dùng =
Mật khẩu =
Cổng = 5432
Giao thức = 6.4
ReadOnly = Không
RowVersoning = Không
ShowSystemTables = Không
ShowOidColumn = Không
FakeOidIndex = Không
Cài đặt kết nối =

Sử dụng beancounterp trực tuyến bằng các dịch vụ onworks.net