aei_tag_parser 1.0.1

A simple tool and library to parse AEI RFID tags
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

# AEI TAG PARSER

This library provides a way to deserialize RFID AEI tags used in railway industry to identify wagons. It can be used both a CLI util or a library

# Usage 

## CLI

Deserialize one or multiple tags passed as parameters :
```bash 
# One tag :
$ aei-tag-parser 9EA488C030426A179000000000000331
# Output : 
# 9EA488C030426A179000000000000331 : Initials : IOCC      Car number : 3088
# Multiple tags :
$ aei-tag-parser 2F3E06C007DB1E139000000000000331 9EA488C030426A179000000000000331 9EA488C5320CC01B9000000000000331
# Output : 
# 2F3E06C007DB1E139000000000000331 : Initials : QNSL      Car number : 502
# 9EA488C030426A179000000000000331 : Initials : IOCC      Car number : 3088
# 9EA488C5320CC01B9000000000000331 : Initials : IOCC      Car number : 85123
```

Tag deserialization from a file :
```bash
# tags.txt content :
$ cat tags.txt
# Output :
# 2F3E06C007DB1E139000000000000331
# 9EA488C030426A179000000000000331
# 9EA488C5320CC01B9000000000000331
$ aei-tag-parser -f test.txt
# Output :
# 2F3E06C007DB1E139000000000000331 : Initials : QNSL      Car number : 502
# 9EA488C030426A179000000000000331 : Initials : IOCC      Car number : 3088
# 9EA488C5320CC01B9000000000000331 : Initials : IOCC      Car number : 85123
```

Tag deserialization from a UNIX pipe :
```bash
# tags.txt content :
$ cat tags.txt
# Output :
# 2F3E06C007DB1E139000000000000331
# 9EA488C030426A179000000000000331
# 9EA488C5320CC01B9000000000000331
$ cat tags.txt | aei-tag-parser
# Output :
# 2F3E06C007DB1E139000000000000331 : Initials : QNSL      Car number : 502
# 9EA488C030426A179000000000000331 : Initials : IOCC      Car number : 3088
# 9EA488C5320CC01B9000000000000331 : Initials : IOCC      Car number : 85123
```

## Librairie

This project can also be used as an external library. Documentation is available here : [https://docs.rs/aei_tag_parser/1.0.0/aei_tag_parser/index.html](https://docs.rs/aei_tag_parser/1.0.0/aei_tag_parser/index.html)

### Usage

```rust
let tag_str : String = String::from("9EA488C030426A179000000000000331");
let tag : AEITagData = AEITagData::new(&tag_str);

println!("Tag {} content is : \r\n\tInitials: {}\r\n\tCar number: {}", &tag_str, tag.equipment_initial(), tag.car_number());
```

# Install

To install the CLI util, you must have Rust installed (cf [RustUp](https://rustup.rs/)).

Then you can simply do : 
```bash 
$ cargo install aei_tag_parser
```