arcgis 0.1.3

Type-safe Rust SDK for the ArcGIS REST API with compile-time guarantees
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

# Integration Tests

## Setup

Integration tests require ArcGIS credentials and the `api` feature flag.

### 1. Create `.env` file

Copy the example file:

```bash
cp .env.example .env
```

### 2. Add your credentials

Edit `.env` and add either:

**Option A: API Key** (recommended for read-only testing):
```bash
ARCGIS_API_KEY=your_api_key_here
```

Get an API key from: https://developers.arcgis.com/dashboard

**Option B: OAuth Credentials** (for full read/write testing):
```bash
ARCGIS_CLIENT_ID=your_client_id_here
ARCGIS_CLIENT_SECRET=your_client_secret_here
```

### 3. Run integration tests

Run all integration tests (hits live AGOL):

```bash
cargo test --features api
```

Or use the justfile recipe:

```bash
just test-api
```

Run specific test:

```bash
cargo test --features api test_public_feature_service_accessible
```

## Rate Limiting

Tests include `rate_limit()` calls to be polite to the ArcGIS Online API. Do not remove these delays.

## Target Environment

All integration tests target **ArcGIS Online (AGOL)**, not ArcGIS Enterprise.

## Test Organization

- `tests/common/` - Shared utilities, credential loading
- `tests/integration_basic.rs` - Basic connectivity tests
- `tests/integration_feature_service.rs` - Feature Service tests (TODO)
- `tests/integration_geocoding.rs` - Geocoding tests (TODO)

## Public Test Data

Some tests use ESRI's public sample data:
- World Cities Feature Service (read-only, no auth required)

These tests verify basic API structure without requiring credentials.