Finish implementing the TypeDesc API, adding license headers, etc

Signed-off-by: Scott Wilson <scott@propersquid.com>

Author: scott-wilson

src/rust/Cargo.toml

@@ -18,16 +18,13 @@ repository = "https://github.com/AcademySoftwareFoundation/OpenImageIO.git"
 [workspace]
 members = ["oiio-sys"]
 
-[workspace.dependencies]
-cxx = { version = "1.0.143", features = ["c++17"] }
-thiserror = "2.0.12"
-
 [dependencies]
-cxx = { workspace = true }
 oiio-sys = { path = "oiio-sys", version = "0.1.0" }
-thiserror = { workspace = true }
+thiserror = "2.0.12"
 
 [dev-dependencies]
+proptest = "1.6.0"
+proptest-derive = "0.5.1"
 
 # The docs are the same across all platforms so we only need to build once.
 [package.metadata.docs.rs]

src/rust/oiio-sys/build.rs

@@ -1,3 +1,7 @@
+// Copyright Contributors to the OpenImageIO project.
+// SPDX-License-Identifier: Apache-2.0
+// https://github.com/AcademySoftwareFoundation/OpenImageIO
+
 use anyhow::Result;
 
 const NAMES: &[&str] = &["typedesc"];

src/rust/oiio-sys/include/typedesc.h

@@ -1,3 +1,7 @@
+// Copyright Contributors to the OpenImageIO project.
+// SPDX-License-Identifier: Apache-2.0
+// https://github.com/AcademySoftwareFoundation/OpenImageIO
+
 #pragma once
 
 #include "rust/cxx.h"

src/rust/oiio-sys/src/lib.rs

@@ -1 +1,5 @@
+// Copyright Contributors to the OpenImageIO project.
+// SPDX-License-Identifier: Apache-2.0
+// https://github.com/AcademySoftwareFoundation/OpenImageIO
+
 pub mod typedesc;

src/rust/oiio-sys/src/typedesc.cpp

@@ -1,3 +1,7 @@
+// Copyright Contributors to the OpenImageIO project.
+// SPDX-License-Identifier: Apache-2.0
+// https://github.com/AcademySoftwareFoundation/OpenImageIO
+
 #include "oiio-sys/include/typedesc.h"
 #include "rust/cxx.h"
 #include <OpenImageIO/string_view.h>

src/rust/oiio-sys/src/typedesc.rs

@@ -1,3 +1,7 @@
+// Copyright Contributors to the OpenImageIO project.
+// SPDX-License-Identifier: Apache-2.0
+// https://github.com/AcademySoftwareFoundation/OpenImageIO
+
 pub use ffi::*;
 
 /// A TypeDesc describes simple data types.
@@ -160,8 +164,8 @@ mod ffi {
             arraylen: i32,
         ) -> TypeDesc;
 
-        /// Construct from a string (e.g., "float[3]").  If no valid
-        /// type could be assembled, set base to UNKNOWN.
+        /// Construct from a string (e.g., `float[3]`).  If no valid
+        /// type could be assembled, set base to `UNKNOWN`.
         ///
         /// Examples:
         ///
@@ -178,8 +182,8 @@ mod ffi {
         /// Clone constructor.
         fn typedesc_clone(t: &TypeDesc) -> TypeDesc;
 
-        /// Return the name, for printing and whatnot.  For example,
-        /// "float", "int[5]", "normal"
+        /// Display the name, for printing and whatnot.  For example,
+        /// `float`, `int[5]`, `normal`
         fn typedesc_as_str(typedesc: &TypeDesc) -> &str;
 
         /// Return the number of elements: 1 if not an array, or the array
@@ -261,13 +265,13 @@ mod ffi {
         /// inequality is differing vector semantics.
         fn typedesc_equivalent(typedesc: &TypeDesc, b: &TypeDesc) -> bool;
 
-        /// Is this a 2-vector aggregate (of the given type, float by default)?
+        /// Is this a 2-vector aggregate (of the given type)?
         fn typedesc_is_vec2(typedesc: &TypeDesc, b: BaseType) -> bool;
 
-        /// Is this a 3-vector aggregate (of the given type, float by default)?
+        /// Is this a 3-vector aggregate (of the given type)?
         fn typedesc_is_vec3(typedesc: &TypeDesc, b: BaseType) -> bool;
 
-        /// Is this a 4-vector aggregate (of the given type, float by default)?
+        /// Is this a 4-vector aggregate (of the given type)?
         fn typedesc_is_vec4(typedesc: &TypeDesc, b: BaseType) -> bool;
 
         /// Is this an array of aggregates that represents a 2D bounding box?
@@ -304,7 +308,7 @@ mod ffi {
         /// * If dsttype is int32 or uint32: other integer types will do their best
         ///   (caveat emptor if you mix signed/unsigned). Also a source string will
         ///   convert to int if and only if its characters form a valid integer.
-        /// * If dsttype is float: inteegers and other float types will do
+        /// * If dsttype is float: integers and other float types will do
         ///   their best conversion; strings will convert if and only if their
         ///   characters form a valid float number.
         fn typedesc_convert_type(

src/rust/src/lib.rs

@@ -1,3 +1,7 @@
+// Copyright Contributors to the OpenImageIO project.
+// SPDX-License-Identifier: Apache-2.0
+// https://github.com/AcademySoftwareFoundation/OpenImageIO
+
 /// Low-level oiio-sys FFI bindings to OpenImageIO.
 use oiio_sys as sys;