diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index d92088c..6f66a72 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -25,10 +25,10 @@ jobs:
sudo apt-get install -y gcc g++ clang valgrind
- name: Build nob
- run: cc -o nob nob.c
+ run: cc -o build/nob build/nob.c
- name: Run build and tests
- run: ./nob
+ run: ./build/nob
env:
SNAKEPATH_SANITIZE: "1"
@@ -48,7 +48,7 @@ jobs:
uses: ilammy/msvc-dev-cmd@v1
- name: Build nob
- run: cl.exe /Fe:nob.exe nob.c
+ run: cl.exe /Fe:build\nob.exe build\nob.c
- name: Run build and tests
- run: .\nob.exe
+ run: .\build\nob.exe
diff --git a/.gitignore b/.gitignore
index 5ea2a79..3e40bd7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,5 +1,5 @@
-nob
-nob.old
+build/nob
+build/nob.old
*.o
*.dSYM/
api_demo
@@ -9,17 +9,17 @@ __pycache__/
*.pyc
# Tests
-tests/python_harness/cpython_tests/
-tests/python_harness/libsnakepath.so
-tests/python_harness/snakepath.dll
-tests/test_gcc
-tests/test_clang
-tests/test_gcc_san
-tests/test_clang_san
-tests/test_gpp
-tests/test_clangpp
-tests/test_fluent_*
-tests/test_msvc*
+build/python_harness/cpython_tests/
+build/python_harness/libsnakepath.so
+build/python_harness/snakepath.dll
+build/test_gcc
+build/test_clang
+build/test_gcc_san
+build/test_clang_san
+build/test_gpp
+build/test_clangpp
+build/test_fluent_*
+build/test_msvc*
# Stale test symlink artifacts
test_fluent_sym_*.tmp
diff --git a/CLAUDE.md b/CLAUDE.md
index 6c6a0ae..a3cc42c 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -17,14 +17,14 @@ Bad: shorten names, define convenience macros, remove whitespace/braces.
**Run all three before committing:**
```bash
-gcc -std=c99 -I. -Wall -Wextra -Werror -o test_snakepath tests/test.c && ./test_snakepath
-g++ -std=c++11 -x c++ -I. -Wall -Wextra -Werror -Wmissing-field-initializers -o test_cpp tests/test.c && ./test_cpp
-cd tests/python_harness && gcc -shared -fPIC -o snakepath/libsnakepath.so snakepath_lib.c -I../.. && python run_cpython_tests.py
+gcc -std=c99 -I. -Wall -Wextra -Werror -o test_snakepath build/test.c && ./test_snakepath
+g++ -std=c++11 -x c++ -I. -Wall -Wextra -Werror -Wmissing-field-initializers -o test_cpp build/test.c && ./test_cpp
+cd build/python_harness && gcc -shared -fPIC -o snakepath/libsnakepath.so snakepath_lib.c -I../.. && python run_cpython_tests.py
```
**g++ pitfalls:** `{0}` → `memset`, `void*` casts → `SP_PRIV_CAST`, C casts → `SP_PRIV_CAST`
-**Termux:** `cc -DSNAKEPATH_QUIET -o nob nob.c && SNAKEPATH_SKIP_GCC=1 SNAKEPATH_NO_NRVO=1 ./nob`
+**Termux:** `cc -DSNAKEPATH_QUIET -o build/nob build/nob.c && SNAKEPATH_SKIP_GCC=1 SNAKEPATH_NO_NRVO=1 ./build/nob`
Termux `/tmp` symlink failures are expected locally (Python `test_resolve_nonexist_relative_issue38671` and fluent `hardlink_to` test). CI is authoritative.
## EXPECTED_FAILURES
@@ -50,7 +50,7 @@ Dict mapping error substrings → `(class_name, test_name)` tuples. Runner verif
- Use `_decode(..., errors="surrogatepass")` and copy `SpPath` structs in `_from_sp` to preserve embedded nulls.
- Windows builds should not compile `sp_owner_wrap`/`sp_group_wrap`; gate the wrappers in C.
- `sp_with_segments` now takes a `parts_count` (no NULL-terminated arrays); use `SP_ARRAY_LEN`.
-- New functionality goes in `snakepath.h` first; then mirror wrappers in `tests/python_harness/snakepath_lib.c` and `tests/python_harness/snakepath/__init__.py`, plus tests in `tests/test.c` (and `tests/test_fluent_api.c` for fluent parity).
+- New functionality goes in `snakepath.h` first; then mirror wrappers in `build/python_harness/snakepath_lib.c` and `build/python_harness/snakepath/__init__.py`, plus tests in `build/test.c` (and `build/test_fluent_api.c` for fluent parity).
- When API examples change, update `api_demo.c` first, then sync `README.md` and `index.html`, and record any new learnings here.
-- Public API call depth is now enforced by `tests/test_call_depth.py` (limit = 3 public frames); keep wrapper chains flat and favor `sp_priv_*` delegation.
+- Public API call depth is now enforced by `build/test_call_depth.py` (limit = 3 public frames); keep wrapper chains flat and favor `sp_priv_*` delegation.
- For `"."` behavior, keep `SpPath` canonical as empty (`len == 0`) and let string conversion render `"."`; storing literal `"."` breaks equality/parents semantics.
diff --git a/README.md b/README.md
index 395005d..03661b5 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,5 @@
Snakepath:
-C99 STB-style header-only port of [Python's pathlib](https://docs.python.org/3/library/pathlib.html). Passes [CPython 3.12's own test suite](tests/python_harness/).
+C99 STB-style header-only port of [Python's pathlib](https://docs.python.org/3/library/pathlib.html). Passes [CPython 3.12's own test suite](build/python_harness/).
POSIX + Windows. No malloc (OS functions like `opendir`/`stat` may allocate internally).
Vibe-coded with Claude Code + Cursor.
@@ -31,7 +31,7 @@ rm -f demo snakepath.h
## Build & Test
```bash
-cc -o nob nob.c && ./nob
+cc -o build/nob build/nob.c && ./build/nob
```
diff --git a/nob.c b/build/nob.c
similarity index 78%
rename from nob.c
rename to build/nob.c
index d304f1d..9a56cce 100644
--- a/nob.c
+++ b/build/nob.c
@@ -1,10 +1,10 @@
/* nob.c - Build script for snakepath using nob.h
- * Usage: cc -o nob nob.c && ./nob
+ * Usage: cc -o build/nob build/nob.c && ./build/nob
*
* Builds are parallelized across available CPU cores.
*
* For quiet mode (no command echo):
- * cc -DSNAKEPATH_QUIET -o nob nob.c && ./nob
+ * cc -DSNAKEPATH_QUIET -o build/nob build/nob.c && ./build/nob
*/
#ifdef SNAKEPATH_QUIET
@@ -123,14 +123,14 @@ static bool build_source_async(BuildConfig cfg, const char *source, const char *
#endif
}
- /* Include root directory for header files */
+ /* Include project root for snakepath.h */
#ifdef _WIN32
if (cfg.compiler == COMPILER_MSVC || cfg.compiler == COMPILER_MSVC_CPP) {
- nob_cmd_append(&cmd, "/I.");
+ nob_cmd_append(&cmd, "/I..");
} else
#endif
{
- nob_cmd_append(&cmd, "-I.");
+ nob_cmd_append(&cmd, "-I..");
}
append_warnings(&cmd, cfg.compiler);
@@ -199,18 +199,18 @@ static bool run_valgrind(const char *exe) {
static const char *all_artifacts[] = {
#ifdef _WIN32
- "tests/test_msvc.exe", "tests/test_msvc_cpp.exe", "tests/test_fluent_msvc.exe", "demo.exe",
- /* PDB and obj files from MSVC (now in tests/ directory to avoid conflicts) */
- "tests/test_msvc.pdb", "tests/test_msvc_cpp.pdb", "tests/test_fluent_msvc.pdb", "demo.pdb",
- "tests/test_msvc.obj", "tests/test_msvc_cpp.obj", "tests/test_fluent_msvc.obj", "api_demo.obj",
+ "test_msvc.exe", "test_msvc_cpp.exe", "test_fluent_msvc.exe", "../demo.exe",
+ /* PDB and obj files from MSVC */
+ "test_msvc.pdb", "test_msvc_cpp.pdb", "test_fluent_msvc.pdb", "../demo.pdb",
+ "test_msvc.obj", "test_msvc_cpp.obj", "test_fluent_msvc.obj", "../api_demo.obj",
/* Legacy obj files in root (clean these up too) */
- "test.obj", "test_fluent_api.obj",
- "tests/python_harness/snakepath.dll",
+ "../test.obj", "../test_fluent_api.obj",
+ "python_harness/snakepath.dll",
#else
- "tests/test_gcc", "tests/test_clang", "tests/test_gcc_san", "tests/test_clang_san",
- "tests/test_gpp", "tests/test_clangpp", "tests/test_fluent_gcc", "tests/test_fluent_clang",
- "api_demo",
- "tests/python_harness/libsnakepath.so",
+ "test_gcc", "test_clang", "test_gcc_san", "test_clang_san",
+ "test_gpp", "test_clangpp", "test_fluent_gcc", "test_fluent_clang",
+ "../api_demo",
+ "python_harness/libsnakepath.so",
#endif
NULL
};
@@ -222,23 +222,23 @@ static bool build_python_lib(Compiler compiler, Nob_Procs *procs) {
#ifdef _WIN32
if (compiler == COMPILER_MSVC) {
nob_cmd_append(&cmd, "cl.exe", "/std:c11", "/LD", "/O2");
- nob_cmd_append(&cmd, "/W4", "/I.");
- nob_cmd_append(&cmd, "/Fe:tests/python_harness/snakepath.dll");
- nob_cmd_append(&cmd, "tests/python_harness/snakepath_lib.c");
+ nob_cmd_append(&cmd, "/W4", "/I..");
+ nob_cmd_append(&cmd, "/Fe:python_harness/snakepath.dll");
+ nob_cmd_append(&cmd, "python_harness/snakepath_lib.c");
} else {
nob_log(NOB_WARNING, "Python lib: Using clang on Windows");
- nob_cmd_append(&cmd, "clang", "-shared", "-fPIC", "-O2", "-I.");
+ nob_cmd_append(&cmd, "clang", "-shared", "-fPIC", "-O2", "-I..");
nob_cmd_append(&cmd, "-fvisibility=hidden");
- nob_cmd_append(&cmd, "-o", "tests/python_harness/snakepath.dll");
- nob_cmd_append(&cmd, "tests/python_harness/snakepath_lib.c");
+ nob_cmd_append(&cmd, "-o", "python_harness/snakepath.dll");
+ nob_cmd_append(&cmd, "python_harness/snakepath_lib.c");
}
#else
const char *cc = (compiler == COMPILER_CLANG || compiler == COMPILER_CLANGPP) ? "clang" : "gcc";
- nob_cmd_append(&cmd, cc, "-shared", "-fPIC", "-O2", "-I.");
+ nob_cmd_append(&cmd, cc, "-shared", "-fPIC", "-O2", "-I..");
nob_cmd_append(&cmd, "-Wall", "-Wextra");
nob_cmd_append(&cmd, "-fvisibility=hidden");
- nob_cmd_append(&cmd, "-o", "tests/python_harness/libsnakepath.so");
- nob_cmd_append(&cmd, "tests/python_harness/snakepath_lib.c");
+ nob_cmd_append(&cmd, "-o", "python_harness/libsnakepath.so");
+ nob_cmd_append(&cmd, "python_harness/snakepath_lib.c");
#endif
bool result;
@@ -270,14 +270,14 @@ static const char *find_python(void) {
static bool run_call_depth_tests(void) {
Nob_Cmd cmd = {0};
const char *python = find_python();
- nob_cmd_append(&cmd, python, "tests/test_call_depth.py", "snakepath.h", "3");
+ nob_cmd_append(&cmd, python, "test_call_depth.py", "../snakepath.h", "3");
return nob_cmd_run(&cmd);
}
static bool run_python_tests(void) {
Nob_Cmd cmd = {0};
const char *python = find_python();
- nob_cmd_append(&cmd, python, "tests/python_harness/run_cpython_tests.py");
+ nob_cmd_append(&cmd, python, "python_harness/run_cpython_tests.py");
return nob_cmd_run(&cmd);
}
@@ -297,6 +297,9 @@ static bool clean_artifacts(void) {
int main(int argc, char **argv) {
NOB_GO_REBUILD_URSELF(argc, argv);
+ /* nob.c lives in build/ alongside test sources — chdir so paths are simple */
+ nob_set_current_dir("build");
+
/* Check VERBOSE env var - default true, set to 0 to suppress INFO logs */
const char *verbose_env = getenv("VERBOSE");
if (verbose_env && (strcmp(verbose_env, "0") == 0 || strcmp(verbose_env, "false") == 0)) {
@@ -344,39 +347,39 @@ int main(int argc, char **argv) {
#ifdef _WIN32
BuildConfig test_configs[] = {
- {COMPILER_MSVC, false, "MSVC (C)", "tests/test_msvc.exe"},
- {COMPILER_MSVC_CPP, false, "MSVC (C++)", "tests/test_msvc_cpp.exe"},
+ {COMPILER_MSVC, false, "MSVC (C)", "test_msvc.exe"},
+ {COMPILER_MSVC_CPP, false, "MSVC (C++)", "test_msvc_cpp.exe"},
};
size_t test_count = sizeof(test_configs) / sizeof(test_configs[0]);
BuildConfig fluent_configs[] = {
- {COMPILER_MSVC, false, "MSVC Fluent", "tests/test_fluent_msvc.exe"},
+ {COMPILER_MSVC, false, "MSVC Fluent", "test_fluent_msvc.exe"},
};
- BuildConfig demo_config = {COMPILER_MSVC, false, "Demo", "api_demo.exe"};
- const char *demo_output = "api_demo.exe";
+ BuildConfig demo_config = {COMPILER_MSVC, false, "Demo", "../api_demo.exe"};
+ const char *demo_output = "../api_demo.exe";
#else
bool use_sanitizers = getenv("SNAKEPATH_SANITIZE") != NULL;
bool skip_gcc = getenv("SNAKEPATH_SKIP_GCC") != NULL; /* For Termux where gcc is clang */
/* Full configs with sanitizers */
BuildConfig test_configs_full[] = {
- {COMPILER_GCC, false, "GCC", "./tests/test_gcc"},
- {COMPILER_CLANG, false, "Clang", "./tests/test_clang"},
- {COMPILER_GCC, true, "GCC + sanitizers", "./tests/test_gcc_san"},
- {COMPILER_CLANG, true, "Clang + sanitizers", "./tests/test_clang_san"},
- {COMPILER_GPP, false, "G++ (C++)", "./tests/test_gpp"},
- {COMPILER_CLANGPP, false, "Clang++ (C++)", "./tests/test_clangpp"},
+ {COMPILER_GCC, false, "GCC", "./test_gcc"},
+ {COMPILER_CLANG, false, "Clang", "./test_clang"},
+ {COMPILER_GCC, true, "GCC + sanitizers", "./test_gcc_san"},
+ {COMPILER_CLANG, true, "Clang + sanitizers", "./test_clang_san"},
+ {COMPILER_GPP, false, "G++ (C++)", "./test_gpp"},
+ {COMPILER_CLANGPP, false, "Clang++ (C++)", "./test_clangpp"},
};
/* No sanitizers */
BuildConfig test_configs_no_san[] = {
- {COMPILER_GCC, false, "GCC", "./tests/test_gcc"},
- {COMPILER_CLANG, false, "Clang", "./tests/test_clang"},
- {COMPILER_GPP, false, "G++ (C++)", "./tests/test_gpp"},
- {COMPILER_CLANGPP, false, "Clang++ (C++)", "./tests/test_clangpp"},
+ {COMPILER_GCC, false, "GCC", "./test_gcc"},
+ {COMPILER_CLANG, false, "Clang", "./test_clang"},
+ {COMPILER_GPP, false, "G++ (C++)", "./test_gpp"},
+ {COMPILER_CLANGPP, false, "Clang++ (C++)", "./test_clangpp"},
};
/* Clang-only (for Termux where gcc is clang) */
BuildConfig test_configs_clang_only[] = {
- {COMPILER_CLANG, false, "Clang", "./tests/test_clang"},
- {COMPILER_CLANGPP, false, "Clang++ (C++)", "./tests/test_clangpp"},
+ {COMPILER_CLANG, false, "Clang", "./test_clang"},
+ {COMPILER_CLANGPP, false, "Clang++ (C++)", "./test_clangpp"},
};
BuildConfig *test_configs;
@@ -395,17 +398,17 @@ int main(int argc, char **argv) {
}
BuildConfig fluent_configs_full[] = {
- {COMPILER_GCC, false, "GCC Fluent", "./tests/test_fluent_gcc"},
- {COMPILER_CLANG, false, "Clang Fluent", "./tests/test_fluent_clang"},
+ {COMPILER_GCC, false, "GCC Fluent", "./test_fluent_gcc"},
+ {COMPILER_CLANG, false, "Clang Fluent", "./test_fluent_clang"},
};
BuildConfig fluent_configs_clang[] = {
- {COMPILER_CLANG, false, "Clang Fluent", "./tests/test_fluent_clang"},
+ {COMPILER_CLANG, false, "Clang Fluent", "./test_fluent_clang"},
};
BuildConfig *fluent_configs = skip_gcc ? fluent_configs_clang : fluent_configs_full;
BuildConfig demo_config = skip_gcc
- ? (BuildConfig){COMPILER_CLANG, false, "Demo", "./api_demo"}
- : (BuildConfig){COMPILER_GCC, false, "Demo", "./api_demo"};
- const char *demo_output = "./api_demo";
+ ? (BuildConfig){COMPILER_CLANG, false, "Demo", "../api_demo"}
+ : (BuildConfig){COMPILER_GCC, false, "Demo", "../api_demo"};
+ const char *demo_output = "../api_demo";
#endif
#ifdef _WIN32
@@ -419,16 +422,16 @@ int main(int argc, char **argv) {
for (size_t i = 0; i < test_count; i++) {
LOG_INFO( " Starting build: %s", test_configs[i].name);
- build_source_async(test_configs[i], "tests/test.c", NULL, &procs);
+ build_source_async(test_configs[i], "test.c", NULL, &procs);
}
for (size_t i = 0; i < fluent_count; i++) {
LOG_INFO( " Starting build: %s", fluent_configs[i].name);
- build_source_async(fluent_configs[i], "tests/test_fluent_api.c", NULL, &procs);
+ build_source_async(fluent_configs[i], "test_fluent_api.c", NULL, &procs);
}
LOG_INFO( " Starting build: %s", demo_config.name);
- build_source_async(demo_config, "api_demo.c", NULL, &procs);
+ build_source_async(demo_config, "../api_demo.c", NULL, &procs);
/* Build Python shared library */
LOG_INFO( " Starting build: Python bindings");
@@ -484,7 +487,7 @@ int main(int argc, char **argv) {
/* Phase 5: Valgrind (must be sequential, slow) */
if (all_ok) {
LOG_INFO( "=== Running valgrind ===");
- if (!run_valgrind("./tests/test_gcc")) {
+ if (!run_valgrind("./test_gcc")) {
nob_log(NOB_ERROR, "Valgrind check failed");
all_ok = false;
}
diff --git a/nob.h b/build/nob.h
similarity index 100%
rename from nob.h
rename to build/nob.h
diff --git a/tests/python_harness/run_cpython_tests.py b/build/python_harness/run_cpython_tests.py
similarity index 100%
rename from tests/python_harness/run_cpython_tests.py
rename to build/python_harness/run_cpython_tests.py
diff --git a/tests/python_harness/snakepath/__init__.py b/build/python_harness/snakepath/__init__.py
similarity index 100%
rename from tests/python_harness/snakepath/__init__.py
rename to build/python_harness/snakepath/__init__.py
diff --git a/tests/python_harness/snakepath_lib.c b/build/python_harness/snakepath_lib.c
similarity index 100%
rename from tests/python_harness/snakepath_lib.c
rename to build/python_harness/snakepath_lib.c
diff --git a/tests/test.c b/build/test.c
similarity index 100%
rename from tests/test.c
rename to build/test.c
diff --git a/tests/test_call_depth.py b/build/test_call_depth.py
similarity index 100%
rename from tests/test_call_depth.py
rename to build/test_call_depth.py
diff --git a/tests/test_fluent_api.c b/build/test_fluent_api.c
similarity index 100%
rename from tests/test_fluent_api.c
rename to build/test_fluent_api.c
diff --git a/docs/index.html b/docs/index.html
index 16a107f..516f5d2 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -207,7 +207,7 @@ Build & Test
cc -o nob nob.c && ./nob
+ class="highlight">
cc -o build/nob build/nob.c && ./build/nob