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
|
#!/usr/bin/env perl
use strict;
use warnings;
# Goal: extract the comments from the top of each script file, and
# turn them into some sort of markdown-style README.md for github to nom on.
#
# Not sure how it's going to work with multiple files in a dir though. Sections?
use File::Find;
use File::Spec;
use Pod::Markdown;
use feature qw/say/;
use Cwd;
my @dirs = map { File::Spec->catdir(getcwd(), $_) } @ARGV;
die unless @dirs;
find(\&wanted, @dirs);
sub wanted {
my ($file, $dir, $path) = ($_, $File::Find::dir, $File::Find::name);
return unless $file =~ m/\.pl$/;
_err("processing file: $path");
read_input_file($dir, $file);
}
sub read_input_file {
my ($dir, $filename) = @_;
my $filepath = File::Spec->catfile($dir, $filename);
open my $rfh, '<', $filepath or die "Couldn't open $filepath for input: $!";
_err("reading $filepath");
my $parser = Pod::Markdown->new;
$parser->parse_from_filehandle($rfh);
close $rfh;
my @other_files = glob($dir . "/*.pl");
# if (@other_files > 1) {
# $filename =~ s/\.pl$//;
# create_output_file($dir, "README-$filename.md", $parser);
# } else {
create_output_file($dir, "README.md", $parser);
# }
}
sub create_output_file {
my ($dir, $filename, $parser) = @_;
my $filepath = File::Spec->catfile($dir, $filename);
my $markdown = $parser->as_markdown;
return unless length chomp($markdown);
return if $markdown =~ m/^\s*$/;
_err("Writing to $filepath");
my $sec_sep = '';
if (-f $filepath) {
_err("$filepath already exists, going to append");
$sec_sep = "\n\n* * * *\n\n";
}
open my $wfh, '>>', $filepath or die "Couldn't open $filepath for output: $!";
print $wfh $sec_sep;
print $wfh $parser->as_markdown;
close $wfh;
}
sub _err {
my ($msg, @args) = @_;
my $str = sprintf($msg, @args);
say STDERR $str;
}
|
