libthai-idcard 0.2.0

A Rust library for reading Thai National ID smart cards via PC/SC
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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169

# libthai-idcard Makefile

.DEFAULT_GOAL := help

##@ Development

.PHONY: build
build: ## Build all targets (library + examples)
	cargo build --examples

.PHONY: build-release
build-release: ## Build in release mode
	cargo build --release

.PHONY: example
example: ## Run the Rust usage example (waits for card)
	cargo run --example rust_usage

.PHONY: check
check: ## Check code compiles without building (fast)
	cargo check

.PHONY: fmt
fmt: ## Format all Rust code
	cargo fmt

.PHONY: vet
vet: ## Run clippy lints
	cargo clippy -- -D warnings

.PHONY: test
test: ## Run all tests
	cargo test

##@ C FFI

.PHONY: shared
shared: ## Build the native shared library (.dylib/.so/.dll)
	cargo build --lib

.PHONY: headers
headers: ## Generate C header file (requires cbindgen)
	cbindgen --config cbindgen.toml --crate thaiidcard --output thaiidcard.h

.PHONY: install
install: build-release ## Install the shared library system-wide (Linux/macOS)
	sudo cp target/release/libthaiidcard.* /usr/local/lib/
	@-sudo cp thaiidcard.h /usr/local/include/ 2>/dev/null; true

##@ Cross-compilation

.PHONY: build-linux
build-linux: ## Build Linux .so via Docker (x86_64)
	docker build --build-arg TARGET=x86_64-unknown-linux-gnu \
		-f Dockerfile.build -t thaiidcard-builder .
	docker run --rm -v $(PWD):/build thaiidcard-builder
	@ls -lh target/x86_64-unknown-linux-gnu/release/libthaiidcard.so 2>/dev/null || true

.PHONY: build-linux-arm64
build-linux-arm64: ## Build Linux .so via Docker (ARM64)
	docker build --build-arg TARGET=aarch64-unknown-linux-gnu \
		-f Dockerfile.build -t thaiidcard-builder .
	docker run --rm -v $(PWD):/build thaiidcard-builder
	@ls -lh target/aarch64-unknown-linux-gnu/release/libthaiidcard.so 2>/dev/null || true

.PHONY: build-mac
build-mac: ## Build macOS .dylib via Docker (Apple Silicon)
	docker build --build-arg TARGET=aarch64-apple-darwin \
		-f Dockerfile.build -t thaiidcard-builder .
	docker run --rm -v $(PWD):/build thaiidcard-builder
	@ls -lh target/aarch64-apple-darwin/release/libthaiidcard.dylib 2>/dev/null || true

.PHONY: build-mac-x64
build-mac-x64: ## Build macOS .dylib via Docker (Intel)
	docker build --build-arg TARGET=x86_64-apple-darwin \
		-f Dockerfile.build -t thaiidcard-builder .
	docker run --rm -v $(PWD):/build thaiidcard-builder
	@ls -lh target/x86_64-apple-darwin/release/libthaiidcard.dylib 2>/dev/null || true

.PHONY: build-win
build-win: ## Build Windows DLL via Docker (x86_64)
	docker build --build-arg TARGET=x86_64-pc-windows-gnu \
		-f Dockerfile.build -t thaiidcard-builder .
	docker run --rm -v $(PWD):/build thaiidcard-builder
	@ls -lh target/x86_64-pc-windows-gnu/release/thaiidcard.dll 2>/dev/null || true

.PHONY: build-win-native
build-win-native: ## Build Windows DLL natively (x86_64, requires mingw-w64)
	cargo build --target x86_64-pc-windows-gnu --lib
	@echo "---"
	@ls -lh target/x86_64-pc-windows-gnu/debug/thaiidcard.dll

.PHONY: build-win-native-release
build-win-native-release: ## Build Windows DLL natively in release mode
	cargo build --target x86_64-pc-windows-gnu --lib --release
	@echo "---"
	@ls -lh target/x86_64-pc-windows-gnu/release/thaiidcard.dll

##@ C Example

.PHONY: c-example
c-example: shared ## Build and run the C usage example
	cc -o /tmp/thaiid-c-example examples/c_usage.c $(shell uname -s | grep -q Linux && echo "-ldl")
	/tmp/thaiid-c-example

.PHONY: c-example-link
c-example-link: shared ## Build C example with direct linking
	cc -o /tmp/thaiid-c-link examples/c_usage.c \
		-Ltarget/debug -lthaiidcard \
		-framework PCSC \
		-Wl,-rpath,target/debug
	/tmp/thaiid-c-link

##@ C++ Example

.PHONY: cpp-example
cpp-example: shared ## Build and run the C++ usage example
	g++ -std=c++17 -o /tmp/thaiid-cpp-example examples/cpp_usage.cpp $(shell uname -s | grep -q Linux && echo "-ldl")
	/tmp/thaiid-cpp-example

##@ Go Example

.PHONY: go-example
go-example: shared ## Run the Go usage example
	go run examples/go_usage.go

##@ Java Example

.PHONY: java-example
java-example: shared ## Run the Java usage example (requires jbang)
	jbang examples/java_usage.java

##@ Kotlin Example

.PHONY: kotlin-example
kotlin-example: shared ## Run the Kotlin usage example (requires jbang)
	jbang examples/kotlin_usage.kt

##@ JavaScript Example

.PHONY: js-example
js-example: shared ## Run the JavaScript usage example (requires koffi)
	node examples/js_usage.js

##@ Python Example

.PHONY: python-example
python-example: shared ## Run the Python usage example
	python3 examples/python_usage.py

##@ Ruby Example

.PHONY: ruby-example
ruby-example: shared ## Run the Ruby usage example
	ruby examples/ruby_usage.rb

##@ Clean

.PHONY: clean
clean: ## Remove build artifacts
	cargo clean
	rm -f thaiidcard.h

##@ Help

.PHONY: help
help: ## Display this help screen
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | \
		awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'