add and beman/scope.hpp header and change code to use.

README.md

@@ -37,7 +37,7 @@ is exited with an exception.  `scope_success` and `scope_exit` provide similar c
 but with different checked conditions on exiting the scope.
 
 ```c++
-#include <beman/scope/scope.hpp>
+#include <beman/scope.hpp>
 
 
     bool triggered = false;
@@ -59,7 +59,7 @@ but with different checked conditions on exiting the scope.
 `unique_resource` is a cutomizeable RAII type similar to `unique_ptr`.
 
 ```c++
-#include <beman/scope/scope.hpp>
+#include <beman/scope.hpp>
 
   {
     auto file = beman::scope::unique_resource(
@@ -97,7 +97,7 @@ As a header only library no building is required to use in a project -- simply m
 the `include` directory available add add the following to your source.
 
 ```cpp
-#include <beman/scope/scope.hpp>
+#include <beman/scope.hpp>
 
 //modular version
 

examples/examples.md

@@ -0,0 +1,10 @@
+# Scope Examples
+
+The header-based examples include `<beman/scope.hpp>`. The module example imports `beman.scope` and `std` and requires a compiler and build configuration that support those modules.
+
+| Example | Description |
+| --- | --- |
+| [`scope_example.cpp`](scope_example.cpp) | Compares manual scope handling with `scope_exit`, `scope_fail`, and `scope_success`. |
+| [`unique_resource.cpp`](unique_resource.cpp) | Manages a dynamically allocated integer array with `unique_resource` automatically releases it with `delete[]` on scope exit. |
+| [`unique_resource_file.cpp`](unique_resource_file.cpp) | Manages a `FILE*` opened with `fopen`, checks for an open failure and automatically closes the file with `fclose` on scope exit. |
+| [`scope_module.cpp`](scope_module.cpp) | Uses `import beman.scope` and `import std` to demonstrate scope guard and `unique_resource`. |

examples/scope_example.cpp

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 
-#include <beman/scope/scope.hpp>
+#include <beman/scope.hpp>
 
 #include <cstdlib>
 #include <iostream>

examples/unique_resource.cpp

@@ -2,7 +2,7 @@
 
 #include <iostream>
 #include <memory>
-#include <beman/scope/scope.hpp>
+#include <beman/scope.hpp>
 
 constexpr size_t arr_size = 10;
 // clang-format off

examples/unique_resource_file.cpp

@@ -3,7 +3,7 @@
 #include <iostream>
 #include <memory>
 #include <cstdio>
-#include <beman/scope/scope.hpp>
+#include <beman/scope.hpp>
 
 // clang-format off
 int main() {

include/beman/scope.hpp

@@ -0,0 +1,8 @@
+// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+
+#ifndef BEMAN_SCOPE_CONVENIENCE_HPP
+#define BEMAN_SCOPE_CONVENIENCE_HPP
+
+#include <beman/scope/scope.hpp>
+
+#endif // BEMAN_SCOPE_CONVENIENCE_HPP

tests/beman/scope/scope_exit.test.cpp

@@ -2,7 +2,7 @@
 
 // clang-format off
 
-#include <beman/scope/scope.hpp>
+#include <beman/scope.hpp>
 #include <stdexcept>
 #include <string>
 

tests/beman/scope/scope_fail.test.cpp

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 
-#include <beman/scope/scope.hpp>
+#include <beman/scope.hpp>
 #include <stdexcept>
 #include <string>
 

tests/beman/scope/scope_success.test.cpp

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 
-#include <beman/scope/scope.hpp>
+#include <beman/scope.hpp>
 #include <stdexcept>
 #include <string>
 

tests/beman/scope/unique_resource.test.cpp

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 
-#include <beman/scope/scope.hpp>
+#include <beman/scope.hpp>
 #include <memory>
 #include <cstdio>
 #include <stdexcept>