skyward-core 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 62d2a29c63a5a5d186f8e242973a3ea30ac592fc1b2744c08f05d747fb497322
+  data.tar.gz: aa16ded8ef75a94d5035cbdac2d6211b42cce715eb266caab5e182b98f2b2e98
+SHA512:
+  metadata.gz: 0e12b24e78b4f8b66af5d052312b45100c86392e9c3c12cf11c5f9b8541b4e62b6d42679697c7b530f03ed3f64a6d136377ff19c4e1d2446aebec0e9089e2ec7
+  data.tar.gz: 7a763b2d9c480ba962204fa586b90bdc7a22c3a33c3f75914028dd13f650ea5906132fc27530c05a6054a3c2fb1c12c1f19157936bb16f1c17250ef52a1cdfa7

data/README.md

@@ -0,0 +1,34 @@
+# Skyward Core
+
+> [!CAUTION]
+> **Work in progress: Skyward Core doesn't do anything yet.** Version 0.1 is a skeleton. The gems install and load, but none of the features described here are built. This README is the spec for what's coming, not documentation of what exists. Don't depend on it yet.
+
+The plumbing that [Skyward API](../skyward-api/README.md) and [Skyward ORM](../skyward-orm/README.md) share. You don't add it to your Gemfile: each of them depends on it, at exactly the same version.
+
+## What it owns
+
+- **The `Skyward` namespace.** Skyward Core opens it, and every Skyward gem's Zeitwerk loader extends it.
+- **The `skyward` command.** It comes with Skyward Core, so it's there whichever Skyward gems you install. Each gem adds its own commands to it.
+- **Loading RBS signatures.** One loader finds your app's signatures and those of the gems it uses, for every Skyward gem.
+- **Reading RBS types.** One reader turns a signature into values that Skyward API and Skyward ORM each build their own mappings on, so a `Todo` read from the database and a `Todo` sent as JSON are the same thing.
+- **`Skyward::BootError`**, which every Skyward gem raises when your app can't boot, saying why.
+
+## Adding commands
+
+The `skyward` executable finds each installed gem's `lib/skyward/<gem>/commands.rb` with `Gem.find_files` and loads it, and that file registers the gem's commands:
+
+```ruby
+Skyward::Commands.register("routes", "List every route and the method that serves it") do |args|
+  # ...
+end
+```
+
+`skyward` with no command, or `skyward help`, lists every registered command with its description. An unknown command prints the same list and exits with status 1. A command fails by exiting (`abort "why"`); one that returns has succeeded.
+
+## Ruby
+
+Skyward supports every Ruby that isn't end-of-life (3.3 and later, as of November 2026).
+
+## Status
+
+This README is the spec. Skyward 0.1 is a skeleton: the gem installs, opens the `Skyward` namespace and sets up its loader, and nothing else is built yet. This section lists each part as it lands.

data/lib/skyward/core/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Skyward
+  module Core
+    VERSION = "0.1.0" #: String
+  end
+end

data/lib/skyward/core.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require "zeitwerk"
+require_relative "core/version"
+
+# Skyward Core owns the Skyward namespace: its version.rb opens it, and every
+# Skyward gem's loader, this one included, extends it.
+loader = Zeitwerk::Loader.for_gem_extension(Skyward)
+loader.setup

data/sig/generated/skyward/core/version.rbs

@@ -0,0 +1,7 @@
+# Generated from lib/skyward/core/version.rb with RBS::Inline
+
+module Skyward
+  module Core
+    VERSION: String
+  end
+end

data/sig/generated/skyward/core.rbs

@@ -0,0 +1,2 @@
+# Generated from lib/skyward/core.rb with RBS::Inline
+

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: skyward-core
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jake Bottrall
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+email:
+- jakebottrall@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/skyward/core.rb
+- lib/skyward/core/version.rb
+- sig/generated/skyward/core.rbs
+- sig/generated/skyward/core/version.rbs
+homepage: https://github.com/bottrall/skyward
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/bottrall/skyward
+  source_code_uri: https://github.com/bottrall/skyward/tree/main/skyward-core
+  changelog_uri: https://github.com/bottrall/skyward/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/bottrall/skyward/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.20
+specification_version: 4
+summary: 'The plumbing Skyward API and Skyward ORM share: the namespace, the skyward
+  command and RBS loading.'
+test_files: []