hledger Verified current stable Not installed? Data Processing

Hledger / Mark File As Seen

Mark File As Seen

Marks the specified CSV file as processed, indicating it should not be re-imported in the future.

$
Terminal
hledger import --catchup <path/to/bank.csv>

When To Use

To ensure a bank file is not re-imported after transactions have been processed.

Pro Tip

Keep a log of processed files to avoid future mismatches; consider using a database for tracking.

Command Builder

Tune the command before you copy it

Back to syntax
$
Generated Command
hledger import --catchup <path/to/bank.csv>

Anatomy of Output

Understanding the result

Marking file as seen: path/to/bank.csv File Status

Behavior indicates that the file is being marked.

Processed: 45 transactions Unprocessed Transactions

Indicates how many transactions were processed.

Success: File marked successfully. Status Confirmation

Confirms successful marking operation.

Troubleshooting

Common pitfalls

Error: File path not found: path/to/bank.csv

Solution: Verify the path is correct; ensure the file exists.

Warning: No transactions have been processed from this file

Solution: Check for unprocessed transactions before marking.

Error: File already marked as seen

Solution: No action needed; the file is already tracked.

Command Breakdown

What each part is doing

hledger
Base Command
The executable that performs this operation. Here it runs Hledger before the shell applies any redirect operators.
<path/to/bank.csv>
path to bank.csv
The value supplied for path to bank.csv.
--catchup
Command Option
Tool-specific option used by this command invocation.

Alternative Approaches

Comparable commands in other tools

Alternative data processing tools for the same job.