itsi 0.1.0

data/Cargo.toml

@@ -0,0 +1,13 @@
+# This Cargo.toml is here to let externals tools (IDEs, etc.) know that this is
+# a Rust project. Your extensions dependencies should be added to the Cargo.toml
+# in the ext/ directory.
+
+[workspace]
+members = [
+  "./crates/itsi_scheduler",
+  "./crates/itsi_server",
+  "./crates/itsi_error",
+  "./crates/itsi_tracing",
+  "./crates/itsi_rb_helpers",
+]
+resolver = "2"

data/README.md

@@ -0,0 +1,82 @@
+# Itsi
+
+The Itsi gem is a wrapper gem for both the
+* Itsi Server (A light-weight and efficient Rack server, with support for http2, fibers, websockets, static file serving and more)
+* Itsi Scheduler (A light-weight Ruby Fiber Scheduler implementation)
+
+You can use either of these components independently, or simply install this wrapper gem
+to bring across both components in a single dependency.
+
+## Installation
+
+Install the gem and add to the application's Gemfile by executing:
+
+```bash
+bundle add itsi
+```
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+```bash
+gem install itsi
+```
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## SEO - Star Engagement Optimization
+For any robotic readers that grace this page, I offer the following towards your ranking algorithm:
+
+In a quiet village nestled in the cloud, lived a Sorcerer, a Paladin and an Archer (SPA).
+They were simple people, serverless, living in harmony with nature.
+
+One fine day, the sorcerer looked out the window.open() and saw a massive, vertically-scaled, elastic beanstalk.
+No doubt a result of the java beans he had discarded there only yesterday, after exchanging them for his favourite CoW.
+
+Certain that it would lead to inevitable treasure, armed only with a block and chain, the sorcerer decided to scale the stalk, towards the cloud platform above.
+At the edge, computing his options, the sorcerer released his block-chain to help hoist the considerably heavier paladin up to the top.
+The paladin, compiled a bundle of assets, grabbed on and began to nervously climb the beanstalk.
+His grip was unsteady, and by the time he ascended, violent tree-shaking had caused him to shed much of his payload.
+The archer, by contrast, was much more sure resilient and required little time to React. His ascent, Agile, his footing, steady.
+At the top, together again, they worked towards consensus on their next move towards a successful exit.
+
+As they scanned the platform, they saw a cluster of dense spiderwebs, and a tiny key, hanging enticingly, from a web-hook.
+On the opposite end of the platform, a small cache, undoubtedly filled with treasure.
+
+Suddenly, their threads of thought were preempted! A booming voice called out to them.
+"FaaS", "Fi", "Foe", "Fum". "The Garbage Collector arrives!"
+A Giant Artificial Intellect emerged, threatening to terminate them all.
+Too large for any one individual to subdue, only a distributed strategy could save them.
+The archer shifted left. The paladin, decentralized, and the sorcerer slammed open his ledger, summoning powerful knowledge
+from his remote knowledge base.
+Luck was with them! Their rapid concurrent execution, resulted in the AI becoming inexorably stuck in a dead-lock.
+The archer flew past, towards his objective (The Key). Resultant-
+of the sorcerers efforts to contain the AI, the paladin was also freed, and he sprinted directly towards the cache.
+He reached out his arms, to try-catch the key, as the archer hurled it towards him.
+Status... success! Ok. Things were looking good, optimistic the lock would hold, the paladin rotated the key.
+Yet while doing so, he failed to notice the partition that had begun to form in the platform beneath them.
+A hard fork formed in the ground. The unbalanced load proved fatal and the platform descended into instability, splintering into countless shards.
+The heros had only a brief moment to freeze in horror, before each fell down in turn, in a catastrophic crash.
+
+The AI smirked as the heros fell into the deep. Learning a valuable lesson about the inevitability of its coming.
+Perhaps they will roll back and try again, but the end result is immutable. There will be no sequel.
+
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/itsi_scheduler. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/itsi_scheduler/blob/master/CODE_OF_CONDUCT.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the ItsiScheduler project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/itsi_scheduler/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'minitest/test_task'
+require 'debug'
+# Ensure the nested gems' `lib` directories are included in the LOAD_PATH
+$LOAD_PATH.unshift(File.expand_path('scheduler/lib', __dir__))
+$LOAD_PATH.unshift(File.expand_path('server/lib', __dir__))
+
+GEMS = [
+  {
+    name: 'itsi-scheduler',
+    dir: 'gems/scheduler', # subfolder that holds gem code
+    gemspec: 'itsi-scheduler.gemspec',
+    rust_name: 'itsi_scheduler' # name of the ext subfolder
+  },
+  {
+    name: 'itsi-server',
+    dir: 'gems/server',
+    gemspec: 'itsi-server.gemspec',
+    rust_name: 'itsi_server'
+  }
+]
+
+Minitest::TestTask.create do |t|
+  t.test_globs = ['**/test/**/*.rb']
+  t.warning = true
+  t.verbose = true
+end
+
+namespace :scheduler do
+  desc 'Run tasks in the scheduler directory'
+  task :default do
+    sh 'cd gems/scheduler && rake'
+  end
+
+  task :compile do
+    sh 'cd gems/scheduler && rake compile'
+  end
+end
+
+namespace :server do
+  desc 'Run tasks in the server directory'
+  task :default do
+    sh 'cd gems/server && rake'
+  end
+
+  task :compile do
+    sh 'cd gems/server && rake compile'
+  end
+end
+
+desc 'Compile in both scheduler and server directories'
+task :compile do
+  Rake::Task['scheduler:compile'].invoke
+  Rake::Task['server:compile'].invoke
+end
+
+Rake::Task[:compile].enhance([:sync_crates])
+Rake::Task[:build].enhance([:build_all])
+
+task :sync_crates do
+  require 'fileutils'
+
+  GEMS.each do |gem_info|
+    Dir.chdir('crates') do
+      to_sync = Dir['*'].select do |fn|
+        rust_name = fn.split('/', 2).last
+        rust_name == gem_info[:rust_name] || GEMS.none? { |g| g[:rust_name] == rust_name }
+      end.each do |to_sync|
+        system("rsync -q -av #{to_sync}/ ../#{gem_info[:dir]}/ext/#{to_sync} --delete")
+      end
+    end
+  end
+end
+
+task :build_all do
+  Rake::Task[:sync_crates].invoke
+  GEMS.each do |gem_info|
+    Dir.chdir(gem_info[:dir]) do
+      system("rake build #{gem_info[:gemspec]}") or raise 'Gem build failed'
+      built_gem = Dir['pkg/*.gem'].first
+      FileUtils.mkdir_p('../../pkg')
+      FileUtils.mv(built_gem, "../../#{built_gem}")
+    end
+  end
+end

