Introduce core crate

Author: fasterthanlime

Cargo.lock

@@ -1,5 +1,5 @@
 [workspace]
-members = ["shapely", "shapely-derive", "shapely-json"]
+members = ["shapely", "shapely-core", "shapely-derive", "shapely-json"]
 resolver = "3"
 
 [workspace.package]
@@ -11,11 +11,19 @@ license = "MIT OR Apache-2.0"
 repository = "https://github.com/bearcove/shapely"
 homepage = "https://github.com/bearcove/shapely"
 documentation = "https://docs.rs/shapely"
-description = "Know the shape of your types"
-keywords = ["serialization", "deserialization"]
-categories = ["encoding", "parsing"]
+description = "One trait for reflection, serialization, deserialization"
+keywords = [
+  "serialization",
+  "deserialization",
+  "reflection",
+  "schema",
+  "validation",
+]
+categories = ["encoding", "parsing", "development-tools", "data-structures"]
 
 [workspace.dependencies]
 shapely = { version = "1.0.0", path = "shapely" }
+shapely-core = { version = "1.0.0", path = "shapely-core" }
 shapely-derive = { version = "1.0.0", path = "shapely-derive" }
 shapely-json = { version = "1.0.0", path = "shapely-json" }
+unsynn = "0.0.25"

Cargo.toml

@@ -0,0 +1,16 @@
+[package]
+name = "shapely-core"
+version.workspace = true
+authors.workspace = true
+edition.workspace = true
+rust-version.workspace = true
+license.workspace = true
+repository.workspace = true
+homepage.workspace = true
+documentation.workspace = true
+description = "Core types and traits for the shapely ecosystem, providing fundamental reflection capabilities"
+keywords = ["reflection", "introspection", "serialization", "deserialization"]
+categories = ["development-tools", "encoding"]
+
+[dependencies]
+nonmax = "0.5.5"

shapely-core/Cargo.toml

@@ -0,0 +1,22 @@
+# shapely-core
+
+[![crates.io](https://img.shields.io/crates/v/shapely-core.svg)](https://crates.io/crates/shapely-core)
+[![documentation](https://docs.rs/shapely-core/badge.svg)](https://docs.rs/shapely-core)
+[![MIT/Apache-2.0 licensed](https://img.shields.io/crates/l/shapely-core.svg)](./LICENSE)
+
+This is the core crate for the shapely ecosystem. It provides the fundamental
+types and traits used by other crates in the shapely family.
+
+Note that the main documentation for the shapely project can be found in the
+[shapely crate](https://crates.io/crates/shapely). This core crate serves as a
+common dependency for:
+
+  * The derived proc macro crate [`shapely-derive`]  (https://crates.io/crates/shapely-derive)
+  * Serializers and deserializers (e.g. [`shapely-json`]  (https://crates.io/crates/shapely-json))
+  * Any other crates in the shapely ecosystem
+
+If you're building tools or libraries that interact with shapely's core
+functionality, you should depend directly on `shapely-core` rather than the main
+`shapely` crate.
+
+For more detailed information and usage examples, please refer to the [shapely crate documentation](https://docs.rs/shapely).

shapely-core/README.md

@@ -0,0 +1,53 @@
+use std::mem::MaybeUninit;
+
+pub use nonmax;
+
+mod hashmap_impl;
+mod scalar_impls;
+
+mod shape;
+pub use shape::*;
+
+mod slot;
+pub use slot::Slot;
+
+mod partial;
+pub use partial::*;
+
+mod helpers;
+pub use helpers::*;
+
+pub mod mini_typeid;
+
+#[doc(hidden)]
+pub mod log;
+pub use log::*;
+
+#[cfg(test)]
+mod tests;
+
+/// Allows querying the [Shape] of a type, which in turn lets us inspect any fields, build a value of
+/// this type progressively, etc.
+pub trait Shapely: Sized {
+    /// Returns the shape of this type
+    fn shape() -> Shape;
+
+    /// Returns a shape def (a function that can describe this shape)
+    fn shape_desc() -> ShapeDesc {
+        ShapeDesc(Self::shape)
+    }
+
+    /// Allocates this shape on the heap and return a partial that allows gradually initializing its fields.
+    fn partial() -> Partial<'static> {
+        Partial::alloc(Self::shape_desc())
+    }
+
+    /// Initializes a `Partial` from a borrowed `MaybeUninit<Self>`.
+    ///
+    /// Before calling assume_init, make sure to call Partial.build_in_place().
+    fn partial_from_uninit(dest: &mut MaybeUninit<Self>) -> Partial<'_> {
+        Partial::borrow(dest)
+    }
+
+    // TODO: partial_from_mut? where all the fields are already initialized?
+}