seq_runtime/
lib.rs

1//! Seq Runtime: A clean concatenative language foundation
2//!
3//! Key design principles:
4//! - Value: What the language talks about (Int, Bool, Variant, etc.)
5//! - StackValue: 40-byte tagged stack entry (discriminant + 4 payload slots)
6//! - Stack: Contiguous array of StackValue entries for efficient operations
7
8pub mod arena;
9pub mod args;
10pub mod arithmetic;
11pub mod channel;
12pub mod closures;
13pub mod cond;
14pub mod diagnostics;
15pub mod file;
16pub mod float_ops;
17pub mod io;
18pub mod list_ops;
19pub mod map_ops;
20pub mod memory_stats;
21pub mod os;
22pub mod quotations;
23pub mod scheduler;
24pub mod seqstring;
25pub mod serialize;
26pub mod son;
27pub mod stack;
28pub mod string_ops;
29pub mod tagged_stack;
30pub mod tcp;
31pub mod tcp_test;
32pub mod test;
33pub mod time_ops;
34pub mod value;
35pub mod variant_ops;
36pub mod watchdog;
37pub mod weave;
38
39// Re-export key types and functions
40pub use stack::{
41    DISC_BOOL, DISC_CHANNEL, DISC_CLOSURE, DISC_FLOAT, DISC_INT, DISC_MAP, DISC_QUOTATION,
42    DISC_STRING, DISC_VARIANT, Stack, clone_stack, clone_stack_segment, clone_stack_value,
43    drop_stack_value, drop_top, is_empty, patch_seq_2dup as two_dup, patch_seq_3drop as three_drop,
44    patch_seq_clone_value as clone_value, patch_seq_drop_op as drop_op, patch_seq_dup as dup,
45    patch_seq_nip as nip, patch_seq_over as over, patch_seq_pick_op as pick_op,
46    patch_seq_push_value as push_value, patch_seq_rot as rot,
47    patch_seq_set_stack_base as set_stack_base, patch_seq_stack_dump as stack_dump,
48    patch_seq_swap as swap, patch_seq_tuck as tuck, peek, peek_sv, pop, pop_sv, push, push_sv,
49    stack_value_to_value, value_to_stack_value,
50};
51pub use value::{ChannelData, MapKey, Value, VariantData};
52
53// Serialization types (for persistence/exchange with external systems)
54pub use serialize::{SerializeError, TypedMapKey, TypedValue, ValueSerialize};
55
56// Arithmetic operations (exported for LLVM linking)
57pub use arithmetic::{
58    patch_seq_add as add, patch_seq_divide as divide, patch_seq_eq as eq, patch_seq_gt as gt,
59    patch_seq_gte as gte, patch_seq_lt as lt, patch_seq_lte as lte, patch_seq_multiply as multiply,
60    patch_seq_neq as neq, patch_seq_push_bool as push_bool, patch_seq_push_int as push_int,
61    patch_seq_subtract as subtract,
62};
63
64// Float operations (exported for LLVM linking)
65pub use float_ops::{
66    patch_seq_f_add as f_add, patch_seq_f_divide as f_divide, patch_seq_f_eq as f_eq,
67    patch_seq_f_gt as f_gt, patch_seq_f_gte as f_gte, patch_seq_f_lt as f_lt,
68    patch_seq_f_lte as f_lte, patch_seq_f_multiply as f_multiply, patch_seq_f_neq as f_neq,
69    patch_seq_f_subtract as f_subtract, patch_seq_float_to_int as float_to_int,
70    patch_seq_float_to_string as float_to_string, patch_seq_int_to_float as int_to_float,
71    patch_seq_push_float as push_float,
72};
73
74// I/O operations (exported for LLVM linking)
75pub use io::{
76    patch_seq_exit_op as exit_op, patch_seq_push_interned_symbol as push_interned_symbol,
77    patch_seq_push_string as push_string, patch_seq_push_symbol as push_symbol,
78    patch_seq_read_line as read_line, patch_seq_read_line_plus as read_line_plus,
79    patch_seq_read_n as read_n, patch_seq_string_to_symbol as string_to_symbol,
80    patch_seq_symbol_to_string as symbol_to_string, patch_seq_write_line as write_line,
81};
82
83// Scheduler operations (exported for LLVM linking)
84pub use scheduler::{
85    patch_seq_maybe_yield as maybe_yield, patch_seq_scheduler_init as scheduler_init,
86    patch_seq_scheduler_run as scheduler_run, patch_seq_scheduler_shutdown as scheduler_shutdown,
87    patch_seq_spawn_strand as spawn_strand, patch_seq_strand_spawn as strand_spawn,
88    patch_seq_wait_all_strands as wait_all_strands, patch_seq_yield_strand as yield_strand,
89};
90
91// Channel operations (exported for LLVM linking)
92// Note: All channel ops now return success flags (errors are values, not crashes)
93pub use channel::{
94    patch_seq_chan_receive as receive, patch_seq_chan_send as send,
95    patch_seq_close_channel as close_channel, patch_seq_make_channel as make_channel,
96};
97
98// Weave operations (generators/coroutines with yield/resume)
99pub use weave::{
100    patch_seq_resume as weave_resume, patch_seq_weave as weave_make,
101    patch_seq_weave_cancel as weave_cancel, patch_seq_yield as weave_yield,
102};
103
104// String operations (exported for LLVM linking)
105pub use io::patch_seq_int_to_string as int_to_string;
106pub use string_ops::{
107    patch_seq_json_escape as json_escape, patch_seq_string_chomp as string_chomp,
108    patch_seq_string_concat as string_concat, patch_seq_string_contains as string_contains,
109    patch_seq_string_empty as string_empty, patch_seq_string_length as string_length,
110    patch_seq_string_split as string_split, patch_seq_string_starts_with as string_starts_with,
111    patch_seq_string_to_int as string_to_int, patch_seq_string_to_lower as string_to_lower,
112    patch_seq_string_to_upper as string_to_upper, patch_seq_string_trim as string_trim,
113};
114
115// Quotation operations (exported for LLVM linking)
116pub use quotations::{
117    patch_seq_call as call, patch_seq_peek_is_quotation as peek_is_quotation,
118    patch_seq_peek_quotation_fn_ptr as peek_quotation_fn_ptr,
119    patch_seq_push_quotation as push_quotation, patch_seq_spawn as spawn, patch_seq_times as times,
120    patch_seq_until_loop as until_loop, patch_seq_while_loop as while_loop,
121};
122
123// Closure operations (exported for LLVM linking)
124pub use closures::{
125    patch_seq_create_env as create_env, patch_seq_env_get as env_get,
126    patch_seq_env_get_int as env_get_int, patch_seq_env_set as env_set,
127    patch_seq_make_closure as make_closure, patch_seq_push_closure as push_closure,
128};
129
130// Conditional combinator (exported for LLVM linking)
131pub use cond::patch_seq_cond as cond;
132
133// TCP operations (exported for LLVM linking)
134pub use tcp::{
135    patch_seq_tcp_accept as tcp_accept, patch_seq_tcp_close as tcp_close,
136    patch_seq_tcp_listen as tcp_listen, patch_seq_tcp_read as tcp_read,
137    patch_seq_tcp_write as tcp_write,
138};
139
140// OS operations (exported for LLVM linking)
141pub use os::{
142    patch_seq_current_dir as current_dir, patch_seq_exit as exit, patch_seq_getenv as getenv,
143    patch_seq_home_dir as home_dir, patch_seq_os_arch as os_arch, patch_seq_os_name as os_name,
144    patch_seq_path_exists as path_exists, patch_seq_path_filename as path_filename,
145    patch_seq_path_is_dir as path_is_dir, patch_seq_path_is_file as path_is_file,
146    patch_seq_path_join as path_join, patch_seq_path_parent as path_parent,
147};
148
149// Variant operations (exported for LLVM linking)
150pub use variant_ops::{
151    patch_seq_make_variant_0 as make_variant_0, patch_seq_make_variant_1 as make_variant_1,
152    patch_seq_make_variant_2 as make_variant_2, patch_seq_make_variant_3 as make_variant_3,
153    patch_seq_make_variant_4 as make_variant_4, patch_seq_unpack_variant as unpack_variant,
154    patch_seq_variant_field_at as variant_field_at,
155    patch_seq_variant_field_count as variant_field_count, patch_seq_variant_tag as variant_tag,
156};
157
158// Command-line argument operations (exported for LLVM linking)
159pub use args::{
160    patch_seq_arg_at as arg_at, patch_seq_arg_count as arg_count, patch_seq_args_init as args_init,
161};
162
163// File operations (exported for LLVM linking)
164pub use file::{
165    patch_seq_file_exists as file_exists,
166    patch_seq_file_for_each_line_plus as file_for_each_line_plus,
167    patch_seq_file_slurp as file_slurp,
168};
169
170// List operations (exported for LLVM linking)
171pub use list_ops::{
172    patch_seq_list_each as list_each, patch_seq_list_empty as list_empty,
173    patch_seq_list_filter as list_filter, patch_seq_list_fold as list_fold,
174    patch_seq_list_get as list_get, patch_seq_list_length as list_length,
175    patch_seq_list_make as list_make, patch_seq_list_map as list_map,
176    patch_seq_list_push as list_push, patch_seq_list_set as list_set,
177};
178
179// Map operations (exported for LLVM linking)
180pub use map_ops::{
181    patch_seq_make_map as make_map, patch_seq_map_empty as map_empty, patch_seq_map_get as map_get,
182    patch_seq_map_has as map_has, patch_seq_map_keys as map_keys,
183    patch_seq_map_remove as map_remove, patch_seq_map_set as map_set,
184    patch_seq_map_size as map_size, patch_seq_map_values as map_values,
185};
186
187// Test framework operations (exported for LLVM linking)
188pub use test::{
189    patch_seq_test_assert as test_assert, patch_seq_test_assert_eq as test_assert_eq,
190    patch_seq_test_assert_eq_str as test_assert_eq_str,
191    patch_seq_test_assert_not as test_assert_not, patch_seq_test_fail as test_fail,
192    patch_seq_test_fail_count as test_fail_count, patch_seq_test_finish as test_finish,
193    patch_seq_test_has_failures as test_has_failures, patch_seq_test_init as test_init,
194    patch_seq_test_pass_count as test_pass_count,
195};
196
197// Time operations (exported for LLVM linking)
198pub use time_ops::{
199    patch_seq_time_nanos as time_nanos, patch_seq_time_now as time_now,
200    patch_seq_time_sleep_ms as time_sleep_ms,
201};
202
203// SON serialization (exported for LLVM linking)
204pub use son::{patch_seq_son_dump as son_dump, patch_seq_son_dump_pretty as son_dump_pretty};