Feature: C and C++ header dependencies
Scenario: Rebuild after a header dependency from a depfile is updated
Given a file named "build.ninja" with:
"""
rule cc
command = printf 'building\n' && printf '$out: $in header.h\n' > $out.d && cp $in $out
depfile = $out.d
deps = gcc
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
And a file named "header.h" with "#define FOO 1"
When I successfully run `turtle`
And a file named "header.h" with "#define FOO 2"
And I successfully run `turtle`
Then the stdout should contain exactly:
"""
building
building
"""
And the file named "foo.o.d" should not exist
Scenario: Rebuild every object sharing an updated header dependency
Given a file named "build.ninja" with:
"""
rule cc
command = printf 'building\n' && printf '$out: $in header.h\n' > $out.d && cp $in $out
depfile = $out.d
deps = gcc
build foo.o: cc foo.c
build bar.o: cc bar.c
"""
And a file named "foo.c" with "int main(void) { return 0; }"
And a file named "bar.c" with "int main(void) { return 0; }"
And a file named "header.h" with "#define FOO 1"
When I successfully run `turtle`
And a file named "header.h" with "#define FOO 2"
And I successfully run `turtle`
Then the stdout should contain exactly:
"""
building
building
building
building
"""
Scenario: Rebuild after a header dependency from a depfile without deps is updated
Given a file named "build.ninja" with:
"""
rule cc
command = printf 'building\n' && printf '$out: $in header.h\n' > $out.d && cp $in $out
depfile = $out.d
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
And a file named "header.h" with "#define FOO 1"
When I successfully run `turtle`
And a file named "header.h" with "#define FOO 2"
And I successfully run `turtle`
Then the stdout should contain exactly:
"""
building
building
"""
And the file named "foo.o.d" should exist
Scenario: Rebuild after a header dependency from a depfile declared in a build statement is updated
Given a file named "build.ninja" with:
"""
rule cc
command = printf 'building\n' && printf '$out: $in header.h\n' > $out.d && cp $in $out
build foo.o: cc source.c
depfile = foo.o.d
deps = gcc
"""
And a file named "source.c" with "int main(void) { return 0; }"
And a file named "header.h" with "#define FOO 1"
When I successfully run `turtle`
And a file named "header.h" with "#define FOO 2"
And I successfully run `turtle`
Then the stdout should contain exactly:
"""
building
building
"""
And the file named "foo.o.d" should not exist
Scenario: Rebuild after a header dependency from MSVC is updated
Given a file named "build.ninja" with:
"""
rule cc
command = printf 'Note: including file: header.h\ncompiled\n' && cp $in $out
deps = msvc
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
And a file named "header.h" with "#define FOO 1"
When I successfully run `turtle`
And a file named "header.h" with "#define FOO 2"
And I successfully run `turtle`
Then the stdout should contain exactly:
"""
compiled
compiled
"""
Scenario: Read a header dependency with a custom msvc_deps_prefix declared on the rule
Given a file named "build.ninja" with:
"""
rule cc
command = printf 'Remarque : inclusion du fichier : header.h\ncompiled\n' && cp $in $out
deps = msvc
msvc_deps_prefix = Remarque : inclusion du fichier :
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
And a file named "header.h" with "#define FOO 1"
When I successfully run `turtle`
And a file named "header.h" with "#define FOO 2"
And I successfully run `turtle`
Then the stdout should contain exactly:
"""
compiled
compiled
"""
Scenario: Read a header dependency with a custom msvc_deps_prefix declared at the top level
Given a file named "build.ninja" with:
"""
msvc_deps_prefix = Remarque : inclusion du fichier :
rule cc
command = printf 'Remarque : inclusion du fichier : header.h\ncompiled\n' && cp $in $out
deps = msvc
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
And a file named "header.h" with "#define FOO 1"
When I successfully run `turtle`
And a file named "header.h" with "#define FOO 2"
And I successfully run `turtle`
Then the stdout should contain exactly:
"""
compiled
compiled
"""
Scenario: Prefer a build-level msvc_deps_prefix over a conflicting rule-level one
Given a file named "build.ninja" with:
"""
rule cc
command = printf 'Remarque : inclusion du fichier : header.h\ncompiled\n' && cp $in $out
deps = msvc
msvc_deps_prefix = WRONG:
build foo.o: cc source.c
msvc_deps_prefix = Remarque : inclusion du fichier :
"""
And a file named "source.c" with "int main(void) { return 0; }"
And a file named "header.h" with "#define FOO 1"
When I successfully run `turtle`
And a file named "header.h" with "#define FOO 2"
And I successfully run `turtle`
Then the stdout should contain exactly:
"""
compiled
compiled
"""
Scenario: Prefer a rule-level msvc_deps_prefix over a conflicting top-level one
Given a file named "build.ninja" with:
"""
msvc_deps_prefix = WRONG:
rule cc
command = printf 'Remarque : inclusion du fichier : header.h\ncompiled\n' && cp $in $out
deps = msvc
msvc_deps_prefix = Remarque : inclusion du fichier :
build foo.o: cc source.c
cflags = -O2
"""
And a file named "source.c" with "int main(void) { return 0; }"
And a file named "header.h" with "#define FOO 1"
When I successfully run `turtle`
And a file named "header.h" with "#define FOO 2"
And I successfully run `turtle`
Then the stdout should contain exactly:
"""
compiled
compiled
"""
Scenario: Do not rebuild with unchanged header dependencies from gcc
Given a file named "build.ninja" with:
"""
rule cc
command = printf 'building\n' && printf '$out: $in header.h\n' > $out.d && cat $in > $out
depfile = $out.d
deps = gcc
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
And a file named "header.h" with "#define FOO 1"
When I successfully run `turtle`
And I successfully run `turtle`
Then the stdout should contain exactly:
"""
building
"""
Scenario: Do not rebuild with unchanged header dependencies from MSVC
Given a file named "build.ninja" with:
"""
rule cc
command = printf 'Note: including file: header.h\ncompiled\n' && cat $in > $out
deps = msvc
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
And a file named "header.h" with "#define FOO 1"
When I successfully run `turtle`
And I successfully run `turtle`
Then the stdout should contain exactly:
"""
compiled
"""
Scenario: Tolerate a command that does not write its declared depfile
Given a file named "build.ninja" with:
"""
rule cc
command = printf 'building\n' && cp $in $out
depfile = $out.d
deps = gcc
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
When I successfully run `turtle`
Then the file named "foo.o" should exist
Scenario: Recover after a header dependency is deleted
Given a file named "build.ninja" with:
"""
rule cc
command = printf 'building\n' && printf '$out: $in header.h\n' > $out.d && cp $in $out
depfile = $out.d
deps = gcc
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
And a file named "header.h" with "#define FOO 1"
When I successfully run `turtle`
And I remove the file "header.h"
And I successfully run `turtle`
Then the stdout should contain exactly:
"""
building
building
"""
@turtle
Scenario: Stabilize after a header dependency is deleted
Given a file named "build.ninja" with:
"""
rule cc
command = printf 'building\n' && printf '$out: $in header.h\n' > $out.d && cp $in $out
depfile = $out.d
deps = gcc
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
And a file named "header.h" with "#define FOO 1"
When I successfully run `turtle`
And I remove the file "header.h"
And I successfully run `turtle`
And I successfully run `turtle`
Then the stdout should contain exactly:
"""
building
building
"""
Scenario: Tolerate a header dependency deleted while a generated header dependency is built
Given a file named "build.ninja" with:
"""
rule gen
command = sleep 1 && rm -f header.h && cp $in $out
rule cc
command = printf '$out: $in gen.h header.h\n' > $out.d && cp $in $out
depfile = $out.d
deps = gcc
build gen.h: gen gen.h.in
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
And a file named "gen.h.in" with "#define G 1"
And a file named "header.h" with "#define FOO 1"
When I successfully run `turtle foo.o`
And I successfully run `turtle foo.o`
Then the file named "header.h" should not exist
Scenario: Build foo.o on a clean checkout before its generated header exists
Given a file named "build.ninja" with:
"""
rule gen
command = printf '#define G 1\n' > $out
rule cc
command = printf 'building\n' && printf '$out: $in gen.h\n' > $out.d && cp $in $out
depfile = $out.d
deps = gcc
build gen.h: gen
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
When I successfully run `turtle foo.o`
Then the file named "foo.o" should exist
Scenario: Do not rebuild with an unchanged header dependency that is a phony output
Given a file named "build.ninja" with:
"""
rule cc
command = printf 'building\n' && printf '$out: $in header.h\n' > $out.d && cp $in $out
depfile = $out.d
deps = gcc
build header.h: phony
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
And a file named "header.h" with "#define FOO 1"
When I successfully run `turtle foo.o`
And I successfully run `turtle foo.o`
Then the stdout should contain exactly "building"
Scenario: Rebuild after a header dependency that is a phony output is updated
Given a file named "build.ninja" with:
"""
rule cc
command = printf '$out: $in header.h\n' > $out.d && cat $in header.h > $out
depfile = $out.d
deps = gcc
build header.h: phony header.h.in
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
And a file named "header.h" with "#define FOO 1"
And a file named "header.h.in" with "#define FOO 1"
When I successfully run `turtle foo.o`
And I successfully run `turtle foo.o`
And a file named "header.h" with "#define FOO 2"
And I successfully run `turtle foo.o`
Then the file named "foo.o" should contain "#define FOO 2"
Scenario: Do not rebuild with an unchanged header dependency generated behind a phony output
Given a file named "build.ninja" with:
"""
rule gen
command = cp gen.h.in gen.h && touch $out
rule cc
command = printf 'building\n' && printf '$out: $in gen.h\n' > $out.d && cat $in gen.h > $out
depfile = $out.d
deps = gcc
build gen.stamp: gen gen.h.in
build gen.h: phony gen.stamp
build foo.o: cc foo.c || gen.h
"""
And a file named "foo.c" with "int main(void) { return 0; }"
And a file named "gen.h.in" with "#define G 1"
When I successfully run `turtle foo.o`
And I successfully run `turtle foo.o`
Then the stdout should contain exactly "building"
Scenario: Rebuild after a header dependency generated behind a phony output is updated
Given a file named "build.ninja" with:
"""
rule gen
command = cp gen.h.in gen.h && touch $out
rule cc
command = printf '$out: $in gen.h\n' > $out.d && cat $in gen.h > $out
depfile = $out.d
deps = gcc
build gen.stamp: gen gen.h.in
build gen.h: phony gen.stamp
build foo.o: cc foo.c || gen.h
"""
And a file named "foo.c" with "int main(void) { return 0; }"
And a file named "gen.h.in" with "#define G 1"
When I successfully run `turtle gen.h`
And I successfully run `turtle foo.o`
And a file named "gen.h.in" with "#define G 2"
And I successfully run `turtle foo.o`
Then the file named "foo.o" should contain "#define G 2"
Scenario: Rebuild after a header dependency generated behind a rule output is updated
Given a file named "build.ninja" with:
"""
rule gen
command = cp gen.h.in gen.h && touch $out
rule alias
command = true
rule cc
command = printf '$out: $in gen.h\n' > $out.d && cat $in gen.h > $out
depfile = $out.d
deps = gcc
build gen.stamp: gen gen.h.in
build gen.h: alias gen.stamp
build foo.o: cc foo.c || gen.h
"""
And a file named "foo.c" with "int main(void) { return 0; }"
And a file named "gen.h.in" with "#define G 1"
When I successfully run `turtle gen.h`
And I successfully run `turtle foo.o`
And a file named "gen.h.in" with "#define G 2"
And I successfully run `turtle foo.o`
Then the file named "foo.o" should contain "#define G 2"
Scenario: Do not rebuild with an unchanged generated header dependency
Given a file named "build.ninja" with:
"""
rule gen
command = cp $in $out
rule cc
command = printf 'building\n' && printf '$out: $in gen.h\n' > $out.d && cat $in gen.h > $out
depfile = $out.d
deps = gcc
build gen.h: gen gen.h.in
build foo.o: cc foo.c || gen.h
"""
And a file named "foo.c" with "int main(void) { return 0; }"
And a file named "gen.h.in" with "#define G 1"
When I successfully run `turtle foo.o`
And I successfully run `turtle foo.o`
Then the stdout should contain exactly "building"
Scenario: Rebuild after a generated header dependency is updated
Given a file named "build.ninja" with:
"""
rule gen
command = cp $in $out
rule cc
command = printf '$out: $in gen.h\n' > $out.d && cat $in gen.h > $out
depfile = $out.d
deps = gcc
build gen.h: gen gen.h.in
build foo.o: cc foo.c
"""
And a file named "foo.c" with "int main(void) { return 0; }"
And a file named "gen.h.in" with "#define G 1"
When I successfully run `turtle gen.h`
And a file named "gen.h.in" with "#define G 2"
And I successfully run `turtle foo.o`
And I successfully run `turtle foo.o`
Then the file named "foo.o" should contain "#define G 2"
Scenario: Rebuild objects sharing a regenerated header dependency
Given a file named "build.ninja" with:
"""
rule gen
command = cp $in $out
rule cc
command = printf '$out: $in gen.h\n' > $out.d && cat $in gen.h > $out
depfile = $out.d
deps = gcc
build gen.h: gen gen.h.in
build foo.o: cc foo.c
build bar.o: cc bar.c
"""
And a file named "foo.c" with "int main(void) { return 0; }"
And a file named "bar.c" with "int main(void) { return 0; }"
And a file named "gen.h.in" with "#define G 1"
When I successfully run `turtle gen.h`
And a file named "gen.h.in" with "#define G 2"
And I successfully run `turtle foo.o bar.o`
And I successfully run `turtle foo.o bar.o`
Then the file named "foo.o" should contain "#define G 2"
And the file named "bar.o" should contain "#define G 2"
Scenario: Rebuild with a regenerated input discovered as a header dependency by another build
Given a file named "build.ninja" with:
"""
rule cp
command = cp $in $out
rule gen
command = sleep 1 && cp $in $out
rule cc
command = printf '$out: %s\n' "$$(cat $in)" > $out.d && cp $in $out
depfile = $out.d
deps = gcc
rule cat
command = cat $in > $out
build gen.h.tmp: cp gen.h.in
build gen.h: gen gen.h.tmp
build foo.o: cc foo.c
build bar.o: cat bar.c gen.h
"""
And a file named "foo.c" with "foo.c"
And a file named "bar.c" with "int main(void) { return 0; }"
And a file named "gen.h.in" with "#define G 1"
When I successfully run `turtle`
And a file named "foo.c" with "gen.h"
And a file named "gen.h.in" with "#define G 2"
And I successfully run `turtle`
Then the file named "bar.o" should contain "#define G 2"
Scenario: Rebuild with a header dependency regenerated behind a phony output and discovered by another build
Given a file named "build.ninja" with:
"""
rule cp
command = cp $in $out
rule gen
command = sleep 1 && cp $in gen.h && touch $out
rule cc
command = printf '$out: %s\n' "$$(cat $in)" > $out.d && cp $in $out
depfile = $out.d
deps = gcc
rule cc_header
command = printf '$out: $in gen.h\n' > $out.d && cat $in gen.h > $out
depfile = $out.d
deps = gcc
build gen.h.tmp: cp gen.h.in
build gen.stamp: gen gen.h.tmp
build gen.h: phony gen.stamp
build foo.o: cc foo.c
build bar.o: cc_header bar.c || gen.h
"""
And a file named "foo.c" with "foo.c"
And a file named "bar.c" with "int main(void) { return 0; }"
And a file named "gen.h.in" with "#define G 1"
When I successfully run `turtle`
And a file named "foo.c" with "gen.h"
And a file named "gen.h.in" with "#define G 2"
And I successfully run `turtle`
Then the file named "bar.o" should contain "#define G 2"
Scenario: Report an error for a cycle through a header dependency on the next run
Given a file named "build.ninja" with:
"""
rule gen
command = cp $in $out
rule cc
command = printf '$out: $in gen.h\n' > $out.d && cp $in $out
depfile = $out.d
deps = gcc
build gen.h: gen foo.o
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
When I successfully run `turtle foo.o`
And I run `turtle foo.o`
Then the exit status should not be 0
And the stderr should contain "dependency cycle"
Scenario: Accept a header path with an escaped space in a depfile
Given a file named "build.ninja" with:
"""
rule cc
command = printf 'building\n' && printf '$out: $in my\\ header.h\n' > $out.d && cat $in > $out
depfile = $out.d
deps = gcc
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
And a file named "my header.h" with "#define FOO 1"
When I successfully run `turtle`
And I successfully run `turtle`
Then the stdout should contain exactly:
"""
building
"""
Scenario: Ignore a depfile set alongside deps = msvc
Given a file named "build.ninja" with:
"""
rule cc
command = printf 'Note: including file: header.h\ncompiled\n' && printf '$out: $in nonexistent.h\n' > $out.d && cp $in $out
depfile = $out.d
deps = msvc
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
And a file named "header.h" with "#define FOO 1"
When I successfully run `turtle`
Then the stdout should contain exactly "compiled"
Scenario: Reject deps = gcc without a depfile
Given a file named "build.ninja" with:
"""
rule cc
command = printf 'building\n' && cp $in $out
deps = gcc
build foo.o: cc source.c
"""
And a file named "source.c" with "int main(void) { return 0; }"
When I run `turtle`
Then the exit status should not be 0