Package: animalsgonewild
animalsgonewildThis package is designed to demonstrate how basic features of text analysis can be utilized to analyze and represent a text file or string while applying a humorous lens (because what is data science without a dash of humor!). It counts the number of words from a text, calculates the average word length of that text, and returns an animal image corresponding to the average word length. It subsequently transforms the text into a wordcloud in the shape of the animal. We have included a bonus fourth function for fun, inspired by the popular childhood game - MadLibs.ContributorsKyle Maj, Nagraj Rao, Morgan Rosenberg, Junrong ZhuInstallationpipinstallanimalsgonewildUsageThis package can be used in conjunction with any code to read in multiple text files to analyze and compare whole corpuses (your software must call the Animals Gone Wild functions for each text variable).For more examples of usage in python, please check out thislink.import animalsgonewild
from animalsgonewild.animalsgonewild import animalClassifier
from animalsgonewild.animalsgonewild import animalType
from animalsgonewild.animalsgonewild import textTransformer
from animalsgonewild.animalsgonewild import wordClousFunction 1: animalClassifierThis function takes a sequence of text(str), counts the words in the string, and then returns an animal type (str).Function 2: animalTypeThis function takes a sequence of text(str)  and a species (str), determines the average word length (proxy for language complexity), and returns an smart looking animal image (jpg) corresponding to the average word length.Function 3: wordcloudThis function takes a sequence of text(str) and an animal image (jpg), and returns a wordcloud in the shape of the species comprised of the sequence of text (jpg).Function 4: textTransformerThis function takes a sequence of text(str) and a species(str), and returns a new text sequence where all proper nouns are replaced with the species.Fit within the Python ecosystemWhile other fun packages with animal images exist, most are very basic. For example, the animal-cuties script (https://pypi.org/project/animal-cuties/#description) generates animal images (e.g. animal-cuties cat). However, we were unable to find any interactive, multidimensional comedic relief package, where users can input information, and receive dynamic humorous feedback in the form of cute and/or hilarious animals. Given how much time we all are spending in front of a computer screen during the pandemic, this package is an essential addition to the ecosystem promoting mental wellness through humor. By offering it as a package rather than a script, we also empower other developers to integrate this is as a fun injection to their coding projecs.ContributingInterested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.Licenseanimalsgonewildwas created by DSCI 524 - Team 16:
Nagraj Rao, Junrong Zhu, Kyle Maj, Morgan RosenbergIt is licensed under the terms of the MIT license.Creditsanimalsgonewildwas created withcookiecutterand thepy-pkgs-cookiecuttertemplate.Easter egg #1Did you know the name of our package was almost called "whattheduck"?Easter egg #2Got any carrots?Easter egg #3Aren't we pretty?