whole_func_string: function swal_base(arg1, arg2, arg3) {
          // In case of options
          if (arg1 !== null && typeof arg1 === 'object') {
            return $q.when(swal(arg1));
          } else {
            // In case of: title, text, type
            return $q.when(swal(arg1, arg2, arg3));
          }
        }
func_code_string: function swal_base(arg1, arg2, arg3) {
          // In case of options
          if (arg1 !== null && typeof arg1 === 'object') {
            return $q.when(swal(arg1));
          } else {
            // In case of: title, text, type
            return $q.when(swal(arg1, arg2, arg3));
          }
        }
func_documentation_string: /*
  
  Base Sweet Alert function
  Use this for for a direct mapping to sweetalert,
  by either passing an options object or by passing up to 3 string arguments
  
  ex. 1: Swangular.swal("Good job!", "You clicked the button!", "success")
  
  ex. 2: Swangular.swal({title: "Auto close alert!", text: "I will close in 2 seconds.", timer: 2000});