Environment and CLI

Contents
ENV variables
ARGV
OptionParser
Exit codes

ENV variables

Programs read their configuration from ENV, which maps process environment variables by name.

Fetch with a fallback keeps development simple while production passes the real value.

mode = ENV.fetch("APP_MODE", "development") puts mode

APP_MODE=production ruby app.rb

production

ARGV

Command line arguments arrive in ARGV as an array of strings.

Length counts the arguments and first reads the leading one.

puts ARGV.length puts ARGV.first

ruby args.rb one two

2
one

OptionParser

OptionParser turns flags such as verbose into an options hash with help text built in.

The on call registers each flag, and parse! consumes the flags from ARGV.

require "optparse" options = { verbose: false } OptionParser.new do |parser| parser.on("-v", "--verbose", "Run verbosely") do options[:verbose] = true end end.parse! p options

ruby flags.rb --verbose

{:verbose=>true}

Exit codes

A nonzero exit status signals failure to the shell and to calling scripts.

Warn writes the complaint to standard error, and exit 1 stops the program with status 1.

if ARGV.empty? warn("Need a file name") exit(1) end puts "Got #{ARGV.first}"

ruby check.rb

Need a file name

Next: Logging

Article author: Arthur Isaev

Related articles
Ruby
Ruby course: zero to hero in 50 lessons
What is Ruby and where it runs
Install Ruby and check the version
irb: the interactive shell
Your first Ruby script
Variables
Numbers
Strings
Symbols
Truthiness: only false and nil
Conditions
Loops
Arrays
Hashes
Ranges
Methods
Blocks, procs, lambdas
String tools
Files and IO
Exceptions
Modules and mixins
Classes and objects
Inheritance
Enumerables
Duck typing and core idioms
Gems and Bundler
Testing with Minitest
Debugging
Encodings
Time and date
JSON and YAML
HTTP clients
Sockets
REST APIs
puts, print and p
Metaprogramming
Enumerators
Pattern matching
Arguments: splats and kwargs
Rake tasks
Environment and CLI
Logging
CSV
ERB templates
WEBrick server
Rails in one lesson
Capstone: todo CLI
Capstone: JSON API
Performance
Modern Ruby tour
Hero roadmap: the whole course on one page
Install Ruby on Windows 11
Install Ruby on Ubuntu
Install Ruby on Rocky Linux
Install Ruby on macOS
Install Ruby on FreeBSD
Ruby in Docker
Threads and fibers

Search this site

Channel @aofeed Chat @aofeedchat

Contacts and cooperation:
I recommend our hosting beget.ru
Write to info@urn.su, info@aredel.com if you:
1. Want to write an article for our site or translate an article into your native language.
2. Want to place thematically relevant ads on the site.
3. Ads on my site pass maximum censorship. If you see an ad block unsuitable for school-age children, shocking or misleading - please contact us by e-mail
4. Found a mistake, inaccuracy, bug, etc. on the site. ... .......
5. Articles can be shared on social media by clicking a network icon: