lib/Frey/Action.pm

package Frey::Action;
use Moose;
extends 'Frey::PPI';
with 'Frey::Web';
with 'Frey::Config';

use Clone qw/clone/;
use Data::Dump qw/dump/;

=head1 DESCRIPTION

Invoke any L<Frey> object creating html for with various default parameters
if not supplied at invocation.

=cut

has 'class' => (
        is => 'rw',
        isa => 'Str',
        required => 1,
);

has 'params' => (
        is => 'rw',
        isa => 'HashRef',
        default => sub { {} },
);

=head2 required

  my @required_attributes = $self->required;
  my $required_attributes = $self->required;

=cut

sub required {
        my ( $self ) = @_;
        $self->load_class( $self->class );

        my @required = 
                grep {
                        defined $_ && $_->can('name') &&
                        ! defined( $self->params->{ $_->name } ) &&
                        ! $_->is_lazy
                }
                map {
                        my $attr = $self->class->meta->get_attribute($_);
                        blessed $attr && $attr->is_required && $attr;
                } $self->class->meta->get_attribute_list;

        warn "## required = ",dump( map { $_->name } @required ), " for ", $self->class if @required && $self->debug;
        return @required if wantarray;
        return \@required;
}

=head2 attributes

Generated from attributes specified in code (extracted using L<Frey::PPI>)
and required atributes

  my @class_attributes = $self->attributes;
  my @class_attributes = $self->attributes;

=cut

sub attributes {
        my ( $self ) = @_;
        my $a;
        my @attrs = @{ $self->attribute_order };
        @attrs = map {  $a->{$_}++; $_ } @attrs;
        push @attrs, $_ foreach grep { ! $a->{$_} } map { $_->name } @{ $self->required };
        warn "# attributes = ",dump( @attrs ) if $self->debug;
        return @attrs if wantarray;
        return \@attrs;
}

=head2 params_form

  my  $html                  = $self->params_form;
  my ($html,$default_params) = $self->params_form;

=cut

