Sprichwoerter 0.1 → 1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 80f837ad47153be05dea980ae26c1fd24dfe9cf6
-  data.tar.gz: 93abff22aaac0f9232b93bd846099c98f8f8296f
+SHA256:
+  metadata.gz: 409ea77be08978d4ac11df8a73862f25b8af2638043749feb7ca0baca0e8b124
+  data.tar.gz: df0cd33efbe5421d50e6f2792ff6dea4d31d00892dd7123601f571a5c95d39a1
 SHA512:
-  metadata.gz: c638f6865975268ed30b33962d17f7b2cda89703145f41c1f43386a5b2d2ad48c403b0977bef9bd537df154c22d173f02faaa271c19fcc4bd63f7abccb6e99ec
-  data.tar.gz: ba43ea04d0630ccc11cc0b382e18eac42b3815f8ad9514c7974c72edad1b12c49118b0fb9f04aab3f9108ccd5537bdce5dd16827fef41a31b96f83bf28316957
+  metadata.gz: df720f489ff6223d426199387d64f0cc53ea20f71cfd76791e37f36920d76e6b15f384fcf56fc650a301f395d927105ac2a7e182f6eede5786c19ca4401a3ee5
+  data.tar.gz: 39b01904a8a6f76d1b9fbfe7ac4106d145c931fd60dc8c5ee4c40b13543ca0557ae4fd197c9975baebadffc68743b3334bcb32e3b5a1d86cd10bfe127396800b

data/Sprichwoerter.gemspec

@@ -0,0 +1,20 @@
+require_relative "lib/version"
+require 'date'
+
+Gem::Specification.new do |s|
+  s.version     = VERSION
+  s.name        = File.basename(__FILE__, '.gemspec')
+  s.date        = Date.today.strftime('%F')
+  s.summary     = SUMMARY
+  s.description = "Generates random, senseless proverbs by combining beginnings and endings of existing proverbs."
+  s.authors     = ["Michael Uplawski"]
+  s.email       = 'michael.uplawski@uplawski.eu'
+  s.files  	=  %w~sprichwoerter proverbs~.collect{|f| 'bin/' << f} + %w~adder.rb color_output.rb argparser.rb rearranging.rb translating.rb translations logging.rb log.conf liste_de.rb sprichwörter.rb liste_en.rb version.rb user_input.rb~.collect{|f| 'lib/' << f} + %w~Sprichwoerter.gemspec~.collect{|f|f} + %w~html/proverbs.html html/sprichwoerter.html man/proverbs.6.gz man/sprichwoerter.6.gz pdf/proverbs.pdf pdf/sprichwoerter.pdf rst/proverbs.rst rst/sprichwoerter.rst~.collect{|f| 'doc/' << f}
+  s.executables = "sprichwoerter", "proverbs"
+  s.license     = 'Nonstandard'
+  s.required_ruby_version = '>= 2.5'
+  s.metadata = {
+    "homepage_uri" => 'https://www.uplawski.eu/software/sprichwoerter',
+    "documentation_uri" => 'https://www.uplawski.eu/software/sprichwoerter/proverbs.html'
+  }
+end

data/bin/proverbs

@@ -1,25 +1,55 @@
 #!/usr/bin/env ruby
 #encoding: UTF-8
+
 =begin
-/***************************************************************************
- *   ©2016-2016, Michael Uplawski <michael.uplawski@uplawski.eu>           *
+ *   ©2016-2025, Michael Uplawski <michael.uplawski@uplawski.eu>           *
  *                                                                         *
  *   This program is free software; you can redistribute it and/or modify  *
- *   it under the terms of the GNU General Public License as published by  *
- *   the Free Software Foundation; either version 3 of the License, or     *
+ *   it under the terms of the WTFPL, either version 2 of the License, or  *
  *   (at your option) any later version.                                   *
- *                                                                         *
- *   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.  See the         *
- *   GNU General Public License for more details.                          *
- *                                                                         *
- *   You should have received a copy of the GNU General Public License     *
- *   along with this program; if not, write to the                         *
- *   Free Software Foundation, Inc.,                                       *
- *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
- ***************************************************************************/
+ *   See http://www.wtfpl.net/about/ for details.                           *
 =end
 
 require_relative '../lib/sprichwörter'
