RubyGems - flnews_post_proc - Versions diffs - 1.48 → 1.53 - Mend

flnews_post_proc 1.48 → 1.53

Files changed (18) hide show

checksums.yaml +4 -4
data/README.md +10 -10
data/doc/{html/flnews_post_proc_fr.html → fr/html/flnews_post_proc.html} +4 -1
data/doc/fr/man/flnews_post_proc.1.gz +0 -0
data/doc/fr/pdf/flnews_post_proc.pdf +0 -0
data/doc/{rst/flnews_post_proc_fr.rst → fr/rst/flnews_post_proc.rst} +4 -0
data/doc/html/flnews_post_proc.html +18 -11
data/doc/man/flnews_post_proc.1.gz +0 -0
data/doc/pdf/flnews_post_proc.pdf +0 -0
data/doc/rst/flnews_post_proc.rst +3 -0
data/lib/_quoting_style_regexp +1 -0
data/lib/body.rb +28 -9
data/lib/configuration.rb +1 -0
data/lib/flnews_post_proc.rb +1 -1
data/lib/version.rb +2 -3
metadata +8 -9
data/doc/man/flnews_post_proc_fr.1.gz +0 -0
data/doc/pdf/flnews_post_proc_fr.pdf +0 -0

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9a019c52dac602a5b00c71131e8b44a61769604a08035b7afad305a27c5d43a0
-  data.tar.gz: 7f5a69f62df2a18fefe9f0f5f499d7960d40b751b4bda67f26a88f91034ac941
+  metadata.gz: bb3c498d2cde3e3c4afcd611006857a9b88db02cd27a05fe04ef1cac4448d6bd
+  data.tar.gz: 1fbd7d419082397cb748ad397c168c5ebc55b002e162a2831775677b0289734e
 SHA512:
-  metadata.gz: fe1d5fee2fffc214f8aa96b34e4886b3c2e7b16a71dd2ac99b8df214528d53c43df8b425fe4b21d4edf58e691e6cd5f497e09ed12a81129dd0f0e883fcf9ab76
-  data.tar.gz: 40f0b45424e01cc6b034aeeb4a7729bb0a499e231eb0001a60d762e4f1952964090dacda102fb87215ed66786e7e2887c471c95cc930018b469df669d16915b1
+  metadata.gz: 547bfbcea62f28654150632b088ad3f9ff7a48b2df3893fff5849e94f865f1ed2c7c39d97f493320f1a1687247118864a242f760ae8c032f4817c43d70bdc43c
+  data.tar.gz: 34ad4b1054b1308f391a4207222ffd39b407e62184cf38012e46d60cfbe3a375b598477e50ff92d9bec8181cbd15ea79d249bb6d0c535b2bf4e884ba7cea9460

data/README.md CHANGED Viewed

@@ -56,7 +56,7 @@ The flnews newsreader is sufficient for Usenet access, i.e. to receive and read
 articles from -, as well as to write and post articles to newsgroups.
 When you compare news-clients, you will always notice the differences and
-choose the software that you prefer. Flnews however, has the charm that you can
+choose the software that you prefer. flnews however, has the charm that you can
 influence how the program itself works but also modify posts that flnews
 produces, just before the program will transmit them to the chosen nntp-server.
@@ -93,13 +93,13 @@ some users may not always agree with the result and for arbitrary reasons:
   Custom headers may be defined in the configuration file for the program
   and will then be added to each outgoing post.
-* The Archive- and X-No-Archive headers are sometimes set to avoid that an
-  article be saved and stays available to search-engines (Google, notably).
-  Test-  postings, for example, do probably not justify at all that they would
-  be  referenced in search results. The post-processor program can impose the
-  Archive- and X-No-Archive header for all posts to certain newsgroups.
+* The Archive- and X-No-Archive headers are sometimes set to avoid that an
+  article be saved and stays available to search-engines (Google, notably).
+  Test-  postings, for example, do probably not justify at all that they would
+  be  referenced in search results. The post-processor program can impose the
+  Archive- and X-No-Archive header for all posts to certain newsgroups.
-  **ATTN** As of 2024, the header “X-No-Archive“ has lost most of its utility
+  **ATTN** As of 2024, the header “X-No-Archive“ has lost most of its utility
   and it is the decision of server operators to honor it or not.
 * If a news post contains many references to either other posts or Web
@@ -166,7 +166,7 @@ Ruby, noted as a String. Beware to mask a backslash '\\' by another one,
 ike in the example. A capture-group '()' serves to extract the name from the
 match result.
-Leave this field empty to keep the default from the FLNews configuration
+Leave this field empty to keep the default from the flnews configuration
 intact.
  CONTENT: A String equivalent of a regular expression.