sub params_form {
        my ( $self ) = @_;
        my @required = $self->required;
        if ( ! @required ) {
                warn "all params available ", dump( $self->params ), " not creating form" if $self->debug;
                return (undef,$self->params) if wantarray;
                return;
        } else {
                warn $self->class, " required params ", map { $_->dump(2) } @required if $self->debug;
        }

        my $class = $self->class;

        $self->load_class( $class );

        my $default = clone $self->params; # XXX we really don't want to modify params!

        my $params_config = {};
        $params_config = $self->config($class);
        warn "# $class config = ",dump( $params_config ) if $self->debug;

        my $form;

        sub select_values {
                my ( $name, $attr_type, $values ) = @_;

                if ( $#$values > 3 ) {
                        my $options = join("\n",
                                map {
                                        my $v = ref($_) eq 'HASH' ? $_->{$name} : $_;
                                        qq|<option value="$v">$v</option>| if $v;
                                } @$values
                        );
                        qq|<select title="$attr_type" name="$name">$options</select>| if $options;
                } else {
                        my $radio = join("\n",
                                map {
                                        my $v = ref($_) eq 'HASH' ? $_->{$name} : $_;
                                        qq|<input type="radio" name="$name" value="$v" title="$attr_type"><span style="float: left; padding-right: 2em;">$v</span>|;
                                } @$values
                        );
                        qq|<div>$radio</div>|;
                }
        }

        foreach my $checkbox ( split(/\s+/, $default->{'frey-checkboxes'} ) ) {
                next if defined $default->{ $checkbox };

                $default->{ $checkbox } = 0;
                $self->params->{ $checkbox } = 0;
                warn "# checkbox $checkbox not ticked";
        }

        my @checkboxes;

        my $skip_prefix;
        if ( $self->class->can('action') ) {
                my $action = eval $self->class . '->action';
                $skip_prefix->{$_}++ foreach eval $self->class .'->action_order';
                warn "# skip_prefix = ", $self->dump( $skip_prefix );
        }

        my $label_width = 1; # minimum

        foreach my $name (
                grep {
                        ! $class->meta->get_attribute($_)->is_lazy
                        && ! defined $default->{$_}
                        && ! m{^_} # skip _private
                } $self->attributes
        ) {
                my $attr_type = '';
                my $type = $name =~ m/^pass/ ? 'password' : 'text';
                my $label = $name;
                my $label_title = '';
                my $value_html = '';

                my $attr = $class->meta->get_attribute( $name );
                $attr_type = $attr->type_constraint->name if $attr->has_type_constraint;

                my $value =
                        defined $default->{$name} ? $default->{$name}       :
                        $attr->has_default        ? $attr->default( $name ) :
                        '';

                if ( ref($params_config) eq 'HASH' ) {
                        $value = $params_config->{$name};
                } elsif ( ref($params_config) eq 'ARRAY' ) {
                        $value_html = select_values( $name, $attr_type, $params_config );
                        $default->{$name} = $params_config->[0]->{$name};
                } elsif ( $attr->has_type_constraint && $attr->type_constraint->can('values') ) {
                        $value_html = select_values( $name, $attr_type, $attr->type_constraint->values );
                } elsif ( $attr_type =~ m{^Bool} ) {
                        my $suffix = '';
                        $suffix = ' checked' if $value;
                        $value_html = qq|<input type="checkbox" name="$name" title="$attr_type" value="$value"$suffix>|;
                        push @checkboxes, $name;
                } elsif ( ! defined $value ) {
                        $value_html = qq|<tt id="$name">undef</tt><!-- $name = undef -->|; # FIXME if $self->debug
                } elsif ( $attr_type !~ m{^(Str|Int)$} || $value =~ $Frey::Web::re_html ) {
                        $value_html = qq|<textarea name="$name" title="$attr_type">$value</textarea>|;
                }

                $label_title = qq| title="| . $attr->documentation . qq|"| if $attr->has_documentation;

                $default->{$name} = $value unless defined $default->{$name};

                $value_html = qq|<input type="$type" name="$name" title="$attr_type" value="$value">| unless $value_html;

#               warn "# required $name ", $class->meta->get_attribute( $name )->dump( 2 );
                $form .= qq|<label for="$name"$label_title>$label</label>$value_html<br>|;
                my $ll = length($label);
                $label_width = $ll if $ll > $label_width;
        }
        $form .= qq|<input type="hidden" name="frey-checkboxes" value="| . join(' ', @checkboxes) . qq|">| if @checkboxes;

        $self->add_css(qq|
                label,input {
                        display: block;
                        float: left;
                        margin-bottom: 10px;
                }

                label {
                        text-align: right;
                        width: ${label_width}ex;
                        padding-right: 20px;
                }

                br {
                        clear: left;
                }
        |);

        my $html;

        # http://www.quirksmode.org/oddsandends/forms.html
#       $form =~ s{<([^>]+)(name=")([^"]+)(")([^>]*)>}{<$1$2$3$4 id="$3" $5}gs;

        $html = qq|
                <h1>$class params</h1>
                <form method="post">
                $form
                <input type="submit" value="Run $class">
                </form>
        | if $form;

        $self->add_status({
                $self->class => {
                        params  => $self->params,
                        params_config  => $params_config,
                        default => $default,
                },
        });

        return ($html,$default) if wantarray;
        return $html;
}

=head1 SEE ALSO

L<http://www.quirksmode.org/css/forms.html> for info on CSS2 forms

=cut

