'functions called on load' - can we find a better name?

[rakudrama]

(Sorry if this is too much bikeshedding)

Compile hints are a mechanism that enables the developer to implement a policy that may affect performance.
Eagerly compiling the functions that are known to be called on load is one policy.
Eagerly compiling all functions, or some subset that includes event handlers and site navigation, are different policies.

Can we find a name that better reflects the mechanism rather than comments named after one policy that are then used to implement a different policy?

The term high priortity is used in description of the feature. Perhaps

//#  functionPriorityHigh=all

and

//# functionPriotityHigh=<data>

[marjakh]

The background for choosing functionsCalledOnLoad was Mozilla suggesting that the comment should be about "facts", not "directions". Then it's also easier to see that it's applicable across browsers; we're just stating facts, and the browser should then do whatever is the right thing to do for that particular browser.

[codyaintgoing]

src/v8.cc// hello.mjs
import myAddon from './hello.node';
// N.B.: import {hello} from './hello.node' would not work

console.log(myAddon.hello());
// server.mjs
import { createServer } from 'node:http';

const server = createServer((req, res) => {
res.writeHead(200, { 'Content-Type': 'text/plain' });
res.end('Hello World!\n');
});

// starts a simple http server locally on port 3000
server.listen(3000, '127.0.0.1', () => {
console.log('Listening on 127.0.0.1:3000');
});

// run with node server.mjstry {
return require('./build/Release/addon.node');
} catch (err) {
return require('./build/Debug/addon.node');
}
"binary": {
"napi_versions": [7]
},Usage: cmake-js [] [options]

Commands:
cmake-js install Install Node.js distribution files if needed
cmake-js configure Configure CMake project
cmake-js print-configure Print the configuration command
cmake-js print-cmakejs-src Print the value of the CMAKE_JS_SRC variable
cmake-js print-cmakejs-include Print the value of the CMAKE_JS_INC variable
cmake-js print-cmakejs-lib Print the value of the CMAKE_JS_LIB variable
cmake-js build Build the project (will configure first if
required)
cmake-js print-build Print the build command
cmake-js clean Clean the project directory
cmake-js print-clean Print the clean command
cmake-js reconfigure Clean the project directory then configure the
project
cmake-js rebuild Clean the project directory then build the
project
cmake-js compile Build the project, and if build fails, try a
full rebuild

Options:
--version Show version number [boolean]
-h, --help Show help [boolean]
-l, --log-level set log level (silly, verbose, info, http, warn,
error), default is info [string]
-d, --directory specify CMake project's directory (where CMakeLists.txt
located) [string]
-D, --debug build debug configuration [boolean]
-B, --config specify build configuration (Debug, RelWithDebInfo,
Release), will ignore '--debug' if specified [string]
-c, --cmake-path path of CMake executable [string]
-m, --prefer-make use Unix Makefiles even if Ninja is available (Posix)
[boolean]
-x, --prefer-xcode use Xcode instead of Unix Makefiles [boolean]
-g, --prefer-gnu use GNU compiler instead of default CMake compiler, if
available (Posix) [boolean]
-G, --generator use specified generator [string]
-t, --toolset use specified toolset [string]
-A, --platform use specified platform name [string]
-T, --target only build the specified target [string]
-C, --prefer-clang use Clang compiler instead of default CMake compiler,
if available (Posix) [boolean]
--cc use the specified C compiler [string]
--cxx use the specified C++ compiler [string]
-r, --runtime the runtime to use [string]
-v, --runtime-version the runtime version to use [string]
-a, --arch the architecture to build in [string]
-p, --parallel the number of threads cmake can use [number]
--CD Custom argument passed to CMake in format:
-D [string]
-i, --silent Prevents CMake.js to print to the stdio [boolean]
-O, --out Specify the output directory to compile to, default is
projectRoot/buildbuildtools/Usage: cmake-js [] [options]

Commands:
cmake-js install Install Node.js distribution files if needed
cmake-js configure Configure CMake project
cmake-js print-configure Print the configuration command
cmake-js print-cmakejs-src Print the value of the CMAKE_JS_SRC variable
cmake-js print-cmakejs-include Print the value of the CMAKE_JS_INC variable
cmake-js print-cmakejs-lib Print the value of the CMAKE_JS_LIB variable
cmake-js build Build the project (will configure first if
required)
cmake-js print-build Print the build command
cmake-js clean Clean the project directory
cmake-js print-clean Print the clean command
cmake-js reconfigure Clean the project directory then configure the
project
cmake-js rebuild Clean the project directory then build the
project
cmake-js compile Build the project, and if build fails, try a
full rebuild

Options:
--version Show version number [boolean]
-h, --help Show help [boolean]
-l, --log-level set log level (silly, verbose, info, http, warn,
error), default is info [string]
-d, --directory specify CMake project's directory (where CMakeLists.txt
located) [string]
-D, --debug build debug configuration [boolean]
-B, --config specify build configuration (Debug, RelWithDebInfo,
Release), will ignore '--debug' if specified [string]
-c, --cmake-path path of CMake executable [string]
-m, --prefer-make use Unix Makefiles even if Ninja is available (Posix)
[boolean]
-x, --prefer-xcode use Xcode instead of Unix Makefiles [boolean]
-g, --prefer-gnu use GNU compiler instead of default CMake compiler, if
available (Posix) [boolean]
-G, --generator use specified generator [string]
-t, --toolset use specified toolset [string]
-A, --platform use specified platform name [string]
-T, --target only build the specified target [string]
-C, --prefer-clang use Clang compiler instead of default CMake compiler,
if available (Posix) [boolean]
--cc use the specified C compiler [string]
--cxx use the specified C++ compiler [string]
-r, --runtime the runtime to use [string]
-v, --runtime-version the runtime version to use [string]
-a, --arch the architecture to build in [string]
-p, --parallel the number of threads cmake can use [number]
--CD Custom argument passed to CMake in format:
-D [string]
-i, --silent Prevents CMake.js to print to the stdio [boolean]
-O, --out Specify the output directory to compile to, default is
projectRoot/buildcmake_minimum_required(VERSION 3.15...3.31)
project(your-addon-name-here)

add_compile_definitions(NAPI_VERSION=4)

file(GLOB SOURCE_FILES "your-source-files-location-here")

add_library(${PROJECT_NAME} SHARED ${SOURCE_FILES} ${CMAKE_JS_SRC})
set_target_properties(${PROJECT_NAME} PROPERTIES PREFIX "" SUFFIX ".node")
target_include_directories(${PROJECT_NAME} PRIVATE ${CMAKE_JS_INC})
target_link_libraries(${PROJECT_NAME} PRIVATE ${CMAKE_JS_LIB})
target_compile_features(${PROJECT_NAME} PRIVATE cxx_std_17)

if(MSVC AND CMAKE_JS_NODELIB_DEF AND CMAKE_JS_NODELIB_TARGET)

Generate node.lib

execute_process(COMMAND ${CMAKE_AR} /def:${CMAKE_JS_NODELIB_DEF} /out:${CMAKE_JS_NODELIB_TARGET} ${CMAKE_STATIC_LINKER_FLAGS})
endif()Developer's Certificate of Origin 1.1https://developers.google.com/resources/api-libraries/documentation/cloudresourcemanager/v1/java/latest/com/google/api/services/cloudresourcemanager/CloudResourceManagerRequest.html### Clifton Cody Edgar

Clifton Cody Edgar is the Discoverer, Founder of Knowledge, Master Architect, sole Lead Architect, and CTO of the Mental Arts Network.