afasi

Fuzz a language by mixing up only few words.

v2021.10.28

• Happy linter, happy winter

Installation

Preferred way to install is as usual (for testing or in isolation):

$ pipx install afasi

For production use (well, ahem, ...) or within a virtual python env:

$ pip install afasi

Use

Examples

Version

$ afasi version
Fuzz a language by mixing up only few words. version 2021.10.28

General Help

$ afasi
Usage: afasi [OPTIONS] COMMAND [ARGS]...

  Fuzz a language by mixing up only few words.

  The translation table entries are applied in order per line of input. So,
  with large translation tables the performance will obviously degrade with a
  power of two. The latter should be taken as a hint to maintain both language
  files in separate entities not as a patch task.

  The translation table is either an array of two element arrays provided as
  JSON and thus shall be in a shape like:

    [
      ["repl", "ace"],
      ["als", "othis"]
    ]

  Or the table is given as an object providing more detailed instructions
  constraining the translation rules like:

  * contra indicators - when given exempting a line from translation
  * pro indicators - when given marking a line for translation
  * flip_flop indicators - providing either stop-start (default) or start-stop state switching

  The JSON object format is best understood when executing the template
  command and adapting the resulting JSON object written to standard out.

  Default for input source is standard in and out per default is sent to
  standard out.

Options:
  -V, --version  Display the afasi version and exit
  -h, --help     Show this message and exit.

Commands:
  template   Write a template of a translation table JSON structure to...
  translate  Translate from a language to a 'langauge'.
  version    Display the afasi version and exit

Translate Help

$ afasi translate -h
Usage: afasi translate [OPTIONS] [SOURCE] [TARGET]

  Translate from a language to a 'langauge'.

Arguments:
  [SOURCE]  [default: STDIN]
  [TARGET]  [default: STDOUT]

Options:
  -i, --input <sourcepath>        Path to input file (default is reading from
                                  standard in)
  -o, --output <targetpath>       Path to non-existing output file (default is
                                  writing to standard out)
  -t, --table <translation table path>
                                  Path to translation table file in JSON
                                  format. Structure of table data is [["repl",
                                  "ace"], ["als", "othis"]]
  -n, --dryrun                    Flag to execute without writing the
                                  translation but a diff instead (default is
                                  False)
  -h, --help                      Show this message and exit.

Translate Dryrun

$ afasi translate minimal-in.xml --table minimal.json --dryrun
dryrun requested
# ---
* resources used:
  - input from:       "minimal-in.xml"
  - output to:        STDOUT
  - translation from: "minimal.json"
* translations (in order):
  1. '>Rock' -> '>Lounge'
  2. '>Track' -> '>Rock'
* diff of source to target:
--- SOURCE
+++ TARGET
@@ -6,12 +6,12 @@
         <message id="SOME_TRACK">
             <source>Some Track</source>
             <extracomment>Does not matter.</extracomment>
-            <translation>Track</translation>
+            <translation>Rock</translation>
         </message>
         <message id="SOME_ROCK">
             <source>Some Rock</source>
             <extracomment>Does not matter.</extracomment>
-            <translation>Rock</translation>
+            <translation>Lounge</translation>
         </message>
     </context>
 </TS>
# ---

Translate

$ afasi translate --input minimal-in.xml --output minimal-out.xml --table minimal.json
$ afasi % diff -u minimal-*.xml
--- minimal-in.xml  2021-10-20 20:12:54.000000000 +0200
+++ minimal-out.xml 2021-10-20 20:14:45.000000000 +0200
@@ -6,12 +6,12 @@
         <message id="SOME_TRACK">
             <source>Some Track</source>
             <extracomment>Does not matter.</extracomment>
-            <translation>Track</translation>
+            <translation>Rock</translation>
         </message>
         <message id="SOME_ROCK">
             <source>Some Rock</source>
             <extracomment>Does not matter.</extracomment>
-            <translation>Rock</translation>
+            <translation>Lounge</translation>
         </message>
     </context>
 </TS>

Example Translation Tables

Simple version (parallel arrays):

[
  [">Rock", ">Lounge"],
  [">Track", ">Rock"]
]

Augmented version (object):

{
  "table": {
    "description": "table level default constraints, row attributes do replace those if present.",
    "contra": [
      "extracomment",
      "source"
    ],
    "count": 0,
    "flip_is_stop": true,
    "flip_flop": [
      "<message id=\"SOME_TRACK\">",
      "</message>"
    ],
    "pro": [
      "translation"
    ]
  },
  "foo": "bar",
  "translations": [
    {
      "repl": ">Lock",
      "ace": ">Launch"
    },
    {
      "repl": ">Track",
      "ace": ">Lock"
    },
    {
      "repl": ">Autotrack",
      "ace": ">Autolock"
    },
    {
      "repl": "lock r",
      "ace": "launch r"
    },
    {
      "repl": "track r",
      "ace": "lock r"
    }
  ]
}