1;
1	package Frey::Action;
2	use Moose;
3	extends 'Frey::PPI';
4	with 'Frey::Web';
5	with 'Frey::Config';
6
7	use Clone qw/clone/;
8	use Data::Dump qw/dump/;
9
10	=head1 DESCRIPTION
11
12	Invoke any L<Frey> object creating html for with various default parameters
13	if not supplied at invocation.
14
15	=cut
16
17	has 'class' => (
18	is => 'rw',
19	isa => 'Str',
20	required => 1,
21	);
22
23	has 'params' => (
24	is => 'rw',
25	isa => 'HashRef',
26	default => sub { {} },
27	);
28
29	=head2 required
30
31	my @required_attributes = $self->required;
32	my $required_attributes = $self->required;
33
34	=cut
35
36	sub required {
37	my ( $self ) = @_;
38	$self->load_class( $self->class );
39
40	my @required =
41	grep {
42	defined $_ && $_->can('name') &&
43	! defined( $self->params->{ $_->name } ) &&
44	! $_->is_lazy
45	}
46	map {
47	my $attr = $self->class->meta->get_attribute($_);
48	blessed $attr && $attr->is_required && $attr;
49	} $self->class->meta->get_attribute_list;
50
51	warn "## required = ",dump( map { $_->name } @required ), " for ", $self->class if @required && $self->debug;
52	return @required if wantarray;
53	return \@required;
54	}
55
56	=head2 attributes
57
58	Generated from attributes specified in code (extracted using L<Frey::PPI>)
59	and required atributes
60
61	my @class_attributes = $self->attributes;
62	my @class_attributes = $self->attributes;
63
64	=cut
65
66	sub attributes {
67	my ( $self ) = @_;
68	my $a;
69	my @attrs = @{ $self->attribute_order };
70	@attrs = map { $a->{$_}++; $_ } @attrs;
71	push @attrs, $_ foreach grep { ! $a->{$_} } map { $_->name } @{ $self->required };
72	warn "# attributes = ",dump( @attrs ) if $self->debug;
73	return @attrs if wantarray;
74	return \@attrs;
75	}
76
77	=head2 params_form
78
79	my $html = $self->params_form;
80	my ($html,$default_params) = $self->params_form;
81
82	=cut
83
84	sub params_form {
85	my ( $self ) = @_;
86	my @required = $self->required;
87	if ( ! @required ) {
88	warn "all params available ", dump( $self->params ), " not creating form" if $self->debug;
89	return (undef,$self->params) if wantarray;
90	return;
91	} else {
92	warn $self->class, " required params ", map { $_->dump(2) } @required if $self->debug;
93	}
94
95	my $class = $self->class;
96
97	$self->load_class( $class );
98
99	my $default = clone $self->params; # XXX we really don't want to modify params!
100
101	my $params_config = {};
102	$params_config = $self->config($class);
103	warn "# $class config = ",dump( $params_config ) if $self->debug;
104
105	my $form;
106
107	sub select_values {
108	my ( $name, $attr_type, $values ) = @_;
109
110	if ( $#$values > 3 ) {
111	my $options = join("\n",
112	map {
113	my $v = ref($_) eq 'HASH' ? $_->{$name} : $_;
114	qq\|<option value="$v">$v</option>\| if $v;
115	} @$values
116	);
117	qq\|<select title="$attr_type" name="$name">$options</select>\| if $options;
118	} else {
119	my $radio = join("\n",
120	map {
121	my $v = ref($_) eq 'HASH' ? $_->{$name} : $_;
122	qq\|<input type="radio" name="$name" value="$v" title="$attr_type"><span style="float: left; padding-right: 2em;">$v</span>\|;
123	} @$values
124	);
125	qq\|<div>$radio</div>\|;
126	}
127	}
128
129	foreach my $checkbox ( split(/\s+/, $default->{'frey-checkboxes'} ) ) {
130	next if defined $default->{ $checkbox };
131
132	$default->{ $checkbox } = 0;
133	$self->params->{ $checkbox } = 0;
134	warn "# checkbox $checkbox not ticked";
135	}
136
137	my @checkboxes;
138
139	my $skip_prefix;
140	if ( $self->class->can('action') ) {
141	my $action = eval $self->class . '->action';
142	$skip_prefix->{$_}++ foreach eval $self->class .'->action_order';
143	warn "# skip_prefix = ", $self->dump( $skip_prefix );
144	}
145
146	my $label_width = 1; # minimum
147
148	foreach my $name (
149	grep {
150	! $class->meta->get_attribute($_)->is_lazy
151	&& ! defined $default->{$_}
152	&& ! m{^_} # skip _private
153	} $self->attributes
154	) {
155	my $attr_type = '';
156	my $type = $name =~ m/^pass/ ? 'password' : 'text';
157	my $label = $name;
158	my $label_title = '';
159	my $value_html = '';
160
161	my $attr = $class->meta->get_attribute( $name );
162	$attr_type = $attr->type_constraint->name if $attr->has_type_constraint;
163
164	my $value =
165	defined $default->{$name} ? $default->{$name} :
166	$attr->has_default ? $attr->default( $name ) :
167	'';
168
169	if ( ref($params_config) eq 'HASH' ) {
170	$value = $params_config->{$name};
171	} elsif ( ref($params_config) eq 'ARRAY' ) {
172	$value_html = select_values( $name, $attr_type, $params_config );
173	$default->{$name} = $params_config->[0]->{$name};
174	} elsif ( $attr->has_type_constraint && $attr->type_constraint->can('values') ) {
175	$value_html = select_values( $name, $attr_type, $attr->type_constraint->values );
176	} elsif ( $attr_type =~ m{^Bool} ) {
177	my $suffix = '';
178	$suffix = ' checked' if $value;
179	$value_html = qq\|<input type="checkbox" name="$name" title="$attr_type" value="$value"$suffix>\|;
180	push @checkboxes, $name;
181	} elsif ( ! defined $value ) {
182	$value_html = qq\|<tt id="$name">undef</tt><!-- $name = undef -->\|; # FIXME if $self->debug
183	} elsif ( $attr_type !~ m{^(Str\|Int)$} \|\| $value =~ $Frey::Web::re_html ) {
184	$value_html = qq\|<textarea name="$name" title="$attr_type">$value</textarea>\|;
185	}
186
187	$label_title = qq\| title="\| . $attr->documentation . qq\|"\| if $attr->has_documentation;
188
189	$default->{$name} = $value unless defined $default->{$name};
190
191	$value_html = qq\|<input type="$type" name="$name" title="$attr_type" value="$value">\| unless $value_html;
192
193	# warn "# required $name ", $class->meta->get_attribute( $name )->dump( 2 );
194	$form .= qq\|<label for="$name"$label_title>$label</label>$value_html<br>\|;
195	my $ll = length($label);
196	$label_width = $ll if $ll > $label_width;
197	}
198	$form .= qq\|<input type="hidden" name="frey-checkboxes" value="\| . join(' ', @checkboxes) . qq\|">\| if @checkboxes;
199
200	$self->add_css(qq\|
201	label,input {
202	display: block;
203	float: left;
204	margin-bottom: 10px;
205	}
206
207	label {
208	text-align: right;
209	width: ${label_width}ex;
210	padding-right: 20px;
211	}
212
213	br {
214	clear: left;
215	}
216	\|);
217
218	my $html;
219
220	# http://www.quirksmode.org/oddsandends/forms.html
221	# $form =~ s{<([^>]+)(name=")([^"]+)(")([^>]*)>}{<$1$2$3$4 id="$3" $5}gs;
222
223	$html = qq\|
224	<h1>$class params</h1>
225	<form method="post">
226	$form
227	<input type="submit" value="Run $class">
228	</form>
229	\| if $form;
230
231	$self->add_status({
232	$self->class => {
233	params => $self->params,
234	params_config => $params_config,
235	default => $default,
236	},
237	});
238
239	return ($html,$default) if wantarray;
240	return $html;
241	}
242
243	=head1 SEE ALSO
244
245	L<http://www.quirksmode.org/css/forms.html> for info on CSS2 forms
246
247	=cut
248
249	1;