Capstone: dự án xuất xưởng

cấu trúc thư mục

du-an-xuat-xuong/
├── include/task.h            # interface cong khai (Model + Store opaque)
├── src/store.c               # implementation (mang dong) + storage
├── src/main.c                # CLI
├── tests/test_store.c        # unit test (assert) -> chay bang CTest
├── CMakeLists.txt            # build + bat test
├── .clang-format             # phong cach thong nhat
├── .clang-tidy               # phan tich tinh
└── .github/workflows/ci.yml  # chay het cac cong moi push

CMakeLists.txt

cmake_minimum_required(VERSION 3.16)
project(todo C)

set(CMAKE_C_STANDARD 11)
set(CMAKE_C_STANDARD_REQUIRED ON)
set(CMAKE_EXPORT_COMPILE_COMMANDS ON)  # cho clang-tidy doc
add_compile_options(-Wall -Wextra)

# Loi tai dung: module store. include/ la PUBLIC.
add_library(todocore src/store.c)
target_include_directories(todocore PUBLIC include)

add_executable(todo src/main.c)
target_link_libraries(todo PRIVATE todocore)

enable_testing()                       # bat ctest
add_executable(test_store tests/test_store.c)
target_link_libraries(test_store PRIVATE todocore)
add_test(NAME store COMMAND test_store)

tests/test_store.c - unit test bằng assert

#include "task.h"
#include <assert.h>
#include <stdio.h>

int main(void) {
    TaskStore *s = store_create();
    assert(s != NULL);
    assert(store_count(s) == 0);

    int id1 = store_add(s, "viec A");
    assert(store_count(s) == 1);
    assert(store_done(s, id1) == true);
    assert(store_done(s, 999) == false);   /* id khong ton tai */
    assert(store_at(s, 9) == NULL);        /* ngoai pham vi    */

    store_destroy(s);
    printf("OK: tat ca assert deu dung\n");
    return 0;
}

chạy các cổng trên máy

# Cong 1 - dinh dang
clang-format --dry-run --Werror $(git ls-files '*.c' '*.h')

# Cong 2 - build voi canh bao = loi
cmake -S . -B build -DCMAKE_C_FLAGS="-Werror" && cmake --build build

# Cong 3 - phan tich tinh
clang-tidy -p build $(git ls-files 'src/*.c')

# Cong 4 - test
ctest --test-dir build --output-on-failure

# Cong 5 - test duoi ASan + UBSan
cmake -S . -B build-san -DCMAKE_C_FLAGS="-fsanitize=address,undefined -g"
cmake --build build-san && ctest --test-dir build-san --output-on-failure

Test project .../build
    Start 1: store
1/1 Test #1: store ............   Passed    0.01 sec
100% tests passed, 0 tests failed out of 1

.github/workflows/ci.yml (rút gọn)

name: CI
on: [push, pull_request]
jobs:
  quality:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - run: sudo apt-get update && sudo apt-get install -y cmake clang-format clang-tidy
      - run: clang-format --dry-run --Werror $(git ls-files '*.c' '*.h')
      - run: cmake -S . -B build -DCMAKE_C_FLAGS="-Werror -fsanitize=address,undefined -g" -DCMAKE_EXPORT_COMPILE_COMMANDS=ON
      - run: cmake --build build
      - run: clang-tidy -p build $(git ls-files 'src/*.c')
      - run: ctest --test-dir build --output-on-failure