header typing

ruby gem version author

yuurisan is a Ruby gem that prints a styled ASCII art banner and sets the terminal tab title for your Ruby bots and scripts.
Drop it into any Ruby project and call one method to get a clean startup banner with your bot name, community link, and timestamp -- styled with ANSI colors that match the Python colorama palette used across Yuurisandesu's projects.
Built and distributed by Yuurisandesu.

Table of Contents

Requirements

  • Ruby 3.2+
  • RubyGems

Installation

Add to your Gemfile:

gem "yuurisan"

Then run:

bundle install

Or install directly:

gem install yuurisan

Usage

Require the gem and call Yuurisan.banner at the top of your bot or script:

require "yuurisan"

Yuurisan.banner("My Bot Name")

This clears the terminal, prints the ASCII art banner, and sets the terminal tab title all in one call.

To set only the terminal title without printing the banner:

Yuurisan.set_title("My Bot Name")

Example output in the terminal:

__   __                _                     _
\ \ / /   _ _   _ _ __(_)___  __ _ _ __   __| | ___  ___ _   _
 \ V / | | | | | | '__| / __|/ _` | '_ \ / _` |/ _ \/ __| | | |
  | || |_| | |_| | |  | \__ \ (_| | | | | (_| |  __/\__ \ |_| |
  |_| \__,_|\__,_|_|  |_|___/\__,_|_| |_|\__,_|\___||___/\__,_|

Welcome to Yuuri's My Bot Name
Join our community: https://t.me/Y3YuYuYo
Current time: 13-08-2026 12:00:00

API Reference

Yuurisan.banner(bot_name)

Clears the terminal, renders the Yuurisandesu ASCII art in cyan bold using the standard figlet font via the artii gem, then prints the welcome line, community link, and current timestamp. Also sets the terminal tab title.

Parameter Type Description
bot_name String Name of your bot, shown in the welcome line and terminal title

Yuurisan.set_title(bot_name)

Sets the terminal tab title to <bot_name> by : 佐賀県産 (YUURI) using an ANSI escape sequence. Works on xterm, iTerm2, GNOME Terminal, and Windows Terminal.

Parameter Type Description
bot_name String Name of your bot, shown in the terminal tab title

File Structure

Yuurisan-rb/
├── .github/
│   └── workflows/
│       └── publish.yml          # CI: publish gem to RubyGems on version tag push
├── lib/
│   ├── yuurisan.rb              # Main entry point, exposes Yuurisan.banner and Yuurisan.set_title
│   └── yuurisan/
│       ├── banner.rb            # ASCII art rendering and ANSI color output
│       ├── title.rb             # Terminal tab title setter via ANSI escape
│       └── version.rb           # Gem version constant (1.0.2)
├── LICENSE
└── .gitignore

Disclaimer

This tool is built for educational and technical exploration purposes. Use it wisely and at your own responsibility.

footer