Checksums

md5:a6699fc2205027e98c910d7bda724ce5  dist/afasi-2021.10.28.tar.gz
sha1:db320403cf64e7992d888f2c7b816556dbc27bf0  dist/afasi-2021.10.28.tar.gz
sha256:d265c63f635fd1c6efb91fd11b0fde95e7c3db1f5589cd654f1cd3e6a048ef87  dist/afasi-2021.10.28.tar.gz
sha384:c0e30b2aa465134ebb9b3f1f754243956b310242f405a4aacf4c3ad9fc8977a450df97c4361c44280c95372c8b8ffac3  dist/afasi-2021.10.28.tar.gz
sha512:e39ce973257e8c0dd554a62e396427a45fb12fff07d2481d04213ea1202a5aa64831cdd3b35d271d8433403076866f5158914b99a369231a21126decd760c500  dist/afasi-2021.10.28.tar.gz
dist/afasi-2021.10.28.tar.gz.md5:a6699fc2205027e98c910d7bda724ce5  dist/afasi-2021.10.28.tar.gz
dist/afasi-2021.10.28.tar.gz.sha1:db320403cf64e7992d888f2c7b816556dbc27bf0  dist/afasi-2021.10.28.tar.gz
dist/afasi-2021.10.28.tar.gz.sha256:d265c63f635fd1c6efb91fd11b0fde95e7c3db1f5589cd654f1cd3e6a048ef87  dist/afasi-2021.10.28.tar.gz
dist/afasi-2021.10.28.tar.gz.sha384:c0e30b2aa465134ebb9b3f1f754243956b310242f405a4aacf4c3ad9fc8977a450df97c4361c44280c95372c8b8ffac3  dist/afasi-2021.10.28.tar.gz
dist/afasi-2021.10.28.tar.gz.sha512:e39ce973257e8c0dd554a62e396427a45fb12fff07d2481d04213ea1202a5aa64831cdd3b35d271d8433403076866f5158914b99a369231a21126decd760c500  dist/afasi-2021.10.28.tar.gz

Status

Beta.

Note: The default branch is default.

afasi

Fuzz a language by mixing up only few words.

The translation table entries are applied in order per line of input. So, with large translation tables the performance will obviously degrade with a power of two. The latter should be taken as a hint to maintain both language files in separate entities not as a patch task.

The translation table is either

• an array or two element arrays provided as JSON and thus shall be in a shape like:

  [
    ["repl", "ace"],
    ["als", "othis"]
  ]
  

• or an object allowing for pro, contra replace indications, flip-flop behavior and more (see help for more info).

Default for input source is standard in and out per default is sent to standard out.

Packaging:

pypi.org/project/afasi/

Installation

$ pip install afasi==2021.10.22

Changelog

v2021.10.22

• Resolved feedback from friendly users
• Added new command template to ease use of augmented translation table syntax
• Simplified internal operation and reduced warning noise
• Documented new features and data structures
• Outer test line coverage again complete
• New: Contra indicators - when given exempting a line from translation
• New: Pro indicators - when given marking a line for translation
• New: Flip-Flop indicators - providing either stop-start (default) or start-stop state switching
• Refactored tests to use pytest tmp_path fixture to stabilize the tests
• Removed prototype data and tests from table implemenbtation

v2021.10.21

• Resolved feedback from friendly users
• Created initial documentation set covering API and examples of use
• Fixed python version dependency to be consistently 3.8, 3.9, and 3.10

v2021.10.20

• Initial release to pypi

Checksums