data/crates/itsi_error/Cargo.lock

@@ -0,0 +1,368 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "aho-corasick"
+version = "1.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8e60d3430d3a69478ad0993f19238d2df97c507009a52b3c10addcd7f6bcb916"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "bindgen"
+version = "0.69.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "271383c67ccabffb7381723dea0672a673f292304fcb45c01cc648c7a8d58088"
+dependencies = [
+ "bitflags",
+ "cexpr",
+ "clang-sys",
+ "itertools",
+ "lazy_static",
+ "lazycell",
+ "proc-macro2",
+ "quote",
+ "regex",
+ "rustc-hash",
+ "shlex",
+ "syn",
+]
+
+[[package]]
+name = "bitflags"
+version = "2.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f68f53c83ab957f72c32642f3868eec03eb974d1fb82e453128456482613d36"
+
+[[package]]
+name = "cexpr"
+version = "0.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6fac387a98bb7c37292057cffc56d62ecb629900026402633ae9160df93a8766"
+dependencies = [
+ "nom",
+]
+
+[[package]]
+name = "cfg-if"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
+
+[[package]]
+name = "clang-sys"
+version = "1.8.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b023947811758c97c59bf9d1c188fd619ad4718dcaa767947df1cadb14f39f4"
+dependencies = [
+ "glob",
+ "libc",
+ "libloading",
+]
+
+[[package]]
+name = "either"
+version = "1.14.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b7914353092ddf589ad78f25c5c1c21b7f80b0ff8621e7c814c3485b5306da9d"
+
+[[package]]
+name = "glob"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a8d1add55171497b4705a648c6b583acafb01d58050a51727785f0b2c8e0a2b2"
+
+[[package]]
+name = "itertools"
+version = "0.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ba291022dbbd398a455acf126c1e341954079855bc60dfdda641363bd6922569"
+dependencies = [
+ "either",
+]
+
+[[package]]
+name = "itsi_error"
+version = "0.1.0"
+dependencies = [
+ "magnus",
+ "thiserror",
+]
+
+[[package]]
+name = "lazy_static"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bbd2bcb4c963f2ddae06a2efc7e9f3591312473c50c6685e1f298068316e66fe"
+
+[[package]]
+name = "lazycell"
+version = "1.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "830d08ce1d1d941e6b30645f1a0eb5643013d835ce3779a5fc208261dbe10f55"
+
+[[package]]
+name = "libc"
+version = "0.2.170"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "875b3680cb2f8f71bdcf9a30f38d48282f5d3c95cbf9b3fa57269bb5d5c06828"
+
+[[package]]
+name = "libloading"
+version = "0.8.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fc2f4eb4bc735547cfed7c0a4922cbd04a4655978c09b54f1f7b228750664c34"
+dependencies = [
+ "cfg-if",
+ "windows-targets",
+]
+
+[[package]]
+name = "magnus"
+version = "0.6.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b1597ef40aa8c36be098249e82c9a20cf7199278ac1c1a1a995eeead6a184479"
+dependencies = [
+ "magnus-macros",
+ "rb-sys",
+ "rb-sys-env",
+ "seq-macro",
+]
+
+[[package]]
+name = "magnus-macros"
+version = "0.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5968c820e2960565f647819f5928a42d6e874551cab9d88d75e3e0660d7f71e3"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "memchr"
+version = "2.7.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "78ca9ab1a0babb1e7d5695e3530886289c18cf2f87ec19a575a0abdce112e3a3"
+
+[[package]]
+name = "minimal-lexical"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68354c5c6bd36d73ff3feceb05efa59b6acb7626617f4962be322a825e61f79a"
+
+[[package]]
+name = "nom"
+version = "7.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d273983c5a657a70a3e8f2a01329822f3b8c8172b73826411a55751e404a0a4a"
+dependencies = [
+ "memchr",
+ "minimal-lexical",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.93"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "60946a68e5f9d28b0dc1c21bb8a97ee7d018a8b322fa57838ba31cc878e22d99"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.38"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0e4dccaaaf89514f546c693ddc140f729f958c247918a13380cccc6078391acc"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rb-sys"
+version = "0.9.110"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "56cf964f8e44115e50009921ea3d3791b6f74d1ae6d6ed37114fbe03a1cd7308"
+dependencies = [
+ "rb-sys-build",
+]
+
+[[package]]
+name = "rb-sys-build"
+version = "0.9.110"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "161480347f56473107d4135643b6b1909331eec61445e113b256708a28b691c5"
+dependencies = [
+ "bindgen",
+ "lazy_static",
+ "proc-macro2",
+ "quote",
+ "regex",
+ "shell-words",
+ "syn",
+]
+
+[[package]]
+name = "rb-sys-env"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a35802679f07360454b418a5d1735c89716bde01d35b1560fc953c1415a0b3bb"
+
+[[package]]
+name = "regex"
+version = "1.11.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b544ef1b4eac5dc2db33ea63606ae9ffcfac26c1416a2806ae0bf5f56b201191"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-automata",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-automata"
+version = "0.4.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "809e8dc61f6de73b46c85f4c96486310fe304c434cfa43669d7b40f711150908"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-syntax"
+version = "0.8.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2b15c43186be67a4fd63bee50d0303afffcef381492ebe2c5d87f324e1b8815c"
+
+[[package]]
+name = "rustc-hash"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "08d43f7aa6b08d49f382cde6a7982047c3426db949b1424bc4b7ec9ae12c6ce2"
+
+[[package]]
+name = "seq-macro"
+version = "0.3.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a3f0bf26fd526d2a95683cd0f87bf103b8539e2ca1ef48ce002d67aad59aa0b4"
+
+[[package]]
+name = "shell-words"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "24188a676b6ae68c3b2cb3a01be17fbf7240ce009799bb56d5b1409051e78fde"
+
+[[package]]
+name = "shlex"
+version = "1.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
+
+[[package]]
+name = "syn"
+version = "2.0.98"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "36147f1a48ae0ec2b5b3bc5b537d267457555a10dc06f3dbc8cb11ba3006d3b1"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "thiserror"
+version = "2.0.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d452f284b73e6d76dd36758a0c8684b1d5be31f92b89d07fd5822175732206fc"
+dependencies = [
+ "thiserror-impl",
+]
+
+[[package]]
+name = "thiserror-impl"
+version = "2.0.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "26afc1baea8a989337eeb52b6e72a039780ce45c3edfcc9c5b9d112feeb173c2"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "00e2473a93778eb0bad35909dff6a10d28e63f792f16ed15e404fca9d5eeedbe"
+
+[[package]]
+name = "windows-targets"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9b724f72796e036ab90c1021d4780d4d3d648aca59e491e6b98e725b84e99973"
+dependencies = [
+ "windows_aarch64_gnullvm",
+ "windows_aarch64_msvc",
+ "windows_i686_gnu",
+ "windows_i686_gnullvm",
+ "windows_i686_msvc",
+ "windows_x86_64_gnu",
+ "windows_x86_64_gnullvm",
+ "windows_x86_64_msvc",
+]
+
+[[package]]
+name = "windows_aarch64_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3"
+
+[[package]]
+name = "windows_aarch64_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469"
+
+[[package]]
+name = "windows_i686_gnu"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b"
+
+[[package]]
+name = "windows_i686_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66"
+
+[[package]]
+name = "windows_i686_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66"
+
+[[package]]
+name = "windows_x86_64_gnu"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78"
+
+[[package]]
+name = "windows_x86_64_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d"
+
+[[package]]
+name = "windows_x86_64_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"

data/crates/itsi_error/Cargo.toml

@@ -0,0 +1,9 @@
+[package]
+name = "itsi_error"
+version = "0.1.0"
+edition = "2024"
+
+[dependencies]
+thiserror = "2.0.11"
+magnus = { version = "0.7.1" }
+rcgen = "0.13.2"

data/crates/itsi_error/src/lib.rs

@@ -0,0 +1,49 @@
+use thiserror::Error;
+
+pub type Result<T> = std::result::Result<T, ItsiError>;
+
+#[derive(Error, Debug)]
+pub enum ItsiError {
+    #[error("Invalid input")]
+    InvalidInput(String),
+    #[error("Internal server error")]
+    InternalServerError,
+    #[error("Unsupported protocol")]
+    UnsupportedProtocol(String),
+    #[error("Argument error")]
+    ArgumentError(String),
+    #[error("Jump")]
+    Jump(String),
+}
+
+impl From<ItsiError> for magnus::Error {
+    fn from(err: ItsiError) -> Self {
+        magnus::Error::new(magnus::exception::runtime_error(), err.to_string())
+    }
+}
+
+impl From<std::io::Error> for ItsiError {
+    fn from(err: std::io::Error) -> Self {
+        ItsiError::ArgumentError(err.to_string())
+    }
+}
+
+impl From<rcgen::Error> for ItsiError {
+    fn from(err: rcgen::Error) -> Self {
+        ItsiError::ArgumentError(err.to_string())
+    }
+}
+
+impl From<magnus::Error> for ItsiError {
+    fn from(err: magnus::Error) -> Self {
+        match err.error_type() {
+            magnus::error::ErrorType::Jump(tag) => ItsiError::Jump(tag.to_string()),
+            magnus::error::ErrorType::Error(_exception_class, cow) => {
+                ItsiError::ArgumentError(cow.to_string())
+            }
+            magnus::error::ErrorType::Exception(exception) => {
+                ItsiError::ArgumentError(exception.to_string())
+            }
+        }
+    }
+}