Added SQL rss feed, Fixed regex for image, and scp files to hpr server

Community_News/make_email: minor POD changes

Community_News/make_shownotes: minor POD changes

Community_News/shownote_template.tpl: now a copy of the latest template
    rather than a symbolic linkl to it

Community_News/shownote_template13.tpl: new template which doesn't
    filter 'comment_author_name' with 'html_entity'

Community_News/.make_email.cfg

@@ -0,0 +1,18 @@
+<email>
+    server = chatter.skyehaven.net
+    port   = 64738
+    room   = HPR
+    # Default day of the week for the recording
+    dayname = Friday
+    # Times are UTC
+    starttime = 16:00:00
+    endtime = 18:00:00
+    # Usually 2 hours are set aside. This value is used when a different start
+    # time is provided and no end time.
+    duration = 02 # hours
+    # Template is in the current directory
+    template = make_email_template.tpl
+</email>
+<recdates>
+    name = recording_dates.dat
+</recdates>

Community_News/.make_shownotes.cfg

@@ -0,0 +1,47 @@
+#
+# .make_shownotes.cfg (2025-04-13)
+# Configuration file for make_shownotes version >= 4
+#
+<settings>
+    # Format strings (using 'printf' formatting) for building certain required strings
+    title_template   = HPR Community News for %s %s
+    summary_template = HPR Volunteers talk about shows released and comments posted in %s %s
+
+    # Repeat the following line with each of the desired tags to make an
+    # array-like structure
+    tags             = Community News
+
+    # Host id for HPR Volunteers
+    # Series id for HPR Community News series
+    hostid = 159
+    series_id = 47
+
+    # Day the Community News show is released
+    releaseday = Monday
+
+    # Default day of the week for the recording
+    recordingday = Friday
+
+    # Recording times are UTC
+    starttime = 16:00:00
+    endtime = 17:00:00
+
+    # cache of previous recording dates and times
+    cache = recording_dates.dat
+
+    # Template Toolkit templates
+    # --------------------------
+
+    # Main note template (actually a soft link)
+    main_template = shownote_template.tpl
+
+    # Used to make a stand-alone HTML file from the default HTML
+    # fragment
+    container_template = shownotes_container.tpl
+
+</settings>
+
+<database>
+    # Assume a local file
+    name = hpr.db
+</database>

Community_News/README.md

@@ -0,0 +1,685 @@
+# NAME
+
+make\_shownotes - Make show notes for the Hacker Public Radio Community News show
+
+# VERSION
+
+This documentation refers to **make\_shownotes** version 0.4.5
+
+# USAGE
+
+    make_shownotes [-help] [-documentation|-man] [-config=FILE]
+        [-from=DATE] [-[no]comments] [-[no]silent] [-[no]mailnotes]
+        [-lastrecording=DATETIME]
+        [-full-html=FILE] [-html=FILE] [-json=FILE]
+        [-debug=N]
+
+# OPTIONS
+
+- **-help**
+
+    Displays a brief help message describing the usage of the program, and then exits.
+
+- **-documentation** or **-man**
+
+    Displays the entirety of the documentation (using a pager), and then exits.
+
+    To generate a PDF version use:
+
+        pod2pdf make_shownotes --out=make_shownotes.pdf
+
+- **-config=FILE**
+
+    The script uses a configuration file to hold the various parameters it needs
+    to run. This option allows an alternative configuration file to be used. This file
+    defines many settings including the location of the database.
+
+    See the CONFIGURATION AND ENVIRONMENT section below for the file format.
+
+    If the option is omitted the default file is used: **.make\_shownotes.cfg**,
+    which is expected to be in the same directory as the script itself.
+
+- **-from=DATE**
+
+    This option is used to indicate the month for which the shownotes are to be
+    generated. The script is able to parse a variety of date formats, but it is
+    recommended that ISO8601 **YYYY-MM-DD** format be used (for example 2014-06-30).
+
+    The day part of the date must be present but is ignored and only the month and
+    year parts are used (to internally denote the first day of the month).
+
+    If this option is omitted the current month is used. Of course, this may cause
+    problems if the notes are to generated for an earlier (or later) month, which
+    is why this option exists.
+
+- **-\[no\]comments**
+
+    This option controls whether the comments pertaining to the selected month are
+    included in the output. If the option is omitted then no comments are included
+    (**-nocomments**).
+
+- _Output file options_: **-html=FILE**, **-full-html=FILE**, **-json=FILE**
+
+    There are three output file types that can be generated by the script. At
+    least one must be present:
+
+    - _HTML fragment_ (**-html=FILE**)
+
+        This file will contain the HTML to be added to the HPR database. The page for
+        the show, when it is released, will be a full web page, with standard header
+        and footer, and the contents will come from this HTML fragment in the database.
+
+        Action will be needed in addition to the script to add this file to the
+        database, but how this is done is outside the scope of this documentation.
+
+    - _Standalone HTML_ (**-full-html=FILE**)
+
+        The file created in this case will contain a full, stand-alone HTML page. It
+        is intended to be circulated to the co-hosts recording the episode to make it
+        easier to access various information sources during the recording.
+
+        In the file the comments relating to past shows will show the full text, and
+        there will be indications of comments that were read in the last recording,
+        and any that were missed.
+
+        In order to highlight comments read, and those missed in the previous
+        recording the script needs to know the date and time of the recording. This
+        information should be in a date cache file referenced in the configuration
+        file (usually **recording\_dates.dat**). This file is updated when the monthly
+        mail message is generated (see **make\_email**). If, for any reason, this has
+        not happened, the information can be provided with the
+        **-lastrecording=DATETIME** option (alternatively written as **-lr=DATETIME**).
+        See below for more information.
+
+    - _JSON details_ (**-json=FILE**)
+
+        This file will contain JSON data which is intended to be used to upload the
+        episode to the database. How this is done is outside the scope of this
+        document. The format used is very close to that used in the workflow which is
+        used to upload episodes submitted through the upload forms.
+
+    In all cases the output file name may contain the characters '**%s**'. This
+    denotes the point at which the year and month in the format **YYYY-MM** are
+    inserted. For example if the script is being run for July 2014 the option:
+
+        -html=shownotes_%s.html
+
+    This will cause the generation of the file:
+
+        shownotes_2014-07.html
+
+- **-lastrecording=DATETIME** or **-lr=DATETIME**
+
+    As mentioned for **-full-html=FILE**, and later in the _MARKING COMMENTS_
+    section, the script needs the date of the last recording when marking
+    comments. This can be extracted from the file referenced in the configuration
+    data using the setting **cache**. By default the name of this file is
+    **recording\_dates.dat**, and its contents are managed when the script
+    **make\_email** is run and by this script.
+
+    If for any reason the date and time of the last recording is missing, these
+    values can be defined with this option, and these values will be written to
+    the cache file (or modified, if necessary).
+
+    The format can be an ISO 8601 date followed by a 24-hour time, such as
+    '2020-01-25 15:00:00'. If the time is omitted it defaults to the value of
+    _starttime_ in the configuration file.
+
+    The script will update the cache file with the date and time used in this
+    option if the relevant entry is missing. Also, if an entry is present but the
+    values are different from those provided with the option, the relevant entry
+    will be updated.
+
+    Note that the **DATETIME** value must contain the date of the last recording.
+    This will be checked, and written to the cache file prefixed by a "key"
+    consisting of the first day of the month _BEFORE_ the month being reviewed.
+
+    For example, when generating the notes for August 2025 the following command
+    will be needed if there is no last recording date (for July 2025) in the
+    cache:
+
+        ./make_shownotes -from=2025-08-01 -full-html=full_shownotes_%s.html \
+            -mail -comments -lr="2025-08-01 15:00:00"
+
+    Here we need the last recording date for the show reviewing HPR shows in July
+    2025\. The date and time for this recording was in early August (Friday before
+    the first Monday of September 2025-09-01), as shown. This combination will
+    result in the addition of the following line to the cache file:
+
+        2025-07-01,2025-08-01 15:00:00
+
+    As mentioned, the addition of such date and time information to the cache will
+    normally be performed by **make\_email**, which performs the date computations
+    itself, unlike this script. This feature in this script is an alternative for
+    special cases.
+
+- **-\[no\]silent**
+
+    This option controls whether the script reports details of its progress
+    to STDERR. If the option is omitted the report is generated (**-nosilent**).
+
+    The script reports: the month it is working on, the name of the requested output files
+    and details of the process of generating these files.
+
+- **-\[no\]mailnotes**
+
+    If desired, the show notes may include a section linking to recent discussions
+    on the HPR Mailman mailing list.
+
+    The current template (defined in the configuration file by the variable
+    **main\_template**, **shownote\_template12.tpl**) simply contains a section
+    like the following:
+
+        [%- IF mailnotes == 1 -%]
+        <h2>Mailing List discussions</h2>
+        <p>
+        Policy decisions surrounding HPR are taken by the community as a whole.
+        This discussion takes place on the <a href="[% mailinglist %]"
+        target="_blank">Mailing List</a> which is open to all HPR listeners and
+        contributors. The discussions are open and available on the HPR server
+        under <a href="[% mailbase %]">Mailman</a>.
+        </p>
+        <p>The threaded discussions this month can be found here:</p>
+        <a href="[% mailthreads %]" target="_blank">[% mailthreads %]</a>
+        [%- END %]
+
+    The _TT2_ variables such as **mailinglist** and **mailthreads** are defined earlier in
+    the template.
+
+- **-debug=N**
+
+    Enables debugging mode when N > 0 (zero is the default, no debugging output).
+    The levels are:
+
+    Values are:
+
+    1. TBA
+    2. Reports the following (as well as the data for level 1):
+
+        >         Details of the last recording data (and time)
+
+    3. Reports the following (as well as the data for level 2):
+
+        >         The generation of comment indexes needed in the comment lists. These are
+        >         computed after the query has been run.
+
+    4. See the **DESCRIPTION** section for an explanation of the data structures
+    mentioned here.
+
+        Reports the following (as well as the data for level 3):
+
+        >         A dump of the '%past' hash which contains details of comments on past shows.
+        >
+        >         A dump of the '%current' hash which contains details of comments on this
+        >         month's shows.
+        >
+        >         A dump of the '@missed\_comments' array containing comments that arrived after
+        >         the last recording.
+        >
+        >         A list of the duplicated episode numbers in '@missed\_episodes'
+        >
+        >         Another dump of '%past' after it has been cleaned up. Also the count of
+        >         comments to past shows and the comment count.
+
+# MARKING COMMENTS
+
+Explaining the marking of comments in the full HTML file:
+
+> This is only relevant when generating the full stand-alone HTML ("handout")
+> for circulation to the volunteers recording the Community News episode. In
+> this output the comments sent in to past shows (those before the review month)
+> include their full texts in order to make reading them easier.
+>
+> Normally comments (to shows in the reviewed month) are read as the shows
+> themselves are reviewed, so the full texts are not needed in this handout.
+>
+> In addition to this, there is a possibility that certain comments relating to
+> past shows were already discussed last month, because they were made before
+> that show was recorded. We don't want to read them again during this show, so
+> a means of marking them is needed.
+>
+> As well as this, some comments may have been missed in the last month because
+> the recording was made before the end of the review month. On some months of
+> the year the recording is made during the month itself because the first
+> Monday of the next month is in the first few days of the next month. For
+> example, in March 2019 the date of recording is the 30th, and the show is
+> released on April 1st. Between the recording and the release of the show there
+> is time during which more comments could be submitted.
+>
+> Such comments should be in the notes for March (and these can be regenerated
+> to make sure this is so) but they will not have been read on the March
+> recording. The **make\_shownotes** script detects this problem and, if
+> generating full notes will show a list of any eligible comments in a red
+> highlighted box. This is so that the volunteers recording the show can ensure
+> they read comments that have slipped through this loophole.
+>
+> The script extracts the date of the last recording  from the _cache_ file (or
+> it can be specified with the **-lastrecording=DATETIME** option, or its
+> abbreviation **-lr=DATETIME**) and passes it to the template. The template can
+> then compare this date with the dates of the relevant comments and take action
+> to highlight those that don't want to be re-read or were missed last month. It
+> is up to the template to do what is necessary to highlight them.
+
+# DESCRIPTION
+
+## Overview
+
+This script generates notes for the next Hacker Public Radio _Community News_
+show. It does this by collecting various details of activity from the HPR
+database and passing them to a template. The default template is called
+**shownote\_template.tpl** (defined in the configuration file) and this
+generates HTML, but any suitable textual format could be generated if
+required, by using a different template.
+
+## Data Gathering
+
+Four types of information are collected by the script:
+
+- **Host details**
+
+    Details of new hosts who have released new shows in the selected month
+
+- **Show details**
+
+    Details of shows which have been released in the selected month
+
+- **Comments**
+
+    Comments which have been submitted to the HPR website in the selected month.
+    These need to be related to shows in the current period or in the past.
+    Comments made about shows which have not yet been released (but are visible on
+    the website) are not included even though they are made in the current month.
+
+- **Mailing list threads**
+
+    A link to the current threads on the mailing list in the past month can be included. This
+    is done by default but can be skipped if the **-nomailnotes** option is used.
+
+## Report Generation
+
+The four components listed above are formatted in the following way by the
+default template.
+
+- **New Hosts**
+
+    These are formatted as a list of links to the **hostid** with the host's name.
+
+- **Shows**
+
+    These are formatted into an HTML table containing the show number, title and
+    host name. The show title is a link to the show page on the HPR website. The
+    host name is a link to the host page on the website.
+
+- **Comments**
+
+    These are formatted with &lt;article> tags separated by horizontal lines.
+    A &lt;header> shows the author name and title and a &lt;footer> displays a link to
+    the show and the show's host and the show title is also included. Where
+    relevant, the body of the article contains the comment text with line breaks.
+
+- **Mailing list discussions**
+
+    A link to the mail threads on the mailing list is included if the
+    **-mailnotes** option is chosen or defaulted.
+
+    See the explanation of the **-mailnotes** option for more details.
+
+## Variable, Field and Hash names
+
+If you wish to write your own template refer to the following lists for the
+names of items. Also refer to the default template **shownote\_template.tpl**
+for the techniques used there. (Note that **shownote\_template.tpl** is a soft
+link to the current default template, such as **shownote\_template12.tpl**, the
+soft link name is currently used in the configuration file).
+
+The hash and field names available to the template are as follows
+
+- **Global variables**
+
+        Variable Name          Details
+        -------------          -------
+        review_month           The month name of the report date
+        review_year            The year of the report date
+        comment_count          The number of comments in total
+        past_count             The number of comments on old shows
+        ignore_count           The number of past comments to ignore
+        missed_count           The number of comments missed last time
+        skip_comments          Set when -comments is omitted
+        mark_comments          Set when comments are being marked
+        ctext                  Set when the comment texts in the 'Past shows'
+                               section are to be shown
+        last_recording         The date the last recording was made
+                               in Unixtime format
+        last_month             The month prior to the month for which the notes are
+                               being generated (computed if comments are being
+                               marked) in 'YYYY-MM' format
+        mailnotes              Set when a mail link is required
+
+- **New Hosts**
+
+    The name of the hash in the template is **hosts**. The hash might be empty if
+    there are no new hosts in the month. See the default template for how to
+    handle this.
+
+        Field Name     Details
+        ----------     -------
+        host           Name of host
+        hostid         Host id number
+
+- **Show Details**
+
+    The name of the hash in the template is **shows**. Note that there are more
+    fields available than are used in the default template. Note also that certain
+    field names are aliases to avoid clashes (e.g. _eps\_hostid_ and _ho\_hostid_).
+
+        Field Name     Details
+        ----------     -------
+        eps_id         Episode number
+        date           Episode date
+        title          Episode title
+        length         Episode duration
+        summary        Episode summary
+        notes          Episode show notes
+        eps_hostid     The numerical host id from the 'eps' table
+        series         The series number from the 'eps' table
+        explicit       The explicit marker for the show
+        eps_license    The license for the show
+        tags           The show's tags as a comma-delimited string
+        version        ?Obsolete?
+        eps_valid      The valid value from the 'eps' table
+        ho_hostid      The host id number from the 'hosts' table
+        ho_host        The host name
+        email          The hosts's email address (protected)
+        profile        The host's profile
+        ho_license     The default license for the host
+        ho_valid       The valid value from the 'hosts' table
+
+- **Comment Details**
+
+    Two hashes are created for comments. The hash named **past** contains comments
+    made in the review month to shows before this month, and **current** contains
+    comments to this month's shows. Note that these hashes are only populated if
+    the **-comments** option is provided or defaulted. Both hashes have the same
+    structure.
+
+        Field Name             Details
+        ----------             -------
+        episode                Episode number
+        identifier_url         Full show URL
+        title                  Episode title
+        date                   Episode date
+        host                   Host name
+        hostid                 Host id number
+        timestamp              Comment timestamp in ISO8601 format
+        comment_author_name    Name of the commenter
+        comment_title          Title of comment
+        comment_text           Text of the comment
+        comment_timestamp_ut   Comment timestamp in Unixtime format
+        in_range               Boolean (0/1) denoting whether the comment was made
+                               in the target month
+        index                  The numerical index of the comment for a given show
+        ignore                 Boolean (0/1), set if the comment is to be ignored
+
+    The purpose of the **in\_range** value is to denote whether a comment was made
+    in the target month. This is used in the script to split the comments into the
+    **past** and **current** hashes. It is therefore of little use in the template,
+    but is retained in case it might be useful. The **index** value can be used in
+    the template to refer to the comment, make linking URLs etc. It is generated
+    by the SQL.
+
+- **Mailing List Link**
+
+    The variable **mailnotes** contains 0 or 1 depending on whether the link and
+    accompanying text are required.
+
+## Filters
+
+A filter called **decode\_entities** is available to the template. The reason
+for creating this was when the HTML of a comment is being listed as text
+(Unicode actually). Since comment text is stored in the database as HTML with
+entities when appropriate this is needed to prevent the plain text showing
+_&amp;amp;_ and the like verbatim. It is not currently used, but has been left in
+case it might be of use in future.
+
+# DIAGNOSTICS
+
+- **Unable to find configuration file ...**
+
+    The nominated configuration file in **-config=FILE** (or the default file)
+    cannot be found.
+
+- **Error: Unable to find AOB file ...**
+
+    The AOB file referred to in the error message is missing. Th
+
+- **Use -lastrecording=DATETIME only with -full-html=FILE**
+
+    The **-lastrecording=DATETIME** option is only relevant when the full
+    stand-alone HTML is being generated. This is a fatal error.
+
+- **At least one of -html=FILE, -full-html=FILE and -json=FILE must be present**
+
+    The script writes up to three output files, as explained above. At least one
+    must be present otherwise there is no point in running it!
+
+- **Error: Unable to find ... file ...**
+
+    The type of mandatory file with the name referred to in the error message is missing.
+
+- **The date and time of the last recording is not in the cache**
+
+    Followed by:
+
+        Use option -lastrecording=DATETIME (or -lr=DATETIME) instead
+        Can't continue
+
+    This means that the date and time expected in the date cache cannot be found,
+    so the script needs to be run again with the information presented in the
+    option mentioned.
+
+- **Unable to find database**
+
+    The SQLite database referenced in the configuration file has not been found.
+
+- **Trying to overwrite an existing show. Aborting**
+
+    After a check on the database, the computed episode number matches a slot that
+    has already been allocated. A check has been made for an old-style placeholder
+    for Community News episodes, but no match was found, so the script has aborted
+    in case an existing episode will be overwritten.
+
+- **Error: show ... has a date in the past**
+
+    The date computed for the Community News episode is in the past. Perhaps the
+    wrong date or month was specified in an option?
+
+- **Problem with constructing JSON**
+
+    A request for JSON output has been made. The script is attempting to collect
+    information about the host who is preparing the show (_HPR Volunteers_) but
+    the database query has failed.
+
+    It is possible the configuration file entry _hostid_ contains the wrong host
+    id number.
+
+- **Unable to find a reference show**
+
+    The script is attempting to find the release date (and episode number) for the
+    Community News show in the database. It does this by finding a reference
+    episode and stepping forward, incrementing the episode number and date. The
+    reference date is the earliest in the target month, but for some unexpected
+    reason this has not been found.
+
+- **Invalid DATE or DATETIME '...' in parse\_to\_dc**
+
+    It is likely that the date provided through the **-from=DATE** option is
+    invalid. Use an ISO8601 date in the format _YYYY-MM-DD_.
+
+- **... failed to open '...': ...**
+
+    There was a problem opening the date cache file. Check the details in the
+    configuration file. This file is expected to be located in the same directory
+    as the script.
+
+- **... failed to close '...': ...**
+
+    There was a problem closing the date cache file.
+
+- **Invalid Date::Calc date and time (...) in dc\_to\_dt**
+
+    There was a problem processing a date (and time). A likely cause is an invalid
+    date in one of options which requires and date or date and time. The script
+    will report more than usual on this error to try and aid with debugging.
+
+# CONFIGURATION AND ENVIRONMENT
+
+The script obtains the details and settings it required from a configuration
+file. The name of the file it expects is **.make\_shownotes.cfg**, but this can
+be changed with the **-config=FILE** option.
+
+The configuration file is expected to be in the directory holding the
+script. The script determines its location dynamically for this purpose.
+
+The configuration file contains the following settings, which are explained
+at the end.
+
+    #
+    # .make_shownotes.cfg (2025-04-13)
+    # Configuration file for make_shownotes version >= 4
+    #
+    <settings>
+        # Format strings (using 'printf' formatting) for building certain required strings
+        title_template   = HPR Community News for %s %s
+        summary_template = HPR Volunteers talk about shows released and comments posted in %s %s
+    
+        # Repeat the following line with each of the desired tags to make an
+        # array-like structure
+        tags             = Community News
+    
+        # Host id for HPR Volunteers
+        # Series id for HPR Community News series
+        hostid = 159
+        series_id = 47
+    
+        # Day the Community News show is released
+        releaseday = Monday
+    
+        # Default day of the week for the recording
+        recordingday = Friday
+    
+        # Recording times are UTC
+        starttime = 16:00:00
+        endtime = 17:00:00
+    
+        # cache of previous recording dates and times
+        cache = recording_dates.dat
+    
+        # Template Toolkit templates
+        # --------------------------
+    
+        # Main note template (actually a soft link)
+        main_template = shownote_template.tpl
+    
+        # Used to make a stand-alone HTML file from the default HTML
+        # fragment
+        container_template = shownotes_container.tpl
+    
+    </settings>
+    
+    <database>
+        # Assume a local file
+        name = hpr.db
+    </database>
+
+## Configuration file details
+
+If any mandatory elements are omitted from the configuration file they are
+given default values in the script.
+
+- **Section "settings"**
+    - **title\_template**, **summary\_template**
+
+        These are (_sprintf_) templates for these database fields, which are added to the full HTML
+        and the JSON. They are filled in (using _sprintf_) in the script.
+
+    - **tags**
+
+        Up to now, Community News episodes have used the tag **"Community News"**, so
+        this is now used in the configuration file.
+
+    - **hostid**, **series\_id**
+
+        As documented in the file, these are the internal numbers from the database
+        for the host and series associated with the show.
+
+    - **releaseday**, **recordingday**, **starttime**, **endtime**
+
+        These values define default dates and times for the recording of the show and
+        the date of release.
+
+    - **cache**
+
+        This is the name of the file holding recording dates and times for Community
+        News shows. The file is updated when **make\_email** is run since this script
+        defines the recording date and time. The script expects this file to be in the
+        directory holding the script itself, though an absolute path could be used if
+        needed.
+
+    - **main\_template**, **container\_template**
+
+        These are _TT2_ templates to be used by the script. The first is the template
+        used to generate the two types of HTML, and the second is used to generate
+        stand-alone HTML when the **-full-html=FILE** option is used. The script uses
+        both templates when generating the full HTML.
+
+        The **container\_template** contains a snapshot of an HPR HTML page with the body
+        removed and the header and footer retained. The generated notes are added by
+        the script, giving the HTML which can be handed out to the volunteers hosting
+        the recording.
+- **Section "database"**
+    - **name**
+
+        This contains the name of the SQLite database. This is a file which is
+        expected to be in the same directory as the script.
+
+# DEPENDENCIES
+
+Modules used:
+
+    Carp
+    Config::General
+    Cwd
+    DBI
+    Data::Dumper
+    Date::Calc
+    Date::Parse
+    DateTime::Duration
+    DateTime
+    File::Copy
+    Getopt::Long
+    HTML::Entities
+    JSON
+    Pod::Usage
+    Template::Filters
+    Template
+
+# BUGS AND LIMITATIONS
+
+There are no known bugs in this module.
+Please report problems to Dave Morriss (Dave.Morriss@gmail.com)
+Patches are welcome.
+
+# AUTHOR
+
+Dave Morriss  (Dave.Morriss@gmail.com)
+
+# LICENCE AND COPYRIGHT
+
+Copyright (c) 2014-2025 Dave Morriss (Dave.Morriss@gmail.com). All rights reserved.
+
+This module is free software; you can redistribute it and/or
+modify it under the same terms as Perl itself. See perldoc perlartistic.
+
+This program is distributed in the hope that it will be useful
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Community_News/build_AOB

@@ -241,7 +241,8 @@ AOBMKD="$BASEDIR/aob_$startdate.mkd"
 #     --define "table=$TMP1" "$AOBMKD" |\
 #     pandoc -f markdown-smart -t html5 -o "${AOBMKD%mkd}html"; then
 #
-if pandoc -f markdown-smart -t html5 "$AOBMKD" -o "${AOBMKD%mkd}html"; then
+if tpage "$AOBMKD" |\
+    pandoc -f markdown-smart -t html5 -o "${AOBMKD%mkd}html"; then
     echo "Converted $AOBMKD to HTML"
 else
     echo "Conversion of $AOBMKD to HTML failed"

Community_News/collect_HPR_database

