### Verify Beancount Installation

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Example ledger file and commands to verify that the installation is working correctly.

```text
2024-01-01 open Assets:Bank

2024-01-01 open Equity:Opening-Balances

2024-01-01 * "Opening Balance"

  Assets:Bank  1000.00 USD

  Equity:Opening-Balances
```

```bash
bean-query tst.bean
```

```bash
python -m beanquery tst.bean
```

--------------------------------

### Install and Run Tests on Linux

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount_v3.md

Install pytest and execute the test suite.

```bash
python -m pip install pytest
pytest --import-mode=importlib beancount/
```

--------------------------------

### Install and Run Tests on Windows

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount_v3.md

Install pytest and execute the test suite.

```cmd
(venv) C:\_code\t\beancount>py -m pip install pytest
(venv) C:\_code\t\beancount>pytest --import-mode=importlib beancount
```

--------------------------------

### Build and install Beancount from source

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Install dependencies and the package from the local source directory.

```bash
sudo -H python3 -m pip install .
```

--------------------------------

### Install Dependencies on Linux

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount_v3.md

Install build tools required for the installation.

```bash
python -m pip install meson-python meson ninja
```

--------------------------------

### Install Dependencies on Windows

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount_v3.md

Install required build packages using the Python launcher.

```cmd
(venv) C:\_code\t\beancount>py -m pip install meson-python meson ninja
```

--------------------------------

### Generate Example Beancount Ledger

Source: https://context7.com/beancount/docs/llms.txt

Create an example Beancount ledger file for learning purposes using 'bean-example'. The output is redirected to a new file.

```bash
bean-example > example.beancount
```

--------------------------------

### Check winflexbison Installation

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Verifies that winflexbison has been installed correctly by checking its version.

```bash
win_bison --version
```

--------------------------------

### Install and verify Beancount with pipx

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Install Beancount in an isolated virtual environment and list installed packages.

```bash
pipx install beancount
```

```bash
pipx list
```

--------------------------------

### File Assertion Syntax Examples

Source: https://github.com/beancount/docs/blob/master/docs/balance_assertions_in_beancount.md

Examples of file-based balance assertions for Beancount plugins.

```text
2012-02-03 file_balance Assets:CA:Bank:Checking    417.61 CAD
```

```text
file_balance Assets:CA:Bank:Checking    417.61 CAD
```

--------------------------------

### Install Beancount with uv

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Use the uv package manager to install Beancount and beanquery tools.

```bash
uv tool install beancount

uv tool install beanquery
```

--------------------------------

### Verify Beancount Installation

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Run the bean-check command to verify that the installation is working correctly.

```bash
$ bean-check

usage: bean-check [-h] [-v] filename
bean-check: error: the following arguments are required: filename
```

--------------------------------

### Configure Beancount Funds

Source: https://github.com/beancount/docs/blob/master/docs/fund_accounting_with_beancount.md

Example setup for pay stub accounts, including FSA and 403b retirement funds, using the proposed Fund-based accounting syntax.

```beancount
    option "title" "Paystub - no Funds"

    2014-07-15 open Assets:Bank:Checking
    2014-07-15 open Assets:CreditUnion:Saving
    2014-07-15 open Assets:FedIncTaxDeposits
    2014-07-15 open Expenses:OASI
    2014-07-15 open Expenses:Medicare
    2014-07-15 open Expenses:MedicalAid
    2014-07-15 open Expenses:SalReduction:HealthInsurance
    2014-07-15 open Expenses:SalReduction:FSA
    2014-07-15 open Expenses:SalReduction:R-403b
    2014-07-15 open Income:Gross:Emp1
    2014-07-15 open Income:EmplContrib:Emp1:Retirement
    2014-01-01 open FSA:Assets                    	; FSA fund accounts
    2014-01-01 open FSA:Income:Contributions
    2014-01-01 open FSA:Expenses:Medical
    2014-01-01 open FSA:Expenses:ReimburseMedical
    2014-01-01 open FSA:Liabilities
    2014-07-15 open Retirement403b:Assets:CREF    	; Retirement fund accounts
    2014-07-15 open Retirement403b:Income:EmployeeContrib
    2014-07-15 open Retirement403b:Income:EmployerContrib
    2014-07-15 open Retirement403b:Income:EarningsGainsAndLosses

    ; This implements the same idea as above for the FSA, of balancing
    ; Assets and Liabilities at the opening, but now does it using a 
    ; separate Fund.
    2014-01-01 ! "Set up FSA for 2014"
      FSA:Assets                                                 	2000 USD
      FSA:Liabilities                                           	-2000 USD

    2014-07-15 ! "Emp1 Paystub"
      Income:Gross:Emp1                                         	-6000 USD
      Assets:Bank:Checking                                       	3000 USD
      Assets:CreditUnion:Saving                                  	1000 USD
      Assets:FedIncTaxDeposits                                    	750 USD
      Expenses:OASI                                               	375 USD
      Expenses:Medicare                                           	100 USD
      Expenses:MedicalAid                                          	10 USD
      Expenses:SalReduction:R-403b                                	600 USD
      Retirement403b:Income:EmployeeContrib                       	-600 USD
      Retirement403b:Assets:CREF                                  	600 USD
      Expenses:SalReduction:FSA                                    	75 USD
      FSA:Income:Contributions                                    	-75 USD
      FSA:Liabilities                                            	 
      Expenses:SalReduction:HealthInsurance                      	 
      Retirement403b:Income:EmployerContrib                       	-600 USD
      Retirement403b:Assets:CREF
```

