theforeman/foreman · error · Foreman::Exception

Invalid version format, please enter in x.y (only major vers

Error message

Invalid version format, please enter in x.y (only major version).

What it means

Error "Invalid version format, please enter in x.y (only major version)." thrown in theforeman/foreman.

Source

Thrown at app/services/foreman/deprecation.rb:10

module Foreman
  class Deprecation
    # deadline_version - is the version the deprecation is going to be deleted, the format must be a major release e.g "1.8"
    def self.deprecation_warning(foreman_version_deadline, info)
      check_version_format foreman_version_deadline
      ActiveSupport::Deprecation.warn("You are using a deprecated behavior, it will be removed in version #{foreman_version_deadline}, #{info}", caller_locations(2))
    end

    def self.check_version_format(foreman_version_deadline)
      raise Foreman::Exception.new(N_("Invalid version format, please enter in x.y (only major version).")) unless foreman_version_deadline.to_s =~ /\A\d[.]\d+\z/
    end

    def self.api_deprecation_warning(info)
      Foreman::Logging.logger('api_deprecations').warn(info)
    end

    def self.renderer_deprecation(foreman_version_deadline, method, new_method)
      check_version_format foreman_version_deadline
      called_from_params = false
      caller.each_with_index do |item, index|
        called_from_params = true if item =~ /host_params\.rb.*params/
        return if called_from_params && item.match(/host_info_extensions\.rb.*info/)
        next unless item =~ /renderer\.rb.*render_safe/
        Rails.logger.warn "DEPRECATION WARNING: you are using deprecated @host.#{method} in a template, it will be removed in #{foreman_version_deadline}. Use #{new_method} instead."
        return
      end
    end
  end

View on GitHub (pinned to 6b05625475)

When it happens

Trigger: Thrown at app/services/foreman/deprecation.rb:10 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of theforeman/foreman@6b05625475 (2026-08-23). Data as JSON: /api/errors/d4cfba739e8824ab. Report an issue: GitHub.