Creating a gem basics in Ruby - Try It Yourself

Creating a gem basics

📖 Scenario: You want to create a simple Ruby gem that can be shared and reused by others. A gem is like a small package of Ruby code that does something useful.In this project, you will create the basic files and structure needed for a Ruby gem, add a version number, write a simple method, and then print the result.

🎯 Goal: Build a basic Ruby gem structure with a version file and a main file that defines a simple method. Then print the output of that method.

📋 What You'll Learn

Create a gem folder structure with a main file and a version file

Define a module with a version constant

Add a method inside the module that returns a greeting string

Print the greeting string to the console

💡 Why This Matters

🌍 Real World

Ruby gems are used to share reusable code with other developers easily. Creating a gem helps organize your code and distribute it.

💼 Career

Many Ruby developers create and maintain gems as part of their work to build libraries, tools, or frameworks used by others.

1

Create the gem module and version constant

Create a Ruby module called SimpleGem. Inside it, define a constant VERSION and set it to the string "0.1.0".

Ruby

# Your code here

Hint

Use module SimpleGem to start and VERSION = "0.1.0" inside it.

2

Add a greeting method inside the module

Inside the SimpleGem module, define a method called greet that returns the string "Hello from SimpleGem!".

Ruby

module SimpleGem
  VERSION = "0.1.0"

  # Your code here
end

Hint

Define a class method using def self.greet that returns the greeting string.

3

Call the greeting method and store the result

Call the greet method from the SimpleGem module and store the returned string in a variable called message.

Ruby

module SimpleGem
  VERSION = "0.1.0"

  def self.greet
    "Hello from SimpleGem!"
  end
end

# Your code here

Hint

Use message = SimpleGem.greet to call the method and save the result.

4

Print the greeting message

Print the variable message to the console using puts.

Ruby

module SimpleGem
  VERSION = "0.1.0"

  def self.greet
    "Hello from SimpleGem!"
  end
end

message = SimpleGem.greet

# Your code here

Hint

Use puts message to show the greeting on the screen.

Practice

1. What is the main purpose of a Ruby gem?

easy

A. To compile Ruby code into machine language

B. To package and share reusable Ruby code

C. To create graphical user interfaces

D. To manage Ruby versions on your system

Solution

1. Step 1: Understand what a gem is

   A gem is a package that contains Ruby code that can be reused in different projects.

2. Step 2: Identify the main purpose

   The main purpose is to share and reuse code easily across Ruby projects.

3. Final Answer:

   To package and share reusable Ruby code -> Option B

4. Quick Check:

   Gem = reusable Ruby package [OK]

Hint: Gems are for sharing code, not compiling or GUIs [OK]

Common Mistakes:

• Thinking gems compile Ruby code
• Confusing gems with Ruby version managers
• Assuming gems create user interfaces

2. Which file is essential to define a Ruby gem's metadata and dependencies?

easy

A. README.md

B. Gemfile

C. Rakefile

D. gemspec

Solution

1. Step 1: Identify gem metadata file

   The gemspec file (.gemspec) defines the gem's name, version, authors, and dependencies.

2. Step 2: Differentiate from other files

   Gemfile manages project dependencies, Rakefile defines tasks, README.md is documentation.

3. Final Answer:

   gemspec -> Option D

4. Quick Check:

   Metadata and dependencies = gemspec [OK]

Hint: gemspec holds gem info; Gemfile is for app dependencies [OK]

Common Mistakes:

• Confusing Gemfile with gemspec
• Thinking README.md defines dependencies
• Assuming Rakefile holds gem metadata

3. Given this gemspec snippet, what is the gem's version?

Gem::Specification.new do |spec|
  spec.name        = "my_gem"
  spec.version     = "0.2.5"
  spec.summary     = "A sample gem"
end

medium

A. "0.2.5"

B. "2.5"

C. "0.2.0"

D. "1.0.0"

Solution

1. Step 1: Locate the version assignment

   The line spec.version = "0.2.5" sets the gem's version.

2. Step 2: Confirm the exact version string

   The version is exactly "0.2.5" as given in the code.

3. Final Answer:

   "0.2.5" -> Option A

4. Quick Check:

   Version in gemspec = "0.2.5" [OK]

Hint: Look for spec.version assignment in gemspec [OK]

Common Mistakes:

• Picking partial version like "0.2.0"
• Confusing version with gem name
• Assuming default version "1.0.0"

4. This gemspec file has an error. What is it?

Gem::Specification.new do |spec|
  spec.name = "example_gem"
  spec.version = 1.0.0
  spec.summary = "Example gem"
end

medium

A. Version should be a string, not a number

B. Missing spec.authors field

C. spec.name cannot have underscores

D. spec.summary must be longer than 20 characters

Solution

1. Step 1: Check version format

   The version is written as 1.0.0 without quotes, which Ruby treats as a numeric expression causing error.

2. Step 2: Correct version format

   Version must be a string like "1.0.0" with quotes to be valid.

3. Final Answer:

   Version should be a string, not a number -> Option A

4. Quick Check:

   Version must be string in gemspec [OK]

Hint: Always quote version strings in gemspec [OK]

Common Mistakes:

• Leaving version unquoted
• Thinking underscores are invalid in gem names
• Assuming summary length is strictly enforced

5. You want to create a gem that provides a method greet returning "Hello!". Which file structure and code snippet is correct? Options: A)

my_gem/
  lib/
    my_gem.rb
  my_gem.gemspec

# lib/my_gem.rb
module MyGem
  def self.greet
    "Hello!"
  end
end

B)

my_gem/
  src/
    greet.rb
  gemspec.rb

# src/greet.rb
class Greet
  def greet
    puts "Hello!"
  end
end

C)

my_gem/
  lib/
    greet.rb
  my_gem.gemspec

# lib/greet.rb
module Greet
  def greet
    "Hello!"
  end
end

D)

my_gem/
  lib/
    my_gem.rb
  my_gem.gemspec

# lib/my_gem.rb
def greet
  "Hello!"
end

hard

A. Wrong file name and missing self for method

B. Wrong folder and gemspec name; greet is instance method

C. Correct structure with module and class method greet

D. Method defined outside module, no namespacing

Solution

1. Step 1: Check folder and file structure

   Ruby gems use lib/ folder and a gemspec named after the gem. Correct structure with module and class method greet uses lib/my_gem.rb and my_gem.gemspec, which is correct.

2. Step 2: Verify code correctness

   Correct structure with module and class method greet defines a module MyGem with a class method self.greet returning "Hello!", which is the right way to provide a gem method.

3. Final Answer:

   Correct structure with module and class method greet -> Option C

4. Quick Check:

   lib folder + module + self method = correct gem code [OK]

Hint: Use lib folder and module with self.method for gem code [OK]

Common Mistakes:

• Using wrong folder names like src
• Defining instance instead of class methods
• Not namespacing methods inside a module