--------------------------------

### Setup Virtual Environment on Linux

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount_v3.md

Create and activate a Python virtual environment for the project.

```bash
python3.12 -m venv beancount/venv
. beancount/venv/bin/activate
cd beancount
```

--------------------------------

### Install Beancount v3 via Beanquery

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Recommended installation methods for Beancount v3 using pip or uv.

```bash
pip install beanquery
```

```bash
python -m pip install beanquery
```

```bash
uv tool install beanquery
```

--------------------------------

### Install Beancount in Editable Mode on Windows

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount_v3.md

Install the package in editable mode.

```cmd
(venv) C:\_code\t\beancount> py -m pip install --editable .
```

--------------------------------

### Install Pytest for Testing

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Installs the pytest framework, which is used for running Beancount's unit tests.

```bash
python -m pip install pytest
```

--------------------------------

### Install Beancount v2

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Commands to install the final version of Beancount v2.

```bash
pip install "beancount<3"
```

```bash
python -m pip install "beancount<3"
```

--------------------------------

### Install Beancount Converter Environment

Source: https://github.com/beancount/docs/blob/master/README.md

Commands to create a virtual environment for the converter.

```bash
python3 -m venv venv
. venv/bin/activate
```

--------------------------------

### Install Beancount using pip

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Install Beancount from PyPI or directly from the source repository using pip.

```bash
sudo -H python3 -m pip install beancount
```

```bash
sudo -H python3 -m pip install git+https://github.com/beancount/beancount#egg=beancount
```

--------------------------------

### Navigate to Beancount Directory on Windows

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount_v3.md

Change to the installation directory within the command prompt.

```cmd
C:\Program Files\Microsoft Visual Studio\2022\Community>cd C:\_code\t\beancount
C:\_code\t\beancount>
```

--------------------------------

### Launch the bean-web interface

Source: https://github.com/beancount/docs/blob/master/docs/getting_started_with_beancount.md

Starts the web server to view reports for a specific Beancount file.

```shell
bean-web /path/to/your/file.beancount
```

--------------------------------

### Install Converter Dependencies

Source: https://github.com/beancount/docs/blob/master/README.md

Install required Python packages from the requirements file.

```bash
pip install -r requirements.txt
```

--------------------------------

### Example Account Names

Source: https://github.com/beancount/docs/blob/master/docs/the_double_entry_counting_method.md

Concrete examples of applying the naming convention to asset and liability accounts.

```text
Assets:US:BofA:Checking
```

```text
Liabilities:US:Amex:Platinum
```

--------------------------------

### Clone and Install Beancount from Source

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Clones the Beancount repository from GitHub and installs it in editable mode using pip.

```bash
git clone https://github.com/beancount/beancount.git
```

```bash
cd beancount
```

```bash
python -m pip install --no-build-isolation -e .
```

--------------------------------

### Example Transaction for Splitting

Source: https://github.com/beancount/docs/blob/master/docs/sharing_expenses_with_beancount.md

This is an example of an input transaction before the split_expenses plugin is applied. It shows a shared expense that needs to be divided.

