ruby-repo-canary 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e4339b12d04645ef481d8d832d9088d4c0462b0ffd273aa3004384a41ffbf3ca
+  data.tar.gz: 5616fc641573c9d984cd22c3ff84b63545f59f513581ead4ae3a8b1fab53cd95
+SHA512:
+  metadata.gz: ed8921af0d0508ac34b4492c2e5ccc2373f25a6cd4f7b11aed1ff94964dcf1298ea901ac92b06eeb2b7101fa2dc6e0282deb238bff40de5698553e6342dc6876
+  data.tar.gz: 1b52baa94d00ec46e2f30e06e501e2a793fe20b30f3dc20718a69274a65feae48d8efe0451e843dbc686fc1448b5a16e8fc621dea3ade8763929db44b5f1a76e

data/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+All notable user-visible changes are documented here.
+
+## [Unreleased]
+
+## [0.1.0] - 2026-10-05
+
+### Added
+
+- Initial text-printing CLI with help, version and predictable exit statuses.
+
+[Unreleased]: https://github.com/hvpaiva/ruby-repo-canary/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/hvpaiva/ruby-repo-canary/releases/tag/v0.1.0

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Highlander Paiva
+
+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,53 @@
+# ruby-repo-canary
+
+A small Ruby CLI that prints its text arguments separated by spaces.
+
+Requires Ruby 3.4 or newer. This initial implementation has no external service
+dependencies.
+
+## Usage
+
+    ruby-repo-canary hello world
+    ruby-repo-canary --help
+    ruby-repo-canary --version
+    ruby-repo-canary -- --text-starting-with-a-dash
+
+Successful output goes to stdout. Invalid options and missing text go to stderr
+with exit status 2. A closed output pipe exits cleanly.
+
+## Install from source
+
+    gem build ruby-repo-canary.gemspec
+    gem install ./ruby-repo-canary-0.1.0.gem
+
+This repository's creation does not publish the gem or reserve its name.
+After a release has actually been published, RubyGems installation is available:
+
+    gem install ruby-repo-canary
+
+## Development
+
+    bin/setup
+    bundle exec rake check
+    bundle exec rake audit
+
+Commit Gemfile.lock after dependency installation. It pins development tools;
+users installing the gem resolve the dependencies declared in its gemspec.
+The versioned ruby-repo-kit development dependency supplies repository and release
+operations. That gem version must be available from the configured source before
+contributors or hosted CI can install the development bundle.
+
+Local checks include Ruby linting, tests with coverage (90% lines, 80% branches),
+repository checks and installation of the built package.
+The separate audit task updates a vulnerability database and
+needs network access. CI additionally checks pull-request commits and exercises
+Ruby 3.4/4.0 on Linux and Ruby 4.0 on macOS. These are configured checks, not a
+claim that a new repository has already passed them.
+
+See [contributing](CONTRIBUTING.md), [architecture](ARCHITECTURE.md),
+[security](SECURITY.md), [conduct](CODE_OF_CONDUCT.md), and
+[release setup](docs/releasing.md).
+
+## License
+
+MIT. See [LICENSE.txt](LICENSE.txt).

data/SECURITY.md

@@ -0,0 +1,11 @@
+# Security
+
+Report suspected vulnerabilities privately to contact@hvpaiva.dev. Include the affected
+version, impact and a minimal reproduction; do not disclose private credentials.
+Please avoid a public issue until maintainers have coordinated a fix.
+
+Security fixes target the latest released version. If no version has been
+published yet, report issues against the current main branch.
+
+The project does not promise a response deadline. Maintainers will assess the
+report, agree on disclosure where possible, and document any published fix.

data/exe/ruby-repo-canary

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "ruby_repo_canary"
+
+exit RubyRepoCanary::CLI.run(ARGV)

data/lib/ruby_repo_canary/cli.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "optparse"
+
+require_relative "version"
+
+module RubyRepoCanary
+  class CLI
+    def self.run(argv, out: $stdout, err: $stderr)
+      new(out: out, err: err).run(argv)
+    end
+
+    def initialize(out:, err:)
+      @out = out
+      @err = err
+    end
+
+    def run(argv)
+      arguments = argv.dup
+      requested = nil
+      parser = OptionParser.new do |options|
+        options.banner = "Usage: ruby-repo-canary [options] TEXT..."
+        options.separator ""
+        options.separator "Print text, separating arguments with spaces."
+        options.on("-h", "--help", "Show this help") { requested = :help }
+        options.on("-v", "--version", "Show the version") { requested = :version }
+      end
+      parser.parse!(arguments)
+      return print_result(parser.to_s) if requested == :help
+      return print_result(VERSION) if requested == :version
+
+      raise OptionParser::MissingArgument, "TEXT (see --help)" if arguments.empty?
+
+      print_result(arguments.join(" "))
+    rescue OptionParser::ParseError => e
+      @err.puts "ruby-repo-canary: #{e.message}"
+      2
+    rescue Errno::EPIPE
+      0
+    end
+
+    private
+
+    def print_result(value)
+      @out.puts value
+      @out.flush
+      0
+    end
+  end
+end

data/lib/ruby_repo_canary/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module RubyRepoCanary
+  VERSION = "0.1.0"
+end

data/lib/ruby_repo_canary.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative "ruby_repo_canary/version"
+require_relative "ruby_repo_canary/cli"

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: ruby-repo-canary
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Highlander Paiva
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: optparse
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.6'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.6'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1'
+description: Prints positional arguments separated by spaces; includes help and version
+  commands.
+email:
+- contact@hvpaiva.dev
+executables:
+- ruby-repo-canary
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- SECURITY.md
+- exe/ruby-repo-canary
+- lib/ruby_repo_canary.rb
+- lib/ruby_repo_canary/cli.rb
+- lib/ruby_repo_canary/version.rb
+homepage: https://github.com/hvpaiva/ruby-repo-canary
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/hvpaiva/ruby-repo-canary
+  bug_tracker_uri: https://github.com/hvpaiva/ruby-repo-canary/issues
+  changelog_uri: https://github.com/hvpaiva/ruby-repo-canary/blob/main/CHANGELOG.md
+  documentation_uri: https://github.com/hvpaiva/ruby-repo-canary#readme
+  rubygems_mfa_required: 'true'
+  allowed_push_host: https://rubygems.org
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.20
+specification_version: 4
+summary: A small command-line tool that prints text
+test_files: []