Thank you for the comments and helpful source. I felt like a ship lost at sea without a host because I had unmoored myself from American tech giants. I tried to sign up for gitlab and showed up instead at the server that haukex's employer uses, because I'm there so often to get the details on configuring an rpi. I was refused entrance, and I thought, "gosh, I've never been refused entrance to anything in Berlin ever. Is this a new balkanization of the net?" No. It's me showing up in the wrong place, disoriented by Charybdis, blinded by Scylla....

So lot's of changes with hosting situations, and I found it much better to use Getopt::Long and the command line to input the data rather than have it instantiated in a sub. I'm super rusty with the module building parts that I just couldn't even start with that. Now that I have a place to host source code again, maybe this is the type of thing I should work up again.

For now though, I have a working script, and I wanted to post it as a result for the thread.

fritz@laptop:~/Documents$ ./4.getopt.pl --infile /home/fritz/Desktop/1
+.tran.txt --outfile /home/fritz/Desktop/1.enc_trans.txt --lang EL --v
+erbose 1
/home/fritz/Desktop/1.tran.txt, /home/fritz/Desktop/1.enc_trans.txt, E
+L, 1

...
./4.getopt.pl : sending above payload, of 574 bytes...
...
./4.getopt.pl : text=Scylla and Charybdis are the horns of a dilemma.&
+target_lang=EL
./4.getopt.pl : sending above payload, of 68 bytes..../4.getopt.pl : d
+one, success.
fritz@laptop:~/Documents$
[download]

Source:

#!/usr/bin/env perl
use v5.030;    # strictness implied
use warnings;
use utf8;
use Getopt::Long;

#use Net::API::DeepL qw/http_tiny/; # maybe someday...

my ( $infile, $outfile, $lang, $verbose );
$verbose = 0;
if (
  !Getopt::Long::GetOptions(
    'infile=s'  => \$infile,
    'outfile=s' => \$outfile,
    'lang=s'    => \$lang,
    'verbose=i' => \$verbose,
    'help'      => sub {
      print STDERR
        "Usage : $0 --infile xx --outfile xx --lang xx [--verbose N]\n
+";
      exit(0);
    },
  )
  )
{
  die "error, something wrong with the command-line parameters.";
}

die "parameters needed!" unless $infile and $outfile and $lang;

say "$infile, $outfile, $lang, $verbose";

# at this point consider adding all your parameters into a hash and
# pass that to http_tiny($options) instead of passing a long list whic
+h
# may contain optional parameters.
my %h;
$h{infile}  = $infile;
$h{outfile} = $outfile;
$h{lang}    = $lang;
$h{verbose} = $verbose;
my $results = http_tiny( \%h );

die unless $results;

print "$0 : done, success.\n";

sub http_tiny {

  my ($hr) = (shift);

  use Path::Tiny;
  use HTTP::Tiny;
  use JSON::MaybeXS;

  my %h        = %$hr;
  my $file_in  = path( $h{infile} );
  my $file_out = path( $h{outfile} );
  my $lang     = $h{lang};
  my $debug    = $h{verbose};

  # slurp file
  my $guts = $file_in->slurp_utf8;
  my @spl  = split( '\n', $guts );

  # get credentials
  my ( $url, $key ) = get_тайный()
+;

  #say "$url, $key";

  my $ua = HTTP::Tiny->new( 'verify_SSL' => '1' );

  for my $para (@spl) {

    say $para;

    my $payload    = "text=$para&target_lang=$lang";
    my $payloadlen = length($payload);

    my $response = $ua->request(
      'POST' => $url,
      {
        headers => {
          'Authorization'  => "DeepL-Auth-Key $key",
          'Content-Length' => $payloadlen,
          'Accept'         => '*/*',
          'Content-Type'   => 'application/x-www-form-urlencoded',
          'User-Agent'     => 'curl/7.55.1'
        },
        content => $payload,
      },
    );

    die "Failed!\n" unless $response->{success};

    if ( $debug > 0 ) {

      print
        "$0 : $payload\n$0 : sending above payload, of $payloadlen byt
+es...";
    }

    #print $response->{content} if length $response->{content};
    my $content = $response->{content};

    #say "content is $content";
    my $data = decode_json($content);

    #say "data is $data";
    my $text1 = $data->{'translations'}->[0]->{'text'};
    my $outstring = $para. "\n".$text1."\n";
    $file_out->append_utf8( $outstring);
    

  }
  return $hr;
}

