NAME

Sidef::Module::Require

DESCRIPTION

This module can load a perl module at run-time, via the keyword require.

SYNOPSIS

    var req = (require "My::Perl::Module");

    if (nil != req) {   # module successfully loaded
        var result = (req.some_method);
    }

METHODS

frequire

Require.frequire() -> Obj

Return the

require

require(String) -> Sidef::Module::Caller

• Loading Object-Oriented modules:

      var req = (require "Some::Perl::Module");

  When the Perl module is successfully loaded, it returns a Sidef::Module::Caller object, which can call any method from the required module.

      var oo_mod = (req.new);
      var result = (oo_mod.some_method);
      var solved = (oo_mod.solve(1, 4));

• Loading Functional-oriented modules:

  To initialize a functional-oriented module, apply an empty method ('->()') on the object returned by the require keyword.

      var func_mod = (require "Some::Perl::Module"->());     # notice the '->()'
  
      var result = (func_mod->some_function(x,y));
      var solved = (func_mod->solve(1, 4));

• Real object-oriented module loading example:

      var req = (require 'LWP::UserAgent');
  
      if (nil != req) {   # if the module is successfully loaded
  
          var lwp = (req.new(
                  'show_progress' => 1,
                  'timeout'       => 10,
                  'agent'         => 'Mozilla/5.0',
          ));
  
          var resp = (lwp->get("http://google.com"));
  
          if (Bool.new(resp->is_success)) {
              var content = (Str.new(resp->content));
              # ... do something with the content variable ...
          }
          else {
              "[ERROR] Response: %s\n".sprintf(Str.new(resp->status_line)).warn;
          }
      }

• Real functional-oriented module loading example:

      var spec = ( require 'File::Spec::Functions'->() );
  
      # Calling the curdir() function
      var curdir = (Dir.new(spec.curdir));
  
      # Call the catfile() function
      var file   = (File.new(spec.catfile("my", "dir", "file.ext")));
  
      ## On Unix, file is 'my/dir/file.ext'