hal-sdk 0.2.0

Async Rust SDK for the HAL open-archive API (hal.science) — companion crate of chapter 16 of the book Rust (ENI, 2022).
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

//! Integration tests that hit the live HAL API.
//!
//! They are tolerant of network failures (offline CI, rate limiting): a transport
//! error is treated as a skip rather than a failure. The response *shape*, however,
//! must be correct whenever the API does answer.

use hal_sdk::{HalClient, SearchQuery};

#[tokio::test]
async fn basic_search_returns_documents() {
    let client = HalClient::new();
    match client.basic_search("programmation").await {
        Ok(results) => {
            assert!(results.num_found() >= 0);
            for doc in results.docs() {
                assert!(!doc.docid.is_empty());
            }
        }
        Err(reason) => eprintln!("skipping: HAL API unreachable ({reason})"),
    }
}

#[tokio::test]
async fn field_search_with_pagination_and_facets() {
    let client = HalClient::new();
    let query = SearchQuery::field("title_t", "europe")
        .fields(["docid", "label_s", "title_s", "docType_s"])
        .facet("docType_s")
        .page(0, 5);

    match client.search(&query).await {
        Ok(results) => {
            assert!(results.docs().len() <= 5);
            if let Some(facets) = results.facets() {
                let _ = facets.field("docType_s");
            }
        }
        Err(reason) => eprintln!("skipping: HAL API unreachable ({reason})"),
    }
}