bechdel.io

Find out if your favorite film passes the test

deps Coverage Status Build Status Maintainability stars pr license twitter snyk greenkeeper bch compliance first-timers-only

The Bechdel Test, sometimes called the Mo Movie Measure or Bechdel Rule is a simple test which names the following three criteria:

  1. It includes at least two women
  2. who have at least one conversation
  3. about something other than a man or men.

The test was popularized by Alison Bechdel's comic Dykes to Watch Out For, in a 1985 strip called The Rule. For a nice video introduction to the subject please check out The Bechdel Test for Women in Movies on feministfrequency.com.

This program accepts a movie script and analyzes whether or not it passes the Bechdel Test, as well as analyzing several other feminist components to a film. It can answer questions like "How many females are in this film," "By what factor does this pass the Bechdel Test?"

Prerequisites

Fast Way - Setup Your Project with Docker

Start here if you want to get setup quickly using a docker image.

Pre-reqs

Download and unpack Bechdel Test. Or alternatively checkout from source:

git clone https://github.com/JoeKarlsson/bechdel-test
cd bechdel-test

Next, inside the project, you need to install the project's various NPM dependencies:

npm install

Start up Docker, and you should now be ready to spin up a development build of your new project:

npm run start:docker

Navigate to http://localhost:3000

Slow Way - Setup Your Project Locally

Pre-reqs

  • Install Node.js
  • Install MongoDB (Create a new database called bechdelTest in MongoDD.)

Setup Your Project

Download and unpack Bechdel Test. Or alternatively checkout from source:

git clone https://github.com/JoeKarlsson/bechdel-test
cd bechdel-test

Next, inside the project, you need to install the project's various NPM dependencies:

npm install

Start up your local mongo server

mongod

Configure Mongo, and create a new Mongo collection called bechdelTest:

mongo
use bechdelTest

Quit out of the mongo shell, and you should now be ready to spin up a development build of your new project:

npm start

Navigate to http://localhost:3000

Testing

Follow the setup steps listed above. Once the app is running

git clone https://github.com/JoeKarlsson/bechdel-test
cd bechdel-test
npm install

The bechdel.io test suite is run with npm test. You can read more about testing bechdel.io.

You can start bechdel.io by using start:docker.

Introduction

The Bechdel Test Script Parser was a collaborative digital humanities project between myself and my sister, Laurel Karlsson. It is the product of a shared passion for film, feminism, and the creative potential of technology. By combining the talents and interests of myself, a software engineer, we’ve been able to create an innovative data mining tool for film analysis that we hope to continue to work on and improve. You can check out the project on our website.

This project was born when my sister reached out to me for advice on a few ideas she had been mulling over for a digital humanities project. Hoping to do something related to feminist film analysis, she was feeling very limited by my lack of coding experience and hadn’t been able to find an existing data mining tool to accomplish what she was looking to do. I immediately offered up my coding expertise, looking to gain experience by building a tool from scratch which would accomplish the specific needs of the project. After brainstorming several different project ideas, we settled on the one you see here.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

TLDR;

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D

Maintainers


Joe Karlsson

Laurel Karlsson

License

MIT

Related Links

Resources

Built With

Share this project:
×

Updates