flnews_post_proc 2.05 → 2.08

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87bf0a3e9a8c5ab513c440c94fd798aba136a4fd72fb351cfbf133f1270e2758
-  data.tar.gz: 32f644c07859db2b6569621b471a786e4409e0cdaffb5e67a193e54d7f7e99a7
+  metadata.gz: 2c91b6463159cb90bf142d575d81505c73a93fd978c3c8ea6dd8318edd34a59e
+  data.tar.gz: fcc43bbb8fa81b02fcf85ebebc3c89a299659067fa5ea0fb4914fe1fb2014302
 SHA512:
-  metadata.gz: ae7465a7d6e9ec4dee294344bbdb1d6c10950351f6d5eeddb84c324d3700e653d4bb305170415071632208b3f5ec0e2f4ec05ada59dee07d9426cde2f7e87a1d
-  data.tar.gz: e0180d504592a9ab223d46c994b5a79ae81bb5a2b62970915b0b683d546c79ef2affdd12c6b17932f71a63639d9fc8c25ad41289ec69ce03a429ae71db6c92b0
+  metadata.gz: e3ea12979ad3b9230cf41854d0204ba2f443122438dd4b1d2990ca822f578d74dac23c42108607248f6cdb6b70acc40c4f0016ab44e60c93f670e6e07b4b83f6
+  data.tar.gz: 1b4463b3048db04aa62e4f6d50dae998303fac7f30f52fd5bb1b93e9315fd784181c8bcc9170c3d14c9ba03beba4064fceb6cb5a907fd4aa6e112f4c23ea8572

data/bin/flnews_post_proc

@@ -62,6 +62,7 @@ config = Configuration::instance
 if (!STDIN.tty?)
   # read from STDIN
   artext = ARGF.read
+  artext.force_encoding('UTF-8')
 
   # There is content, create the post-processor.
   if !artext.strip.empty? 

data/changes.txt

@@ -1,5 +1,32 @@
+V. 2.08
+    *) Bugfix: A random signature could not be set due to 
+       the interfering process of rearranging them in the signature
+       file. -> Changed the order of actions.
+    *) The gem tool suddenly imposes duplication of the homepage
+       URL in the specs. Okay. Done. Beats me.
+
+v. 2.07
+    *) Logging: exception in case of invalid target file is now handled.
+    *) Configuration variable “NAME_POSTPROCESSOR” can be set to true
+       or yes in order to create a custom header 
+       X-Post-Processor: flnews_post_proc [version]
+       The default is empty, no or false, i.e. no additional header.
+       The setting is independent of the presence of other custom headers
+       and cannot be influenced in the Override Dialog, only in the
+       configuration file.
+
+v. 2.06
+    *) The content of the signature file is (again) rearranged after
+       having picked a random signature, to provide for better randomness.
+       It is not proven that this is better but something must be done.
+
+    *) Ruby 4.1.0 chokes again at an encoding mismatch, when calling
+       Array.join('delimiter') before the encoding is enforced. I have
+       forced UTF-8 an all Array elements prior join(). This works now.
+
 v.2.05
     *) Gemspec: Dependency for io-console added.
+
 v.2.04
     *) Gemspec: Dependencies added
        -) gem New_rfc_2047 was missing from the specs.

data/doc/fr/html/flnews_post_proc.html

@@ -82,7 +82,7 @@
 
         <li>
           <p><a class="reference internal" href=
-          "#autres-informations" id="toc-entry-7">Autres
+          "#autres-informations-1" id="toc-entry-7">Autres
           Informations</a>
           </p>
 
@@ -346,6 +346,24 @@
           </li>
         </ul>
 
+        <p>Il existe une option supplémentaire, désactivée par
+        défaut, que vous ne pouvez activer que dans la boîte de
+        dialogue et nulle part ailleurs :</p>
+
+        <ul class="simple">
+          <li>
+            <p>Le message en cours peut être enregistré comme
+            brouillon, au lieu d'être publié sur Usenet.</p>
+          </li>
+        </ul>
+
+        <p>Si votre configuration contient le chemin d'accès à un
+        répertoire destiné à ces brouillons (option
+        <em>DRAFT_DIR</em>), celui-ci sera utilisé pour stocker ces
+        brouillons ; sinon, c'est le répertoire temporaire défini
+        par la variable d'environnement <em>$TEMP</em> qui sera
+        utilisé.</p>
+
         <p>En tapant Esc ou en poussant le bouton « Annuler » du
         dialogue, vous pouvez interrompre le processus, flnews ne
         va pas envoyer l'article.</p>
