Skip to content

06j07m/MADCAS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Marvel and DC Character Appearances Sorter, or, ...

MADCAS

About ~ Features ~ Installation ~ Usage ~ FAQ

About

MADCAS allows you to paste from any character's Appearances list on the Marvel and DC fandom wikis and get a clean, sorted list! See below for more information on how it sorts.

Warning

There are issues for characters with many appearances-- 50+ gets really slow 🥲 See below for a workaround.

Features

Implemented:

  • Support for Marvel wiki
    • Paste list from any marvel.fandom.com/Category:<name>_(Earth-616)/Appearances page
    • Should also work for other comic universes, but NOT guaranteed for television or movies
  • Support for DC wiki
    • Paste list from any dc.fandom.com/Category:<name>_(Prime_Earth)/Appearances or dc.fandom.com/Category:<name>_(New_Earth)/Appearances page
    • Should also work for other comic universes, but NOT guaranteed for television or movies

Future (hopefully):

  • Save to file
    • Be able to save to new files or update existing files
  • Read from file
    • Be able to upload a text file with the list of appearances
  • Read website information directly
    • Be able to find character appearances by name or reality instead of copy and pasting the list of appearances
  • Combine New Earth/Prime Earth
    • Have the option to get DC character appearances from 1986 to the present all at once

Installation

Instructions

Download the source code and run locally.

Requirements

  • Python 3.11
    • Flask
    • requests
    • beautifulsoup4

Detailed requirements are in the requirements.txt file.

Usage

  1. Find the Appearances page of your favourite character

  2. Copy the list of issue titles (some have multiple pages)

  3. Open a terminal in the directory where the source code is

  4. Run app.py (Flask should automatically detect it)

    python -m flask run
    
  5. Go to the local server address in your browser

  6. Select the MADCAS page that corresponds to the wiki

  7. Paste your list into the first box on the left

  8. Hit "Sort"

The sorted list will show up in the text box on the right.

FAQ

What do you mean, sorted?

MADCAS sorts each issue in the character appearances list using two criteria:

  1. By volume of the issue
  2. By publication date of the volume

The publication date of each volume is determined by the publication date of the first issue where the character has an appearance.

The Marvel wiki already has all the appearances sorted by publication date, so MADCAS organizes them by volume.

The DC wiki has all the appearances sorted by volume, so MADCAS sends some requests to the wiki and determines the publication dates, then organizes the volumes accordingly.

What is the --- line that appears in the sorted DC list?

MADCAS uses each issue's wiki page to find the "was published on" date. Unfortunately, it only looks for dates in a specific format.

Anything before the --- line is not sorted by publication date because the program couldn't find anything matching usual format. Anything after the line is sorted as usual.

How can I workaround the DC character appearance sorter being slow?

If you don't need the appearances sorted by publication date, you can put them in the Marvel sorter.

The resulting list will still be sorted by volume, and have all the duplicates and alphabet headers removed. Only it will be in alphabetical order of the volumes, rather than date.

About

Marvel and DC wiki character appearances sorter, made using BeautifulSoup and Flask

Topics

Resources

Stars

Watchers

Forks