@@ -0,0 +1,122 @@
+#!/bin/bash -
+#===============================================================================
+#
+#         FILE: collect_HPR_database
+#
+#        USAGE: ./collect_HPR_database
+#
+#  DESCRIPTION: Collects the SQL dump of the public copy of the HPR database
+#               from the website and converts it to SQLite.
+#
+#      OPTIONS: None
+# REQUIREMENTS: ---
+#         BUGS: ---
+#        NOTES: There are dependencies on mysql2sqlite and sqlite3. The former
+#               comes from https://github.com/mysql2sqlite and is expected to
+#               be in the same directory as this script. The sqlite3 package
+#               needs to be installed from the repository appropriate to the
+#               local OS. It is assumed that wget is available. The script
+#               uses auto-deleted temporary files for the MySQL dump, and the
+#               dump converted for SQLite.
+#       AUTHOR: Dave Morriss (djm), Dave.Morriss@gmail.com
+#      VERSION: 0.0.1
+#      CREATED: 2025-02-22 16:52:40
+#     REVISION: 2025-02-22 17:56:00
+#
+#===============================================================================
+
+set -o nounset                              # Treat unset variables as an error
+
+SCRIPT=${0##*/}
+BASEDIR=${0%/*}
+
+VERSION="0.0.1"
+
+# {{{ -- Functions: cleanup_temp
+#===  FUNCTION  ================================================================
+#          NAME:  cleanup_temp
+#   DESCRIPTION:  Cleanup temporary files in case of a keyboard interrupt
+#                 (SIGINT) or a termination signal (SIGTERM) and at script
+#                 exit. Expects to be called from 'trap' so it can just exit
+#                 (assuming it's all that's called)
+#    PARAMETERS:  * - names of temporary files to delete
+#       RETURNS:  Nothing
+#===============================================================================
+function cleanup_temp {
+    for tmp; do
+        [ -e "$tmp" ] && rm --force "$tmp"
+    done
+    exit 0
+}
+# }}}
+
+#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#
+# Make sure we're where the script lives
+#
+cd "$BASEDIR" || { echo "$SCRIPT: Failed to cd to $BASEDIR"; exit 1; }
+
+#
+# Make temporary files and set traps to delete them
+#
+TMP1=$(mktemp) || {
+    echo "$SCRIPT: creation of temporary file failed!"
+    exit 1
+}
+TMP2=$(mktemp) || {
+    echo "$SCRIPT: creation of temporary file failed!"
+    exit 1
+}
+trap 'cleanup_temp $TMP1 $TMP2' SIGHUP SIGINT SIGPIPE SIGTERM EXIT
+
+#
+# Definition of files
+#
+#-------------------------------------------------------------------------------
+mysql2sqlite="$BASEDIR/mysql2sqlite"
+snapshot_url="https://www.hackerpublicradio.org/hpr.sql"
+db_name="hpr.db"
+#-------------------------------------------------------------------------------
+
+#
+# Sanity check
+#
+[ -e "$mysql2sqlite" ] || {
+    echo "$SCRIPT: Unable to find mandatory script $mysql2sqlite"
+    exit 1
+}
+
+#
+# Collect the SQL dump into a temporary file`
+#
+if ! wget -q "$snapshot_url" -O "$TMP1"; then
+    echo "$SCRIPT: Failed to download from $snapshot_url"
+    exit 1
+fi
+
+#
+# Delete the SQLite database if it exists (otherwise the new data is merged
+# with it causing chaos)
+#
+[ -e "$db_name" ] && rm -f "$db_name"
+
+#
+# Convert the MySQL/MariaDB dump. First run sed on it, then run mysql2sqlite
+# (from https://github.com/mysql2sqlite) to do the SQL dump conversion. Use
+# the result to make a SQLite database.
+#
+sed '/^DELIMITER ;;/,/^DELIMITER ;/d' "$TMP1" > "$TMP2"
+$mysql2sqlite "$TMP2" | sqlite3 "$db_name"
+
+#
+# Report success if the new database exists
+#
+if [[ -e "$db_name" ]]; then
+    echo "Created SQLite database '$db_name'"
+else
+    echo "Failed to find the expected new database '$db_name'"
+fi
+
+# vim: syntax=sh:ts=8:sw=4:ai:et:tw=78:fo=tcrqn21:fdm=marker
+

Community_News/make_email_template.tpl

@@ -0,0 +1,76 @@
+[%# make_email_template.tpl 2025-04-03 -%]
+[%# Community News email template -%]
+[% USE wrap -%]
+[% subject %]
+
+[% FILTER replace('\n', ' ') -%]
+[% IF utc.days > 6 -%]
+The Community News for [% utc.revmonth %] will be recorded using Mumble on
+[% ELSE -%]
+The next Community News will be recorded using Mumble on
+[% END -%]
+[% utc.date %] between [% utc.start %] and [% utc.end %] in the '[% room %]' room on [% server %] port [% port %].
+[% END %]
+
+[% FILTER replace('\n', ' ') -%]
+During the recording HPR Volunteers will review the shows released during
+[% utc.revmonth %] [% utc.revyear %], they will read comments submitted during that
+month, as well as summarising email sent to the HPR mailing list.
+[% END %]
+
+[% FILTER replace('\n', ' ') -%]
+All HPR listeners are welcome to join in, but we ask that you listen to all
+the shows in [% utc.revmonth %] before you do so.
+[% END %]
+
+[% FILTER replace('\n', ' ') -%]
+Occasionally, due to local factors, we might need to change the time, or even
+the date, without warning. If you're planning on joining in it might be a good
+idea to let us know in advance - email admin@hackerpublicradio.org. Then we
+can contact you with the new schedule in the rare event that we have to
+make a change.
+[% END %]
+
+[% FILTER replace('\n', ' ') -%]
+The notes for the recording are an extended version of the show notes.
+A version without these extended elements is made for release on the HPR site
+(and on archive.org). Comments which might have been missed in the last
+recording will be marked in red in the extended version. Comments which would
+normally be in this month, but which were read out in the last show are marked
+in green. Comments made in the past month to older shows will be displayed in
+full (so they are easier to read).
+[% END %]
+
+[% FILTER replace('\n', ' ') -%]
+The notes for this recording will be made available to participants before the
+recording begins.
+[% END %]
+
+Summary:
+[% FILTER indent('   ') -%]
+Date of recording:      [% utc.date %]
+Start and end times:    [% utc.start %] and [% utc.end %]
+Mumble server:          [% server %]
+Port:                   [% port %]
+Room:                   [% room %]
+[% END -%]
+
+Refer to https://hackerpublicradio.org/recording.html for how to use Mumble.
+
+[% FILTER replace('\n', ' ') -%]
+There is an iCal file on the HPR site that you can load into a compatible
+calendar which will remind you of the next 12 upcoming recording dates.
+Access it from https://hackerpublicradio.org/HPR_Community_News_schedule.ics
+[% END %]
+
+See below for start and end times in various international timezones.
+
+[% FOREACH tz IN timezones -%]
+[% tz.name %]
+Start: [% tz.start %]
+End:   [% tz.end %]
+
+[% END -%]
+[%#
+  # vim: syntax=tt2:ts=8:sw=4:ai:et:tw=78:fo=tcrqn21
+-%]

Community_News/make_meeting

@@ -17,9 +17,9 @@
 #               Hacking"
 #       AUTHOR: Dave Morriss (djm), Dave.Morriss@gmail.com
 #      LICENCE: Copyright (c) year 2012-2024 Dave Morriss
-#      VERSION: 0.2.2
+#      VERSION: 0.2.3
 #      CREATED: 2012-10-13 15:34:01
-#     REVISION: 2024-05-24 22:45:56
+#     REVISION: 2024-10-28 13:17:44
 #
 #===============================================================================
 
@@ -42,7 +42,7 @@ use Date::ICal;
 #
 # Version number (manually incremented)
 #
-our $VERSION = '0.2.2';
+our $VERSION = '0.2.3';
 
 #
 # Script name
@@ -65,8 +65,6 @@ my ( @startdate, @rdate, @events );
 #
 # Attributes for the calendar message
 #
-#my $server = 'ch1.teamspeak.cc';
-#my $port   = 64747;
 my $server = 'chatter.skyehaven.net';
 my $port   = 64738;
 
@@ -129,9 +127,10 @@ else {
 # of having a time zone defined (default UTC, as now).
 #
 my $monday = 1;    # Day of week number 1-7, Monday-Sunday
+my $offset = -3;   # Offset from the target date (-3 is Friday)
 
-my @starttime = ( 13, 00, 00 );    # UTC
+my @starttime = ( 15, 00, 00 );    # UTC
-my @endtime   = ( 15, 00, 00 );
+my @endtime   = ( 17, 00, 00 );
 
 my @todostart = (  9, 00, 00 );    # UTC
 my @todoend   = ( 17, 00, 00 );
@@ -161,12 +160,13 @@ http://hackerpublicradio.org/recording.php
 ENDDESC
 
 #
-# Compute the next recording date from the starting date (@startdate will be
+# Compute the next recording date from the starting date.
-# today's date or the start of the explicitly selected month provided via
+# Now @startdate will be today's date or the start of the explicitly selected
-# -from=DATE. We want day of the week to be Monday, the first in the month,
+# month provided via -from=DATE. We want day of the week to be Monday, the
-# then to go back 1 day from that to get to the Sunday! Simple)
+# first in the month, then to go back $offset days from that to get to the
+# recording day! Simple.
 #
-@startdate = make_date( \@startdate, $monday, 1, -1 );
+@startdate = make_date( \@startdate, $monday, 1, $offset );
 @rdate = @startdate;
 
 #
@@ -208,7 +208,7 @@ for my $i ( 1 .. $count ) {
     #
     # Recording date computation from the start of the month
     #
-    @rdate = make_date( \@rdate, $monday, 1, -1 );
+    @rdate = make_date( \@rdate, $monday, 1, $offset );
 
     #
     # Save the current recording date to make an array of arrayrefs
@@ -305,8 +305,9 @@ exit;
 #      RETURNS: The start of the month in the textual date in Date::Calc
 #               format
 #  DESCRIPTION: Parses the date string and makes a Date::Calc date from the
-#               result where the day part is 1. Optionally checks that the
+#               result where the day part is forced to be 1. Optionally
-#               date isn't in the past, though $force = 1 ignores this check.
+#               checks that the date isn't in the past, though $force
+#               = 1 ignores this check.
 #       THROWS: No exceptions
 #     COMMENTS: Requires Date::Calc and Date::Parse
 #               Note the validation 'die' has a non-generic message

Community_News/recording_dates.dat

@@ -0,0 +1,38 @@
+2021-10-01,2021-10-30 14:00:00
+2022-06-01,2022-07-02 14:00:00
+2022-07-01,2022-07-30 14:00:00
+2022-08-01,2022-09-03 14:00:00
+2022-09-01,2022-10-01 14:00:00
+2022-10-01,2022-11-05 14:00:00
+2022-11-01,2022-12-03 15:00:00
+2022-12-01,2022-12-27 15:00:00
+2023-01-01,2023-02-04 15:00:00
+2023-02-01,2023-03-04 15:00:00
+2023-03-01,2023-04-01 15:00:00
+2023-04-01,2023-04-29 15:00:00
+2023-05-01,2023-06-03 15:00:00
+2023-07-01,2023-08-05 15:00:00
+2023-08-01,2023-09-02 15:00:00
+2023-09-01,2023-09-30 15:00:00
+2023-10-01,2023-11-04 15:00:00
+2023-11-01,2023-12-02 15:00:00
+2023-12-01,2023-12-30 15:00:00
+2024-01-01,2024-02-04 15:00:00
+2024-02-01,2024-03-02 15:00:00
+2024-03-01,2024-03-30 15:00:00
+2024-05-01,2024-06-02 13:00:00
+2024-06-01,2024-06-28 15:00:00
+2024-07-01,2024-08-02 15:00:00
+2024-08-01,2024-08-29 15:00:00
+2024-09-01,2024-10-04 15:00:00
+2024-10-01,2024-11-01 15:00:00
+2024-11-01,2024-11-29 15:00:00
+2024-12-01,2025-01-03 15:00:00
+2025-01-01,2025-01-31 15:00:00
+2025-02-01,2025-02-28 16:00:00
+2025-03-01,2025-04-04 16:00:00
+2025-04-01,2025-05-02 15:00:00
+2025-05-01,2025-05-30 15:00:00
+2025-06-01,2025-07-04 15:00:00
+2025-07-01,2025-08-01 15:00:00
+2025-08-01,2025-08-29 15:00:00

Community_News/shownote_template.tpl

@@ -1 +0,0 @@
-shownote_template11.tpl

Community_News/shownote_template.tpl

@@ -0,0 +1,223 @@
+[%# shownote_template13.tpl Updated: 2025-08-20 -%]
+[%# -------------------------------------------------------------------------------- -%]
+[%# Makes either an HTML snippet for insertion into the database or a full           -%]
+[%# listing with full comments for circulation to the hosts recording the episode    -%]
+[%# This one uses the new format for the mailing list data, and partitions           -%]
+[%# comments into past and current. It also marks comments that don't need           -%]
+[%# to be read when mark_comments is true. It requires make_shownotes >= V0.0.30     -%]
+[%# -------------------------------------------------------------------------------- -%]
+[%- USE date -%]
+[%- USE pad4 = format('%04d') -%]
+[%- correspondents = "https://hackerpublicradio.org/correspondents"
+    mailinglist = "https://lists.hackerpublicradio.com/mailman/listinfo/hpr"
+    mailbase="https://lists.hackerpublicradio.com/pipermail/hpr"
+    mailthreads = "$mailbase/$review_year-$review_month/thread.html" -%]
+[%- DEFAULT skip_comments = 0
+    mark_comments = 0
+    ctext = 0
+    ignore_count = 0
+    missed_count = 0
+    past_count = 0
+-%]
+[%# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -%]
+[%# Embedded CSS. The 'table' and 'hr' settings are always there but the rest is     -%]
+[%# only for when we are marking comments                                            -%]
+<style>
+table td.shrink {
+    white-space:nowrap
+}
+hr.thin {
+    border: 0;
+    height: 0;
+    border-top: 1px solid rgba(0, 0, 0, 0.1);
+    border-bottom: 1px solid rgba(255, 255, 255, 0.3);
+}
+[%- IF mark_comments == 1 %]
+p#ignore, li#ignore {
+    background-color: lightgreen;
+    color:maroon;
+}
+div#highlight {
+  border-style: solid;
+  border-color: red;
+  padding-right: 20px;
+  padding-left: 20px;
+}
+[%- END %]
+</style>
+[%# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -%]
+<h2>New hosts</h2>
+<p>
+[% IF hosts.size > 0 -%]
+Welcome to our new host[%- hosts.size > 1 ? 's' : '' -%]: <br />
+[%- count = 0 %]
+[%# List the new hosts. If a name contains a comma quote it.                  -%]
+[%- FOREACH row IN hosts %]
+    [%- count = count + 1 %]
+    [%- hostname = (row.host.search(',') ? row.host.replace('^(.*)$','"$1"') : row.host) %]
+    <a href="[% correspondents %]/[% pad4(row.hostid) %].html" target="_blank">[% hostname %]</a>
+    [%- count < hosts.size ? ', ' : '.' %]
+[%- END %]
+[% ELSE -%]
+There were no new hosts this month.
+[% END -%]
+</p>
+
+<h2>Last Month's Shows</h2>
+[%# The id 't01' is in the HPR CSS but might give trouble on the IA -%]
+<table id="t01">
+<tr>
+<th>Id</th>
+<th>Day</th>
+<th>Date</th>
+<th>Title</th>
+<th>Host</th>
+</tr>
+[%- FOREACH row IN shows %]
+<tr>
+<td><strong><a href="https://hackerpublicradio.org/eps/hpr[% pad4(row.eps_id) %]/index.html" target="_blank">[% row.eps_id %]</a></strong></td>
+<td>[% date.format(row.date,'%a') %]</td>
+<td class="shrink">[% date.format(row.date,'%Y-%m-%d') %]</td>
+<td><a href="https://hackerpublicradio.org/eps/hpr[% pad4(row.eps_id) %]/index.html" target="_blank">[% row.title %]</a></td>
+<td><a href="[% correspondents %]/[% pad4(row.ho_hostid) %].html" target="_blank">[% row.ho_host %]</a></td>
+</tr>
+[%- END %]
+</table>
+
+[%# ---------------------------------------------------------------------------------------- -%]
+[%# Skip comments if told to by the caller -%]
+[%- IF skip_comments == 0 -%]
+[%# Handle any missed comments if mark_comments is true -%]
+[%- IF (mark_comments == 1) AND (missed_count > 0) -%]
+<br/><div id="highlight">
+<h2>Missed comment[%- missed_comments.size > 1 ? 's' : '' -%] last month</h2>
+<p><b>Note to Volunteers</b>: These are comments for shows last month that were not read in the last show because they arrived on or after the recording started. This section will be removed before these notes are released.</p>
+<ul>
+[%- FOREACH comment IN missed_comments -%]
+<li><strong><a href="[% comment.identifier_url %]#comments" target="_blank">hpr[% pad4(comment.episode) %]</a></strong>
+([% comment.date %]) "<em>[% comment.title %]</em>" by <a href="[% correspondents %]/[% pad4(comment.hostid) %].html" target="_blank">[% comment.host %]</a>.<br/>
+<small>Summary: "<em>[% comment.summary %]</em>"</small><br/>
+From: [% comment.comment_author_name %] on [% date.format(comment.comment_timestamp_ut,'%Y-%m-%d','UTC') -%]:
+[%- IF comment.comment_title.length > 0 %]
+"[% comment.comment_title %]"
+[%- ELSE -%]
+"[no title]"
+[%- END -%]
+<br/><hr class="thin">[% comment.comment_text FILTER html_line_break %]
+</li><br/>
+[%- END -%]
+</ul></div>
+[%- END -%]
+[%# ---------------------------------------------------------------------------------------- -%]
+<h2>Comments this month</h2>
+
+[% IF comment_count > 0 -%]
+[%- IF (mark_comments == 1) AND (ignore_count > 0) -%]
+<p id="ignore"><b>Note to Volunteers</b>: Comments marked in green were read in the last
+Community News show and should be ignored in this one.</p>
+[%- END -%]
+<p>These are comments which have been made during the past month, either to shows released during the month or to past shows.
+There [%- comment_count == 1 ? "is $comment_count comment" : "are $comment_count comments" -%] in total.</p>
+[% IF past_count > 0 -%]
+<h3>Past shows</h3>
+<p>There [% past_count == 1 ? "is $past_count comment" : "are $past_count comments" %] on
+[% past.size %] previous [% past.size == 1 ? "show" : "shows" %]:</p>
+<ul>
+[%# Loop through by episode then by comment relating to that episode -%]
+[%-    FOREACH ep IN past.keys.nsort -%]
+[%-       arr = past.$ep -%]
+<li><strong><a href="[% arr.0.identifier_url %]#comments" target="_blank">hpr[% pad4(arr.0.episode) %]</a></strong>
+([%       arr.0.date %]) "<em>[% arr.0.title %]</em>"
+by <a href="[% correspondents %]/[% pad4(arr.0.hostid) %].html" target="_blank">[% arr.0.host %]</a>.<br/>
+[%-       IF mark_comments == 1 || ctext == 1 -%]
+<small>Summary: "<em>[% arr.0.summary %]</em>"</small></li>
+[%-       END %]
+<li style="list-style: none; display: inline">
+<ul>
+[%-       FOREACH row IN arr -%]
+[%#          IF mark_comments == 1 && ((row.comment_timestamp_ut <= last_recording) && (arr.0.date.substr(0,7) == last_month)) -%]
+[%#          IF mark_comments == 1 && ((row.comment_released_ut <= last_recording) && (arr.0.date.substr(0,7) == last_month)) -%]
+[%-          IF mark_comments == 1 && row.ignore == 1 -%]
+<li id="ignore">
+[%-          ELSE %]
+<li>
+[%-          END %]
+<a href="[% row.identifier_url %]#comment_[% row.comment_id %]" target="_blank">Comment [% row.comment_number %]</a>:
+[%        row.comment_author_name -%] on [% date.format(row.comment_timestamp_ut,'%Y-%m-%d','UTC') -%]:
+[%-          IF row.comment_title.length > 0 %]
+"[%             row.comment_title %]"
+[%-          ELSE -%]
+"[no title]"
+[%-          END -%]
+[%# Add the comment body in too if ctext is true -%]
+[%-          IF ctext == 1 %]
+<br/><hr class="thin">[% row.comment_text FILTER html_line_break %]
+</li><br/>
+[%-          ELSE -%]
+</li>
+[%-          END -%]
+[%-       END -%]
+</ul><br/>
+</li>
+[%-    END -%]
+</ul>
+[%- END %]
+[%# ---------------------------------------------------------------------------------------- -%]
+[% cc = (comment_count - past_count) -%]
+[% IF cc > 0 -%]
+<h3>This month's shows</h3>
+<p>There [% cc == 1 ? "is $cc comment" : "are $cc comments" %] on [% current.size %] of this month's shows:</p>
+<ul>
+[%- FOREACH ep IN current.keys.nsort -%]
+[%- arr = current.$ep -%]
+<li><strong><a href="[% arr.0.identifier_url %]#comments" target="_blank">hpr[% pad4(arr.0.episode) %]</a></strong>
+([% arr.0.date %]) "<em>[% arr.0.title %]</em>"
+by <a href="[% correspondents %]/[% pad4(arr.0.hostid) %].html" target="_blank">[% arr.0.host %]</a>.</li>
+<li style="list-style: none; display: inline">
+<ul>
+[%- FOREACH row IN arr -%]
+<li><a href="[% row.identifier_url %]#comment_[% row.comment_id %]" target="_blank">Comment [% row.comment_number %]</a>:
+[% row.comment_author_name -%] on [% date.format(row.comment_timestamp_ut,'%Y-%m-%d','UTC') -%]:
+[%- IF row.comment_title.length > 0 %]
+"[% row.comment_title %]"
+[%- ELSE -%]
+"[no title]"
+[%- END -%]
+</li>
+[%- END -%]
+</ul><br/>
+</li>
+[%- END -%]
+</ul>
+[%- END %]
+[%- ELSE %]
+There were no comments this month.
+[%- END %]
+[%- END %]
+
+[%# ---------------------------------------------------------------------------------------- -%]
+[%- IF mailnotes == 1 -%]
+<h2>Mailing List discussions</h2>
+<p>
+Policy decisions surrounding HPR are taken by the community as a whole. This
+discussion takes place on the <a href="[% mailinglist %]" target="_blank">Mailing List</a>
+which is open to all HPR listeners and contributors. The discussions are open
+and available on the HPR server under <a href="[% mailbase %]">Mailman</a>.
+</p>
+<p>The threaded discussions this month can be found here:</p>
+<a href="[% mailthreads %]" target="_blank">[% mailthreads %]</a>
+[%- END %]
+
+[%# ---------------------------------------------------------------------------------------- -%]
+<h2>Events Calendar</h2>
+<p>With the kind permission of <strong>LWN.net</strong> we are linking to
+<a href="https://lwn.net/Calendar/" target="_blank">The LWN.net Community Calendar</a>.</p>
+<p>Quoting the site:</p>
+<blockquote>This is the LWN.net community event calendar, where we track
+events of interest to people using and developing Linux and free software.
+Clicking on individual events will take you to the appropriate web
+page.</blockquote>
+[%# ---------------------------------------------------------------------------------------- -%]
+[%#
+  # vim: syntax=tt2:ts=8:sw=4:ai:et:tw=78:fo=tcrqn21
+-%]

Community_News/shownote_template11.tpl

@@ -1,11 +1,15 @@
-[%# shownote_template11.tpl 2024-05-07 -%]
+[%# shownote_template11.tpl Updated: 2025-03-31 -%]
-[%# HTML snippet for insertion into the database -%]
+[%# -------------------------------------------------------------------------------- -%]
+[%# Makes either an HTML snippet for insertion into the database or a full           -%]
+[%# listing with full comments for circulation to the hosts recording the episode    -%]
 [%# This one uses the new format for the mailing list data, and partitions           -%]
 [%# comments into past and current. It also marks comments that don't need           -%]
-[%# to be read when -markcomments is selected. It requires make_shownotes >= V0.0.30 -%]
+[%# to be read when mark_comments is true. It requires make_shownotes >= V0.0.30     -%]
+[%# -------------------------------------------------------------------------------- -%]
 [%- USE date -%]
 [%- USE pad4 = format('%04d') -%]
 [%- correspondents = "https://hackerpublicradio.org/correspondents"
+    mailinglist = "https://lists.hackerpublicradio.com/mailman/listinfo/hpr"
     mailbase="https://lists.hackerpublicradio.com/pipermail/hpr"
     mailthreads = "$mailbase/$review_year-$review_month/thread.html" -%]
 [%- DEFAULT skip_comments = 0
@@ -15,8 +19,9 @@
     missed_count = 0
     past_count = 0
 -%]
-[%# Embedded CSS. The 'table' and 'hr' settings are always there but the rest is only for if -%]
+[%# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -%]
-[%# we are marking comments                                                                  -%]
+[%# Embedded CSS. The 'table' and 'hr' settings are always there but the rest is     -%]
+[%# only for when we are marking comments                                            -%]
 <style>
 table td.shrink {
     white-space:nowrap
@@ -40,12 +45,7 @@ div#highlight {
 }
 [%- END %]
 </style>
-[%# For the '-mailnotes' option without a file we generate our own inclusion. -%]
+[%# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -%]
-[%# We pretend 'default_mail' is a filename in the calling script. Messy.     -%]
-[% BLOCK default_mail -%]
-<a href="[% mailthreads %]" target="_blank">[% mailthreads %]</a>
-[% END -%]
-
 <h2>New hosts</h2>
 <p>
 [% IF hosts.size > 0 -%]
@@ -88,13 +88,13 @@ There were no new hosts this month.
 [%# Skip comments if told to by the caller -%]
 [%- IF skip_comments == 0 -%]
 [%# Handle any missed comments if mark_comments is true -%]
-[%- IF mark_comments == 1 && missed_count > 0 -%]
+[%- IF (mark_comments == 1) AND (missed_count > 0) -%]
 <br/><div id="highlight">
 <h2>Missed comment[%- missed_comments.size > 1 ? 's' : '' -%] last month</h2>
-<p><b>Note to Volunteers</b>: These are comments for shows last month that were not read in the last show because they arrived on or after the recording day. This section will be removed before these notes are released.</p>
+<p><b>Note to Volunteers</b>: These are comments for shows last month that were not read in the last show because they arrived on or after the recording started. This section will be removed before these notes are released.</p>
 <ul>
 [%- FOREACH comment IN missed_comments -%]
-<li><strong><a href="[% comment.identifier_url %]#comments" target="_blank">hpr[% comment.episode %]</a></strong>
+<li><strong><a href="[% comment.identifier_url %]#comments" target="_blank">hpr[% pad4(comment.episode) %]</a></strong>
 ([% comment.date %]) "<em>[% comment.title %]</em>" by <a href="[% correspondents %]/[% pad4(comment.hostid) %].html" target="_blank">[% comment.host %]</a>.<br/>
 <small>Summary: "<em>[% comment.summary %]</em>"</small><br/>
 From: [% comment.comment_author_name FILTER html_entity -%] on [% date.format(comment.comment_timestamp_ut,'%Y-%m-%d','UTC') -%]:
@@ -112,7 +112,7 @@ From: [% comment.comment_author_name FILTER html_entity -%] on [% date.format(co
 <h2>Comments this month</h2>
 
 [% IF comment_count > 0 -%]
-[%- IF mark_comments == 1 && ignore_count > 0 -%]
+[%- IF (mark_comments == 1) AND (ignore_count > 0) -%]
 <p id="ignore"><b>Note to Volunteers</b>: Comments marked in green were read in the last
 Community News show and should be ignored in this one.</p>
 [%- END -%]
@@ -124,9 +124,9 @@ There [%- comment_count == 1 ? "is $comment_count comment" : "are $comment_count
 [% past.size %] previous [% past.size == 1 ? "show" : "shows" %]:</p>
 <ul>
 [%# Loop through by episode then by comment relating to that episode -%]
-[%-    FOREACH ep IN past.keys.sort -%]
+[%-    FOREACH ep IN past.keys.nsort -%]
 [%-       arr = past.$ep -%]
-<li><strong><a href="[% arr.0.identifier_url %]#comments" target="_blank">hpr[% arr.0.episode %]</a></strong>
+<li><strong><a href="[% arr.0.identifier_url %]#comments" target="_blank">hpr[% pad4(arr.0.episode) %]</a></strong>
 ([%       arr.0.date %]) "<em>[% arr.0.title %]</em>"
 by <a href="[% correspondents %]/[% pad4(arr.0.hostid) %].html" target="_blank">[% arr.0.host %]</a>.<br/>
 [%-       IF mark_comments == 1 || ctext == 1 -%]
@@ -142,7 +142,7 @@ by <a href="[% correspondents %]/[% pad4(arr.0.hostid) %].html" target="_blank">
 [%-          ELSE %]
 <li>
 [%-          END %]
-<a href="[% row.identifier_url %]#[% row.index %]" target="_blank">Comment [% row.index %]</a>:
+<a href="[% row.identifier_url %]#comment_[% row.comment_id %]" target="_blank">Comment [% row.comment_number %]</a>:
 [%        row.comment_author_name FILTER html_entity -%] on [% date.format(row.comment_timestamp_ut,'%Y-%m-%d','UTC') -%]:
 [%-          IF row.comment_title.length > 0 %]
 "[%             row.comment_title %]"
@@ -158,7 +158,7 @@ by <a href="[% correspondents %]/[% pad4(arr.0.hostid) %].html" target="_blank">
 [%-          END -%]
 [%-       END -%]
 </ul><br/>
-</limage>
+</li>
 [%-    END -%]
 </ul>
 [%-    IF mark_comments == 1 || ctext == 1 -%]
@@ -171,15 +171,15 @@ by <a href="[% correspondents %]/[% pad4(arr.0.hostid) %].html" target="_blank">
 <h3>This month's shows</h3>
 <p>There [% cc == 1 ? "is $cc comment" : "are $cc comments" %] on [% current.size %] of this month's shows:</p>
 <ul>
-[%- FOREACH ep IN current.keys.sort -%]
+[%- FOREACH ep IN current.keys.nsort -%]
 [%- arr = current.$ep -%]
-<li><strong><a href="[% arr.0.identifier_url %]#comments" target="_blank">hpr[% arr.0.episode %]</a></strong>
+<li><strong><a href="[% arr.0.identifier_url %]#comments" target="_blank">hpr[% pad4(arr.0.episode) %]</a></strong>
 ([% arr.0.date %]) "<em>[% arr.0.title %]</em>"
 by <a href="[% correspondents %]/[% pad4(arr.0.hostid) %].html" target="_blank">[% arr.0.host %]</a>.</li>
 <li style="list-style: none; display: inline">
 <ul>
 [%- FOREACH row IN arr -%]
-<li><a href="[% row.identifier_url %]#[% row.index %]" target="_blank">Comment [% row.index %]</a>:
+<li><a href="[% row.identifier_url %]#comment_[% row.comment_id %]" target="_blank">Comment [% row.comment_number %]</a>:
 [% row.comment_author_name FILTER html_entity -%] on [% date.format(row.comment_timestamp_ut,'%Y-%m-%d','UTC') -%]:
 [%- IF row.comment_title.length > 0 %]
 "[% row.comment_title %]"
@@ -199,17 +199,16 @@ There were no comments this month.
 [%- END %]
 
 [%# ---------------------------------------------------------------------------------------- -%]
-[%- IF includefile.defined -%]
+[%- IF mailnotes == 1 -%]
 <h2>Mailing List discussions</h2>
 <p>
 Policy decisions surrounding HPR are taken by the community as a whole. This
-discussion takes place on the <a href="https://hackerpublicradio.org/maillist"
+discussion takes place on the <a href="[% mailinglist %]" target="_blank">Mailing List</a>
-target="_blank">Mail List</a> which is open to all HPR listeners and
+which is open to all HPR listeners and contributors. The discussions are open
-contributors. The discussions are open and available on the HPR server under
+and available on the HPR server under <a href="[% mailbase %]">Mailman</a>.
-<a href="[% mailbase %]">Mailman</a>.
 </p>
 <p>The threaded discussions this month can be found here:</p>
-[% INCLUDE $includefile -%]
+<a href="[% mailthreads %]" target="_blank">[% mailthreads %]</a>
 [%- END %]
 
 [%# ---------------------------------------------------------------------------------------- -%]
@@ -231,4 +230,3 @@ page.</blockquote>
 [%#
   # vim: syntax=tt2:ts=8:sw=4:ai:et:tw=78:fo=tcrqn21
 -%]
-

Community_News/shownote_template12.tpl

@@ -0,0 +1,223 @@
+[%# shownote_template12.tpl Updated: 2025-03-31 -%]
+[%# -------------------------------------------------------------------------------- -%]
+[%# Makes either an HTML snippet for insertion into the database or a full           -%]
+[%# listing with full comments for circulation to the hosts recording the episode    -%]
+[%# This one uses the new format for the mailing list data, and partitions           -%]
+[%# comments into past and current. It also marks comments that don't need           -%]
+[%# to be read when mark_comments is true. It requires make_shownotes >= V0.0.30     -%]
+[%# -------------------------------------------------------------------------------- -%]
+[%- USE date -%]
+[%- USE pad4 = format('%04d') -%]
+[%- correspondents = "https://hackerpublicradio.org/correspondents"
+    mailinglist = "https://lists.hackerpublicradio.com/mailman/listinfo/hpr"
+    mailbase="https://lists.hackerpublicradio.com/pipermail/hpr"
+    mailthreads = "$mailbase/$review_year-$review_month/thread.html" -%]
+[%- DEFAULT skip_comments = 0
+    mark_comments = 0
+    ctext = 0
+    ignore_count = 0
+    missed_count = 0
+    past_count = 0
+-%]
+[%# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -%]
+[%# Embedded CSS. The 'table' and 'hr' settings are always there but the rest is     -%]
+[%# only for when we are marking comments                                            -%]
+<style>
+table td.shrink {
+    white-space:nowrap
+}
+hr.thin {
+    border: 0;
+    height: 0;
+    border-top: 1px solid rgba(0, 0, 0, 0.1);
+    border-bottom: 1px solid rgba(255, 255, 255, 0.3);
+}
+[%- IF mark_comments == 1 %]
+p#ignore, li#ignore {
+    background-color: lightgreen;
+    color:maroon;
+}
+div#highlight {
+  border-style: solid;
+  border-color: red;
+  padding-right: 20px;
+  padding-left: 20px;
+}
+[%- END %]
+</style>
+[%# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -%]
+<h2>New hosts</h2>
+<p>
+[% IF hosts.size > 0 -%]
+Welcome to our new host[%- hosts.size > 1 ? 's' : '' -%]: <br />
+[%- count = 0 %]
+[%# List the new hosts. If a name contains a comma quote it.                  -%]
+[%- FOREACH row IN hosts %]
+    [%- count = count + 1 %]
+    [%- hostname = (row.host.search(',') ? row.host.replace('^(.*)$','"$1"') : row.host) %]
+    <a href="[% correspondents %]/[% pad4(row.hostid) %].html" target="_blank">[% hostname %]</a>
+    [%- count < hosts.size ? ', ' : '.' %]
+[%- END %]
+[% ELSE -%]
+There were no new hosts this month.
+[% END -%]
+</p>
+
+<h2>Last Month's Shows</h2>
+[%# The id 't01' is in the HPR CSS but might give trouble on the IA -%]
+<table id="t01">
+<tr>
+<th>Id</th>
+<th>Day</th>
+<th>Date</th>
+<th>Title</th>
+<th>Host</th>
+</tr>
+[%- FOREACH row IN shows %]
+<tr>
+<td><strong><a href="https://hackerpublicradio.org/eps/hpr[% pad4(row.eps_id) %]/index.html" target="_blank">[% row.eps_id %]</a></strong></td>
+<td>[% date.format(row.date,'%a') %]</td>
+<td class="shrink">[% date.format(row.date,'%Y-%m-%d') %]</td>
+<td><a href="https://hackerpublicradio.org/eps/hpr[% pad4(row.eps_id) %]/index.html" target="_blank">[% row.title %]</a></td>
+<td><a href="[% correspondents %]/[% pad4(row.ho_hostid) %].html" target="_blank">[% row.ho_host FILTER html_entity %]</a></td>
+</tr>
+[%- END %]
+</table>
+
+[%# ---------------------------------------------------------------------------------------- -%]
+[%# Skip comments if told to by the caller -%]
+[%- IF skip_comments == 0 -%]
+[%# Handle any missed comments if mark_comments is true -%]
+[%- IF (mark_comments == 1) AND (missed_count > 0) -%]
+<br/><div id="highlight">
+<h2>Missed comment[%- missed_comments.size > 1 ? 's' : '' -%] last month</h2>
+<p><b>Note to Volunteers</b>: These are comments for shows last month that were not read in the last show because they arrived on or after the recording started. This section will be removed before these notes are released.</p>
+<ul>
+[%- FOREACH comment IN missed_comments -%]
+<li><strong><a href="[% comment.identifier_url %]#comments" target="_blank">hpr[% pad4(comment.episode) %]</a></strong>
+([% comment.date %]) "<em>[% comment.title %]</em>" by <a href="[% correspondents %]/[% pad4(comment.hostid) %].html" target="_blank">[% comment.host %]</a>.<br/>
+<small>Summary: "<em>[% comment.summary %]</em>"</small><br/>
+From: [% comment.comment_author_name FILTER html_entity -%] on [% date.format(comment.comment_timestamp_ut,'%Y-%m-%d','UTC') -%]:
+[%- IF comment.comment_title.length > 0 %]
+"[% comment.comment_title %]"
+[%- ELSE -%]
+"[no title]"
+[%- END -%]
+<br/><hr class="thin">[% comment.comment_text FILTER html_line_break %]
+</li><br/>
+[%- END -%]
+</ul></div>
+[%- END -%]
+[%# ---------------------------------------------------------------------------------------- -%]
+<h2>Comments this month</h2>
+
+[% IF comment_count > 0 -%]
+[%- IF (mark_comments == 1) AND (ignore_count > 0) -%]
+<p id="ignore"><b>Note to Volunteers</b>: Comments marked in green were read in the last
+Community News show and should be ignored in this one.</p>
+[%- END -%]
+<p>These are comments which have been made during the past month, either to shows released during the month or to past shows.
+There [%- comment_count == 1 ? "is $comment_count comment" : "are $comment_count comments" -%] in total.</p>
+[% IF past_count > 0 -%]
+<h3>Past shows</h3>
+<p>There [% past_count == 1 ? "is $past_count comment" : "are $past_count comments" %] on
+[% past.size %] previous [% past.size == 1 ? "show" : "shows" %]:</p>
+<ul>
+[%# Loop through by episode then by comment relating to that episode -%]
+[%-    FOREACH ep IN past.keys.nsort -%]
+[%-       arr = past.$ep -%]
+<li><strong><a href="[% arr.0.identifier_url %]#comments" target="_blank">hpr[% pad4(arr.0.episode) %]</a></strong>
+([%       arr.0.date %]) "<em>[% arr.0.title %]</em>"
+by <a href="[% correspondents %]/[% pad4(arr.0.hostid) %].html" target="_blank">[% arr.0.host %]</a>.<br/>
+[%-       IF mark_comments == 1 || ctext == 1 -%]
+<small>Summary: "<em>[% arr.0.summary %]</em>"</small></li>
+[%-       END %]
+<li style="list-style: none; display: inline">
+<ul>
+[%-       FOREACH row IN arr -%]
+[%#          IF mark_comments == 1 && ((row.comment_timestamp_ut <= last_recording) && (arr.0.date.substr(0,7) == last_month)) -%]
+[%#          IF mark_comments == 1 && ((row.comment_released_ut <= last_recording) && (arr.0.date.substr(0,7) == last_month)) -%]
+[%-          IF mark_comments == 1 && row.ignore == 1 -%]
+<li id="ignore">
+[%-          ELSE %]
+<li>
+[%-          END %]
+<a href="[% row.identifier_url %]#comment_[% row.comment_id %]" target="_blank">Comment [% row.comment_number %]</a>:
+[%        row.comment_author_name FILTER html_entity -%] on [% date.format(row.comment_timestamp_ut,'%Y-%m-%d','UTC') -%]:
+[%-          IF row.comment_title.length > 0 %]
+"[%             row.comment_title %]"
+[%-          ELSE -%]
+"[no title]"
+[%-          END -%]
+[%# Add the comment body in too if ctext is true -%]
+[%-          IF ctext == 1 %]
+<br/><hr class="thin">[% row.comment_text FILTER html_line_break %]
+</li><br/>
+[%-          ELSE -%]
+</li>
+[%-          END -%]
+[%-       END -%]
+</ul><br/>
+</li>
+[%-    END -%]
+</ul>
+[%- END %]
+[%# ---------------------------------------------------------------------------------------- -%]
+[% cc = (comment_count - past_count) -%]
+[% IF cc > 0 -%]
+<h3>This month's shows</h3>
+<p>There [% cc == 1 ? "is $cc comment" : "are $cc comments" %] on [% current.size %] of this month's shows:</p>
+<ul>
+[%- FOREACH ep IN current.keys.nsort -%]
+[%- arr = current.$ep -%]
+<li><strong><a href="[% arr.0.identifier_url %]#comments" target="_blank">hpr[% pad4(arr.0.episode) %]</a></strong>
+([% arr.0.date %]) "<em>[% arr.0.title %]</em>"
+by <a href="[% correspondents %]/[% pad4(arr.0.hostid) %].html" target="_blank">[% arr.0.host %]</a>.</li>
+<li style="list-style: none; display: inline">
+<ul>
+[%- FOREACH row IN arr -%]
+<li><a href="[% row.identifier_url %]#comment_[% row.comment_id %]" target="_blank">Comment [% row.comment_number %]</a>:
+[% row.comment_author_name FILTER html_entity -%] on [% date.format(row.comment_timestamp_ut,'%Y-%m-%d','UTC') -%]:
+[%- IF row.comment_title.length > 0 %]
+"[% row.comment_title %]"
+[%- ELSE -%]
+"[no title]"
+[%- END -%]
+</li>
+[%- END -%]
+</ul><br/>
+</li>
+[%- END -%]
+</ul>
+[%- END %]
+[%- ELSE %]
+There were no comments this month.
+[%- END %]
+[%- END %]
+
+[%# ---------------------------------------------------------------------------------------- -%]
+[%- IF mailnotes == 1 -%]
+<h2>Mailing List discussions</h2>
+<p>
+Policy decisions surrounding HPR are taken by the community as a whole. This
+discussion takes place on the <a href="[% mailinglist %]" target="_blank">Mailing List</a>
+which is open to all HPR listeners and contributors. The discussions are open
+and available on the HPR server under <a href="[% mailbase %]">Mailman</a>.
+</p>
+<p>The threaded discussions this month can be found here:</p>
+<a href="[% mailthreads %]" target="_blank">[% mailthreads %]</a>
+[%- END %]
+
+[%# ---------------------------------------------------------------------------------------- -%]
+<h2>Events Calendar</h2>
+<p>With the kind permission of <strong>LWN.net</strong> we are linking to
+<a href="https://lwn.net/Calendar/" target="_blank">The LWN.net Community Calendar</a>.</p>
+<p>Quoting the site:</p>
+<blockquote>This is the LWN.net community event calendar, where we track
+events of interest to people using and developing Linux and free software.
+Clicking on individual events will take you to the appropriate web
+page.</blockquote>
+[%# ---------------------------------------------------------------------------------------- -%]
+[%#
+  # vim: syntax=tt2:ts=8:sw=4:ai:et:tw=78:fo=tcrqn21
+-%]

Community_News/shownote_template13.tpl

@@ -0,0 +1,223 @@
+[%# shownote_template13.tpl Updated: 2025-08-20 -%]
+[%# -------------------------------------------------------------------------------- -%]
+[%# Makes either an HTML snippet for insertion into the database or a full           -%]
+[%# listing with full comments for circulation to the hosts recording the episode    -%]
+[%# This one uses the new format for the mailing list data, and partitions           -%]
+[%# comments into past and current. It also marks comments that don't need           -%]
+[%# to be read when mark_comments is true. It requires make_shownotes >= V0.0.30     -%]
+[%# -------------------------------------------------------------------------------- -%]
+[%- USE date -%]
+[%- USE pad4 = format('%04d') -%]
+[%- correspondents = "https://hackerpublicradio.org/correspondents"
+    mailinglist = "https://lists.hackerpublicradio.com/mailman/listinfo/hpr"
+    mailbase="https://lists.hackerpublicradio.com/pipermail/hpr"
+    mailthreads = "$mailbase/$review_year-$review_month/thread.html" -%]
+[%- DEFAULT skip_comments = 0
+    mark_comments = 0
+    ctext = 0
+    ignore_count = 0
+    missed_count = 0
+    past_count = 0
+-%]
+[%# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -%]
+[%# Embedded CSS. The 'table' and 'hr' settings are always there but the rest is     -%]
+[%# only for when we are marking comments                                            -%]
+<style>
+table td.shrink {
+    white-space:nowrap
+}
+hr.thin {
+    border: 0;
+    height: 0;
+    border-top: 1px solid rgba(0, 0, 0, 0.1);
+    border-bottom: 1px solid rgba(255, 255, 255, 0.3);
+}
+[%- IF mark_comments == 1 %]
+p#ignore, li#ignore {
+    background-color: lightgreen;
+    color:maroon;
+}
+div#highlight {
+  border-style: solid;
+  border-color: red;
+  padding-right: 20px;
+  padding-left: 20px;
+}
+[%- END %]
+</style>
+[%# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -%]
+<h2>New hosts</h2>
+<p>
+[% IF hosts.size > 0 -%]
+Welcome to our new host[%- hosts.size > 1 ? 's' : '' -%]: <br />
+[%- count = 0 %]
+[%# List the new hosts. If a name contains a comma quote it.                  -%]
+[%- FOREACH row IN hosts %]
+    [%- count = count + 1 %]
+    [%- hostname = (row.host.search(',') ? row.host.replace('^(.*)$','"$1"') : row.host) %]
+    <a href="[% correspondents %]/[% pad4(row.hostid) %].html" target="_blank">[% hostname %]</a>
+    [%- count < hosts.size ? ', ' : '.' %]
+[%- END %]
+[% ELSE -%]
+There were no new hosts this month.
+[% END -%]
+</p>
+
+<h2>Last Month's Shows</h2>
+[%# The id 't01' is in the HPR CSS but might give trouble on the IA -%]
+<table id="t01">
+<tr>
+<th>Id</th>
+<th>Day</th>
+<th>Date</th>
+<th>Title</th>
+<th>Host</th>
+</tr>
+[%- FOREACH row IN shows %]
+<tr>
+<td><strong><a href="https://hackerpublicradio.org/eps/hpr[% pad4(row.eps_id) %]/index.html" target="_blank">[% row.eps_id %]</a></strong></td>
+<td>[% date.format(row.date,'%a') %]</td>
+<td class="shrink">[% date.format(row.date,'%Y-%m-%d') %]</td>
+<td><a href="https://hackerpublicradio.org/eps/hpr[% pad4(row.eps_id) %]/index.html" target="_blank">[% row.title %]</a></td>
+<td><a href="[% correspondents %]/[% pad4(row.ho_hostid) %].html" target="_blank">[% row.ho_host %]</a></td>
+</tr>
+[%- END %]
+</table>
+
+[%# ---------------------------------------------------------------------------------------- -%]
+[%# Skip comments if told to by the caller -%]
+[%- IF skip_comments == 0 -%]
+[%# Handle any missed comments if mark_comments is true -%]
+[%- IF (mark_comments == 1) AND (missed_count > 0) -%]
+<br/><div id="highlight">
+<h2>Missed comment[%- missed_comments.size > 1 ? 's' : '' -%] last month</h2>
+<p><b>Note to Volunteers</b>: These are comments for shows last month that were not read in the last show because they arrived on or after the recording started. This section will be removed before these notes are released.</p>
+<ul>
+[%- FOREACH comment IN missed_comments -%]
+<li><strong><a href="[% comment.identifier_url %]#comments" target="_blank">hpr[% pad4(comment.episode) %]</a></strong>
+([% comment.date %]) "<em>[% comment.title %]</em>" by <a href="[% correspondents %]/[% pad4(comment.hostid) %].html" target="_blank">[% comment.host %]</a>.<br/>
+<small>Summary: "<em>[% comment.summary %]</em>"</small><br/>
+From: [% comment.comment_author_name %] on [% date.format(comment.comment_timestamp_ut,'%Y-%m-%d','UTC') -%]:
+[%- IF comment.comment_title.length > 0 %]
+"[% comment.comment_title %]"
+[%- ELSE -%]
+"[no title]"
+[%- END -%]
+<br/><hr class="thin">[% comment.comment_text FILTER html_line_break %]
+</li><br/>
+[%- END -%]
+</ul></div>
+[%- END -%]
+[%# ---------------------------------------------------------------------------------------- -%]
+<h2>Comments this month</h2>
+
+[% IF comment_count > 0 -%]
+[%- IF (mark_comments == 1) AND (ignore_count > 0) -%]
+<p id="ignore"><b>Note to Volunteers</b>: Comments marked in green were read in the last
+Community News show and should be ignored in this one.</p>
+[%- END -%]
+<p>These are comments which have been made during the past month, either to shows released during the month or to past shows.
+There [%- comment_count == 1 ? "is $comment_count comment" : "are $comment_count comments" -%] in total.</p>
+[% IF past_count > 0 -%]
+<h3>Past shows</h3>
+<p>There [% past_count == 1 ? "is $past_count comment" : "are $past_count comments" %] on
+[% past.size %] previous [% past.size == 1 ? "show" : "shows" %]:</p>
+<ul>
+[%# Loop through by episode then by comment relating to that episode -%]
+[%-    FOREACH ep IN past.keys.nsort -%]
+[%-       arr = past.$ep -%]
+<li><strong><a href="[% arr.0.identifier_url %]#comments" target="_blank">hpr[% pad4(arr.0.episode) %]</a></strong>
+([%       arr.0.date %]) "<em>[% arr.0.title %]</em>"
+by <a href="[% correspondents %]/[% pad4(arr.0.hostid) %].html" target="_blank">[% arr.0.host %]</a>.<br/>
+[%-       IF mark_comments == 1 || ctext == 1 -%]
+<small>Summary: "<em>[% arr.0.summary %]</em>"</small></li>
+[%-       END %]
+<li style="list-style: none; display: inline">
+<ul>
+[%-       FOREACH row IN arr -%]
+[%#          IF mark_comments == 1 && ((row.comment_timestamp_ut <= last_recording) && (arr.0.date.substr(0,7) == last_month)) -%]
+[%#          IF mark_comments == 1 && ((row.comment_released_ut <= last_recording) && (arr.0.date.substr(0,7) == last_month)) -%]
+[%-          IF mark_comments == 1 && row.ignore == 1 -%]
+<li id="ignore">
+[%-          ELSE %]
+<li>
+[%-          END %]
+<a href="[% row.identifier_url %]#comment_[% row.comment_id %]" target="_blank">Comment [% row.comment_number %]</a>:
+[%        row.comment_author_name -%] on [% date.format(row.comment_timestamp_ut,'%Y-%m-%d','UTC') -%]:
+[%-          IF row.comment_title.length > 0 %]
+"[%             row.comment_title %]"
+[%-          ELSE -%]
+"[no title]"
+[%-          END -%]
+[%# Add the comment body in too if ctext is true -%]
+[%-          IF ctext == 1 %]
+<br/><hr class="thin">[% row.comment_text FILTER html_line_break %]
+</li><br/>
+[%-          ELSE -%]
+</li>
+[%-          END -%]
+[%-       END -%]
+</ul><br/>
+</li>
+[%-    END -%]
+</ul>
+[%- END %]
+[%# ---------------------------------------------------------------------------------------- -%]
+[% cc = (comment_count - past_count) -%]
+[% IF cc > 0 -%]
+<h3>This month's shows</h3>
+<p>There [% cc == 1 ? "is $cc comment" : "are $cc comments" %] on [% current.size %] of this month's shows:</p>
+<ul>
+[%- FOREACH ep IN current.keys.nsort -%]
+[%- arr = current.$ep -%]
+<li><strong><a href="[% arr.0.identifier_url %]#comments" target="_blank">hpr[% pad4(arr.0.episode) %]</a></strong>
+([% arr.0.date %]) "<em>[% arr.0.title %]</em>"
+by <a href="[% correspondents %]/[% pad4(arr.0.hostid) %].html" target="_blank">[% arr.0.host %]</a>.</li>
+<li style="list-style: none; display: inline">
+<ul>
+[%- FOREACH row IN arr -%]
+<li><a href="[% row.identifier_url %]#comment_[% row.comment_id %]" target="_blank">Comment [% row.comment_number %]</a>:
+[% row.comment_author_name -%] on [% date.format(row.comment_timestamp_ut,'%Y-%m-%d','UTC') -%]:
+[%- IF row.comment_title.length > 0 %]
+"[% row.comment_title %]"
+[%- ELSE -%]
+"[no title]"
+[%- END -%]
+</li>
+[%- END -%]
+</ul><br/>
+</li>
+[%- END -%]
+</ul>
+[%- END %]
+[%- ELSE %]
+There were no comments this month.
+[%- END %]
+[%- END %]
+
+[%# ---------------------------------------------------------------------------------------- -%]
+[%- IF mailnotes == 1 -%]
+<h2>Mailing List discussions</h2>
+<p>
+Policy decisions surrounding HPR are taken by the community as a whole. This
+discussion takes place on the <a href="[% mailinglist %]" target="_blank">Mailing List</a>
+which is open to all HPR listeners and contributors. The discussions are open
+and available on the HPR server under <a href="[% mailbase %]">Mailman</a>.
+</p>
+<p>The threaded discussions this month can be found here:</p>
+<a href="[% mailthreads %]" target="_blank">[% mailthreads %]</a>
+[%- END %]
+
+[%# ---------------------------------------------------------------------------------------- -%]
+<h2>Events Calendar</h2>
+<p>With the kind permission of <strong>LWN.net</strong> we are linking to
+<a href="https://lwn.net/Calendar/" target="_blank">The LWN.net Community Calendar</a>.</p>
+<p>Quoting the site:</p>
+<blockquote>This is the LWN.net community event calendar, where we track
+events of interest to people using and developing Linux and free software.
+Clicking on individual events will take you to the appropriate web
+page.</blockquote>
+[%# ---------------------------------------------------------------------------------------- -%]
+[%#
+  # vim: syntax=tt2:ts=8:sw=4:ai:et:tw=78:fo=tcrqn21
+-%]

Community_News/shownotes_container.tpl

@@ -0,0 +1,257 @@
+[%# /home/cendjm/HPR/Community_News/shownotes_container.tpl 2024-06-22 -%]
+[%# Container to display Community News shownotes as an HTML page -%]
+[%- USE date -%]
+[% DEFAULT shownotes = ""
+   episode = ""
+   month_year = ""
+-%]
+<!DOCTYPE HTML>
+<html lang="en">
+<head>
+  <title>Hacker Public Radio ~ The Technology Community Podcast</title>  <base href="https://hackerpublicradio.org/">  <meta charset="utf-8" />
+  <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
+  <meta http-equiv="last-modified" content="Sat, 22 Jun 2024 16:04:21 +0000">
+  <meta name="keywords" content="Technology, Tech News, Education, Training" />
+  <meta name="description" content="Hacker Public Radio is a podcast that releases shows every weekday Monday through Friday. Our shows are produced by the community (you) and can be on any topic that is of interest to hackers and hobbyists." />
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <!-- Internal CSS -->
+  <style type="text/css">
+  article, aside, dialog, figure, footer, header, hgroup, menu, nav, section {
+          display: block;
+  }
+  #list1, #list2, #list3 {
+          display:none;
+  }
+  </style>
+  <link rel="shortcut icon" href="https://hackerpublicradio.org/hpr.ico" >
+  <link rel="alternate" type="application/rss+xml" title="Hacker Public Radio Ogg Vorbis RSS" href="./hpr_ogg_rss.php" />
+  <link rel="alternate" type="application/rss+xml" title="Hacker Public Radio Speex RSS" href="./hpr_spx_rss.php" />
+  <link rel="alternate" type="application/rss+xml" title="Hacker Public Radio MP3 RSS" href="./hpr_mp3_rss.php" />
+  <link rel="alternate" type="application/rss+xml" title="Hacker Public Radio Comments RSS" href="./comments.rss" />
+  <link rel="license" title="CC BY-SA 4.0"  href="https://creativecommons.org/licenses/by-sa/4.0/" />
+  <link href="./css/hpr.css" rel="stylesheet" />
+  <!--[if IE]>
+  <link rel="stylesheet" href="./css/hpr.css" media="screen" type="text/css" />
+  <script src="/JavaScript/html5.js"></script>
+  <![endif]-->
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.5, user-scalable=yes"/>
+</head>
+
+<body id="give">
+<div id="container" class="shadow">
+<header>
+  <a href="./"><img id="hprlogo" src="./images/hpr_logo.png" alt="hprlogo"></a>
+  <div id="hpr_banner">
+    <p id="accessible_menu">
+      <a href="./sitemap.html">Site Map</a>
+      - <a href="#maincontent">skip to main content</a>
+      </p>
+      <h1 id="sitename">
+        <a href="./correspondents/index.html">H</a>acker
+        <a href="./comments_viewer.html">P</a>ublic
+        <a href="./syndication.html">R</a>adio
+      </h1>
+    <h2>Your ideas, projects, opinions - podcasted.</h2>
+    <h3>New episodes every weekday Monday through Friday.<br />
+    <em><small>Temporary version of the Community News notes for hosts to use when recording<br />
+    Updated on [% date.format(date.now,'%Y-%m-%d %H:%M:%S') %]</small></em></h3>
+
+  </div>
+  <hr />
+
+  <nav class="menu" role="navigation">		<ul>
+			<li><a href="https://hub.hackerpublicradio.org/"><strong>⇧Upload⇧</strong></a></li>
+			<li><a href="./index.html"><strong>Home</strong></a></li>
+			<li><a href="./syndication.html"><strong>Get Shows »</strong></a></li>
+			<li><a href="./eps/index.html">Full Episode Guide</a></li>
+			<li><a href="./series/index.html">In-Depth Series</a></li>
+			<li><a href="./download.html">Download Options</a></li>
+		</ul>
+  </nav>
+</header>
+
+<main id="maincontent">
+
+
+
+<article>
+	<header>
+		<h1>hpr[% episode %] :: HPR Community News for [% month_year %]</h1>
+		<h3>HPR Volunteers talk about shows released and comments posted in [% month_year %]</h3>
+		<p class="meta"><small><a href="./eps/hpr0001/index.html" rel="first">&lt;&lt; First</a>,    <a href="./eps/hpr4190/index.html" rel="previous">&lt; Previous</a>,    Next <span>&gt;</span>    <a href="./eps/hpr4145/index.html" rel="last">Latest &gt;&gt;</a></small>		</p>
+<p><a href="./correspondents/0159.html"><img src="./images/hosts/159.png" height="80" width="80" alt="Thumbnail of HPR Volunteers"  /></a><br>Hosted by <a href="./correspondents/0159.html">HPR Volunteers</a> on <span>2024-09-02</span> is flagged as <span>Explicit</span> and is released under a <span>CC-BY-SA license</span>. <br>    <span><label>Tags:</label> <em>        <a href="./tags.html#community news">Community News</a>.</em>
+    </span>
+<label>Comments: </label><a href="./eps/hpr[% episode %]/index.html#comments" aria-label="Comments for hpr[% episode %]">(Be the first)</a>. <br>
+The show is available on the Internet Archive at: <a href="https://archive.org/details/hpr[% episode %]">https://archive.org/details/hpr[% episode %]</a><p> Listen in <a href="https://archive.org/download/hpr[% episode %]/hpr[% episode %].ogg" aria-label="Download hpr[% episode %] as">ogg</a>,
+<a href="https://archive.org/download/hpr[% episode %]/hpr[% episode %].spx" aria-label="Download hpr[% episode %] as">spx</a>,
+or <a href="https://archive.org/download/hpr[% episode %]/hpr[% episode %].mp3" aria-label="Download hpr[% episode %] as">mp3</a> format. Play now:<br>
+	<audio controls preload="none">
+	<source src="https://archive.org/download/hpr[% episode %]/hpr[% episode %].ogg" type="audio/ogg" >
+		<source src="https://archive.org/download/hpr[% episode %]/hpr[% episode %].mp3" type="audio/mpeg" >
+	</audio><br>
+	Duration: 00:00:00</p></p>
+<h3>	<label>Part of the series:</label> <a href="./series/0047.html">HPR Community News</a>.</h3>
+<p><em>A monthly look at what has been going on in the HPR community. This is a regular show scheduled for the first Monday of the month.</em></p>
+	</header>
+	<div>
+	[% INCLUDE $shownotes -%]
+	</div>
+<footer><h2>Show Transcript</h2>
+<p>Automatically generated using <a href="https://github.com/openai/whisper">whisper</a>
+<pre><code>whisper --model tiny --language en hpr[% episode %].wav</code></pre></p>
+<p>
+You can save these subtitle files to the same location as the HPR Episode, and they will automatically show in players like <a href="https://mpv.io/">mpv</a>, <a href="https://www.videolan.org/vlc/">vlc</a>. Some players allow you to specify the subtitle file location.
+</p>
+<ul>
+	<li>Text: <a href="https://archive.org/download/hpr[% episode %]/hpr[% episode %]/hpr[% episode %].txt">hpr[% episode %].txt</a></li>
+	<li><a href="https://en.wikipedia.org/wiki/WebVTT">WebVTT</a>: <a href="https://archive.org/download/hpr[% episode %]/hpr[% episode %]/hpr[% episode %].vtt">hpr[% episode %].vtt</a></li>
+	<li><a href="https://en.wikipedia.org/wiki/SubRip">SubRip</a>: <a href="https://archive.org/download/hpr[% episode %]/hpr[% episode %]/hpr[% episode %].srt">hpr[% episode %].srt</a></li>
+</ul><p><small><a href="./eps/hpr0001/index.html" rel="first">&lt;&lt; First</a>,    <a href="./eps/hpr4190/index.html" rel="previous">&lt; Previous</a>,    Next <span>&gt;</span>    <a href="./eps/hpr4145/index.html" rel="last">Latest &gt;&gt;</a></small></p>
+    </footer></article><hr />
+<h1>Comments</h1>
+<p id="comments">
+Subscribe to the comments <a href="./comments.rss">RSS</a> feed.
+</p>
+        <h2>Leave Comment</h2>
+        <p>
+        <strong>Note to Verbose Commenters</strong><br />
+        If you can't fit everything you want to say in the comment below then you really should <a href="https://hackerpublicradio.org/about.html#so_you_want_to_record_a_podcast">record</a> a response show instead.
+        </p>
+        <p>
+        <strong>Note to Spammers</strong><br />
+		All comments are moderated. All links are checked by humans. We strip out all html. Feel free to <a href="https://hackerpublicradio.org/about.html#so_you_want_to_record_a_podcast">record</a> a show about yourself, or your industry, or any other topic we may find interesting. <em>We also check shows for spam :)</em>.
+        </p>
+        <form method="POST" action="https://hub.hackerpublicradio.org/comment_confirm.php">
+        <fieldset>
+        <legend>Provide feedback</legend>
+        <table>
+        <tr>
+            <td>Your Name/Handle:</td>
+            <td><input required type="text" name="comment_author_name" size="40" maxlength="40" placeholder="Enter your name" ></td>
+        </tr>
+        <tr>
+            <td>Title:</td>
+            <td><input required type="text" name="comment_title" size="50" maxlength="100" placeholder="What is your comment about?"></td>
+        </tr>
+        <tr>
+            <td>Comment:</td>
+            <td><textarea required name="comment_text" maxlength="2000" rows="10" cols="50" placeholder="Place the comment here."></textarea></td>
+        </tr>
+        <tr>
+            <td>Anti Spam Question:</td>
+            <td>
+            What does the letter <strong>P</strong> in <em>HPR</em> stand for? <br />
+            <input required type="text" name="anti_spam_question" size="50" maxlength="100" placeholder="Type out what the P in HPR stands for."></td>
+	</tr><!-- . -->
+	<tr>
+	<td>Are you a spammer?</td>
+	<td>
+	<input required checked="checked" type="radio" name="spammer" id="spammer_yes" value="Yes">
+	<label for="spammer_yes">Yes</label>
+	<input required type="radio" name="spammer" id="spammer_no" value="No">
+	<label for="spammer_no">No</label>
+	</td>
+	</tr>
+<!-- . -->
+	<tr>
+	<td>What is the <strong>HOST_ID</strong> for the host of this show?</td>
+	<td>
+	<input required type="text" name="hostid" size="20" maxlength="5" placeholder="Type the host number"></td>
+	<td>
+<!-- . -->
+	<tr>
+	<td>What does HPR mean to you?</td>
+	<td><textarea required name="justification" maxlength="200" rows="4" cols="50" placeholder="Convince us you are part of the community."></textarea></td>
+	</tr>	<tr><td>
+        <input type="hidden" name="eps_id" value="[% episode %]">
+	</td></tr>
+        </table>
+        <input type="submit" value="Next">
+        </fieldset>
+        </form>
+</main>
+
+<footer id="footer_page">
+  <h1 class="thick_bar"><span style="padding-left: 1em;">More Information...</span></h1>
+  <div id="more_info">
+    <nav class="column">
+      <h2>Ancestry</h2>
+      <ul>
+        <li><a href="http://audio.textfiles.com/shows/radiofreekamerica/">Radio Freek America</a></li>
+        <li><a href="http://audio.textfiles.com/shows/binrev/">BinRev Radio</a></li>
+        <li><a href="http://audio.textfiles.com/shows/infonomicon/">Infonomicon</a></li>
+        <li><a href="http://audio.textfiles.com/shows/twat/">Today With a Techie</a></li>
+      </ul>
+    </nav>
+    <nav class="column">
+      <h2>Social</h2>
+      <ul>
+        <li><a href="https://hackerpublicradio.org/maillist" >Mailing list</a></li>
+        <li><a href="https://botsin.space/@hpr" >Mastodon</a></li>
+        <li><a href="https://matrix.to/#/#hpr:matrix.org" >Matrix</a></li>
+        <li><a href="mumble://chatter.skyehaven.net:64738/Hacker%20Public%20Radio?version=1.2.0" >Mumble</a></li>
+        <li><a href="https://web.libera.chat/gamja/?channels=oggcastplanet" target="_blank">#oggcastplanet</a></li>
+        <li><a href="https://t.me/+6fEhQrf5IEc4ZGU8">Telegram</a></li>
+        <li><a href="https://twitter.com/HPR">Twitter.com</a></li>
+        <li><a href="https://www.facebook.com/HenryPartickReilly" target="_blank">Facebook</a></li>
+        <li><a href="https://www.linkedin.com/company/hackerpublicradio/" target="_blank">Linked-In</a></li>
+      </ul>
+    </nav>
+    <nav class="column">
+      <h2>Unaffiliates</h2>
+      <ul>
+        <li><a href="https://archive.org/details/hackerpublicradio">Archive.org</a></li>
+        <li><a href="https://music.amazon.fr/podcasts/9d9e6211-ff78-4501-93b6-6a9e560c4dbd/hacker-public-radio">Amazon Music</a></li>
+        <li><a href="https://podcasts.google.com/feed/aHR0cDovL2hhY2tlcnB1YmxpY3JhZGlvLm9yZy9ocHJfcnNzLnBocA">Google Podcasts</a></li>
+        <li><a href="https://www.iheart.com/podcast/256-hacker-public-radio-30994513/" target="_blank">iHeart Radio</a></li>
+        <li><a href="https://podcasts.apple.com/us/podcast/hacker-public-radio/id281699640">iTunes</a></li>
+        <li><a href="https://www.listennotes.com/de/podcasts/hacker-public-radio-hacker-public-radio-mNH-jsI7LcJ/">Listen Notes</a></li>
+        <li><a href="https://www.mixcloud.com/hackerpublicradio/">MixCloud</a></li>
+        <li><a href="https://player.fm/series/hacker-public-radio">PlayerFM</a></li>
+        <li><a href="https://www.podchaser.com/podcasts/hacker-public-radio-76781">Podchaser</a></li>
+        <li><a href="https://nl.radio.net/podcast/hacker-public-radio">Radio.net</a></li>
+        <li><a href="https://open.spotify.com/show/7e2hYcnHj9vKgUzsIOf4r3">Spotify</a></li>
+        <li><a href="https://toppodcast.com/podcast_feeds/hacker-public-radio/">Top Podcasts</a></li>
+      </ul>
+    </nav>
+    <nav class="column">
+      <h2>Commons</h2>
+      <ul>
+        <li><a href="https://freeculturepodcasts.org/">Free Culture Podcasts</a></li>
+        <li><a href="https://archive.org/details/hackerpublicradio">archive.org</a></li>
+        <li><a href="https://repo.anhonesthost.net/explore/repos" >HPR Source Code</a></li>
+        <li><a href="https://cchits.net/">cchits.net</a></li>
+        <li><a href="https://freesound.org/">freesound.org</a></li>
+        <li><a href="https://librivox.org/">librivox.org</a></li>
+        <li><a href="https://openclipart.org/">openclipart.org</a></li>
+        <li><a href="https://openfontlibrary.org/">openfontlibrary.org</a></li>
+        <li><a href="https://www.openrouteservice.org/">openrouteservice.org/</a></li>
+        <li><a href="https://pixabay.com/">pixabay.com/</a></li>
+      </ul>
+    </nav>
+    <nav class="column">
+      <h2>Patrons</h2>
+      <ul>
+        <li><a href="https://anhonesthost.com/hosting/shared-hosting">AnHonestHost.com</a></li>
+        <li><a href="https://archive.org/donate/">Archive.org</a></li>
+        <li><a href="https://rsync.net/">rsync.net</a></li>
+      </ul>
+    </nav>
+  </div><!-- more_info -->
+  <h1 class="thick_bar"><span style="padding-left: 1em;">Copyright Information</span></h1>
+  <div id="copyright">
+    <p>
+    Unless otherwise stated, our shows are released under a <a rel="license" href="https://creativecommons.org/licenses/by-sa/4.0/">
+    Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)</a> license.</p>
+    <p>
+    The <span property="dct:title">HPR Website Design</span> is released to the <a rel="license" href="https://creativecommons.org/publicdomain/mark/1.0/">Public Domain</a>.
+    </p>
+    <hr />
+  </div><!-- copyright -->
+  <hr />
+</footer>
+</div>
+<!-- shadow -->
+[%#
+vim: syntax=html:ts=8:sw=4:ai:et:tw=78:fo=tcqn:fdm=marker:com+=fb\:-
+-%]

Containerfile

@@ -0,0 +1,62 @@
+FROM perl:5.40.1 As base
+
+LABEL author="sgoti" \
+      email="lyunpaw@gmail.com" \
+      project="Hacker Public Radio" \
+      forge="https://repo.anhonesthost.net/HPR"
+
+ARG unprivilegedUser="janitor"
+
+RUN apt update && apt upgrade --yes;
+
+RUN apt install --no-install-recommends sqlite3 git --yes \
+    && rm --recursive --force /var/lib/apt/lists/*;
+
+RUN mkdir --verbose --parent /opt/hpr /tmp/hpr;
+
+RUN groupadd --system ${unprivilegedUser} \
+    && useradd --system --no-log-init --gid ${unprivilegedUser} ${unprivilegedUser};
+
+RUN chown --recursive ${unprivilegedUser}:${unprivilegedUser} /opt/hpr \
+    && chown --recursive ${unprivilegedUser}:${unprivilegedUser} /tmp/hpr;
+
+#Bill of particulars.
+
+##Meta::CPAN (Comprehensive Perl Archive Network)
+RUN cpanm Config::General \
+    DBD::SQLite \
+    DBI \
+    Data::Dumper \
+    Date::Calc \
+    Date::Parse \
+    DateTime \
+    DateTime::Duration \
+    DateTime::Format::Duration \
+    DateTime::TimeZone \
+    HTML::Entities \
+    JSON \
+    Template \
+    Template::Filters;
+
+##Included perl core modules (standard library).
+##Carp
+##Cwd
+##Getopt::Long
+##Pod::Usage
+##File::Copy
+
+USER ${unprivilegedUser}
+
+WORKDIR /opt/hpr
+
+RUN git clone https://repo.anhonesthost.net/HPR/hpr-tools.git \
+    && git clone https://repo.anhonesthost.net/HPR/hpr_hub.git \
+    && git clone https://repo.anhonesthost.net/HPR/hpr_generator.git \
+    && git clone https://repo.anhonesthost.net/HPR/hpr_documentation.git;
+
+WORKDIR /opt/hpr/hpr-tools/Community_News/
+RUN ln --symbolic /opt/hpr/hpr_generator/utils/mysql2sqlite /opt/hpr/hpr-tools/Community_News/mysql2sqlite;
+RUN ./collect_HPR_database;
+
+CMD bash;
+

Database/edit_episode

@@ -14,9 +14,9 @@
 #         BUGS: ---
 #        NOTES: Had to revert to MySQL due to a problem with DBD::MariaDB
 #       AUTHOR: Dave Morriss (djm), Dave.Morriss@gmail.com
-#      VERSION: 0.1.3
+#      VERSION: 0.1.4
 #      CREATED: 2015-06-17 23:17:50
-#     REVISION: 2022-02-16 20:07:45
+#     REVISION: 2024-07-20 11:21:19
 #
 #===============================================================================
 
@@ -39,7 +39,7 @@ use Data::Dumper;
 #
 # Version number (manually incremented)
 #
-our $VERSION = '0.1.3';
+our $VERSION = '0.1.4';
 
 #
 # Script and directory names
@@ -301,11 +301,11 @@ sub change_episode {
             #
             if ($rv) {
                 my $ccount = scalar( keys(%changes) );
-                printf "Updated database (%d %s to the eps row)\n",
+                printf "Updated database (%d %s to the eps row for show %s)\n",
-                    $ccount, _plural( 'change', $ccount );
+                    $ccount, _plural( 'change', $ccount ), $show;
             }
             else {
-                print "Episode not updated due to error\n";
+                print "Episode $show not updated due to error\n";
             }
 
         }
@@ -603,7 +603,7 @@ edit_episode - edit one or more fields in the database for a given HPR show
 
 =head1 VERSION
 
-This documentation refers to edit_episode version 0.1.3
+This documentation refers to edit_episode version 0.1.4
 
 
 =head1 USAGE

Database/hosts_list.tpl

@@ -0,0 +1,39 @@
+[%# ==========================================================================
+This is the TT2 file for making a list of hosts contributing to HPR in the
+    current year which is run in conjunction with 'query2tt2'. It's invoked
+    thus:
+        year="2022" # or whatever
+        ./query2tt2 -query=$HOME/HPR/Community_News/hosts_showcount.sql \
+            -conf=$HOME/HPR/.hpr_livedb.cfg \
+            -dbargs "${year}-01-01" -dbargs "${year}-12-31" -def year=${year} \
+            -template=$HOME/HPR/Community_News/hosts_list.tpl \
+            > $HOME/HPR/Community_News/hosts_showcount_${year}.html
+
+    [We can't use the planned pure TT2 version since Template::Plugin::DBI
+    can't run over the SSH tunnel.]
+
+2023-10-30 The correspondent URL has changed with the static site, and needs
+the hostid to be zero-padded.
+========================================================================== -%]
+[%- USE date -%]
+[%- DEFAULT
+    year = date.format(date.now,'%Y','UTC')
+-%]
+<h3>Thanks to all [% result.size %] HPR contributors in [% year %]!</h3>
+
+[% limit = 8 -%]
+[% count = 0 -%]
+<p><ul><li>
+[% FOREACH h = result -%]
+<a href="https://hackerpublicradio.org/correspondents/[% h.hostid %].html">[% h.hostname %]</a>
+[%- IF loop.count mod limit == 0 || loop.count == result.size -%].[% ELSE %],[% END %]
+[% count = count + 1 -%]
+[% IF count == limit -%]
+[% count = 0 -%]
+</li><li>
+[% END -%]
+[% END -%]
+</li></ul></p>
+[%#
+  # vim: syntax=tt2:ts=8:sw=4:ai:et:tw=78:fo=tcrqn21:fdm=marker
+-%]

Database/hosts_showcount.sqlite.sql

@@ -0,0 +1,15 @@
+--
+-- Query for use with 'query2tt2' to generate a list of hosts who contributed
+-- shows in a particular year. Designed to be used with the 'hosts_list.tpl'
+-- template.
+-- The two '?' placeholders in the query are to be filled with 'YYYY-01-01'
+-- for the start of the year and 'YYYY-12-31'. The values can be passed using
+-- the '-dbargs' option to 'query2tt2'.
+--
+SELECT DISTINCT
+    printf('%04d',h.hostid) AS hostid, h.host AS hostname
+FROM eps e
+JOIN hosts h ON e.hostid = h.hostid
+WHERE e.date BETWEEN ? AND ?
+AND title != 'Reserved'
+ORDER BY h.host

Database/query2csv

@@ -3,30 +3,41 @@
 #
 #         FILE: query2csv
 #
-#        USAGE: ./query2csv query
+#        USAGE: ./query2csv [-help] [-documentation|-man] [-debug=N]
+#               [-config=FILE] [-query=FILE]
+#               [-dbarg=ARG1 [-dbarg=ARG2] ...] [-[no-]header] [QUERY]
 #
-#  DESCRIPTION: Runs a query given as the only argument. Caution is needed
+#  DESCRIPTION: Runs a query given as the only argument, or provided in
-#               since *any* query will be run. The result of the query is
+#               a file. Caution is needed since *any* query will be run. The
-#               output in CSV form on STDOUT. The CSV is always quoted to
+#               result of the query is output in CSV form on STDOUT or to
-#               cater for the more simplistic consumers.
+#               a file. The -header option allows a CSV header of column names
+#               to be added (default not added). If the query contains '?'
+#               placeholders they can be filled with -dbarg=ARG options.
 #
 #      OPTIONS: ---
 # REQUIREMENTS: ---
 #         BUGS: ---
-#        NOTES: Had to revert to MySQL because of a problem with DBD::MariaDB
+#        NOTES: ---
 #       AUTHOR: Dave Morriss (djm), Dave.Morriss@gmail.com
-#      VERSION: 0.0.2
+#      VERSION: 0.0.5
 #      CREATED: 2015-07-11 15:53:01
-#     REVISION: 2022-02-16 23:17:16
+#     REVISION: 2025-05-25 18:26:13
 #
 #===============================================================================
 
-use 5.010;
+use v5.40;
-use strict;
-use warnings;
 use utf8;
+use open ':std', ':encoding(UTF-8)';
+
+use feature qw{ say try };
+
+use Cwd qw( getcwd abs_path );                 # Detecting where the script lives
+
+use Getopt::Long;
+use Pod::Usage;
 
 use Config::General;
+use File::Slurper qw{ read_text };
 use Text::CSV_XS;
 use DBI;
 
@@ -35,14 +46,12 @@ use Data::Dumper;
 #
 # Version number (manually incremented)
 #
-our $VERSION = '0.0.2';
+our $VERSION = '0.0.5';
 
 #
-# Script and directory names
+# Script name
 #
 ( my $PROG = $0 ) =~ s|.*/||mx;
-( my $DIR  = $0 ) =~ s|/?[^/]*$||mx;
-$DIR = '.' unless $DIR;
 
 #-------------------------------------------------------------------------------
 # Declarations
@@ -50,58 +59,147 @@ $DIR = '.' unless $DIR;
 #
 # Constants and other declarations
 #
-my $basedir    = "$ENV{HOME}/HPR/Database";
+#
-my $configfile = "$basedir/.hpr_livedb.cfg";
+# Make a variable to hold the working directory where the script is located
+#
+( my $basedir = abs_path($0) ) =~ s|/?[^/]*$||mx;
+
+my $configfile = "$basedir/.hpr_sqlite.cfg";
 
 my ( $dbh, $sth1, $aref1 );
-my ( $query, $csv );
+my ( $query, @names, $csv );
-
+my ( $pcount, $acount );
-#
-# Enable Unicode mode
-#
-binmode STDOUT, ":encoding(UTF-8)";
-binmode STDERR, ":encoding(UTF-8)";
-
-#
-# Load database configuration data
-#
-my $conf = Config::General->new(
-    -ConfigFile      => $configfile,
-    -InterPolateVars => 1,
-    -ExtendedAccess  => 1
-);
-my %config = $conf->getall();
 
 #-------------------------------------------------------------------------------
 # Options and arguments
 #-------------------------------------------------------------------------------
-$query = shift;
+my %options;
-die "Usage: $PROG query\n" unless $query;
+Options( \%options );
+
+#
+# Default help
+#
+pod2usage( -msg => "Version $VERSION\n", -exitval => 1, -verbose => 0 )
+    if ( $options{'help'} );
+
+#
+# Full documentation if requested with -doc
+#
+pod2usage(
+    -msg => "$PROG version $VERSION\n",
+    -verbose => 2,
+    -exitval => 1,
+    -noperldoc => 0,
+) if ( $options{'documentation'} );
+
+
+#
+# Collect options
+#
+my $DEBUG = ( $options{'debug'} ? $options{'debug'} : 0 );
+
+my $cfgfile
+    = ( defined( $options{config} ) ? $options{config} : $configfile );
+
+my $queryfile = $options{query};
+
+my $header = ( defined( $options{header} ) ? $options{header} : 0 );
+
+my $outfile = $options{output};
+_debug( $DEBUG >= 3, '$outfile: ' . $outfile ) if ($outfile);
+
+my @dbargs = _dbargs( \%options );
+_debug( $DEBUG >= 3, '@dbargs: ' . join( ',', @dbargs ) );
+
+#-------------------------------------------------------------------------------
+# Option checks and defaults
+#-------------------------------------------------------------------------------
+die "Unable to find configuration file $cfgfile\n" unless ( -e $cfgfile );
+_debug( $DEBUG >= 3, '$cfgfile: ' . $cfgfile );
+
+#
+# Query is an argument string or is in a file
+#
+if ($queryfile) {
+    die "Unable to find query file $queryfile\n" unless ( -e $queryfile );
+    $query = read_text($queryfile);
+}
+else {
+    $query = shift;
+    pod2usage(
+        -msg     => "Please specify a SQL query\n",
+        -exitval => 1,
+        -verbose => 0
+        )
+        unless $query;
+}
+_debug( $DEBUG >= 3, '$query: ' . Dumper(\$query) );
+
+#
+# Strip SQL comments
+#
+$query = strip_sql_comments($query);
+
+#
+# Count placeholders in the query and the arguments provided. First remove all
+# comments which may contain '?' characters, then count any that are left.
+#
+#$query = join("\n", grep {!/^--/} split( "\n", $query ) );
+$pcount = grep {/\?/} split( '', $query );
+$acount = scalar(@dbargs);
+
+#
+# Check the placeholder and argument counts are the same
+#
+if ( $pcount ne $acount) {
+    say STDERR "Query placeholder vs argument mismatch";
+    say STDERR "Placeholders = $pcount, Arguments = $acount";
+    pod2usage(
+        -msg       => "Wrong number of DB arguments\n",
+        -exitvalue => 1,
+        -verbose   => 0
+    );
+}
+
+#-------------------------------------------------------------------------------
+# Open the output file (or STDOUT)
+#-------------------------------------------------------------------------------
+my $outfh;
+if ($outfile) {
+    open( $outfh, ">:encoding(UTF-8)", $outfile )
+        or die "Unable to open $outfile for writing: $!";
+}
+else {
+    open( $outfh, ">&", \*STDOUT )
+        or die "Unable to initialise for writing: $!";
+}
+
+#-------------------------------------------------------------------------------
+# Load database configuration data; allow environment variables
+#-------------------------------------------------------------------------------
+my $conf = Config::General->new(
+    -ConfigFile      => $cfgfile,
+    -InterPolateVars => 1,
+    -InterPolateEnv  => 1,
+    -ExtendedAccess  => 1
+);
+my %config = $conf->getall();
+
+#
+# Set defaults in case values have been omitted
+#
+$config{database}->{dbtype} //= 'SQLite';
+$config{database}->{host}   //= '127.0.0.1';
+$config{database}->{port}   //= 3306;
 
 #-------------------------------------------------------------------------------
 # Connect to the database
 #-------------------------------------------------------------------------------
-my $dbhost = $config{database}->{host} // '127.0.0.1';
+$dbh = db_connect(\%config);
-my $dbport = $config{database}->{port} // 3306;
-my $dbname = $config{database}->{name};
-my $dbuser = $config{database}->{user};
-my $dbpwd  = $config{database}->{password};
-#$dbh = DBI->connect( "DBI:MariaDB:host=$dbhost;port=$dbport;database=$dbname",
-#    $dbuser, $dbpwd, { AutoCommit => 1 } )
-#    or die $DBI::errstr;
 
-$dbh = DBI->connect( "dbi:mysql:host=$dbhost;port=$dbport;database=$dbname",
+#-------------------------------------------------------------------------------
-    $dbuser, $dbpwd, { AutoCommit => 1 } )
+# Set up and perform the query
-    or die $DBI::errstr;
+#-------------------------------------------------------------------------------
-
-#
-# Enable client-side UTF8
-#
-$dbh->{mysql_enable_utf8} = 1;
-
-#
-# Set up the query
-#
 $sth1 = $dbh->prepare($query) or die $DBI::errstr;
 if ( $dbh->err ) {
     warn $dbh->errstr;
@@ -110,9 +208,18 @@ if ( $dbh->err ) {
 #
 # Perform the query
 #
-$sth1->execute;
+try {
-if ( $dbh->err ) {
+    $sth1->execute(@dbargs);
+    if ( $dbh->err ) {
         warn $dbh->errstr;
+    }
+}
+catch ($e) {
+    #
+    # The 'die' above was triggered. The error is in $_.
+    #
+    say STDERR "Failed to execute query.";
+    exit 1;
 }
 
 #
@@ -122,16 +229,430 @@ $csv = Text::CSV_XS->new(
 #    { always_quote => 1 }
 );
 
+#
+# Collect field names  and output them at the start of the CSV if requested
+#
+if ($header) {
+    @names = @{$sth1->{NAME}};
+    _debug( $DEBUG >= 3, '@names: ' . Dumper(\@names) );
+
+    $csv->combine(@names);
+    say $outfh $csv->string();
+}
+
 #
 # Loop through the returned rows making and printing CSV. Each row is returned
 # as an arrayref to make it easy to join everything.
 #
 while ( $aref1 = $sth1->fetchrow_arrayref ) {
     $csv->combine(@$aref1);
-    print $csv->string(), "\n";
+    say $outfh $csv->string();
 }
+close($outfh);
 
 exit;
 
+#===  FUNCTION  ================================================================
+#         NAME: db_connect
+#      PURPOSE: Connects to a database using configuration settings including
+#               the database type
+#   PARAMETERS: $cfg            Config::General object
+#      RETURNS: Database handle
+#  DESCRIPTION: The 'dbtype' field in the configuration file gets a default,
+#               but the 'name' field is mandatory. Depending on the
+#               (lowercase) type name a different form of database connect is
+#               performed after '$dbtype' is set to the format the DBD driver
+#               needs. The database handle is returned (unless there's an
+#               error).
+#       THROWS: No exceptions
+#     COMMENTS: None
+#     SEE ALSO: N/A
+#===============================================================================
+sub db_connect {                                                            #{{{
+    my ($cfg) = @_;
+
+    my ( $dbh, $dbtype, $dbname );
+
+    $dbtype = $cfg->{database}->{dbtype};
+    $dbname = $cfg->{database}->{name};
+    die "Database name is mandatory\n" unless $dbname;
+
+    #
+    # Connect according to the database type
+    #
+    if ($dbtype =~ /sqlite/i) {
+        #
+        # The name for the SQLite driver is 'DBD:SQLite'
+        #
+        $dbtype = 'SQLite';
+        _debug( $DEBUG >= 3, '$dbtype: ' . $dbtype, '$dbname: ' . $dbname );
+
+        $dbh = DBI->connect( "DBI:$dbtype:dbname=$dbname",
+            "", "", { AutoCommit => 1, sqlite_unicode => 1,  } )
+            or die $DBI::errstr;
+    }
+    elsif ($dbtype =~ /mysql/i) {
+        #
+        # The name for the MySQL driver is 'DBD:mysql'
+        #
+        $dbtype = 'mysql';
+
+        my $dbhost = $cfg->{database}->{host};
+        my $dbport = $cfg->{database}->{port};
+        my $dbuser = $cfg->{database}->{user};
+        my $dbpwd  = $cfg->{database}->{password};
+
+        $dbh = DBI->connect( "DBI:$dbtype:host=$dbhost;port=$dbport;database=$dbname",
+            $dbuser, $dbpwd, { AutoCommit => 1 } )
+            or die $DBI::errstr;
+
+        #
+        # Enable client-side UTF8
+        #
+        $dbh->{mysql_enable_utf8} = 1;
+
+        # $dbh->trace('2|SQL');
+    }
+    elsif ($dbtype =~ /pg/i) {
+        #
+        # The name for the PostgreSQL driver is 'DBD:Pg'
+        #
+        $dbtype = 'Pg';
+
+        die "The PostgreSQL database type is not catered for yet.\n";
+    }
+    else {
+        die "Unknown database type: $dbtype\n";
+    }
+
+    return $dbh;
+}                                                                           #}}}
+
+#===  FUNCTION  ================================================================
+#         NAME: strip_sql_comments
+#      PURPOSE: Given a query as a scalar, strips all SQL comments
+#   PARAMETERS: $query          string containing a query
+#      RETURNS: Stripped string
+#  DESCRIPTION: Two types of comments might exist in the query: the C-style
+#               and the SQL style. The string is treated as a single string
+#               even though it's multi-line, and any C-style comments are
+#               removed. Then the string is treated as multi-line and each
+#               line is scanned for SQL comments (which end at the end of the
+#               line), and these are stripped. Blank lines are skipped too to
+#               compress the output a little.
+#       THROWS: No exceptions
+#     COMMENTS: None
+#     SEE ALSO: N/A
+#===============================================================================
+sub strip_sql_comments {                                                    #{{{
+    my ($query) = @_;
+
+    my $result;
+
+    #
+    # Strip C-style comments
+    #
+    $query =~ s/\/\*.*?\*\///sg;
+
+    #
+    # Strip SQL line-oriented comments
+    #
+    foreach my $line (split(/\n/,$query)) {
+        next if $line =~ /^\s*$/;
+        $line =~ s/--.*$//;
+        $result .= "$line\n";
+    }
+
+    return $result;
+}                                                                           #}}}
+
+#===  FUNCTION  ================================================================
+#         NAME: _debug
+#      PURPOSE: Prints debug reports
+#   PARAMETERS: $active         Boolean: 1 for print, 0 for no print
+#               @messages       Messages to print
+#      RETURNS: Nothing
+#  DESCRIPTION: Outputs messages if $active is true. It removes any trailing
+#               newlines and then adds one to each line so the caller doesn't
+#               have to bother. Prepends 'D> ' to each message to show it's
+#               a debug message.
+#       THROWS: No exceptions
+#     COMMENTS: None
+#     SEE ALSO: N/A
+#===============================================================================
+sub _debug {                                                                #{{{
+    my ( $active, @messages ) = @_;
+
+    if ($active) {
+        chomp(@messages);
+        say STDERR "D> ", join( "\nD> ", @messages );
+    }
+}                                                                           #}}}
+
+#===  FUNCTION  ================================================================
+#         NAME: _dbargs
+#      PURPOSE: Collects database arguments for the main query
+#   PARAMETERS: $opts   hash reference holding the options
+#      RETURNS: An array holding all of the arguments
+#  DESCRIPTION: If there are -dbargs options they will be an array in the hash
+#               returned by Getopt::Long. We return the array to the caller.
+#       THROWS: No exceptions
+#     COMMENTS: None
+#     SEE ALSO: N/A
+#===============================================================================
+sub _dbargs {                                                               #{{{
+    my ($opts) = @_;
+
+    my @args;
+
+    if ( defined( $opts->{dbarg} ) ) {
+        @args = @{ $opts->{dbarg} };
+    }
+
+    return (@args);
+}                                                                           #}}}
+
+#===  FUNCTION  ================================================================
+#         NAME: Options
+#      PURPOSE: Processes command-line options
+#   PARAMETERS: $optref     Hash reference to hold the options
+#      RETURNS: Undef
+#  DESCRIPTION:
+#       THROWS: no exceptions
+#     COMMENTS: none
+#     SEE ALSO: n/a
+#===============================================================================
+sub Options {                                                               #{{{
+    my ($optref) = @_;
+
+    my @options = (
+        "help",     "documentation|man", "debug=i",   "config=s",
+        "output=s", "query=s",           "dbarg=s@", "header!",
+    );
+
+    if ( !GetOptions( $optref, @options ) ) {
+        pod2usage( -msg => "Version $VERSION\n", -exitval => 1 );
+    }
+
+    return;
+}                                                                           #}}}
+
+__END__
+
+#%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+#  Application Documentation
+#%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+#{{{
+
+=head1 NAME
+
+query2csv - A script for generating CSV from database query
+
+=head1 VERSION
+
+This documentation refers to query2csv version 0.0.5
+
+=head1 USAGE
+
+    query2csv [-help] [-documentation|-man] [-debug=N] [-config=FILE]
+         [-query=FILE] [-output=FILE] [-[no]header] [QUERY]
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<-help>
+
+Prints a brief help message describing the usage of the program, and then exits.
+
+=item B<-documentation> or B<-man>
+
+Displays the entirety of the documentation (using a pager), and then exits. To
+generate a PDF version use:
+
+    pod2pdf query2csv --out=query2csv.pdf
+
+=item B<-debug=N>
+
+Selects a level of debugging. Debug information consists of a line or series
+of lines prefixed with the characters 'D>':
+
+=over 4
+
+=item B<0>
+
+No debug output is generated: this is the default
+
+=item B<3>
+
+Prints all data structures from options or from the database
+
+=back
+
+(The debug levels need work!)
+
+=item B<-config=FILE>
+
+This option allows an alternative configuration file to be used. This file
+defines the location of the database, its port, its name and the username and
+password to be used to access it. This feature was added to allow the script
+to access alternative databases.
+
+See the CONFIGURATION AND ENVIRONMENT section below for the file format.
+
+If the option is omitted the default file is used: B<.hpr_sqlite.cfg>
+
+=item B<-output=FILE>
+
+This option defines an output file to receive the result of the query. If the
+option is omitted the notes are written to STDOUT, allowing them to be
+redirected if required.
+
+=item B<-query=FILE>
+
+The script needs an SQL query to be applied to the database. This may be
+supplied as a file, in which case this option gives the name of the file.
+
+Alternatively the query can be given as a delimited string on the command
+line.
+
+If neither method is used the script aborts with an error message.
+
+=item B<-dbarg=ARG> [ B<-dbarg=ARG> ... ]
+
+The query can have place holders ('?') in it and the corresponding values for
+these placeholders can be passed to the script through the B<-dbarg=ARG>
+option. The option can be repeated as many times as required and the order of
+B<ARG> values is preserved.
+
+=item B<-[no-]header>
+
+This option allows a header to be added to the CSV output with the names of
+the database columns in CSV format. By default this is not produced.
+
+=back
+
+=head1 DESCRIPTION
+
+The purpose of the script is to run a query against a local database. It will
+query SQLite or MySQL/MariaDB databases.  The database choice is made via
+a configuration file using B<dbtype = TYPE>. The default file points to the
+local SQLite copy of the HPR database, but the alternative (discussed later)
+can access the equivalent MySQL database.
+
+The data returned from the query is then passed through a CSV conversion
+library and the results output to the terminal or to a file.
+
+=head1 DIAGNOSTICS
+
+=over 4
+
+=item B<Unable to find configuration file ...>
+
+The nominated (or default) configuration file could not be found.
+
+=item B<Unable to find query file ...>
+
+The nominated query file could not be found.
+
+=item B<Couldn't open ...: ...>
+
+The nominated query file could not be opened.
+
+=item B<various database errors>
+
+An error has occurred while performing a database operation.
+
+=item B<Failed to execute query.>
+
+There is a mismatch between the number of placeholders in the query ('?'
+characters) and the number of arguments provided through the B<-dbargs=ARG>
+option. The script will attempt to analyse whether there are too many or too
+few arguments
+
+=back
+
+=head1 CONFIGURATION AND ENVIRONMENT
+
+The script obtains the credentials it requires to open the SQLite or MariaDB database
+from a configuration file. No credentials are required for the SQLite format.
+The name of the MySQL database or the SQLite file it expects is specified as
+a simple name or as an absolute file path. This configuration file can be overridden
+using the B<-config=FILE> option as described above.
+
+The configuration file formats are as follows:
+
+SQLite format:
+
+ <database>
+     dbtype = SQLite
+     name   = /home/cendjm/HPR/Community_News/hpr.db
+ </database>
+
+MySQL/MariaDB format:
+
+ <database>
+     dbtype   = MySQL
+     host     = 127.0.0.1
+     name     = DBNAME
+     user     = DBUSER
+     password = PASSWORD
+ </database>
+
+=head1 EXAMPLES
+
+ query2csv -help
+
+ # Find tags fields shorter than 5 characters between shows 1 and 2000
+ query2csv -config=.hpr_sqlite.cfg \
+    'SELECT id,summary,tags FROM eps WHERE id BETWEEN 1 AND 2000
+    AND length(tags) < 5 ORDER BY id'
+
+ # Find hosts who have released HPR shows during 2025. The database
+ # arguments are the dates of the start and end of the year
+ year=2025
+ query2csv -query=hosts_showcount.sqlite.sql \
+    -dbargs "${year}-01-01" -dbargs "${year}-12-31"
+
+=head1 DEPENDENCIES
+
+    Config::General
+    Cwd
+    Data::Dumper
+    DBI
+    File::Slurper
+    Getopt::Long
+    Pod::Usage
+    Text::CSV_XS
+
+=head1 BUGS AND LIMITATIONS
+
+There are no known bugs in this module.
+Please report problems to Dave Morriss (Dave.Morriss@gmail.com)
+Patches are welcome.
+
+=head1 AUTHOR
+
+Dave Morriss (Dave.Morriss@gmail.com)
+
+
+=head1 LICENCE AND COPYRIGHT
+
+Copyright (c) 2021, 2022, 2024, 2025 Dave Morriss (Dave.Morriss@gmail.com).
+All rights reserved.
+
+This module is free software; you can redistribute it and/or
+modify it under the same terms as Perl itself. See perldoc perlartistic.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+
+=cut
+
+#}}}
+
+# [zo to open fold, zc to close]
+
 # vim: syntax=perl:ts=8:sw=4:et:ai:tw=78:fo=tcrqn21:fdm=marker
 

Database/query2json

@@ -3,29 +3,40 @@
 #
 #         FILE: query2json
 #
-#        USAGE: ./query2json query
+#        USAGE: ./query2json [-help] [-documentation|-man] [-debug=N]
+#               [-config=FILE] [-query=FILE]
+#               [-dbarg=ARG1 [-dbarg=ARG2] ...] [QUERY]
 #
-#  DESCRIPTION: Runs a query given as the only argument. Caution is needed
+#  DESCRIPTION: Runs a query given as the only argument, or provided in
-#               since *any* query will be run. The result of the query is
+#               a file. Caution is needed since *any* query will be run. The
-#               output in JSON form on STDOUT.
+#               result of the query is output in JSON form on STDOUT or to
+#               a file. If the query contains '?' placeholders they can be
+#               filled with -dbarg=ARG options.
 #
 #      OPTIONS: ---
 # REQUIREMENTS: ---
 #         BUGS: ---
-#        NOTES: Had to revert to MySQL because of a problem with DBD::MariaDB
+#        NOTES: ---
 #       AUTHOR: Dave Morriss (djm), Dave.Morriss@gmail.com
-#      VERSION: 0.0.2
+#      VERSION: 0.0.4
 #      CREATED: 2021-06-18 13:24:49
-#     REVISION: 2023-01-05 16:17:24
+#     REVISION: 2025-05-25 18:48:59
 #
 #===============================================================================
 
-use 5.010;
+use v5.40;
-use strict;
-use warnings;
 use utf8;
+use open ':std', ':encoding(UTF-8)';
+
+use feature qw{ say try };
+
+use Cwd qw( getcwd abs_path );                 # Detecting where the script lives
+
+use Getopt::Long;
+use Pod::Usage;
 
 use Config::General;
+use File::Slurper qw{ read_text };
 use JSON;
 use DBI;
 
@@ -34,14 +45,12 @@ use Data::Dumper;
 #
 # Version number (manually incremented)
 #
-our $VERSION = '0.0.2';
+our $VERSION = '0.0.4';
 
 #
-# Script and directory names
+# Script name
 #
 ( my $PROG = $0 ) =~ s|.*/||mx;
-( my $DIR  = $0 ) =~ s|/?[^/]*$||mx;
-$DIR = '.' unless $DIR;
 
 #-------------------------------------------------------------------------------
 # Declarations
@@ -49,58 +58,144 @@ $DIR = '.' unless $DIR;
 #
 # Constants and other declarations
 #
-my $basedir    = "$ENV{HOME}/HPR/Database";
+#
-my $configfile = "$basedir/.hpr_livedb.cfg";
+# Make a variable to hold the working directory where the script is located
+#
+( my $basedir = abs_path($0) ) =~ s|/?[^/]*$||mx;
+
+my $configfile = "$basedir/.hpr_sqlite.cfg";
 
 my ( $dbh, $sth1, $aref1 );
 my ( $query, $result, $json );
-
+my ( $pcount, $acount );
-#
-# Enable Unicode mode
-#
-binmode STDOUT, ":encoding(UTF-8)";
-binmode STDERR, ":encoding(UTF-8)";
-
-#
-# Load database configuration data
-#
-my $conf = Config::General->new(
-    -ConfigFile      => $configfile,
-    -InterPolateVars => 1,
-    -ExtendedAccess  => 1
-);
-my %config = $conf->getall();
 
 #-------------------------------------------------------------------------------
 # Options and arguments
 #-------------------------------------------------------------------------------
-$query = shift;
+my %options;
-die "Usage: $PROG query\n" unless $query;
+Options( \%options );
+
+#
+# Default help
+#
+pod2usage( -msg => "Version $VERSION\n", -exitval => 1, -verbose => 0 )
+    if ( $options{'help'} );
+
+#
+# Full documentation if requested with -doc
+#
+pod2usage(
+    -msg => "$PROG version $VERSION\n",
+    -verbose => 2,
+    -exitval => 1,
+    -noperldoc => 0,
+) if ( $options{'documentation'} );
+
+#
+# Collect options
+#
+my $DEBUG = ( $options{'debug'} ? $options{'debug'} : 0 );
+
+my $cfgfile
+    = ( defined( $options{config} ) ? $options{config} : $configfile );
+
+my $queryfile = $options{query};
+
+my $outfile = $options{output};
+_debug( $DEBUG >= 3, '$outfile: ' . $outfile ) if ($outfile);
+
+my @dbargs = _dbargs( \%options );
+_debug( $DEBUG >= 3, '@dbargs: ' . join( ',', @dbargs ) );
+
+#-------------------------------------------------------------------------------
+# Option checks and defaults
+#-------------------------------------------------------------------------------
+die "Unable to find configuration file $cfgfile\n" unless ( -e $cfgfile );
+_debug( $DEBUG >= 3, '$cfgfile: ' . $cfgfile );
+
+#
+# Query is an argument string or is in a file
+#
+if ($queryfile) {
+    die "Unable to find query file $queryfile\n" unless ( -e $queryfile );
+    $query = read_text($queryfile);
+}
+else {
+    $query = shift;
+    pod2usage(
+        -msg     => "Please specify a SQL query\n",
+        -exitval => 1,
+        -verbose => 0
+        )
+        unless $query;
+}
+_debug( $DEBUG >= 3, '$query: ' . Dumper(\$query) );
+
+#
+# Strip SQL comments
+#
+$query = strip_sql_comments($query);
+
+#
+# Count placeholders in the query and the arguments provided. First remove all
+# comments which may contain '?' characters, then count any that are left.
+#
+#$query = join("\n", grep {!/^--/} split( "\n", $query ) );
+$pcount = grep {/\?/} split( '', $query );
+$acount = scalar(@dbargs);
+
+#
+# Check the placeholder and argument counts are the same
+#
+if ( $pcount ne $acount) {
+    say STDERR "Query placeholder vs argument mismatch";
+    say STDERR "Placeholders = $pcount, Arguments = $acount";
+    pod2usage(
+        -msg       => "Wrong number of DB arguments\n",
+        -exitvalue => 1,
+        -verbose   => 0
+    );
+}
+
+#-------------------------------------------------------------------------------
+# Open the output file (or STDOUT)
+#-------------------------------------------------------------------------------
+my $outfh;
+if ($outfile) {
+    open( $outfh, ">:encoding(UTF-8)", $outfile )
+        or die "Unable to open $outfile for writing: $!";
+}
+else {
+    open( $outfh, ">&", \*STDOUT )
+        or die "Unable to initialise for writing: $!";
+}
+
+#-------------------------------------------------------------------------------
+# Load database configuration data; allow environment variables
+#-------------------------------------------------------------------------------
+my $conf = Config::General->new(
+    -ConfigFile      => $configfile,
+    -InterPolateVars => 1,
+    -InterPolateEnv  => 1,
+    -ExtendedAccess  => 1
+);
+my %config = $conf->getall();
+
+#
+# Set defaults in case values have been omitted
+#
+$config{database}->{dbtype} //= 'SQLite';
+$config{database}->{host}   //= '127.0.0.1';
+$config{database}->{port}   //= 3306;
 
 #-------------------------------------------------------------------------------
 # Connect to the database
 #-------------------------------------------------------------------------------
-my $dbhost = $config{database}->{host} // '127.0.0.1';
+$dbh = db_connect(\%config);
-my $dbport = $config{database}->{port} // 3306;
-my $dbname = $config{database}->{name};
-my $dbuser = $config{database}->{user};
-my $dbpwd  = $config{database}->{password};
-#$dbh = DBI->connect( "DBI:MariaDB:host=$dbhost;port=$dbport;database=$dbname",
-#    $dbuser, $dbpwd, { AutoCommit => 1 } )
-#    or die $DBI::errstr;
 
-$dbh = DBI->connect( "dbi:mysql:host=$dbhost;port=$dbport;database=$dbname",
+#-------------------------------------------------------------------------------
-    $dbuser, $dbpwd, { AutoCommit => 1 } )
+# Set up and perform the query
-    or die $DBI::errstr;
+#-------------------------------------------------------------------------------
-
-#
-# Enable client-side UTF8
-#
-$dbh->{mysql_enable_utf8} = 1;
-
-#
-# Set up the query
-#
 $sth1 = $dbh->prepare($query) or die $DBI::errstr;
 if ( $dbh->err ) {
     warn $dbh->errstr;
@@ -109,26 +204,434 @@ if ( $dbh->err ) {
 #
 # Perform the query
 #
-$sth1->execute;
+try {
-if ( $dbh->err ) {
+    $sth1->execute(@dbargs);
+    if ( $dbh->err ) {
         warn $dbh->errstr;
+    }
 }
+catch ($e) {
+    #
+    # The 'die' above was triggered. The error is in $_.
+    #
+    say STDERR "Failed to execute query.";
+    exit 1;
+}
+
+#
+# Prepare for JSON, forcing object key sorting (expensive), and prettification
+#
+$json = JSON->new->utf8->canonical->pretty;
 
 #
 # Grab everything as an arrayref of hashrefs
 #
 $result = $sth1->fetchall_arrayref( {} );
 
-#
-# Prepare for JSON, forcing object key sorting (expensive)
-#
-$json = JSON->new->utf8->canonical;
-
 #
 # Encode the Perl structure to JSON
 #
-print $json->encode($result), "\n";
+say $outfh $json->encode($result);
+close($outfh);
 
 exit;
 
+#===  FUNCTION  ================================================================
+#         NAME: db_connect
+#      PURPOSE: Connects to a database using configuration settings including
+#               the database type
+#   PARAMETERS: $cfg            Config::General object
+#      RETURNS: Database handle
+#  DESCRIPTION: The 'dbtype' field in the configuration file gets a default,
+#               but the 'name' field is mandatory. Depending on the
+#               (lowercase) type name a different form of database connect is
+#               performed after '$dbtype' is set to the format the DBD driver
+#               needs. The database handle is returned (unless there's an
+#               error).
+#       THROWS: No exceptions
+#     COMMENTS: None
+#     SEE ALSO: N/A
+#===============================================================================
+sub db_connect {                                                            #{{{
+    my ($cfg) = @_;
+
+    my ( $dbh, $dbtype, $dbname );
+
+    $dbtype = $cfg->{database}->{dbtype};
+    $dbname = $cfg->{database}->{name};
+    die "Database name is mandatory\n" unless $dbname;
+
+    #
+    # Connect according to the database type
+    #
+    if ($dbtype =~ /sqlite/i) {
+        #
+        # The name for the SQLite driver is 'DBD:SQLite'
+        #
+        $dbtype = 'SQLite';
+        _debug( $DEBUG >= 3, '$dbtype: ' . $dbtype, '$dbname: ' . $dbname );
+
+        $dbh = DBI->connect( "DBI:$dbtype:dbname=$dbname",
+            "", "", { AutoCommit => 1, sqlite_unicode => 1,  } )
+            or die $DBI::errstr;
+    }
+    elsif ($dbtype =~ /mysql/i) {
+        #
+        # The name for the MySQL driver is 'DBD:mysql'
+        #
+        $dbtype = 'mysql';
+
+        my $dbhost = $cfg->{database}->{host};
+        my $dbport = $cfg->{database}->{port};
+        my $dbuser = $cfg->{database}->{user};
+        my $dbpwd  = $cfg->{database}->{password};
+
+        $dbh = DBI->connect( "DBI:$dbtype:host=$dbhost;port=$dbport;database=$dbname",
+            $dbuser, $dbpwd, { AutoCommit => 1 } )
+            or die $DBI::errstr;
+
+        #
+        # Enable client-side UTF8
+        #
+        $dbh->{mysql_enable_utf8} = 1;
+
+        # $dbh->trace('2|SQL');
+    }
+    elsif ($dbtype =~ /pg/i) {
+        #
+        # The name for the PostgreSQL driver is 'DBD:Pg'
+        #
+        $dbtype = 'Pg';
+
+        die "The PostgreSQL database type is not catered for yet.\n";
+    }
+    else {
+        die "Unknown database type: $dbtype\n";
+    }
+
+    return $dbh;
+}                                                                           #}}}
+
+#===  FUNCTION  ================================================================
+#         NAME: strip_sql_comments
+#      PURPOSE: Given a query as a scalar, strips all SQL comments
+#   PARAMETERS: $query          string containing a query
+#      RETURNS: Stripped string
+#  DESCRIPTION: Two types of comments might exist in the query: the C-style
+#               and the SQL style. The string is treated as a single string
+#               even though it's multi-line, and any C-style comments are
+#               removed. Then the string is treated as multi-line and each
+#               line is scanned for SQL comments (which end at the end of the
+#               line), and these are stripped. Blank lines are skipped too to
+#               compress the output a little.
+#       THROWS: No exceptions
+#     COMMENTS: None
+#     SEE ALSO: N/A
+#===============================================================================
+sub strip_sql_comments {                                                    #{{{
+    my ($query) = @_;
+
+    my $result;
+
+    #
+    # Strip C-style comments
+    #
+    $query =~ s/\/\*.*?\*\///sg;
+
+    #
+    # Strip SQL line-oriented comments
+    #
+    foreach my $line (split(/\n/,$query)) {
+        next if $line =~ /^\s*$/;
+        $line =~ s/--.*$//;
+        $result .= "$line\n";
+    }
+
+    return $result;
+}                                                                           #}}}
+
+#===  FUNCTION  ================================================================
+#         NAME: _debug
+#      PURPOSE: Prints debug reports
+#   PARAMETERS: $active         Boolean: 1 for print, 0 for no print
+#               @messages       Messages to print
+#      RETURNS: Nothing
+#  DESCRIPTION: Outputs messages if $active is true. It removes any trailing
+#               newlines and then adds one to each line so the caller doesn't
+#               have to bother. Prepends 'D> ' to each message to show it's
+#               a debug message.
+#       THROWS: No exceptions
+#     COMMENTS: None
+#     SEE ALSO: N/A
+#===============================================================================
+sub _debug {                                                                #{{{
+    my ( $active, @messages ) = @_;
+
+    if ($active) {
+        chomp(@messages);
+        say STDERR "D> ", join( "\nD> ", @messages );
+    }
+}                                                                           #}}}
+
+#===  FUNCTION  ================================================================
+#         NAME: _dbargs
+#      PURPOSE: Collects database arguments for the main query
+#   PARAMETERS: $opts   hash reference holding the options
+#      RETURNS: An array holding all of the arguments
+#  DESCRIPTION: If there are -dbargs options they will be an array in the hash
+#               returned by Getopt::Long. We return the array to the caller.
+#       THROWS: No exceptions
+#     COMMENTS: None
+#     SEE ALSO: N/A
+#===============================================================================
+sub _dbargs {                                                               #{{{
+    my ($opts) = @_;
+
+    my @args;
+
+    if ( defined( $opts->{dbarg} ) ) {
+        @args = @{ $opts->{dbarg} };
+    }
+
+    return (@args);
+}                                                                           #}}}
+
+#===  FUNCTION  ================================================================
+#         NAME: Options
+#      PURPOSE: Processes command-line options
+#   PARAMETERS: $optref     Hash reference to hold the options
+#      RETURNS: Undef
+#  DESCRIPTION:
+#       THROWS: no exceptions
+#     COMMENTS: none
+#     SEE ALSO: n/a
+#===============================================================================
+sub Options {                                                               #{{{
+    my ($optref) = @_;
+
+    my @options = (
+        "help",     "documentation|man", "debug=i", "config=s",
+        "output=s", "query=s",           "dbargs=s@",
+    );
+
+    if ( !GetOptions( $optref, @options ) ) {
+        pod2usage( -msg => "Version $VERSION\n", -exitval => 1 );
+    }
+
+    return;
+}                                                                           #}}}
+
+__END__
+
+#%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+#  Application Documentation
+#%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+#{{{
+
+=head1 NAME
+
+query2json - A script for generating CSV from database query
+
+=head1 VERSION
+
+This documentation refers to query2json version 0.0.4
+
+=head1 USAGE
+
+    query2json [-help] [-documentation|-man] [-debug=N] [-config=FILE]
+         [-query=FILE] [-output=FILE] [QUERY]
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<-help>
+
+Prints a brief help message describing the usage of the program, and then exits.
+
+=item B<-documentation> or B<-man>
+
+Displays the entirety of the documentation (using a pager), and then exits. To
+generate a PDF version use:
+
+    pod2pdf query2json --out=query2json.pdf
+
+=item B<-debug=N>
+
+Selects a level of debugging. Debug information consists of a line or series
+of lines prefixed with the characters 'D>':
+
+=over 4
+
+=item B<0>
+
+No debug output is generated: this is the default
+
+=item B<3>
+
+Prints all data structures from options or from the database
+
+=back
+
+(The debug levels need work!)
+
+=item B<-config=FILE>
+
+This option allows an alternative configuration file to be used. This file
+defines the location of the database, its port, its name and the username and
+password to be used to access it. This feature was added to allow the script
+to access alternative databases.
+
+See the CONFIGURATION AND ENVIRONMENT section below for the file format.
+
+If the option is omitted the default file is used: B<.hpr_sqlite.cfg>
+
+=item B<-output=FILE>
+
+This option defines an output file to receive the result of the query. If the
+option is omitted the notes are written to STDOUT, allowing them to be
+redirected if required.
+
+=item B<-query=FILE>
+
+The script needs an SQL query to be applied to the database. This may be
+supplied as a file, in which case this option gives the name of the file.
+
+Alternatively the query can be given as a delimited string on the command
+line.
+
+If neither method is used the script aborts with an error message.
+
+=item B<-dbarg=ARG> [ B<-dbarg=ARG> ... ]
+
+The query can have place holders ('?') in it and the corresponding values for
+these placeholders can be passed to the script through the B<-dbarg=ARG>
+option. The option can be repeated as many times as required and the order of
+B<ARG> values is preserved.
+
+=back
+
+=head1 DESCRIPTION
+
+The purpose of the script is to run a query against a local database. It will
+query SQLite or MySQL/MariaDB databases.  The database choice is made via
+a configuration file using B<dbtype = TYPE>. The default file points to the
+local SQLite copy of the HPR database, but the alternative (discussed later)
+can access the equivalent MySQL database.
+
+The data returned from the query is then passed through a JSON conversion
+library and the results output to the terminal or to a file.
+
+=head1 DIAGNOSTICS
+
+=over 4
+
+=item B<Unable to find configuration file ...>
+
+The nominated (or default) configuration file could not be found.
+
+=item B<Unable to find query file ...>
+
+The nominated query file could not be found.
+
+=item B<Couldn't open ...: ...>
+
+The nominated query file could not be opened.
+
+=item B<various database errors>
+
+An error has occurred while performing a database operation.
+
+=item B<Failed to execute query.>
+
+There is a mismatch between the number of placeholders in the query ('?'
+characters) and the number of arguments provided through the B<-dbargs=ARG>
+option. The script will attempt to analyse whether there are too many or too
+few arguments
+
+=back
+
+=head1 CONFIGURATION AND ENVIRONMENT
+
+The script obtains the credentials it requires to open the SQLite or MariaDB database
+from a configuration file. No credentials are required for the SQLite format.
+The name of the MySQL database or the SQLite file it expects is specified as
+a simple name or as an absolute file path. This configuration file can be overridden
+using the B<-config=FILE> option as described above.
+
+The configuration file formats are as follows:
+
+SQLite format:
+
+ <database>
+     dbtype = SQLite
+     name   = /home/cendjm/HPR/Community_News/hpr.db
+ </database>
+
+MySQL/MariaDB format:
+
+ <database>
+     dbtype   = MySQL
+     host     = 127.0.0.1
+     name     = DBNAME
+     user     = DBUSER
+     password = PASSWORD
+ </database>
+
+=head1 EXAMPLES
+
+ query2json -help
+
+ # Find tags fields shorter than 5 characters between shows 1 and 2000
+ query2json -config=.hpr_sqlite.cfg \
+    'SELECT id,summary,tags FROM eps WHERE id BETWEEN 1 AND 2000
+    AND length(tags) < 5 ORDER BY id'
+
+ # Find hosts who have released HPR shows during 2025. The database
+ # arguments are the dates of the start and end of the year
+ year=2025
+ query2json -query=hosts_showcount.sqlite.sql \
+    -dbargs "${year}-01-01" -dbargs "${year}-12-31"
+
+=head1 DEPENDENCIES
+
+    Config::General
+    Cwd
+    Data::Dumper
+    DBI
+    File::Slurper
+    Getopt::Long
+    Pod::Usage
+    Text::CSV_XS
+
+=head1 BUGS AND LIMITATIONS
+
+There are no known bugs in this module.
+Please report problems to Dave Morriss (Dave.Morriss@gmail.com)
+Patches are welcome.
+
+=head1 AUTHOR
+
+Dave Morriss (Dave.Morriss@gmail.com)
+
+
+=head1 LICENCE AND COPYRIGHT
+
+Copyright (c) 2021, 2022, 2024, 2025 Dave Morriss (Dave.Morriss@gmail.com).
+All rights reserved.
+
+This module is free software; you can redistribute it and/or
+modify it under the same terms as Perl itself. See perldoc perlartistic.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+
+=cut
+
+#}}}
+
+# [zo to open fold, zc to close]
+
+
 # vim: syntax=perl:ts=8:sw=4:et:ai:tw=78:fo=tcrqn21:fdm=marker

Database/query2tt2

@@ -3,11 +3,11 @@
 #
 #         FILE: query2tt2
 #
-#        USAGE: ./query2tt2 [-help] [-debug=N] [-config=FILE] [-query=FILE]
+#        USAGE: ./query2tt2 [-help] [-documentation|-man] [-debug=N]
-#               [-template=FILE]
+#               [-config=FILE] [-query=FILE] [-template=FILE]
 #               [-dbarg=ARG1 [-dbarg=ARG2] ...]
-#               [-define KEY1=VALUE1 [-define KEY2=VALUE2] ...
+#               [-define KEY1=VALUE1 [-define KEY2=VALUE2] ...]
-#               [-define KEYn=VALUEn]] [QUERY]
+#               [QUERY]
 #
 #  DESCRIPTION: Built for use with the Hacker Public Radio database, but could
 #               be used in any context with a MariaDB database.
@@ -24,31 +24,26 @@
 #      OPTIONS: ---
 # REQUIREMENTS: ---
 #         BUGS: ---
-#        NOTES: Had to revert to MySQL because of a problem with DBD::MariaDB
+#        NOTES: ---
 #       AUTHOR: Dave Morriss (djm), Dave.Morriss@gmail.com
-#      VERSION: 0.0.5
+#      VERSION: 0.0.9
 #      CREATED: 2021-06-18 13:24:49
-#     REVISION: 2024-06-29 18:42:49
+#     REVISION: 2025-05-25 18:41:09
 #
 #===============================================================================
 
-use 5.010;
+use v5.40;
-use strict;
-use warnings;
 use utf8;
-use open ':encoding(UTF-8)';
+use open ':std', ':encoding(UTF-8)';
 
-# Using experimental features, some of which require warnings to be turned off
 use feature qw{ say try };
-no warnings qw{
+
-    experimental::try
+use Cwd qw( getcwd abs_path );                 # Detecting where the script lives
-};
 
 use Getopt::Long;
 use Pod::Usage;
 
 use Config::General;
-#use Try::Tiny;
 use File::Slurper qw{ read_text };
 use Hash::Merge;
 use Template;
@@ -59,14 +54,12 @@ use Data::Dumper;
 #
 # Version number (manually incremented)
 #
-our $VERSION = '0.0.5';
+our $VERSION = '0.0.9';
 
 #
 # Script and directory names
 #
 ( my $PROG = $0 ) =~ s|.*/||mx;
-( my $DIR  = $0 ) =~ s|/?[^/]*$||mx;
-$DIR = '.' unless $DIR;
 
 #-------------------------------------------------------------------------------
 # Declarations
@@ -74,11 +67,16 @@ $DIR = '.' unless $DIR;
 #
 # Constants and other declarations
 #
-my $basedir    = "$ENV{HOME}/HPR/Database";
+#
-my $configfile = "$basedir/.hpr_db.cfg";
+# Make a variable to hold the working directory where the script is located
+#
+( my $basedir = abs_path($0) ) =~ s|/?[^/]*$||mx;
+
+my $configfile = "$basedir/.hpr_sqlite.cfg";
 
 my ( $dbh, $sth1 );
 my ( $query, $result, @names, $document );
+my ( $pcount, $acount );
 
 #
 # Default template iterates through all rows in the 'result' matrix and for
@@ -94,15 +92,10 @@ my $def_template = <<'ENDTPL';
 [% END -%]
 ENDTPL
 
-#-------------------------------------------------------------------------------
+################################################################################
 # There should be no need to edit anything after this point
-#-------------------------------------------------------------------------------
+################################################################################
 
-#
-# Enable Unicode mode
-#
-#binmode STDOUT, ":encoding(UTF-8)";
-#binmode STDERR, ":encoding(UTF-8)";
 
 #-------------------------------------------------------------------------------
 # Options and arguments
@@ -124,8 +117,7 @@ pod2usage(
     -verbose => 2,
     -exitval => 1,
     -noperldoc => 0,
-) if ( $options{'doc'} );
+) if ( $options{'documentation'} );
-
 
 #
 # Collect options
@@ -143,6 +135,9 @@ my %defs   = _define( \%options );
 _debug( $DEBUG >= 3, '@dbargs: ' . join( ',', @dbargs ) );
 _debug( $DEBUG >= 3, '%defs: ' . Dumper(\%defs) );
 
+my $outfile = $options{output};
+_debug( $DEBUG >= 3, '$outfile: ' . $outfile ) if ($outfile);
+
 #-------------------------------------------------------------------------------
 # Option checks and defaults
 #-------------------------------------------------------------------------------
@@ -158,11 +153,41 @@ if ($queryfile) {
 }
 else {
     $query = shift;
-    pod2usage( -msg => "Please specify a SQL query\n", -exitval => 1 )
+    pod2usage(
+        -msg     => "Please specify a SQL query\n",
+        -exitval => 1,
+        -verbose => 0
+        )
         unless $query;
 }
 _debug( $DEBUG >= 3, '$query: ' . Dumper(\$query) );
 
+#
+# Strip SQL comments
+#
+$query = strip_sql_comments($query);
+
+#
+# Count placeholders in the query and the arguments provided. First remove all
+# comments which may contain '?' characters, then count any that are left.
+#
+#$query = join("\n", grep {!/^--/} split( "\n", $query ) );
+$pcount = grep {/\?/} split( '', $query );
+$acount = scalar(@dbargs);
+
+#
+# Check the placeholder and argument counts are the same
+#
+if ( $pcount ne $acount) {
+    say STDERR "Query placeholder vs argument mismatch";
+    say STDERR "Placeholders = $pcount, Arguments = $acount";
+    pod2usage(
+        -msg       => "Wrong number of DB arguments\n",
+        -exitvalue => 1,
+        -verbose   => 0
+    );
+}
+
 #
 # Template is the default pre-defined string or a filename
 #
@@ -176,41 +201,49 @@ _debug(
     $DEBUG >= 3,
     '$template: '
         . (ref($template) eq ''
-        ? "filename $template"
+        ? "filename = $template"
         : "reference to string\n$$template")
 );
 
 #-------------------------------------------------------------------------------
-# Load database configuration data
+# Open the output file (or STDOUT)
+#-------------------------------------------------------------------------------
+my $outfh;
+if ($outfile) {
+    open( $outfh, ">:encoding(UTF-8)", $outfile )
+        or die "Unable to open $outfile for writing: $!";
+}
+else {
+    open( $outfh, ">&", \*STDOUT )
+        or die "Unable to initialise for writing: $!";
+}
+
+#-------------------------------------------------------------------------------
+# Load database configuration data; allow environment variables
 #-------------------------------------------------------------------------------
 my $conf = Config::General->new(
     -ConfigFile      => $cfgfile,
     -InterPolateVars => 1,
+    -InterPolateEnv  => 1,
     -ExtendedAccess  => 1
 );
 my %config = $conf->getall();
 
+#
+# Set defaults
+#
+$config{database}->{dbtype} //= 'SQLite';
+$config{database}->{host}   //= '127.0.0.1';
+$config{database}->{port}   //= 3306;
+
 #-------------------------------------------------------------------------------
 # Connect to the database
 #-------------------------------------------------------------------------------
-my $dbhost = $config{database}->{host} // '127.0.0.1';
+$dbh = db_connect(\%config);
-my $dbport = $config{database}->{port} // 3306;
-my $dbname = $config{database}->{name};
-my $dbuser = $config{database}->{user};
-my $dbpwd  = $config{database}->{password};
 
-$dbh = DBI->connect( "dbi:mysql:host=$dbhost;port=$dbport;database=$dbname",
+#-------------------------------------------------------------------------------
-    $dbuser, $dbpwd, { AutoCommit => 1 } )
+# Set up and perform the query
-    or die $DBI::errstr;
+#-------------------------------------------------------------------------------
-
-#
-# Enable client-side UTF8
-#
-$dbh->{mysql_enable_utf8} = 1;
-
-#
-# Set up the query
-#
 $sth1 = $dbh->prepare($query) or die $DBI::errstr;
 if ( $dbh->err ) {
     die $dbh->errstr;
@@ -229,11 +262,8 @@ catch ($e) {
     #
     # The 'die' above was triggered. The error is in $_.
     #
-    my $pcount = grep {/\?/} split( '', $query );
+    say STDERR "Failed to execute query.";
-    my $acount = scalar(@dbargs);
+    exit 1;
-    print STDERR "Failed to execute query.\n";
-    print STDERR "Placeholder/Argument mismatch: $pcount/$acount\n";
-    exit;
 }
 
 #
@@ -249,14 +279,16 @@ _debug( $DEBUG >= 3, '$result: ' . Dumper($result) );
 _debug( $DEBUG >= 3, '@names: ' . Dumper(\@names) );
 
 #
-# Set up the template
+# Set up the template object. Look for template files where the script lives
+# and in the current directory.
 #
 my $tt = Template->new(
     {   ABSOLUTE     => 1,
+        RELATIVE     => 1,
         ENCODING     => 'utf8',
-        INCLUDE_PATH => $basedir,
+        INCLUDE_PATH => [ $basedir, getcwd() ],
     }
-);
+) || die Template->error(), "\n";
 
 #
 # Send collected data to the template
@@ -274,31 +306,148 @@ _debug( $DEBUG >= 3, '$vars: ' . Dumper($vars) );
 
 $tt->process( $template, $vars, \$document, { binmode => ':utf8' } )
     || die $tt->error(), "\n";
-print $document;
+print $outfh $document;
+close($outfh);
+_debug( $DEBUG >= 3, '$document: ' . Dumper($document) );
 
 exit;
 
+#===  FUNCTION  ================================================================
+#         NAME: db_connect
+#      PURPOSE: Connects to a database using configuration settings including
+#               the database type
+#   PARAMETERS: $cfg            Config::General object
+#      RETURNS: Database handle
+#  DESCRIPTION: The 'dbtype' field in the configuration file gets a default,
+#               but the 'name' field is mandatory. Depending on the
+#               (lowercase) type name a different form of database connect is
+#               performed after '$dbtype' is set to the format the DBD driver
+#               needs. The database handle is returned (unless there's an
+#               error).
+#       THROWS: No exceptions
+#     COMMENTS: None
+#     SEE ALSO: N/A
+#===============================================================================
+sub db_connect {                                                            #{{{
+    my ($cfg) = @_;
+
+    my ( $dbh, $dbtype, $dbname );
+
+    $dbtype = $cfg->{database}->{dbtype};
+    $dbname = $cfg->{database}->{name};
+    die "Database name is mandatory\n" unless $dbname;
+
+    #
+    # Connect according to the database type
+    #
+    if ($dbtype =~ /sqlite/i) {
+        #
+        # The name for the SQLite driver is 'DBD:SQLite'
+        #
+        $dbtype = 'SQLite';
+        _debug( $DEBUG >= 3, '$dbtype: ' . $dbtype, '$dbname: ' . $dbname );
+
+        $dbh = DBI->connect( "DBI:$dbtype:dbname=$dbname",
+            "", "", { AutoCommit => 1, sqlite_unicode => 1,  } )
+            or die $DBI::errstr;
+    }
+    elsif ($dbtype =~ /mysql/i) {
+        #
+        # The name for the MySQL driver is 'DBD:mysql'
+        #
+        $dbtype = 'mysql';
+
+        my $dbhost = $cfg->{database}->{host};
+        my $dbport = $cfg->{database}->{port};
+        my $dbuser = $cfg->{database}->{user};
+        my $dbpwd  = $cfg->{database}->{password};
+
+        $dbh = DBI->connect( "DBI:$dbtype:host=$dbhost;port=$dbport;database=$dbname",
+            $dbuser, $dbpwd, { AutoCommit => 1 } )
+            or die $DBI::errstr;
+
+        #
+        # Enable client-side UTF8
+        #
+        $dbh->{mysql_enable_utf8} = 1;
+
+        # $dbh->trace('2|SQL');
+    }
+    elsif ($dbtype =~ /pg/i) {
+        #
+        # The name for the PostgreSQL driver is 'DBD:Pg'
+        #
+        $dbtype = 'Pg';
+
+        die "The PostgreSQL database type is not catered for yet.\n";
+    }
+    else {
+        die "Unknown database type: $dbtype\n";
+    }
+
+    return $dbh;
+}                                                                           #}}}
+
+#===  FUNCTION  ================================================================
+#         NAME: strip_sql_comments
+#      PURPOSE: Given a query as a scalar, strips all SQL comments
+#   PARAMETERS: $query          string containing a query
+#      RETURNS: Stripped string
+#  DESCRIPTION: Two types of comments might exist in the query: the C-style
+#               and the SQL style. The string is treated as a single string
+#               even though it's multi-line, and any C-style comments are
+#               removed. Then the string is treated as multi-line and each
+#               line is scanned for SQL comments (which end at the end of the
+#               line), and these are stripped. Blank lines are skipped too to
+#               compress the output a little.
+#       THROWS: No exceptions
+#     COMMENTS: None
+#     SEE ALSO: N/A
+#===============================================================================
+sub strip_sql_comments {                                                    #{{{
+    my ($query) = @_;
+
+    my $result;
+
+    #
+    # Strip C-style comments
+    #
+    $query =~ s/\/\*.*?\*\///sg;
+
+    #
+    # Strip SQL line-oriented comments
+    #
+    foreach my $line (split(/\n/,$query)) {
+        next if $line =~ /^\s*$/;
+        $line =~ s/--.*$//;
+        $result .= "$line\n";
+    }
+
+    return $result;
+}                                                                           #}}}
+
 #===  FUNCTION  ================================================================
 #         NAME: _debug
 #      PURPOSE: Prints debug reports
 #   PARAMETERS: $active         Boolean: 1 for print, 0 for no print
-#               $message        Message to print
+#               @messages       Messages to print
 #      RETURNS: Nothing
-#  DESCRIPTION: Outputs a message if $active is true. It removes any trailing
+#  DESCRIPTION: Outputs messages if $active is true. It removes any trailing
-#               newline and then adds one in the 'print' to the caller doesn't
+#               newlines and then adds one to each line so the caller doesn't
-#               have to bother. Prepends the message with 'D> ' to show it's
+#               have to bother. Prepends 'D> ' to each message to show it's
 #               a debug message.
 #       THROWS: No exceptions
 #     COMMENTS: None
 #     SEE ALSO: N/A
 #===============================================================================
-sub _debug {
+sub _debug {                                                                #{{{
-    my ( $active, $message ) = @_;
+    my ( $active, @messages ) = @_;
-
-    chomp($message);
-    print STDERR "D> $message\n" if $active;
-}
 
+    if ($active) {
+        chomp(@messages);
+        say STDERR "D> ", join( "\nD> ", @messages );
+    }
+}                                                                           #}}}
 
 #===  FUNCTION  ================================================================
 #         NAME: _dbargs
@@ -311,17 +460,17 @@ sub _debug {
 #     COMMENTS: None
 #     SEE ALSO: N/A
 #===============================================================================
-sub _dbargs {
+sub _dbargs {                                                               #{{{
     my ($opts) = @_;
 
     my @args;
 
-    if ( defined( $opts->{dbargs} ) ) {
+    if ( defined( $opts->{dbarg} ) ) {
-        @args = @{ $opts->{dbargs} };
+        @args = @{ $opts->{dbarg} };
     }
 
     return (@args);
-}
+}                                                                           #}}}
 
 #===  FUNCTION  ================================================================
 #         NAME: _define
@@ -336,7 +485,7 @@ sub _dbargs {
 #     COMMENTS: None
 #     SEE ALSO:
 #===============================================================================
-sub _define {
+sub _define {                                                               #{{{
     my ($opts) = @_;
 
     my %defs;
@@ -346,7 +495,7 @@ sub _define {
     }
 
     return (%defs);
-}
+}                                                                           #}}}
 
 #===  FUNCTION  ================================================================
 #         NAME: Options
@@ -358,12 +507,15 @@ sub _define {
 #     COMMENTS: none
 #     SEE ALSO: n/a
 #===============================================================================
-sub Options {
+sub Options {                                                               #{{{
     my ($optref) = @_;
 
     my @options = (
-        "help",    "doc",        "debug=i",   "config=s",
+        "help",       "documentation|man",
-        "query=s", "template=s", "dbargs=s@", "define=s%",
+        "debug=i",    "config=s",
+        "output=s",   "query=s",
+        "template=s", "dbarg=s@",
+        "define=s%",
     );
 
     if ( !GetOptions( $optref, @options ) ) {
@@ -371,7 +523,7 @@ sub Options {
     }
 
     return;
-}
+}                                                                           #}}}
 
 __END__
 
@@ -386,26 +538,14 @@ query2tt2 - A script for formatting a report from database query using a templat
 
 =head1 VERSION
 
-This documentation refers to query2tt2 version 0.0.5
+This documentation refers to query2tt2 version 0.0.9
 
 =head1 USAGE
 
-    query2tt2 [-help] [-doc] [-debug=N] [-config=FILE] [-query=FILE]
+    query2tt2 [-help] [-documentation|-man] [-debug=N] [-config=FILE]
-         [-template=FILE] [-dbargs=ARG1 [-dbarg=ARG2] ...]
+         [-query=FILE] [-template=FILE] [-dbargs=ARG1 [-dbarg=ARG2] ...]
          [define KEY1=VALUE [define key2=VALUE2] ...] [QUERY]
 
-    query2tt2 -help
-
-    query2tt2 -query=tag_query_580-589.sql
-
-    query2tt2 -config=.hpr_livedb.cfg -template=query2tt2_taglist.tpl \
-    'select id,summary,tags from eps where id between 580 AND 589 AND (length(summary) = 0 or length(tags) = 0) ORDER BY id'
-
-    query2tt2 -config=.hpr_livedb.cfg -query=hosts_showcount.sql \
-        -dbargs '2021-01-01' -dbargs '2021-12-31' \
-        -def year=2021 -template=~/HPR/Community_News/hosts_list.tpl
-
-
 =head1 OPTIONS
 
 =over 4
@@ -414,7 +554,7 @@ This documentation refers to query2tt2 version 0.0.5
 
 Prints a brief help message describing the usage of the program, and then exits.
 
-=item B<-doc>
+=item B<-documentation> or B<-man>
 
 Displays the entirety of the documentation (using a pager), and then exits. To
 generate a PDF version use:
@@ -445,11 +585,17 @@ Prints all data structures from options or from the database
 This option allows an alternative configuration file to be used. This file
 defines the location of the database, its port, its name and the username and
 password to be used to access it. This feature was added to allow the script
-to access alternative databases or the live HPR database over an SSH tunnel.
+to access alternative databases.
 
 See the CONFIGURATION AND ENVIRONMENT section below for the file format.
 
-If the option is omitted the default file is used: B<.hpr_db.cfg>
+If the option is omitted the default file is used: B<.hpr_sqlite.cfg>
+
+=item B<-output=FILE>
+
+This option defines an output file to receive the result of the query. If the
+option is omitted the notes are written to STDOUT, allowing them to be
+redirected if required.
 
 =item B<-query=FILE>
 
@@ -474,30 +620,32 @@ The results of the query are fed to the Template Toolkit system for
 reformatting. This option provides the name of the template definition file.
 If this option is omitted then the script uses a very simple internal template
 which is roughly equivalent to the effect in MySQL/MariaDB of ending a query
-with I<\G>.
+with I<\G> or using I<.mode list> with SQLite.
 
 See below in the B<DESCRIPTION> section for the constraints imposed on the
 contents of the template.
 
-Output from the template is written to STDOUT.
+Output from the template is written to STDOUT or to the file designated with
+the B<-out=FILE> option.
 
 =item B<-define KEY1=VALUE1> [ B<-define KEY2=VALUE2> ... B<-define KEYn=VALUEn> ]
 
 The Template Toolkit (TT2) template may receive values from the command line
 using this option. The argument to the B<-define> option is a B<key=value>
 pair. Keys should be unique otherwise they will overwrite one another. They
-should also not be 'names' or 'result' because these keys are used internally
+should also not be I<'names'> or I<'result'> because these keys are used
-(for the data from the database). See below for more details. The keys will
+internally (for the data from the database). See below for more details. The
-become TT2 variables and the values will be assigned to them.
+keys will become TT2 variables and the values will be assigned to them.
 
 =back
 
 =head1 DESCRIPTION
 
 The purpose of the script is to run a query against the HPR database (a local
-copy or the live one on the server over an SSH tunnel). The database choice is
+copy in SQLite or MySQL form or the live one on the server over an SSH
-made via a configuration file. The default file points to the local database,
+tunnel). The database choice is made via a configuration file. The default
-but the alternative (discussed later) accesses the live database.
+file points to the local database, but the alternative (discussed later)
+accesses the live database.
 
 The data returned from the query is then passed through a Template Toolkit
 template so that it can be formatted. There are many ways in which this can be
@@ -566,26 +714,64 @@ An error has occurred while processing the template.
 
 =head1 CONFIGURATION AND ENVIRONMENT
 
-The script obtains the credentials it requires to open the MariaDB database
+The script obtains the credentials it requires to open the SQLite or MariaDB database
-from a configuration file. The name of the file it expects is B<.hpr_db.cfg>
+from a configuration file. No credentials are required for the SQLite format.
-in the directory holding the script. This configuration file can be overridden
+The name of the MySQL database or the SQLite file it expects is specified as
+a simple name or as an absolute file path. This configuration file can be overridden
 using the B<-config=FILE> option as described above.
 
-The configuration file format is as follows:
+The configuration file formats are as follows:
+
+SQLite format:
 
  <database>
+     dbtype = SQLite
+     name   = /home/cendjm/HPR/Community_News/hpr.db
+ </database>
+
+MySQL/MariaDB format:
+
+ <database>
+     dbtype   = MySQL
      host     = 127.0.0.1
-     port = PORT
+     name     = hpr_hpr
-     name = DATABASE
+     user     = hpradmin
-     user = USERNAME
      password = PASSWORD
  </database>
 
+=head1 EXAMPLES
+
+ # Request minimal help
+ query2tt2 -help
+
+ # Request full internal documentation
+ query2tt2 -man
+
+ # Run a query from a file and output in the default format
+ query2tt2 -query=tag_query_580-589.sql
+
+ # Run the query on the command line and process the results using
+ # a specific template
+ query2tt2 -config=.hpr_sqlite.cfg -template=query2tt2_taglist.tpl \
+     'select id,summary,tags from eps where id between 580 AND 589
+     AND (length(summary) = 0 or length(tags) = 0) ORDER BY id'
+
+ # Run a query from a file. The query has two placeholders which receive
+ # values from the '-dbarg' options. A template processes the output and
+ # takes a TT2 variable 'year' which is used by the template. Output is in
+ # HTML format and is written to a file.
+ query2tt2 -config=.hpr_sqlite.cfg -query=hosts_showcount.sql \
+     -dbargs '2024-01-01' -dbargs '2024-12-31' \
+     -def year=2024 -template=~/HPR/Community_News/hosts_list.tpl \
+     -out=host_showcount.html
+
+
 =head1 DEPENDENCIES
 
     Config::General
-    DBI
+    Cwd
     Data::Dumper
+    DBI
     File::Slurper
     Getopt::Long
     Hash::Merge
@@ -605,8 +791,8 @@ Dave Morriss (Dave.Morriss@gmail.com)
 
 =head1 LICENCE AND COPYRIGHT
 
-Copyright (c) 2021, 2022, 2024 Dave Morriss (Dave.Morriss@gmail.com). All
+Copyright (c) 2021, 2022, 2024, 2025 Dave Morriss (Dave.Morriss@gmail.com).
-rights reserved.
+All rights reserved.
 
 This module is free software; you can redistribute it and/or
 modify it under the same terms as Perl itself. See perldoc perlartistic.

InternetArchive/future_upload

@@ -1,9 +1,10 @@
 #!/bin/bash -
+# shellcheck disable=SC2317
 #===============================================================================
 #
 #         FILE: future_upload
 #
-#        USAGE: ./future_upload
+#        USAGE: ./future_upload [-h] [-v] [-D] [-d {0|1}] [-F] [-r] [-l cp]
 #
 #  DESCRIPTION: Uploads future HPR shows based on what is in the upload area
 #
@@ -13,9 +14,9 @@
 #        NOTES: Contains methods from 'delete_uploaded' and 'weekly_upload' as
 #               well as 'update_state'
 #       AUTHOR: Dave Morriss (djm), Dave.Morriss@gmail.com
-#      VERSION: 0.0.15
+#      VERSION: 0.0.17
 #      CREATED: 2021-01-07 12:11:02
-#     REVISION: 2024-07-29 23:17:45
+#     REVISION: 2025-01-06 17:51:57
 #
 #===============================================================================
 
@@ -26,7 +27,7 @@ SCRIPT=${0##*/}
 
 STDOUT="/dev/fd/2"
 
-VERSION="0.0.15"
+VERSION="0.0.17"
 
 #
 # Load library functions
@@ -36,7 +37,7 @@ LIB="$HOME/bin/function_lib.sh"
 # shellcheck disable=SC1090
 source "$LIB"
 
-# {{{ -- Functions -- check_uploads, _log, _usage
+# {{{ -- Functions -- check_uploads, update_show_state, _log, _usage
 
 #===  FUNCTION  ================================================================
 #         NAME: check_uploads
@@ -51,13 +52,54 @@ check_uploads () {
     #
     # Look for files called hpr1234.flac and so on. Don't bother with the
     # hpr1234_source.flac one. As soon as a file is missing return with false.
+    # 2025-01-01: Dropped 'spx' from the list
     #
-    for suff in flac mp3 ogg opus spx wav; do
+    for suff in flac mp3 ogg opus wav; do
         if [[ ! -e $UPLOADS/$prefix.$suff ]]; then
             return 1
         fi
     done
 
+    #
+    # Transcripts are (currently) in a sub-directory with the same name as the
+    # IA item. We only cater for two types as of 2025.
+    #
+    for suff in txt srt; do
+        if [[ ! -e $UPLOADS/$prefix/$prefix.$suff ]]; then
+            return 1
+        fi
+    done
+
+    return 0
+}
+
+#===  FUNCTION  ================================================================
+#         NAME: update_show_state
+#  DESCRIPTION: Updates the status of a single show in the HPR database.
+#               It is assumed the caller has found the show number in the
+#               'reservations' table with the required status of
+#               'MEDIA_TRANSCODED'. All this function does is to change this
+#               to 'UPLOADED_TO_IA', returning true if successful, otherwise
+#               false.
+#   PARAMETERS: $show           Show number to update
+#      RETURNS: True if the update worked, otherwise false
+#===============================================================================
+update_show_state () {
+    local show=${1:?Usage: update_state show}
+    local BASECOM URL QUERY COMMAND RES
+
+    BASECOM='curl -K ./.hpradmin_curlrc -s'
+    URL="https://hub.hackerpublicradio.org/cms/status.php"
+    QUERY="${BASECOM} ${URL}"
+
+    COMMAND="${QUERY}?ep_num=${show}&status=UPLOADED_TO_IA"
+
+    $COMMAND
+    RES=$?
+    if [[ $RES -ne 0 ]]; then
+        return 1
+    fi
+
     return 0
 }
 
@@ -72,7 +114,7 @@ check_uploads () {
 #   PARAMETERS: 1 - the message to write
 #      RETURNS: Nothing
 #===============================================================================
-# shellcheck disable=SC2317 disable=SC2059
+# shellcheck disable=SC2059
 _log () {
     local msg="$1"
 
@@ -169,7 +211,7 @@ BASECOM='curl -K ./.hpradmin_curlrc -s'
 URL="https://hub.hackerpublicradio.org/cms/status.php"
 # QUERY1="${BASECOM} ${URL}"
 QUERY2="${BASECOM} -o - ${URL}"
-UPSTATE="$BASEDIR/update_state"
+# UPSTATE="$BASEDIR/update_state"
 
 #
 # Fallback URL
@@ -188,10 +230,10 @@ ia=$(command -v ia)
     echo "Needs the 'make_metadata' script"
     exit 1
 }
-[ -e "$UPSTATE" ] || {
+# [ -e "$UPSTATE" ] || {
-    echo "Needs the 'update_state' script"
+#     echo "Needs the 'update_state' script"
-    exit 1
+#     exit 1
-}
+# }
 
 #
 # File of processed shows
@@ -223,6 +265,9 @@ do
 done
 shift $((OPTIND - 1))
 
+#
+# Check and set option variables
+#
 DRYRUN=${DRYRUN:-1}
 if [[ $DRYRUN -ne 0 && $DRYRUN -ne 1 ]]; then
     echo "** Use '-d 0' or '-d 1'"
@@ -261,6 +306,7 @@ fi
 
 #
 # Declarations
+# ------------
 #
 declare -A processed
 declare -A ready
@@ -271,6 +317,7 @@ lastitem=
 
 #
 # Load array of processed shows
+# ---- ----- -- --------- -----
 #
 while read -r item; do
     processed+=([$item]=1)
@@ -278,46 +325,17 @@ done < "$PROCFILE"
 [ "$VERBOSE" -eq 1 ] && echo "Number of shows in cache: ${#processed[@]}"
 
 #
-# TODO: Create the associative array 'ready' containing the numbers of shows
+# Populate the associative array 'ready' with the numbers of shows ready for
-# ready for upload. This is a way to ensure that we don't try and upload shows
+# upload. This is a way to ensure that we don't try and upload shows in
-# in transit to the upload area.
+# transit to the upload area. Only do this if force mode is off.
 #
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-# Proposed code. Not sure what the actual URL will be nor what will be
-# returned if nothing is ready for upload yet
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-#
-# json=$(curl http://hackerpublicradio.org/queue.php -s -o -)
-# while read -r showno; do
-#     ready+=([$showno]=1)
-# done < <(echo "${json}" | jq '.READY_FOR_IA_UPLOAD[] | tonumber')
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-# Change of plan. Now we have a list of CSV values, so we need to do something
-# like this:
-#
-# reservations=$($BASECOM -o - $URL)
-# while read -r line; do
-#    if [[ $line =~ ^([^,]+),([^,]+),([^,]+),([^,]+),([^,]+),.*$ ]]; then
-#       state="${BASH_REMATCH[5]}"
-#       show="${BASH_REMATCH[2]}"
-#    fi
-#    if [[ $state = 'MEDIA_TRANSCODED' ]]; then
-#       ready+=([$show]=1)
-#    fi
-# done <<< $reservations
-#
-# At the end of this the associative array 'ready' will contain the keys of
-# shows that are ready for upload (presumably) so we can look in this array to
-# double check.
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
 if [[ $FORCE -eq 0 ]]; then
     #
     # Collect the current table of shows requiring work. We expect something like:
     # timestamp_epoc,ep_num,ep_date,key,status,email
     # 1651286617,3617,2022-06-14,fda088e0e3bd5d0353ea6b7569e93b87626ca25976a0a,UPLOADED_TO_IA,lurkingprion@gmail.com
     # 1651648589,3619,2022-06-16,e7d3810afa098863d81663418d8640276272284de68f1,UPLOADED_TO_IA,monochromec@gmail.com
-    # TODO: Check for a failure in the query?A
+    # TODO: Reinstate the check for a failure in the query? Se update_state
     # NOTE: Problem encountered 2022-09-23 because the SSL certificate has expired
     #
     reservations=$($QUERY2) || {
@@ -342,8 +360,8 @@ if [[ $FORCE -eq 0 ]]; then
     fi
 
     #
-    # The query returns the bare number, but we're using 'hprxxxx' as the key in
+    # The query returns the bare show number, but we're using 'hprxxxx' as the
-    # the 'ready' array.
+    # key in the 'ready' array.
     #
     while read -r line; do
         if [[ $line =~ ^([^,]+),([^,]+),([^,]+),([^,]+),([^,]+),.*$ ]]; then
@@ -363,7 +381,10 @@ fi
 
 #
 # Process files. There will be several with the same prefix so look for
-# a change of prefix
+# a change of prefix.
+#
+# The loop is reading from the following pipeline:
+# find "$UPLOADS" -regextype posix-extended -regex '.*hpr[0-9]{4}.*' | sort
 #
 while read -r path; do
     #
@@ -379,8 +400,8 @@ while read -r path; do
     _DEBUG "Item $item"
 
     #
-    # Detect that the item prefix has changed. If it has we're processing
+    # Detect that the item prefix has changed. If it has we've found a new IA
-    # a new IA identifier, so work on this one
+    # identifier, so work on the previous one
     #
     if [[ $item != "$lastitem" ]]; then
         lastitem=$item
@@ -414,7 +435,8 @@ while read -r path; do
                 processed+=([$lastitem]=1)
             else
                 #
-                # Is the show ready for upload?
+                # Is the show ready for upload? We don't check if force mode
+                # is on. If not ready we skip this show.
                 #
                 if [[ $FORCE -eq 0 ]]; then
                     if [[ ! -v "ready[$lastitem]" ]]; then
@@ -461,10 +483,9 @@ while read -r path; do
 
 done < <(find "$UPLOADS" -regextype posix-extended -regex '.*hpr[0-9]{4}.*' | sort)
 
-#
+#-------------------------------------------------------------------------------
 # Write the processed array to the cache file unless in dry-run mode
-#
+#-------------------------------------------------------------------------------
-# [ $DEBUG -eq 1 ] && { echo -n 'D> '; declare -p processed; }
 _DEBUG "processed = ${!processed[*]}"
 [ "$VERBOSE" -eq 1 ] && echo "Number of shows in cache: ${#processed[@]}"
 if [[ $DRYRUN -ne 1 ]]; then
@@ -473,24 +494,26 @@ if [[ $DRYRUN -ne 1 ]]; then
     done < <(printf '%s\n' "${!processed[@]}" | sort -u ) > "$PROCFILE"
 fi
 
-#
+#-------------------------------------------------------------------------------
 # Generate the list of uploads for the 'make_metadata' option '-list=1,2,3'.
+# The show numbers are keys in the associative array 'uploads'. The
+# end-product is a comma-separated list of the keys in the variable '$list'.
 # Order is unimportant because make_metadata sorts internally.
-#
+#-------------------------------------------------------------------------------
 _DEBUG "uploads = ${!uploads[*]}"
 [ "$VERBOSE" -eq 1 ] && echo "Number of shows for upload: ${#uploads[@]}"
 printf -v list '%s,' "${!uploads[@]}"
 list="${list:0:-1}"
 
-#
+#-------------------------------------------------------------------------------
 # If there are no uploads to do we can stop
-#
+#-------------------------------------------------------------------------------
 [[ ! -v uploads[@] ]] && { echo "Nothing to do!"; exit; }
 
-#
+#-------------------------------------------------------------------------------
 # Check that the shows being uploaded have all their files and log what is
 # happening.
-#
+#-------------------------------------------------------------------------------
 while read -r show; do
     echo "$(date +%Y%m%d%H%M%S) preparing to upload hpr$show" >> "$LOGFILE"
 
@@ -501,10 +524,10 @@ while read -r show; do
     fi
 done < <(printf '%s\n' "${!uploads[@]}" | sort)
 
-#
+#-------------------------------------------------------------------------------
 # Define output files. If the list contains one element then it's a different
 # name from the multi-element case (make_metadata does this too).
-#
+#-------------------------------------------------------------------------------
 if [[ ${#uploads[@]} -eq 1 ]]; then
     metadata="metadata_${minshow}.csv"
     script="script_${minshow}.sh"
@@ -513,9 +536,9 @@ else
     script="script_${minshow}-${maxshow}.sh"
 fi
 
-#
+#-------------------------------------------------------------------------------
 # Perform the uploads or report what would be done
-#
+#-------------------------------------------------------------------------------
 if [[ $DRYRUN -eq 1 ]]; then
     echo "Dry run: Would have uploaded list '$list'"
     echo "Dry run: Would have created $metadata and $script"
@@ -562,17 +585,17 @@ else
                 echo "$(date +%Y%m%d%H%M%S) ${#uploads[@]} uploads completed" >> "$LOGFILE"
 
                 #
-                # Update the state in the HPR database, unless we're using
+                # Update the state  of all the shows being processed in the
-                # FORCE. Pass the limit used here to this script so it can
+                # HPR database, unless we're using FORCE.
-                # stop looking for work unnecessarily
                 #
                 if [[ $FORCE -eq 0 ]]; then
-                    $UPSTATE -l$LIMIT
+                    while read -r show; do
-                    RES=$?
+                        if update_show_state $show; then
-                    if [[ $RES -ne 0 ]]; then
+                            echo "Updated state for show $show"
-                        echo "Problem updating database state"
+                        else
-                        exit 1
+                            echo "Failed to update state for show $show"
                         fi
+                    done < <(printf '%s\n' "${!uploads[@]}" | sort)
                 else
                     echo "Not updating the database, FORCE mode is on"
                 fi

InternetArchive/reformat_html

@@ -0,0 +1,245 @@
+#!/usr/bin/env perl
+#===============================================================================
+#
+#         FILE: reformat_html
+#
+#        USAGE: ./reformat_html < input.html > output.html
+#
+#  DESCRIPTION: Reformats the HTML found in the HPR database in the 'notes'
+#               field to the format required in the 'description' field of an
+#               item on the IA. It reads from STDIN and writes to STDOUT.
+#
+#      OPTIONS: ---
+# REQUIREMENTS: ---
+#         BUGS: ---
+#        NOTES: ---
+#       AUTHOR: Dave Morriss (djm), Dave.Morriss@gmail.com
+#      VERSION: 0.0.1
+#      CREATED: 2025-02-09 22:56:30
+#     REVISION: 2025-02-13 11:13:37
+#
+#===============================================================================
+
+use v5.36;
+use strict;
+use warnings;
+use feature qw{ say try };
+no warnings qw{ experimental::try };
+
+use open ':std', ':encoding(UTF-8)'; # Make all IO UTF-8
+
+use HTML::TreeBuilder 5 -weak;
+use HTML::Entities;
+
+#
+# Version number (Incremented by Vim)
+#
+our $VERSION = '0.0.1';
+
+#
+# Declarations
+#
+my ($verbose, @notes, $notes, $tree);
+
+#
+# Read the input data into an array
+#
+try {
+    @notes = <STDIN>;
+}
+catch ($e) {
+    warn "Problem reading input HTML; $e";
+    exit 1;
+}
+
+die "No input HTML detected\n" unless @notes;
+
+#
+# Turn the array into a scalar
+#
+$notes = join( '', @notes );
+
+#
+# Get ready to parse the array
+#
+$tree = HTML::TreeBuilder->new;
+$tree->ignore_unknown(0);
+$tree->no_expand_entities(1);
+$tree->p_strict(1);
+$tree->store_comments(1);               # Necessary?
+$tree->warn(1);
+
+#
+# Parse HTML to the tree structure
+#
+$tree->parse_content($notes)
+    or die "HTML::TreeBuilder failed to parse input HTML: $!\n";
+
+#
+# Flatten all <pre> tags and add <br/> tags
+#
+$notes = flatten_pre($tree);
+
+#
+# Deal with non-ASCII
+#
+$notes = encode_entities( $notes, '^\n&\x20-\x25\x27-\x7e' );
+
+#
+# Remove all newlines
+#
+$notes =~ s/\n//g;
+
+#
+# Write the end result to the STDOUT
+#
+say $notes;
+
+exit;
+
+#===  FUNCTION  ================================================================
+#         NAME: flatten_pre
+#      PURPOSE: Process notes "flattening" <pre> contents
+#   PARAMETERS: $tree   HTML::TreeBuilder object containing parsed and
+#                       partially processed notes
+#      RETURNS: Processed notes
+#  DESCRIPTION: The HTML "<pre>" tag encloses preformatted text. It can also
+#               contain some formatting tags like <em> and <code>, but spaces
+#               and newlines are significant. The Internet Archive upload API
+#               uses HTTP headers which are text strings without newlines, so
+#               when these tags are uploaded through this route some
+#               formatting is lost. What this routine does is parse the
+#               contents of all <pre> sections in $notes, adding <br/> tags
+#               to replace newlines. It has to perform a full parse
+#               since the contents may include HTML tags and these need to be
+#               passed through intact. It calls the subroutine 'flatten_item' to
+#               deal with the recursive nature of HTML tags.
+#       THROWS: No exceptions
+#     COMMENTS: None
+#     SEE ALSO: N/A
+#===============================================================================
+sub flatten_pre {
+    my ($tree) = @_;
+
+    #
+    # Find all the <pre> tags
+    #
+    my @pre_tags = $tree->look_down( _tag => 'pre', );
+
+    #
+    # Walk the various <pre> elements in the document
+    #
+    foreach my $tag (@pre_tags) {
+        #
+        # Save the tag and empty the original
+        #
+        my $saved = $tag->clone();
+        $tag->delete_content();
+
+        #
+        # Walk the saved content and rebuild the tag into $atag using the
+        # nested arrayref structure permitted by HTML::Element for
+        # convenience (the alternative is a little nasty). See the
+        # documentation for 'new_from_lol' in HTML::Element.
+        #
+        my $atag;
+        foreach my $item ( @{ $saved->content_array_ref } ) {
+            push( @$atag, flatten_item($item) );
+        }
+
+        #
+        # Rebuild the tag from the arrayref we built. We treat the arrayref
+        # structure we just built as an array because otherwise the top level
+        # is interpreted as a spurious <null> tag.
+        #
+        $tag->push_content(@$atag);
+    }
+
+    #
+    # Trim out the original notes from the enclosing tags we added earlier
+    #
+    my $body = $tree->look_down( _tag => 'body' );
+    ( my $result = $body->as_HTML( undef, ' ', {} ) )
+        =~ s{(^<body[^>]*>|</body>$)}{}gi;
+
+    return $result;
+
+}
+
+#===  FUNCTION  ================================================================
+#         NAME: flatten_item
+#      PURPOSE: Recursively "flatten" items within the enclosing <pre>
+#   PARAMETERS: $item   an HTML::Element item parsed from the original
+#                       <pre> section
+#      RETURNS: An arrayref if the last seen item was a tag, otherwise a list
+#  DESCRIPTION: Since <pre> sections can contain inline elements which change
+#               the rendering of the text we need to parse these as we add
+#               <br/> tags. This routine does this by recursively descending
+#               through the contents. A common tag sequence is <pre><code> for
+#               scripts and the like. This routine deals with such sequences.
+#               It expects to receive the contents in sequence and builds the
+#               result as a nested arrayref structure.
+#       THROWS: No exceptions
+#     COMMENTS: None
+#     SEE ALSO: N/A
+#===============================================================================
+sub flatten_item {
+    my ($item) = @_;
+
+    return unless defined($item);
+
+    my ( @result, %attr );
+
+    #
+    # Is it a sub-tag or non-tag content?
+    #
+    if ( ref($item) ) {
+        #
+        # It's a tag. Save the tag name and any attributes and recurse into
+        # it. Return an arrayref
+        #
+        push( @result, $item->tag() );
+        %attr = $item->all_external_attr();
+        push( @result, \%attr ) if %attr;
+        for my $child ( $item->content_list() ) {
+            push( @result, flatten_item($child) );
+        }
+        return \@result;
+    }
+    else {
+        #
+        # It's non-tag content. Join the lines with <br/> tags.  Return an
+        # array (since this is a simple list).
+        #
+        # Note that we split with a LIMIT of -1 which causes any trailing list
+        # items to be returned; default behaviour is to drop them.
+        #
+        $item =~ s/\r//g;
+        my @content = split( /\n/, $item, -1 );
+        if (@content) {
+            #
+            # Remove a leading blank line - usually the result of
+            # a "<pre>'NL'text" sequence
+            #
+            shift(@content) if ( $content[0] =~ /^\s*$/ );
+
+            #
+            # Join back the lines with <br/> tags between them.
+            #
+            foreach my $txt (@content) {
+                push( @result, $txt, ['br'] );
+            }
+
+            #
+            # Remove the <br/> at the end, it's spurious
+            #
+            pop(@result);
+        }
+
+        return (@result);
+    }
+
+}
+
+# vim: syntax=perl:ts=8:sw=4:et:ai:tw=78:fo=tcrqn21:fdm=marker
+

InternetArchive/tidy_uploaded

@@ -6,7 +6,7 @@
 #        USAGE: ./tidy_uploaded [-h] [-v] [-d {0|1}] [-c COUNT]
 #
 #  DESCRIPTION: Relocates HPR audio and other show-related files on 'borg'
-#               after their shows have been uploaded to the Internet Archive
+#               after their shows have been uploaded to the Internet Archive.
 #
 #      OPTIONS: ---
 # REQUIREMENTS: ---
@@ -43,7 +43,7 @@ TMP1=$(mktemp) || { echo "$SCRIPT: creation of temporary file failed!"; exit 1;
 trap 'cleanup_temp $TMP1' SIGHUP SIGINT SIGPIPE SIGTERM EXIT
 
 #
-# Configure depending whether local or on the VPS
+# Configure depending whether local or on 'borg'
 #
 case $HOSTNAME in
     borg)       BASEDIR="$HOME/InternetArchive"
@@ -95,7 +95,7 @@ queued_tasks () {
 #         NAME: movefile
 #  DESCRIPTION: Moves a file to a new place, catering for any directories in
 #               the path
-#   PARAMETERS: $1      directory to move form
+#   PARAMETERS: $1      directory to move from
 #               $2      directory to move to
 #               $3      file (or sub-path to move)
 #      RETURNS: True if a move was done, otherwise False
@@ -356,7 +356,7 @@ while read -r path; do
         #
         tasks=$(queued_tasks "$item")
         if [[ $tasks -gt 0 ]]; then
-            echo "** Item $item still has $tasks unfinished " \
+            echo "** Item $item still has $tasks unfinished" \
                 "$(ngettext task tasks "$tasks")"
             echo "** Skipping to the next item"
             continue
@@ -434,9 +434,6 @@ while read -r path; do
 
 done < <(find "$UPLOADS" -regextype posix-extended -regex '.*hpr[0-9]{4}.*' -printf "%CY%Cm%Cd%CH%CM%CS %p\n" | sort  | cut -f2 -d' ')
 
-# Old 'find' used:
-# done < <(find "$UPLOADS" -regextype posix-extended -regex '.*hpr[0-9]{4}.*' | sort)
-
 #
 # No shows processed? There was nothing to do
 #

InternetArchive/update_state

@@ -3,7 +3,7 @@
 #
 #         FILE: update_state
 #
-#        USAGE: ./update_state
+#        USAGE: ./update_state [-h] [-D] [-d] [-F] [-l N] [-m]
 #
 #  DESCRIPTION: A script to update the state of shows which have been sent to
 #               the IA. It looks at the current state of the 'reservations'
@@ -136,7 +136,6 @@ esac
 
 cd "$BASEDIR" || { echo "Can't cd to $BASEDIR"; exit 1; }
 
-
 #
 # Tools
 #

Show_Submission/extract_images

@@ -0,0 +1,739 @@
+#!/usr/bin/env perl
+#===============================================================================
+#
+#         FILE: extract_images
+#
+#        USAGE: ./extract_images [--help] [--documentation|man]
+#               [--prefix=STRING] [--[no-]backup] [--force] [--[no]silent]
+#               HTML_file [ [HTML_file_2] [HTML_file_3] ... ]
+#
+#  DESCRIPTION: Processes HTML files which may have 'data' scheme URIs containing
+#               images, and extracts these images into files in the same
+#               directory.  The 'data' scheme links are converted to 'https'
+#               and reference the extracted files. The modified HTML is
+#               output, and the original will be saved as a backup if
+#               requested.
+#
+#               The 'data' URI scheme is specified in RFC 2397.
+#
+#      OPTIONS: ---
+# REQUIREMENTS: ---
+#         BUGS: ---
+#        NOTES: ---
+#       AUTHOR: Dave Morriss (djm), Dave.Morriss@gmail.com
+#      VERSION: 0.0.3
+#      CREATED: 2024-12-25 10:53:15
+#     REVISION: 2024-12-31 20:56:50
+#
+#===============================================================================
+
+use v5.36;
+use strict;
+use warnings;
+use feature qw{ say state try };
+no warnings qw{ experimental::try };
+
+use open ':std', ':encoding(UTF-8)'; # Make all IO UTF-8
+
+use Getopt::Long;
+use Pod::Usage;
+
+use HTML::TreeBuilder 5 -weak;
+use URI;
+use MIME::Types;
+
+use Path::Tiny;
+use File::Copy;
+
+use Data::Dumper;
+
+#
+# Version number (Incremented by Vim)
+#
+our $VERSION = '0.0.3';
+
+#
+# Script and directory names
+#
+( my $PROG = $0 ) =~ s|.*/||mx;
+
+#-------------------------------------------------------------------------------
+# Declarations
+#-------------------------------------------------------------------------------
+my ( $notes,   $typename, $uri );
+my ( $fcount,  $basename, $filename, $suffix, $fh );
+my ( $updates, $bsuffix,  $newURL );
+
+my $backupcount = 5;
+
+#-------------------------------------------------------------------------------
+# Options and arguments
+#-------------------------------------------------------------------------------
+# {{{
+#
+# Option defaults
+#
+my $DEFDEBUG = 0;
+my $DEFPREFIX = 'image';
+
+my %options;
+Options( \%options );
+
+#
+# Default help shows minimal information
+#
+pod2usage( -msg => "$PROG version $VERSION\n", -exitval => 1, -verbose => 0 )
+    if ( $options{'help'} );
+
+#
+# The -documentation or -man option shows the full POD documentation through
+# a pager for convenience
+#
+pod2usage( -msg => "$PROG version $VERSION\n", -exitval => 1, -verbose => 2 )
+    if ( $options{'documentation'} );
+
+#
+# Collect options
+#
+my $DEBUG  = ( defined( $options{debug} )  ? $options{debug}  : $DEFDEBUG );
+my $silent = ( defined( $options{silent} ) ? $options{silent} : 0 );
+my $prefix = ( defined( $options{prefix} ) ? $options{prefix} : $DEFPREFIX );
+my $backup = ( defined( $options{backup} ) ? $options{backup} : 1 );
+my $force  = ( defined( $options{force} )  ? $options{force}  : 0 );
+
+#
+# Check we have arguments
+#
+pod2usage(
+    -msg     => "Missing arguments. One or more HTML file names are needed\n",
+    -exitval => 1,
+    -verbose => 0
+    )
+unless ( scalar(@ARGV) > 0 );
+
+#
+# Clean up the prefix
+#
+$prefix = ($prefix =~ /(.*)_$/ ? $1 : $prefix);
+
+#
+# Backup suffix (the dot gets added later)
+#
+$bsuffix = 'bak';
+
+#
+# Debug the options
+#
+_debug(
+    $DEBUG > 1,
+    '$silent = ' . $silent,
+    '$prefix = ' . $prefix,
+    '$backup = ' . $backup,
+    '$force = ' . $force,
+);
+
+# }}}
+
+#-------------------------------------------------------------------------------
+# Prepare a MIME::Types object
+#-------------------------------------------------------------------------------
+my $mt = MIME::Types->new;
+
+#-------------------------------------------------------------------------------
+# Loop through the arguments
+#-------------------------------------------------------------------------------
+foreach my $notesfile (@ARGV) {
+
+    #
+    # Get the absolute path of the argument
+    #
+    my $abs_nf = path($notesfile)->absolute;
+
+    #
+    # Get the 'dirname' from the absolute path
+    #
+    my $dirname = path($abs_nf)->parent->stringify;
+
+    unless (-e $abs_nf) {
+        warn "Unable to find $notesfile\n";
+        next;
+    }
+
+    #
+    # Force the MIME type of $notesfile to a string
+    #
+    $typename = "" . coalesce( $mt->mimeTypeOf("$abs_nf"), '' );
+
+    #
+    # Check the MIME type and reject non-HTML
+    #
+    unless ($typename eq 'text/html') {
+        warn "File $abs_nf is not HTML\n";
+        next
+    }
+
+    say "Reading from $abs_nf\n" unless $silent;
+
+    #
+    # Get HTML file basename (no path) without the suffix for building filenames
+    #
+    $basename = path($abs_nf)->basename('.html');
+
+    #
+    # Read the HTML
+    #
+    open (my $nfh, '<', $notesfile) or die "Unable to open $notesfile\n";
+    $notes = <$nfh>;
+    close($nfh);
+
+    #
+    # Image files are to have an index/sequence number
+    #
+    $fcount = 0;
+
+    #
+    # Keep a note of HTML updates
+    #
+    $updates = 0;
+
+    #
+    # Initialise the TreeBuilder
+    #
+    my $tree = HTML::TreeBuilder->new;
+    $tree->ignore_unknown(0);
+    $tree->no_expand_entities(1);
+    $tree->p_strict(1);
+    $tree->store_comments(1);
+    $tree->warn(1);
+
+    #
+    # Load the HTML obtained from the file into the TreeBuilder
+    #
+    $tree->parse_content($notes)
+        or die "HTML::TreeBuilder failed to parse notes: $!\n";
+
+    #
+    # Loop through the tree looking for 'data' scheme images
+    #
+    for ( @{ $tree->extract_links('img') } ) {
+        my ( $link, $element, $attr, $tag ) = @$_;
+
+        $uri = URI->new($link);
+        unless ($silent) {
+            say "Scheme: ",     $uri->scheme;
+            say "Media type: ", $uri->media_type;
+        }
+
+        #
+        # We only care about 'data' scheme stuff - for now anyway, and only
+        # images within this set
+        #
+        if ( $uri->scheme eq 'data' ) {
+            #
+            # Only images
+            #
+            if ( $uri->media_type =~ /^image/ ) {
+              #
+              # Extract the file name suffix from the MIME string, and give it
+              # a leading '.'
+              #
+                ( $suffix = $uri->media_type ) =~ s{^.*/}{.};
+
+                #
+                # Construct the filename for this image making sure it's in
+                # the directory where the HTML is located.
+                #
+                # ${fileprefix}_${prefix}_${increment}.${extension}
+                #
+                $fcount++;
+                $filename
+                    = "$dirname/${basename}_${prefix}_${fcount}${suffix}";
+                say "Writing to: $filename" unless $silent;
+
+                say '-' x 40 unless $silent;
+
+                #
+                # If the file exists and --force is not active, warn and skip.
+                # Otherwise write the file.
+                #
+                if ( -e $filename && !$force ) {
+                    warn "File $filename exists; not overwriting\n";
+                }
+                else {
+                    #
+                    # Write the data to the file in binary format. The URI
+                    # module does the conversion so it's already binary.
+                    #
+                    $fh = path($filename)->openw_raw;
+                    print $fh $uri->data;
+                    close($fh);
+                }
+
+                #
+                # Update the HTML with a link to the file we created (or that
+                # was already there from an earlier time).
+                #
+                $updates++;
+                $newURL = path($filename)->basename;
+                $element->attr( $attr, $newURL );
+            }
+        }
+
+    }    # extract_links loop
+
+    #
+    # Output the changed HTML turning what became standalone back into
+    # a <body> fragment.
+    #
+    if ($updates > 0) {
+        my $body = $tree->look_down( _tag => 'body' );
+        ( my $result = $body->as_HTML( undef, ' ', {} ) )
+            =~ s{(^<body[^>]*>|</body>$)}{}gi;
+
+        #$notesfile = path($notesfile)->basename;
+        if ($backup) {
+            if (_backup( $abs_nf, $bsuffix, $backupcount )) {
+                say "$notesfile backed up" unless $silent;
+            }
+        }
+        else {
+            say "$notesfile not backed up" unless $silent;
+        }
+
+        $fh = path($notesfile)->openw;
+        say $fh $result;
+        close($fh);
+
+        say "$updates images converted, $notesfile updated" unless $silent;
+    }
+    else {
+        say "No images found, no changes made to $notesfile" unless $silent;
+    }
+
+} # $notesfile loop
+
+exit;
+
+#===  FUNCTION  ================================================================
+#         NAME: _backup
+#      PURPOSE: Given a file, make a backup of it by appending $suffix, and
+#               handle previous backups
+#   PARAMETERS: $filename               path of file to backup
+#               $suffix                 suffix to use, default 'bck'
+#               $limit                  number of backups to keep
+#      RETURNS: True or false depending on success
+#  DESCRIPTION: Checks that the file exists and returns FALSE if it doesn't.
+#               Rationalises the $limit to avoid it being 0 or less.
+#       THROWS: No exceptions
+#     COMMENTS: None
+#     SEE ALSO: N/A
+#===============================================================================
+sub _backup {
+    my ( $filename, $suffix, $limit ) = @_;
+
+    my ( $backupname, $limitname );
+
+    #
+    # Check the target file exists
+    #
+    unless ( -e $filename ) {
+        warn "Unable to find $filename to backup\n";
+        return 0;
+    }
+
+    #
+    # Handle invalid $limit values
+    #
+    $limit = 1 unless ( $limit >= 1 );
+
+    #
+    # Defaults
+    #
+    $suffix     = 'bck' unless $suffix;
+    $limitname  = "$filename.$suffix.$limit";
+    $backupname = "$filename.$suffix";
+
+    #
+    # Look for existing backups
+    #
+    if ( -e $backupname ) {
+
+        #
+        # If maximum version exists delete it
+        #
+        if ( -e $limitname ) {
+            unlink($limitname);
+        }
+
+        #
+        # Go backwards through the versions incrementing their version numbers
+        #
+        for ( my $vsn = $limit - 1; $vsn > 0; $vsn-- ) {
+            if ( -e "$filename.$suffix.$vsn" ) {
+                move( "$filename.$suffix.$vsn",
+                    sprintf( '%s.%s.%s', $filename, $suffix, $vsn + 1 ) );
+            }
+        }
+
+        #
+        # Make $filename.bck into $filename.bck.1
+        #
+        move( "$filename.$suffix", "$filename.$suffix.1" );
+
+    }
+
+    #
+    # Finally save the $filename as $filename.bck
+    #
+    move( $filename, "$filename.$suffix" );
+
+    return 1;
+}
+
+#===  FUNCTION  ================================================================
+#         NAME: coalesce
+#      PURPOSE: To find the first defined argument and return it
+#   PARAMETERS: Arbitrary number of arguments
+#      RETURNS: The first defined argument or undef if there are none
+#  DESCRIPTION: Just a simple way of ensuring an 'undef' value is never
+#               returned when doing so might be a problem.
+#       THROWS: No exceptions
+#     COMMENTS: None
+#     SEE ALSO: N/A
+#===============================================================================
+sub coalesce {
+    foreach (@_) {
+        return $_ if defined($_);
+    }
+    return undef;    ## no critic
+}
+
+#===  FUNCTION  ================================================================
+#         NAME: _debug
+#      PURPOSE: Prints debug reports
+#   PARAMETERS: $active         Boolean: 1 for print, 0 for no print
+#               $messages...    Arbitrary list of messages to print
+#      RETURNS: Nothing
+#  DESCRIPTION: Outputs messages if $active is true. It removes any trailing
+#               newline from each one and then adds one in the 'print' to the
+#               caller doesn't have to bother. Prepends each message with 'D>'
+#               to show it's a debug message.
+#       THROWS: No exceptions
+#     COMMENTS: Differs from other functions of the same name
+#     SEE ALSO: N/A
+#===============================================================================
+sub _debug {
+    my $active = shift;
+
+    my $message;
+    return unless $active;
+
+    while ($message = shift) {
+        chomp($message);
+        print STDERR "D> $message\n";
+    }
+}
+
+#===  FUNCTION  ================================================================
+#         NAME: Options
+#      PURPOSE: Processes command-line options
+#   PARAMETERS: $optref     Hash reference to hold the options
+#      RETURNS: Undef
+#  DESCRIPTION: Process the options we want to offer. See the documentation
+#               for details
+#       THROWS: no exceptions
+#     COMMENTS: none
+#     SEE ALSO: n/a
+#===============================================================================
+sub Options {
+    my ($optref) = @_;
+
+    my @options = (
+        "help",     "documentation|man", "debug=i", "silent!",
+        "prefix=s", "backup!",           "force!",
+        # "config=s",
+    );
+
+    if ( !GetOptions( $optref, @options ) ) {
+        pod2usage(
+            -msg     => "$PROG version $VERSION\n",
+            -exitval => 1,
+            -verbose => 0
+        );
+    }
+
+    return;
+}
+
+__END__
+
+#%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+#  Application Documentation
+#%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+#{{{
+
+=head1 NAME
+
+extract_images - extract embedded images from HTML and save as files
+
+=head1 VERSION
+
+This documentation refers to extract_images version 0.0.3
+
+=head1 USAGE
+
+    extract_images
+        [--help] [--documentation|man] [-debug=N]
+        [--prefix=STRING] [--[no]backup] [--[no]force] [--[no]silent]
+        HTML_file [ [HTML_file_2] [ [HTML_file_3] ... ] ]
+
+    Examples:
+
+    extract_images --prefix=picture_ --backup index.html
+
+    extract_images --silent --nobackup shownotes.html
+
+=head1 REQUIRED ARGUMENTS
+
+The script requires the names of one or more HTML files which will be scanned
+for embedded images.
+
+=head1 OPTIONS
+
+Note that all on/off options can be written as B<--silent>, B<--nosilent> or
+B<--no-silent>. A single hyphen can be used at the start or a pair.
+
+=over 8
+
+=item B<--help>
+
+Reports brief information about how to use the script and exits. To see the
+full documentation use the option B<--documentation> or B<--man>. Alternatively,
+to generate a PDF version use the I<pod2pdf> tool from
+I<http://search.cpan.org/~jonallen/pod2pdf-0.42/bin/pod2pdf>. This can be
+installed with the cpan tool as App::pod2pdf.
+
+=item B<--documentation> or B<--man>
+
+Reports full information about how to use the script and exits. Alternatively,
+to generate a PDF version use the I<pod2pdf> tool from
+I<http://search.cpan.org/~jonallen/pod2pdf-0.42/bin/pod2pdf>. This can be
+installed with the cpan tool as App::pod2pdf.
+
+=item B<--debug=N>
+
+Run in debug mode at the level specified by I<N>. Possible values are:
+
+=over 4
+
+=item B<0>
+
+No debugging (the default).
+
+=item B<1>
+
+TBA
+
+=item B<2>
+
+Displays the internal variables used to store the options.
+
+=item B<3>
+
+TBA
+
+=back
+
+=item B<--prefix=STRING>
+
+Since embedded images have no names, when they are written to image files
+names are generated for them. These names are built from the following
+components:
+
+=over 4
+
+=item B<HTML filename>
+
+The name of the HTML file without a suffix. So, if the name is 'index.html',
+the 'index' part will be used.
+
+=item B<prefix>
+
+The prefix string provided by this option, or 'image' if not specified.
+
+=item B<counter>
+
+The images found in the HTML are counted, starting from 1, and this number is
+used here.
+
+=item B<extension>
+
+The image format extension, taken from the embedded image information.
+Examples would be 'jpg', 'jpeg' and 'png'.
+
+=back
+
+The B<HTML filename>, B<prefix>, B<counter> and B<extension> are joined
+together to make the file name as follows:
+
+    <HTML filename>_<prefix>_<counter>.<extension>
+
+So the following run of the script would generate the first file shown below
+assuming the first embedded picture was in 'PNG' format:
+
+    extract_images --prefix=picture hpr4283.html
+
+    hpr4283_picture_1.png
+
+=item B<--[no]backup>
+
+The HTML is modified to leave placeholders referring to any embedded images
+found as it it processed. The new HTML is written to the original file if
+B<--nobackup> is specified, or a backup of the original file is made, before
+writing the new HTML. Making a backup is the default behaviour.
+
+=item B<--[no]force>
+
+Images are written to the current directory. If an image already exists, and
+B<--force> has not been specified, the script will stop processing and exit.
+The default setting of this option is B<--noforce>.
+
+=item B<--[no]silent>
+
+By default the script reports its progress as it processes an HTML file, but
+this can be turned off by using this option.
+
+=back
+
+=head1 DESCRIPTION
+
+This Perl script B<extract_images> parses HTML looking for embedded images.
+Such images use a URI with the scheme 'data' followed by image details
+including the encoded binary contents. See the Wikipedia article
+https://en.wikipedia.org/wiki/Data_URI_scheme for details.
+
+When such images are found they are written as files (with generated names),
+and the HTML is updated with these names replacing the original URI. Further
+work is likely to be required to build full image links, but the majority of
+work will have been done.
+
+The script will not overwrite image files unless the B<--force> option is
+used, but will overwrite the original HTML file unless B<--backup> is
+specified.
+
+By default details of progress are written to standard output, but this can be
+preveneted by using the B<--silent> option.
+
+=head2 GENERATED IMAGE FILE NAMES
+
+These names are built from various elements:
+
+    <HTML filename>_<prefix>_<counter>.<extension>
+
+Where <HTML filename> is the base name of the HTML input file, <prefix> is the
+string provided with the B<--prefix=STRING> option (or B<image> by default),
+<counter> is a count of image files found during the scan of the HTML, and
+<extension> is the appropriate file extension for the type of image being
+converted.
+
+See the option B<--prefix=STRING> for details of file name generation.
+
+=head1 DIAGNOSTICS
+
+=over 4
+
+=item B<Unable to find ...>
+
+Type: warning
+
+The script is attempting to find a file presented to it as an argument, but
+cannot. It will skip to the next argument and continue.
+
+=item B<File ... is not HTML>
+
+Type: warning
+
+The script is checking files presented to it as arguments. The named file has
+been checked to see if it contains HTML, and it appears it does not.  It will
+skip to the next argument and continue.
+
+=item B<Unable to open ...>
+
+Type: fatal
+
+The script is attempting to open a file presented to it as an argument. Its
+existence has already been checked but it cannot be opened, possibly due to
+a permissions issue.
+
+=item B<HTML::TreeBuilder failed to parse notes: ...>
+
+Type: fatal
+
+The script has attempted to parse the HTML in a file presented to it. This has
+failed. The error message includes a report from the module used to do this.
+
+=item B<File ... exists; not overwriting>
+
+Type: warning
+
+The script is attempting to write an image file copied from the HTML, but has
+found it already exists. Using the option B<--force> would cause it to be
+overwritten, but this option is not enabled.
+
+The script will not write the file, however, it will still modify the HTML to
+reference the existing image file.
+
+=item B<Unable to find ... to backup>
+
+Type: warning
+
+The script is attempting to make a backup of one of the HTML file arguments,
+but is unable to find it. Since this is a rather unusual circumstance (has the
+file been deleted?), it is assumed it can be regenerated if needed, so the
+writing of the modified HTML is continued.
+
+=head1 CONFIGURATION AND ENVIRONMENT
+
+TBA
+
+=head1 DEPENDENCIES
+
+    Data::Dumper
+    File::Copy
+    Getopt::Long
+    HTML::TreeBuilder
+    MIME::Types
+    Path::Tiny
+    Pod::Usage
+    URI
+
+=head1 BUGS AND LIMITATIONS
+
+There are no known bugs in this module.
+Please report problems to Dave Morriss (Dave.Morriss@gmail.com)
+Patches are welcome.
+
+=head1 AUTHOR
+
+Dave Morriss  (Dave.Morriss@gmail.com)
+
+=head1 LICENCE AND COPYRIGHT
+
+Copyright (c) 2024 Dave Morriss (Dave.Morriss@gmail.com).
+All rights reserved.
+
+This module is free software; you can redistribute it and/or
+modify it under the same terms as Perl itself. See perldoc perlartistic.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+
+=cut
+
+#}}}
+
+# [zo to open fold, zc to close]
+
+# vim: syntax=perl:ts=8:sw=4:et:ai:tw=78:fo=tcrqn21:fdm=marker
+

Show_Submission/parse_JSON

@@ -361,7 +361,8 @@ try {
     $content = decode_json($json_text);
 }
 catch ($e) {
-    die colored( "Failed to decode the JSON in $infile", 'red' ) . "\n"
+    warn colored( "Failed to decode the JSON in $infile", 'red' ) . "\n";
+    die "Error was: $e\n";
 }
 
 $log->info( $showno, "[$VERSION] Processing $infile" );

Show_Submission/query2csv

@@ -1 +0,0 @@
-/home/cendjm/HPR/Database/query2csv

Show_Submission/query2csv

@@ -0,0 +1,137 @@
+#!/usr/bin/env perl
+#===============================================================================
+#
+#         FILE: query2csv
+#
+#        USAGE: ./query2csv query
+#
+#  DESCRIPTION: Runs a query given as the only argument. Caution is needed
+#               since *any* query will be run. The result of the query is
+#               output in CSV form on STDOUT. The CSV is always quoted to
+#               cater for the more simplistic consumers.
+#
+#      OPTIONS: ---
+# REQUIREMENTS: ---
+#         BUGS: ---
+#        NOTES: Had to revert to MySQL because of a problem with DBD::MariaDB
+#       AUTHOR: Dave Morriss (djm), Dave.Morriss@gmail.com
+#      VERSION: 0.0.2
+#      CREATED: 2015-07-11 15:53:01
+#     REVISION: 2022-02-16 23:17:16
+#
+#===============================================================================
+
+use 5.010;
+use strict;
+use warnings;
+use utf8;
+
+use Config::General;
+use Text::CSV_XS;
+use DBI;
+
+use Data::Dumper;
+
+#
+# Version number (manually incremented)
+#
+our $VERSION = '0.0.2';
+
+#
+# Script and directory names
+#
+( my $PROG = $0 ) =~ s|.*/||mx;
+( my $DIR  = $0 ) =~ s|/?[^/]*$||mx;
+$DIR = '.' unless $DIR;
+
+#-------------------------------------------------------------------------------
+# Declarations
+#-------------------------------------------------------------------------------
+#
+# Constants and other declarations
+#
+my $basedir    = "$ENV{HOME}/HPR/Database";
+my $configfile = "$basedir/.hpr_livedb.cfg";
+
+my ( $dbh, $sth1, $aref1 );
+my ( $query, $csv );
+
+#
+# Enable Unicode mode
+#
+binmode STDOUT, ":encoding(UTF-8)";
+binmode STDERR, ":encoding(UTF-8)";
+
+#
+# Load database configuration data
+#
+my $conf = Config::General->new(
+    -ConfigFile      => $configfile,
+    -InterPolateVars => 1,
+    -ExtendedAccess  => 1
+);
+my %config = $conf->getall();
+
+#-------------------------------------------------------------------------------
+# Options and arguments
+#-------------------------------------------------------------------------------
+$query = shift;
+die "Usage: $PROG query\n" unless $query;
+
+#-------------------------------------------------------------------------------
+# Connect to the database
+#-------------------------------------------------------------------------------
+my $dbhost = $config{database}->{host} // '127.0.0.1';
+my $dbport = $config{database}->{port} // 3306;
+my $dbname = $config{database}->{name};
+my $dbuser = $config{database}->{user};
+my $dbpwd  = $config{database}->{password};
+#$dbh = DBI->connect( "DBI:MariaDB:host=$dbhost;port=$dbport;database=$dbname",
+#    $dbuser, $dbpwd, { AutoCommit => 1 } )
+#    or die $DBI::errstr;
+
+$dbh = DBI->connect( "dbi:mysql:host=$dbhost;port=$dbport;database=$dbname",
+    $dbuser, $dbpwd, { AutoCommit => 1 } )
+    or die $DBI::errstr;
+
+#
+# Enable client-side UTF8
+#
+$dbh->{mysql_enable_utf8} = 1;
+
+#
+# Set up the query
+#
+$sth1 = $dbh->prepare($query) or die $DBI::errstr;
+if ( $dbh->err ) {
+    warn $dbh->errstr;
+}
+
+#
+# Perform the query
+#
+$sth1->execute;
+if ( $dbh->err ) {
+    warn $dbh->errstr;
+}
+
+#
+# Prepare to make CSV. Not sure if always quoting is the best idea though
+#
+$csv = Text::CSV_XS->new(
+#    { always_quote => 1 }
+);
+
+#
+# Loop through the returned rows making and printing CSV. Each row is returned
+# as an arrayref to make it easy to join everything.
+#
+while ( $aref1 = $sth1->fetchrow_arrayref ) {
+    $csv->combine(@$aref1);
+    print $csv->string(), "\n";
+}
+
+exit;
+
+# vim: syntax=perl:ts=8:sw=4:et:ai:tw=78:fo=tcrqn21:fdm=marker
+

Show_Submission/query2json

@@ -1 +0,0 @@
-/home/cendjm/HPR/Database/query2json

Show_Submission/query2json

@@ -0,0 +1,134 @@
+#!/usr/bin/env perl
+#===============================================================================
+#
+#         FILE: query2json
+#
+#        USAGE: ./query2json query
+#
+#  DESCRIPTION: Runs a query given as the only argument. Caution is needed
+#               since *any* query will be run. The result of the query is
+#               output in JSON form on STDOUT.
+#
+#      OPTIONS: ---
+# REQUIREMENTS: ---
+#         BUGS: ---
+#        NOTES: Had to revert to MySQL because of a problem with DBD::MariaDB
+#       AUTHOR: Dave Morriss (djm), Dave.Morriss@gmail.com
+#      VERSION: 0.0.2
+#      CREATED: 2021-06-18 13:24:49
+#     REVISION: 2023-01-05 16:17:24
+#
+#===============================================================================
+
+use 5.010;
+use strict;
+use warnings;
+use utf8;
+
+use Config::General;
+use JSON;
+use DBI;
+
+use Data::Dumper;
+
+#
+# Version number (manually incremented)
+#
+our $VERSION = '0.0.2';
+
+#
+# Script and directory names
+#
+( my $PROG = $0 ) =~ s|.*/||mx;
+( my $DIR  = $0 ) =~ s|/?[^/]*$||mx;
+$DIR = '.' unless $DIR;
+
+#-------------------------------------------------------------------------------
+# Declarations
+#-------------------------------------------------------------------------------
+#
+# Constants and other declarations
+#
+my $basedir    = "$ENV{HOME}/HPR/Database";
+my $configfile = "$basedir/.hpr_livedb.cfg";
+
+my ( $dbh, $sth1, $aref1 );
+my ( $query, $result, $json );
+
+#
+# Enable Unicode mode
+#
+binmode STDOUT, ":encoding(UTF-8)";
+binmode STDERR, ":encoding(UTF-8)";
+
+#
+# Load database configuration data
+#
+my $conf = Config::General->new(
+    -ConfigFile      => $configfile,
+    -InterPolateVars => 1,
+    -ExtendedAccess  => 1
+);
+my %config = $conf->getall();
+
+#-------------------------------------------------------------------------------
+# Options and arguments
+#-------------------------------------------------------------------------------
+$query = shift;
+die "Usage: $PROG query\n" unless $query;
+
+#-------------------------------------------------------------------------------
+# Connect to the database
+#-------------------------------------------------------------------------------
+my $dbhost = $config{database}->{host} // '127.0.0.1';
+my $dbport = $config{database}->{port} // 3306;
+my $dbname = $config{database}->{name};
+my $dbuser = $config{database}->{user};
+my $dbpwd  = $config{database}->{password};
+#$dbh = DBI->connect( "DBI:MariaDB:host=$dbhost;port=$dbport;database=$dbname",
+#    $dbuser, $dbpwd, { AutoCommit => 1 } )
+#    or die $DBI::errstr;
+
+$dbh = DBI->connect( "dbi:mysql:host=$dbhost;port=$dbport;database=$dbname",
+    $dbuser, $dbpwd, { AutoCommit => 1 } )
+    or die $DBI::errstr;
+
+#
+# Enable client-side UTF8
+#
+$dbh->{mysql_enable_utf8} = 1;
+
+#
+# Set up the query
+#
+$sth1 = $dbh->prepare($query) or die $DBI::errstr;
+if ( $dbh->err ) {
+    warn $dbh->errstr;
+}
+
+#
+# Perform the query
+#
+$sth1->execute;
+if ( $dbh->err ) {
+    warn $dbh->errstr;
+}
+
+#
+# Grab everything as an arrayref of hashrefs
+#
+$result = $sth1->fetchall_arrayref( {} );
+
+#
+# Prepare for JSON, forcing object key sorting (expensive)
+#
+$json = JSON->new->utf8->canonical;
+
+#
+# Encode the Perl structure to JSON
+#
+print $json->encode($result), "\n";
+
+exit;
+
+# vim: syntax=perl:ts=8:sw=4:et:ai:tw=78:fo=tcrqn21:fdm=marker

hpr_container_email_shownotes.sh

@@ -0,0 +1,135 @@
+#!/usr/bin/env bash
+#License: GPL v3
+#see <https://www.gnu.org/licenses/>.
+
+#Name: button_hpr_container.sh
+#Purpose: build/run HPR Container.
+#Version: beta 0.01
+#Author: SGOTI (Some Guy On The Internet)
+#Email: Lyunpaw@gmail.com
+#Date: 2025-04-19
+
+#declaration:
+declare bindir="/usr/bin/"
+declare podman="${bindir}podman"
+declare echo="builtin echo -e"
+declare unprivilegedUser="janitor"
+declare date="${bindir}date"
+declare flags
+declare OPTIND
+declare -A containerBulidProperties
+
+declare currentMonth
+declare nextMonth
+declare currentYear
+
+#start:
+currentMonth=$(${date} +%m)
+currentYear=$(${date} +%Y)
+
+if [[ ${currentmonth} -gt 0 ]] && [[ ${currentmonth} -le 11 ]]; then
+    nextMonth="(($(${date} +%m)+01))" #Incomplete: Can return single-digit integer; must be a double-digit integer.
+else
+    nextMonth="01"
+fi
+
+containerBulidProperties=(
+    "containerFile" "/path/to/Containerfile"
+    "hostMountDir01" "/path/to/project/directory"
+    "hostMountDir02" "/tmp/"
+    "containerMountDir01" "/opt/hpr/"
+    "containerMountDir02" "/tmp/hpr/"
+    "containerImageTag" "hpr_image:5.40.1"
+    "pullNewImage" "podman pull docker.io/library/perl"
+    "recordingDate" "$(${date} -d "${currentYear}/${currentMonth}/01")"
+    "recordingTimeStart" "15:00" #TZ: UTC
+    "recordingTimeEnd" "17:00" #TZ: UTC
+)
+
+function runHPRContainer () {
+    local makeEmail #Incomplete: 
+    makeEmail="./make_email -month=${containerBulidProperties[recordingDate]} -start=15:00 -end=17:00 -out=/tmp/hpr/%semail.txt"
+    local makeShownotes #Incomplete: 
+    makeShownotes="/opt/hpr/src/hpr-tools/Community_News/make_shownotes -from=${containerBulidProperties[recordingDate]} -full=/tmp/hpr/%sfull_shownotes.html -mail -comments"
+
+    ${podman} run \
+        --mount type=bind,src=${containerBulidProperties[hostMountDir02]},dst=${containerBulidProperties[containerMountDir02]},rw=true \
+        --label="Project"="HPR" \
+        --label="Forge"="https://repo.anhonesthost.net/HPR/" \
+        --interactive \
+        --tty \
+        --rm=true \
+        --privileged=false \
+        --pull="never" \
+        --cgroups=enabled \
+        --cgroupns=private \
+        --uts=private \
+        --pid=private \
+        --memory="32m" \
+        --memory-reservation="16m" \
+        --hostname="hpr" \
+        --name="hpr_project" \
+        --user="${unprivilegedUser}" \
+        ${containerBulidProperties[containerImageTag]} bash;
+    return;
+}
+
+function buildNewContainerImage () {
+    if [[ -f "${containerBulidProperties[containerFile]}" ]]; then
+        ${echo} "Building new container image...\nThis may take several minutes.\
+            \nThis is a non interactive build process, so you can return when \
+            it's completed.";
+        ${podman} build --file="${containerBulidProperties[containerFile]}" --tag="${containerBulidProperties[containerImageTag]}";
+    else
+        ${echo} 'Dont forget to assign the ${containerBulidProperties[containerFile]} ;). The Containerfile is needed to build the container image.'
+    fi
+    return;
+}
+
+function help () {
+    ${echo} "$0 [-hbpq]\n\t[-h] help\n\t[-b] build new container\n\t[-p] pull new perl image\n\t[-q] quit";
+    return;
+}
+
+while getopts 'hbpq' flags; do
+    case "${flags}" in
+        h) help; exit 0;
+        ;;
+
+        i) ${echo} "Work in progress... :D"; break;
+        ;;
+
+        b) buildNewContainerImage;
+        ;;
+
+        p) ${containerBulidProperties[pullNewImage]}; exit 0;
+        ;;
+
+        e) ${echo} "Work in progress... :D"; break;
+        ;;
+
+        s) ${echo} "Work in progress... :D"; break;
+        ;;
+
+        q)
+        ${echo} "Quitting script."; break;
+        ;;
+
+        *)
+        ${echo} "Good Heavens! Wrong input."; help; exit 1
+        ;;
+    esac
+done
+shift $((OPTIND-1))
+
+if [[ -z ${1} ]]; then help; runHPRContainer; fi;
+
+unset echo
+unset flags
+unset podman
+unset OPTIND
+unset currentMonth
+unset currentYear
+unset containerBulidProperties
+exit 0
+

workflow/duration.bash

@@ -2,7 +2,14 @@
 # Copyright Ken Fallon - Released into the public domain. http://creativecommons.org/publicdomain/ 
 #============================================================
 
-find ${HOME}/processing/ -type f | egrep -v '/sponsor-anhonesthost.com-hpr15.flac|/outro.flac|/intro.flac|/sponsor-archive.org.flac' | while read mediafile
+search_dir="${HOME}/processing/"
+
+if [ -d "${1}" ]
+then
+  search_dir="${1}"
+fi
+
+find ${search_dir} -type f | grep -vP '/sponsor-anhonesthost.com-hpr15.flac|/outro.flac|/intro.flac|/sponsor-archive.org.flac' | while read mediafile
 do 
   duration=$( mediainfo --full --Output=XML "${mediafile}" | xmlstarlet sel -T -t -m "_:MediaInfo/_:media/_:track[@type='Audio']/_:Duration[1]" -v "." -n - | awk -F '.' '{print $1}' )
   if [ "${duration}" != "" ]

workflow/hpr-get-and-transcribe.bash

@@ -0,0 +1,35 @@
+#!/bin/bash
+
+rsync -av --partial --progress hpr:hub.hackerpublicradio.org/upload/ $HOME/tmp/hpr/processing/
+
+find $HOME/tmp/hpr/processing/*_*_????-??-??_* -type d | sort -t _ -k 2 | while read show_dir
+do
+  echo "${show_dir}"
+  if [ "$( find "${show_dir}" -type f -iname "*srt" | wc -l )" -eq "0" ]
+  then
+    cd "${show_dir}"
+    ls -haltr
+    find "${show_dir}/" -type f -exec file {} \; | grep -Ei 'audio|mpeg|video|MP4' | awk -F ': ' '{print $1}' | while read this_media
+    do
+      whisper --model tiny --language en --output_dir "${show_dir}" "${this_media}"
+    done
+    rsync -av --partial --progress "${show_dir}/" hpr:hub.hackerpublicradio.org/upload/$( basename "${show_dir}")/
+  fi
+done
+
+rsync -av --partial --progress hpr:hub.hackerpublicradio.org/reserve/ $HOME/tmp/hpr/reserve/
+
+find $HOME/tmp/hpr/reserve/*_*_* -type d | sort -t _ -k 2 | while read show_dir
+do
+  echo "${show_dir}"
+  if [ "$( find "${show_dir}" -type f -iname "*srt" | wc -l )" -eq "0" ]
+  then
+    cd "${show_dir}"
+    ls -haltr
+    find "${show_dir}/" -type f -exec file {} \; | grep -Ei 'audio|mpeg|video|MP4' | awk -F ': ' '{print $1}' | while read this_media
+    do
+      whisper --model tiny --language en --output_dir "${show_dir}" "${this_media}"
+    done
+    rsync -av --partial --progress "${show_dir}/" hpr:hub.hackerpublicradio.org/reserve/$( basename "${show_dir}")/
+  fi
+done

workflow/hpr-publish.bash

@@ -12,9 +12,9 @@ cd "${git_dir}"
 
 git pull
 
-ssh hpr -t "ls -al /home/hpr/www/hpr.sql;md5sum /home/hpr/www/hpr.sql"
+# ssh hpr -t "ls -al /home/hpr/www/hpr.sql;md5sum /home/hpr/www/hpr.sql"
-ssh hpr -t "/home/hpr/bin/hpr_db_backup.bash"
+# ssh hpr -t "/home/hpr/bin/hpr_db_backup.bash"
-ssh hpr -t "ls -al /home/hpr/www/hpr.sql;md5sum /home/hpr/www/hpr.sql"
+# ssh hpr -t "ls -al /home/hpr/www/hpr.sql;md5sum /home/hpr/www/hpr.sql"
 
 ./utils/update-hpr-db.sh
 if [ $? -ne 0 ]
@@ -30,8 +30,8 @@ then
   exit 1
 fi
 
-rsync -av --partial --progress "${git_dir}/public_html/" hpr:/home/hpr/public_html/
+rsync -av --partial --progress "${git_dir}/public_html/" hpr:hackerpublicradio.org/public_html
-rsync -av --partial --progress "${git_dir}/public_html/" hobbypublicradio.org:hobbypublicradio.org/
+#rsync -av --partial --progress "${git_dir}/public_html/" hobbypublicradio.org:hobbypublicradio.org/
 
 cd $HOME/sourcecode/hpr/hpr_hub/
 git pull 

workflow/hpr_ccdn_stats.bash

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+yesterday="$( \date -u +%Y-%m-%d -d yesterday)" 
+echo -e "${yesterday}\t$( grep -Ec "${yesterday}T.*Sending request to" /home/hpr/logs/naughty-ip.txt )" >> /home/hpr/hub/hpr_ccdn_stats.tsv

workflow/hpr_db_backup.bash

@@ -0,0 +1,194 @@
+#!/bin/bash
+
+# 5,20,35,50 * * * * $HOME/userfiles/sql/hpr_db_backup.bash >> $HOME/userfiles/sql/cron.log 2>&1 &
+
+#TODO
+#add a rss feed with the latest updates. Linking to the changes on gittea.
+# run that every 5 minutes and then if there is a change sleep 5 and confirm there has been no change since.
+# Then download the db and regenerate the site.
+# While making sure to generate the site at least once a day 
+# check the skip-extended-insert export into of the sql into git, so that the small diffs show up.
+# generate a rss feed with the latest changes.
+# update all the other scripts reserve, stats etc.
+
+
+sql_save_dir="$HOME/userfiles/sql"
+credential_file="${sql_save_dir}/.my-hpr.cnf"
+last_update_txt="${sql_save_dir}/last_update.txt"
+hpr_full_sql="${sql_save_dir}/hpr_hpr_full.sql"
+hpr_site_sql="${sql_save_dir}/hpr.sql"
+full_mysqldump_sql="${sql_save_dir}/mysqldump.sql"
+hpr_database_file="hackerpublicradio.org/public_html/hpr.sql"
+
+sync_delay_seconds="300" # 5 minutes
+
+last_update_query="SELECT
+  update_time
+FROM
+  information_schema.tables tab
+WHERE
+  update_time > (current_timestamp() - interval 30 day)
+  AND table_type = 'BASE TABLE'
+  AND table_name not in ('reservations')
+  AND table_schema not in ('information_schema', 'sys', 'performance_schema', 'mysql')
+ORDER BY
+  update_time DESC
+LIMIT 1;"
+
+if [ ! -s "${credential_file}" ]
+then
+  echo "The file \"${credential_file}\" is missing"
+  exit 
+fi
+
+local_db_last_update_epoch="0"
+if [ -s "${last_update_txt}" ]
+then
+  echo "Found the last update file \"${last_update_txt}\""
+  local_db_last_update_iso8601="$( \date --utc --date="$( cat ${last_update_txt} )" +%Y-%m-%dT%H:%M:%SZ )"
+  local_db_last_update_epoch="$( \date --utc --date="$( cat ${last_update_txt} )" +%s )"
+  echo -e "Local DB update time is\t${local_db_last_update_iso8601} (${local_db_last_update_epoch})"
+fi
+
+live_db_last_update_iso8601="$( mysql --defaults-file="${credential_file}" --disable-column-names --batch --execute="${last_update_query}" | sed -e 's/ /T/g' -e 's/$/Z/g' )"
+if [ -z "${live_db_last_update_iso8601}" ]
+then
+  echo "The live db update time \"live_db_last_update_iso8601\" is missing"
+  exit 1
+fi
+
+live_db_last_update_epoch="$( \date --utc --date="${live_db_last_update_iso8601}" +%s )"
+if [ -z "${live_db_last_update_epoch}" ]
+then
+  echo "The live db update time \"live_db_last_update_epoch\" is missing"
+  exit 2
+fi
+
+echo -e "Live DB update time is\t${live_db_last_update_iso8601} (${live_db_last_update_epoch})"
+
+if [ "${local_db_last_update_epoch}" -eq "${live_db_last_update_epoch}" ]
+then
+  echo "No changes detected. Skipping export."
+  exit 0
+fi
+
+echo "Starting export full with -complete-insert."
+if [ -s "${hpr_full_sql}" ]
+then
+  hpr_full_sql_write_time_iso8601="$( \date --utc --date="$( ls -al --full-time "${hpr_full_sql}" | awk '{print $6, $7, $8}' )" +%Y-%m-%dT%H:%M:%SZ )"
+  hpr_full_sql_write_time_epoch="$( \date --utc --date="${hpr_full_sql_write_time_iso8601}" +%s )"
+  if [ -z "${hpr_full_sql_write_time_epoch}" ]
+  then
+    echo "The live db update time \"hpr_full_sql_write_time_epoch\" is missing"
+    exit 3
+  fi
+  echo -e "Full DB write time is\t${hpr_full_sql_write_time_iso8601} (${hpr_full_sql_write_time_epoch})"
+
+  hpr_full_sql_write_time_with_delay_epoch="$(( ${hpr_full_sql_write_time_epoch} + ${sync_delay_seconds} ))"
+  time_now_epoch="$( \date --utc +%s )"
+
+  if [ "${hpr_full_sql_write_time_with_delay_epoch}" -gt "${time_now_epoch}" ]
+  then
+    echo "Skipping export. The Database has been recently created \"${hpr_full_sql_write_time_iso8601}\". Try again after $( \date --utc --date="@${hpr_full_sql_write_time_with_delay_epoch}" +%Y-%m-%dT%H:%M:%SZ )."
+    exit 4
+  fi
+fi
+mysqldump --defaults-file="${credential_file}" --tz-utc --add-drop-database --extended-insert --complete-insert --skip-extended-insert --default-character-set=utf8 --single-transaction --skip-set-charset --databases hpr_hpr > "${hpr_full_sql}"
+tail "${hpr_full_sql}" | grep 'Dump completed on'
+
+echo "Starting export full for static site generation."
+if [ -s "${hpr_site_sql}" ]
+then
+  hpr_site_sql_write_time_iso8601="$( \date --utc --date="$( ls -al --full-time "${hpr_site_sql}" | awk '{print $6, $7, $8}' )" +%Y-%m-%dT%H:%M:%SZ )"
+  hpr_site_sql_write_time_epoch="$( \date --utc --date="${hpr_site_sql_write_time_iso8601}" +%s )"
+  if [ -z "${hpr_site_sql_write_time_epoch}" ]
+  then
+    echo "The live db update time \"hpr_site_sql_write_time_epoch\" is missing"
+    exit 5
+  fi
+  echo -e "Full DB write time is\t${hpr_site_sql_write_time_iso8601} (${hpr_site_sql_write_time_epoch})"
+
+  hpr_site_sql_write_time_with_delay_epoch="$(( ${hpr_site_sql_write_time_epoch} + ${sync_delay_seconds} ))"
+  time_now_epoch="$( \date --utc +%s )"
+
+  if [ "${hpr_site_sql_write_time_with_delay_epoch}" -gt "${time_now_epoch}" ]
+  then
+    echo "Skipping export. The Database has been recently created \"${hpr_site_sql_write_time_iso8601}\". Try again after $( \date --utc --date="@${hpr_site_sql_write_time_with_delay_epoch}" +%Y-%m-%dT%H:%M:%SZ )."
+    exit 6
+  fi
+fi
+mysqldump --defaults-file="${credential_file}" --tz-utc --add-drop-database --complete-insert --extended-insert --default-character-set=utf8 --single-transaction --skip-set-charset --databases hpr_hpr --ignore-table=hpr_hpr.reservations > "${hpr_site_sql}"
+tail "${hpr_site_sql}" | grep 'Dump completed on'
+
+echo "Starting export full for data recovery."
+if [ -s "${full_mysqldump_sql}" ]
+then
+  full_mysqldump_sql_write_time_iso8601="$( \date --utc --date="$( ls -al --full-time "${full_mysqldump_sql}" | awk '{print $6, $7, $8}' )" +%Y-%m-%dT%H:%M:%SZ )"
+  full_mysqldump_sql_write_time_epoch="$( \date --utc --date="${full_mysqldump_sql_write_time_iso8601}" +%s )"
+  if [ -z "${full_mysqldump_sql_write_time_epoch}" ]
+  then
+    echo "The live db update time \"full_mysqldump_sql_write_time_epoch\" is missing"
+    exit 5
+  fi
+  echo -e "Full DB write time is\t${full_mysqldump_sql_write_time_iso8601} (${full_mysqldump_sql_write_time_epoch})"
+
+  full_mysqldump_sql_write_time_with_delay_epoch="$(( ${full_mysqldump_sql_write_time_epoch} + ${sync_delay_seconds} ))"
+  time_now_epoch="$( \date --utc +%s )"
+
+  if [ "${full_mysqldump_sql_write_time_with_delay_epoch}" -gt "${time_now_epoch}" ]
+  then
+    echo "Skipping export. The Database has been recently created \"${full_mysqldump_sql_write_time_iso8601}\". Try again after $( \date --utc --date="@${full_mysqldump_sql_write_time_with_delay_epoch}" +%Y-%m-%dT%H:%M:%SZ )."
+    exit 6
+  fi
+fi
+mysqldump --defaults-file="${credential_file}" --tz-utc --add-drop-database  --databases hpr_hpr> "${full_mysqldump_sql}"
+tail "${full_mysqldump_sql}" | grep 'Dump completed on'
+
+echo "<?xml version=\"1.0\" encoding=\"UTF-8\"?>
+<rss xmlns:atom=\"https://www.w3.org/2005/Atom\" version=\"2.0\">
+  <channel>
+    <title>Hacker Public Radio ~ Database Feed</title>
+    <link>http://hackerpublicradio.org/about.html</link>
+    <description>This Feed provides information the latest version of the HPR database.</description>
+    <language>en-us</language>
+    <copyright>Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) License</copyright>
+    <managingEditor>feedback.nospam@nospam.hackerpublicradio.org (HPR Feedback)</managingEditor>
+    <webMaster>admin.nospam@nospam.hackerpublicradio.org (HPR Webmaster)</webMaster>
+    <generator>https://repo.anhonesthost.net/HPR/hpr-tools/src/branch/main/workflow/hpr_db_backup.bash</generator>
+    <docs>https://www.rssboard.org/rss-specification</docs>
+    <ttl>15</ttl>
+    <image>
+      <url>http://hackerpublicradio.org/images/hpr_feed_small.png</url>
+      <title>Hacker Public Radio ~ Database Feed</title>
+      <link>http://hackerpublicradio.org/about.html</link>
+      <description>The Hacker Public Radio Old Microphone Logo</description>
+      <height>164</height>
+      <width>144</width>
+    </image>
+    <atom:link href=\"https://hackerpublicradio.org/hpr.sql.rss\" rel=\"self\" type=\"application/rss+xml\"/>
+    <pubDate>$( date --utc --rfc-email )</pubDate>
+    <item>
+      <title>Export of the Public mariadb SQL for ${live_db_last_update_iso8601}</title>
+      <author>admin.nospam@nospam.hackerpublicradio.org (Janitors)</author>
+      <link>http://hackerpublicradio.org/hpr.sql#${live_db_last_update_iso8601}</link>
+      <description/>
+      <pubDate>$( date --utc --rfc-email )</pubDate>
+      <enclosure url=\"http://hackerpublicradio.org/hpr.sql#${live_db_last_update_iso8601}\" length=\"$( ls -al "${hpr_site_sql}" | awk '{print $5}' )\" type=\"application/sql\"/>
+      <guid isPermaLink=\"false\">sha1sum:$( sha1sum "${hpr_site_sql}" | awk '{print $1}' ),md5sum:$( md5sum "${hpr_site_sql}" | awk '{print $1}' )</guid>      
+    </item>
+  </channel>
+</rss>" > "${hpr_site_sql}.rss"
+
+if [ $HOSTNAME = "whp01.cloud-hosting.io" ]
+then
+  cp -v "${hpr_site_sql}" "$HOME/${hpr_database_file}"
+  cp -v "${hpr_site_sql}.rss" "$HOME/${hpr_database_file}.rss"
+else
+  rsync -av --partial --progress ${hpr_site_sql} hpr:${hpr_database_file}
+  rsync -av --partial --progress ${hpr_site_sql}.rss hpr:${hpr_database_file}.rss
+fi
+
+echo "${live_db_last_update_iso8601}" > "${last_update_txt}"
+
+echo "Finished export of \"${live_db_last_update_iso8601}\""
+

workflow/hprtranscode.bash

@@ -1,685 +0,0 @@
-#!/usr/bin/env bash
-# Copyright Ken Fallon - Released into the public domain. http://creativecommons.org/publicdomain/ 
-#============================================================
-
-PATH=$PATH:$HOME/sourcecode/hpr/hpr_hub/bin/
-source $HOME/tmp/pip3.9/bin/activate
-# https://hub.tcno.co/ai/whisper/install/
-
-TEMP_DIR="/var/tmp/"
-CHANNELS="2"
-FIXAUDIO="1"
-ARTIST="EMPTY"
-TITLE="EMPTY"
-YEAR="EMPTY"
-SLOT="EMPTY"
-basedir="/var/IA"
-upload_dir="${basedir}/uploads"
-theme="${basedir}/theme.wav"
-outro="${basedir}/2022-03-07-outro.wav"
-outro_c2="${basedir}/2022-03-07-outro_c2.wav"
-ttsserver="http://localhost:5500"
-processing_dir="$HOME/tmp/hpr/processing"
-git_image_dir="$HOME/sourcecode/hpr/HPR_Public_Code/www/images/hosts"
-acceptable_duration_difference="2" # Seconds
-thedate=$(/usr/bin/date -u +%Y-%m-%d_%H-%M-%SZ_%A)
-echo "Processing the next HPR Show in the queue"
-
-
-if [ $( curl -s -o /dev/null -w "%{http_code}" -X 'GET' "${ttsserver}/api/voices" -H 'accept: */*' ) != "200" ]
-then
-  echo "Please start the tts-server \"podman run -it -p 5500:5500 synesthesiam/opentts:en\""
-  exit
-fi
-
-function abs_diff {
-  echo $(($1 >= $2 ? $1 - $2 : $2 - $1))
-}
-
-function create_tts_summary {
-  HPR_summary="$( cat "hpr${ep_num}_summary.txt" )"
-  echo "INFO: Converting text \"${HPR_summary}\" to speech."
-  curl -X 'GET' -G --data-urlencode "voice=coqui-tts:en_ljspeech" --data-urlencode "text=${HPR_summary}" --data-urlencode "vocoder=high" --data-urlencode "denoiserStrength=0.03" --data-urlencode "cache=false" ${ttsserver}/api/tts -H 'accept: */*' --output ~hpr${ep_num}_summary.wav
-}
-
-###################
-# Locate media directory
-#
-#
-show_type=""
-if [[ -f "${1}" && -n "${2}" ]]
-then
-  echo "DEBUG: Show type is local" 1>&2
-  show_type="local"
-  mediafile="${1}"
-  media_dir="$( dirname "${mediafile}" )"
-  ep_num="${2}"
-  echo "The duration is \"$( \date -ud "1970-01-01 $( ffprobe -i "${mediafile}" 2>&1| awk -F ': |, ' '/Duration:/ { print $2 }' )" +%s )\"."
-else
-  echo "DEBUG: Show type is remote" 1>&2
-  show_type="remote"
-  response=$( curl --silent --netrc-file ${HOME}/.netrc "https://hub.hackerpublicradio.org/cms/status.php" | \
-  grep 'SHOW_POSTED' | \
-  head -1 | \
-  sed 's/,/ /g' )
-
-  echo "DEBUG: Getting server response" 1>&2
-  if [ -z "${response}" ]
-  then
-    echo "INFO: There appear to be no more shows with the status \"SHOW_POSTED\"."
-    echo "Getting a list of all the reservations."
-    curl --silent --netrc-file ${HOME}/.netrc "https://hub.hackerpublicradio.org/cms/status.php"
-    exit 3
-  fi
-
-  timestamp_epoc="$( echo ${response} | awk '{print $1}' )"
-  ep_num="$( echo ${response} | awk '{print $2}' )"
-  ep_date="$( echo ${response} | awk '{print $3}' )"
-  key="$( echo ${response} | awk '{print $4}' )"
-  status="$( echo ${response} | awk '{print $5}' )"
-  email="$( echo ${response} | awk '{print $6}' )"
-
-  #source_dir="hpr:/home/hpr/upload/${timestamp_epoc}_${ep_num}_${ep_date}_${key}"
-  dest_dir="${timestamp_epoc}_${ep_num}_${ep_date}_${key}"
-  media_dir="${processing_dir}/${timestamp_epoc}_${ep_num}_${ep_date}_${key}"
-
-fi
-
-upload_dir_ep_num="${upload_dir}/hpr${ep_num}"
-mkdir -p "${upload_dir_ep_num}" 2>/dev/null
-if [ ! -d "${upload_dir_ep_num}" ]
-then
-  echo "DEBUG: Missing directory \"upload_dir_ep_num\" \"${upload_dir}\", /hpr and \"${ep_num}\"" 1>&2
-  exit
-fi
-
-echo "DEBUG: Checking variables" 1>&2
-if [ -z "${show_type}" ]
-then
-  echo "sorry, variable \"show_type\" is not set."
-  exit
-fi
-
-if [ -z "${media_dir}" ]
-then
-  echo "sorry, variable \"media_dir\" is not set."
-  exit
-fi
-
-if [ ! -d "${media_dir}" ]
-then
-  echo "sorry, directory \"media_dir: ${media_dir}\" does not exist"
-  exit 1
-fi
-
-echo detox -v "${media_dir}/"
-detox -vr "${media_dir}/"
-
-echo "DEBUG: Using media directory as \"${media_dir}\""
-
-if [[ "$( find "${media_dir}" \( -iname "hpr${ep_num}_sandwitch.wav" -o -iname "hpr${ep_num}.mp3" -o -iname "hpr${ep_num}.ogg" -o -iname "hpr${ep_num}.spx" -o -iname "hpr${ep_num}_summary.txt" -o -iname "hpr${ep_num}_summary.wav" -o -iname "hpr${ep_num}_sandwitch.wav" -o -iname "*_mez.wav" -o -iname "*_sox_norm.wav" -o -iname "*_mezzanine.wav" -o -iname "*_tmp.pcm" -o -iname "hpr${ep_num}_intro*.wav" -o -iname "~hpr${ep_num}_summary.wav" -o -iname "~~hpr${ep_num}_summary.wav" -o -iname "*_tmp.log" -o -iname "silence.wav" -o -iname "hpr${ep_num}_norm.wav" \) | wc -l )" -ne 0 ]]
-then
-  echo "Files for this episode already exist."
-  find "${media_dir}" \( -iname "hpr${ep_num}_sandwitch.wav" -o -iname "hpr${ep_num}.mp3" -o -iname "hpr${ep_num}.ogg" -o -iname "hpr${ep_num}.spx" -o -iname "hpr${ep_num}_summary.txt" -o -iname "hpr${ep_num}_summary.wav" -o -iname "hpr${ep_num}_sandwitch.wav" -o -iname "*_mez.wav" -o -iname "*_sox_norm.wav" -o -iname "*_mezzanine.wav" -o -iname "*_tmp.pcm" -o -iname "hpr${ep_num}_intro*.wav" -o -iname "~hpr${ep_num}_summary.wav" -o -iname "~~hpr${ep_num}_summary.wav" -o -iname "*_tmp.log" -o -iname "silence.wav" -o -iname "hpr${ep_num}_norm.wav" \)
-  read -p "Shall I remove them ? (N|y) ? " -n 1 -r
-  echo    # (optional) move to a new line
-  if [[ ! $REPLY =~ ^[yY]$ ]]
-  then
-    echo "skipping...."
-    exit
-  else
-    echo "Removing old files ...."
-    find "${media_dir}" \( -iname "hpr${ep_num}_sandwitch.wav" -o -iname "hpr${ep_num}.mp3" -o -iname "hpr${ep_num}.ogg" -o -iname "hpr${ep_num}.spx" -o -iname "hpr${ep_num}_summary.txt" -o -iname "hpr${ep_num}_summary.wav" -o -iname "hpr${ep_num}_sandwitch.wav" -o -iname "*_mez.wav" -o -iname "*_sox_norm.wav" -o -iname "*_mezzanine.wav" -o -iname "*_tmp.pcm" -o -iname "hpr${ep_num}_intro*.wav" -o -iname "~hpr${ep_num}_summary.wav" -o -iname "~~hpr${ep_num}_summary.wav" -o -iname "*_tmp.log" -o -iname "silence.wav" -o -iname "hpr${ep_num}_norm.wav" \) -delete -print
-  fi
-fi
-
-
-#####################################################
-# Process media
-
-media=$( find "${media_dir}" -type f -exec file {} \; | grep -Ei 'audio|mpeg|video|MP4' | awk -F ': ' '{print $1}' )
-if [ -z "${media}" ]
-then
-  echo "ERROR: Can't find any media in \"${media_dir}/\""
-  find "${media_dir}/" -type f
-  exit 1
-fi
-
-mediafile=""
-
-echo "Found more than one media file. Please select which one to use ?"
-if [ "$( echo "${media}" | wc -l )" -ne 1 ]
-then
-  select this_media in $( echo "${media}" )
-  do
-    echo "INFO: You selected \"${this_media}\"."
-    ls -al "${this_media}"
-    mediafile="${this_media}"
-    break
-  done
-else
-  echo "INFO: Selecting media as \"${media}\"."
-  mediafile="${media}"
-fi
-
-# extract file name and extension
-fname="$( basename "${mediafile%.*}" )"
-ext="${mediafile/*./}"
-
-cd "${media_dir}/"
-pwd
-
-echo "INFO: Processing hpr${ep_num} from ${email}"
-echo "INFO: Working directory is \"${media_dir}/\""
-echo ""
-
-
-if [ -z "${mediafile}" ]
-then
-  echo "sorry, variable \"mediafile\" is not set."
-  exit
-fi
-
-if [ -z "${fname}" ]
-then
-  echo "sorry, variable \"fname\" is not set."
-  exit
-fi
-
-if [ -z "${ext}" ]
-then
-  echo "sorry, variable \"ext\" is not set."
-  exit
-fi
-
-if [ ! -f "${mediafile}" ]
-then
-  echo "sorry, media file \"${mediafile}\" does not exist"
-  exit
-fi
-
-echo "--------------------------------------------------------------------------------" | tee -a ${fname}_tmp.log
-echo "File information for \"${mediafile}\"" | tee -a ${fname}_tmp.log
-ffprobe ${mediafile} 2>&1 | grep Audio:
-mediainfo ${mediafile}
-audio2image.bash ${mediafile}
-xdg-open ${mediafile%.*}.png >/dev/null 2>&1 &
-unset REPLY
-until [[ $REPLY =~ ^[yYnN]$ ]]
-do
-  read -p "Source Waveform look ok ? (N|y) ? " -n 1 -r
-  echo ""
-done
-
-if [[ ! $REPLY =~ ^[yY]$ ]]
-then
-  echo "skipping.... $REPLY"
-  exit
-fi
-
-
-re='^[0-9]+$'
-if ! [[ $ep_num =~ $re ]]
-then
-   echo "error: episode \"${ep_num}\" is not a number"
-   exit 1
-fi
-
-if [ ! -f "${outro}" ]
-then
-  echo "sorry, file \"${outro}\" does not exist"
-  exit 1
-fi
-
-if [ ! -f "${outro_c2}" ]
-then
-  echo "sorry, file \"${outro_c2}\" does not exist"
-  exit 1
-fi
-
-
-if [ ! -f "${theme}" ]
-then
-  echo "sorry, file \"${theme}\" does not exist"
-  exit 1
-fi
-
-if [ ! -r "${mediafile}" ]
-then
-  echo "sorry, media file \"${mediafile}\" is not readable"
-  exit
-fi
-
-if [ $(ffprobe "${mediafile}" 2>&1 | grep "Audio:" | wc -l ) -eq 0 ]
-then
-  echo "sorry, media file \"${mediafile}\" has no audio track"
-  exit
-fi
-
-xdg-open "https://hackerpublicradio.org/eps/hpr${ep_num}/index.html" >/dev/null 2>&1 &
-
-mpv -vo=null "${mediafile}"
-
-unset REPLY
-until [[ $REPLY =~ ^[yYnN]$ ]]
-do
-  read -p "Is the audio ok (n|Y) ? " -n 1 -r
-  echo ""
-done
-
-if [[ ! $REPLY =~ ^[yY]$ ]]
-then
-  echo "skipping.... $REPLY"
-  exit
-fi
-
-echo "--------------------------------------------------------------------------------"
-echo "Geting metadata for hpr${ep_num}"
-
-while read -r line
-do
-  field=$(echo $line | awk -F ':' '{print $1}')
-  case $field in
-  "HPR_summary")
-      HPR_summary=$(echo $line | grep "HPR_summary: " | cut -c 14- )
-      continue
-      ;;
-  "HPR_album")
-     HPR_album=$(echo $line | grep "HPR_album: " | cut -c 12- )
-      continue
-      ;;
-  "HPR_artist")
-    HPR_artist=$(echo $line | grep "HPR_artist: "  | cut -c 13- )
-      continue
-      ;;
-  "HPR_comment")
-    HPR_comment=$(echo $line | grep "HPR_comment: " | cut -c 14- )
-      continue
-      ;;
-  "HPR_genre")
-    HPR_genre=$(echo $line | grep "HPR_genre: " | cut -c 12- )
-      continue
-      ;;
-  "HPR_title")
-    HPR_title=$(echo $line | grep "HPR_title: " | cut -c 12- )
-      continue
-      ;;
-  "HPR_track")
-    HPR_track=$(echo $line | grep "HPR_track: " | cut -c 12- )
-      continue
-      ;;
-  "HPR_year")
-    HPR_year=$(echo $line | grep "HPR_year: " | cut -c 11- )
-      continue
-      ;;
-  "HPR_duration")
-    HPR_duration=$(echo $line | grep "HPR_duration: " | cut -c 15- )
-      continue
-      ;;
-  "HPR_explicit")
-    HPR_explicit=$(echo $line | grep "HPR_explicit: " | cut -c 15- )
-      continue
-      ;;
-  "HPR_license")
-    HPR_license=$(echo $line | grep "HPR_license: " | cut -c 14- )
-      continue
-      ;;
-  esac
-done < <( curl --silent --netrc-file ${HOME}/.netrc "https://hub.hackerpublicradio.org/cms/say.php?id=${ep_num}" )
-
-if [[ -z "$HPR_album" || -z "$HPR_artist" || -z "$HPR_comment" || -z "$HPR_genre" || -z "$HPR_title" || -z "$HPR_track" || -z "$HPR_year" || -z "$HPR_summary" || -z "$HPR_duration" || -z "$HPR_explicit" || -z "$HPR_license" ]]
-then
-  echo "Could not find information on ${ep_num}. Has the show been posted ?"
-  exit;
-fi
-echo "--------------------------------------------------------------------------------"
-echo "album       : $HPR_album"
-echo "artist      : $HPR_artist"
-echo "comment     : $HPR_comment"
-echo "genre       : $HPR_genre"
-echo "title       : $HPR_title"
-echo "track       : $HPR_track"
-echo "year        : $HPR_year"
-echo "summary     : $HPR_summary"
-echo "duration    : $HPR_duration"
-echo "explicit    : $HPR_explicit"
-echo "license     : $HPR_license"
-echo "media_dir   : ${media_dir}"
-echo "mediafile   : ${mediafile}"
-echo "fname       : ${fname}"
-echo "ext         : ${ext}"
-
-if [[ $HPR_duration == "0" ]]
-then
-  echo "The duration is set to 0. Please update the show with the correct time."
-  exit;
-fi
-
-#============================================================
-# Preproc`s the source file
-
-echo "--------------------------------------------------------------------------------" | tee -a ${fname}_tmp.log
-echo "Prepare mezzanine file" | tee -a ${fname}_tmp.log
-ffmpeg -y -i ${mediafile} -ar 44100 -ac $CHANNELS ${fname}_mezzanine.wav >> ${fname}_tmp.log 2>&1
-
-echo "--------------------------------------------------------------------------------" | tee -a ${fname}_tmp.log
-echo "Add HPR Branding" | tee -a ${fname}_tmp.log
-
-echo "Creating the summary" | tee -a ${fname}_tmp.log
-#echo "$HPR_summary" - | text2wave -F 44100 - -o hpr${ep_num}_summary.wav #festival --tts
-#echo "$HPR_summary" - | espeak -w ~hpr${ep_num}_summary.wav
-
-echo "$HPR_summary" > "hpr${ep_num}_summary.txt"
-
-create_tts_summary_ok="not-ok"
-
-while [ "${create_tts_summary_ok}" != "OK" ]
-do
-  create_tts_summary
-
-  xdg-open "hpr${ep_num}_summary.txt" 2>&1 &
-  mpv --speed=1.8 ~hpr${ep_num}_summary.wav
-
-  read -p "Is the text to speech correct (y|N) ? " -n 1 -r
-  echo    # (optional) move to a new line
-  if [[ $REPLY =~ ^[Yy]$ ]]
-  then
-    create_tts_summary_ok="OK"
-  else
-    echo "WARN: Please correct the text and try again."
-    inotifywait --event modify "hpr${ep_num}_summary.txt"
-  fi
-done
-echo "INFO: TTS complete."
-
-ffmpeg -y -i ~hpr${ep_num}_summary.wav -ar 44100 ~~hpr${ep_num}_summary.wav >> ${fname}_tmp.log 2>&1
-
-sox -V2 -n -r 44100 -c 1 silence.wav trim 0.0 6.0 >> ${fname}_tmp.log 2>&1
-
-sox -V2 silence.wav ~~hpr${ep_num}_summary.wav hpr${ep_num}_summary.wav >> ${fname}_tmp.log 2>&1
-
-echo "Adding the theme" | tee -a ${fname}_tmp.log
-sox -V2 -m "hpr${ep_num}_summary.wav" "${theme}" "hpr${ep_num}_intro.wav" >> ${fname}_tmp.log 2>&1
-
-
-if [ ${CHANNELS} -eq "2" ]
-then
-  echo "Converting mono to Stero" | tee -a ${fname}_tmp.log
-  ffmpeg -y -i "hpr${ep_num}_intro.wav" -ac 2 "hpr${ep_num}_intro_c2.wav"
-  echo "Creating the sandwitch: \"hpr${ep_num}_intro_c2.wav\" \"${fname}_mezzanine.wav\" \"${outro}\" \"hpr${ep_num}_sandwitch.wav\" " | tee -a ${fname}_tmp.log
-  sox -V2 "hpr${ep_num}_intro_c2.wav" "${fname}_mezzanine.wav" "${outro_c2}" "hpr${ep_num}_sandwitch.wav" >> ${fname}_tmp.log 2>&1
-else
-  echo "Creating the sandwitch: \"hpr${ep_num}_intro.wav\" \"${fname}_mezzanine.wav\" \"${outro}\" \"hpr${ep_num}_sandwitch.wav\" " | tee -a ${fname}_tmp.log
-  sox -V2 "hpr${ep_num}_intro.wav" "${fname}_mezzanine.wav" "${outro}" "hpr${ep_num}_sandwitch.wav" >> ${fname}_tmp.log 2>&1
-fi
-
-
-
-echo "Normalizing the wav files" | tee -a ${fname}_tmp.log
-#sox --temp "${TEMP_DIR}" --norm hpr${ep_num}_sandwitch.wav hpr${ep_num}_norm.wav
-#ffmpeg -y -i hpr${ep_num}_sandwitch.wav -filter:a "dynaudnorm=p=0.9:s=5" hpr${ep_num}_norm.wav  >> ${fname}_tmp.log 2>&1
-ffmpeg -y -i hpr${ep_num}.wav -af loudnorm=I=-16:LRA=11:TP=-1.5  hpr${ep_num}_norm.wav  >> ${fname}_tmp.log 2>&1
-
-if [ ! -d "${upload_dir_ep_num}" ]
-then
-  echo "DEBUG: Missing directory \"upload_dir_ep_num\" \"${upload_dir}\", /hpr and \"${ep_num}\"" 1>&2
-  exit
-fi
-
-if [ ! -e "hpr${ep_num}_norm.wav" ]
-then
-  echo "DEBUG: Missing file \"hpr${ep_num}_norm.wav\"" 1>&2
-  exit
-fi
-
-cp -v hpr${ep_num}_norm.wav ${upload_dir_ep_num}/hpr${ep_num}.wav >> ${fname}_tmp.log 2>&1
-
-if [ ! -e "${upload_dir_ep_num}/hpr${ep_num}.wav" ]
-then
-  echo "DEBUG: Missing file \"${upload_dir_ep_num}/hpr${ep_num}.wav\"" 1>&2
-  exit
-fi
-
-
-echo "--------------------------------------------------------------------------------" | tee -a ${fname}_tmp.log
-echo "File information" | tee -a ${fname}_tmp.log
-ffprobe ${upload_dir_ep_num}/hpr${ep_num}.wav 2>&1 | grep Audio:
-mediainfo ${upload_dir_ep_num}/hpr${ep_num}.wav
-audio2image.bash ${upload_dir_ep_num}/hpr${ep_num}.wav
-xdg-open ${upload_dir_ep_num}/hpr${ep_num}.png >/dev/null 2>&1 &
-read -p "Processed Waveform look ok ? (N|y) ? " -n 1 -r
-echo    # (optional) move to a new line
-if [[ ! $REPLY =~ ^[yY]$ ]]
-then
-  echo "skipping...."
-  exit
-fi
-#rm -v ${upload_dir_ep_num}/hpr${ep_num}.png
-
-
-echo "--------------------------------------------------------------------------------"
-echo "Geting transcript of hpr${ep_num}"
-
-echo whisper --model tiny --language en --output_dir "${media_dir}" "${upload_dir_ep_num}/hpr${ep_num}.wav" | tee -a ${fname}_tmp.log
-whisper --model tiny --language en --output_dir "${media_dir}" "${upload_dir_ep_num}/hpr${ep_num}.wav" | tee -a ${fname}_tmp.log
-
-ls -al "${media_dir}/hpr${ep_num}".*
-xdg-open "${media_dir}/hpr${ep_num}".txt 2>&1 &
-echo mpv --no-audio-display --audio-channels=stereo --speed="3.5" "${media_dir}/hpr${ep_num}".txt
-unset REPLY
-until [[ $REPLY =~ ^[yYnN]$ ]]
-do
-  read -p "Processed transcript look ok ? (N|y) ? " -n 1 -r
-  echo ""
-done
-
-if [[ ! $REPLY =~ ^[yY]$ ]]
-then
-  echo "skipping.... $REPLY"
-  exit
-fi
-
-mkdir "${upload_dir_ep_num}/hpr${ep_num}" >/dev/null 2>&1
-
-cp -v "${media_dir}/hpr${ep_num}".vtt "${upload_dir_ep_num}/hpr${ep_num}.vtt" | tee -a ${fname}_tmp.log
-cp -v "${media_dir}/hpr${ep_num}".srt "${upload_dir_ep_num}/hpr${ep_num}.srt" | tee -a ${fname}_tmp.log
-cp -v "${media_dir}/hpr${ep_num}".txt "${upload_dir_ep_num}/hpr${ep_num}.txt" | tee -a ${fname}_tmp.log
-cp -v "${media_dir}/hpr${ep_num}".tsv "${upload_dir_ep_num}/hpr${ep_num}.tsv" | tee -a ${fname}_tmp.log
-cp -v "${media_dir}/hpr${ep_num}".json "${upload_dir_ep_num}/hpr${ep_num}.json" | tee -a ${fname}_tmp.log
-
-echo "--------------------------------------------------------------------------------" | tee -a ${fname}_tmp.log
-echo "Convert to opus" | tee -a ${fname}_tmp.log
-ffmpeg -y -i ${upload_dir_ep_num}/hpr${ep_num}.wav ${upload_dir_ep_num}/hpr${ep_num}.opus 2>> ${fname}_tmp.log 1>&2
-
-echo "--------------------------------------------------------------------------------" | tee -a ${fname}_tmp.log
-echo "Convert to flac" | tee -a ${fname}_tmp.log
-ffmpeg -y -i ${upload_dir_ep_num}/hpr${ep_num}.wav ${upload_dir_ep_num}/hpr${ep_num}.flac 2>> ${fname}_tmp.log 1>&2
-
-echo "--------------------------------------------------------------------------------" | tee -a ${fname}_tmp.log
-echo "Convert to mp3" | tee -a ${fname}_tmp.log
-ffmpeg -y -i ${upload_dir_ep_num}/hpr${ep_num}.wav ${upload_dir_ep_num}/hpr${ep_num}.mp3 2>> ${fname}_tmp.log 1>&2
-
-echo "--------------------------------------------------------------------------------" | tee -a ${fname}_tmp.log
-echo "Convert to ogg" | tee -a ${fname}_tmp.log
-#ffmpeg -y -i ${upload_dir_ep_num}/hpr${ep_num}.wav ${upload_dir_ep_num}/hpr${ep_num}.ogg 2>> ${fname}_tmp.log 1>&2
-ffmpeg -y -i ${upload_dir_ep_num}/hpr${ep_num}.wav -acodec libopus -f ogg ${upload_dir_ep_num}/hpr${ep_num}.ogg 2>> ${fname}_tmp.log 1>&2
-
-echo "--------------------------------------------------------------------------------" | tee -a ${fname}_tmp.log
-echo "Convert to spx" | tee -a ${fname}_tmp.log
-ffmpeg -y -i ${upload_dir_ep_num}/hpr${ep_num}.wav ${upload_dir_ep_num}/hpr${ep_num}.spx 2>> ${fname}_tmp.log 1>&2
-
-### End conversion
-
-intro_duration="$( mediainfo --Output=XML --Full "hpr${ep_num}_intro.wav" | xmlstarlet sel -T -t -m '/_:MediaInfo/_:media/_:track[@type="Audio"]' -v '_:Duration' -n | awk -F '.' '{print $1}' )"
-outro_duration="$( mediainfo --Output=XML --Full "${outro}" | xmlstarlet sel -T -t -m '/_:MediaInfo/_:media/_:track[@type="Audio"]' -v '_:Duration' -n | awk -F '.' '{print $1}' )"
-source_duration="$( mediainfo --Output=XML --Full "${mediafile}" | xmlstarlet sel -T -t -m '/_:MediaInfo/_:media/_:track[@type="Audio"]' -v '_:Duration' -n | awk -F '.' '{print $1}' )"
-expected_duration=$(( ${intro_duration} + ${HPR_duration} + ${outro_duration} ))
-
-echo "Intro(${intro_duration}) + Show(${HPR_duration}) + Outro(${outro_duration}) = ${expected_duration}"
-
-media_error="0"
-
-for check_file in \
-${upload_dir_ep_num}/hpr${ep_num}.wav \
-${upload_dir_ep_num}/hpr${ep_num}.opus \
-${upload_dir_ep_num}/hpr${ep_num}.flac \
-${upload_dir_ep_num}/hpr${ep_num}.mp3 \
-${upload_dir_ep_num}/hpr${ep_num}.spx \
-${upload_dir_ep_num}/hpr${ep_num}.ogg
-do
-  # ${upload_dir_ep_num}/hpr${ep_num}.spx
-  echo "INFO: Processing the file \"${check_file}\""
-  if [[ ! -s "${check_file}" ]]
-  then
-    echo "ERROR: Something went wrong encoding of the file \"${check_file}\""
-    exit
-  else
-    mediainfo --Output=XML --Full "${check_file}" | xmlstarlet sel -T -t -m '/_:MediaInfo/_:media/_:track[@type="Audio"]' -v '_:Duration' -n | awk -F '.' '{print $1}'
-    this_duration=$( mediainfo --Output=XML --Full "${check_file}" | xmlstarlet sel -T -t -m '/_:MediaInfo/_:media/_:track[@type="Audio"]' -v '_:Duration' -n | awk -F '.' '{print $1}' )
-    if [[ $(abs_diff "${this_duration}" "${expected_duration}" ) -le "${acceptable_duration_difference}" ]]
-    then
-      echo "INFO: The file \"${check_file}\" duration of ${this_duration} () is close enough to ${expected_duration}"
-    else
-      echo "ERROR: The file \"${check_file}\" actual duration of ${this_duration} is not close enough to posted duration of ${expected_duration}."
-      echo "       Fix or update the posted duration to ${source_duration}."
-      media_error="1"
-    fi
-    #${expected_duration}
-  fi
-done
-echo "Source: ${source_duration}"
-
-if [[ "${media_error}" -eq "1" ]]
-then
-  echo "ERROR: Media is not encoded correctly"
-  exit
-else
-  echo "INFO: Media duration is correct"
-fi
-
-
-if [[ ! -s ${upload_dir_ep_num}/hpr${ep_num}.wav ]] || [[ ! -s ${upload_dir_ep_num}/hpr${ep_num}.opus ]] || [[ ! -s ${upload_dir_ep_num}/hpr${ep_num}.flac ]] || [[ ! -s ${upload_dir_ep_num}/hpr${ep_num}.mp3 ]] || [[ ! -s ${upload_dir_ep_num}/hpr${ep_num}.ogg ]] || [[ ! -s ${upload_dir_ep_num}/hpr${ep_num}.spx ]]
-then
-  echo "ERROR: Something went wrong encoding the files"
-  exit 1
-fi
-
-
-echo "--------------------------------------------------------------------------------" | tee -a ${fname}_tmp.log
-echo "Fixing Tags" | tee -a ${fname}_tmp.log
-
-fix_tags -album="$HPR_album" -artist="$HPR_artist" -comment="${HPR_comment} The license is ${HPR_license}" -genre="$HPR_genre" -title="$HPR_title" -track="$HPR_track" -year="$HPR_year" ${upload_dir_ep_num}/hpr${ep_num}* 2>> ${fname}_tmp.log 1>&2
-
-fix_tags ${upload_dir_ep_num}/hpr${ep_num}*
-
-#echo "Changing the file dates to the time of upload"
-touch -r ${mediafile} hpr${ep_num}*
-touch -r ${mediafile} ${upload_dir_ep_num}/hpr${ep_num}*
-
-ls -al hpr${ep_num}* ${upload_dir_ep_num}/hpr${ep_num}* | tee -a ${fname}_tmp.log
-
-# # echo "--------------------------------------------------------------------------------" | tee -a ${fname}_tmp.log
-# # echo "Getting info for the asset table" | tee -a ${fname}_tmp.log
-# #
-# # echo "INSERT INTO assets (episode_id,filename,extension,size,sha1sum,mime_type,file_type) VALUES"
-# #
-# # for asset_file in \
-# # ${upload_dir_ep_num}/hpr${ep_num}.wav \
-# # ${upload_dir_ep_num}/hpr${ep_num}.opus \
-# # ${upload_dir_ep_num}/hpr${ep_num}.flac \
-# # ${upload_dir_ep_num}/hpr${ep_num}.mp3 \
-# # ${upload_dir_ep_num}/hpr${ep_num}.spx \
-# # ${upload_dir_ep_num}/hpr${ep_num}.ogg
-# # do
-# #   size="$( ls -al "${asset_file}" | awk '{print $5}' )"
-# #   sha1sum="$( sha1sum "${asset_file}" | awk '{print $1}' )"
-# #   mime_type=$( file --dereference --brief --mime "${asset_file}" )
-# #   file_type=$( file --dereference --brief "${asset_file}" )
-# #   echo "(${ep_num},'${filename}','${extension}','${size}','${sha1sum}','${mime_type}','${file_type}'),"
-# # done
-
-echo "--------------------------------------------------------------------------------" | tee -a ${fname}_tmp.log
-echo "Transferring files to Servers" | tee -a ${fname}_tmp.log
-
-
-#rsync -ave ssh --partial --progress --ignore-existing ${upload_dir_ep_num}/hpr${ep_num}.mp3 ${upload_dir_ep_num}/hpr${ep_num}.ogg ${upload_dir_ep_num}/hpr${ep_num}.spx hpr:www/eps/
-
-#firefox "https://hackerpublicradio.org/local/hpr${ep_num}.mp3" >/dev/null 2>&1 &
-#firefox "https://hackerpublicradio.org/local/hpr${ep_num}.ogg" >/dev/null 2>&1 &
-firefox "file://${upload_dir_ep_num}/hpr${ep_num}.mp3" >/dev/null 2>&1 &
-firefox "file://${upload_dir_ep_num}/hpr${ep_num}.ogg" >/dev/null 2>&1 &
-#firefox "https://hackerpublicradio.org/eps.php?id=${ep_num}" >/dev/null 2>&1 &
-
-#mpv "http://hackerpublicradio.org/local/hpr${ep_num}.spx" "http://hackerpublicradio.org/local/hpr${ep_num}.ogg" "http://hackerpublicradio.org/local/hpr${ep_num}.mp3" "file://${upload_dir_ep_num}/hpr${ep_num}.spx" "file://${upload_dir_ep_num}/hpr${ep_num}.opus" "file://${upload_dir_ep_num}/hpr${ep_num}.ogg" "file://${upload_dir_ep_num}/hpr${ep_num}.mp3" "file://${upload_dir_ep_num}/hpr${ep_num}.flac"
-mpv "file://${upload_dir_ep_num}/hpr${ep_num}.spx" "file://${upload_dir_ep_num}/hpr${ep_num}.opus" "file://${upload_dir_ep_num}/hpr${ep_num}.ogg" "file://${upload_dir_ep_num}/hpr${ep_num}.mp3" "file://${upload_dir_ep_num}/hpr${ep_num}.flac"
-
-read -p "Remove files for \"${fname}\" (y|N) ? " -n 1 -r
-echo    # (optional) move to a new line
-if [[ $REPLY =~ ^[Yy]$ ]]
-then
-  mediafilename=$(basename "${mediafile}")
-  mediaextension="${mediafilename##*.}"                                             # "
-#   ssh hpr -t "mkdir /home/hpr/www/eps/hpr${ep_num}" >/dev/null 2>&1
-#   rsync -ave ssh --partial --progress --ignore-existing "${mediafile}" hpr:www/eps/hpr${ep_num}/hpr${ep_num}_source.${mediaextension} | tee -a ${fname}_tmp.log
-#
-#   rsync -ave ssh --partial --progress --ignore-existing "${media_dir}/hpr${ep_num}.wav".vtt hpr:www/eps/hpr${ep_num}/hpr${ep_num}.vtt | tee -a ${fname}_tmp.log
-#   rsync -ave ssh --partial --progress --ignore-existing "${media_dir}/hpr${ep_num}.wav".srt hpr:www/eps/hpr${ep_num}/hpr${ep_num}.srt | tee -a ${fname}_tmp.log
-#   rsync -ave ssh --partial --progress --ignore-existing "${media_dir}/hpr${ep_num}.wav".txt hpr:www/eps/hpr${ep_num}/hpr${ep_num}.txt | tee -a ${fname}_tmp.log
-#   f
-#   ssh hpr -t "ls -al /home/hpr/www/eps/hpr${ep_num}*"
-  cp -v "${mediafile}" "${upload_dir_ep_num}/hpr${ep_num}_source.${mediaextension}"
-
-  #echo "Remove temp files"
-  # rm -v ~hpr${ep_num}_summary.wav ~~hpr${ep_num}_summary.wav silence.wav
-  # rm -v ${fname}_mezzanine.wav ${fname}_tmp*.pcm ${fname}_tmp.log ${fname}_mez.wav
-  #mv -v ${fname}* hpr${ep_num}*  *_${ep_num}_* /var/IA/done/
-
-#   wget --timeout=0 -q "http://hackerpublicradio.org/hpr_ogg_rss.php?gomax=1" -O - | xmlstarlet val --err -
-#   wget --timeout=0 -q "http://hackerpublicradio.org/hpr_mp3_rss.php?gomax=1" -O - | xmlstarlet val --err -
-#   wget --timeout=0 -q "http://hackerpublicradio.org/hpr_spx_rss.php?gomax=1" -O - | xmlstarlet val --err -
-#   wget --timeout=0 -q "http://hackerpublicradio.org/rss-future.php" -O - | xmlstarlet val --err -
-
-  echo "INFO: rsync -ave ssh --partial --progress ${upload_dir}/hpr${ep_num}* borg:/data/IA/uploads/"
-  rsync -ave ssh --partial --progress ${upload_dir}/hpr${ep_num}* borg:/data/IA/uploads/
-  echo "INFO: rsync -ave ssh --partial --progress ${upload_dir}/hpr${ep_num}* rsync.net:processing/"
-  rsync -ave ssh --partial --progress ${upload_dir}/hpr${ep_num}* rsync.net:processing/
-  echo "$( ssh borg -t "ls -al /data/IA/uploads/hpr${ep_num}*" ; ssh rsync.net -t "ls -al rsync.net:processing/hpr${ep_num}*" ; ls -al ${upload_dir}/hpr${ep_num}* )" | grep "hpr${ep_num}" | awk '{print $5, $NF}' | sort
-# ken@kalani: 
-# rsync -av --partial --progress /var/IA/uploads/ vger:processing/
-# $HOME/sourcecode/hpr/hpr_hub.wip/bin/hpr-assets.bash
-
-# root@vger:~# 
-# rsync -av --progress --partial $HOME/processing/ /mnt/data/hpr/eps/
-# find /mnt/data/hpr/eps/ -mindepth 1 -maxdepth 1 -type f | grep -vE 'assets.csv|assets.json' |  while read i;do mv -fv ${i} $(dirname ${i})/$(basename ${i%.*} | cut -c -7 )/;done
-# find /mnt/data/hpr/eps/ -type f \( -iname "*source*" -o -iname "*flac*" -o -iname "*wav*" \) -delete -print
-# chcon -R --type=httpd_sys_rw_content_t /mnt/data/hpr/
-# chown apache:apache /mnt/data/hpr/
-
-# ken@kalani: 
-# sshfs vger:/ /mnt/sshfs/vger/
-# sshfs rsync.net: /mnt/sshfs/rsync.net/
-# rsync -av --partial --progress /mnt/sshfs/vger/mnt/data/hpr/eps/ /mnt/sshfs/rsync.net/hpr/eps/
-
-# https://hpr.nyc3.cdn.digitaloceanspaces.com/eps/hpr1404/hpr1404.mp3
-# https://alpha.nl.eu.mirror.hackerpublicradio.org/eps/hpr4271/hpr4271.mp3
-# https://archive.org/download/hpr4268/hpr4268.ogg
-
-# set eps.valid=1
-
-  if [ ${show_type} == "remote" ]
-  then
-    echo "INFO: Setting the status"
-    # SHOW_SUBMITTED → METADATA_PROCESSED → SHOW_POSTED → MEDIA_TRANSCODED → UPLOADED_TO_IA → UPLOADED_TO_RSYNC_NET
-    curl --netrc-file ${HOME}/.netrc "https://hub.hackerpublicradio.org/cms/status.php?ep_num=${ep_num}&status=MEDIA_TRANSCODED"
-    curl --silent --netrc-file ${HOME}/.netrc "https://hub.hackerpublicradio.org/cms/status.php"
-  fi
-else
-  echo "skipping...."
-  echo "cp -v \"${mediafile}\" \"${upload_dir_ep_num}/hpr${ep_num}_source.${mediaextension}\""
-#   echo "rm -v ${fname}_mezzanine.wav ${fname}_tmp*.pcm ${fname}_tmp.log ${fname}_mez.wav"
-  #echo "mv -v ${fname}* hpr${ep_num}*  *_${ep_num}_* /var/IA/done/"
-  echo "wget --timeout=0 -q \"http://hackerpublicradio.org/hpr_ogg_rss.php?gomax=1\" -O - | xmlstarlet val --err -"
-  echo "wget --timeout=0 -q \"http://hackerpublicradio.org/hpr_mp3_rss.php?gomax=1\" -O - | xmlstarlet val --err -"
-  echo "wget --timeout=0 -q \"http://hackerpublicradio.org/hpr_spx_rss.php?gomax=1\" -O - | xmlstarlet val --err -"
-  echo "rsync -ave ssh --partial --progress ${upload_dir}/hpr${ep_num}* borg:/data/IA/uploads/"
-fi

