Module: Ree

Extended by:
Args
Defined in:
lib/ree.rb,
lib/ree/cli.rb,
lib/ree/gen.rb,
lib/ree/version.rb,
lib/ree/cli/init.rb,
lib/ree/gen/init.rb,
lib/ree/gen/package.rb,
lib/ree/spec_runner.rb,
lib/ree/cli/indexing.rb,
lib/ree/cli/spec_runner.rb,
lib/ree/cli/generate_package.rb,
lib/ree/cli/generate_template.rb,
lib/ree/cli/indexing/index_file.rb,
lib/ree/cli/indexing/index_package.rb,
lib/ree/cli/indexing/index_project.rb,
lib/ree/cli/generate_packages_schema.rb

Defined Under Namespace

Modules: Args, BeanDSL, CLI, Contracts, FnDSL, Gen, Inspectable, LinkDSL, ObjectSchema, PackageDSL, PackagesSchema, RSpecLinkDSL, SpecRunner Classes: BuildPackageDsl, Container, DomainError, Error, ErrorDsl, ImportDsl, LinkImportBuilder, LinkValidator, Object, ObjectCompiler, ObjectDsl, ObjectError, ObjectLink, Package, PackageDep, PackageEnvVar, PackageFileStructureLoader, PackageLoader, PackagesDetector, PackagesFacade, PackagesSchemaBuilder, PackagesSchemaLoader, PackagesSchemaLocator, PackagesStore, PathHelper, ReeGem, RenderUtils, StringUtils, TemplateDetector, TemplateHandler, TemplateRenderer

Constant Summary collapse

PACKAGE = 
'package'
SCHEMAS = 
'schemas'
SCHEMA = 
'schema'
REE_SETUP = 
'ree.setup.rb'
PACKAGES_SCHEMA_FILE = 
'Packages.schema.json'
ROOT_DIR_MESSAGE = 
'Ree.root_dir is not set. Use Ree.init(DIR) to set project dir'
VERSION = 
"1.1.1"

Class Method Summary collapse

Methods included from Args

check_arg, check_arg_any, check_arg_array_of, check_bool, not_nil

Class Method Details

.container ⇒ Object 



77
78
79
 
# File 'lib/ree.rb', line 77

def container
  Container.instance
end

.disable_contracts ⇒ Object 



100
101
102
 
# File 'lib/ree.rb', line 100

def disable_contracts
  ENV['NO_CONTRACTS'] = 'true'
end

.disable_irb_mode ⇒ Object 



96
97
98
 
# File 'lib/ree.rb', line 96

def disable_irb_mode
  @irb_mode = false
end

.enable_contracts ⇒ Object 



104
105
106
 
# File 'lib/ree.rb', line 104

def enable_contracts
  ENV['NO_CONTRACTS'] = nil
end

.enable_irb_mode ⇒ Object

Switches Ree into irb mode that allows to declare ree objects inside IRB



92
93
94
 
# File 'lib/ree.rb', line 92

def enable_irb_mode
  @irb_mode = true
end

.gem(name) ⇒ Nilor[Ree::ReeGem]

Parameters:

  • name (Symbol)

Returns:



157
158
159
160
 
# File 'lib/ree.rb', line 157

def gem(name)
  check_arg(name, :name, Symbol)
  gems.detect { _1.name == name }
end

.gems ⇒ Object 



162
163
164
165
 
# File 'lib/ree.rb', line 162

def gems
  @gems ||= []
  @gems
end

.init(dir, irb: false) ⇒ Object 



127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
 
# File 'lib/ree.rb', line 127

def init(dir, irb: false)
  check_arg(dir, :dir, String)

  if !Dir.exist?(dir)
    raise Ree::Error.new("Dir does not exist: #{dir}", :invalid_root_dir)
  end

  @packages_schema_path = locate_packages_schema(dir)
  @root_dir = Pathname.new(@packages_schema_path).dirname.to_s

  ree_setup_path = File.join(@root_dir, REE_SETUP)

  if File.exist?(ree_setup_path)
    require(ree_setup_path)
  end

  if irb
    require('irb')
    enable_irb_mode

    FileUtils.cd(@root_dir) do
      IRB.start(@root_dir)
    end
  end

  @root_dir
end

.irb_mode? ⇒ Boolean

Returns:

  • (Boolean) 


108
109
110
 
# File 'lib/ree.rb', line 108

def irb_mode?
  !!@irb_mode
end

.load_entire_package(name) ⇒ Object 



202
203
204
205
 
# File 'lib/ree.rb', line 202

def load_entire_package(name)
  check_arg(name, :name, Symbol)
  container.load_entire_package(name)
end

.load_package(name) ⇒ Object 



197
198
199
200
 
# File 'lib/ree.rb', line 197

def load_package(name)
  check_arg(name, :name, Symbol)
  container.load_package(name)
end

.locate_packages_schema(path) ⇒ Object 



207
208
209
210
211
 
# File 'lib/ree.rb', line 207

def locate_packages_schema(path)
  check_arg(path, :path, String)
  Ree.logger.debug("locate_packages_schema: #{path}")
  Ree::PackagesSchemaLocator.new.call(path)
end

.logger ⇒ Object 



81
82
83
84
85
86
87
88
89
 
# File 'lib/ree.rb', line 81

def logger
  @logger ||= begin
    logger = Logger.new(STDOUT)
    logger.level = Logger::WARN
    logger
  end

  @logger
end

.packages_schema_path ⇒ Object 



213
214
215
 
# File 'lib/ree.rb', line 213

def packages_schema_path
  @packages_schema_path || (raise Ree::Error.new(ROOT_DIR_MESSAGE, :invalid_root_dir))
end

.preload_for(env) ⇒ Object

Define preload context for registered objects



117
118
119
120
 
# File 'lib/ree.rb', line 117

def preload_for(env)
  check_arg(env, :env, Symbol)
  @prelaod_for = env
end

.preload_for?(env) ⇒ Boolean

Returns:

  • (Boolean) 


122
123
124
125
 
# File 'lib/ree.rb', line 122

def preload_for?(env)
  check_arg(env, :env, Symbol)
  @prelaod_for == env
end

.register_gem(gem_name, dir) ⇒ Ree::ReeGem

Returns ].

Parameters:

  • name (Symbol)
  • dir (String)

Returns:



170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
 
# File 'lib/ree.rb', line 170

def register_gem(gem_name, dir)
  check_arg(gem_name, :gem_name, Symbol)
  check_arg(dir, :dir, String)

  if gem(gem_name)
    raise Ree::Error.new("Ree already registered gem `#{name}`", :duplicate_gem)
  end

  if !Dir.exist?(dir)
    raise Ree::Error.new("Dir does not exist: #{dir}", :invalid_gem_dir)
  end

  dir = File.expand_path(dir)
  packages_schema_path = locate_packages_schema(dir)
  gem_dir = Pathname.new(packages_schema_path).dirname.to_s
  ree_setup_path = File.join(gem_dir, REE_SETUP)

  if File.exist?(ree_setup_path)
    require(ree_setup_path)
  end

  gem = ReeGem.new(gem_name, gem_dir, packages_schema_path)
  @gems.push(gem)

  gem
end

.root_dir ⇒ Object 



217
218
219
 
# File 'lib/ree.rb', line 217

def root_dir
  @root_dir || (raise Ree::Error.new(ROOT_DIR_MESSAGE, :invalid_root_dir))
end

.set_logger_debug ⇒ Object 



112
113
114
 
# File 'lib/ree.rb', line 112

def set_logger_debug
  logger.level = Logger::DEBUG
end