@@ -199,7 +199,7 @@ intact.
  CONTENT: A newsgroup or regexp per line, followed by a colon, a space and a String
- DEFAULT: As configured in FLNews
+ DEFAULT: As configured in flnews
  EXAMPLE: _alt.test: "Thus spoke #\{fup_name\} on that baleful #\{fup_date\}:"_
@@ -320,7 +320,7 @@ A dialog may be displayed which allows you to disable any of these
 four options, so that the defaults from flnews prevail.
 ATTN! Canceling the dialog or pushing the Esc-key does interrupt
-the process. Flnews will not post the article.
+the process. flnews will not post the article.
 Set this option to no, NO or similar to disable the dialog.

data/doc/{html/flnews_post_proc_fr.html → fr/html/flnews_post_proc.html} RENAMED Viewed

@@ -4,7 +4,7 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 <meta name="generator" content="Docutils 0.20.1: https://docutils.sourceforge.io/" />
-<title>Flnews_post_proc_fr</title>
+<title>Flnews_post_proc</title>
 <style type="text/css">
 /*
@@ -429,6 +429,9 @@ parmi les résultats des recherches.</p>
 <p>Avec flnews_post_proc vous pouvez décider et imposer que vos articles dans
 certains newsgroups contiendront d'office les deux entêtes <strong>Archive: no</strong> et
 <strong>X-No-Archive: Yes</strong>.</p>
+<p><strong>ATTENTION</strong>: Dès 2024, l'entête « X-No-Archive » a perdu beaucoup de son
+utilité. Les opérateurs des serveurs peuvent décider s'ils veulent le prendre
+en considération ou non.</p>
 </li>
 <li><p class="first">Certains messages mentionnent d'autres articles ou des URLs de pages Web.
 S'ils sont nombreux, ces références peuvent déranger la lecture à cause de

data/doc/fr/man/flnews_post_proc.1.gz ADDED Viewed

Binary file

data/doc/fr/pdf/flnews_post_proc.pdf ADDED Viewed

Binary file

data/doc/{rst/flnews_post_proc_fr.rst → fr/rst/flnews_post_proc.rst} RENAMED Viewed

@@ -83,6 +83,10 @@ et ce pour des raisons arbitraires :
   certains newsgroups contiendront d'office les deux entêtes **Archive: no** et
   **X-No-Archive: Yes**.
+  **ATTENTION**: Dès 2024, l'entête « X-No-Archive » a perdu beaucoup de son
+  utilité. Les opérateurs des serveurs peuvent décider s'ils veulent le prendre
+  en considération ou non.
 * Certains messages mentionnent d'autres articles ou des URLs de pages Web.
   S'ils sont nombreux, ces références peuvent déranger la lecture à cause de
   leur syntaxe spécifique.

data/doc/html/flnews_post_proc.html CHANGED Viewed

@@ -390,33 +390,39 @@ own creations.</p>
 <h2>The limits of a basic newsreader — what the program can do</h2>
 <p>While the articles that flnews creates, are complete and ready to be posted,
 some users may not always agree with the result and for arbitrary reasons:</p>
-<ul class="simple">
-<li>There may be inconveniences when you post to different newsgroups in
+<ul>
+<li><p class="first">There may be inconveniences when you post to different newsgroups in
 different languages, as an introductory line which refers to a previous
 post can only be set once in the flnews-configuration. The consequence
 can be that your post to a french newsgroup begins with an introduction
 in English.
 My post-processor program can set an introductory line specifically
-chosen for one or several newsgroups.</li>
-<li>The same conflict arises, when you have set a standard signature-text and
+chosen for one or several newsgroups.</p>
+</li>
+<li><p class="first">The same conflict arises, when you have set a standard signature-text and
 would like to replace it against another, based on the newsgroup you are
 about to post to.
 The post-processor program sets specific signatures as configured for one
-or several newsgroups.</li>
-<li>Some custom headers may serve to convey additional information to
+or several newsgroups.</p>
+</li>
+<li><p class="first">Some custom headers may serve to convey additional information to
 interested readers of your post, like GnuPG key IDs, your language skills
 or the like. The signature may be a better choice than custom headers.
 You are free. I just mention face and x-face but prefer that you do not
 remember I did.
 Custom-headers may be defined in the configuration file for the program
-and will then be added to each outgoing post.</li>
-<li>The Archive- and the X-No-Archive header are sometimes set to avoid that an
+and will then be added to each outgoing post.</p>
+</li>
+<li><p class="first">The Archive- and the X-No-Archive header are sometimes set to avoid that an
 article be saved and stays available to search-engines (Google, notably).
 Test- postings, for example, do probably not justify at all that they would
 be referenced in search-results.
 The post-processor program can impose both headers for all posts to certain
-newsgroups.</li>
-<li>If a news post contains many references to either other posts or Web
+newsgroups.</p>
+<p><strong>ATTN</strong> As of 2024, the header “X-No-Archive“ has lost most of its utility
+and it is the decision of server operators to honor it or not.</p>
+</li>
+<li><p class="first">If a news post contains many references to either other posts or Web
 pages, the text can be cluttered with URLs.
 The post-processor can identify marked text fragments and transform them
 into footnotes, which will be attached as a list at the bottom of the
@@ -425,7 +431,8 @@ This works almost like the &lt;ref/&gt; link in Wikipedia, but the delimiter
 can be determined in the configuration file.
 Example (with %=):
 This is an object %=and this becomes the footnote, describing the object
-further=%</li>
+further=%</p>
+</li>
 </ul>
 </div>
 <div class="section" id="dialog-to-override-settings">

data/doc/man/flnews_post_proc.1.gz CHANGED Viewed

Binary file

data/doc/pdf/flnews_post_proc.pdf CHANGED Viewed

Binary file

data/doc/rst/flnews_post_proc.rst CHANGED Viewed

@@ -67,6 +67,9 @@ some users may not always agree with the result and for arbitrary reasons:
   The post-processor program can impose both headers for all posts to certain
   newsgroups.
+  **ATTN** As of 2024, the header “X-No-Archive“ has lost most of its utility
+  and it is the decision of server operators to honor it or not.
 * If a news post contains many references to either other posts or Web
   pages, the text can be cluttered with URLs.
   The post-processor can identify marked text fragments and transform them

data/lib/_quoting_style_regexp CHANGED Viewed

	@@ -1 +1,2 @@
1	+ # UNUSED
1 2	" > >> > testerei ei ei".strip.gsub( /^>+(\s+>+)*/) {\|m\| m.to_s.delete(" ")}

