s3-headers-lite 0.1.0

A minimal, lightweight alternative to the official AWS crates. Only the headers necessary for communicating with S3-like services.
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

# s3-headers-lite

[![CI](https://github.com/softwarepatterns-com/s3-headers-lite/actions/workflows/ci.yml/badge.svg)](https://github.com/softwarepatterns-com/s3-headers-lite/actions/workflows/ci.yml)
[![crates.io](https://img.shields.io/crates/v/s3-headers-lite.svg)](https://crates.io/crates/s3-headers-lite)
[![docs.rs](https://docs.rs/s3-headers-lite/badge.svg)](https://docs.rs/s3-headers-lite)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/softwarepatterns-com/s3-headers-lite/blob/main/LICENSE)

A minimal, lighter-weight alternative to the official AWS crates. Zero `aws-*` dependencies. 

Only generates the headers necessary for communicating with S3-like services, so use any HTTP client you want. Examples use reqwest, but any HTTP client will work.

## Get

```rust
use s3_headers_lite::{S3HeadersBuilder, ValidS3Url};

let url = ValidS3Url::parse("https://example.s3.amazonaws.com/test/test.json").unwrap();

let headers = S3HeadersBuilder::new(&url)
  .set_access_key(&access_key)
  .set_secret_key(&secret_key)
  .set_region(&region)
  .set_method("GET")
  .build();

let response = reqwest::blocking::Client::new()
  .get(url.as_url().clone())
  .headers(reqwest::header::HeaderMap::from_iter(headers.into_iter().map(
    |(k, v)| {
      (
        reqwest::header::HeaderName::from_str(k).unwrap(),
        reqwest::header::HeaderValue::from_str(&v).unwrap(),
      )
    },
  )))
  .send()
  .unwrap();
```

## Put

```rust
use s3_headers_lite::{S3HeadersBuilder, ValidS3Url};

let url = ValidS3Url::parse("https://example.s3.amazonaws.com/test/test.json").unwrap();
let content = "{\"c\":\"d\"}\n".as_bytes().to_vec();

let headers = S3HeadersBuilder::new(&url)
  .set_access_key(&access_key)
  .set_secret_key(&secret_key)
  .set_region(&region)
  .set_method("PUT")
  .set_payload_hash_with_content(&content)
  .build();

let response = reqwest::blocking::Client::new()
  .put(url.as_url().clone())
  .headers(reqwest::header::HeaderMap::from_iter(headers.into_iter().map(
    |(k, v)| {
      (
        reqwest::header::HeaderName::from_str(k).unwrap(),
        reqwest::header::HeaderValue::from_str(&v).unwrap(),
      )
    },
  )))
  .send()
  .unwrap();
```

## List

```rust
use s3_headers_lite::{S3HeadersBuilder, ValidS3Url};

let url = ValidS3Url::parse("https://example.s3.amazonaws.com/").unwrap();

let headers = S3HeadersBuilder::new(&url)
  .set_access_key(&access_key)
  .set_secret_key(&secret_key)
  .set_region(&region)
  .set_method("GET")
  .build();

let response = reqwest::blocking::Client::new()
  .get(url.as_url().clone())
  .headers(reqwest::header::HeaderMap::from_iter(headers.into_iter().map(
    |(k, v)| {
      (
        reqwest::header::HeaderName::from_str(k).unwrap(),
        reqwest::header::HeaderValue::from_str(&v).unwrap(),
      )
    },
  )))
  .send()
  .unwrap();
```