-SprichWoerter.new('en')
+require_relative '../lib/adder'
+require_relative '../lib/color_output'
+
+        SprichWoerter.new('en', ARGV)
+=begin
+if(ARGV.include?("-h") || ARGV.include?("--help"))
+   usage = %q~ 
+   Usage: proverbs
+       or proverbs list
+       or proverbs add singular "A watched pot" "never boils"
+       or proverbs add plural "cheaters" "never prosper"
+   
+   The argument 'add' will add a new, original proverb to the list and write
+   all available English proverbs to
+   /home/user/.proverbs/liste_en.rb.
+
+   A backup-copy of the previous version is also created.
+
+   Proverbs, which are identical in all details will be recognized and
+   duplicates are avoided.  
+   ~
+
+   puts usage
+   exit 0
+end
+
+
+if(ARGV.include?("add") && ARGV.length > 3 )
+        ARGV.delete('add')
+        Adder.new('en', *ARGV)
+elsif ARGV.include?("list")
+  SprichWoerter.new('en', :list)
+  exit true
+elsif !ARGV.empty?
+  puts red("\nUnsuitable or insufficient arguments '" << bold(ARGV.join(', ') ) << "'.")
+  puts "Run with '-h' or '--help' to see the usage message."
+  puts
+  exit 0
+else
+        SprichWoerter.new('en')
+end
+=end

data/bin/sprichwoerter

@@ -1,25 +1,59 @@
 #!/usr/bin/env ruby
 #encoding: UTF-8
 =begin
-/***************************************************************************
- *   ©2016-2016, Michael Uplawski <michael.uplawski@uplawski.eu>           *
+ *   ©2016-2025, Michael Uplawski <michael.uplawski@uplawski.eu>           *
  *                                                                         *
  *   This program is free software; you can redistribute it and/or modify  *
- *   it under the terms of the GNU General Public License as published by  *
- *   the Free Software Foundation; either version 3 of the License, or     *
+ *   it under the terms of the WTFPL, either version 2 of the License, or  *
  *   (at your option) any later version.                                   *
- *                                                                         *
- *   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.  See the         *
- *   GNU General Public License for more details.                          *
- *                                                                         *
- *   You should have received a copy of the GNU General Public License     *
- *   along with this program; if not, write to the                         *
- *   Free Software Foundation, Inc.,                                       *
- *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
- ***************************************************************************/
+ *   See http://www.wtfpl.net/about/ for details.                           *
 =end
 
 require_relative '../lib/sprichwörter'
-SprichWoerter.new('de')
+require_relative '../lib/adder'
+require_relative '../lib/color_output'
+
+SprichWoerter.new('de', ARGV)
+
+=begin
+if(ARGV.include?("-h") || ARGV.include?("--hilfe"))
+   usage = %q~ 
+   Aufrufsyntax: sprichwoerter
+            oder sprichwoerter liste
+            oder sprichwoerter neu singular "Ein König mit Krone" "ist besser als ohne"
+            oder sprichwoerter neu plural "Hunde, die bellen" "beißen nicht"
+   
+   Der Parameter 'neu' fügt ein neues, ursprüngliches Sprichwort in die Liste
+   hinzu und schreibt alle verfügbaren, deutschen Sprichwörter in die Datei 
+   /home/user/.proverbs/liste_de.rb,
+
+   Außerdem wird bei jedem Schreiben in diese Datei eine Kopie der vorigen Version
+   erzeugt.
+
+   Buchstäblich identische Sprichwörter werden erkannt und Duplikate vermieden.
+   ~
+
+   puts usage
+   exit 0
+end
+=end
+
+=begin
+if(ARGV.include?("neu") && ARGV.length > 3)
+        ARGV.delete('neu')
+        Adder.new('de', *ARGV)
+elsif ARGV.include?("liste")
+  SprichWoerter.new('de', :list)
+  exit true
+elsif !ARGV.empty?
+  puts red("\nUnbrauchbare oder zu wenig Programmargumente '" << bold(ARGV.join(', ') ) << "'.")
+  puts "Starten Sie das Programm mit '-h' oder '--hilfe', um die Kurzhilfe zu sehen."
+  puts
+  exit 0
+else
+        #SprichWoerter.new('de', :create)
+        SprichWoerter.new(ARGV)
+end
+=end
+#
+#---test

data/doc/html/proverbs.html

