1Algorithm::Dependency::USsoeurrcCeo:n:tFriilbeu(t3e)d PeArllgoDroictuhmme:n:tDaetpieonndency::Source::File(3)
2
3
4
6 Algorithm::Dependency::Source::File - File source for dependency
7 hierarchies
8
10 version 1.111
11
13 Algorithm::Dependency::Source::File implements a source where the items
14 are stored in a flat file or a relatively simple format.
15
16 File Format
17 The file should be an ordinary text file, consisting of a series of
18 lines, with each line completely containing the information for a
19 single item. Blank lines, or lines beginning with the hash character
20 '#' will be ignored as comments.
21
22 For a single item line, only word characters will be used. A 'word
23 character' consists of all letters and numbers, and the underscore '_'
24 character. Anything that is not a word character will be assumed to be
25 a separator.
26
27 The first word will be used as the name or id of the item, and any
28 further words in the line will be used as other items that this one
29 depends on. For example, all of the following are legal.
30
31 # A single item with no dependencies
32 Foo
33
34 # Another item that depends on the first one
35 Bar Foo
36
37 # Depending on multiple others
38 Bin Foo Bar
39
40 # We can use different separators
41 One:Two|Three-Four+Five=Six Seven
42
43 # We can also use multiple non-word characters as separators
44 This&*&^*&File: is& & & :::REALLY()Neat
45
46 From the examples above, it should be easy to create your own files.
47
49 This documents the methods differing from the ordinary
50 Algorithm::Dependency::Source methods.
51
52 new $filename
53 When constructing a new Algorithm::Dependency::Source::File object, an
54 argument should be provided of the name of the file to use. The
55 constructor will check that the file exists, and is readable, returning
56 "undef" otherwise.
57
59 Algorithm::Dependency
60
62 Bugs may be submitted through the RT bug tracker
63 <https://rt.cpan.org/Public/Dist/Display.html?Name=Algorithm-
64 Dependency> (or bug-Algorithm-Dependency@rt.cpan.org <mailto:bug-
65 Algorithm-Dependency@rt.cpan.org>).
66
68 Adam Kennedy <adamk@cpan.org>
69
71 This software is copyright (c) 2003 by Adam Kennedy.
72
73 This is free software; you can redistribute it and/or modify it under
74 the same terms as the Perl 5 programming language system itself.
75
76
77
78perl v5.32.1 2021-01A-l2g6orithm::Dependency::Source::File(3)