```beancount
2015-02-28 * "Scuba Club Cozumel" | "Room bill"
  Income:Martin:CreditCard         -1380.40 USD
  Expenses:Scuba:Martin              178.50 USD
  Expenses:Accommodation            1201.90 USD
```

--------------------------------

### List Beancount Dependencies

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Execute this command to output the versions of installed dependencies for troubleshooting purposes.

```bash
python3 -m beancount.scripts.deps
```

--------------------------------

### Instantiate Cost Object

Source: https://github.com/beancount/docs/blob/master/docs/beancount_design_doc.md

Example of creating a Cost object with decimal, currency, date, and label.

```python
Cost(Decimal("56.78"), "USD", date(2012, 3, 5), "lot15")
```

--------------------------------

### Launch bean-query in interactive mode

Source: https://github.com/beancount/docs/blob/master/docs/beancount_query_language.md

Starts the interactive query tool on a specific ledger file.

```bash
$ bean-query myfile.beancount
```

--------------------------------

### Self-Running Importer Example

Source: https://github.com/beancount/docs/blob/master/docs/beangulp_design_doc_for_new_repo.md

An example of how an importer's main function can be structured to be self-running for testing and direct invocation.

```python
if __name__ == '__main__':
            main = Ingest([SoAndSoBankImporter()])
            main()
```

--------------------------------

### Reordered File-Based Assertions Example

Source: https://github.com/beancount/docs/blob/master/docs/balance_assertions_in_beancount.md

Demonstrates the same set of transactions as the previous example, but with the credit card payment assertion moved. This reordering can lead to processing failures.

```beancount
;; Credit card account
2014/05/01 opening
  Liabilities:CreditCard    $-1000.00
  Expenses:Opening-Balances

2014/05/12 dinner
  Liabilities:CreditCard    $-74.20
  Expenses:Restaurant

2014/06/05 cc payment
  Assets:Checking            $-1074.20 = $3008.67
  Liabilities:CreditCard     = $0

;; Checking account
2014/06/05 salary
  Assets:Checking            $4082.87
  Income:Salary
```

--------------------------------

### Initial Lot Transactions

Source: https://github.com/beancount/docs/blob/master/docs/beancount_language_syntax.md

Examples of transactions establishing initial lots for a commodity.

```beancount
2014-02-11 * "Bought shares of S&P 500"
  Assets:ETrade:IVV                20 IVV {183.07 USD, "ref-001"}
  … 

2014-03-22 * "Bought shares of S&P 500"
  Assets:ETrade:IVV                15 IVV {187.12 USD}
  … 
```

--------------------------------

### View bean-example help options

Source: https://github.com/beancount/docs/blob/master/docs/tutorial_example.md

Displays available command-line options for the example generator, including seed configuration.

```bash
bean-example --help
```

--------------------------------

### Install Pip3 Installer with Cygwin

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Installs the pip3 installer tool within a Cygwin environment. Ensure you use the 'easy_install' version that matches your Python installation.

```bash
easy_install-3.4 pip
```

--------------------------------

### Generate and Verify Beancount Files

Source: https://github.com/beancount/docs/blob/master/docs/tutorial_example.md

Create an initial example file and verify its integrity using the command line tools.

```bash
bean-example > example.beancount
```

```bash
bean-check example.beancount
```

--------------------------------

### Install Python Dependencies

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount_v3.md

Installs Python dependencies required to run Beancount programs. Ensure you have Python 3.8+ installed.

```bash
pip install –r requirements/dev.txt
```

--------------------------------

### Install Beancount Standalone

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Commands to install Beancount as a standalone package.

```bash
pip install beancount
```

```bash
python -m pip install beancount
```

--------------------------------

### Manage Documentation Website

Source: https://github.com/beancount/docs/blob/master/README.md

Commands to serve or build the static documentation website.

```makefile
make serve
```

```makefile
make build
```

--------------------------------

### Example: Buying Stock Lots

Source: https://github.com/beancount/docs/blob/master/docs/a_proposal_for_an_improvement_on_inventory_booking.md

Demonstrates how to record the purchase of stock lots with different acquisition dates and costs. This sets up inventory for future sales.

```beancount
2014-02-01 * "First trade"
  Assets:Investments:Stock        10 HOOL {500 USD}
  Assets:Investments:Cash
  Expenses:Commissions          9.95 USD
```

