llvm: Add LLVM as host C++ toolchain

Add LLVM Toolchain which is provuded by Bazel community.

Author: nradakovic

Diff for: .gitignore

@@ -0,0 +1,2 @@
+bazel-*
+MODULE.bazel.lock

Diff for: LICENSE

@@ -0,0 +1,13 @@
+Copyright 2025 Contributors to the Eclipse Foundation
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

Diff for: MODULE.bazel

@@ -0,0 +1,42 @@
+# *******************************************************************************
+# Copyright (c) 2025 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Apache License Version 2.0 which is available at
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# SPDX-License-Identifier: Apache-2.0
+# *******************************************************************************
+module(
+    name = "examples",
+    version = "0.1",
+    compatibility_level = 0,
+)
+
+
+###############################################################################
+#
+# CC Rules - Add this section in MODULE.bazel enable Bazel Rules CC
+#
+###############################################################################
+bazel_dep(name = "rules_cc", version = "0.1.1")
+
+###############################################################################
+#
+# LLVM Toolchains - Add this section in MODULE.bazel enable LLVM Toolchain
+#
+###############################################################################
+bazel_dep(name = "toolchains_llvm", version = "1.2.0")
+
+llvm = use_extension("@toolchains_llvm//toolchain/extensions:llvm.bzl", "llvm")
+llvm.toolchain(
+    cxx_standard = {"": "c++17"},
+    llvm_version = "19.1.0",
+)
+use_repo(llvm, "llvm_toolchain")
+use_repo(llvm, "llvm_toolchain_llvm")
+
+register_toolchains("@llvm_toolchain//:all")

Diff for: README.md

@@ -1,2 +1,19 @@
-# examples
-Hosts templates and examples for score tools and workflows
+# Examples Repository
+
+This repository serves as a template for setting up tools and toolchains used in Score, providing small examples that demonstrate how these tools work in practice.
+
+## Available Toolchains
+
+Currently, the repository includes:
+
+- LLVM from the Bazel community
+
+## Setting Up Toolchains in Your Module
+
+To integrate a toolchain into your Bazel module, follow these steps:
+
+- Copy the relevant content from MODULE.bazel in this repository.
+- Add the necessary bazel_dep() entries to your module’s MODULE.bazel file.
+- Ensure your build configurations align with the toolchain requirements.
+
+This approach allows developers to quickly set up and reuse toolchains in their own projects with minimal effort.

Diff for: examples/cpp/BUILD

@@ -0,0 +1,28 @@
+# *******************************************************************************
+# Copyright (c) 2025 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Apache License Version 2.0 which is available at
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# SPDX-License-Identifier: Apache-2.0
+# *******************************************************************************
+load("@rules_cc//cc:defs.bzl", "cc_binary", "cc_test")
+
+cc_binary(
+    name = "example-app",
+    srcs = ["main.cpp"],
+    deps = ["//examples/cpp/company"],
+)
+
+cc_test(
+    name = "example-test",
+    srcs = ["test.cpp"],
+    deps = [
+        "@googletest//:gtest",
+        "@googletest//:gtest_main",
+    ],
+)

Diff for: examples/cpp/company/BUILD

@@ -0,0 +1,23 @@
+# *******************************************************************************
+# Copyright (c) 2025 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Apache License Version 2.0 which is available at
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# SPDX-License-Identifier: Apache-2.0
+# *******************************************************************************
+load("@rules_cc//cc:defs.bzl", "cc_library")
+
+cc_library(
+    name = "company",
+    srcs = ["company.cpp"],
+    hdrs = ["includes/company.h"],
+    includes = ["includes/"],
+    linkstatic = True,
+    visibility = ["//examples/cpp:__subpackages__"],
+    deps = ["//examples/cpp/department"],
+)

Diff for: examples/cpp/company/company.cpp

@@ -0,0 +1,47 @@
+/********************************************************************************
+* Copyright (c) {year} Contributors to the Eclipse Foundation
+*
+* See the NOTICE file(s) distributed with this work for additional
+* information regarding copyright ownership.
+*
+* This program and the accompanying materials are made available under the
+* terms of the Apache License Version 2.0 which is available at
+* https://www.apache.org/licenses/LICENSE-2.0
+*
+* SPDX-License-Identifier: Apache-2.0
+********************************************************************************/
+#include "company.h"
+
+#include <utility>
+
+Company::Company(std::string name) : name(std::move(name)) {};
+
+std::string Company::GetName()
+{
+    return this->name;
+}
+
+void Company::AddDepartment(int id, std::string dep_name, int employee_nu)
+{
+    this->departments.push_back(Department(id, std::move(dep_name), employee_nu));
+}
+
+std::optional<Department> Company::GetDepartmentByName(const std::string& sname)
+{
+    std::list<Department>::iterator it;
+
+    for (it = this->departments.begin(); it != this->departments.end(); ++it)
+    {
+        if (sname.compare((*it).GetName()) == 0)
+        {
+            return *it;
+        }
+    }
+
+    return std::nullopt;
+}
+
+size_t Company::GetNumberOfDepartments()
+{
+    return this->departments.size();
+}

Diff for: examples/cpp/company/includes/company.h

