The Perl and Raku Conference 2025: Greenville, South Carolina - June 27-29 Learn more

FERKI / Rex-1.16.0 / lib / Rex / Resource / Common.pm 

            

              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
—
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
—
136
137
138
139
140
141

              
#
# (c) Jan Gehring <jan.gehring@gmail.com>
#
package Rex::Resource::Common;
use v5.12.5;
use warnings;
our $VERSION = '1.16.0'; # VERSION
require Exporter;
require Rex::Config;
use Rex::Resource;
use Data::Dumper;
use Symbol;
use base qw(Exporter);
use vars qw(@EXPORT);
@EXPORT = qw(emit resource resource_name changed created removed);
sub changed { return "changed"; }
sub created { return "created"; }
sub removed { return "removed"; }
sub emit {
  my ( $type, $message ) = @_;
  if ( !Rex::Resource->is_inside_resource ) {
    die "emit() only allowed inside resource.";
  }
  $message ||= "";
  Rex::Logger::debug( "Emiting change: " . $type . " - $message." );
  if ( $type eq changed ) {
    current_resource()->changed(1);
  }
  if ( $type eq created ) {
    current_resource()->created(1);
  }
  if ( $type eq removed ) {
    current_resource()->removed(1);
  }
  if ($message) {
    current_resource()->message($message);
  }
}
=over 4
=item resource($name, $function)
=cut
sub resource {
  my ( $name, $options, $function ) = @_;
  my $name_save = $name;
  my $caller_pkg = caller;
  if ( ref $options eq "CODE" ) {
    $function = $options;
    $options  = {};
  }
  if ( $name_save !~ m/^[a-zA-Z_][a-zA-Z0-9_]+$/ ) {
    Rex::Logger::info(
      "Please use only the following characters for resource names:", "warn" );
    Rex::Logger::info( "  A-Z, a-z, 0-9 and _", "warn" );
    Rex::Logger::info( "Also the resource should start with A-Z or a-z",
      "warn" );
    die "Wrong resource name syntax.";
  }
  my ( $class, $file, @tmp ) = caller;
  my $res = Rex::Resource->new(
    type         => "${class}::$name",
    name         => $name,
    display_name => (
      $options->{name}
        || ( $options->{export} ? $name : "${caller_pkg}::${name}" )
    ),
    cb => $function
  );
  my $func = sub {
    $res->call(@_);
  };
  if (!$class->can($name)
    && $name_save =~ m/^[a-zA-Z_][a-zA-Z0-9_]+$/ )
  {
    if ( $class ne "main" && $class ne "Rex::CLI" ) {
      # if not in main namespace, register the task as a sub
      Rex::Logger::debug(
        "Registering resource (not main namespace): ${class}::$name_save");
    }
    else {
      Rex::Logger::debug("Registering resource: ${class}::$name_save");
    }
    my $code            = $_[-2];
    my $ref_to_resource = qualify_to_ref( $name_save, $class );
    *{$ref_to_resource} = $func;
  }
  if ( exists $options->{export} && $options->{export} ) {
    # register in caller namespace
    my $ref_to_ISA    = qualify_to_ref( 'ISA',    $caller_pkg );
    my $ref_to_EXPORT = qualify_to_ref( 'EXPORT', $caller_pkg );
    push @{ *{$ref_to_ISA} }, "Rex::Exporter"
      unless ( grep { $_ eq "Rex::Exporter" } @{ *{$ref_to_ISA} } );
    push @{ *{$ref_to_EXPORT} }, $name_save;
  }
}
sub resource_name {
  Rex::Config->set( resource_name => current_resource()->{res_name} );
  return current_resource()->{res_name};
}
sub resource_ensure {
  my ($option) = @_;
  $option->{ current_resource()->{res_ensure} }->();
}
sub current_resource {
  return $Rex::Resource::CURRENT_RES[-1];
}
=back
=cut
1;