```beancount
2014-02-15 * "Second trade"
  Assets:Investments:Stock         8 HOOL {510 USD}
  Assets:Investments:Cash
  Expenses:Commissions          9.95 USD
```

--------------------------------

### Clone and Navigate Repository on Windows

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount_v3.md

Clone the repository and change to the project directory.

```cmd
git clone https://github.com/beancount/beancount.git
cd beancount
```

--------------------------------

### Execute Ledger Balance Report with Cost Syntax

Source: https://github.com/beancount/docs/blob/master/docs/a_proposal_for_an_improvement_on_inventory_booking.md

Command to display balance for the cost-syntax example and the resulting output.

```bash
$ ledger -f l7.lgr bal --lots
                   0  Assets:Investments
   -10 HOOL {USD500}    Cash
    10 HOOL {USD500}    Stock
--------------------
                   0
```

--------------------------------

### Example Source String Format

Source: https://github.com/beancount/docs/blob/master/docs/fetching_prices_in_beancount.md

Illustrates the general format for specifying a price source. The quote-currency is the currency the commodity is quoted in, followed by the module and symbol for lookup.

```text
USD:beancount.prices.sources.google/NASDAQ:AAPL
```

--------------------------------

### Build and Configure Development Environment

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Commands to build the source in-place and update environment variables for local development.

```bash
make build
```

```bash
export PATH=$PATH:/path/to/beancount/bin
export PYTHONPATH=$PYTHONPATH:/path/to/beancount
```

--------------------------------

### Install Beancount on WSL

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Commands to install Beancount and its dependencies within a Windows Subsystem for Linux environment.

```bash
sudo apt-get install python3-pip
sudo pip3 install m3-cdecimal  # probably not needed anymore
sudo pip3 install beancount --pre
```

--------------------------------

### Execute Import Script

Source: https://github.com/beancount/docs/blob/master/docs/importing_external_data.md

Command-line usage for executing the import script and accessing help documentation.

```bash
./your-import-script.py --help
```

--------------------------------

### Install Beancount in Editable Mode on Linux

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount_v3.md

Install the package in editable mode with build isolation disabled.

```bash
python -m pip install --no-build-isolation --editable .
```

--------------------------------

### Account Opening Order Example

Source: https://github.com/beancount/docs/blob/master/docs/beancount_language_syntax.md

Demonstrates that the Open directive date must precede transaction dates, regardless of file order.

```beancount
2014-05-05 * "Using my new credit card"
  Liabilities:CreditCard:CapitalOne         -37.45 USD
  Expenses:Restaurant

2014-05-01 open Liabilities:CreditCard:CapitalOne     USD
1990-01-01 open Expenses:Restaurant
```

--------------------------------

### Reducing Leg Example

Source: https://github.com/beancount/docs/blob/master/docs/beancount_v3.md

Example of a reducing leg transaction with price in annotation and empty cost basis.

```beancount
2021-02-24 * "SOLD -1 /NQH21:XCME 1/20 FEB 21 (EOM) /QNEG21:XCME 13100 CALL @149.00"
  Assets:US:Ameritrade:Futures:Options        -1 QNEG21C13100 {} @ 2980.00 USD
    contract: 149.00 USD
  ...
```

--------------------------------

### Augmenting Leg Example

Source: https://github.com/beancount/docs/blob/master/docs/beancount_v3.md

Example of an augmenting leg transaction requiring cost basis in curly braces.

```beancount
2021-02-24 * "BOT +1 /NQH21:XCME 1/20 FEB 21 (EOM) /QNEG21:XCME 13100 CALL @143.75"
  Assets:US:Ameritrade:Futures:Options         1 QNEG21C13100 {2875.00 USD}
    contract: 143.75 USD
  ...
```

--------------------------------

### View Export Portfolio Help

Source: https://github.com/beancount/docs/blob/master/docs/exporting_your_portfolio.md

This command displays the help information for the export_portfolio report, detailing available options for controlling the export process.

```bash
bean-report file.beancount export_portfolio --help
```

--------------------------------

### Commodity Examples in Beancount

Source: https://github.com/beancount/docs/blob/master/docs/beancount_language_syntax.md

Examples of currency/commodity names recognized by Beancount. These are case-sensitive and follow specific naming conventions.