@@ -517,6 +535,27 @@ alt.fr.test: /home/[utilisateur]/.signatures</pre>
 - 'X-Another-Header: care not!'</pre>
         </blockquote>
 
+        <p><strong>NAME_POSTPROCESSOR</strong>
+        </p>
+
+        <blockquote>
+          <p>Si la valeur est "yes" ou "true", ajoute une entête
+          "X-Post-Processor" avec le nom et la version du
+          programme. Laissez vide ou notez explicitement "no" ou
+          "false" afin d'éviter la création de l'entête. Ce réglage
+          est indépendant de la présence ou absence d'autres
+          entêtes supplémentaires et ne peut pas être manipulé dans
+          le dialog graphique avant l'envoi d'un message, seulement
+          dans le fichier de configuration.</p>
+
+          <p>CONTENU : yes, YES, True, no, NO, vide, False et
+          variations.</p>
+
+          <p>PAR DÉFAUT : Vide</p>
+
+          <p>EXEMPLE : Yes</p>
+        </blockquote>
+
         <p><strong>NO_ARCHIVE_GROUPS</strong>
         </p>
 
@@ -682,7 +721,7 @@ alt.fr.test: /home/[utilisateur]/.signatures</pre>
 
           <p>PAR DÉFAUT : yes</p>
 
-          <p>EXEMPLE: No</p>
+          <p>EXEMPLE : No</p>
         </blockquote>
 
         <p><strong>USE_OLD</strong>
@@ -699,14 +738,49 @@ alt.fr.test: /home/[utilisateur]/.signatures</pre>
           <p>Ne changez pas cette variable ou notez la valeur
           'false' afin d'ignorer les changements de l'objet.</p>
 
-          <p>PAR DEFAUT: false</p>
+          <p>PAR DÉFAUT : false</p>
 
-          <p>EXEMPLE: yes</p>
+          <p>EXEMPLE : yes</p>
+        </blockquote>
+
+        <p id="draft-dir"><strong>DRAFT_DIR</strong>
+        </p>
+
+        <blockquote>
+          <p>Chemin d'accès au répertoire contenant les brouillons
+          de messages.</p>
+
+          <p>Vous pouvez activer l'option <em>DRAFT_ONLY</em> dans
+          la boîte de <cite>Dialogue pour désactiver des
+          options</cite>. Le message en cours sera alors enregistré
+          dans ce répertoire, <strong>au lieu d'être
+          publié</strong> sur Usenet. Si vous ne renseignez pas
+          cette option, un répertoire temporaire ($TEMP) sera
+          utilisé à la place. Les fichiers de brouillon seront
+          nommés selon le schéma suivant :</p>
+
+          <blockquote>
+            <p>[n][1er_groupe][++].draft</p>
+          </blockquote>
+
+          <p>où <em>n</em> correspond au nombre de fichiers dans ce
+          répertoire, <em>1er_groupe</em> au premier groupe de
+          discussion auquel le message était adressé et <em>++</em>
+          à un suffixe facultatif, indiquant qu’il y a d’autres
+          groupes de discussion dans la liste (publication
+          croisée). Le contenu d’un fichier brouillon correspond au
+          corps actuel du message, précédé de la liste des groupes
+          de discussion.</p>
+
+          <p>PAR DÉFAUT : vide</p>
+
+          <p>EXEMPLE : ~/flnews_brouillons</p>
         </blockquote>
       </section>
     </section>
 
-    <section id="autres-informations">
+    <section id="autres-informations-1">
+      <span id="autres-informations"></span>
       <h2>Autres Informations</h2>
 
       <section id="changement-de-l-objet-1">
@@ -908,7 +982,7 @@ alt.fr.test: /home/[utilisateur]/.signatures</pre>
         "https://creativecommons.org/licenses/by-nd/4.0/deed.fr">CC
         BY-ND 4.0</a></p>
 
-        <p>Date: 2026-08-11</p>
+        <p>Date: 2026-09-11</p>
 
         <p><strong>Ω</strong>
         </p>
@@ -917,7 +991,7 @@ alt.fr.test: /home/[utilisateur]/.signatures</pre>
   </main>
 
   <div id='page_dt'>
-    2026-08-11
+    2026-09-11
   </div>
 </body>
 </html>

data/doc/fr/rst/flnews_post_proc.rst

