tests: add test skeleton project

Documentation from nathanj's pull request #12.

Author: tylerwhall

README.rst

@@ -139,6 +139,23 @@ Sample Output
          0x0000035d (0x86a9)
          Fatal fault in thread 0x00400060! Aborting.
 
+Testing
+*******
+
+The Zephyr test runner can be used:
+
+.. code-block:: console
+
+    $ZEPHYR_BASE/scripts/sanitycheck --testcase-root tests -p native_posix -N
+
+Or you can build and run the test manually:
+
+.. code-block:: console
+
+    cd tests/rust
+    mkdir -p build-posix && cd build-posix
+    cmake -GNinja -DBOARD=native_posix ..
+    ninja run
 
 Supported Architectures
 ***********************

tests/rust/CMakeLists.txt

@@ -0,0 +1,8 @@
+# SPDX-License-Identifier: Apache-2.0
+
+cmake_minimum_required(VERSION 3.13.1)
+get_filename_component(ZEPHYR_RUST ${CMAKE_CURRENT_SOURCE_DIR}/../.. ABSOLUTE)
+list(APPEND ZEPHYR_MODULES ${ZEPHYR_RUST})
+include($ENV{ZEPHYR_BASE}/cmake/app/boilerplate.cmake NO_POLICY_SCOPE)
+project(rust)
+target_sources(app PRIVATE ./src/main.c)

tests/rust/Cargo.lock

@@ -0,0 +1,7 @@
+[package]
+name = "app"
+version = "0.1.0"
+authors = ["Tyler Hall <[email protected]>"]
+edition = "2018"
+
+[dependencies]

tests/rust/Cargo.toml

@@ -0,0 +1,2 @@
+CONFIG_RUST=y
+CONFIG_ZTEST=y

tests/rust/prj.conf

@@ -0,0 +1,4 @@
+#[no_mangle]
+pub extern "C" fn test_main() {
+    println!("Hello, world!");
+}

tests/rust/src/lib.rs

@@ -0,0 +1 @@
+// Empty

tests/rust/src/main.c

@@ -0,0 +1,5 @@
+common:
+    arch_whitelist: x86 arm posix
+tests:
+    rust.main:
+        tags: rust