@@ -0,0 +1,36 @@
+/********************************************************************************
+* Copyright (c) {year} Contributors to the Eclipse Foundation
+*
+* See the NOTICE file(s) distributed with this work for additional
+* information regarding copyright ownership.
+*
+* This program and the accompanying materials are made available under the
+* terms of the Apache License Version 2.0 which is available at
+* https://www.apache.org/licenses/LICENSE-2.0
+*
+* SPDX-License-Identifier: Apache-2.0
+********************************************************************************/
+#ifndef SAMPLE_COMPANY_H
+#define SAMPLE_COMPANY_H
+
+#include "department.h"
+#include <list>
+#include <optional>
+#include <vector>
+
+class Company
+{
+
+  public:
+    explicit Company(std::string name);
+    std::string GetName();
+    void AddDepartment(int id, std::string dep_name, int employee_nu);
+    std::optional<Department> GetDepartmentByName(const std::string& name);
+    size_t GetNumberOfDepartments();
+
+  private:
+    std::string name;
+    std::list<Department> departments;
+};
+
+#endif  // SAMPLE_COMPANY_H

Diff for: examples/cpp/department/BUILD

@@ -0,0 +1,22 @@
+# *******************************************************************************
+# Copyright (c) 2025 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Apache License Version 2.0 which is available at
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# SPDX-License-Identifier: Apache-2.0
+# *******************************************************************************
+load("@rules_cc//cc:defs.bzl", "cc_library")
+
+cc_library(
+    name = "department",
+    srcs = ["department.cpp"],
+    hdrs = ["includes/department.h"],
+    includes = ["includes/"],
+    linkstatic = True,
+    visibility = ["//examples/cpp/company:__pkg__"],
+)

Diff for: examples/cpp/department/department.cpp

@@ -0,0 +1,33 @@
+/********************************************************************************
+* Copyright (c) {year} Contributors to the Eclipse Foundation
+*
+* See the NOTICE file(s) distributed with this work for additional
+* information regarding copyright ownership.
+*
+* This program and the accompanying materials are made available under the
+* terms of the Apache License Version 2.0 which is available at
+* https://www.apache.org/licenses/LICENSE-2.0
+*
+* SPDX-License-Identifier: Apache-2.0
+********************************************************************************/
+#include "department.h"
+
+#include <utility>
+
+Department::Department(int id, std::string name, int employee_nu)
+    : id(id), name(std::move(name)), employee_nu(employee_nu) {};
+
+int Department::GetEmployeeNumber()
+{
+    return this->employee_nu;
+}
+
+std::string Department::GetName()
+{
+    return this->name;
+}
+
+int Department::GetID()
+{
+    return this->id;
+}

Diff for: examples/cpp/department/includes/department.h

@@ -0,0 +1,33 @@
+/********************************************************************************
+* Copyright (c) {year} Contributors to the Eclipse Foundation
+*
+* See the NOTICE file(s) distributed with this work for additional
+* information regarding copyright ownership.
+*
+* This program and the accompanying materials are made available under the
+* terms of the Apache License Version 2.0 which is available at
+* https://www.apache.org/licenses/LICENSE-2.0
+*
+* SPDX-License-Identifier: Apache-2.0
+********************************************************************************/
+#ifndef SAMPLE_DEPARTMENT_H
+#define SAMPLE_DEPARTMENT_H
+
+#include <string>
+
+class Department
+{
+
+  public:
+    Department(int id, std::string name, int employee_nu);
+    int GetEmployeeNumber();
+    int GetID();
+    std::string GetName();
+
+  private:
+    int id;
+    std::string name;
+    int employee_nu;
+};
+
+#endif  // SAMPLE_DEPARTMENT_H

Diff for: examples/cpp/main.cpp

@@ -0,0 +1,32 @@
+/********************************************************************************
+* Copyright (c) {year} Contributors to the Eclipse Foundation
+*
+* See the NOTICE file(s) distributed with this work for additional
+* information regarding copyright ownership.
+*
+* This program and the accompanying materials are made available under the
+* terms of the Apache License Version 2.0 which is available at
+* https://www.apache.org/licenses/LICENSE-2.0
+*
+* SPDX-License-Identifier: Apache-2.0
+********************************************************************************/
+#include <iostream>
+
+#include "company.h"
+
+int main(int /* argc */, char** /* argv */)
+{
+
+    Company awesome_company("SuperAwesome Inc.");
+    std::cout << "Company name: " << awesome_company.GetName() << '\n';
+
+    awesome_company.AddDepartment(13, "QX-57", 26262);  // NOLINT(cppcoreguidelines-avoid-magic-numbers)
+
+    auto department = awesome_company.GetDepartmentByName("QX-57");
+    if (department)
+    {
+        std::cout << "Department ID: " << department->GetID() << '\n';
+    }
+
+    return 0;
+}

Diff for: examples/cpp/test.cpp

@@ -0,0 +1,19 @@
+/********************************************************************************
+* Copyright (c) {year} Contributors to the Eclipse Foundation
+*
+* See the NOTICE file(s) distributed with this work for additional
+* information regarding copyright ownership.
+*
+* This program and the accompanying materials are made available under the
+* terms of the Apache License Version 2.0 which is available at
+* https://www.apache.org/licenses/LICENSE-2.0
+*
+* SPDX-License-Identifier: Apache-2.0
+********************************************************************************/
+#include <gtest/gtest.h>
+
+TEST(HelloTest, BasicAssertions)
+{
+    const int i = 42;
+    EXPECT_EQ(i, 42);
+}