guardship 0.2.0-amd64-freebsd

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 97711bf66111c592144081c6543991a44b5c6bf4bd8b2ba9f63265053674413b
+  data.tar.gz: 71fceda326f6790c7dc9a04643f5826b5aed24ceb71e33e3a836a8d67c520124
+SHA512:
+  metadata.gz: ea5cc9fb925923ee2a04cee9ddd07cd0604914d45784964931ee70289cf59a17e23e3d78dde62e5b7f62cbf6114d7c31ac126ccf2eddcdfc231496fc47c854b3
+  data.tar.gz: 2791c8d7daa8b304ccca73460c4e6278fcf7c97d451d7b023a9c4b3bc21cac70222956c25b71d68f3fa50c309e28b82594723ea2b37ff27337d4cca89e844961

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Abdelkader Boudih
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,95 @@
+# Guardship
+
+Ruby wrapper and release packaging for [Mothership](https://github.com/seuros/mothership), the process supervisor with HTTP exposure.
+
+## Installation
+
+RubyGems should resolve the matching platform gem automatically on supported targets:
+
+```bash
+gem install guardship
+```
+
+The generic `guardship` gem is a stub. Platform-specific releases carry the bundled native `mothership` binary.
+
+## What Is Included
+
+- Stub gem:
+  - Ruby launcher only
+  - no bundled native binary
+- Platform gems:
+  - `mothership` native binary under `libexec/`
+  - default feature set only
+
+## Usage
+
+```bash
+mothership --config mothership.toml
+```
+
+If you install the stub gem directly on a platform without a matching packaged binary, the launcher will tell you that no bundled binary is present.
+
+## Supported Platforms
+
+- Linux: `x86_64-linux`, `aarch64-linux`
+- macOS: `x86_64-darwin`, `arm64-darwin`
+
+All packaged binaries are precompiled. No local Rust toolchain is required to run the gem.
+
+## Release Workflow
+
+The release build produces one stub gem and one platform gem for each supported target. Run it from the repository root after the Rust crate and gem versions have been bumped together.
+
+```bash
+just build
+cd gem
+bundle exec rake gem:build
+mise exec zig@0.17.0 -- bundle exec rake platforms:build
+```
+
+`platforms:build` is the common ecosystem entry point for `gem:build_platforms`.
+It compiles and packages every supported platform; it does not publish anything.
+The full matrix needs a macOS host with the Apple SDK for both Darwin targets,
+Rust/rustup, `cargo-zigbuild`, and Zig for Linux and FreeBSD. Missing Rust targets are
+installed automatically, and a failed build stops packaging rather than
+substituting a host binary.
+
+Together with `gem:build`, these tasks build:
+
+- `guardship-VERSION.gem`
+- `guardship-VERSION-arm64-darwin.gem`
+- `guardship-VERSION-x86_64-darwin.gem`
+- `guardship-VERSION-aarch64-linux.gem`
+- `guardship-VERSION-x86_64-linux.gem`
+- `guardship-VERSION-amd64-freebsd.gem`
+
+Linux platform gems are built with `cargo zigbuild` through the configured Zig toolchain. The task uses glibc-versioned targets by default:
+
+- `x86_64-unknown-linux-gnu.2.36`
+- `aarch64-unknown-linux-gnu.2.36`
+
+The FreeBSD gem is cross-built for FreeBSD 15 and later: `libc` is compiled for
+FreeBSD 15's struct layouts (`--cfg libc_unstable_freebsd_version="15"`; the
+crate defaults to FreeBSD 12), and it links only symbol versions FreeBSD 15
+provides. Its gem platform is `amd64-freebsd`, the CPU name FreeBSD's Ruby
+reports, without a release so FreeBSD 16 matches too.
+
+The glibc floor can be changed for a release with `GUARDSHIP_GLIBC_VERSION=2.xx`. Do not use the plain `*-unknown-linux-gnu` Zig targets for the local all-platform release; Rama DNS links resolver symbols such as `res_nquery` require the glibc-versioned target.
+
+Publish after the artifacts are present:
+
+```bash
+bundle exec rake gem:push
+# or
+bundle exec rake gem:push_all
+```
+
+## Documentation
+
+- [Main Repository](https://github.com/seuros/mothership)
+- [Configuration Guide](https://github.com/seuros/mothership#configuration)
+- [API Documentation](https://docs.rs/mothership)
+
+## License
+
+MIT

data/exe/mothership

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+binary = File.expand_path("../libexec/mothership", __dir__)
+
+unless File.file?(binary)
+  warn "guardship stub gem installed: no bundled mothership binary was found at #{binary}."
+  warn "Install a platform-specific guardship gem release, or use cargo install mothership."
+  exit 1
+end
+
+exec binary, *ARGV

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: guardship
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: amd64-freebsd
+authors:
+- Abdelkader Boudih
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: Platform-specific Mothership gem with a bundled native binary.
+email:
+- oss@seuros.com
+executables:
+- mothership
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- exe/mothership
+- libexec/mothership
+homepage: https://github.com/seuros/mothership
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/seuros/mothership
+  changelog_uri: https://github.com/seuros/mothership/blob/master/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '4.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: Mothership gem wrapper
+test_files: []