```plaintext
USD
CAD
EUR
MSFT
IBM
AIRMILE
```

--------------------------------

### Query account register via CLI

Source: https://github.com/beancount/docs/blob/master/docs/beancount_query_language.md

Example command-line usage of bean-query to output a register with balances.

```bash
$ bean-query $T "select date, account, position, balance where account ~ 'Expenses:Food:Restaurant';"
   date            account          position   balance  
---------- ------------------------ --------- ----------
2012-01-02 Expenses:Food:Restaurant 31.02 USD  31.02 USD
2012-01-04 Expenses:Food:Restaurant 25.33 USD  56.35 USD
2012-01-08 Expenses:Food:Restaurant 67.88 USD 124.23 USD
2012-01-09 Expenses:Food:Restaurant 35.28 USD 159.51 USD
2012-01-14 Expenses:Food:Restaurant 25.84 USD 185.35 USD
2012-01-17 Expenses:Food:Restaurant 36.73 USD 222.08 USD
2012-01-21 Expenses:Food:Restaurant 28.11 USD 250.19 USD
2012-01-22 Expenses:Food:Restaurant 21.12 USD 271.31 USD
```

--------------------------------

### Cost-based Tolerance Inference Example

Source: https://github.com/beancount/docs/blob/master/docs/rounding_precision_in_beancount.md

An example of an abandoned approach for deriving tolerance based on units held at cost.

```beancount
2014-05-06 * “Buy mutual fund”
  Assets:Investments:RGXGX       23.45 RGAGX {42.6439 USD} 
  ...
```

```beancount
2011-01-25 * "Transfer of Assets, 3467.90 USD"
  * Assets:RothIRA:Vanguard:VTIVX  250.752 VTIVX {18.35 USD} @ 13.83 USD  
  * Assets:RothIRA:DodgeCox:DODGX  -30.892 DODGX {148.93 USD} @ 112.26 USD
```

--------------------------------

### Example Transaction Signature

Source: https://github.com/beancount/docs/blob/master/docs/calculating_portolio_returns.md

This is an example of a derived transaction signature, 'CASH_DIVIDEND', which is intended to uniquely identify a dividend payment transaction.

```plaintext
CASH_DIVIDEND
```

--------------------------------

### Execute equivalent bean-query command

Source: https://github.com/beancount/docs/blob/master/docs/running_beancount_and_generating_reports.md

SQL-like query to retrieve date, flag, description, account, and cost information.

```sql
    SELECT date, flag, description, account, cost(position), cost(balance);
```

--------------------------------

### Beancount Account Name Examples

Source: https://github.com/beancount/docs/blob/master/docs/beancount_language_syntax.md

Provides examples of valid Beancount account names, adhering to the specified structure of account types and components.

```beancount
Assets:US:BofA:Checking
Liabilities:CA:RBC:CreditCard
Equity:Retained-Earnings
Income:US:Acme:Salary
Expenses:Food:Groceries
```

--------------------------------

### Example Transaction in Beancount

Source: https://github.com/beancount/docs/blob/master/docs/calculating_portolio_returns.md

This is an example of a Beancount transaction for an ordinary dividend payment. It shows the date, flag, payee, and the postings to income and asset accounts.

```beancount
2020-03-12 * "(DOI) ORDINARY DIVIDEND"
  Income:US:BTrade:VTI:Dividend  -1312.31 USD
  Assets:US:BTrade:Cash           1312.31 USD
```

--------------------------------

### Use wildcard targets

Source: https://github.com/beancount/docs/blob/master/docs/beancount_query_language.md

Select default columns or inspect the query plan using wildcards and EXPLAIN.

```sql
SELECT * FROM year = 2014;
```

```sql
EXPLAIN SELECT * FROM year = 2014;
```

--------------------------------

### Activate Virtual Environment on Windows

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount_v3.md

Activate the existing virtual environment.

```cmd
C:\_code\t\beancount>venv\Scripts\Activate
(venv) C:\_code\t\beancount>
```

--------------------------------

### Partial Balance Assertion Example

Source: https://github.com/beancount/docs/blob/master/docs/balance_assertions_in_beancount.md

This is an example of a partial balance assertion in Beancount. It asserts the balance of a specific commodity in an account at the beginning of the specified date.

```beancount
2012-02-04 balance Assets:CA:Bank:Checking    417.61 CAD
```

