Add addons examples

tests/projects/addons/description_api/addon/addon.lua

@@ -0,0 +1,3 @@
+addon("example-description-api")
+    set_description("The standalone description api example.")
+    set_license("Apache-2.0")

tests/projects/addons/description_api/addon/includes/apis/xmake.lua

@@ -0,0 +1,2 @@
+interp_add_scopeapis("example_profile.set_message", "example_profile.add_tags", {kind = "values"})
+interp_add_scopeapis("target.set_example_profile", {kind = "values"})

tests/projects/addons/description_api/addon/rules/message/xmake.lua

@@ -0,0 +1,10 @@
+rule("message")
+    on_config(function (target)
+        import("core.project.project")
+        local profiles = project.scope("example_profile")
+        local name = target:get("example_profile")
+        local profile = assert(profiles and profiles[name], "unknown example profile: %s", name)
+        local message = assert(profile:get("message"), "the example profile needs a message")
+        target:add("defines", 'EXAMPLE_MESSAGE="' .. message .. '"')
+        target:add("defines", "EXAMPLE_TAG_COUNT=" .. #table.wrap(profile:get("tags")))
+    end)

tests/projects/addons/description_api/repo/addons/e/example-description-api/xmake.lua

@@ -0,0 +1,6 @@
+package("example-description-api")
+    set_kind("addon")
+    set_description("The standalone description api example.")
+    set_license("Apache-2.0")
+
+    set_sourcedir(path.join(os.scriptdir(), "../../../../addon"))

tests/projects/addons/description_api/src/main.c

@@ -0,0 +1,10 @@
+#include <stdio.h>
+
+#ifndef EXAMPLE_MESSAGE
+#error The addon rule must supply EXAMPLE_MESSAGE.
+#endif
+
+int main(void) {
+    printf("%s (%d tags)\n", EXAMPLE_MESSAGE, EXAMPLE_TAG_COUNT);
+    return 0;
+}

tests/projects/addons/description_api/xmake.lua

@@ -0,0 +1,16 @@
+add_repositories("example-description-api-repo ./repo", {rootdir = os.scriptdir()})
+add_addons("example-description-api")
+includes("@addon/example-description-api/apis")
+
+-- Skip addon APIs during the first scan, before automatic installation.
+if example_profile then
+    example_profile("demo")
+        set_message("hello from a custom scope")
+        add_tags("portable", "reusable")
+
+    target("hello")
+        set_kind("binary")
+        add_files("src/main.c")
+        set_example_profile("demo")
+        add_rules("@addon/example-description-api/message")
+end

tests/projects/addons/functions/addon/addon.lua

@@ -0,0 +1,3 @@
+addon("example-functions")
+    set_description("The standalone functions example.")
+    set_license("Apache-2.0")

tests/projects/addons/functions/addon/includes/targets/xmake.lua

@@ -0,0 +1,9 @@
+function example_console(name, ...)
+    interp_save_scope()
+    target(name)
+        set_kind("binary")
+        add_files(...)
+        set_warnings("all")
+    target_end()
+    interp_restore_scope()
+end

tests/projects/addons/functions/repo/addons/e/example-functions/xmake.lua

@@ -0,0 +1,6 @@
+package("example-functions")
+    set_kind("addon")
+    set_description("The standalone functions example.")
+    set_license("Apache-2.0")
+
+    set_sourcedir(path.join(os.scriptdir(), "../../../../addon"))

tests/projects/addons/functions/src/main.c

@@ -0,0 +1,6 @@
+#include <stdio.h>
+
+int main(void) {
+    printf("description function: %d\n", EXAMPLE_NUMBER);
+    return 0;
+}

tests/projects/addons/functions/xmake.lua

@@ -0,0 +1,11 @@
+add_repositories("example-functions-repo ./repo", {rootdir = os.scriptdir()})
+add_addons("example-functions")
+includes("@addon/example-functions/targets")
+
+-- Skip addon APIs during the first scan, before automatic installation.
+if example_console then
+    example_console("hello", "src/main.c")
+
+    target("hello")
+        add_defines("EXAMPLE_NUMBER=42")
+end

tests/projects/addons/includes/addon/addon.lua

@@ -0,0 +1,3 @@
+addon("example-includes")
+    set_description("The standalone includes example.")
+    set_license("Apache-2.0")

tests/projects/addons/includes/addon/includes/options/xmake.lua

@@ -0,0 +1,5 @@
+option("example_verbose")
+    set_default(true)
+    set_showmenu(true)
+    set_description("Enable the example's verbose greeting.")
+option_end()

tests/projects/addons/includes/repo/addons/e/example-includes/xmake.lua

@@ -0,0 +1,6 @@
+package("example-includes")
+    set_kind("addon")
+    set_description("The standalone includes example.")
+    set_license("Apache-2.0")
+
+    set_sourcedir(path.join(os.scriptdir(), "../../../../addon"))

tests/projects/addons/includes/src/main.c

@@ -0,0 +1,10 @@
+#include <stdio.h>
+
+int main(void) {
+#ifdef EXAMPLE_VERBOSE
+    puts("includes: verbose");
+#else
+    puts("includes: quiet");
+#endif
+    return 0;
+}

tests/projects/addons/includes/xmake.lua

@@ -0,0 +1,14 @@
+add_repositories("example-includes-repo ./repo", {rootdir = os.scriptdir()})
+add_addons("example-includes")
+includes("@addon/example-includes/options")
+
+add_rules("mode.debug", "mode.release")
+
+target("hello")
+    set_kind("binary")
+    add_files("src/main.c")
+    on_config(function (target)
+        if has_config("example_verbose") then
+            target:add("defines", "EXAMPLE_VERBOSE")
+        end
+    end)

tests/projects/addons/modules/addon/addon.lua

@@ -0,0 +1,3 @@
+addon("example-modules")
+    set_description("The standalone modules example.")
+    set_license("Apache-2.0")

tests/projects/addons/modules/addon/modules/greeting.lua

@@ -0,0 +1,3 @@
+function main(name)
+    return "addon module: hello " .. name
+end

tests/projects/addons/modules/repo/addons/e/example-modules/xmake.lua

@@ -0,0 +1,5 @@
+package("example-modules")
+    set_kind("addon")
+    set_description("The standalone modules example.")
+    set_license("Apache-2.0")
+    set_sourcedir(path.join(os.scriptdir(), "../../../../addon"))

tests/projects/addons/modules/xmake.lua

@@ -0,0 +1,9 @@
+add_repositories("example-modules-repo ./repo", {rootdir = os.scriptdir()})
+add_addons("example-modules")
+
+target("hello")
+    set_kind("phony")
+    on_run(function ()
+        import("@addon.example-modules.greeting")
+        print(greeting("xmake"))
+    end)

tests/projects/addons/plugins/addon/addon.lua

@@ -0,0 +1,3 @@
+addon("example-plugins")
+    set_description("The standalone plugins example.")
+    set_license("Apache-2.0")

tests/projects/addons/plugins/addon/plugins/example_greet/main.lua

@@ -0,0 +1,5 @@
+import("core.base.option")
+
+function main()
+    print("addon plugin: hello %s", option.get("name"))
+end

tests/projects/addons/plugins/addon/plugins/example_greet/xmake.lua

@@ -0,0 +1,8 @@
+task("example_greet")
+    set_category("plugin")
+    set_menu {
+        usage = "xmake example_greet [options]",
+        description = "Greet someone from the example addon.",
+        options = {{'n', "name", "kv", "world", "Set the name."}}
+    }
+    on_run("main")

tests/projects/addons/plugins/repo/addons/e/example-plugins/xmake.lua

@@ -0,0 +1,5 @@
+package("example-plugins")
+    set_kind("addon")
+    set_description("The standalone plugins example.")
+    set_license("Apache-2.0")
+    set_sourcedir(path.join(os.scriptdir(), "../../../../addon"))

tests/projects/addons/plugins/xmake.lua

@@ -0,0 +1,5 @@
+add_repositories("example-plugins-repo ./repo", {rootdir = os.scriptdir()})
+add_addons("example-plugins")
+
+target("bootstrap")
+    set_kind("phony")

tests/projects/addons/rules_modules/addon/addon.lua

@@ -0,0 +1,3 @@
+addon("example-rules-modules")
+    set_description("The standalone rules modules example.")
+    set_license("Apache-2.0")

tests/projects/addons/rules_modules/addon/modules/greeting.lua

@@ -0,0 +1,7 @@
+function message(name)
+    return "addon module: hello " .. name
+end
+
+function define()
+    return "EXAMPLE_NUMBER=42"
+end

tests/projects/addons/rules_modules/addon/rules/message/xmake.lua

@@ -0,0 +1,5 @@
+rule("message")
+    on_load(function (target)
+        import("@self.greeting")
+        target:add("defines", greeting.define())
+    end)

tests/projects/addons/rules_modules/repo/addons/e/example-rules-modules/xmake.lua

@@ -0,0 +1,6 @@
+package("example-rules-modules")
+    set_kind("addon")
+    set_description("The standalone rules modules example.")
+    set_license("Apache-2.0")
+
+    set_sourcedir(path.join(os.scriptdir(), "../../../../addon"))

tests/projects/addons/rules_modules/src/main.c

@@ -0,0 +1,6 @@
+#include <stdio.h>
+
+int main(void) {
+    printf("addon rule: %d\n", EXAMPLE_NUMBER);
+    return 0;
+}

tests/projects/addons/rules_modules/xmake.lua

@@ -0,0 +1,12 @@
+add_repositories("example-rules-modules-repo ./repo", {rootdir = os.scriptdir()})
+add_addons("example-rules-modules")
+
+target("hello")
+    set_kind("binary")
+    add_files("src/main.c")
+    add_rules("@addon/example-rules-modules/message")
+    on_run(function (target)
+        import("@addon.example-rules-modules.greeting")
+        print(greeting.message(target:name()))
+        os.execv(target:targetfile())
+    end)

tests/projects/addons/templates/addon/addon.lua

@@ -0,0 +1,3 @@
+addon("example-templates")
+    set_description("The standalone templates example.")
+    set_license("Apache-2.0")

tests/projects/addons/templates/addon/templates/c/example-addon/console/src/main.c

@@ -0,0 +1,6 @@
+#include <stdio.h>
+
+int main(void) {
+    puts("hello from the addon template");
+    return 0;
+}

tests/projects/addons/templates/addon/templates/c/example-addon/console/xmake.lua

@@ -0,0 +1,5 @@
+add_rules("mode.debug", "mode.release")
+
+target("${TARGET_NAME}")
+    set_kind("binary")
+    add_files("src/main.c")

tests/projects/addons/templates/repo/addons/e/example-templates/xmake.lua

@@ -0,0 +1,5 @@
+package("example-templates")
+    set_kind("addon")
+    set_description("The standalone templates example.")
+    set_license("Apache-2.0")
+    set_sourcedir(path.join(os.scriptdir(), "../../../../addon"))

tests/projects/addons/templates/xmake.lua

@@ -0,0 +1,5 @@
+add_repositories("example-templates-repo ./repo", {rootdir = os.scriptdir()})
+add_addons("example-templates")
+
+target("bootstrap")
+    set_kind("phony")

tests/projects/addons/toolchains/addon/addon.lua

@@ -0,0 +1,3 @@
+addon("example-toolchains")
+    set_description("The standalone toolchains example.")
+    set_license("Apache-2.0")

tests/projects/addons/toolchains/addon/toolchains/settings/xmake.lua

@@ -0,0 +1,5 @@
+toolchain("settings")
+    set_kind("binary")
+    on_load(function (toolchain)
+        toolchain:add("defines", "EXAMPLE_TOOLCHAIN=42")
+    end)

tests/projects/addons/toolchains/repo/addons/e/example-toolchains/xmake.lua

@@ -0,0 +1,5 @@
+package("example-toolchains")
+    set_kind("addon")
+    set_description("The standalone toolchains example.")
+    set_license("Apache-2.0")
+    set_sourcedir(path.join(os.scriptdir(), "../../../../addon"))

tests/projects/addons/toolchains/src/main.c

@@ -0,0 +1,10 @@
+#include <stdio.h>
+
+#ifndef EXAMPLE_TOOLCHAIN
+#error The addon toolchain must supply EXAMPLE_TOOLCHAIN.
+#endif
+
+int main(void) {
+    printf("addon toolchain: %d\n", EXAMPLE_TOOLCHAIN);
+    return 0;
+}

tests/projects/addons/toolchains/xmake.lua

@@ -0,0 +1,7 @@
+add_repositories("example-toolchains-repo ./repo", {rootdir = os.scriptdir()})
+add_addons("example-toolchains")
+
+target("hello")
+    set_kind("binary")
+    add_files("src/main.c")
+    add_toolchains("@addon/example-toolchains/settings")