Trace:

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
how [2022/02/25 18:29] – devahow [2022/02/26 12:52] (current) – deva
Line 7: Line 7:
   * ''std::thread::hardware_concurrency()'' for automatic ''-jn'' deduction   * ''std::thread::hardware_concurrency()'' for automatic ''-jn'' deduction
   * ''gcc -MMD'' for dependency tracking   * ''gcc -MMD'' for dependency tracking
-  * trixy self-re-invoke (after re-compilation) when configuration files change. +  * ''configure'' target
-    * tree of self-dependency weirdness +
-  * configure target+
     * cross-compilation and tool-chain control     * cross-compilation and tool-chain control
 +  * trixy self-re-invoke (after re-compilation) when configuration files change.
 +    * tree of self-dependency weirdness:
 +        * <code>main()
 +2    if configure arg call configure(args), exit
 +4    if reconfigure arg call reconfigure(args), exit
 +1,3  other rebuildCheck
 +1    build dirty project sources...
 +
 +configure(args)
 +  collect (relevant) env vars in map: A
 + collect (relevant) cli args in map: B
 +  call generateCache(A, B)
 +  then call rebuildCheck to force rebuild and then exit
 +
 +reconfigure(args)
 +  read A and B from (current) config cache and call generateCache(A, B) to
 + generate a new one
 +  then call rebuildCheck to rebuild and then exit
 +
 +rebuildCheck()
 +  check if rebuild is needed (if any ctor.cc files or configuration.cc changed):
 +   rebuild
 + if !"only configuration.cc changed" re-run, with "reconfigure" argument
 +
 +generateCache(A, B)
 +  resolv tool-chain (compiler, linker, etc) and store in map: C
 +  run through externals and resolv them, store results in map: D
 + generate config cache .cc file with A, B, C and D
 +Scenarios:
 +
 +1. No ctor deps changed (normal run)
 +   rebuild dirty project sources.
 + OK
 +
 +2. a new configuration.cc has been generated (user called configure)
 +   regenerate cache
 + * rebuild
 + OK
 +
 +3. one or more ctor.cc files changed (run with args)
 + * rebuild
 +   relaunch with 'reconfigure' with args (goto 4)
 + OK
 +
 +4. run with reconfigure (with other args)
 +   "ignore" args but keep them for later
 +   regenerate cache
 + * rebuild
 +   relauch with "other args" (goto 1)
 + OK
 +</code>
 +  * independent target compilation (with dependency deduction)
 +  * ''clean'' target
   * bootstrapping (yes - libctor compiles itself)   * bootstrapping (yes - libctor compiles itself)
-  * unit tests +  * ''check'' target, for unit test compilation and execution 
-  * compilation-database (json) +  * compilation-database (json) for c-lion and others 
-  * future: + 
-    * external dependency deduction +  * currently working on: 
-    * compilation configuration control through configure target (ala ''--with-foo''/''--enable-bar'' from autotools) +    * external dependency flags with ''std::variant'' 
-    * install target +        * manual dependency 
-    * ''DESTDIR'' support+        * automatic dependency deduction through searches 
 + 
 +  * future work: 
 +    * more external dependency variants: 
 +        * pkg-config 
 +        * conan 
 +    * pre-/postbuild actions with conditions 
 +    * globbing 
 +    * custom target generation through external application (generators) 
 +    * lambda functions as generators 
 +    * custom compilation configuration control through ''configure'' target (like ''--with-X''/''--enable-Y'' in autotools) 
 +    * ''install'' target with ''PREFIX'' and ''DESTDIR'' support
     * documentation :-)     * documentation :-)