hasp-backend-env 0.2.0-alpha

env:// backend for hasp — reads secrets from environment variables.
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

# hasp-backend-env

`env://` backend for the `hasp` secrets library.

## URL Grammar

```
env://VAR_NAME
```

- `VAR_NAME` (host): The name of the environment variable. Required.
- No path, query, or fragment components are allowed.

## Supported Operations

| Operation | Support | Notes |
|-----------|---------|-------|
| `get` | ✅ | Returns the value of the environment variable |
| `exists` | ✅ | Returns true if the variable is set |
| `put` | ❌ | Unsupported — child processes cannot set parent environment variables |
| `list` | ❌ | Unsupported |
| `delete` | ❌ | Unsupported |

## Platform-Specific Failure Modes

- **Variable not set**: Returns `Error::NotFound`
- **Variable not valid Unicode**: Returns `Error::Backend { kind: Permanent }`