datalab-cli 0.1.0

A powerful CLI for converting, extracting, and processing documents using the Datalab 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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156

# Installation

This guide covers the different ways to install the Datalab CLI.

## Requirements

- **Rust**: Version 1.70 or later (for building from source)
- **Operating System**: Linux, macOS, or Windows

---

## Install from Cargo (Recommended)

If you have Rust installed, the easiest way to install is via Cargo:

```bash
cargo install datalab
```

This installs the `datalab` binary to `~/.cargo/bin/`.

!!! tip "Add Cargo bin to PATH"
    Make sure `~/.cargo/bin` is in your PATH:
    ```bash
    export PATH="$HOME/.cargo/bin:$PATH"
    ```

---

## Build from Source

Clone the repository and build:

```bash
git clone https://github.com/datalab/datalab-cli
cd datalab-cli
cargo build --release
```

The binary will be at `target/release/datalab`.

### Install system-wide

=== "Linux/macOS"

    ```bash
    sudo cp target/release/datalab /usr/local/bin/
    ```

=== "Windows"

    Copy `target\release\datalab.exe` to a directory in your PATH.

---

## Verify Installation

Check that the CLI is installed correctly:

```bash
datalab --version
```

Expected output:
```
datalab 0.1.0
```

Get help:
```bash
datalab --help
```

---

## Install Man Pages

Man pages are generated during the build process. To install them:

=== "Linux"

    ```bash
    # Find the generated man pages
    ls target/release/build/datalab-*/out/man/

    # Install to system man directory
    sudo cp target/release/build/datalab-*/out/man/*.1 /usr/local/share/man/man1/

    # Update man database
    sudo mandb
    ```

=== "macOS"

    ```bash
    # Install to local man directory
    cp target/release/build/datalab-*/out/man/*.1 /usr/local/share/man/man1/
    ```

After installation, you can view man pages:

```bash
man datalab
man datalab-convert
man datalab-extract
```

---

## Updating

To update to the latest version:

=== "Cargo"

    ```bash
    cargo install datalab --force
    ```

=== "From Source"

    ```bash
    cd datalab-cli
    git pull
    cargo build --release
    ```

---

## Uninstalling

=== "Cargo"

    ```bash
    cargo uninstall datalab
    ```

=== "Manual"

    ```bash
    # Remove binary
    rm /usr/local/bin/datalab

    # Remove man pages
    rm /usr/local/share/man/man1/datalab*.1

    # Remove cache (optional)
    rm -rf ~/.cache/datalab
    ```

---

## Next Steps

- [Set up your API key](configuration.md)
- [Follow the quickstart guide](quickstart.md)