@@ -142,6 +142,15 @@ Vous **ne pouvez pas** activer des options qui n'ont pas été activées au pré
 
 * L'écriture d'un protocole peut être arrêtée.  
 
+Il existe une option supplémentaire, désactivée par défaut, que vous ne pouvez activer que dans la boîte de dialogue et nulle part ailleurs :
+
+* Le message en cours peut être enregistré comme brouillon, au lieu d'être publié sur Usenet.
+
+Si votre configuration contient le chemin d'accès à un répertoire destiné à ces
+brouillons (option *DRAFT_DIR*), celui-ci sera utilisé pour stocker ces
+brouillons ; sinon, c'est le répertoire temporaire défini par la variable
+d'environnement *$TEMP* qui sera utilisé.
+
 En tapant Esc ou en poussant le bouton « Annuler » du dialogue, vous pouvez
 interrompre le processus, flnews ne va pas envoyer l'article.
 
@@ -271,6 +280,22 @@ Options de configuration
         - 'X-My-Header: nothing fancy'
         - 'X-Another-Header: care not!' 
 
+**NAME_POSTPROCESSOR**
+
+    Si la valeur est "yes" ou "true", ajoute une entête "X-Post-Processor" avec
+    le nom et la version du programme. Laissez vide ou notez explicitement "no"
+    ou "false" afin d'éviter la création de l'entête.  
+    Ce réglage est indépendant de la présence ou absence d'autres entêtes
+    supplémentaires et ne peut pas être manipulé dans le dialog graphique avant
+    l'envoi d'un message, seulement dans le fichier de configuration.
+
+    CONTENU : yes, YES, True, no, NO, vide, False et variations.
+
+    PAR DÉFAUT : Vide
+
+    EXEMPLE : Yes
+
+
 **NO_ARCHIVE_GROUPS**
 
     Les newsgroups, où les entêtes « Archive: no » et « X-No-Archive: yes »
@@ -393,7 +418,7 @@ Options de configuration
 
     PAR DÉFAUT : yes
 
-    EXEMPLE: No
+    EXEMPLE : No
 
 **USE_OLD**
 
@@ -404,10 +429,36 @@ Options de configuration
     Ne changez pas cette variable ou notez la valeur 'false' afin d'ignorer
     les changements de l'objet.
 
