From ccba436af54ff690c3853bf015e43767a356a7d6 Mon Sep 17 00:00:00 2001
From: Tom Feist <shabble@metavore.org>
Date: Mon, 18 Apr 2011 08:01:35 +0100
Subject: readme_generator: script to generate README.md files for github to
 use.

---
 readme_generator.pl | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 readme_generator.pl

diff --git a/readme_generator.pl b/readme_generator.pl
new file mode 100644
index 0000000..20e7312
--- /dev/null
+++ b/readme_generator.pl
@@ -0,0 +1,61 @@
+#!/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;
+
+my @dirs = @ARGV // '.';
+
+find(\&wanted, @dirs);
+
+sub wanted {
+    my ($file, $dir, $path) = ($_, $File::Find::dir, $File::Find::name);
+    return unless $file =~ m/\.pl$/;
+
+    _err("processing file: $path");
+}
+
+sub read_input_file {
+    my ($path, $filename) = @_;
+
+    my $filepath = File::Spec->catfile($path, $filename);
+
+    open my $rfh, '<', $filepath or die "Couldn't open $filepath for output: $!";
+
+    _err("reading $filepath");
+
+    my $parser = Pod::Markdown->new;
+
+    $parser->parse($rfh);
+
+    close $rfh;
+
+    create_output_file($path, 'README.md', $parser);
+}
+
+sub create_output_file {
+    my ($path, $filename, $parser) = @_;
+
+    my $filepath = File::Spec->catfile($path, $filename);
+
+    _err("Writing to $filepath");
+
+    open my $wfh, '>', $filepath or die "Couldn't open $filepath for output: $!";
+    print $wfh $parser->as_markdown;
+    close $wfh;
+}
+
+sub _err {
+    my ($msg, @args) = @_;
+    my $str = sprintf($msg, @args);
+    print STDERR $str;
+}
-- 
cgit v1.2.3