Class: Eco::API::Session
- Inherits:
-
Common::Session::BaseSession
- Object
- Common::Session::BaseSession
- Eco::API::Session
- Defined in:
- lib/eco/api/session.rb,
lib/eco/api/session/batch.rb,
lib/eco/api/session/config.rb,
lib/eco/api/session/batch/job.rb,
lib/eco/api/session/batch/jobs.rb,
lib/eco/api/session/config/api.rb,
lib/eco/api/session/config/apis.rb,
lib/eco/api/session/config/sftp.rb,
lib/eco/api/session/batch/errors.rb,
lib/eco/api/session/batch/status.rb,
lib/eco/api/session/config/files.rb,
lib/eco/api/session/config/logger.rb,
lib/eco/api/session/config/mailer.rb,
lib/eco/api/session/config/people.rb,
lib/eco/api/session/batch/feedback.rb,
lib/eco/api/session/batch/launcher.rb,
lib/eco/api/session/batch/policies.rb,
lib/eco/api/session/batch/searcher.rb,
lib/eco/api/session/config/tagtree.rb,
lib/eco/api/session/config/workflow.rb,
lib/eco/api/session/batch/base_policy.rb,
lib/eco/api/session/batch/jobs_groups.rb,
lib/eco/api/session/config/s3_storage.rb,
lib/eco/api/session/config/base_config.rb,
lib/eco/api/session/config/post_launch.rb,
lib/eco/api/session/batch/request_stats.rb,
lib/eco/api/session/config/apis/one_off.rb,
lib/eco/api/session/batch/launcher/retry.rb,
lib/eco/api/session/batch/launcher/options.rb,
lib/eco/api/session/config/apis/service_up.rb,
lib/eco/api/session/batch/launcher/mode_size.rb,
lib/eco/api/session/config/apis/enviro_spaces.rb,
lib/eco/api/session/config/apis/space_helpers.rb,
lib/eco/api/session/batch/launcher/benchmarking.rb,
lib/eco/api/session/batch/launcher/valid_methods.rb,
lib/eco/api/session/batch/launcher/status_handling.rb
Overview
Class to manage the current session. Central helper of resources.
Defined Under Namespace
Instance Attribute Summary
Attributes inherited from Common::Session::BaseSession
#config, #environment, #session
Attributes included from Language::AuxiliarLogger
Pure organization helpers collapse
- #live_tree(id: nil, include_archived: false, **kargs, &block) ⇒ Eco::API::Organization::TagTree
- #live_trees(include_archived: false, **kargs, &block) ⇒ Object
- #login_providers ⇒ Object
-
#node_classifications(active: true) ⇒ Eco::API::Organization::NodeClassifications
The location node classifications of the organization.
- #policy_groups ⇒ Object
- #schemas ⇒ Object
- #tagtree(live: false, merge: false, include_archived: false, recache: false, **kargs, &block) ⇒ Eco::API::Organization::TagTree
People and Input entries helpers collapse
-
#csv_entries(file, **kargs) ⇒ Eco::API::Common::People::Entries
Generates an entries collection from a csv input file.
-
#discarded_entries ⇒ Eco::API::Common::People::Entries
Generates the collection of entries that should be discarded from an update.
-
#entries(*args, **kargs) ⇒ Eco::API::Common::People::Entries
Collection of entries.
-
#entry_factory(schema: nil) ⇒ Eco::API::Common::People::EntryFactory
Helper to obtain a EntryFactory.
- #export(*args) ⇒ Object
-
#fields_mapper ⇒ Eco::Data::Mapper
The mappings between the internal and external attribute/property names.
-
#new_entry(data, dependencies: {}) ⇒ Eco::API::Common::People::PersonEntry
Builds the entry for the given data.
- #new_person(**keyed_args) ⇒ Ecoportal::API::Internal::Person
-
#parse_attribute(attr, source, phase = :internal, deps: {}) ⇒ Object
Allows to use the defined parsers.
-
#person_factory(schema: nil) ⇒ Eco::API::Common::People::PersonFactory
Helper to obtain a PersonFactory.
-
#presets_factory ⇒ Object
Helper to state the abilities that a person should have with given their usergroups.
-
#schema ⇒ String, Ecoportal::API::V1::PersonSchema
Current active session's schema.
-
#schema=(value) ⇒ Object
Sets the current target
PersonSchema
of this session.
Session workflow and batch job launces collapse
-
#default_policies ⇒ Object
The native policies.
-
#job_group(name, order: :last) ⇒ Eco::API::Session::Batch::Jobs
It retrives the group of
Batch::Jobs
namedname
. - #job_groups ⇒ Eco::API::Session::Batch::JobsGroups
- #jobs_launch(simulate: false) ⇒ Object
-
#micro ⇒ Eco::API::MicroCases
Set of helpers to simplify your code.
-
#new_job(group, name, type, usecase, sets = %i[core details account],, accept_update_with_no_id = false, &block) ⇒ Eco::API::Session::Batch::Job
Shortcut to create a job of certain type within a group.
-
#policies ⇒ Eco::API::Policies
Does merge
Eco::API::Policies::DefaultPolicies
with the custom policies. - #post_launch ⇒ Object
- #process_case(name, io: nil, type: nil, **params) ⇒ Object
- #summary ⇒ Object
-
#usecases ⇒ Eco::API::UseCases
Does merge
Eco::API::UseCases::DefaultCases
with the custom cases. -
#workflow(io:) ⇒ Object
Opens up the
workflow
configuration.
Additional resources collapse
-
#mail(**kargs) ⇒ Object
Sends an email.
-
#s3upload(content: nil, file: nil, directory: nil, recurse: false, link: false) ⇒ String+
Uploads content into a file, a file or a directory to S3.
Instance Method Summary collapse
-
#batch ⇒ Eco::API::Session::Batch
Provides helper to launch batch operations.
- #enviro_name ⇒ Object
-
#initialize(init = {}) ⇒ Session
constructor
A new instance of Session.
Methods inherited from Common::Session::BaseSession
#api, #api?, #fatal, #file_manager, #logger, #mailer, #mailer?, #s3uploader, #s3uploader?, #sftp, #sftp?
Methods included from Language::AuxiliarLogger
Constructor Details
#initialize(init = {}) ⇒ Session
Returns a new instance of Session.
7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
# File 'lib/eco/api/session.rb', line 7 def initialize(init = {}) env = init msg = "Expected object Eco::API::Session::Config or Eco::API::Common::Session::Environment. " msg << " Given: #{init}" correct_env = env.is_a?(Session::Config) || env.is_a?(Eco::API::Common::Session::Environment) raise ArgumentError, msg unless correct_env unless env.is_a?(Eco::API::Common::Session::Environment) env = Eco::API::Common::Session::Environment.new(init, session: self) end super(env) @entry_factories = {} @person_factories = {} log(:debug) { "LINE COMMAND: #{$0} #{ARGV.join(" ")}" # rubocop:disable Style/SpecialGlobalVars } end |
Instance Method Details
#batch ⇒ Eco::API::Session::Batch
Returns provides helper to launch batch operations.
36 37 38 |
# File 'lib/eco/api/session.rb', line 36 def batch @batch ||= Batch.new(enviro) end |
#csv_entries(file, **kargs) ⇒ Eco::API::Common::People::Entries
Generates an entries collection from a csv input file.
212 213 214 215 216 217 218 |
# File 'lib/eco/api/session.rb', line 212 def csv_entries(file, **kargs) kargs.merge!({ file: file, format: :csv }) entries(**kargs) end |
#default_policies ⇒ Object
The native policies
265 266 267 |
# File 'lib/eco/api/session.rb', line 265 def default_policies @default_policies ||= Eco::API::Policies::DefaultPolicies.new end |
#discarded_entries ⇒ Eco::API::Common::People::Entries
requires session.config.people.discarded_file
to be defined.
Generates the collection of entries that should be discarded from an update.
223 224 225 226 227 228 229 230 231 |
# File 'lib/eco/api/session.rb', line 223 def discarded_entries return @discarded_entries if instance_variable_defined?(:@discarded_entries) file = config.people.discarded_file file = file_manager.dir.file(file) fatal("You have not specified the 'discarded_people_file'") unless file @discarded_entries = csv_entries(file) end |
#entries(*args, **kargs) ⇒ Eco::API::Common::People::Entries
Returns collection of entries.
201 202 203 204 205 |
# File 'lib/eco/api/session.rb', line 201 def entries(*args, **kargs) entry_factory.entries(*args, **kargs).tap do |collection| log(:info) { "Loaded #{collection.length} input entries." } end end |
#entry_factory(schema: nil) ⇒ Eco::API::Common::People::EntryFactory
Helper to obtain a EntryFactory
136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 |
# File 'lib/eco/api/session.rb', line 136 def entry_factory(schema: nil) schema = to_schema(schema) || self.schema return @entry_factories[schema&.id] if @entry_factories.key?(schema&.id) unless @entry_factories.empty? @entry_factories[schema&.id] = @entry_factories.values.first.newFactory(schema: schema) return @entry_factories[schema&.id] end @entry_factories[schema&.id] = Eco::API::Common::People::EntryFactory.new( enviro, schema: schema, person_parser: config.people.parser, attr_map: fields_mapper ) end |
#enviro_name ⇒ Object
31 32 33 |
# File 'lib/eco/api/session.rb', line 31 def enviro_name config.active_enviro end |
#export(*args) ⇒ Object
180 181 182 |
# File 'lib/eco/api/session.rb', line 180 def export(*args) entry_factory.export(*args) end |
#fields_mapper ⇒ Eco::Data::Mapper
Returns the mappings between the internal and external attribute/property names.
120 121 122 123 124 125 126 127 128 129 |
# File 'lib/eco/api/session.rb', line 120 def fields_mapper return @fields_mapper if instance_variable_defined?(:@fields_mapper) mappings = [] if (map_file = config.people.fields_mapper) mappings = map_file ? file_manager.load_json(map_file) : [] end @fields_mapper = Eco::Data::Mapper.new(mappings) end |
#job_group(name, order: :last) ⇒ Eco::API::Session::Batch::Jobs
It retrives the group of Batch::Jobs
named name
. It creates it if it doesn't exist.
293 294 295 296 297 |
# File 'lib/eco/api/session.rb', line 293 def job_group(name, order: :last) return job_groups[name] if job_groups.exists?(name) job_groups.new(name, order: order) end |
#job_groups ⇒ Eco::API::Session::Batch::JobsGroups
287 288 289 |
# File 'lib/eco/api/session.rb', line 287 def job_groups @job_groups ||= Batch::JobsGroups.new(enviro) end |
#jobs_launch(simulate: false) ⇒ Object
322 323 324 |
# File 'lib/eco/api/session.rb', line 322 def jobs_launch(simulate: false) job_groups.launch(simulate: simulate) end |
#live_tree(id: nil, include_archived: false, **kargs, &block) ⇒ Eco::API::Organization::TagTree
82 83 84 |
# File 'lib/eco/api/session.rb', line 82 def live_tree(id: nil, include_archived: false, **kargs, &block) config.live_tree(id: id, include_archived: include_archived, **kargs, &block) end |
#live_trees(include_archived: false, **kargs, &block) ⇒ Object
87 88 89 |
# File 'lib/eco/api/session.rb', line 87 def live_trees(include_archived: false, **kargs, &block) config.live_trees(include_archived: include_archived, **kargs, &block) end |
#login_providers ⇒ Object
48 49 50 |
# File 'lib/eco/api/session.rb', line 48 def login_providers config.login_providers end |
#mail(**kargs) ⇒ Object
Sends an email
337 338 339 340 341 342 343 344 345 346 |
# File 'lib/eco/api/session.rb', line 337 def mail(**kargs) if mailer? mailer.mail(**kargs) else log(:error) { "You are trying to use the mailer, but it's not configured" } nil end end |
#micro ⇒ Eco::API::MicroCases
Set of helpers to simplify your code
272 273 274 |
# File 'lib/eco/api/session.rb', line 272 def micro @micro ||= Eco::API::MicroCases.new(enviro) end |
#new_entry(data, dependencies: {}) ⇒ Eco::API::Common::People::PersonEntry
Builds the entry for the given data.
194 195 196 |
# File 'lib/eco/api/session.rb', line 194 def new_entry(data, dependencies: {}) entry_factory(schema: data&.details&.schema_id).new(data, dependencies: dependencies) end |
#new_job(group, name, type, usecase, sets = %i[core details account],, accept_update_with_no_id = false, &block) ⇒ Eco::API::Session::Batch::Job
Shortcut to create a job of certain type within a group
302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 |
# File 'lib/eco/api/session.rb', line 302 def new_job( # rubocop:disable Metrics/ParameterLists group, name, type, usecase, sets = %i[core details account], accept_update_with_no_id = false, # rubocop:disable Style/OptionalBooleanParameter &block ) job_group(group).new( name, usecase: usecase, type: type, sets: sets, accept_update_with_no_id: accept_update_with_no_id, &block ) end |
#new_person(**keyed_args) ⇒ Ecoportal::API::Internal::Person
187 188 189 |
# File 'lib/eco/api/session.rb', line 187 def new_person(**keyed_args) person_factory.new(**keyed_args) end |
#node_classifications(active: true) ⇒ Eco::API::Organization::NodeClassifications
The location node classifications of the organization
54 55 56 |
# File 'lib/eco/api/session.rb', line 54 def node_classifications(active: true) config.node_classifications(active: active) end |
#parse_attribute(attr, source, phase = :internal, deps: {}) ⇒ Object
the use of these method requires to know which is the expected format of source
Allows to use the defined parsers
171 172 173 174 175 176 |
# File 'lib/eco/api/session.rb', line 171 def parse_attribute(attr, source, phase = :internal, deps: {}) msg = "There are no parsers defined" raise msg unless (parsers = entry_factory.person_parser) parsers.parse(attr, source, phase, deps: deps) end |
#person_factory(schema: nil) ⇒ Eco::API::Common::People::PersonFactory
Helper to obtain a PersonFactory
159 160 161 162 |
# File 'lib/eco/api/session.rb', line 159 def person_factory(schema: nil) schema = to_schema(schema) || self.schema @person_factories[schema&.id] ||= Eco::API::Common::People::PersonFactory.new(schema: schema) end |
#policies ⇒ Eco::API::Policies
- the default policies are added at the end (meaning they will run after the custom policies)
Does merge Eco::API::Policies::DefaultPolicies
with the custom policies.
258 259 260 261 262 |
# File 'lib/eco/api/session.rb', line 258 def policies @policies ||= config.policies.dup.tap do |policies| policies.merge(default_policies) end end |
#policy_groups ⇒ Object
43 44 45 |
# File 'lib/eco/api/session.rb', line 43 def policy_groups config.policy_groups end |
#post_launch ⇒ Object
276 277 278 |
# File 'lib/eco/api/session.rb', line 276 def post_launch @post_launch ||= config.post_launch.select(usecases) end |
#presets_factory ⇒ Object
Helper to state the abilities that a person should have with given their usergroups
115 116 117 |
# File 'lib/eco/api/session.rb', line 115 def presets_factory @presets_factory ||= Eco::API::Organization::PresetsFactory.new(enviro: enviro) end |
#process_case(name, io: nil, type: nil, **params) ⇒ Object
281 282 283 284 |
# File 'lib/eco/api/session.rb', line 281 def process_case(name, io: nil, type: nil, **params) args = { session: self }.merge(params) usecases.case(name, type: type).launch(io: io, **args) end |
#s3upload(content: nil, file: nil, directory: nil, recurse: false, link: false) ⇒ String+
Uploads content into a file, a file or a directory to S3
358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 |
# File 'lib/eco/api/session.rb', line 358 def s3upload(content: nil, file: nil, directory: nil, recurse: false, link: false) if s3uploader? if content == :target path = micro.s3upload_targets elsif content && file path = s3uploader.upload(file, content) elsif file path = s3uploader.upload_file(file) elsif directory path = s3uploader.upload_directory(directory, recurse: recurse) else log(:error) { "To use Session.s3upload, you must specify either directory, file or content and file name" } end return path unless link s3uploader.link(path) else log(:error) { "You are trying to use S3 uploader, but it's not configured" } nil end end |
#schema ⇒ String, Ecoportal::API::V1::PersonSchema
Returns current active session's schema.
100 101 102 103 |
# File 'lib/eco/api/session.rb', line 100 def schema self.schema = config.people.default_schema || schemas.first unless @schema @schema end |
#schema=(value) ⇒ Object
observe that it is essential for the parsers/serialisers to identify target/present attributes.
Sets the current target PersonSchema
of this session.
110 111 112 |
# File 'lib/eco/api/session.rb', line 110 def schema=(value) @schema = to_schema(value) end |
#summary ⇒ Object
327 328 329 |
# File 'lib/eco/api/session.rb', line 327 def summary job_groups.summary end |
#tagtree(live: false, merge: false, include_archived: false, recache: false, **kargs, &block) ⇒ Eco::API::Organization::TagTree
63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 |
# File 'lib/eco/api/session.rb', line 63 def tagtree( live: false, merge: false, include_archived: false, recache: false, **kargs, &block ) if live && api?(version: :graphql) return live_tree(include_archived: include_archived, **kargs, &block) unless merge live_trees(include_archived: include_archived, **kargs, &block).inject(&:merge) else config.tagtree(recache: recache) end end |
#usecases ⇒ Eco::API::UseCases
- the order matters, as a default usecase can be redefined by a custom one with same name
Does merge Eco::API::UseCases::DefaultCases
with the custom cases.
247 248 249 250 251 252 |
# File 'lib/eco/api/session.rb', line 247 def usecases @usecases ||= config.usecases.dup.tap do |cases| all_cases = Eco::API::UseCases::DefaultCases.new.merge(config.usecases) cases.merge(all_cases) end end |
#workflow(io:) ⇒ Object
Opens up the workflow
configuration
237 238 239 240 241 |
# File 'lib/eco/api/session.rb', line 237 def workflow(io:) config.workflow.tap do |wf| yield(wf, io) if block_given? end end |