fix: expose a single public library

CHANGES.md

@@ -1,5 +1,9 @@
 # Changes
 
+## Unreleased
+
+* Redo packaging to expose a single public library: `riot`
+
 ## 0.0.5
 
 * Add `register name pid`

README.md

@@ -18,8 +18,10 @@ An actor-model multi-core scheduler for OCaml 5.
 Riot is an [actor-model][actors] multi-core scheduler for OCaml 5. It brings
 [Erlang][erlang]-style concurrency to the language, where lightweight processes communicate via message-passing.
 
+<!-- $MDX file=test/readme_example.ml,part=main -->
 ```ocaml
 open Riot
+
 type Message.t += Hello_world
 
 let () =
@@ -28,7 +30,8 @@ let () =
     spawn (fun () ->
         match receive () with
         | Hello_world ->
-            Logger.info (fun f -> f "hello world from %a!" Pid.pp (self ())))
+            Logger.info (fun f -> f "hello world from %a!" Pid.pp (self ()));
+            shutdown ())
   in
   send pid Hello_world
 ```

bench/dune

@@ -1,3 +1,3 @@
 (executables
-  (names spawn_many)
-  (libraries riot))
+ (names spawn_many)
+ (libraries riot))

dune

@@ -0,0 +1,2 @@
+(mdx
+ (libraries riot))

dune-project

@@ -1,4 +1,5 @@
-(lang dune 3.10)
+(lang dune 3.11)
+(using mdx 0.4)
 
 (name riot)
 
@@ -19,12 +20,12 @@
  (description "Riot is an actor-model multi-core scheduler for OCaml 5. It brings Erlang-style concurrency to the language, where lighweight process communicate via message passing")
  (depends
    (ocaml (>= "5.1"))
-   dune
    (ptime (>= "1.1.0"))
    (iomux (>= "0.3"))
    (bigstringaf (>= "0.9.1"))
    (uri (>= "4.4.0"))
    (telemetry (>= "0.0.1"))
+   (mdx (and :with-test (>= "2.3.1")))
    (odoc (and :with-doc (>= "2.2.2")))
  )
  (tags

riot.opam

@@ -10,13 +10,14 @@ tags: ["multicore" "erlang" "actor" "message-passing" "processes"]
 homepage: "https://github.com/leostera/riot"
 bug-reports: "https://github.com/leostera/riot/issues"
 depends: [
+  "dune" {>= "3.11"}
   "ocaml" {>= "5.1"}
-  "dune" {>= "3.10"}
   "ptime" {>= "1.1.0"}
   "iomux" {>= "0.3"}
   "bigstringaf" {>= "0.9.1"}
   "uri" {>= "4.4.0"}
   "telemetry" {>= "0.0.1"}
+  "mdx" {with-test & >= "2.3.1"}
   "odoc" {with-doc & >= "2.2.2"}
 ]
 build: [

riot/lib/dune

@@ -1,4 +1,4 @@
 (library
- (public_name riot.lib)
+ (package riot)
  (name lib)
  (libraries lib_net logger runtime))

riot/lib/logger/dune

@@ -1,4 +1,4 @@
 (library
- (public_name riot.lib.logger)
+ (package riot)
  (name logger)
  (libraries runtime))

riot/lib/net/dune

@@ -1,4 +1,4 @@
 (library
- (public_name riot.lib.net)
+ (package riot)
  (name lib_net)
  (libraries runtime logger))

riot/riot.mli

@@ -245,12 +245,12 @@ module Gen_server : sig
       custom request types, including the response type in its type variable.
       Like this: 
 
-      ```ocaml
+      {@ocaml[
       open Riot
       type _ Gen_server.req +=
         | Is_connected : bool Gen_server.req
         | Profile : profile_req -> profile_res Gen_server.req
-      ```
+      ]}
     *)
 
   (** [state init_result] is used to initialize a new generic server. *)
@@ -264,7 +264,7 @@ module Gen_server : sig
   (** [Impl] is the module type of the generic server base implementations. You
       can use this type when defining new gen servers like this:
 
-      ```ocaml
+      {@ocaml[
       type args = int
       module Server : Gen_server.Impl with type args = args = struct
         type nonrec args = args
@@ -274,7 +274,7 @@ module Gen_server : sig
 
         (* ... *)
       end
-      ```
+      ]}
   *)
   module type Impl = sig
     type args

riot/runtime/core/dune

@@ -1,4 +1,4 @@
 (library
- (public_name riot.core)
+ (package riot)
  (name core)
  (libraries log util))

riot/runtime/dune

@@ -1,4 +1,4 @@
 (library
- (public_name riot.runtime)
+ (package riot)
  (name runtime)
  (libraries core log net scheduler time util))

riot/runtime/log/dune

@@ -1,4 +1,4 @@
 (library
- (public_name riot.log)
+ (package riot)
  (name log)
  (libraries ptime ptime.clock.os))

riot/runtime/net/dune

@@ -1,4 +1,4 @@
 (library
- (public_name riot.net)
+ (package riot)
  (name net)
  (libraries core util log iomux uri unix telemetry bigstringaf))

riot/runtime/scheduler/dune

@@ -1,4 +1,4 @@
 (library
- (public_name riot.scheduler)
+ (package riot)
  (name scheduler)
  (libraries core util net time log))

riot/runtime/time/dune

@@ -1,4 +1,4 @@
 (library
- (public_name riot.runtime.time)
+ (package riot)
  (name time)
  (libraries core ptime ptime.clock.os))

riot/runtime/util/dune

@@ -1,4 +1,4 @@
 (library
- (public_name riot.util)
+ (package riot)
  (name util)
  (libraries log unix))

test/dune

@@ -1,5 +1,6 @@
 (tests
  (names
+  readme_example
   application_test
   telemetry_test
   process_registration_test

test/readme_example.ml

@@ -0,0 +1,18 @@
+[@@@warning "-8"]
+
+(* $MDX part-begin=main *)
+open Riot
+
+type Message.t += Hello_world
+
+let () =
+  Riot.run @@ fun () ->
+  let pid =
+    spawn (fun () ->
+        match receive () with
+        | Hello_world ->
+            Logger.info (fun f -> f "hello world from %a!" Pid.pp (self ()));
+            shutdown ())
+  in
+  send pid Hello_world
+(* $MDX part-end *)