data/lib/body.rb CHANGED Viewed

@@ -17,7 +17,12 @@
 require_relative 'basic_logging'
 require_relative 'configuration'
-# an object of this class represents the body of a news-article.
+# An object of this class represents the body of a news-article.
+# It processes the original text and changes some details:
+#    intro-lines
+#    signatures
+#    URI formats
+#    Footnotes (and/or a list of references) are created
 class Body
   # a class-level configuration instance.
   @@config = Configuration.instance
@@ -99,6 +104,13 @@ class Body
             # exchange original intro-line against the new one
             @lines[@lines.index(ointro)] = intro.strip
             # looked complicated because it is.
+            # keep this line for reference.
+            @intro = intro
+          else
+            wmsg = 'Text following the intro is not a citation!'
+            wmsg << "\n\tIntro will NOT be modified: \"#{ointro}\"!"
+            warn wmsg
           end
         end
       end # fn.strip.empty?
@@ -111,7 +123,7 @@ class Body
       # remove any signature(s) from
       # the current article
       sigpos = @lines.index('-- ')
-      debug('found signature at position ' << sigpos) if sigpos
+      debug('found signature in line ' << sigpos.to_s) if sigpos
       @lines = @lines.slice(0, sigpos ) if sigpos
       debug('setting signature ' << signature) if signature
       @lines << "-- " << signature if signature
@@ -119,8 +131,12 @@ class Body
   end
   def join
-    return @lines.join("\r\n") << "\r\n"
+    new_body = @lines.join("\r\n") << "\r\n"
+    # replace ellipsis
+    new_body.gsub!('...', '…')
+    return new_body
   end
   # ------->
   # TODO : Concentrate all URL/URI munging functionality in 1 or 2 helper
   # classes, e.g. Body::News and Body::Http
@@ -128,7 +144,7 @@ class Body
   # Verify and possibly correct links in the post.
   # Simple.
-  def handle_urls()
+  def handle_uris()
     # Determine here or elsewhere if URLs shall be verified.
     # Default is != no. nil or '' do qualify as default.
     if @@config.VFY_URLS
@@ -144,7 +160,8 @@ class Body
           #  <----------------------------
           # BUGFIX : Urls with @
-          new_line = handle_news(l)
+          # BUGFIX : email address in the intro
+          new_line = handle_news(l) if !@intro || l.strip != @intro.strip
           # http(s)
           if l.include?('http')
             new_line = handle_http(l)
@@ -172,9 +189,8 @@ class Body
         # to the whole body, over multiple lines, if need be.
         begin
           ref = body.match(ref_rx )
-          debug("found reference " << ref.to_s << " (length: " << (ref ? ref.to_s.size.to_s : '0') << ")")
+          debug("found reference " << ref.to_s << " (length: " << (ref ? ref.to_s.size.to_s : '0') << ")") if ref && ref.length > 0
           if ref