-    PAR DEFAUT: false
+    PAR DÉFAUT : false
+
+    EXEMPLE : yes
+
+.. _DRAFT_DIR:
+ 
+**DRAFT_DIR**
+
+    Chemin d'accès au répertoire contenant les brouillons de messages.
+
+    Vous pouvez activer l'option *DRAFT_ONLY* dans la boîte de `Dialogue pour
+    désactiver des options`. Le message en cours sera alors enregistré dans ce
+    répertoire, **au lieu d'être publié** sur Usenet. Si vous ne renseignez pas
+    cette option, un répertoire temporaire ($TEMP) sera utilisé à la place. Les
+    fichiers de brouillon seront nommés selon le schéma suivant :
+
+        [n][1er_groupe][++].draft
+
+    où *n* correspond au nombre de fichiers dans ce répertoire, *1er_groupe* au
+    premier groupe de discussion auquel le message était adressé et *++* à un
+    suffixe facultatif, indiquant qu’il y a d’autres groupes de discussion dans
+    la liste (publication croisée). Le contenu d’un fichier brouillon
+    correspond au corps actuel du message, précédé de la liste des groupes de
+    discussion.
+
+    PAR DÉFAUT : vide
 
-    EXEMPLE: yes
+    EXEMPLE : ~/flnews_brouillons
 
+.. _Autres Informations:
 
 Autres Informations
 ===================

data/doc/html/flnews_post_proc.html

@@ -485,6 +485,26 @@ comp.*: /home/[user]/.my_sigs</pre>
 - 'X-Another-Header: care not!'</pre>
         </blockquote>
 
+        <p><strong>NAME_POSTPROCESSOR</strong>
+        </p>
+
+        <blockquote>
+          <p>Can be used to set a custom header "X-Post-Processor"
+          with the name of the program and its current version.
+          Leave empty or set to no or false to avoid the creation
+          of this header. This setting is independent of the
+          presence or absence of other custom headers and cannot be
+          manipulated in the Override Dialog, only in the
+          configuration file.</p>
+
+          <p>CONTENT: yes, YES, True, no, NO, empty string, False
+          and variations.</p>
+
+          <p>DEFAULT: Empty</p>
+
+          <p>EXAMPLE: Yes</p>
+        </blockquote>
+
         <p><strong>NO_ARCHIVE_GROUPS</strong>
         </p>
 
@@ -866,7 +886,7 @@ comp.*: /home/[user]/.my_sigs</pre>
           "https://creativecommons.org/licenses/by-nd/4.0/">CC
           BY-ND 4.0</a></p>
 
-          <p>Date: 2026-08-11</p>
+          <p>Date: 2026-09-18</p>
         </blockquote>
 
         <p><strong>Ω</strong>
@@ -876,7 +896,7 @@ comp.*: /home/[user]/.my_sigs</pre>
   </main>
 
   <div id='page_dt'>
-    2026-08-11
+    2026-09-18
   </div>
 </body>
 </html>

data/doc/rst/flnews_post_proc.rst

@@ -239,6 +239,21 @@ Configuration Options
     - 'X-My-Header: nothing fancy'
     - 'X-Another-Header: care not!'
 
+**NAME_POSTPROCESSOR**
+
+    Can be used to set a custom header "X-Post-Processor" with the name of
+    the program and its current version. Leave empty or set to no or false
+    to avoid the creation of this header.
+    This setting is independent of the presence or absence of other custom 
+    headers and cannot be manipulated in the Override Dialog, only in the
+    configuration file.
+
+    CONTENT: yes, YES, True, no, NO, empty string, False and variations.
+
+    DEFAULT: Empty
+
+    EXAMPLE: Yes
+
 **NO_ARCHIVE_GROUPS**
 
     Newsgroups where the "Archive: no" and "X-No-Archive: YES" headers should

data/lib/basic_logging.rb

@@ -26,7 +26,7 @@ module BasicLogging
   ERROR = 3
   FATAL = 4
   UNKNOWN = nil
-  
+
   # this is mainly for the translation of method calls into log levels
   Levels = {:debug => DEBUG, :info => INFO, :warn => WARN, :error => ERROR,
             :fatal => FATAL, :unknown => UNKNOWN}
@@ -34,7 +34,7 @@ module BasicLogging
   @@log_level = UNKNOWN
   @@target = STDOUT
   @@muted = []
-  
+
   # do not log, if caller is obj (class or instance)
   def self.mute(obj)
     name = obj.class == Class ? obj.name.dup : obj.class.name
@@ -72,7 +72,11 @@ module BasicLogging
     elsif !tg || tg.respond_to?(:to_str) && tg.strip.empty?
       @@target = nil
     elsif(!File::exist?(tg) || ( File.file?(tg) && File.writable?(tg) ) )
-      @@target = File.open(tg, 'w+')  
+      begin
+        @@target = File.open(tg, 'w+')  
+      rescue Exception => ex
+        $stderr.puts 'Cannot open log target ' << tg << ': ' << ex.message
+      end
     else
       STDERR.puts calling_method << ': ERROR : target ' << tg.to_str << ' cannot be set'
       STDERR.puts "Keeping old target " << @@target.inspect
@@ -157,7 +161,7 @@ module BasicLogging
       return 'from main'
     end
   end
-  
+
   # could be useful
   def lock_target(&block)
     begin

data/lib/body.rb

@@ -209,8 +209,15 @@ class Body
     ref_delim = @@config.REFERENCES_DELIMITER
     debug('references delimiter is ' << ref_delim)
     references = Array.new
-    # avoids a lot of trouble
-    body = @lines.join($LN).force_encoding('utf-8')
+    # avoids a lot of trouble.
+    # The encoding must be set before calling join().
+    # New in Ruby 4.1.0
+    #   Should be unneeded, as the encoding is enforced
+    #   after reading from STDIN.
+    @lines.each {|l| l.force_encoding('UTF-8')}
+    #   ... but still is.
+    # -----------------
+    body = @lines.join($LN)
     if ref_delim && !ref_delim.strip.empty? 
       unless ref_delim == ref_delim.reverse
         ref_delim.strip!

data/lib/configuration.rb

@@ -28,7 +28,7 @@ class Configuration
 
   def initialize() 
     debug 'Configuration::initialize()'
-    confname = PROGNAME << '.conf' 
+    confname = PROGNAME.dup << '.conf' 
     # try to open user-configuration
     @config_file = ENV['HOME'].dup << File::Separator << '.' << confname
     # if user-configuration does not exist, copy installed version.

data/lib/flnews_post_proc.conf

@@ -82,9 +82,16 @@ GROUP_SIGS:
 # DEFAULT: undefined
 # EXAMPLE (two headers):
 # - 'X-My-Header: nothing fancy'
-# - 'X-Post-Processor: flnews_post_proc'
+# - 'X-My-Dog: Labcoat Retriever'
 CUSTOM_HEADERS:
-- "X-Post-Processor: flnews_post_proc"
+
+# NAME_POSTPROCESSOR
+# If set, creates a custom header with the name of the post processor and its
+# current version. This setting is independent of CUSTOM_HEADERS, above.
+#
+# DEFAULT: no, false or unset
+# EXAMPLE: true
+NAME_POSTPROCESSOR: 
 
 # NO_ARCHIVE_GROUPS:
 # The newsgroups, where a header X-No-Archive: YES shall be set.

data/lib/headers.rb

@@ -17,6 +17,7 @@ require 'rfc_2047'
 require_relative 'basic_logging'
 require_relative 'configuration'
 require_relative 'newsgroups'
+require_relative 'version'
 
 # an object of this class represents the headers of a news-article
 
@@ -139,7 +140,7 @@ class Headers
         # Ensure header is ascii only
         if hv.ascii_only? && hn.ascii_only?
           # <---------- special treatment Post-Processor ---------->
-          hv << ' ' << PROGVERSION.to_s if hn == 'X-Post-Processor' && hv == 'flnews_post_proc'
+          # hv << ' ' << PROGVERSION.to_s if hn == 'X-Post-Processor' && hv == 'flnews_post_proc'
           #  >----------<
           @headers[hn.to_sym] = hv
         else
@@ -149,8 +150,11 @@ class Headers
         end
         @headers[hn.to_sym] = hv
       end
-      @headers.compact!
     end
+    if @config.NAME_POSTPROCESSOR
+      @headers["X-Post-Processor".to_sym] = PROGNAME.dup << ' ' << PROGVERSION.to_s
+    end
+    @headers.compact!
     debug('updated headers are ' << @headers.inspect)
   end
 

data/lib/newsgroups.rb

@@ -120,6 +120,7 @@ class Newsgroups
         end # gsigs.each
       end # gsigs for group?
       if tsig && tsig.rstrip.start_with?('/')
+        debug 'trying to pick a random signature'
         tsig = pick_sig(tsig.strip)
       end
       @signature = correct_linebreaks(tsig) if tsig
@@ -147,6 +148,7 @@ class Newsgroups
         if(psrc ) 
           psrc = psrc[1]
           if File.exist?(psrc) && File.readable?(psrc) 
+            debug 'reading signature file'
             ssigs = File.read(psrc).split(delim)
           else
             warn 'cannot find or read sourced signature file: ' << psrc
@@ -165,7 +167,10 @@ class Newsgroups
 
       # srand(Time.now.nsec)
       srand()
-      return all_sigs[rand(numSigs)]
+      psig = all_sigs[rand(numSigs)]
+      debug "HAVE a signature: \n\t" << (psig ? psig : ' N I L ')
+      rearrange_sigs(sigfile, all_sigs)
+      return psig
     else
       warn 'cannot find or read signature file: ' << sigfile
     end
@@ -174,7 +179,6 @@ class Newsgroups
 
   # write a new rearranged version of the signature file for 
   # better hazard.
-  # UNUSED
   def rearrange_sigs(sigfile, all_sigs)
     if File.writable?(sigfile) 
       new_sigs = Array.new(all_sigs.length)

data/lib/version.rb

@@ -14,7 +14,7 @@
 =end
 
 PROGNAME = 'flnews_post_proc'
-PROGVERSION = "2.05"
+PROGVERSION = "2.08"
 AUTHORS = "Michael Uplawski"
 EMAIL = "michael.uplawski@uplawski.eu"
 YEARS = "2023 - 2026"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: flnews_post_proc
 version: !ruby/object:Gem::Version
-  version: '2.05'
+  version: '2.08'
 platform: ruby
 authors:
 - Michael Uplawski
 bindir: bin
 cert_chain: []
-date: 2026-08-20 00:00:00.000000000 Z
+date: 2026-09-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: diffy
@@ -119,6 +119,7 @@ files:
 - lib/override.rb
 - lib/ruby_dlg
 - lib/version.rb
+homepage: https://www.uplawski.eu/software/flnews_post_proc/
 licenses:
 - WTFPL
 metadata:
@@ -139,7 +140,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.18
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Modify news posts, before flnews sends them.
 test_files: []