workflow/intro.srt

@@ -0,0 +1,20 @@
+1
+00:00:00,000 --> 00:00:13,200
+REPLACE_LINE_1
+
+2
+00:00:13,200 --> 00:00:16,400
+REPLACE_LINE_2
+
+3
+00:00:16,400 --> 00:00:20,040
+REPLACE_LINE_3
+
+4
+00:00:20,040 --> 00:00:22,080
+REPLACE_LINE_4
+
+5
+00:00:22,080 --> 00:00:27,320
+REPLACE_LINE_5
+

workflow/mdb.bash

@@ -0,0 +1,4 @@
+#!/bin/bash
+pw=$(grep -E '^\$databasePassword = ' /home/hpr/php/credentials.php | awk -F "'" '{print $2}' )
+pw=${pw##* }
+mysql --host=localhost --user=hpr_hpr --password="$pw" hpr_hpr

workflow/outro.srt

@@ -0,0 +1,31 @@
+1
+00:00:00,000 --> 00:00:07,720
+You have been listening to Hacker Public Radio at Hacker Public Radio.org.
+
+2
+00:00:07,720 --> 00:00:11,520
+Today's show was contributed by a HPR listener like yourself.
+
+3
+00:00:11,520 --> 00:00:18,000
+If you ever thought of recording podcast, click on our upload link
+
+4
+00:00:18,000 --> 00:00:19,000
+ to find out how easy it is.
+
+5
+00:00:19,000 --> 00:00:26,480
+Hosting for HPR has been kindly provided by an AnHonestHost.com, the Internet Archive,
+
+6
+00:00:26,480 --> 00:00:27,480
+rsync.net, and our mirror network.
+
+7
+00:00:27,480 --> 00:00:33,480
+Unless otherwise stated, today's show is released under a Creative Commons
+
+8
+00:00:33,480 --> 00:00:36,480
+Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

workflow/postshow.bash

@@ -1,339 +0,0 @@
-#!/usr/bin/env bash
-# Copyright Ken Fallon - Released into the public domain. http://creativecommons.org/publicdomain/ 
-#============================================================
-
-processing_dir="$HOME/tmp/hpr/processing" # The directory where the files will be copied to for processing
-
-if [ ! -d "${processing_dir}" ]
-then
-  echo "ERROR: The application \"${this_program}\" is required but is not installed."
-  exit 1
-fi
-
-###################
-# Check that all the programs are installed
-
-function is_installed () {
-  for this_program in "$@"
-  do
-    if ! command -v ${this_program} 2>&1 >/dev/null
-    then
-      echo "ERROR: The application \"${this_program}\" is required but is not installed."
-      exit 2
-    fi
-  done
-}
-
-is_installed awk base64 cat curl curl date detox eval ffprobe file find grep grep head jq jq kate magick mediainfo mv mv rsync rsync seamonkey sed sed sort sponge ssh touch touch wget
-
-echo "Processing the next HPR Show in the queue"
-
-###################
-# Get the show
-#
-# Replaced METADATA_PROCESSED with SHOW_SUBMITTED
-response=$( curl --silent --netrc-file ${HOME}/.netrc "https://hub.hackerpublicradio.org/cms/status.php" | \
-grep ',SHOW_SUBMITTED,' | \
-head -1 | \
-sed 's/,/ /g' )
-
-if [ -z "${response}" ]
-then
-  echo "INFO: There appear to be no more shows with the status \"SHOW_SUBMITTED\"."
-  echo "Getting a list of all the reservations."
-  curl --silent --netrc-file ${HOME}/.netrc "https://hub.hackerpublicradio.org/cms/status.php" | sort -n
-  exit 3
-fi
-
-timestamp_epoc="$( echo ${response} | awk '{print $1}' )"
-ep_num="$( echo ${response} | awk '{print $2}' )"
-ep_date="$( echo ${response} | awk '{print $3}' )"
-key="$( echo ${response} | awk '{print $4}' )"
-status="$( echo ${response} | awk '{print $5}' )"
-email="$( echo ${response} | awk '{print $6}' )"
-email_unpadded="$( echo $email | sed 's/.nospam@nospam./@/g' )"
-
-upload_dir="/home/hpr/upload/${timestamp_epoc}_${ep_num}_${ep_date}_${key}"
-source_dir="hpr:${upload_dir}"
-publish_dir="hpr:www/eps/hpr${ep_num}"
-dest_dir="${timestamp_epoc}_${ep_num}_${ep_date}_${key}"
-
-ssh hpr -t "detox -v ${upload_dir}/"
-
-echo "INFO: Downloading hpr${ep_num} from ${email_unpadded}"
-echo ""
-echo rsync -ave ssh --partial --progress ${source_dir}/ ${processing_dir}/${dest_dir}/
-rsync -ave ssh --partial --progress ${source_dir}/ ${processing_dir}/${dest_dir}/
-echo ""
-echo "INFO: Working directory is \"${processing_dir}/${dest_dir}/\""
-echo ""
-
-shownotes_json="${processing_dir}/${dest_dir}/shownotes.json"
-
-if [ ! -s "${shownotes_json}" ]
-then
-  echo "ERROR: \"${shownotes_json}\" is missing"
-  exit 4
-fi
-
-if [ "$( file "${shownotes_json}" | grep -ic "text" )" -eq 0 ]
-then
-  echo "ERROR: \"${shownotes_json}\" is not a text file"
-  exit 5
-fi
-
-mv -v "${shownotes_json}" "${shownotes_json%.*}_origional.json"
-
-jq '.' "${shownotes_json%.*}_origional.json" > "${shownotes_json}"
-
-###################
-# Get the media
-#
-
-remote_media="$( jq --raw-output '.metadata.url' "${shownotes_json}" )"
-
-if [ -n "${remote_media}" ]
-then
-  echo "INFO: Fetching remote media from \"${remote_media}\""
-  wget --timestamping  --directory-prefix="${processing_dir}/${dest_dir}/" "${remote_media}"
-  if [ $? -ne 0 ]
-  then
-    echo "ERROR: Could not get the remote media"
-    exit 6
-  fi
-fi
-
-shownotes_html="${processing_dir}/${dest_dir}/shownotes.html"
-
-jq --raw-output '.episode.Show_Notes' "${shownotes_json}" > "${shownotes_html}"
-
-if [ ! -s "${shownotes_html}" ]
-then
-  echo "ERROR: \"${shownotes_html}\" is missing"
-  exit 7
-fi
-
-# Process Shownotes
-sed "s#>#>\n#g" "${shownotes_html}" | sponge "${shownotes_html}"
-
-# Extract Images
-## TODO Temp fix until https://repo.anhonesthost.net/HPR/hpr-tools/issues/3
-
-image_count="1"
-
-for image in $( grep --color=never --perl-regexp --only-matching 'data:image/[^;]*;base64,\K[a-zA-Z0-9+/=]*' "${shownotes_html}" )
-do
-  this_image="${processing_dir}/${dest_dir}/hpr${ep_num}_${image_count}"
-  echo -n "$image" | base64 -di > ${this_image}
-  this_ext="$( file --mime-type ${this_image} | awk -F '/' '{print $NF}' )"
-  mv -v "${this_image}" "${this_image}.${this_ext}"
-  this_width="$( mediainfo "${this_image}.${this_ext}" | grep Width | awk -F ': | pixels' '{print $2}' | sed 's/ //g' )"
-  if [ "${this_width}" -gt "400" ]
-  then
-    magick "${this_image}.${this_ext}" -resize 400x "${this_image}_tn.${this_ext}"
-  fi
-  ((image_count=image_count+1))
-done
-
-for image in $( grep --color=never --perl-regexp --only-matching '<img.*src.*http.*>' "${shownotes_html}" | awk -F 'src=' '{print $2}' | awk -F '"' '{print $2}' )
-do
-  this_image="${processing_dir}/${dest_dir}/hpr${ep_num}_${image_count}"
-  wget "${image}" --output-document=${this_image}
-  this_ext="$( file --mime-type ${this_image} | awk -F '/' '{print $NF}' )"
-  if [ ! -e "${this_image}.${this_ext}" ]
-  then
-    mv -v "${this_image%.*}" "${this_image}.${this_ext}"
-  fi
-  this_width="$( mediainfo "${this_image}.${this_ext}" | grep Width | awk -F ': | pixels' '{print $2}' | sed 's/ //g' )"
-  if [ "${this_width}" -gt "400" ]
-  then
-    magick "${this_image}.${this_ext}" -resize 400x "${this_image}_tn.${this_ext}"
-  fi
-  ((image_count=image_count+1))
-done
-
-## TODO End Temp fix until https://repo.anhonesthost.net/HPR/hpr-tools/issues/3
-
-ls -al "${processing_dir}/${dest_dir}/"
-
-## Manually edit the shownotes to fix issues
-
-kate "${shownotes_html}" >/dev/null 2>&1 &
-# librewolf "${shownotes_html}" >/dev/null 2>&1 &
-seamonkey "${shownotes_html}" >/dev/null 2>&1 &
-# bluefish "${shownotes_html}" >/dev/null 2>&1 &
-
-read -p "Does the metadata 'look ok ? (N|y) ? " -n 1 -r
-echo    # (optional) move to a new line
-if [[ ! $REPLY =~ ^[yY]$ ]]
-then
-  echo "skipping...."
-  exit 8
-fi
-
-media=$( find "${processing_dir}/${dest_dir}/" -type f -exec file {} \; | grep -Ei 'audio|mpeg|video|MP4' | awk -F ': ' '{print $1}' )
-if [ -z "${media}" ]
-then
-  echo "ERROR: Can't find any media in \"${processing_dir}/${dest_dir}/\""
-  find "${processing_dir}/${dest_dir}/" -type f
-  exit 9
-fi
-
-the_show_media=""
-
-if [ "$( echo "${media}" | wc -l )" -ne 1 ]
-then
-  echo "Multiple files found. Which one do you want to use ?"
-  select this_media in $( echo "${media}" )
-  do 
-    echo "INFO: You selected \"${this_media}\"."
-    ls -al "${this_media}"
-    the_show_media="${this_media}"
-    break
-  done
-else
-  echo "INFO: Selecting media as \"${media}\"."
-  the_show_media="${media}"
-fi
-
-duration=$( \date -ud "1970-01-01 $( ffprobe -i "${the_show_media}" 2>&1| awk -F ': |, ' '/Duration:/ { print $2 }' )" +%s )
-if [ $? -ne 0 ]
-then
-  echo 'ERROR: Invalid duration found in '\"${media}\" >&2
-  exit 10
-fi
-
-###################
-# Gather episode information
-#
-
-if [ "$( curl --silent --write-out '%{http_code}'  http://hackerpublicradio.org/say.php?id=${ep_num} --output /dev/null )" == 200 ]
-then
-  echo "ERROR: The Episode hpr${ep_num} has already been posted"
-  exit 11
-fi
-
-if [ "$( jq --raw-output '.metadata.Episode_Number' ${shownotes_json} )" != "${ep_num}" ]
-then
-  echo "ERROR: The Episode_Number: \"${ep_num}\" was not found in \"${shownotes_json}\""
-  exit 12
-fi
-
-if [ "$( jq --raw-output '.metadata.Episode_Date' ${shownotes_json} )" != "${ep_date}" ]
-then
-  echo "ERROR: The Episode_Date: \"${ep_date}\" was not found in \"${shownotes_json}\""
-  exit 13
-fi
-
-if [ "$( jq --raw-output '.host.Host_Email' ${shownotes_json} )" != "${email_unpadded}" ]
-then
-  echo "ERROR: The Host_Email: \"${email_unpadded}\" was not found in \"${shownotes_json}\""
-  exit 14
-fi
-
-###################
-# Assemble the components
-#
-# https://newbedev.com/how-to-urlencode-data-for-curl-command/
-hostid="$( jq --raw-output '.host.Host_ID' ${shownotes_json} | jq --slurp --raw-input @uri | sed -e 's/%0A"$//g' -e 's/^"//g'  )"
-host_name="$( jq --raw-output '.host.Host_Name' ${shownotes_json} | jq --slurp --raw-input @uri | sed -e 's/%0A"$//g' -e 's/^"//g' )"
-title=$( jq --raw-output '.episode.Title' ${shownotes_json} | jq --slurp --raw-input @uri | sed -e 's/%0A"$//g' -e 's/^"//g' )
-summary="$( jq --raw-output '.episode.Summary' ${shownotes_json} | jq --slurp --raw-input @uri | sed -e 's/%0A"$//g' -e 's/^"//g'  )"
-series_id="$( jq --raw-output '.episode.Series' ${shownotes_json} | jq --slurp --raw-input @uri | sed -e 's/%0A"$//g' -e 's/^"//g'  )"
-series_name="$( jq --raw-output '.episode.Series_Name' ${shownotes_json} | jq --slurp --raw-input @uri | sed -e 's/%0A"$//g' -e 's/^"//g' )"
-explicit="$( jq --raw-output '.episode.Explicit' ${shownotes_json} | jq --slurp --raw-input @uri | sed -e 's/%0A"$//g' -e 's/^"//g'  )"
-episode_license="$( jq --raw-output '.episode.Show_License' ${shownotes_json}  | jq --slurp --raw-input @uri | sed -e 's/%0A"$//g' -e 's/^"//g' )"
-tags="$( jq --raw-output '.episode.Tags' ${shownotes_json} | jq --slurp --raw-input @uri | sed -e 's/%0A"$//g' -e 's/^"//g' )"
-host_license=$( jq --raw-output '.host.Host_License' ${shownotes_json} | jq --slurp --raw-input @uri | sed -e 's/%0A"$//g' -e 's/^"//g' )
-host_profile=$( jq --raw-output '.host.Host_Profile' ${shownotes_json} | jq --slurp --raw-input @uri | sed -e 's/%0A"$//g' -e 's/^"//g' )
-
-notes="$( cat "${shownotes_html}" | jq --slurp --raw-input @uri | sed -e 's/%0A"$//g' -e 's/^"//g'  )"
-
-if [ $# -gt 0 ]
-then
-  declare -A hash
-  for argument
-  do
-    if [[ $argument =~ ^[^=]+=.*$ ]]
-    then
-      this_key="${argument%=*}"                                 # "${} Kate format hack
-      this_value="${argument#*=}"                               # "${} Kate format hack
-      this_value="$( echo "${this_value}" | jq --slurp --raw-input @uri | sed -e 's/%0A"$//g' -e 's/^"//g'  )"
-      eval "${this_key}=${this_value}"
-      echo "INFO: Replacing \"${this_key}\" with \"${this_value}\"."
-    fi
-  done
-fi
-
-if [ "${hostid}" == '0' ]
-then
-  echo "ERROR: The hostid is 0. Create the host and use \"hostid=???\" to override"
-  exit 15
-fi
-
-###################
-# Post show to HPR
-#
-
-post_show_json="${processing_dir}/${dest_dir}/post_show.json"
-post_show_response="${processing_dir}/${dest_dir}/post_show_response.txt"
-
-echo "Sending:"
-cat "${post_show}"
-echo "key=${key}
-ep_num=${ep_num}
-ep_date=${ep_date}
-email=${email}
-title=${title}
-duration=${duration}
-summary=${summary}
-series_id=${series_id}
-series_name=${series_name}
-explicit=${explicit}
-episode_license=${episode_license}
-tags=${tags}
-hostid=${hostid}
-host_name=${host_name}
-host_license=${host_license}
-host_profile=${host_profile}
-notes=${notes}"
-
-echo "{
-  \"key\": \"${key}\",
-  \"ep_num\": \"${ep_num}\",
-  \"ep_date\": \"${ep_date}\",
-  \"email\": \"${email}\",
-  \"title\": \"${title}\",
-  \"duration\": \"${duration}\",
-  \"summary\": \"${summary}\",
-  \"series_id\": \"${series_id}\",
-  \"series_name\": \"${series_name}\",
-  \"explicit\": \"${explicit}\",
-  \"episode_license\": \"${episode_license}\",
-  \"tags\": \"${tags}\",
-  \"hostid\": \"${hostid}\",
-  \"host_name\": \"${host_name}\",
-  \"host_license\": \"${host_license}\",
-  \"host_profile\": \"${host_profile}\",
-  \"notes\": \"${notes}\"
-}" | tee "${post_show_json}"
-
-echo "INFO: Uploading processed files to \"${processing_dir}/${dest_dir}/\""
-echo ""
-echo rsync -ave ssh --partial --progress ${processing_dir}/${dest_dir}/ ${source_dir}/ 
-rsync -ave ssh --partial --progress ${processing_dir}/${dest_dir}/ ${source_dir}/ 
-echo ""
-
-curl --netrc --include --request POST "https://hub.hackerpublicradio.org/cms/add_show_json.php" --header "Content-Type: application/json" --data-binary "@${post_show_json}"
-
-if [ "$( curl --silent --write-out '%{http_code}'  http://hackerpublicradio.org/say.php?id=${ep_num} --output /dev/null )" != 200 ]
-then
-  echo "ERROR: The Episode hpr${ep_num} has not been posted"
-  exit 16
-fi
-
-echo "INFO: Uploading completed files to \"${publish_dir}/\""
-echo ""
-echo "rsync -ave ssh --partial --progress \"${processing_dir}/${dest_dir}/hpr${ep_num}\"* \"${publish_dir}/\""
-rsync -ave ssh --partial --progress "${processing_dir}/${dest_dir}/hpr${ep_num}"* "${publish_dir}/"
-echo ""

workflow/remove-image.pl

@@ -0,0 +1,12 @@
+#!/usr/bin/env perl
+
+use strict;
+
+while (<>) {
+    s/(<img.*src.*data:image\/[^;]*;base64,[a-zA-Z0-9+\/=]*)/<img src="LOCAL_IMAGE_REMOVED/g;
+    s/(<img.*src.*http.*>)/<img src="REMOTE_IMAGE_REMOVED" \/>/g;
+    print;
+}
+
+exit
+# <img src="data:image/jpeg;base64,/9j/4QnuRXhpZgAATU

workflow/run-speedtest.bash

@@ -0,0 +1,6 @@
+#!/bin/bash
+
+# * * * * * /usr/local/bin/run-speedtest.bash >/dev/null 2>&1
+
+speedtest-cli --json | jq '.' > /var/www/html/speedtest.json
+chown apache:apache /var/www/html/speedtest.json

workflow/update-stats.bash

@@ -0,0 +1,8 @@
+#!/bin/bash
+
+hub_dir="/home/hpr/hub"
+
+for format in txt csv json xml
+do 
+  curl --silent --netrc-file /home/hpr/.netrc https://hub.hackerpublicradio.org/cms/stats.php?format=${format} --output ${hub_dir}/stats.${format} 
+done