-            debug('ref is ' << ref.to_s)
             #  ... This is some presentation thing and I think
             #  it works, too.
             r = ref[0].gsub(/[ \t]+/, ' ').strip
@@ -184,7 +200,7 @@ class Body
             body.gsub!(ref[0], format(@@config.REFERENCE_FORMAT, index.to_s ))
           end
         end until ref == nil
-        debug("all references found:\n" << references.join('\n'))
+        debug("all references found:\n" << references.join('\n')) if !references.empty?
       else
         msg = 'The References Delimiter is the same in its reversed form.'
         msg << "#{$LN}Cannot handle references or footnotes!"
@@ -198,6 +214,8 @@ class Body
           r = r.gsub(ref_delim, '').gsub(ref_delim.reverse,'')
           body << (i + 1 ).to_s << ") " << r.strip <<  $LN
         end
+      else
+        debug('no refences found')
       end
     end
     @lines = body.split($LN)
@@ -238,7 +256,8 @@ class Body
     url_strs = l_array.collect do |ele|
       if ele.strip.include?('http') && ele.match(/https?:\S+/)
         ele.lstrip!
-        while !ele.match(/([[:alnum:]]|>)$/) do
+        # ensure last character is alphanumeric or '>' or '/'
+        until ele.match(/([[:alnum:]]|>|\/)$/) do
           ele.chop!
         end
         ele

data/lib/configuration.rb CHANGED Viewed

@@ -91,6 +91,7 @@ class Configuration
       end
       @conf[:CONFIG_VERSION] = PROGVERSION.to_f
       bak_conf = @config_file.dup << '_' << conf_version.to_s
+      bak_conf.gsub!('.' << PROGNAME,  'bak_' << PROGNAME)
       info('Old configuration is saved to ' << bak_conf )
       info('New configuration is saved to ' << @config_file )
       begin

data/lib/flnews_post_proc.rb CHANGED Viewed

@@ -55,7 +55,7 @@ class PostProcessor
     body.set_signature(newsgroups.signature)
     # verify and eventually correct URLs
-    body.handle_urls
+    body.handle_uris
     # get the headers and the body as a string.
     # Assemble.

data/lib/version.rb CHANGED Viewed

@@ -14,9 +14,8 @@
 =end
 PROGNAME = 'flnews_post_proc'
-PROGVERSION = "1.48"
+PROGVERSION = "1.53"
 AUTHORS = "Michael Uplawski"
 EMAIL = "michael.uplawski@uplawski.eu"
 YEARS = "2023 - 2024"
-SUMMARY = "\tConcurrent access to the log file\n\tLog cleared upon setting log target"
-SUMMARY << "\n\t\"STDOUT\" allowed as log target"
+SUMMARY = "Ellipsis is replaced against '…', French documentation in sub-folder doc/fr"

metadata CHANGED Viewed

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: flnews_post_proc
 version: !ruby/object:Gem::Version
-  version: '1.48'
+  version: '1.53'
 platform: ruby
 authors:
 - Michael Uplawski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-05-30 00:00:00.000000000 Z
+date: 2024-06-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: diffy
@@ -30,7 +30,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 3.4.2
-description: Post-processor for Usenet-articles created in FLNews
+description: Post-processor for Usenet-articles created in flnews
 email: michael.uplawski@uplawski.eu
 executables:
 - flnews_post_proc
@@ -39,15 +39,15 @@ extra_rdoc_files: []
 files:
 - README.md
 - bin/flnews_post_proc
+- doc/fr/html/flnews_post_proc.html
+- doc/fr/man/flnews_post_proc.1.gz
+- doc/fr/pdf/flnews_post_proc.pdf
+- doc/fr/rst/flnews_post_proc.rst
 - doc/html/flnews_post_proc.html
-- doc/html/flnews_post_proc_fr.html
 - doc/license.txt
 - doc/man/flnews_post_proc.1.gz
-- doc/man/flnews_post_proc_fr.1.gz
 - doc/pdf/flnews_post_proc.pdf
-- doc/pdf/flnews_post_proc_fr.pdf
 - doc/rst/flnews_post_proc.rst
-- doc/rst/flnews_post_proc_fr.rst
 - lib/_quoting_style_regexp
 - lib/basic_logging.rb
 - lib/body.rb
@@ -85,6 +85,5 @@ requirements: []
 rubygems_version: 3.5.3
 signing_key:
 specification_version: 4
-summary: Concurrent access to the log file Log cleared upon setting log target "STDOUT"
-  allowed as log target
+summary: Ellipsis is replaced against '…', French documentation in sub-folder doc/fr
 test_files: []

data/doc/man/flnews_post_proc_fr.1.gz DELETED Viewed

Binary file

data/doc/pdf/flnews_post_proc_fr.pdf DELETED Viewed

Binary file