diff options
author | Paul Cristian Sarbu <paul.cristian.sarbu@huawei.com> | 2025-05-23 14:34:38 +0200 |
---|---|---|
committer | Paul Cristian Sarbu <paul.cristian.sarbu@huawei.com> | 2025-05-23 16:45:16 +0200 |
commit | 2ada58e9a8c7b95dd7da5bfe8a6f1e16bb7686f5 (patch) | |
tree | 7de2ea6eb8299026e75f04282f71580179f67918 /doc | |
parent | 553c4b0a55eee519e2d98d6d8c96ec3af44183e4 (diff) | |
download | justbuild-2ada58e9a8c7b95dd7da5bfe8a6f1e16bb7686f5.tar.gz |
tutorial: Update example outputs in all chapters
...to match the ones produces by latest binaries and rules.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/tutorial/debugging.md | 10 | ||||
-rw-r--r-- | doc/tutorial/getting-started.md | 14 | ||||
-rw-r--r-- | doc/tutorial/hello-world.md | 26 | ||||
-rw-r--r-- | doc/tutorial/just-lock.md | 4 | ||||
-rw-r--r-- | doc/tutorial/just-serve.md | 8 | ||||
-rw-r--r-- | doc/tutorial/lint.md | 86 | ||||
-rw-r--r-- | doc/tutorial/proto.md | 191 | ||||
-rw-r--r-- | doc/tutorial/rebuild.md | 12 | ||||
-rw-r--r-- | doc/tutorial/target-file-glob-tree.md | 46 | ||||
-rw-r--r-- | doc/tutorial/third-party-software.md | 20 |
10 files changed, 227 insertions, 190 deletions
diff --git a/doc/tutorial/debugging.md b/doc/tutorial/debugging.md index ab35e591..cc748983 100644 --- a/doc/tutorial/debugging.md +++ b/doc/tutorial/debugging.md @@ -45,8 +45,8 @@ control, we need to commit the changes: ``` sh $ git add tutorial-defaults $ git commit -m "update compile flags for debugging" -[master baabec7] update compile flags for debugging - 1 file changed, 21 insertions(+), 2 deletions(-) +[master 642f739] update compile flags for debugging + 1 file changed, 1 insertions(+) ``` Now we need to configure the actual target we want to debug. The `TARGETS` file @@ -86,16 +86,16 @@ Now this target can be installed to a location of our choice provided by the ``` sh $ just-mr install "helloworld-debug staged" -o .ext/debug INFO: Performing repositories setup -INFO: Found 5 repositories to set up +INFO: Found 5 repositories involved INFO: Setup finished, exec ["just","install","-C","...","helloworld-debug staged","-o",".ext/debug"] INFO: Requested target is [["@","tutorial","","helloworld-debug install"],{}] INFO: Analysed target [["@","tutorial","","helloworld-debug install"],{}] INFO: Export targets found: 0 cached, 1 uncached, 0 not eligible for caching -INFO: Discovered 7 actions, 3 trees, 0 blobs +INFO: Discovered 7 actions, 0 tree overlays, 3 trees, 0 blobs INFO: Building [["@","tutorial","","helloworld-debug install"],{}]. INFO: Processed 7 actions, 0 cache hits. INFO: Artifacts can be found in: - /tmp/tutorial/.ext/debug/bin/helloworld [d88cadc156dc3b9b442fc162f7bc92c86b63d5f8:1570432:x] + /tmp/tutorial/.ext/debug/bin/helloworld [5f0ce4ed97000af42902c41f9d3b7d51343534a6:1570896:x] /tmp/tutorial/.ext/debug/include/fmt [3a5cb60e63f7480b150fdef0883d7a76e8a57a00:464:t] /tmp/tutorial/.ext/debug/include/greet/greet.hpp [63815ae1b5a36ab29efa535141fee67f3b7769de:53:f] /tmp/tutorial/.ext/debug/work/fmt [3a5cb60e63f7480b150fdef0883d7a76e8a57a00:464:t] diff --git a/doc/tutorial/getting-started.md b/doc/tutorial/getting-started.md index a97aea60..7a373aeb 100644 --- a/doc/tutorial/getting-started.md +++ b/doc/tutorial/getting-started.md @@ -58,7 +58,7 @@ To build a target, we need to run `just` with the subcommand `build`: $ just build greeter INFO: Requested target is [["@","","","greeter"],{}] INFO: Analysed target [["@","","","greeter"],{}] -INFO: Discovered 1 actions, 0 trees, 0 blobs +INFO: Discovered 1 actions, 0 tree overlays, 0 trees, 0 blobs INFO: Building [["@","","","greeter"],{}]. INFO: Processed 1 actions, 0 cache hits. INFO: Artifacts built, logical paths are: @@ -77,7 +77,7 @@ and specify the output directory: $ just install greeter -o . INFO: Requested target is [["@","","","greeter"],{}] INFO: Analysed target [["@","","","greeter"],{}] -INFO: Discovered 1 actions, 0 trees, 0 blobs +INFO: Discovered 1 actions, 0 tree overlays, 0 trees, 0 blobs INFO: Building [["@","","","greeter"],{}]. INFO: Processed 1 actions, 1 cache hits. INFO: Artifacts can be found in: @@ -104,7 +104,7 @@ a text file, as well as for piping the artifact to another program. $ just build greeter -P out.txt INFO: Requested target is [["@","","","greeter"],{}] INFO: Analysed target [["@","","","greeter"],{}] -INFO: Discovered 1 actions, 0 trees, 0 blobs +INFO: Discovered 1 actions, 0 tree overlays, 0 trees, 0 blobs INFO: Building [["@","","","greeter"],{}]. INFO: Processed 1 actions, 1 cache hits. INFO: Artifacts built, logical paths are: @@ -113,7 +113,7 @@ Hello World $ just build -p INFO: Requested target is [["@","","","greeter"],{}] INFO: Analysed target [["@","","","greeter"],{}] -INFO: Discovered 1 actions, 0 trees, 0 blobs +INFO: Discovered 1 actions, 0 tree overlays, 0 trees, 0 blobs INFO: Building [["@","","","greeter"],{}]. INFO: Processed 1 actions, 1 cache hits. INFO: Artifacts built, logical paths are: @@ -178,7 +178,7 @@ As we only request targets, no conflicts arise. $ just build upper -p INFO: Requested target is [["@","","","upper"],{}] INFO: Analysed target [["@","","","upper"],{}] -INFO: Discovered 1 actions, 0 trees, 0 blobs +INFO: Discovered 1 actions, 0 tree overlays, 0 trees, 0 blobs INFO: Building [["@","","","upper"],{}]. INFO: Processed 1 actions, 0 cache hits. INFO: Artifacts built, logical paths are: @@ -187,7 +187,7 @@ WORLD $ just build greeter -p INFO: Requested target is [["@","","","greeter"],{}] INFO: Analysed target [["@","","","greeter"],{}] -INFO: Discovered 1 actions, 0 trees, 0 blobs +INFO: Discovered 1 actions, 0 tree overlays, 0 trees, 0 blobs INFO: Building [["@","","","greeter"],{}]. INFO: Processed 1 actions, 1 cache hits. INFO: Artifacts built, logical paths are: @@ -217,7 +217,7 @@ artifact of that target) as such a mapping is necessarily conflict free. $ just build both INFO: Requested target is [["@","","","both"],{}] INFO: Analysed target [["@","","","both"],{}] -INFO: Discovered 2 actions, 0 trees, 0 blobs +INFO: Discovered 2 actions, 0 tree overlays, 0 trees, 0 blobs INFO: Building [["@","","","both"],{}]. INFO: Processed 2 actions, 2 cache hits. INFO: Artifacts built, logical paths are: diff --git a/doc/tutorial/hello-world.md b/doc/tutorial/hello-world.md index eabcaf49..25645c73 100644 --- a/doc/tutorial/hello-world.md +++ b/doc/tutorial/hello-world.md @@ -117,11 +117,11 @@ command line: ``` sh $ just-mr build helloworld INFO: Performing repositories setup -INFO: Found 2 repositories to set up +INFO: Found 2 repositories involved INFO: Setup finished, exec ["just","build","-C","...","helloworld"] INFO: Requested target is [["@","tutorial","","helloworld"],{}] INFO: Analysed target [["@","tutorial","","helloworld"],{}] -INFO: Discovered 2 actions, 1 trees, 0 blobs +INFO: Discovered 2 actions, 0 tree overlays, 1 trees, 0 blobs INFO: Building [["@","tutorial","","helloworld"],{}]. INFO: Processed 2 actions, 0 cache hits. INFO: Artifacts built, logical paths are: @@ -166,11 +166,11 @@ object that sets `"CXX"` to `"clang++"`: ``` sh $ just-mr build helloworld -D'{"CXX":"clang++"}' INFO: Performing repositories setup -INFO: Found 2 repositories to set up +INFO: Found 2 repositories involved INFO: Setup finished, exec ["just","build","-C","...","helloworld","-D{\"CXX\":\"clang++\"}"] INFO: Requested target is [["@","tutorial","","helloworld"],{"CXX":"clang++"}] INFO: Analysed target [["@","tutorial","","helloworld"],{"CXX":"clang++"}] -INFO: Discovered 2 actions, 1 trees, 0 blobs +INFO: Discovered 2 actions, 0 tree overlays, 1 trees, 0 blobs INFO: Building [["@","tutorial","","helloworld"],{"CXX":"clang++"}]. INFO: Processed 2 actions, 0 cache hits. INFO: Artifacts built, logical paths are: @@ -272,11 +272,11 @@ change): ``` sh $ just-mr build helloworld INFO: Performing repositories setup -INFO: Found 3 repositories to set up +INFO: Found 3 repositories involved INFO: Setup finished, exec ["just","build","-C","...","helloworld"] INFO: Requested target is [["@","tutorial","","helloworld"],{}] INFO: Analysed target [["@","tutorial","","helloworld"],{}] -INFO: Discovered 2 actions, 1 trees, 0 blobs +INFO: Discovered 2 actions, 0 tree overlays, 1 trees, 0 blobs INFO: Building [["@","tutorial","","helloworld"],{}]. INFO: Processed 2 actions, 0 cache hits. INFO: Artifacts built, logical paths are: @@ -399,11 +399,11 @@ binary can be built with the same command as before (no need to rerun ``` sh $ just-mr build helloworld INFO: Performing repositories setup -INFO: Found 3 repositories to set up +INFO: Found 3 repositories involved INFO: Setup finished, exec ["just","build","-C","...","helloworld"] INFO: Requested target is [["@","tutorial","","helloworld"],{}] INFO: Analysed target [["@","tutorial","","helloworld"],{}] -INFO: Discovered 4 actions, 2 trees, 0 blobs +INFO: Discovered 4 actions, 0 tree overlays, 2 trees, 0 blobs INFO: Building [["@","tutorial","","helloworld"],{}]. INFO: Processed 4 actions, 0 cache hits. INFO: Artifacts built, logical paths are: @@ -417,11 +417,11 @@ run the following command: ``` sh $ just-mr build greet greet INFO: Performing repositories setup -INFO: Found 3 repositories to set up +INFO: Found 3 repositories involved INFO: Setup finished, exec ["just","build","-C","...","greet","greet"] INFO: Requested target is [["@","tutorial","greet","greet"],{}] INFO: Analysed target [["@","tutorial","greet","greet"],{}] -INFO: Discovered 2 actions, 1 trees, 0 blobs +INFO: Discovered 2 actions, 0 tree overlays, 1 trees, 0 blobs INFO: Building [["@","tutorial","greet","greet"],{}]. INFO: Processed 2 actions, 2 cache hits. INFO: Artifacts built, logical paths are: @@ -438,13 +438,13 @@ that library provides. ``` sh $ just-mr analyse greet greet INFO: Performing repositories setup -INFO: Found 3 repositories to set up +INFO: Found 3 repositories involved INFO: Setup finished, exec ["just","analyse","-C","...","greet","greet"] INFO: Requested target is [["@","tutorial","greet","greet"],{}] INFO: Analysed target [["@","tutorial","greet","greet"],{}] INFO: Result of target [["@","tutorial","greet","greet"],{}]: { "artifacts": { - "greet/libgreet.a": {"data":{"id":"c4ba32e2fc1ce267b4245d8885ae7b53405d41a709f853061549ca93aa73a6ac","path":"work/greet/libgreet.a"},"type":"ACTION"} + "greet/libgreet.a": {"data":{"id":"d964a2747015935adc5fd7f06bbd910d5dde99e990436be0b1f7034270b5b11d","path":"work/greet/libgreet.a"},"type":"ACTION"} }, "provides": { "compile-args": [ @@ -455,6 +455,8 @@ INFO: Result of target [["@","tutorial","greet","greet"],{}]: { }, "debug-srcs": { }, + "dwarf-pkg": { + }, "link-args": [ "greet/libgreet.a" ], diff --git a/doc/tutorial/just-lock.md b/doc/tutorial/just-lock.md index 538f559e..d5f04fb1 100644 --- a/doc/tutorial/just-lock.md +++ b/doc/tutorial/just-lock.md @@ -146,12 +146,12 @@ $ just-lock -C repos.in.json -o repos.out.json $ $ just-mr -C repos.out.json build helloworld INFO: Performing repositories setup -INFO: Found 5 repositories to set up +INFO: Found 5 repositories involved INFO: Setup finished, exec ["just","build","-C","...","helloworld"] INFO: Requested target is [["@","tutorial","","helloworld"],{}] INFO: Analysed target [["@","tutorial","","helloworld"],{}] INFO: Export targets found: 1 cached, 0 uncached, 0 not eligible for caching -INFO: Discovered 4 actions, 2 trees, 0 blobs +INFO: Discovered 4 actions, 0 tree overlays, 2 trees, 0 blobs INFO: Building [["@","tutorial","","helloworld"],{}]. INFO: Processed 4 actions, 4 cache hits. INFO: Artifacts built, logical paths are: diff --git a/doc/tutorial/just-serve.md b/doc/tutorial/just-serve.md index 9ba08758..9c71e39d 100644 --- a/doc/tutorial/just-serve.md +++ b/doc/tutorial/just-serve.md @@ -570,13 +570,13 @@ serve endpoint ``` sh $ just-mr -R localhost:9999 --local-build-root ~/local-build-root build helloworld INFO: Performing repositories setup -INFO: Found 5 repositories to set up +INFO: Found 5 repositories involved INFO: Setup finished, exec ["just","build","-C","...","--local-build-root","/home/tutorial/local-build-root","-R","127.0.0.1:9999","helloworld"] INFO: Using '127.0.0.1:9999' as the remote execution endpoint. INFO: Requested target is [["@","tutorial","","helloworld"],{}] INFO: Analysed target [["@","tutorial","","helloworld"],{}] INFO: Export targets found: 0 cached, 1 served, 0 uncached, 0 not eligible for caching -INFO: Discovered 4 actions, 2 trees, 0 blobs +INFO: Discovered 4 actions, 0 tree overlays, 2 trees, 0 blobs INFO: Building [["@","tutorial","","helloworld"],{}]. INFO: Processed 4 actions, 0 cache hits. INFO: Artifacts built, logical paths are: @@ -727,13 +727,13 @@ endpoint still running, successfully ``` sh $ just-mr --rc rc-file build helloworld INFO: Performing repositories setup -INFO: Found 5 repositories to set up +INFO: Found 5 repositories involved INFO: Setup finished, exec ["just","build","-C","...","--local-build-root","/home/tutorial/local-build-root","-R","localhost:9999","helloworld"] INFO: Using 'localhost:9999' as the remote execution endpoint. INFO: Requested target is [["@","tutorial","","helloworld"],{}] INFO: Analysed target [["@","tutorial","","helloworld"],{}] INFO: Export targets found: 0 cached, 1 served, 0 uncached, 0 not eligible for caching -INFO: Discovered 4 actions, 2 trees, 0 blobs +INFO: Discovered 4 actions, 0 tree overlays, 2 trees, 0 blobs INFO: Building [["@","tutorial","","helloworld"],{}]. INFO: Processed 4 actions, 4 cache hits. INFO: Artifacts built, logical paths are: diff --git a/doc/tutorial/lint.md b/doc/tutorial/lint.md index f7d99787..7940ae70 100644 --- a/doc/tutorial/lint.md +++ b/doc/tutorial/lint.md @@ -23,24 +23,26 @@ abstract nodes for our sources (`main.cpp`, `greet/greet.hpp`, ``` sh $ just-mr analyse -D '{"LINT": true}' --dump-nodes - INFO: Performing repositories setup -INFO: Found 5 repositories to set up +INFO: Found 5 repositories involved INFO: Setup finished, exec ["just","analyse","-C","...","-D","{\"LINT\": true}","--dump-nodes","-"] INFO: Requested target is [["@","tutorial","","helloworld"],{"LINT":true}] INFO: Analysed target [["@","tutorial","","helloworld"],{"LINT":true}] INFO: Export targets found: 0 cached, 1 uncached, 0 not eligible for caching INFO: Result of target [["@","tutorial","","helloworld"],{"LINT":true}]: { "artifacts": { - "helloworld": {"data":{"id":"edf0113a4dff26d1d2453947fe0c7ae11a6cabb125a5ddb2f15e10106e01781c","path":"work/helloworld"},"type":"ACTION"} + "helloworld": {"data":{"id":"1154ef311dff82653bc6a1a92bfc6152bc116cb86652b4b5218385fe39054391","path":"work/helloworld"},"type":"ACTION"} }, "provides": { "debug-hdrs": { }, "debug-srcs": { }, + "dwarf-pkg": { + }, "lint": [ - {"id":"28df1af04041db0c150bbdef440fc3265a57e1163258fd15a4373b7279e4b91a","type":"NODE"}, - {"id":"f76b7acba64fc35a5c67f81d52a4aa47e0b0c8966eaf19c1f51477a4e0b8fc79","type":"NODE"}, - {"id":"bd8ee55d88fade7ebc8121ab7e230aed3888b27f9e87841482b2b08ecf47acb0","type":"NODE"} + {"id":"aec2651a9f3b869554e3a2e5cc3ab85d86610a79aae388a4f7839396dc2167d2","type":"NODE"}, + {"id":"509e506f8d0c2ebe4fca63fe7cc528be17165bae464410ac5fba97a6ed92930d","type":"NODE"}, + {"id":"cb3bd5f3934e199ddf5d43eae6866f8c6ba449f060213a244c93f0826c070c3f","type":"NODE"} ], "package": { "to_bin": true @@ -53,74 +55,78 @@ INFO: Result of target [["@","tutorial","","helloworld"],{"LINT":true}]: { } INFO: Target nodes of target [["@","tutorial","","helloworld"],{"LINT":true}]: { - "28df1af04041db0c150bbdef440fc3265a57e1163258fd15a4373b7279e4b91a": { + "509e506f8d0c2ebe4fca63fe7cc528be17165bae464410ac5fba97a6ed92930d": { "result": { "artifact_stage": { "include": { "data": { - "id": "ac340b9e4bcdf82d972ff9286bbda4cd7219d6d3487867875418aeb2b03012b5" + "id": "a882ca13d51c70aa6b02d4996aa426ee6e21bf85881ec0f6dbe0a278f5a27b7b" }, "type": "TREE" }, - "work/main.cpp": { + "work/greet/greet.hpp": { "data": { - "path": "main.cpp", + "path": "greet/greet.hpp", "repository": "tutorial" }, "type": "LOCAL" } }, "provides": { - "cmd": ["c++","-O2","-Wall","-I","work","-isystem","include","-c","work/main.cpp","-o","work/main.o"], - "src": "work/main.cpp" + "cmd": ["c++","-O2","-Wall","-I","work","-isystem","include","-E","work/greet/greet.hpp"], + "direct deps artifact names": ["include/fmt","work/greet/greet.hpp"], + "extra outs": [], + "src": "work/greet/greet.hpp" }, "runfiles": { } }, "type": "VALUE_NODE" }, - "bd8ee55d88fade7ebc8121ab7e230aed3888b27f9e87841482b2b08ecf47acb0": { + "aec2651a9f3b869554e3a2e5cc3ab85d86610a79aae388a4f7839396dc2167d2": { "result": { "artifact_stage": { "include": { "data": { - "id": "124bb6d1afd5839463acf1f602109c4229ea303dc5dbfc63d2d4ce21fa590d24" + "id": "29d6c7fef3c48a1a3b15edd770b33d073d5c9cd1e6e9fb22917831fcdd762ebb" }, "type": "TREE" }, - "work/greet/greet.cpp": { - "data": { - "path": "greet/greet.cpp", - "repository": "tutorial" - }, - "type": "LOCAL" - }, - "work/greet/greet.hpp": { + "work/main.cpp": { "data": { - "path": "greet/greet.hpp", + "path": "main.cpp", "repository": "tutorial" }, "type": "LOCAL" } }, "provides": { - "cmd": ["c++","-O2","-Wall","-I","work","-isystem","include","-c","work/greet/greet.cpp","-o","work/greet/greet.o"], - "src": "work/greet/greet.cpp" + "cmd": ["c++","-O2","-Wall","-I","work","-isystem","include","-c","work/main.cpp","-o","work/main.o"], + "direct deps artifact names": ["include/greet/greet.hpp"], + "extra outs": [], + "src": "work/main.cpp" }, "runfiles": { } }, "type": "VALUE_NODE" }, - "f76b7acba64fc35a5c67f81d52a4aa47e0b0c8966eaf19c1f51477a4e0b8fc79": { + "cb3bd5f3934e199ddf5d43eae6866f8c6ba449f060213a244c93f0826c070c3f": { "result": { "artifact_stage": { "include": { "data": { - "id": "124bb6d1afd5839463acf1f602109c4229ea303dc5dbfc63d2d4ce21fa590d24" + "id": "a882ca13d51c70aa6b02d4996aa426ee6e21bf85881ec0f6dbe0a278f5a27b7b" }, "type": "TREE" }, + "work/greet/greet.cpp": { + "data": { + "path": "greet/greet.cpp", + "repository": "tutorial" + }, + "type": "LOCAL" + }, "work/greet/greet.hpp": { "data": { "path": "greet/greet.hpp", @@ -130,8 +136,10 @@ INFO: Target nodes of target [["@","tutorial","","helloworld"],{"LINT":true}]: } }, "provides": { - "cmd": ["c++","-O2","-Wall","-I","work","-isystem","include","-E","work/greet/greet.hpp"], - "src": "work/greet/greet.hpp" + "cmd": ["c++","-O2","-Wall","-I","work","-isystem","include","-c","work/greet/greet.cpp","-o","work/greet/greet.o"], + "direct deps artifact names": ["include/fmt","work/greet/greet.hpp"], + "extra outs": [], + "src": "work/greet/greet.cpp" }, "runfiles": { } @@ -162,9 +170,10 @@ subcommand. ``` sh $ just-mr --main rules-cc describe --rule lint targets INFO: Performing repositories setup -INFO: Found 2 repositories to set up +INFO: Found 2 repositories involved INFO: Setup finished, exec ["just","describe","-C","...","--rule","lint","targets"] | Run a given linter on the lint information provided by the given targets. +... Target fields - "linter" | Single artifact running the lint checks. @@ -315,13 +324,13 @@ We now can build our lint report in the same way as any test report. ``` sh $ just-mr build lint -P report INFO: Performing repositories setup -INFO: Found 5 repositories to set up +INFO: Found 5 repositories involved INFO: Setup finished, exec ["just","build","-C","...","lint","-P","report"] INFO: Requested target is [["@","tutorial","","lint"],{}] INFO: Analysed target [["@","tutorial","","lint"],{}] INFO: Export targets found: 0 cached, 1 uncached, 0 not eligible for caching INFO: Target tainted ["lint"]. -INFO: Discovered 11 actions, 7 trees, 0 blobs +INFO: Discovered 11 actions, 0 tree overlays, 7 trees, 0 blobs INFO: Building [["@","tutorial","","lint"],{}]. INFO: Processed 7 actions, 3 cache hits. INFO: Artifacts built, logical paths are: @@ -351,12 +360,12 @@ Building succeeds without any warning. ``` sh $ just-mr build helloworld INFO: Performing repositories setup -INFO: Found 5 repositories to set up +INFO: Found 5 repositories involved INFO: Setup finished, exec ["just","build","-C","...","helloworld"] INFO: Requested target is [["@","tutorial","","helloworld"],{}] INFO: Analysed target [["@","tutorial","","helloworld"],{}] INFO: Export targets found: 1 cached, 0 uncached, 0 not eligible for caching -INFO: Discovered 4 actions, 2 trees, 0 blobs +INFO: Discovered 4 actions, 0 tree overlays, 2 trees, 0 blobs INFO: Building [["@","tutorial","","helloworld"],{}]. INFO: Processed 4 actions, 1 cache hits. INFO: Artifacts built, logical paths are: @@ -367,15 +376,20 @@ However, the linter reports it. ``` sh $ just-mr build lint -P report || : INFO: Performing repositories setup -INFO: Found 5 repositories to set up +INFO: Found 5 repositories involved INFO: Setup finished, exec ["just","build","-C","...","lint","-P","report"] INFO: Requested target is [["@","tutorial","","lint"],{}] INFO: Analysed target [["@","tutorial","","lint"],{}] INFO: Export targets found: 1 cached, 0 uncached, 0 not eligible for caching INFO: Target tainted ["lint"]. -INFO: Discovered 8 actions, 6 trees, 0 blobs +INFO: Discovered 8 actions, 0 tree overlays, 6 trees, 0 blobs INFO: Building [["@","tutorial","","lint"],{}]. -WARN (action:b9abc2d5c9766644da1f9db5ec6586f6ced35f36670046b14f73ad532ce12ba4): lint failed for work/greet/greet.cpp (exit code 1) +WARN (action:415a94f0c74ec937e2504b9ef5f94696232ff2c57eb2bec00c226896e2eb8be6): + lint failed for work/greet/greet.cpp (exit code 1); outputs: + - "result" [94e1707e853c36f514de3876408c09a0e0ca6fc4:5:f] + - "stderr" [ffc377e8898697782ab96419f6ab82c60985c752:235:f] + - "stdout" [17975e013bd2cc3f66509e11737e1e169f1bd162:231:f] + - "out" [caf25f0a518d21909625f9a7974002796f6d8b5f:39:t] INFO: Processed 4 actions, 2 cache hits. INFO: Artifacts built, logical paths are: out [c298959107421711f8d87a2b96e95858c065b9b9:41:t] FAILED diff --git a/doc/tutorial/proto.md b/doc/tutorial/proto.md index 62e084f7..57484179 100644 --- a/doc/tutorial/proto.md +++ b/doc/tutorial/proto.md @@ -79,16 +79,15 @@ and sets up all the repositories. ``` sh $ just-mr build address INFO: Performing repositories setup -INFO: Found 23 repositories to set up -PROG: [ 0%] 1 local, 0 cached, 0 done -PROG: [ 0%] 1 local, 0 cached, 0 done -PROG: [ 66%] 1 local, 1 cached, 14 done -PROG: [ 90%] 1 local, 1 cached, 19 done -PROG: [ 95%] 1 local, 1 cached, 20 done; 1 fetches ("rules-cc/just/import targets") +INFO: Found 23 repositories involved +PROG: [ 44%] 0 computed, 1 local, 13 cached, 4 done; 7 fetches ("rules-cc/just/defaults", ...) +PROG: [ 66%] 0 computed, 1 local, 13 cached, 6 done; 7 fetches ("rules-cc/just/defaults", ...) +PROG: [ 66%] 0 computed, 1 local, 13 cached, 6 done; 7 fetches ("rules-cc/just/defaults", ...) +PROG: [ 77%] 0 computed, 1 local, 13 cached, 7 done; 7 fetches ("rules-cc/just/defaults", ...) INFO: Setup finished, exec ["just","build","-C","...","--local-build-root","/tmp/proto","address"] INFO: Requested target is [["@","","","address"],{}] INFO: Analysed target [["@","","","address"],{}] -INFO: Discovered 0 actions, 0 trees, 0 blobs +INFO: Discovered 0 actions, 0 tree overlays, 0 trees, 0 blobs INFO: Building [["@","","","address"],{}]. INFO: Processed 0 actions, 0 cache hits. INFO: Artifacts built, logical paths are: @@ -110,7 +109,7 @@ structure of the `.proto` files. ``` sh $ just-mr analyse --dump-nodes - address INFO: Performing repositories setup -INFO: Found 23 repositories to set up +INFO: Found 23 repositories involved INFO: Setup finished, exec ["just","analyse","-C","...","--dump-nodes","-","address"] INFO: Requested target is [["@","","","address"],{}] INFO: Result of target [["@","","","address"],{}]: { @@ -118,7 +117,7 @@ INFO: Result of target [["@","","","address"],{}]: { }, "provides": { "proto": [ - {"id":"2a483a2de7f25c1bc066e47245f55ec9a2d4a719","type":"NODE"} + {"id":"6bcfb07e77f4d00f84d4c38bff64b92e0a1cf07399bd0987250eaef1b06b0b50","type":"NODE"} ] }, "runfiles": { @@ -126,7 +125,19 @@ INFO: Result of target [["@","","","address"],{}]: { } INFO: Target nodes of target [["@","","","address"],{}]: { - "089f6cae7ca77bb786578d3e0138b6ff445c5c92": { + "6bcfb07e77f4d00f84d4c38bff64b92e0a1cf07399bd0987250eaef1b06b0b50": { + "node_type": "library", + "string_fields": { + "name": ["addressbook"], + "stage": [""] + }, + "target_fields": { + "deps": [], + "srcs": [{"id":"dd79fcd0043ad155b5765f6a7a58a6c88fbcd38567ab0523684bd54a925727ce","type":"NODE"}] + }, + "type": "ABSTRACT_NODE" + }, + "dd79fcd0043ad155b5765f6a7a58a6c88fbcd38567ab0523684bd54a925727ce": { "result": { "artifact_stage": { "addressbook.proto": { @@ -144,18 +155,6 @@ INFO: Target nodes of target [["@","","","address"],{}]: } }, "type": "VALUE_NODE" - }, - "2a483a2de7f25c1bc066e47245f55ec9a2d4a719": { - "node_type": "library", - "string_fields": { - "name": ["addressbook"], - "stage": [""] - }, - "target_fields": { - "deps": [], - "srcs": [{"id":"089f6cae7ca77bb786578d3e0138b6ff445c5c92","type":"NODE"}] - }, - "type": "ABSTRACT_NODE" } } $ @@ -214,12 +213,12 @@ $ just-mr build add_person [...] $ just-mr build add_person INFO: Performing repositories setup -INFO: Found 23 repositories to set up +INFO: Found 23 repositories involved INFO: Setup finished, exec ["just","build","-C","...","add_person"] INFO: Requested target is [["@","","","add_person"],{}] INFO: Analysed target [["@","","","add_person"],{}] INFO: Export targets found: 2 cached, 0 uncached, 0 not eligible for caching -INFO: Discovered 5 actions, 2 trees, 0 blobs +INFO: Discovered 5 actions, 0 tree overlays, 2 trees, 0 blobs INFO: Building [["@","","","add_person"],{}]. INFO: Processed 5 actions, 5 cache hits. INFO: Artifacts built, logical paths are: @@ -235,14 +234,22 @@ replaced by `"..."` for clarity.) ``` sh $ just-mr analyse add_person --dump-actions - INFO: Performing repositories setup -INFO: Found 23 repositories to set up +INFO: Found 23 repositories involved INFO: Setup finished, exec ["just","analyse","-C","...","add_person","--dump-actions","-"] INFO: Requested target is [["@","","","add_person"],{}] INFO: Result of target [["@","","","add_person"],{}]: { "artifacts": { - "add_person": {"data":{"id":"6ba3552427c6c47b52bc2fa571a64af300e27243","path":"add_person"},"type":"ACTION"} + "add_person": {"data":{"id":"cb403cfeb7af26f83cb268056847f465d330ac44f7a563788305436b2640df2e","path":"work/add_person"},"type":"ACTION"} }, "provides": { + "debug-hdrs": { + }, + "debug-srcs": { + }, + "dwarf-pkg": { + }, + "lint": [ + ], "package": { "to_bin": true }, @@ -289,14 +296,22 @@ earlier. ``` sh $ just-mr analyse add_person --dump-targets - INFO: Performing repositories setup -INFO: Found 23 repositories to set up +INFO: Found 23 repositories involved INFO: Setup finished, exec ["just","analyse","-C","...","add_person","--dump-targets","-"] INFO: Requested target is [["@","","","add_person"],{}] INFO: Result of target [["@","","","add_person"],{}]: { "artifacts": { - "add_person": {"data":{"id":"6ba3552427c6c47b52bc2fa571a64af300e27243","path":"add_person"},"type":"ACTION"} + "add_person": {"data":{"id":"cb403cfeb7af26f83cb268056847f465d330ac44f7a563788305436b2640df2e","path":"work/add_person"},"type":"ACTION"} }, "provides": { + "debug-hdrs": { + }, + "debug-srcs": { + }, + "dwarf-pkg": { + }, + "lint": [ + ], "package": { "to_bin": true }, @@ -309,14 +324,14 @@ INFO: Result of target [["@","","","add_person"],{}]: { INFO: List of analysed targets: { "#": { - "eda46ea21de25033ff7250e6a4cdc0b2c24be0c7": { - "2a483a2de7f25c1bc066e47245f55ec9a2d4a719": [{"ADD_CFLAGS":null,"ADD_CXXFLAGS":null,"AR":null,"ARCH":null,"CC":null,"CFLAGS":null,"CXX":null,"CXXFLAGS":null,"DEBUG":null,"ENV":null,"HOST_ARCH":null,"OS":null,"PKG_CONFIG_ARGS":null,"PREFIX":null,"TARGET_ARCH":null,"TOOLCHAIN_CONFIG":null}] + "c4f68b96f739e96f894c5b498ab2b3f0bc62df120419094f867b1d5769f5e4fa": { + "6bcfb07e77f4d00f84d4c38bff64b92e0a1cf07399bd0987250eaef1b06b0b50": [{"ADD_CFLAGS":null,"ADD_CXXFLAGS":null,"AR":null,"ARCH":null,"CC":null,"CFLAGS":null,"CXX":null,"CXXFLAGS":null,"DEBUG":null,"ENV":null,"HOST_ARCH":null,"OS":null,"PKG_CONFIG_ARGS":null,"PREFIX":null,"TARGET_ARCH":null,"TOOLCHAIN_CONFIG":null}] } }, "@": { "": { "": { - "add_person": [{"ADD_CFLAGS":null,"ADD_CXXFLAGS":null,"ADD_LDFLAGS":null,"AR":null,"ARCH":null,"BUILD_POSITION_INDEPENDENT":null,"CC":null,"CFLAGS":null,"CXX":null,"CXXFLAGS":null,"DEBUG":null,"ENV":null,"HOST_ARCH":null,"LDFLAGS":null,"OS":null,"PKG_CONFIG_ARGS":null,"PREFIX":null,"TARGET_ARCH":null,"TOOLCHAIN_CONFIG":null}], + "add_person": [{"ADD_CFLAGS":null,"ADD_CXXFLAGS":null,"ADD_LDFLAGS":null,"AR":null,"ARCH":null,"BUILD_POSITION_INDEPENDENT":null,"CC":null,"CFLAGS":null,"CXX":null,"CXXFLAGS":null,"DEBUG":null,"DWP":null,"ENV":null,"HOST_ARCH":null,"LDFLAGS":null,"LINT":null,"OS":null,"PKG_CONFIG_ARGS":null,"PREFIX":null,"TARGET_ARCH":null,"TOOLCHAIN_CONFIG":null}], "address": [{}] } }, @@ -344,8 +359,8 @@ INFO: List of analysed targets: }, "rules-cc/just/toolchain": { "CC": { - "defaults": [{"ARCH":null,"HOST_ARCH":null,"OS":null,"TARGET_ARCH":null,"TOOLCHAIN_CONFIG":null}], - "unknown": [{"ARCH":null,"HOST_ARCH":null,"TARGET_ARCH":null}] + "defaults": [{"ARCH":null,"DEBUG":null,"HOST_ARCH":null,"OS":null,"TARGET_ARCH":null,"TOOLCHAIN_CONFIG":null}], + "unknown": [{"ARCH":null,"DEBUG":null,"HOST_ARCH":null,"TARGET_ARCH":null}] } } } @@ -371,7 +386,7 @@ purpose. ``` sh $ just-mr analyse 'address proto library' INFO: Performing repositories setup -INFO: Found 23 repositories to set up +INFO: Found 23 repositories involved INFO: Setup finished, exec ["just","analyse","-C","...","address proto library"] INFO: Requested target is [["@","","","address proto library"],{}] INFO: Result of target [["@","","","address proto library"],{}]: { @@ -381,16 +396,17 @@ INFO: Result of target [["@","","","address proto library"],{}]: { ... "compile-deps": { ... - "addressbook.pb.h": {"data":{"id":"b05ff2058068a30961c3e28318b9105795a08a42","path":"work/addressbook.pb.h"},"type":"ACTION"}, + "addressbook.pb.h": {"data":{"id":"bab5472beed7f032000d2d2cbf7d772c22c8c95cccdecbe70e73e9494ee34bf0","path":"work/addressbook.pb.h"},"type":"ACTION"}, ... }, + ... "link-args": [ "libaddressbook.a", ... ], "link-deps": { ... - "libaddressbook.a": {"data":{"id":"acc15c9c1218b4df277f49d537a3c4b961263490","path":"libaddressbook.a"},"type":"ACTION"}, + "libaddressbook.a": {"data":{"id":"fa60ded058e1fc7663b4b925a1274d1fe330bedb12c8785a7042e450ef17a7c1","path":"work/libaddressbook.a"},"type":"ACTION"}, ... }, ... @@ -446,39 +462,42 @@ targets and the one anonymous target is reused by both binaries. ``` sh $ just-mr analyse test --dump-targets - INFO: Performing repositories setup -INFO: Found 23 repositories to set up +INFO: Found 23 repositories involved INFO: Setup finished, exec ["just","analyse","-C","...","test","--dump-targets","-"] INFO: Requested target is [["@","","","test"],{}] INFO: Result of target [["@","","","test"],{}]: { "artifacts": { - "result": {"data":{"id":"e37a69e5d5213f53da5f1c2a42297c987732984f","path":"result"},"type":"ACTION"}, - "stderr": {"data":{"id":"e37a69e5d5213f53da5f1c2a42297c987732984f","path":"stderr"},"type":"ACTION"}, - "stdout": {"data":{"id":"e37a69e5d5213f53da5f1c2a42297c987732984f","path":"stdout"},"type":"ACTION"}, - "time-start": {"data":{"id":"e37a69e5d5213f53da5f1c2a42297c987732984f","path":"time-start"},"type":"ACTION"}, - "time-stop": {"data":{"id":"e37a69e5d5213f53da5f1c2a42297c987732984f","path":"time-stop"},"type":"ACTION"}, - "work/addressbook.data": {"data":{"id":"e37a69e5d5213f53da5f1c2a42297c987732984f","path":"work/addressbook.data"},"type":"ACTION"}, - "work/out.txt": {"data":{"id":"e37a69e5d5213f53da5f1c2a42297c987732984f","path":"work/out.txt"},"type":"ACTION"} + "pwd": {"data":{"id":"73744cdcd8be5082a6960ec0cf8c929d2a9cd0dd65860e3458901c49c8e4744f","path":"pwd"},"type":"ACTION"}, + "result": {"data":{"id":"73744cdcd8be5082a6960ec0cf8c929d2a9cd0dd65860e3458901c49c8e4744f","path":"result"},"type":"ACTION"}, + "stderr": {"data":{"id":"73744cdcd8be5082a6960ec0cf8c929d2a9cd0dd65860e3458901c49c8e4744f","path":"stderr"},"type":"ACTION"}, + "stdout": {"data":{"id":"73744cdcd8be5082a6960ec0cf8c929d2a9cd0dd65860e3458901c49c8e4744f","path":"stdout"},"type":"ACTION"}, + "time-start": {"data":{"id":"73744cdcd8be5082a6960ec0cf8c929d2a9cd0dd65860e3458901c49c8e4744f","path":"time-start"},"type":"ACTION"}, + "time-stop": {"data":{"id":"73744cdcd8be5082a6960ec0cf8c929d2a9cd0dd65860e3458901c49c8e4744f","path":"time-stop"},"type":"ACTION"}, + "work/addressbook.data": {"data":{"id":"73744cdcd8be5082a6960ec0cf8c929d2a9cd0dd65860e3458901c49c8e4744f","path":"work/addressbook.data"},"type":"ACTION"}, + "work/out.txt": {"data":{"id":"73744cdcd8be5082a6960ec0cf8c929d2a9cd0dd65860e3458901c49c8e4744f","path":"work/out.txt"},"type":"ACTION"} }, "provides": { + "lint": [ + ] }, "runfiles": { - "read-write-test": {"data":{"id":"71d9414c93b1bf4c2883af6070671761f9bc5cbf"},"type":"TREE"} + "read-write-test": {"data":{"id":"89bfa89b538549aa812415be625759872191d05315726828829848a87f86fa9f"},"type":"TREE"} } } INFO: List of analysed targets: { "#": { - "eda46ea21de25033ff7250e6a4cdc0b2c24be0c7": { - "2a483a2de7f25c1bc066e47245f55ec9a2d4a719": [{"ADD_CFLAGS":null,"ADD_CXXFLAGS":null,"AR":null,"ARCH":null,"CC":null,"CFLAGS":null,"CXX":null,"CXXFLAGS":null,"DEBUG":null,"ENV":null,"HOST_ARCH":null,"OS":null,"PKG_CONFIG_ARGS":null,"PREFIX":null,"TARGET_ARCH":null,"TOOLCHAIN_CONFIG":null}] + "c4f68b96f739e96f894c5b498ab2b3f0bc62df120419094f867b1d5769f5e4fa": { + "6bcfb07e77f4d00f84d4c38bff64b92e0a1cf07399bd0987250eaef1b06b0b50": [{"ADD_CFLAGS":null,"ADD_CXXFLAGS":null,"AR":null,"ARCH":null,"CC":null,"CFLAGS":null,"CXX":null,"CXXFLAGS":null,"DEBUG":null,"ENV":null,"HOST_ARCH":null,"OS":null,"PKG_CONFIG_ARGS":null,"PREFIX":null,"TARGET_ARCH":null,"TOOLCHAIN_CONFIG":null}] } }, "@": { "": { "": { - "add_person": [{"ADD_CFLAGS":null,"ADD_CXXFLAGS":null,"ADD_LDFLAGS":null,"AR":null,"ARCH":null,"BUILD_POSITION_INDEPENDENT":null,"CC":null,"CFLAGS":null,"CXX":null,"CXXFLAGS":null,"DEBUG":null,"ENV":null,"HOST_ARCH":null,"LDFLAGS":null,"OS":null,"PKG_CONFIG_ARGS":null,"PREFIX":null,"TARGET_ARCH":null,"TOOLCHAIN_CONFIG":null}], + "add_person": [{"ADD_CFLAGS":null,"ADD_CXXFLAGS":null,"ADD_LDFLAGS":null,"AR":null,"ARCH":null,"BUILD_POSITION_INDEPENDENT":null,"CC":null,"CFLAGS":null,"CXX":null,"CXXFLAGS":null,"DEBUG":null,"DWP":null,"ENV":null,"HOST_ARCH":null,"LDFLAGS":null,"LINT":null,"OS":null,"PKG_CONFIG_ARGS":null,"PREFIX":null,"TARGET_ARCH":null,"TOOLCHAIN_CONFIG":null}], "address": [{}], - "list_people": [{"ADD_CFLAGS":null,"ADD_CXXFLAGS":null,"ADD_LDFLAGS":null,"AR":null,"ARCH":null,"BUILD_POSITION_INDEPENDENT":null,"CC":null,"CFLAGS":null,"CXX":null,"CXXFLAGS":null,"DEBUG":null,"ENV":null,"HOST_ARCH":null,"LDFLAGS":null,"OS":null,"PKG_CONFIG_ARGS":null,"PREFIX":null,"TARGET_ARCH":null,"TOOLCHAIN_CONFIG":null}], - "test": [{"ADD_CFLAGS":null,"ADD_CXXFLAGS":null,"ADD_LDFLAGS":null,"AR":null,"ARCH":null,"ARCH_DISPATCH":null,"BUILD_POSITION_INDEPENDENT":null,"CC":null,"CFLAGS":null,"CXX":null,"CXXFLAGS":null,"DEBUG":null,"ENV":null,"HOST_ARCH":null,"LDFLAGS":null,"OS":null,"PKG_CONFIG_ARGS":null,"PREFIX":null,"RUNS_PER_TEST":null,"TARGET_ARCH":null,"TEST_ENV":null,"TIMEOUT_SCALE":null,"TOOLCHAIN_CONFIG":null}], + "list_people": [{"ADD_CFLAGS":null,"ADD_CXXFLAGS":null,"ADD_LDFLAGS":null,"AR":null,"ARCH":null,"BUILD_POSITION_INDEPENDENT":null,"CC":null,"CFLAGS":null,"CXX":null,"CXXFLAGS":null,"DEBUG":null,"DWP":null,"ENV":null,"HOST_ARCH":null,"LDFLAGS":null,"LINT":null,"OS":null,"PKG_CONFIG_ARGS":null,"PREFIX":null,"TARGET_ARCH":null,"TOOLCHAIN_CONFIG":null}], + "test": [{"ADD_CFLAGS":null,"ADD_CXXFLAGS":null,"ADD_LDFLAGS":null,"AR":null,"ARCH":null,"ARCH_DISPATCH":null,"BUILD_POSITION_INDEPENDENT":null,"CC":null,"CFLAGS":null,"CXX":null,"CXXFLAGS":null,"DEBUG":null,"DWP":null,"ENV":null,"HOST_ARCH":null,"LDFLAGS":null,"LINT":null,"OS":null,"PKG_CONFIG_ARGS":null,"PREFIX":null,"RUNS_PER_TEST":null,"TARGET_ARCH":null,"TEST_ENV":null,"TEST_SUMMARY_EXECUTION_PROPERTIES":null,"TIMEOUT_SCALE":null,"TOOLCHAIN_CONFIG":null}], "test.sh": [{}] } }, @@ -488,6 +507,9 @@ INFO: List of analysed targets: }, "CC/proto": { "defaults": [{"ADD_CFLAGS":null,"ADD_CXXFLAGS":null,"AR":null,"ARCH":null,"CC":null,"CFLAGS":null,"CXX":null,"CXXFLAGS":null,"DEBUG":null,"ENV":null,"HOST_ARCH":null,"OS":null,"PKG_CONFIG_ARGS":null,"PREFIX":null,"TARGET_ARCH":null,"TOOLCHAIN_CONFIG":null}] + }, + "shell": { + "defaults": [{"ARCH":null,"HOST_ARCH":null,"TARGET_ARCH":null}] } }, "rules-cc/just/protobuf": { @@ -506,8 +528,8 @@ INFO: List of analysed targets: }, "rules-cc/just/toolchain": { "CC": { - "defaults": [{"ARCH":null,"HOST_ARCH":null,"OS":null,"TARGET_ARCH":null,"TOOLCHAIN_CONFIG":null}], - "unknown": [{"ARCH":null,"HOST_ARCH":null,"TARGET_ARCH":null}] + "defaults": [{"ARCH":null,"DEBUG":null,"HOST_ARCH":null,"OS":null,"TARGET_ARCH":null,"TOOLCHAIN_CONFIG":null}], + "unknown": [{"ARCH":null,"DEBUG":null,"HOST_ARCH":null,"TARGET_ARCH":null}] } } } @@ -521,28 +543,29 @@ Finally, the test passes and the output is as expected. ``` sh $ just-mr build test -P work/out.txt INFO: Performing repositories setup -INFO: Found 23 repositories to set up +INFO: Found 23 repositories involved INFO: Setup finished, exec ["just","build","-C","...","test","-P","work/out.txt"] INFO: Requested target is [["@","","","test"],{}] INFO: Analysed target [["@","","","test"],{}] INFO: Export targets found: 2 cached, 0 uncached, 0 not eligible for caching INFO: Target tainted ["test"]. -INFO: Discovered 8 actions, 5 trees, 1 blobs +INFO: Discovered 8 actions, 0 tree overlays, 5 trees, 1 blobs INFO: Building [["@","","","test"],{}]. INFO: Processed 8 actions, 5 cache hits. INFO: Artifacts built, logical paths are: + pwd [9006e78b54c8f3118918d2d471c79745ffa0c8a0:311:f] result [7ef22e9a431ad0272713b71fdc8794016c8ef12f:5:f] stderr [e69de29bb2d1d6434b8b29ae775ad8c2e48c5391:0:f] stdout [7fab9dd1ee66a1e76a3697a27524f905600afbd0:196:f] - time-start [8e3614748ef049ea08bc49740d9ba55dfd42ef06:11:f] - time-stop [8e3614748ef049ea08bc49740d9ba55dfd42ef06:11:f] - work/addressbook.data [b673b647fbce717116104e84c335fdecaae974d6:41:f] - work/out.txt [ae02d08605d72d74bbfa72d33e4d314bb3632591:101:f] + time-start [0836c60e080d14176345259e32f65c1e14edfc49:11:f] + time-stop [0836c60e080d14176345259e32f65c1e14edfc49:11:f] + work/addressbook.data [036614cb6ec77ecf979729cbef3f22bd5ebd6a56:41:f] + work/out.txt [90ffe98823f628b92fe54b8c85f1754a9085c8db:101:f] (1 runfiles omitted.) Person ID: 12345 Name: John Doe E-mail address: jdoe@example.org - Updated: 2024-04-19T15:51:27Z + Updated: ... INFO: Target tainted ["test"]. $ ``` @@ -574,51 +597,49 @@ The debugging target can then be installed to a directory of our choosing. ``` sh $ just-mr install "list_people debug staged" -o .ext/debug INFO: Performing repositories setup -INFO: Found 23 repositories to set up +INFO: Found 23 repositories involved INFO: Setup finished, exec ["just","install","-C","...","list_people debug staged","-o",".ext/debug"] INFO: Requested target is [["@","","","list_people debug staged"],{}] INFO: Analysed target [["@","","","list_people debug staged"],{}] -INFO: Export targets found: 0 cached, 90 uncached, 0 not eligible for caching -INFO: Discovered 419 actions, 89 trees, 1 blobs +INFO: Export targets found: 0 cached, 98 uncached, 0 not eligible for caching +INFO: Discovered 447 actions, 0 tree overlays, 99 trees, 1 blobs INFO: Building [["@","","","list_people debug staged"],{}]. [...] -INFO: Processed 419 actions, 1 cache hits. +INFO: Processed 447 actions, 1 cache hits. INFO: Artifacts can be found in: - /tmp/tutorial/.ext/debug/bin/list_people [2cc2f0efa28327bdf7d49f5d2cafcc25c1693a4c:41761464:x] + /tmp/tutorial/.ext/debug/bin/list_people [71165d3aed4491169ed8bb8e783a9bbc15b9e9b6:46902576:x] /tmp/tutorial/.ext/debug/include/absl/algorithm/algorithm.h [59aeed7d264d927e44648428056cc9c489fad844:2190:f] - /tmp/tutorial/.ext/debug/include/absl/algorithm/container.h [c7bafae1477cf2bb88928b92d0248cb8a146814c:78387:f] + /tmp/tutorial/.ext/debug/include/absl/algorithm/container.h [6bbe3b5adf40b8a4bc48551f8e9f0af96dd98ace:80031:f] ... - /tmp/tutorial/.ext/debug/include/absl/types/variant.h [ac93464bf8d0f63f745b8461daa7698a91caf6f7:34055:f] - /tmp/tutorial/.ext/debug/include/absl/utility/utility.h [fc0d1f65516a3da1341f639577acb4fdab64fe0d:8711:f] - /tmp/tutorial/.ext/debug/include/addressbook.pb.h [964e2745b22e5920f291801db91f2c73ed5435ad:44427:f] - /tmp/tutorial/.ext/debug/include/google/protobuf/any.h [03ddf3f54386e158b1f2575c158f1106d7265a24:5302:f] - /tmp/tutorial/.ext/debug/include/google/protobuf/any.pb.h [b9c4ada87b05a3fdeef134e561d4ce010040728e:15844:f] + /tmp/tutorial/.ext/debug/include/absl/utility/utility.h [ebbb49b7159a3bcf2f1edbf9d44bd67dceb0329f:7646:f] + /tmp/tutorial/.ext/debug/include/addressbook.pb.h [f273099fe8d8345b1e61bdfa19751aefebe55869:46787:f] + /tmp/tutorial/.ext/debug/include/google/protobuf/any.h [fe8a1775c77b91fc08368833d70236509dde82b7:6127:f] + /tmp/tutorial/.ext/debug/include/google/protobuf/any.pb.h [67185ebca130f840ddacd687c59faceb523730e4:16787:f] /tmp/tutorial/.ext/debug/include/google/protobuf/any.proto [eff44e5099da27f7fb1ef14bb34902ccf4250b89:6154:f] ... - /tmp/tutorial/.ext/debug/include/google/protobuf/wrappers.pb.h [02819d3219fe8ffcaf67cee25b7a73ab6e934f24:69964:f] + /tmp/tutorial/.ext/debug/include/google/protobuf/wrappers.pb.h [0d85637aa1dadd86ccbc81a9563d54aba9eb9b3b:77623:f] /tmp/tutorial/.ext/debug/include/google/protobuf/wrappers.proto [1959fa55a4e7f284a9d6a78a447c5d89d137e87c:4044:f] - /tmp/tutorial/.ext/debug/include/utf8_validity.h [4a8d75b3b46d569526b9ae36814e71f1dab476d7:692:f] - /tmp/tutorial/.ext/debug/include/zconf.h [fb76ffe312ae45cf5d5d5e448f81e06fa79ab874:16682:f] - /tmp/tutorial/.ext/debug/include/zlib.h [6b7244f9943219c7b6e5a08d4913f2a15810d0c4:96778:f] + /tmp/tutorial/.ext/debug/include/utf8_range.h [d7c232616022bb28c8bc35ca62d61f890a2f8ced:540:f] + /tmp/tutorial/.ext/debug/include/utf8_validity.h [1f251d0fec0a2ae496335780d93a2869a1d7f743:712:f] + /tmp/tutorial/.ext/debug/include/zconf.h [62adc8d8431f2f9149ae0b1583915e21a28dd8b5:16500:f] + /tmp/tutorial/.ext/debug/include/zlib.h [8d4b932eaf6a0fbb8133b3ab49ba5ef587059fa0:96829:f] /tmp/tutorial/.ext/debug/work/absl/algorithm/algorithm.h [59aeed7d264d927e44648428056cc9c489fad844:2190:f] - /tmp/tutorial/.ext/debug/work/absl/algorithm/container.h [c7bafae1477cf2bb88928b92d0248cb8a146814c:78387:f] + /tmp/tutorial/.ext/debug/work/absl/algorithm/container.h [6bbe3b5adf40b8a4bc48551f8e9f0af96dd98ace:80031:f] ... - /tmp/tutorial/.ext/debug/work/absl/types/span.h [88cd75954084d0df6d774fc038f243fdc1140942:27228:f] - /tmp/tutorial/.ext/debug/work/absl/types/variant.h [ac93464bf8d0f63f745b8461daa7698a91caf6f7:34055:f] - /tmp/tutorial/.ext/debug/work/absl/utility/utility.h [fc0d1f65516a3da1341f639577acb4fdab64fe0d:8711:f] - /tmp/tutorial/.ext/debug/work/addressbook.pb.cc [b19ba7ad01dbf9c701f58b2b511845da2f0e8171:36687:f] - /tmp/tutorial/.ext/debug/work/addressbook.pb.h [964e2745b22e5920f291801db91f2c73ed5435ad:44427:f] + /tmp/tutorial/.ext/debug/work/absl/utility/utility.h [ebbb49b7159a3bcf2f1edbf9d44bd67dceb0329f:7646:f] + /tmp/tutorial/.ext/debug/work/addressbook.pb.cc [2261b2349a90b090d501c3c3c362e1efc783c218:46574:f] + /tmp/tutorial/.ext/debug/work/addressbook.pb.h [f273099fe8d8345b1e61bdfa19751aefebe55869:46787:f] ... - /tmp/tutorial/.ext/debug/work/google/protobuf/any.h [03ddf3f54386e158b1f2575c158f1106d7265a24:5302:f] - /tmp/tutorial/.ext/debug/work/google/protobuf/any.pb.h [b9c4ada87b05a3fdeef134e561d4ce010040728e:15844:f] + /tmp/tutorial/.ext/debug/work/google/protobuf/any.h [fe8a1775c77b91fc08368833d70236509dde82b7:6127:f] + /tmp/tutorial/.ext/debug/work/google/protobuf/any.pb.h [67185ebca130f840ddacd687c59faceb523730e4:16787:f] /tmp/tutorial/.ext/debug/work/google/protobuf/any.proto [eff44e5099da27f7fb1ef14bb34902ccf4250b89:6154:f] ... /tmp/tutorial/.ext/debug/work/list_people.cc [b309c596804739007510f06ff62c12898275fec7:2268:f] ... - /tmp/tutorial/.ext/debug/work/zlib.h [6b7244f9943219c7b6e5a08d4913f2a15810d0c4:96778:f] + /tmp/tutorial/.ext/debug/work/zlib.h [8d4b932eaf6a0fbb8133b3ab49ba5ef587059fa0:96829:f] /tmp/tutorial/.ext/debug/work/zutil.c [b1c5d2d3c6daf5a4b7a337dafe3e862ca177b41c:7179:f] - /tmp/tutorial/.ext/debug/work/zutil.h [902a304cc2d913d5548e0489c0c451790208c96f:7247:f] -INFO: Backing up artifacts of 90 export targets + /tmp/tutorial/.ext/debug/work/zutil.h [48dd7febae65eeeaad7794f0a9317bcd054c107f:6677:f] +INFO: Backing up artifacts of 98 export targets ``` As the command requires (re)building many targets in debug mode, some of the diff --git a/doc/tutorial/rebuild.md b/doc/tutorial/rebuild.md index dfbd9ff6..803260da 100644 --- a/doc/tutorial/rebuild.md +++ b/doc/tutorial/rebuild.md @@ -134,11 +134,11 @@ takes the action result from cache. $ touch ROOT $ just-mr build INFO: Performing repositories setup -INFO: Found 2 repositories to set up +INFO: Found 2 repositories involved INFO: Setup finished, exec ["just","build","-C","..."] INFO: Requested target is [["@","","",""],{}] INFO: Analysed target [["@","","",""],{}] -INFO: Discovered 6 actions, 1 trees, 0 blobs +INFO: Discovered 6 actions, 0 tree overlays, 1 trees, 0 blobs INFO: Building [["@","","",""],{}]. INFO: Processed 6 actions, 0 cache hits. INFO: Artifacts built, logical paths are: @@ -148,11 +148,11 @@ INFO: Artifacts built, logical paths are: $ sleep 1 $ just-mr build INFO: Performing repositories setup -INFO: Found 2 repositories to set up +INFO: Found 2 repositories involved INFO: Setup finished, exec ["just","build","-C","..."] INFO: Requested target is [["@","","",""],{}] INFO: Analysed target [["@","","",""],{}] -INFO: Discovered 6 actions, 1 trees, 0 blobs +INFO: Discovered 6 actions, 0 tree overlays, 1 trees, 0 blobs INFO: Building [["@","","",""],{}]. INFO: Processed 6 actions, 6 cache hits. INFO: Artifacts built, logical paths are: @@ -161,11 +161,11 @@ INFO: Artifacts built, logical paths are: share/hello/version.txt [de0d4f12aeb65c9e0a52909a07b0638e16e112fd:34:f] $ just-mr rebuild INFO: Performing repositories setup -INFO: Found 2 repositories to set up +INFO: Found 2 repositories involved INFO: Setup finished, exec ["just","rebuild","-C","..."] INFO: Requested target is [["@","","",""],{}] INFO: Analysed target [["@","","",""],{}] -INFO: Discovered 6 actions, 1 trees, 0 blobs +INFO: Discovered 6 actions, 0 tree overlays, 1 trees, 0 blobs INFO: Rebuilding [["@","","",""],{}]. WARN: Found flaky action: - id: 50e387d4d4c4dd9d8e6d08e1895c7dc729e5a4f3e7c7ad90cc93e373b5dea947 diff --git a/doc/tutorial/target-file-glob-tree.md b/doc/tutorial/target-file-glob-tree.md index 09b8db78..057f858e 100644 --- a/doc/tutorial/target-file-glob-tree.md +++ b/doc/tutorial/target-file-glob-tree.md @@ -78,11 +78,11 @@ with the empty object and refine it later. $ echo {} > TARGETS.units $ just-mr install -o . definitions.units INFO: Performing repositories setup -INFO: Found 4 repositories to set up +INFO: Found 4 repositories involved INFO: Setup finished, exec ["just","install","-C","...","-o",".","definitions.units"] INFO: Requested target is [["@","units","","definitions.units"],{}] INFO: Analysed target [["@","units","","definitions.units"],{}] -INFO: Discovered 0 actions, 0 trees, 0 blobs +INFO: Discovered 0 actions, 0 tree overlays, 0 trees, 0 blobs INFO: Building [["@","units","","definitions.units"],{}]. INFO: Processed 0 actions, 0 cache hits. INFO: Artifacts can be found in: @@ -132,17 +132,17 @@ their inputs) and, in fact, have a fixed command line. ``` sh $ just-mr analyse definitions.units --dump-actions - INFO: Performing repositories setup -INFO: Found 4 repositories to set up +INFO: Found 4 repositories involved INFO: Setup finished, exec ["just","analyse","-C","...","definitions.units","--dump-actions","-"] INFO: Requested target is [["@","units","","definitions.units"],{}] INFO: Result of target [["@","units","","definitions.units"],{}]: { "artifacts": { - "definitions.units": {"data":{"id":"ac620477c30dc79701cdda95ec97a06f12251b6f","path":"patched"},"type":"ACTION"} + "definitions.units": {"data":{"id":"25d6d534845e948a49064e394712e529b4f6bd915de19d5d42549dacfa60dc41","path":"patched"},"type":"ACTION"} }, "provides": { }, "runfiles": { - "definitions.units": {"data":{"id":"ac620477c30dc79701cdda95ec97a06f12251b6f","path":"patched"},"type":"ACTION"} + "definitions.units": {"data":{"id":"25d6d534845e948a49064e394712e529b4f6bd915de19d5d42549dacfa60dc41","path":"patched"},"type":"ACTION"} } } INFO: Actions for target [["@","units","","definitions.units"],{}]: @@ -188,11 +188,11 @@ Building `"definitions.units"` we find out that the patch applied correctly ``` sh $ just-mr build definitions.units -P definitions.units | grep -A 5 'German units' INFO: Performing repositories setup -INFO: Found 4 repositories to set up +INFO: Found 4 repositories involved INFO: Setup finished, exec ["just","build","-C","...","definitions.units","-P","definitions.units"] INFO: Requested target is [["@","units","","definitions.units"],{}] INFO: Analysed target [["@","units","","definitions.units"],{}] -INFO: Discovered 1 actions, 0 trees, 1 blobs +INFO: Discovered 1 actions, 0 tree overlays, 0 trees, 1 blobs INFO: Building [["@","units","","definitions.units"],{}]. INFO: Processed 1 actions, 0 cache hits. INFO: Artifacts built, logical paths are: @@ -224,19 +224,19 @@ and the output of the patch action. ``` sh $ just-mr analyse data-draft INFO: Performing repositories setup -INFO: Found 4 repositories to set up +INFO: Found 4 repositories involved INFO: Setup finished, exec ["just","analyse","-C","...","data-draft"] INFO: Requested target is [["@","units","","data-draft"],{}] INFO: Result of target [["@","units","","data-draft"],{}]: { "artifacts": { "currency.units": {"data":{"file_type":"f","id":"ac6da8afaac0f34e114e123e4ab3a41e59121b10","size":14707},"type":"KNOWN"}, - "definitions.units": {"data":{"id":"ac620477c30dc79701cdda95ec97a06f12251b6f","path":"patched"},"type":"ACTION"} + "definitions.units": {"data":{"id":"25d6d534845e948a49064e394712e529b4f6bd915de19d5d42549dacfa60dc41","path":"patched"},"type":"ACTION"} }, "provides": { }, "runfiles": { "currency.units": {"data":{"file_type":"f","id":"ac6da8afaac0f34e114e123e4ab3a41e59121b10","size":14707},"type":"KNOWN"}, - "definitions.units": {"data":{"id":"ac620477c30dc79701cdda95ec97a06f12251b6f","path":"patched"},"type":"ACTION"} + "definitions.units": {"data":{"id":"25d6d534845e948a49064e394712e529b4f6bd915de19d5d42549dacfa60dc41","path":"patched"},"type":"ACTION"} } } $ @@ -329,17 +329,17 @@ total, giving 5 compile and one link action. ``` sh $ just-mr build units-draft INFO: Performing repositories setup -INFO: Found 4 repositories to set up +INFO: Found 4 repositories involved INFO: Setup finished, exec ["just","build","-C","...","units-draft"] INFO: Requested target is [["@","units","","units-draft"],{}] INFO: Analysed target [["@","units","","units-draft"],{}] -INFO: Discovered 6 actions, 1 trees, 0 blobs +INFO: Discovered 6 actions, 0 tree overlays, 1 trees, 0 blobs INFO: Building [["@","units","","units-draft"],{}]. -INFO (action:f9426e7a0c3525618ead3787872e843c86f12dd2): - Stderr of command: ["cc","-I","work","-isystem","include","-c","work/strfunc.c","-o","work/strfunc.o"] - work/strfunc.c:109:8: warning: extra tokens at end of #endif directive [-Wendif-labels] - 109 | #endif NO_STRSPN - | ^~~~~~~~~ +INFO (action:a6adae74a8b50103a46700203f32e2286cec0a31ac41667b88d5b1ebe9b9860c): + Stderr of command ["cc","-I","work","-isystem","include","-c","work/strfunc.c","-o","work/strfunc.o"] in environment {"PATH":"/bin:/usr/bin"} + work/strfunc.c:109:8: warning: extra tokens at end of #endif directive [-Wendif-labels] + 109 | #endif NO_STRSPN + | ^~~~~~~~~ INFO: Processed 6 actions, 0 cache hits. INFO: Artifacts built, logical paths are: units [40cdc2a9fa6f06004bbf290014519ba21f122e7d:124488:x] @@ -354,11 +354,11 @@ a patch. ``` sh $ just-mr install -o . strfunc.c INFO: Performing repositories setup -INFO: Found 4 repositories to set up +INFO: Found 4 repositories involved INFO: Setup finished, exec ["just","install","-C","...","-o",".","strfunc.c"] INFO: Requested target is [["@","units","","strfunc.c"],{}] INFO: Analysed target [["@","units","","strfunc.c"],{}] -INFO: Discovered 0 actions, 0 trees, 0 blobs +INFO: Discovered 0 actions, 0 tree overlays, 0 trees, 0 blobs INFO: Building [["@","units","","strfunc.c"],{}]. INFO: Processed 0 actions, 0 cache hits. INFO: Artifacts can be found in: @@ -407,11 +407,11 @@ cache. ``` sh $ just-mr build units INFO: Performing repositories setup -INFO: Found 4 repositories to set up +INFO: Found 4 repositories involved INFO: Setup finished, exec ["just","build","-C","...","units"] INFO: Requested target is [["@","units","","units"],{}] INFO: Analysed target [["@","units","","units"],{}] -INFO: Discovered 7 actions, 1 trees, 1 blobs +INFO: Discovered 7 actions, 0 tree overlays, 1 trees, 1 blobs INFO: Building [["@","units","","units"],{}]. INFO: Processed 7 actions, 5 cache hits. INFO: Artifacts built, logical paths are: @@ -434,11 +434,11 @@ Then things work as expected ``` sh $ just-mr install -o /tmp/testinstall INFO: Performing repositories setup -INFO: Found 4 repositories to set up +INFO: Found 4 repositories involved INFO: Setup finished, exec ["just","install","-C","...","-o","/tmp/testinstall"] INFO: Requested target is [["@","units","",""],{}] INFO: Analysed target [["@","units","",""],{}] -INFO: Discovered 8 actions, 1 trees, 1 blobs +INFO: Discovered 8 actions, 0 tree overlays, 1 trees, 1 blobs INFO: Building [["@","units","",""],{}]. INFO: Processed 8 actions, 8 cache hits. INFO: Artifacts can be found in: diff --git a/doc/tutorial/third-party-software.md b/doc/tutorial/third-party-software.md index 0016f6b8..951a7cbb 100644 --- a/doc/tutorial/third-party-software.md +++ b/doc/tutorial/third-party-software.md @@ -212,12 +212,12 @@ repositories: ``` sh $ just-mr build helloworld INFO: Performing repositories setup -INFO: Found 5 repositories to set up +INFO: Found 5 repositories involved INFO: Setup finished, exec ["just","build","-C","...","helloworld"] INFO: Requested target is [["@","tutorial","","helloworld"],{}] INFO: Analysed target [["@","tutorial","","helloworld"],{}] INFO: Export targets found: 0 cached, 0 uncached, 1 not eligible for caching -INFO: Discovered 7 actions, 3 trees, 0 blobs +INFO: Discovered 7 actions, 0 tree overlays, 3 trees, 0 blobs INFO: Building [["@","tutorial","","helloworld"],{}]. INFO: Processed 7 actions, 1 cache hits. INFO: Artifacts built, logical paths are: @@ -231,12 +231,12 @@ repository `fmtlib` must be specified via the `--main` option: ``` sh $ just-mr --main fmtlib build fmt INFO: Performing repositories setup -INFO: Found 4 repositories to set up +INFO: Found 4 repositories involved INFO: Setup finished, exec ["just","build","-C","...","fmt"] INFO: Requested target is [["@","fmtlib","","fmt"],{}] INFO: Analysed target [["@","fmtlib","","fmt"],{}] INFO: Export targets found: 0 cached, 0 uncached, 1 not eligible for caching -INFO: Discovered 3 actions, 1 trees, 0 blobs +INFO: Discovered 3 actions, 0 tree overlays, 1 trees, 0 blobs INFO: Building [["@","fmtlib","","fmt"],{}]. INFO: Processed 3 actions, 3 cache hits. INFO: Artifacts built, logical paths are: @@ -260,8 +260,8 @@ versioning first: $ git init . $ git add tutorial-defaults fmt-layer $ git commit -m "fix compile flags and fmt targets layer" -[master (root-commit) 9c3a98b] fix compile flags and fmt targets layer - 4 files changed, 29 insertions(+) +[master (root-commit) 0337c65] fix compile flags and fmt targets layer + 4 files changed, 37 insertions(+) create mode 100644 fmt-layer/TARGETS create mode 100644 fmt-layer/include/fmt/TARGETS create mode 100644 fmt-layer/src/TARGETS @@ -326,12 +326,12 @@ the benefits of the target cache should be visible on the second build: ``` sh $ just-mr build helloworld INFO: Performing repositories setup -INFO: Found 5 repositories to set up +INFO: Found 5 repositories involved INFO: Setup finished, exec ["just","build","-C","...","helloworld"] INFO: Requested target is [["@","tutorial","","helloworld"],{}] INFO: Analysed target [["@","tutorial","","helloworld"],{}] INFO: Export targets found: 0 cached, 1 uncached, 0 not eligible for caching -INFO: Discovered 7 actions, 3 trees, 0 blobs +INFO: Discovered 7 actions, 0 tree overlays, 3 trees, 0 blobs INFO: Building [["@","tutorial","","helloworld"],{}]. INFO: Processed 7 actions, 7 cache hits. INFO: Artifacts built, logical paths are: @@ -340,12 +340,12 @@ INFO: Backing up artifacts of 1 export targets $ $ just-mr build helloworld INFO: Performing repositories setup -INFO: Found 5 repositories to set up +INFO: Found 5 repositories involved INFO: Setup finished, exec ["just","build","-C","...","helloworld"] INFO: Requested target is [["@","tutorial","","helloworld"],{}] INFO: Analysed target [["@","tutorial","","helloworld"],{}] INFO: Export targets found: 1 cached, 0 uncached, 0 not eligible for caching -INFO: Discovered 4 actions, 2 trees, 0 blobs +INFO: Discovered 4 actions, 0 tree overlays, 2 trees, 0 blobs INFO: Building [["@","tutorial","","helloworld"],{}]. INFO: Processed 4 actions, 4 cache hits. INFO: Artifacts built, logical paths are: |