Package: zalgolib
ZalgoLib.py - A Full Zalgo Experience"Full"While Zalgo text's popularity has waned, I'm still a fan. I also have a need for it. Other Zalgo libraries aren't recent, are a part of a larger set of tools, haven't been audited for security recently, or don't offer a lot of customization options.The goal of this library is to give a decent set of defaults for en-Zalgo-fy [encoding to Zalgo] and de-Zalgo-fy [decoding from Zalgo] text to various degrees, as well as creating a custom class to dial in specific options.I want to focus on functionality and periodically check in and update as needed.Documentationdependenciesrandom(standard library) is the only dependency required. I've writting this library in python 3.7, but I expect it should work fairly well with a wider set of python versions. The key is my use ofrandom.choices()- if this isn't importable, you'll need to adjust and tweak. I use it to select from the lists of diacriticswith replacement.zalgolib.pyenzalgofy: takes two keyword arguments (textandintensity).textexpects astringas input - you can feed it from whatever source you want.intensityexpects anintfrom0-100(inclusive) and represents a rough percentage of the marks to include on each character.The default is 50.This scales up quite quickly, with values less than 20 being fairly light and values over 75 being very heavy. The differences lower or higher (respectively) from those points have some diminishing returns on legibility.In the future, I'd like to adjust this to provide some more variability from character to character within a block of text. I'd like to make this available as a parameter as well.dezalgofy: takes a zalgostring, converts it to ascii, and then back to utf-8. It ignores all errors. This isn't great overall, since if you're adding text that's accented already, it will return a stripped version of it. To be fair, that problem seems sufficiently complex to solve, and probably benefits from a language specifier and dictionaries, or some ML magic. As it is, it's fairly lean and does the job.diacritics.pyThis contains the various diacritics used in creating zalgo text. Currently, it contains:"DOWN_MARKS": marks that appear below a given character aslist. There are currently 40 of these."DOWN_LEN": length ofDOWN_MARKSasint"UP_MARKS": marks that appear above a given character aslist. There are currently 46 of these."UP_LEN": length ofUP_MARKSasint"MID_MARKS": marks that appear in the middle of, directly over, or overlapping the character slightly in front of or behind aslist. There are currently 21 of these."MID_LEN": length ofMID_MARKSasintThis is a work-in-progress. There are many more overlapping marks to be found in the unicode space. I hope to revisit these soon and include some of the ones specified below:Extended Combining Diacritical MarksCombining Diacritical MarksMarkers from other languages such as Arabic, Hebrew, Hindi, Bengali, Oriya, Malayalam, Tamil, etc.These python lists can be added to in your script, but you'll have to recalculate the lengths (since length calculation from the module is done at import). Conversely, you can just append the characters todiacritics.pyas you see fit, either by adding them to the list or adding them as new lists.To-Doadd additional readily-available diacriticsadd variability to number of diacritics added per characterbased on text inputmake parameter available for adjustingperhaps add option for random variability?add scaffolding to publish to PyPIpublish to PyPILicenseI went with a permissive license (MIT) so feel free to use this any way you want. If you're proud of what you've made with my library, feel free to reach out and I'll try to add your project to a list below. Also, please check the credits section below, which also contributed to my choice to go with the MIT license.CreditI am utilizing the list of diacritics that was carefully and conveniently laid out byGregory Nealin hisZalgo implementation. Huge thanks to him for not only being a great programmer, but also using a very permissive MIT license that allows me to use a part of his work for my own. Just because I don't have to credit him doesn't mean I won't.