--------------------------------

### Example Account Structure with Funds

Source: https://github.com/beancount/docs/blob/master/docs/fund_accounting_with_beancount.md

Illustrates how fund names are prefixed to account names to categorize financial data.

```plaintext
Operations:Assets:Bank:...
Endowment:Assets:Bank:...
Operations:Liabilities:CreditCard:...
Endowment:Liabilities:CreditCard:...
Operations:Income:Pledges:2014
Operations:Expenses:Salaries:...
Operations:Expenses:BuildingImprovement:...
Endowment:Income:Investments:...
Endowment:Expenses:BuildingImprovement:...
```

--------------------------------

### Example Beancount Transaction

Source: https://github.com/beancount/docs/blob/master/docs/the_double_entry_counting_method.md

This is an example of a transaction recorded in Beancount's plain-text format. It includes the date, status, payee, narration, and postings to different accounts.

```plaintext
2016-12-06 * "Biang!" "Dinner"
  Liabilities:CreditCard   -47.23 USD
  Expenses:Restaurants
```

--------------------------------

### Aggregate Function Example in Beancount Query

Source: https://github.com/beancount/docs/blob/master/docs/beancount_query_language.md

Shows an example of using an aggregate function (sum) in a Beancount query to summarize data. This query selects accounts matching 'Income' and sums their positions, grouping the results by account.

```beanquery
SELECT account, sum(position) WHERE account ~ 'Income' GROUP BY account;
```

--------------------------------

### Check Beanquery Version

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Verify the installed version of beanquery.

```bash
beanquery v0.2.0
```

--------------------------------

### Realistic Pad Directive Usage

Source: https://github.com/beancount/docs/blob/master/docs/beancount_language_syntax.md

Example showing an account opening, a pad directive, and a subsequent balance assertion.

```Beancount
; Account was opened way back in the past.
2002-01-17 open Assets:US:BofA:Checking

2002-01-17 pad Assets:US:BofA:Checking Equity:Opening-Balances

2014-07-09 balance Assets:US:BofA:Checking  987.34 USD
```

--------------------------------

### Check Beancount Version

Source: https://github.com/beancount/docs/blob/master/docs/installing_beancount.md

Verify the installed version of Beancount.

```bash
beancount v3.1.0
```

--------------------------------

### Currency Conversion Example in Ledger

Source: https://github.com/beancount/docs/blob/master/docs/a_proposal_for_an_improvement_on_inventory_booking.md

Demonstrates a currency conversion that results in an unbalanced trial balance, highlighting a flaw in Ledger's handling of conversions.

```ledger
2014/05/01 Transfer to Canada
  Assets:US:Checking             -40000 USD
  Assets:CA:Checking              50000 CAD @ 0.80 USD

2014/05/15 Transfer from Canada
  Assets:CA:Checking             -50000 CAD @ 0.85 USD
  Assets:US:Checking              42500 USD
```

--------------------------------

### Example Extracted Transaction

Source: https://github.com/beancount/docs/blob/master/docs/how_we_share_expenses.md

A sample transaction generated by the extract_tagged.py script.

```beancount
2019-02-01 * "AMAZON.COM" "MERCHANDISE - Diapers size 4 for Kyle" #kyle
  Income:Dad      -49.99 USD
  Expenses:Pharmacy   49.99 USD
```

--------------------------------

### Display Beancount report help and arguments

Source: https://github.com/beancount/docs/blob/master/docs/running_beancount_and_generating_reports.md

Lists the available command-line arguments for configuring report output.

```text
    optional arguments:
      -h, --help            show this help message and exit
      -a ACCOUNT, --account ACCOUNT
                            Account to render
      -w WIDTH, --width WIDTH
                            The number of characters wide to render the report to
      -k PRECISION, --precision PRECISION
                            The number of digits to render after the period
      -b, --render-balance, --balance
                            If true, render a running balance
      -c, --at-cost, --cost
                            If true, render values at cost
      -x, --compact         Rendering compactly
      -X, --verbose         Rendering verbosely
```

--------------------------------

### Launch Beancount Web Interface

Source: https://context7.com/beancount/docs/llms.txt

Start the Beancount web interface to browse your financial data interactively. It is accessible at http://localhost:8080 by default.

```bash
bean-web ledger.beancount
```