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

NGLENN / Soar-Production-0.03 / README 

            

              
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

              
NAME
    Soar::Production - REPRESENT SOAR PRODUCTIONS
VERSION
    version 0.03
SYNOPSIS
            use Soar::Production qw(prods_from prods_from_file);
            my $prods = prods_from_file( '/path/to/file' );
            for my $prod (@$prods){
                    print $prod->name . "\n";
            }
            my $prod =
            'sp{myName
                    (state <s>)
                    -->
                    (<s> ^foo bar)
            }';
            my $prod = Soar::Production->new($prod);
DESCRIPTION
    This is a module for storing, manipulating, and querying Soar
    productions. There isn't much functionality implemented, yet. Currently
    there are functions for
NAME
    Soar::Production- Store and manipulate Soar productions
METHODS
  "new"
    Argument: text of a Soar production. Creates a new production object
    using the input text.
  "name"
    Optional argument: name to assign production. Sets the name of the
    current production if an argument is given. Returns the name of the
    production.
EXPORTED FUNCTIONS
    The following functions may be exported:
  "prods_from_file"
    A shortcut for "prods_from(file =" $arg)>.
  "prods_from"
    This method extracts productions from a given text. It returns a
    reference to an array containing production objects. Note that all
    comments are removed as a preprocessing step to detecting and extracting
    productions. It takes a set of named arguments: "file"- the name of a
    file to read. "text"- the text to read. You must choose to export this
    function via the "use" function:
            use Soar::Production qw(prods_from);
TODO
  "state_name"
    Set/get name of matched state
  "superstate_name"
    Set/get name of matched state's superstate
  "type"
    Does this production match a state or an impasse?
  "validate"
    Check this production against a datamap.
  check semantic correctness
    Soar::Production::Parser does not check semantic correctness. The
    following are good things to check:
    everything matched in RHS must be in LHS
    no empty RHS
    Only allowable non-operator preference is REJECT
    Check for existence of RHS function
    <s> not connected
    disconnect from goal or impasses (no 'state' or 'impasse' keyword)
AUTHOR
    Nathan Glenn <garfieldnate@gmail.com>
COPYRIGHT AND LICENSE
    This software is copyright (c) 2012 by Nathan Glenn.
    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.