BlueGit

timfa posprint

Add GitLab CI for tests and Windows/Linux release artifacts.

Linux builds produce .deb packages via cargo-deb for apt installation.
Windows builds produce release binaries on tagged releases.

Co-authored-by: Cursor <cursoragent@cursor.com>

timfa Tim Falken · pushed by timfa

Authored 2026-07-15 · 4 months ago

Hash
cc782a7c0f99c5f85b511547a052a4a34544c655
Parent
9034e64d
2 files changed +108 −62
.gitlab-ci.yml added +90 −0
@@ -0,0 +1,90 @@
1 # posprint — GitLab CI/CD
2 # Builds and tests on every push; publishes Windows and Linux (.deb) releases on tags.
3
4 stages:
5 - test
6 - build
7 - release
8
9 variables:
10 CARGO_TERM_COLOR: always
11 RUST_BACKTRACE: "1"
12
13 .default_rust:
14 image: rust:1.85-bookworm
15 before_script:
16 - rustc --version
17 - cargo --version
18
19 test:linux:
20 extends: .default_rust
21 stage: test
22 script:
23 - apt-get update -qq
24 - apt-get install -y -qq libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev
25 libxkbcommon-dev libssl-dev pkg-config
26 - cargo test --verbose
27
28 test:windows:
29 stage: test
30 tags:
31 - windows
32 - shell
33 before_script:
34 - rustup show
35 script:
36 - cargo test --verbose
37
38 build:linux-deb:
39 extends: .default_rust
40 stage: build
41 rules:
42 - if: $CI_COMMIT_TAG
43 before_script:
44 - apt-get update -qq
45 - apt-get install -y -qq libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev
46 libxkbcommon-dev libssl-dev pkg-config dpkg-dev
47 - cargo install cargo-deb --locked
48 script:
49 - cargo deb
50 - mkdir -p dist
51 - cp target/debian/*.deb dist/
52 artifacts:
53 name: "posprint-linux-$CI_COMMIT_TAG"
54 paths:
55 - dist/*.deb
56 expire_in: 1 year
57
58 build:windows:
59 stage: build
60 tags:
61 - windows
62 - shell
63 rules:
64 - if: $CI_COMMIT_TAG
65 script:
66 - cargo build --release
67 - mkdir dist
68 - cp target/release/posprint.exe dist/
69 artifacts:
70 name: "posprint-windows-$CI_COMMIT_TAG"
71 paths:
72 - dist/posprint.exe
73 expire_in: 1 year
74
75 release:gitlab:
76 stage: release
77 image: registry.gitlab.com/gitlab-org/release-cli:latest
78 rules:
79 - if: $CI_COMMIT_TAG
80 needs:
81 - build:linux-deb
82 - build:windows
83 script:
84 - |
85 release-cli create \
86 --name "posprint $CI_COMMIT_TAG" \
87 --tag-name "$CI_COMMIT_TAG" \
88 --description "Cross-platform POS print designer release $CI_COMMIT_TAG" \
89 --assets-link "{\"name\":\"Linux .deb (amd64)\",\"url\":\"${CI_PROJECT_URL}/-/jobs/artifacts/${CI_COMMIT_TAG}/raw/dist/posprint_${CI_COMMIT_TAG#v}_amd64.deb?job=build%3Alinux-deb\",\"link_type\":\"package\"}" \
90 --assets-link "{\"name\":\"Windows .exe\",\"url\":\"${CI_PROJECT_URL}/-/jobs/artifacts/${CI_COMMIT_TAG}/raw/dist/posprint.exe?job=build%3Awindows\",\"link_type\":\"package\"}"
@@ -0,0 +1,90 @@
1# posprint — GitLab CI/CD
2# Builds and tests on every push; publishes Windows and Linux (.deb) releases on tags.
3
4stages:
5 - test
6 - build
7 - release
8
9variables:
10 CARGO_TERM_COLOR: always
11 RUST_BACKTRACE: "1"
12
13.default_rust:
14 image: rust:1.85-bookworm
15 before_script:
16 - rustc --version
17 - cargo --version
18
19test:linux:
20 extends: .default_rust
21 stage: test
22 script:
23 - apt-get update -qq
24 - apt-get install -y -qq libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev
25 libxkbcommon-dev libssl-dev pkg-config
26 - cargo test --verbose
27
28test:windows:
29 stage: test
30 tags:
31 - windows
32 - shell
33 before_script:
34 - rustup show
35 script:
36 - cargo test --verbose
37
38build:linux-deb:
39 extends: .default_rust
40 stage: build
41 rules:
42 - if: $CI_COMMIT_TAG
43 before_script:
44 - apt-get update -qq
45 - apt-get install -y -qq libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev
46 libxkbcommon-dev libssl-dev pkg-config dpkg-dev
47 - cargo install cargo-deb --locked
48 script:
49 - cargo deb
50 - mkdir -p dist
51 - cp target/debian/*.deb dist/
52 artifacts:
53 name: "posprint-linux-$CI_COMMIT_TAG"
54 paths:
55 - dist/*.deb
56 expire_in: 1 year
57
58build:windows:
59 stage: build
60 tags:
61 - windows
62 - shell
63 rules:
64 - if: $CI_COMMIT_TAG
65 script:
66 - cargo build --release
67 - mkdir dist
68 - cp target/release/posprint.exe dist/
69 artifacts:
70 name: "posprint-windows-$CI_COMMIT_TAG"
71 paths:
72 - dist/posprint.exe
73 expire_in: 1 year
74
75release:gitlab:
76 stage: release
77 image: registry.gitlab.com/gitlab-org/release-cli:latest
78 rules:
79 - if: $CI_COMMIT_TAG
80 needs:
81 - build:linux-deb
82 - build:windows
83 script:
84 - |
85 release-cli create \
86 --name "posprint $CI_COMMIT_TAG" \
87 --tag-name "$CI_COMMIT_TAG" \
88 --description "Cross-platform POS print designer release $CI_COMMIT_TAG" \
89 --assets-link "{\"name\":\"Linux .deb (amd64)\",\"url\":\"${CI_PROJECT_URL}/-/jobs/artifacts/${CI_COMMIT_TAG}/raw/dist/posprint_${CI_COMMIT_TAG#v}_amd64.deb?job=build%3Alinux-deb\",\"link_type\":\"package\"}" \
90 --assets-link "{\"name\":\"Windows .exe\",\"url\":\"${CI_PROJECT_URL}/-/jobs/artifacts/${CI_COMMIT_TAG}/raw/dist/posprint.exe?job=build%3Awindows\",\"link_type\":\"package\"}"
docs/ARCHITECTURE.md +18 −62
@@ -2,75 +2,31 @@
2 2
3 3 ## Overview
4 4
5 posprint is a desktop application with a **web-based UI** (Tauri) and a **Rust backend** that owns parsing, rendering, file I/O, and printer communication.
5 posprint is a **single Rust binary** using **egui** (eframe). No separate frontend language.
6 6
7 7 ```
8 ┌──────────────────────────────────────────────────────────────────┐
9 │ Application │
10 ├────────────────────────────┬─────────────────────────────────────┤
11 │ UI Layer │ Core Layer (Rust) │
12 │ (TypeScript / Tauri WebView) │
13 │ │ │
14 │ DocumentEditor ───────────┼──► parse_dsl() → Document AST │
15 │ PreviewPane ◄─────────────┼─── render_preview(ast, width) │
16 │ SettingsPanel │ │
17 │ ParameterDialog │ │
18 │ PrinterPicker │ │
19 │ │ │
20 │ File menu ────────────────┼──► load_pos() / save_pos() │
21 │ Print button ─────────────┼──► list_printers() │
22 │ │ print_document(ast, params, dev) │
23 └────────────────────────────┴─────────────────────────────────────┘
24 │
25 ┌─────────────────┼─────────────────┐
26 ▼ ▼ ▼
27 Preview bitmap ESC/POS bytes .pos JSON file
8 ┌─────────────────────────────────────────┐
9 │ posprint (Rust + egui) │
10 │ - Editor / Preview / Help tabs │
11 │ - DSL parse → AST │
12 │ - Preview layout + ESC/POS encode │
13 │ - USB-serial printer discovery/print │
14 │ - `.pos` serde │
15 └─────────────────────────────────────────┘
28 16 ```
29 17
30 ---
31
32 ## Modules (Rust crate layout)
33
34 ```
35 posprint-core/ # Library — no UI, unit-testable
36 ├── dsl/
37 │ ├── lexer.rs # Tokenize source
38 │ ├── parser.rs # Build AST
39 │ └── ast.rs # Document, Block, Inline, Directive nodes
40 ├── render/
41 │ ├── preview.rs # Layout for UI (lines, images, barcode placeholders)
42 │ └── escpos.rs # AST → ESC/POS byte buffer
43 ├── params/
44 │ ├── collect.rs # Find unique ${Name} tokens
45 │ └── substitute.rs # Apply user values before render/print
46 ├── io/
47 │ └── pos_file.rs # Serde types, load/save
48 └── print/
49 ├── discover.rs # Enumerate serial / USB / BT devices
50 ├── transport.rs # Trait: write(bytes), read optional status
51 └── pipeline.rs # substitute → escpos → transport
52
53 posprint-app/ # Tauri binary
54 ├── commands/ # #[tauri::command] wrappers
55 ├── state.rs # App state (last params, recent files)
56 └── main.rs
57 ```
58
59 Frontend (`src/`):
18 ### Crate layout
60 19
61 20 ```
62 21 src/
63 ├── components/
64 │ ├── Editor.tsx
65 │ ├── Preview.tsx
66 │ ├── Toolbar.tsx
67 │ ├── ParameterModal.tsx
68 │ └── PrinterDialog.tsx
69 ├── hooks/
70 │ ├── useDocument.ts
71 │ └── usePreview.ts
72 └── lib/
73 └── tauri.ts # Typed invoke wrappers
22 ├── main.rs, app.rs # egui application
23 ├── lib.rs
24 ├── dsl/ # Parser and AST
25 ├── params.rs # Parameter collect/substitute
26 ├── escpos.rs # ESC/POS byte encoder
27 ├── preview.rs # Preview model
28 ├── io/ # .pos file format
29 └── print/ # USB-serial discovery and I/O
74 30 ```
75 31
76 32 ---
@@ -2,75 +2,31 @@
2
2
3## Overview
3## Overview
4
4
5posprint is a desktop application with a **web-based UI** (Tauri) and a **Rust backend** that owns parsing, rendering, file I/O, and printer communication.
5posprint is a **single Rust binary** using **egui** (eframe). No separate frontend language.
6
6
7```
7```
8┌──────────────────────────────────────────────────────────────────┐
8┌─────────────────────────────────────────┐
9│ Application │
9│ posprint (Rust + egui) │
10├────────────────────────────┬─────────────────────────────────────┤
10│ - Editor / Preview / Help tabs │
11│ UI Layer │ Core Layer (Rust) │
11│ - DSL parse → AST │
12│ (TypeScript / Tauri WebView) │
12│ - Preview layout + ESC/POS encode │
13│ │ │
13│ - USB-serial printer discovery/print │
14│ DocumentEditor ───────────┼──► parse_dsl() → Document AST │
14│ - `.pos` serde │
15│ PreviewPane ◄─────────────┼─── render_preview(ast, width) │
15└─────────────────────────────────────────┘
16│ SettingsPanel │ │
17│ ParameterDialog │ │
18│ PrinterPicker │ │
19│ │ │
20│ File menu ────────────────┼──► load_pos() / save_pos() │
21│ Print button ─────────────┼──► list_printers() │
22│ │ print_document(ast, params, dev) │
23└────────────────────────────┴─────────────────────────────────────┘
24 │
25 ┌─────────────────┼─────────────────┐
26 ▼ ▼ ▼
27 Preview bitmap ESC/POS bytes .pos JSON file
28```
16```
29
17
30---
18### Crate layout
31
32## Modules (Rust crate layout)
33
34```
35posprint-core/ # Library — no UI, unit-testable
36├── dsl/
37│ ├── lexer.rs # Tokenize source
38│ ├── parser.rs # Build AST
39│ └── ast.rs # Document, Block, Inline, Directive nodes
40├── render/
41│ ├── preview.rs # Layout for UI (lines, images, barcode placeholders)
42│ └── escpos.rs # AST → ESC/POS byte buffer
43├── params/
44│ ├── collect.rs # Find unique ${Name} tokens
45│ └── substitute.rs # Apply user values before render/print
46├── io/
47│ └── pos_file.rs # Serde types, load/save
48└── print/
49 ├── discover.rs # Enumerate serial / USB / BT devices
50 ├── transport.rs # Trait: write(bytes), read optional status
51 └── pipeline.rs # substitute → escpos → transport
52
53posprint-app/ # Tauri binary
54├── commands/ # #[tauri::command] wrappers
55├── state.rs # App state (last params, recent files)
56└── main.rs
57```
58
59Frontend (`src/`):
60
19
61```
20```
62src/
21src/
63├── components/
22├── main.rs, app.rs # egui application
64│ ├── Editor.tsx
23├── lib.rs
65│ ├── Preview.tsx
24├── dsl/ # Parser and AST
66│ ├── Toolbar.tsx
25├── params.rs # Parameter collect/substitute
67│ ├── ParameterModal.tsx
26├── escpos.rs # ESC/POS byte encoder
68│ └── PrinterDialog.tsx
27├── preview.rs # Preview model
69├── hooks/
28├── io/ # .pos file format
70│ ├── useDocument.ts
29└── print/ # USB-serial discovery and I/O
71│ └── usePreview.ts
72└── lib/
73 └── tauri.ts # Typed invoke wrappers
74```
30```
75
31
76---
32---