class DSL

The configuration DSL.

Example configuration file:

widget :power
widget :uptime, on_click: -> { spawn "alacritty -e htop&" }
widget :custom,
    interval: 1,
    on_click: -> { `notify-send #{@rand}` } do
    @rand = Random.rand 100
    "random value '#{@rand}'"
end

widget :button,
    on_click: -> { `notify-send hi` },
    class: "red" do
        "CLICK ME"
end

widget :load do |_, _, _, running| "tasks: #{running}" end
widget :load do |short| "5m avg: #{short}" end

class Widgets::Spinner < Widgets::Widget
    def initialize options
        super
        init_timer
        @spinner = Gtk::Spinner.new
        append @spinner
        @spinner.start
    end
end

widget :spinner

css <<CSS
box.red * {
    color: red;
}
CSS

Using instance_eval the configuration file is executed inside the context of this class.

Please check the public methods for this class for further documentation.

Entirely custom widgets¶ ↑

If you want a truly custom widget just make one. This code will create a spinner in your bar:

class Widgets::Spinner < Widgets::Widget
    def initialize options
        super
        init_timer
        @spinner = Gtk::Spinner.new
        append @spinner
        @spinner.start
    end
end

widget :spinner

Styling¶ ↑

See DSL#css.

Some implementation details¶ ↑

The DSL produces a hash in DSL#options.

This hash is then used to configure the bar. This hash is printed when rubybar is run in verbose mode.

The DSL#widget method also creates a hash that can then be used by Widgets::Widget::from_options to build a Widgets::Widget.

Attributes

options [R]

Public Class Methods

new (path)

Source

# File src/dsl.rb, line 77
def initialize path
  @options = {
    color: "white",
    background: "rgba(0, 0, 0, 0.5)",
    css: "",
    widgets: []
  }
  @separating = []
  instance_eval(File.read(path), path) if path
end

Public Instance Methods

background (value)

Source

# File src/dsl.rb, line 96
def background value
  @options[:background] = value
end

The window background color.

Defaults to "rgba(0, 0, 0, 0.5)".

color (value)

Source

# File src/dsl.rb, line 90
def color value
  @options[:color] = value
end

The default text color.

Defaults to "white".

css (css)

Source

# File src/dsl.rb, line 117
def css css
  @options[:css] = css
end

Add custom CSS.

This can be combined with the ability to configure a Widgets::Widget with a custom name and/or class for setting styles for a specific widget.

All the top-level widgets can be selected as box.barwidget.

Example:

css <<-END
   box.red * {
     color: red;
   }
   box.load#tasks * {
     color: green;
   }
END

separated (options={}) { || ... }

Source

# File src/dsl.rb, line 150
def separated options={}
  @separating << options
  yield
  @separating.pop
end

Place a Widgets::Separator between all widgets

separated do
  widget :button, on_click: -> {} do "clicky click" end
  widget :load do |_, _, _, running| "tasks: #{running}" end
  widget :load do |short| "5m avg: #{short}" end
end

This doesn’t stack.

You can also set standard widget options for the separators.

Just in case some crazy person wants to make all his separators clickable or something.

I don’t know what people are out there.

spacing (spacing)

Source

# File src/dsl.rb, line 134
def spacing spacing
  @options[:spacing] = spacing
end

Set the spacing for the top-level box widget.

All widgets will be spaced this amount apart.

Default is 10.

widget (type, options={})

Source

# File src/dsl.rb, line 122
def widget type, options={}, &block
  # optionally place a separator
  unless @separating.empty?
    @options[:widgets] << @separating.last.merge({type: :separator})
  end

  @options[:widgets] << options.merge({type: type, proc: block})
end

Configure a Widgets::Widget for your bar.