<p align="center">
<b>Security-first, no_std-first Rust crates for Swedish public APIs and public data.</b><br>
One reviewed crate per source, explicit resource budgets, and small auditable releases.
</p>
<div align="center">
<a href="https://crates.io/crates/sweden">Crates.io</a>
|
<a href="https://docs.rs/sweden">Docs.rs</a>
|
<a href="https://github.com/valkyoth/sweden/blob/main/docs/IMPLEMENTATION_PLAN.md">Implementation Plan</a>
|
<a href="https://github.com/valkyoth/sweden/blob/main/docs/RELEASE_PLAN.md">Release Plan</a>
|
<a href="https://github.com/valkyoth/sweden/blob/main/docs/threat-model.md">Threat Model</a>
|
<a href="https://github.com/valkyoth/sweden/blob/main/rfc/README.md">RFC Baseline</a>
|
<a href="https://github.com/valkyoth/sweden/blob/main/SECURITY.md">Security</a>
</div>
<br>
<p align="center">
<a href="https://github.com/valkyoth/sweden">
<img src="https://raw.githubusercontent.com/valkyoth/sweden/main/.github/images/sweden.webp" alt="Sweden Rust crate overview">
</a>
</p>
# Sweden
`sweden` is the facade for a security-first Rust ecosystem for lawful, typed
access to Swedish public APIs and datasets. Shared logic is dependency-free,
`no_std`, and independently publishable. Future agency crates remain `no_std`;
future networking is isolated in focused `std` crates and is never enabled by
default.
The repository is at its `0.2.0` identifier/version milestone. The maintainer
pentest and retest passed; the release candidate now awaits green GitHub
Actions and CodeQL. It contains only the two crates needed now:
`sweden-core` and the `sweden` facade. It does not make real upstream requests,
and no agency integration has been introduced.
## Install
The default facade exposes only `sweden-core`:
```toml
[dependencies]
sweden = "0.2.0"
```
Or depend directly on the foundation crate:
```toml
[dependencies]
sweden-core = "0.2.0"
```
## Current Status
| Multi-crate workspace | Available | Two independently packageable crates |
| `no_std` shared core and facade | Available | Default builds contain no `std` import |
| Third-party dependencies | None | Workspace manifests contain first-party path dependencies only |
| Unsafe Rust | Forbidden | Every first-party crate uses `#![forbid(unsafe_code)]` |
| Canonical descriptive identifiers | Available | Borrowed source/operation/schema/policy/upstream IDs reject non-canonical input |
| Reviewed source spellings | Reserved only | Closed constants remain descriptive and cannot authorize execution |
| Agency integrations | Not introduced | Source crates begin only when their implementation milestone starts |
| HTTP/TLS implementation | Not implemented | The transport crate is deferred until its contract milestone |
| Production readiness | Not ready | Production admission is reserved for `1.0.0` after audit and pentest evidence |
## Workspace
| `sweden` | `no_std` | Facade and convenience re-exports |
| `sweden-core` | `no_std` | Shared IDs, policy metadata, methods, and explicit budgets |
No empty placeholder crate is published. A crate is created and published only
when its implementation begins:
| `0.7.0` | `sweden-policy` |
| `0.9.0` | `sweden-registry` |
| `0.10.0` | `sweden-http` |
| `0.13.0` | `sweden-codec-json` |
| `0.16.0` | `sweden-codec-xml` |
| `0.19.0` | `sweden-testkit` |
| `0.20.0` | `sweden-schema` |
| `0.21.0` | `sweden-executor`, `sweden-conformance` |
| `0.22.0` | `sweden-trafikverket` |
| `0.51.0` only if a reviewed 1.0 operation requires CSV | `sweden-codec-csv` |
| After `1.0.0` | `sweden-smhi`, `sweden-scb`, `sweden-jobtech`, and `sweden-skatteverket` |
Every Rust crate introduced by this project is published to crates.io. Agency
and conformance crates use the shared core, policy, and codec crates they
require, never the root facade, registry, executor, HTTP, or another source
crate. `sweden-registry` owns generated source-specific authorization bindings;
generic execution belongs to `sweden-executor`; the facade aligns features,
wiring, and re-exports only.
## Crate Versioning And Publication
The `sweden` facade always equals the repository tag and is published for every
release. Subcrates use independent versions and are published only when their
code, bugfixes, dependency requirements, or immutable package metadata change.
Unchanged subcrates keep their last crates.io version.
At `v1.0.0`, every crate then present in the workspace converges to `1.0.0` and
is published. The exact per-crate state is tracked in
[the crate version matrix](https://github.com/valkyoth/sweden/blob/main/docs/CRATE_VERSION_MATRIX.md)
and enforced by `scripts/release_crates.py`.
## Rust Compatibility
Rust `1.97.1` is the pinned development and release toolchain. The public
crates support every stable Rust release from `1.90.0` through `1.97.1`.
| `1.90.0` | Supported MSRV | Full workspace check |
| `1.91.0`, `1.91.1` | Supported | Compatibility check |
| `1.92.0` | Supported | Compatibility check |
| `1.93.0`, `1.93.1` | Supported | Compatibility check |
| `1.94.0`, `1.94.1` | Supported | Compatibility check |
| `1.95.0` | Supported | Compatibility check |
| `1.96.0`, `1.96.1` | Supported | Compatibility check |
| `1.97.0` | Supported | Compatibility check |
| `1.97.1` | Current development release | Full checks, Clippy, tests, docs, and packaging |
The latest-stable pin and Cargo tool versions are checked by
`scripts/check_latest_tools.sh` before a release.
## Platform Direction
Pure library crates are designed from day one for Linux, Windows, macOS,
FreeBSD, NetBSD, Android, and iOS. Platform-independent code does not assume Unix paths,
sockets, clocks, or environment variables. A future Aesynx transport can be
added behind the same transport contracts without changing agency crates.
`no_std` support does not claim that TLS, DNS, or sockets are platform
independent. Applications provide those facilities through an explicit
transport implementation.
## Security
The repository starts fail-closed:
- no third-party project dependencies;
- no default networking, TLS, credentials, filesystem, clock, or telemetry;
- no arbitrary host or generic proxy surface;
- no unsafe Rust;
- explicit response budgets;
- source integrations stay `Foundation` until their policy, fixtures, tests,
upstream review, security review, and pentest gates pass;
- CodeQL uses GitHub default setup rather than an advanced workflow;
- generated and handwritten Rust files over 500 lines fail the local gate.
Report vulnerabilities privately as described in the
[security policy](https://github.com/valkyoth/sweden/blob/main/SECURITY.md).
## Development
Run the normal local gate:
```bash
scripts/checks.sh
```
Verify the locked local RFC reference baseline:
```bash
scripts/verify-rfcs.sh
python3 scripts/test-rfc-sources.py
```
Run the networked freshness and release gate only when preparing a release:
```bash
scripts/release_0_2_gate.sh
```
No tag is created when implementation finishes. Every version stops for the
maintainer's pentest. Findings, fixes, retests, and later GitHub CI fixes stay
current in the same versioned repository report. The implementation and
`AWAITING PENTEST` report are committed as the exact pentest baseline. The
pentest outcome and any remediation are committed next; tagging happens only
after the maintainer confirms GitHub is green and explicitly requests the tag.
After that requested tag exists at `HEAD`, publish only the planned crates in
dependency order:
```bash
scripts/release_crates.py --check
scripts/release_crates.py --version 0.2.0 --require-tag
```
## Documentation
- [Implementation plan](https://github.com/valkyoth/sweden/blob/main/docs/IMPLEMENTATION_PLAN.md)
- [Release plan](https://github.com/valkyoth/sweden/blob/main/docs/RELEASE_PLAN.md)
- [Crate version matrix](https://github.com/valkyoth/sweden/blob/main/docs/CRATE_VERSION_MATRIX.md)
- [Initial architecture discussion](https://github.com/valkyoth/sweden/blob/main/docs/initial-idea.md)
- [Modularity policy](https://github.com/valkyoth/sweden/blob/main/docs/modularity-policy.md)
- [Toolchain policy](https://github.com/valkyoth/sweden/blob/main/docs/toolchain-policy.md)
- [Threat model](https://github.com/valkyoth/sweden/blob/main/docs/threat-model.md)
- [Security controls](https://github.com/valkyoth/sweden/blob/main/docs/security-controls.md)
- [Locked RFC reference baseline](https://github.com/valkyoth/sweden/blob/main/rfc/README.md)
- [Supply-chain security](https://github.com/valkyoth/sweden/blob/main/docs/supply-chain-security.md)
- [Unsafe policy](https://github.com/valkyoth/sweden/blob/main/docs/unsafe-policy.md)
## License
Licensed under either the Apache License, Version 2.0 or the MIT license, at
your option.