Ninja exporter: C, C++, and multiple project types

Author: nickclark2016

contrib/mbedtls/Makefile

@@ -1,6 +1,14 @@
+--
+-- _manifest.lua
+-- Define the ninja manifest
+-- Author: Nick Clark
+-- Copyright (c) 2025 Jess Perkins and the Premake project
+--
+
+
 return {
-    "_preload.lua",
-    "ninja.lua",
-    'ninja_cpp.lua',
-    'ninja_workspace.lua',
+	"_preload.lua",
+	"ninja.lua",
+	'ninja_cpp.lua',
+	'ninja_workspace.lua',
 }

modules/ninja/_manifest.lua

@@ -2,71 +2,73 @@
 -- _preload.lua
 -- Define the ninja actions
 -- Author: Nick Clark
--- Copyright (c) Jess Perkins and the Premake project
+-- Copyright (c) 2025 Jess Perkins and the Premake project
 --
 
 local p = premake
 local project = p.project
+local getrelative = p.tools.getrelative
 
 newaction {
-    trigger     = "ninja",
-    shortname   = "Ninja",
-    description = "Generate Ninja build files",
+	trigger     = "ninja",
+	shortname   = "Ninja",
+	description = "Generate Ninja build files",
 
-    -- Action Capabilities
-    valid_kinds     = { "ConsoleApp", "WindowedApp", "StaticLib", "SharedLib", "None" },
-    valid_languages = { "C", "C++" },
-    valid_tools = {
-        cc = {
-            "gcc",
-            "clang",
-            "msc",
-            "emcc",
-            "cosmocc",
-        }
-    },
-    toolset = (function()
-        local target = os.target()
-        if target == p.MACOSX then
-            return "clang"
-        elseif target == p.EMSCRIPTEN then
-            return "emcc"
-        elseif target == p.WINDOWS then
-            return "v143"
-        else
-            return "gcc"
-        end
-    end)(),
+	-- Action Capabilities
+	valid_kinds     = { "ConsoleApp", "WindowedApp", "StaticLib", "SharedLib", "None" },
+	valid_languages = { "C", "C++" },
+	valid_tools = {
+		cc = {
+			"gcc",
+			"clang",
+			"msc",
+			"emcc",
+			"cosmocc",
+		}
+	},
+	toolset = (function()
+		local target = os.target()
+		if target == p.MACOSX then
+			return "clang"
+		elseif target == p.EMSCRIPTEN then
+			return "emcc"
+		elseif target == p.WINDOWS then
+			return "v143"
+		else
+			return "gcc"
+		end
+	end)(),
 
-    -- Workspace and project generation functions
-    onInitialize = function()
-        require("ninja")
-    end,
-    onWorkspace = function(wks)
-        p.escaper(p.modules.ninja.esc)
-        wks.projects = table.filter(wks.projects, function(prj)
-            return p.action.supports(prj.kind) and prj.kind ~= p.NONE
-        end)
-        p.generate(wks, p.modules.ninja.getninjafilename(wks, false), p.modules.ninja.wks.generate)
-    end,
-    onProject = function(prj)
-        p.escaper(p.modules.ninja.esc)
+	onInitialize = function()
+		require("ninja")
+	end,
+	onWorkspace = function(wks)
+		p.tools.getrelative = p.modules.ninja.getrelative
+		p.escaper(p.modules.ninja.esc)
+		wks.projects = table.filter(wks.projects, function(prj)
+			return p.action.supports(prj.kind) and prj.kind ~= p.NONE
+		end)
+		p.generate(wks, p.modules.ninja.getninjafilename(wks, false), p.modules.ninja.wks.generate)
+		p.tools.getrelative = getrelative
+	end,
+	onProject = function(prj)
+		p.tools.getrelative = p.modules.ninja.getrelative
+		p.escaper(p.modules.ninja.esc)
 
-        if not p.action.supports(prj.kind) or prj.kind == p.NONE then
-            return
-        end
+		if not p.action.supports(prj.kind) or prj.kind == p.NONE then
+			return
+		end
 
-        if project.isc(prj) or project.iscpp(prj) then
-            for cfg in project.eachconfig(prj) do
-                local filename = p.modules.ninja.getprjconfigfilename(cfg)
-                p.generate(prj, filename, p.modules.ninja.cpp.generate)
-            end
-        else
-            p.warn("Ninja does not support the '%s' language. No build file generated for project '%s'.", prj.language, prj.name)
-        end
-    end,
+		if project.isc(prj) or project.iscpp(prj) then
+			p.oven.assignObjectSequences(prj)
+			p.generate(prj, p.modules.ninja.getprjconfigfilename(prj), p.modules.ninja.cpp.generate)
+		else
+			p.warn("Ninja does not support the '%s' language. No build file generated for project '%s'.", prj.language, prj.name)
+		end
+		p.tools.getrelative = getrelative
+	end,
 }
 
 return function(cfg)
