BREP_app 0.11.0

The BREP CAD application: an eframe (egui + wgpu) host that draws the brep-render 3D engine into an egui frame — native + wasm from one codebase.
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

//! The PLM client: where the server is, how a request reaches it, and — in
//! `client` — sign-in, the refusals, the change feed and the version check.
//! Nothing here runs unless a server is configured; the file-based app never
//! constructs any of it.

pub mod backend;
pub mod bom;
pub mod client;
pub mod connection;
pub mod config;
pub mod transport;
// The pure halves of S5 (uses lists) and S13 (adoption): no transport, no
// store writes — the publisher and the importer drive them.
pub mod adoption;
pub mod kicad;
pub mod uses;
/// Embedded copies of PLM parts as a cache of their revisions (refreshed on open).
pub mod cached_copies;
/// Embedded copies pinned to a superseded or obsolete PLM revision.
pub mod superseded;
/// The bake worker (S10): open a queued member, build it, report.
pub mod bake;
/// Families and templates on a PLM store (S9): Generate, members, spin-out.
pub mod family;
/// Parts with no document of their own become items (an assembly's Save).
pub mod promote;
/// Revision thumbnails (P9): the picture a save makes and uploads.
pub mod thumbnail;
/// The instructions player's data a save of an instructions revision makes
/// and uploads.
pub mod player_data;
pub mod thumbnail_view;
pub mod tool_pictures;
#[cfg(not(target_arch = "wasm32"))]
pub mod native;

/// One HTTP exchange with the PLM, whatever carries it. `path` is relative to
/// the server's base URL (`"/api/store/index"`); the client, not the
/// transport, adds the credential headers.
pub struct PlmRequest {
    pub method: &'static str,
    pub path: String,
    pub headers: Vec<(String, String)>,
    pub body: Vec<u8>,
}

/// The server's answer, whatever its status.
pub struct PlmResponse {
    pub status: u16,
    pub headers: Vec<(String, String)>,
    pub body: Vec<u8>,
}

/// Deliberately not `Send`, like the store seam's `BackendFuture`: every host
/// is single-threaded (the browser main thread; the native frame loop).
pub type PlmFuture<T> = std::pin::Pin<Box<dyn std::future::Future<Output = Result<T, String>>>>;

/// Carries a [`PlmRequest`] to the server. `Err` means the request never got
/// an answer (network, DNS, refused connection). Every HTTP status — 204, 4xx
/// and 5xx included — is `Ok`; the client maps them.
pub trait PlmTransport {
    fn send(&self, request: PlmRequest) -> PlmFuture<PlmResponse>;
}

/// Lowercase hex SHA-256 of `bytes`: the server's `content_hash`
/// (`brep_plm::auth::content_hash`) of a document written with exactly these
/// bytes. The app's one copy (I13).
pub fn content_hash(bytes: &[u8]) -> String {
    use sha2::{Digest, Sha256};
    Sha256::digest(bytes).iter().map(|byte| format!("{byte:02x}")).collect()
}

pub mod identity;