sub get_тайный {

  use Config::Tiny;

  my $ini_path = qw( 1.тайный.txt 
+ );
  my $sub_hash = "deepl";
  my $Config   = Config::Tiny->new;

  $Config = Config::Tiny->read( $ini_path, 'utf8' );

  # -> is optional between brackets
  my $url = $Config->{$sub_hash}{'url'};
  my $key = $Config->{$sub_hash}{'key'};

  return ( $url, $key );
}

__END__
[download]

Output in pre tags:

Σας ευχαριστώ για τα σχόλια και τη χρήσιμη πηγή. Ένιωθα σαν ένα πλοίο χαμένο στη θάλασσα χωρίς οικοδεσπότη, επειδή είχα ξεκολλήσει από τους αμερικανικούς τεχνολογικούς γίγαντες. Προσπάθησα να εγγραφώ στο gitlab και εμφανίστηκα αντ' αυτού στον διακομιστή που χρησιμοποιεί ο εργοδότης του haukex, επειδή βρίσκομαι εκεί τόσο συχνά για να πάρω τις λεπτομέρειες σχετικά με τη διαμόρφωση ενός rpi. Μου αρνήθηκαν την είσοδο και σκέφτηκα: "Θεέ μου, ποτέ δεν μου έχουν αρνηθεί την είσοδο σε κάτι στο Βερολίνο. Πρόκειται για μια νέα βαλκανοποίηση του δικτύου;" Όχι. Είναι ότι εμφανίστηκα σε λάθος μέρος, αποπροσανατολισμένος από τη Χάρυβδη, τυφλωμένος από τη Σκύλλα....

It's interesting for me to see the proper nouns that are the protoliths of what we know in English.

Σκύλλα

Cheers,

See also Re: GetOpt Organization for some optimizations of the usage of Getopt::Long.

«The Crux of the Biscuit is the Apostrophe»

good start!

# at this point consider adding all your parameters into a hash and
# pass that to http_tiny($options) instead of passing a long list whic
+h
# may contain optional parameters.
my %h;
$h{infile}  = $infile;
...
[download]

Note that you can pack all into a hash from the beginning avoiding myriads of loose variables:

my %h; # or %params
...
Getopt::Long::GetOptions(
    'infile=s'  => \$h{infile},
    # or more flexible:
    'outfile=s' => sub { $h{$_[0]} = $_[1] },
   # the anonymous sub above will be called with 2 params
   # when --outfile is detected: the key (outfile) and its value
...
}
[download]

Also, the sub get_... (secrets) is a good example where error checking is important. The sub itself does not check whether it found the secrets pair in the config file or whether it managed to open the file. It returns a pair of possibly undefined values (if it does not bomb midway because of IO errors). And you do not check its return value: it will be a pair but will it have defined values? Personally I prefer to pass into subs hash/array refs and return back hash/array refs. In this way if it returns undef then I know an error occured.

sub get_... {
  if( /error/ ){ print STDERR "errors"; return undef }
  return [$url, $key];
}
# use it
my $ret = get_...();
if( ! defined $ret ){ print STDERR "call to get_...() has failed"; exi
+t(1) }
my ($url, $key) = @$ret;
[download]

Apropos the translation, it is impressively good. The *$&?^%$^* will sell the rope with which to be "hanged" but with the current logistics standstill, keep spinning those yarns on the ol'spindle, with Perl, hehehe

bw, bliako