@gabrielerandelli/minus-tracker 0.5.6 → 0.5.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +41 -1
- package/package.json +3 -2
- package/samples/sample-trades.csv +6 -0
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[](./LICENSE)
|
|
4
4
|
|
|
5
|
-
> **Status:** v0.5.
|
|
5
|
+
> **Status:** v0.5.7 — published on npm as `@gabrielerandelli/minus-tracker`.
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -23,6 +23,26 @@ Carica dati seguendo il formato CSV adottato da DEGIRO.
|
|
|
23
23
|
- L'ouput può essere restituito in **italiano** (predefinito) o **inglese** (`--lang en`)
|
|
24
24
|
- minus-tracker è un package NPM con supporto CLI
|
|
25
25
|
|
|
26
|
+
### Avvio rapido
|
|
27
|
+
|
|
28
|
+
Non hai ancora un export DEGIRO? Usa il file di esempio incluso nel pacchetto.
|
|
29
|
+
|
|
30
|
+
**Via npx (senza installazione globale):**
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
curl -O https://raw.githubusercontent.com/gabrielerandelli/minus-tracker/main/samples/sample-trades.csv
|
|
34
|
+
npx @gabrielerandelli/minus-tracker calc sample-trades.csv
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
**Se hai già installato il pacchetto localmente:**
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
./node_modules/.bin/minus-tracker calc node_modules/@gabrielerandelli/minus-tracker/samples/sample-trades.csv
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Il file contiene 5 operazioni fittizie (Apple Inc in USD + ASML Holding in EUR) e mostra
|
|
44
|
+
abbinamento LIFO parziale, conversione valuta e un risultato netto positivo.
|
|
45
|
+
|
|
26
46
|
### Installazione CLI
|
|
27
47
|
|
|
28
48
|
**Installazione globale** (comando disponibile da qualsiasi directory):
|
|
@@ -100,6 +120,26 @@ It loads data following the CSV format used by DEGIRO.
|
|
|
100
120
|
- Output in **Italian** (default) or **English** (`--lang en`)
|
|
101
121
|
- minus-tracker is an NPM package with CLI support
|
|
102
122
|
|
|
123
|
+
### Quick Start
|
|
124
|
+
|
|
125
|
+
Don't have a DEGIRO export yet? Use the sample file bundled with the package.
|
|
126
|
+
|
|
127
|
+
**Via npx (no global install needed):**
|
|
128
|
+
|
|
129
|
+
```bash
|
|
130
|
+
curl -O https://raw.githubusercontent.com/gabrielerandelli/minus-tracker/main/samples/sample-trades.csv
|
|
131
|
+
npx @gabrielerandelli/minus-tracker calc sample-trades.csv
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
**If you have already installed the package locally:**
|
|
135
|
+
|
|
136
|
+
```bash
|
|
137
|
+
./node_modules/.bin/minus-tracker calc node_modules/@gabrielerandelli/minus-tracker/samples/sample-trades.csv
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
The file contains 5 fictional trades (Apple Inc in USD + ASML Holding in EUR) and
|
|
141
|
+
demonstrates partial LIFO matching, currency conversion, and a positive net result.
|
|
142
|
+
|
|
103
143
|
### CLI Installation
|
|
104
144
|
|
|
105
145
|
**Global install** (command available system-wide):
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@gabrielerandelli/minus-tracker",
|
|
3
|
-
"version": "0.5.
|
|
3
|
+
"version": "0.5.7",
|
|
4
4
|
"description": "Italian capital-gains/loss calculator for the Regime Dichiarativo",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"exports": {
|
|
@@ -13,7 +13,8 @@
|
|
|
13
13
|
"minus-tracker": "./dist/cli/index.js"
|
|
14
14
|
},
|
|
15
15
|
"files": [
|
|
16
|
-
"dist"
|
|
16
|
+
"dist",
|
|
17
|
+
"samples"
|
|
17
18
|
],
|
|
18
19
|
"scripts": {
|
|
19
20
|
"build": "tsup && node scripts/copy-assets.js",
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
Date,Time,Product,ISIN,Exchange,Execution centre,Quantity,Price,Local value,Local value currency,Value,Value currency,Exchange rate,Transaction costs,Transaction costs currency,Total,Total currency,Order ID
|
|
2
|
+
02-01-2024,10:00,Apple Inc,US0378331005,XNAS,XNAS,10,150.00,-1500.00,USD,-1365.00,EUR,0.91,-2.00,EUR,-1367.00,EUR,sample-001
|
|
3
|
+
05-01-2024,14:30,Apple Inc,US0378331005,XNAS,XNAS,-10,130.00,1300.00,USD,1188.00,EUR,0.91,-2.00,EUR,1186.00,EUR,sample-002
|
|
4
|
+
15-01-2024,09:30,ASML Holding N.V.,NL0010273215,XAMS,XAMS,5,800.00,-4000.00,EUR,-4000.00,EUR,1,-2.00,EUR,-4002.00,EUR,sample-003
|
|
5
|
+
01-04-2024,10:15,ASML Holding N.V.,NL0010273215,XAMS,XAMS,3,850.00,-2550.00,EUR,-2550.00,EUR,1,-2.00,EUR,-2552.00,EUR,sample-004
|
|
6
|
+
15-07-2024,11:15,ASML Holding N.V.,NL0010273215,XAMS,XAMS,-6,950.00,5700.00,EUR,5700.00,EUR,1,-2.00,EUR,5698.00,EUR,sample-005
|