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>
@@ -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
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\"}"
@@ -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
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
┌──────────────────────────────────────────────────────────────────┐
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
```
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/`):
60
19
61
```
20
```
62
src/
21
src/
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
---