md5:6dbf5fc2da3c68e277976e754a02e6d1  dist/afasi-2021.10.22.tar.gz
sha1:b547a553545686d82b8f5100959d039c13c8412f  dist/afasi-2021.10.22.tar.gz
sha256:7e31edbbfcfb0cd02948830dd82aef9c274935aeb80de121679a1af1c481a3c5  dist/afasi-2021.10.22.tar.gz
sha384:7360545ec1afb88b27cb9fae0c594812624fb69b7b56e6834cba2a4b712c9ab954dc6d0a585d12bf859ede19bc807eeb  dist/afasi-2021.10.22.tar.gz
sha512:fa80b7bf1a223da9a519839ae519fe7e08ba9ad0ee6885ca1e88f48f59cccdf21b318b759452308415dfa8da388933d7a9360050b8326f2b1cf24dc3fe674325  dist/afasi-2021.10.22.tar.gz
dist/afasi-2021.10.22.tar.gz.md5:6dbf5fc2da3c68e277976e754a02e6d1  dist/afasi-2021.10.22.tar.gz
dist/afasi-2021.10.22.tar.gz.sha1:b547a553545686d82b8f5100959d039c13c8412f  dist/afasi-2021.10.22.tar.gz
dist/afasi-2021.10.22.tar.gz.sha256:7e31edbbfcfb0cd02948830dd82aef9c274935aeb80de121679a1af1c481a3c5  dist/afasi-2021.10.22.tar.gz
dist/afasi-2021.10.22.tar.gz.sha384:7360545ec1afb88b27cb9fae0c594812624fb69b7b56e6834cba2a4b712c9ab954dc6d0a585d12bf859ede19bc807eeb  dist/afasi-2021.10.22.tar.gz
dist/afasi-2021.10.22.tar.gz.sha512:fa80b7bf1a223da9a519839ae519fe7e08ba9ad0ee6885ca1e88f48f59cccdf21b318b759452308415dfa8da388933d7a9360050b8326f2b1cf24dc3fe674325  dist/afasi-2021.10.22.tar.gz

afasi

Fuzz a language by mixing up only few words.

The translation table entries are applied in order per line of input. So, with large translation tables the performance will obviously degrade with a power of two. The latter should be taken as a hint to maintain both language files in separate entities not as a patch task.

The translation table is an array or two element arrays provided as JSON and thus shall be in a shape like:

[
  ["repl", "ace"],
  ["als", "othis"]
]

Default for input source is standard in and out per default is sent to standard out.

Packaging:

pypi.org/project/afasi/

Installation

$ pip install afasi==2021.10.21

Changelog

v2021.10.21

• Resolved feedback from friendly users
• Created initial documentation set covering API and examples of use
• Fixed python version dependency to be consistently 3.8, 3.9, and 3.10

v2021.10.20

• Initial release to pypi

Checksums

md5:30b68466efc06882ffa708f0928487b1  dist/afasi-2021.10.21.tar.gz
sha1:6011eed2fe6d1311b648a6394001b63a16077c11  dist/afasi-2021.10.21.tar.gz
sha256:06eeed95d9df877cf89af18eca08bb59fba00b4973c58492839432d94b7e3bb5  dist/afasi-2021.10.21.tar.gz
sha384:bb60cdd316bb809a764be88683dcd9df615fcbc9119daf40211e8b35cc950248f48b84a75ef0c42f54ee7dd4602656a4  dist/afasi-2021.10.21.tar.gz
sha512:5fb82de73375f05436a543d457046b767094d89d68eed008e2b627d842f7c73492f4ebb8796928582792e26115eae1d1e6071b93ae3547d1472e5858930a05b5  dist/afasi-2021.10.21.tar.gz

afasi

Fuzz a language by mixing up only few words.

The translation table entries are applied in order per line of input. So, with large translation tables the performance will obviously degrade with a power of two. The latter should be taken as a hint to maintain both language files in separate entities not as a patch task.

The translation table is an array or two element arrays provided as JSON and thus shall be in a shape like:

[
  ["repl", "ace"],
  ["als", "othis"]
]

Default for input source is standard in and out per default is sent to standard out.

Packaging:

pypi.org/project/afasi/

Installation

$ pip install afasi==2021.10.20

Changelog

v2021.10.20

• Initial release to pypi

Checksums

md5:8fbd0eb4ea15af8bd4e60240d4cc15d4  dist/afasi-2021.10.20.tar.gz
sha1:1805e99835c36ad7e5708dbdbbacd81e28e0dbb2  dist/afasi-2021.10.20.tar.gz
sha256:0148214ceb5a69cb74bb4c85099eefc395c45552af4cbecaa4f2b290ef354dd5  dist/afasi-2021.10.20.tar.gz
sha384:5abbfedbd7fe64c85e31f54ea83de158989eaf89e141f7e475f525d01f5fcf7e37b6ef9e056cac9c05061bc15c17f831  dist/afasi-2021.10.20.tar.gz
sha512:935b009f79cd274a748c26c6b20c87fbad8bbbda8a4d7e4179b5ea7f2aa76d85c6f4ec165cca618b200781c3eec119e34c376e54ac5d731f753745a83c29b7ae  dist/afasi-2021.10.20.tar.gz