lib/DX/State.pm

   1 package DX::State;
   2
   3 use Return::MultiLevel qw(with_return);
   4 use DX::Op::Backtrack;
   5 use Scalar::Util qw(blessed);
   6 use Moo;
   7
   8 has next_op => (is => 'ro', required => 1);
   9
  10 has return_stack => (is => 'ro', required => 1);
  11
  12 has by_id => (is => 'ro', required => 1);
  13
  14 has scope => (is => 'ro', required => 1);
  15
  16 has last_choice => (is => 'ro', required => 1);
  17
  18 has id_gen => (is => 'ro', default => sub { {} });
  19
  20 has rule_set => (is => 'ro');
  21
  22 has facts => (is => 'ro');
  23
  24 sub scope_var {
  25   my ($self, $name) = @_;
  26   $self->by_id->{$self->scope->{$name}};
  27 }
  28
  29 sub allocate_var {
  30   my ($self, $name, $var, $id_gen) = @_;
  31   my $id = join('_', $name, ++($id_gen->{$name}||='000'));
  32   DX::Var->new(id => $id, %$var);
  33 }
  34
  35 sub expand_vars {
  36   my ($self, %vars) = @_;
  37   my %by_id = %{$self->by_id};
  38   my %id_gen = %{$self->id_gen};
  39   foreach my $name (keys %vars) {
  40     unless (blessed($vars{$name})) {
  41       my $var = $vars{$name} = $self->allocate_var(
  42         $name, $vars{$name}, \%id_gen
  43       );
  44       $by_id{$var->id} = $var;
  45     }
  46   }
  47   $self->but(
  48     by_id => \%by_id, id_gen => \%id_gen,
  49   ), %vars;
  50 }
  51
  52 sub assign_vars {
  53   my ($self, %vars) = @_;
  54   my ($state, %expanded) = $self->expand_vars(%vars);
  55   $state->but(
  56     scope => { %{$self->scope}, map +($_ => $expanded{$_}->id), keys %expanded }
  57   );
  58 }
  59
  60 sub bind_value {
  61   my ($self, $var, $value) = @_;
  62   my $bound = $var->with_value($value);
  63   $self->but(
  64     by_id => { %{$self->by_id}, $var->id => $bound },
  65   );
  66 }
  67
  68 sub bind_stream_then {
  69   my ($self, $var, $stream, $then) = @_;
  70   my $bound = $var->with_stream($stream);
  71   $self->but(
  72     by_id => { %{$self->by_id}, $var->id => $bound },
  73     next_op => $then
  74   )->mark_choice($bound);
  75 }
  76
  77 sub bind_root_set_then {
  78   my ($self, $var, $set, $then) = @_;
  79   my $bound = $var->with_root_set($set);
  80   $self->but(
  81     by_id => { %{$self->by_id}, $var->id => $bound },
  82     next_op => $then
  83   )->mark_choice($bound);
  84 }
  85
  86 sub mark_choice {
  87   my ($self, $var) = @_;
  88   $self->but(last_choice => [ $self, $var ]);
  89 }
  90
  91 sub backtrack {
  92   my ($self) = @_;
  93   my ($state, $var) = ($self);
  94   while (($state, $var) = @{$state->last_choice}) {
  95     $var->bound_value; $var->clear_bound_value;
  96     return $state->mark_choice($var) unless $var->bound_stream->is_exhausted;
  97   }
  98   $self->return_from_run(undef);
  99 }
 100
 101 sub then {
 102   my ($self, $then) = @_;
 103   $self->but(next_op => $then);
 104 }
 105
 106 sub return_from_run {
 107   my (undef, $return) = @_;
 108   (our $Run_Return)->($return);
 109 }
 110
 111 sub return_from_op {
 112   my (undef, $return) = @_;
 113   if (our $Op_Return) {
 114     $Op_Return->($return);
 115   }
 116 }
 117
 118 sub run {
 119   my ($state) = @_;
 120   with_return {
 121     my ($return) = @_;
 122     local our $Run_Return = $return;
 123     while (my $op = $state->next_op) {
 124       my $backtrack = with_return {
 125         my ($return) = @_;
 126         local our $Op_Return = $return;
 127         $state = $op->run($state);
 128         return;
 129       };
 130       if ($backtrack) { $state = $state->backtrack }
 131     }
 132     return $state;
 133   }
 134 }
 135
 136 sub push_backtrack {
 137   $_[0]->then(DX::Op::Backtrack->new);
 138 }
 139
 140 sub but {
 141   my ($self, @but) = @_;
 142   $self->new(%$self, @but);
 143 }
 144
 145 sub pop_return_stack {
 146   my ($self) = @_;
 147   my @stack = @{$self->return_stack};
 148   my $top = pop @stack;
 149   $self->but(return_stack => \@stack, next_op => $top->[0]);
 150 }
 151
 152 sub push_return_then {
 153   my ($self, $return, $then) = @_;
 154   $self->but(
 155     return_stack => [ @{$self->return_stack}, [ $return, $self ] ],
 156     next_op => $then
 157   );
 158 }
 159
 160 1;