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
|
use 5.008; # utf8
use strict;
use warnings;
use utf8;
package Path::IsDev::Heuristic::DevDirMarker;
our $VERSION = '1.001003';
# ABSTRACT: Determine if a path contains a .devdir file
our $AUTHORITY = 'cpan:KENTNL'; # AUTHORITY
use Role::Tiny::With qw( with );
with 'Path::IsDev::Role::Heuristic', 'Path::IsDev::Role::Matcher::Child::Exists::Any::File';
sub files {
return qw( .devdir );
}
sub matches {
my ( $self, $result_object ) = @_;
if ( $self->child_exists_any_file( $result_object, $self->files ) ) {
$result_object->result(1);
return 1;
}
return;
}
1;
__END__
=pod
=encoding UTF-8
=head1 NAME
Path::IsDev::Heuristic::DevDirMarker - Determine if a path contains a .devdir file
=head1 VERSION
version 1.001003
=head1 DESCRIPTION
This Heuristic is a workaround that is likely viable in the event none of the other Heuristics work.
All this heuristic checks for is the presence of a special file called C<.devdir>, which is intended as an explicit notation that
"This directory is a project root".
An example case where you might need such a Heuristic, is the scenario where you're not working with a Perl C<CPAN> dist, but are
instead working on a project in a different language, where Perl is simply there for build/test purposes.
=head1 METHODS
=head2 C<files>
Matches files named:
.devdir
=head2 C<matches>
Matches if any of the files in C<files> exist as children of the C<path>
=begin MetaPOD::JSON v1.1.0
{
"namespace":"Path::IsDev::Heuristic::DevDirMarker",
"interface":"single_class",
"does":[
"Path::IsDev::Role::Heuristic",
"Path::IsDev::Role::Matcher::Child::Exists::Any::File"
]
}
=end MetaPOD::JSON
=head1 AUTHOR
Kent Fredric <kentnl@cpan.org>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2017 by Kent Fredric <kentfredric@gmail.com>.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut
|