@@ -0,0 +1,289 @@
+<?xml version="1.0" encoding="utf-8"?>
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <meta name="generator" content="vim - Vi Improved, a programmer's editor; HTML Tidy for Linux version 5.8.0
+"/>
+    <meta charset="utf-8" />
+  <meta name="viewport" content=
+  "width=device-width, initial-scale=1" />
+  <title>Proverbs</title>
+  <style type="text/css">
+  /*<![CDATA[*/
+
+  /*
+  :Author: Michael Uplawski 
+  :Contact: michael.uplawski@uplawski.eu
+  :License: WTFPL 2.0, see http://www.wtfpl.net/about/
+
+  Stylesheet for use with Docutils.  
+  */
+
+  body {
+  background-color:#e0f0c0;
+  font-family: Verdana,Helvetica,Univers;
+  }
+
+  p {width: 80%;}
+
+  h1.title {color:#800080;font-size:2em;}
+  h2 {color:darkblue;font-size:1.5em;}
+  h3 {color:#3030f0;font-size:1em;}
+
+  nav:before {
+  content:'Contents';
+  font-weight:bold;
+  color:darkblue;
+  font-size:1.5em;
+  }
+
+  p, ul.simple, ol.simple, dt {margin-left:2em;}
+  dd {margin-left:4em;}
+
+  /* correct left margin of nested block tags*/
+  dd p, li p {margin-left:0;}
+  dd * ul {margin-left:0 ! important; }
+  dd ul {margin-left:0 ! important; }
+  dd dl dt, dd dl dd {margin-left:0 ! important;}
+
+  em {color:#000080;
+  background-color:#ffffa0;
+  }
+
+  pre.literal-block {
+    margin-left:2em;
+    font-family:Verdana,Helvetica,Univers;
+  }8
+  blockquote {background-color:#ffc090;
+  padding:0.5em;
+  width:80%;
+  border-radius:0.5em;
+  }
+
+
+  /*]]>*/
+  </style>
+</head>
+<body>
+  <main id="proverbs">
+    <h1 class="title">PROVERBS</h1>
+
+    <p class="subtitle" id=
+    "rearrange-proverbs-into-new-mostly-senseless-proverbs">
+    Rearrange proverbs into new, mostly senseless, proverbs.</p>
+
+    <p><em>Sprichwörter</em> is the German name for the same
+    program.</p>
+
+    <section id="synopsis">
+      <h2>Synopsis</h2>
+
+      <blockquote>
+        <p><strong>proverbs</strong>
+        </p>
+
+        <p><strong>proverbs -[qc &lt;COLOR&gt;] (--qualify --color
+        &lt;COLOR&gt;)</strong>
+        </p>
+
+        <p><strong>proverbs -f (--favorites)</strong>
+        </p>
+
+        <p><strong>proverbs -a (--add)</strong>
+        </p>
+
+        <p><strong>proverbs -h (--help)</strong>
+        </p>
+
+        <p><strong>proverbs -v (--version)</strong>
+        </p>
+      </blockquote>
+    </section>
+
+    <section id="description">
+      <h2>DESCRIPTION</h2>
+
+      <p>The program combines the beginnings and the endings of
+      proverbs randomly picked from a list. The result is a phrase
+      which is still recognizable as "kind of a proverb" but
+      without claiming to convey any real message, let alone
+      "wisdom".</p>
+
+      <p>Yes. It is intended as a humorous waste of time. You can,
+      for example, call proverbs from your <em>.bashrc</em>
+      file.</p>
+
+      <p>When called on the command-prompt as
+      <strong>proverbs</strong> without any options, a newly
+      generated proverb will be printed out on screen.</p>
+    </section>
+
+    <section id="options">
+      <h2>OPTIONS</h2>
+
+      <dl class="simple">
+        <dt><strong>-a</strong> or <strong>--add</strong></dt>
+
+        <dd>
+          <p>Allows you to add a new, real proverb to the list of
+          original proverbs. You are prompted for each of the
+          details: language (one of <em>en</em> or <em>de</em> at
+          the time of this writing), singular or plural
+          (<em>s</em>, <em>p</em>), beginning and ending of the
+          proverb.</p>
+        </dd>
+
+        <dt><strong>-f</strong> or
+        <strong>--favorites</strong></dt>
+
+        <dd>
+          <p>Will dump the list of "qualified", random proverbs,
+          i.e. those that had been found worth saving after a
+          previous call to proverbs.</p>
+        </dd>
+
+        <dt><strong>-q</strong> or <strong>--qualify</strong></dt>
+
+        <dd>
+          <p>After a newly created proverb has been presented, you
+          have a few seconds to eventually qualify a proverb, i.e.
+          add it to the list of favorites, by pushing '+'.</p>
+        </dd>
+
+        <dt><strong>-c</strong> or
+        <strong>--color=COLOR</strong></dt>
+
+        <dd>
+          <p>Sets the color the border which sourrounds a generated
+          proverb. Must be one of red, green, yellow, purple, cyan,
+          blue, white or black.</p>
+        </dd>
+
+        <dt><strong>-h</strong> or <strong>--help</strong></dt>
+
+        <dd>
+          <p>Shows the short help-text for the program.</p>
+        </dd>
+
+        <dt><strong>-v</strong> or <strong>--version</strong></dt>
+
+        <dd>
+          <p>Shows version-information</p>
+        </dd>
+      </dl>
+
+      <section id=
+      "adding-proverbs-to-the-default-list-option-a-or-add">
+        <h3>ADDING PROVERBS to the default list (option -a or
+        --add)</h3>
+
+        <p>At the time of this writing (october 2019), original
+        ('real') proverbs must conform to the pattern</p>
+
+        <p>"<em>someone or something</em>" | "<strong>does or
+        is</strong> <em>something</em>"</p>
+
+        <p>Just execute the program a few times on the
+        command-line, without arguments, to get the idea.</p>
+
+        <p>For the time, original proverbs are grouped with respect
+        to their subject (someone or something), which is
+        uncountable or in singular for the first group (like in
+        “Fortune | favors the bold”), in plural for the second
+        group (like in “All Roads | lead to Rome”).</p>
+      </section>
+    </section>
+
+    <section id="files">
+      <h2>FILES</h2>
+
+      <p>The hidden directory <em>.proverbs</em> in the user's
+      home-directory can contain three types of file. For the
+      English version, these are:</p>
+
+      <dl class="simple">
+        <dt><em>liste_en.rb</em>
+        </dt>
+
+        <dd>
+          <p>This file contains all the currently available,
+          original proverbs. It exists only, if you have already
+          added new original proverbs.</p>
+        </dd>
+
+        <dt><em>liste_en_bak.rb</em>
+        </dt>
+
+        <dd>
+          <p>A backup-copy of the previous version of the list of
+          proverbs.</p>
+        </dd>
+
+        <dt><em>qualifile_en</em>
+        </dt>
+
+        <dd>
+          <p>This file contains the list of previously qualified,
+          randomly generated proverbs, i.e. the list of
+          <em>favorites</em>. It is created when you qualify a
+          proverb for the very first time, and dumped to screen,
+          when you use the option -f or --favorites.</p>
+        </dd>
+      </dl>
+    </section>
+
+    <section id="other-information">
+      <h2>OTHER INFORMATION</h2>
+
+      <dl class="field-list simple">
+        <dt>Source-code<span class="colon">:</span></dt>
+
+        <dd>
+          <p>"Proverbs" had been developed in <a class=
+          "reference external" href=
+          "https://www.ruby-lang.org">Ruby</a> and is distributed
+          as a <a class="reference external" href=
+          "https://rubygems.org/gems/Sprichwoerter">ruby-gem</a>.
+          If you installed the program from the gem-file (with
+          <em>gem install</em>), then you find all the source-files
+          in the gem-folder for your Ruby-version. Otherwise, you
+          can also unpack the gem-file (with <em>tar</em>), then
+          uncompress the data-archive and take a look at the files
+          in the resulting, new folders <em>bin</em> and
+          <em>lib</em>.</p>
+        </dd>
+      </dl>
+
+      <dl class="field-list simple">
+        <dt>License<span class="colon">:</span></dt>
+
+        <dd>
+          <p>"Proverbs" is released under the conditions of the
+          <a class="reference external" href=
+          "https://www.wtfpl.net/about/">WTFPL</a>, version
+          2.0.</p>
+        </dd>
+
+        <dt>Version<span class="colon">:</span></dt>
+
+        <dd>
+          <p>1.6 of 2019/10/15</p>
+        </dd>
+
+        <dt>Author<span class="colon">:</span></dt>
+
+        <dd>
+          <p>"Proverbs" has been programmed by Michael Uplawski
+          &lt;<a class="reference external" href=
+          "mailto:michael.uplawski@uplawski.eu">michael.uplawski@uplawski.eu</a>&gt;.
+          The German parlor game <em>"Verrückte Sprichwörter"</em>
+          ("Crazy Proverbs") was the principal inspiration for the
+          project.</p>
+        </dd>
+      </dl>
+
+      <p><strong>Ω</strong>
+      </p>
+    </section>
+  </main>
+</body>
+</html>