Discord Scripts & Use

Note: The current method of diffing is no longer working. This does not mean I will drop maint, only that I need to rewrite this before the next major reroll

The repo is currently serving the diff between the

6b9dd01 (2024-03-26) and 886f52c (2024-06-18)

commits from Sarah's Class Changes. Huge credit to XYZenix for help on completing the recent fixes. To find and replace classes in a file, you can call

python replace.py [-f file_path | -d dir_path]

Note that file replacement and directory replacement are mutually exclusive, and that directory replacement is recursive, so use it carefully. It's still a python script so it might be a little slow (see the other FAR scripts below!).

• Note that the script can be flawed and miss class rerolls! It prioritizes accuracy over completeness, so it will not catch everything. Consequently, I provide another critical classes that most themes might use, but this is made somewhat manually and may take a while to be more complete. Then I merge the two together. I have listed the 3 final result files below:

3rd Party Find and Replace Scripts

The below scripts use the same class changes as in this repo, but do replacement better or faster.

• Syndishanx's far website, easy to use w/ no prereqs and widely known
• Ames' golang far script, supports directory replacement
• Salts' python far script, supports directory replacement

Results

The most complete reroll mappings that I can provide

• classes_mapping.csv contains csv data that's for other programs to interpret
• classes_mapping.diff contains the above data in .diff format
• classes_mapping.txt contains the above data in a format suitable for syndishanx's website

Script compiled mappings

• classes_mapping_script.csv
• classes_mapping_script.diff

Manually compiled mappings

• classes_mapping_selectors.csv
• classes_mapping_selectors.diff

Credits!

• Massive credit to sarah for keeping a history of the discord js file so this is possible. It's probably the one file that can produce a reasonable diff
• Ames has made a script to implement the actual .diffs here. Please go check it out, it's incredibly useful
• SyndiShanX also has his own scripts which produce very similar results to mine but use a slightly different methodology. In fact I have added a CLI flag to my script that generates results in syndishanx's style. Also, he hosts a great website that allows you to do FAR without downloading a script.

Old Docs (remember this isn't just a repo for rerolls)

• cit.py - check if a list of newline separated classes is in the .css files
  • returns fail.txt
• it.py - check if a list of newline separated classes are in the theme file
  • returns fail_in_theme.txt
• diff.py - accepts .diff file generated with

  git diff commit1..commit2 --word-diff=porcelain ./discordclasses.js > classesjs.diff
  

  OR

  git diff commit1..commit2 --diff-algorithm=histogram ./discordclasses.js > classesjs.diff 
  

  of the classes.js file. Currently using the BD-Addons repo
  • Run python diff.py --help to see command flags. Syndi output requires diff output first
  • Requires pandas

Useful Patterns:

\{(.*?)\} -> for removing stuff in selectorplaceholders

[^\x00-\x7F]+ -> removing non ascii chars

e.exports = \{(.*?)\} -> classes.js stuff

\r\n\r\n \..* -> classescss.diff stuff \n[ ]+\n~ -> classescss.diff stuff

git diff commit1..commit2 --word-diff=porcelain ./selectorPlaceholders.scss > selectordiff.diff -> selector diff

git diff --no-index --word-diff=porcelain 1.js 2.js > classesjs.diff

git diff --word-diff=porcelain --no-index ./sources/14.css ./sources/15reroll.css > classescss.diff

git diff --word-diff=porcelain selectorPlaceholders.scss > classescss.diff

python diff.py --diff classes_mapping_script.diff python selectorscsv.py classes_mapping_selectors.diff classes_mapping_selectors.csv python csvmerge.py classes_mapping_selectors.csv classes_mapping_script.csv classes_mapping.csv classes_mapping.diff classes_mapping.txt

Procedure:

• git pull sarah's js file
• generate a diff
  • New steps: May have to download the 2 diff versions and run a different git diff by running alphabetize.py on each one and then diffing the 2
• run diff.py on it to generate a .csv and .diff file
• replace selectors and seek manuals. word diff w/ porcelain that file and clean it up with regex
• run selectorscsv.py to create the csv for that one
• run csvmerge.py to merge the csvs.

Todo:

• Change the script method to consume the classes.js file directly. Sort each export function in place alphabetically and then diff that instead.