semvec/pypi-packages huggingface dataset:
gender-bender 0.1.3
Flips the gender in a text snippet or epub
License: Apache-2.0
Requires Python: >=3.6,<4.0

## Gender Bender

This library allows you to flip the gender of a string or eBook (only works with the `epub` format).  The motivation was to be able to examine gender norms in a fun way.

To use the `epub` format, I recommend the Calibre reader or the Kobo.

### Installation

_Python 3 only_

With `pip`:
```shell script
pip install gender-bender 
```

or with `poetry`:
```shell script
poetry add gender-bender
```

**Note**: on first usage, it will install an English model for the Spacy dependency.  This
is unable to be installed from PyPI due to [this issue](https://github.com/explosion/spaCy/issues/3536).

### Usage

Or from python:

```python
from gender_bender import gender_bend_epub
gender_bend_epub('./Mythical_Man_Month.epub')
```

You can also gender-bend a string:

```python
from gender_bender import gender_bend
x = gender_bend("If Ivanka weren't my daughter, perhaps I'd be dating her.")

assert x == "If Ivan weren't my son, perhaps I'd be dating him."
```

### Installing from source

Get the repo:

```shell script
git clone https://github.com/Garrett-R/gender_bender.git
cd gender_bender
pip install -r requirements.txt
```

It can be run as a script:

```shell script
./main.py --input Lord_of_the_Flies.epub  --output Lady_of_the_Flies.epub
```

If you'd like to choose the names yourself (recommended for translating a whole ebook), you can do:

```shell script
./main.py --input The_Little_Mermaid.epub --interactive-naming
```