-    return (_ACTION == "ninja")
+	return (_ACTION == "ninja")
 end

modules/ninja/_preload.lua

@@ -2,7 +2,7 @@
 -- ninja.lua
 -- Utilities for generating Ninja build files
 -- Author: Nick Clark
--- Copyright (c) Jess Perkins and the Premake project
+-- Copyright (c) 2025 Jess Perkins and the Premake project
 --
 
 local p = premake
@@ -14,12 +14,18 @@ local ninja = p.modules.ninja
 
 --
 -- Escape a string so it can be written to a Ninja build file.
+-- Ninja variables are expanded into shell commands, so we need to escape
+-- shell special characters as well as Ninja special characters.
 --
 function ninja.esc(value)
     value = value:gsub("%$", "$$")
     value = value:gsub(":", "$:")
     value = value:gsub("\n", "$\n")
     value = value:gsub(" ", "$ ")
+    value = value:gsub('%(', '\\(')
+    value = value:gsub('%)', '\\)')
+    value = value:gsub('"', '\\"')
+    
     return value
 end
 
@@ -32,15 +38,16 @@ end
 
 function ninja.key(cfg)
     local name = cfg.project.name
+    local buildcfg = cfg.buildcfg
     if cfg.platform then
-        return name .. "_" .. cfg.buildcfg .. "_" .. cfg.platform
+        return name .. "_" .. (buildcfg or "") .. "_" .. cfg.platform
     else
-        return name .. "_" .. cfg.buildcfg
+        return name .. (buildcfg and ("_" .. buildcfg) or "")
     end
 end
 
-function ninja.getprjconfigfilename(cfg)
-    return ninja.key(cfg) .. ".ninja"
+function ninja.getprjconfigfilename(prj)
+    return prj.name .. ".ninja"
 end
 
 function ninja.getninjafilename(target, searchprjs)
@@ -62,7 +69,7 @@ function ninja.getninjafilename(target, searchprjs)
     if count == 1 then
         return "build.ninja"
     else
-        return ".ninja"
+        return target.name .. ".ninja"
     end
 end
 
@@ -75,6 +82,36 @@ function ninja.gettoolset(cfg)
     return toolset
 end
 
+function ninja.list(value)
+    if #value > 0 then
+        return " " .. table.concat(value, " ")
+    else
+        return ""
+    end
+end
+
+-- Override tools.getrelative to use workspace-relative paths for Ninja
+-- Ninja builds are always executed from the workspace root, so all paths
+-- must be relative to the workspace, not the project
+function ninja.getrelative(prj, value)
+    if type(value) == "table" then
+        local result = {}
+        for i, name in ipairs(value) do
+            result[i] = ninja.getrelative(prj, name)
+        end
+        return result
+    else
+        if value then
+            local result = value
+            if path.hasdeferredjoin(result) then
+                result = path.resolvedeferredjoin(result)
+            end
+            -- Use workspace location instead of project location for Ninja
+            return path.getrelative(prj.workspace.location, result)
+        end
+    end
+end
+
 include("ninja_cpp.lua")
 include("ninja_workspace.lua")