intrac 1.0.0

Unofficial library to track Easypack24/InPost shipments and parcels via their Web API.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

# Intrac
This is an **unofficial** tiny API client for Easypack24 v1 (InPost delivery services) that helps you track
locker-to-locker deliveries of parcels on the aforementioned platforms.

The API endpoints used are public and don't require authentication at the time of writing.
The full API docs are available at [InPost Italy Developers](https://developers.inpost.it/#operation/getTracking).

## As a library

You can use this crate as a library in your projects. It provides a fully async API and
complete type definitions with doc comments.

### Library Example
```rust
use intrac::InPostApiClient;

pub async fn print_shipment_status(shipment_id: &str /* 0123...888 */) -> Result<(), Box<dyn std::error::Error>> {
    let mut api_client = InPostApiClient::new("it" /* country code */)?;
    let shipment = api_client.lookup_shipment(shipment_id).await?;
    println!("Status: {}", shipment.status);
    // And many more fields, as found in the Shipment struct.
    Ok(())
}
```

## As a command-line tool

You can also use this as a standalone application, to track _your_ shipments.
Simply invoke the executable (`cargo build`) or run it from the repo (`cargo run -- `) with the
shipment IDs as arguments. You must provide at least one ID, and they will be resolved in order.

### CLI Example
```shell
# Query two shipments
./intrac 843534321829832368922940 863723273223883882932840
# Will output the following (truncated for brevity):
Shipment 843534321829832368922940
        Created at: 2024-12-02 14:10:03.098 UTC
        Updated at: 2024-12-03 15:03:32.077 UTC
        Type: inpost_locker_standard
        Service: inpost_locker_standard
        Status: sent_from_sorting_center
        Size: C
        End-of-week collection: no
        Drop-off machine:
                Name: ITTOR11684
                Machine type: ParcelLocker
                Address: C.so Filippo Turati 75, 10134 Torino
                Location: N45.04681, E7.66353 (presso CARREFOUR)
                24/7: yes
                Opening hours: 24/7
        Target machine:
                Name: ITVAR44848M
                Machine type: ParcelLocker
                Address: Via Giovanni Borghi 30/0, 21100 Varese
                Location: N45.83419, E8.79707 (Lidl)
                24/7: yes
        Event log:
                Date & time: 2024-12-03 15:03:32 UTC
                Status: adopted_at_source_branch
                Origin status: PWO
                ----------
                Date & time: 2024-12-03 14:38:26 UTC
                Status: taken_by_courier
                Origin status: CustomerSent
                Agency: MI2
                ----------
                Date & time: 2024-12-03 11:07:48 UTC
                Status: dispatched_by_sender
                Origin status: CustomerStored
                Agency: MI2
                ----------
                Date & time: 2024-12-02 14:10:03 UTC
                Status: confirmed
                Origin status: CustomerDelivering
                Agency: MI2
                ----------
Shipment 863723273223883882932840
        Created at: [...]
```

## Not implemented yet
- Authenticated requests: label creation, shipment creation, query by company
- Points list
- `expected_flow` in `Shipment`
- `location` in `TrackingEvent`