https://github.com/matthewelse/bumps-tools
Tools for extracting data from "The Bumps" book CD-ROM
https://github.com/matthewelse/bumps-tools
Last synced: about 1 year ago
JSON representation
Tools for extracting data from "The Bumps" book CD-ROM
- Host: GitHub
- URL: https://github.com/matthewelse/bumps-tools
- Owner: matthewelse
- Created: 2021-06-15T22:25:12.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2023-06-18T18:47:21.000Z (about 3 years ago)
- Last Synced: 2025-01-27T11:49:47.207Z (over 1 year ago)
- Language: Rust
- Size: 1.67 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# The Bumps Tools
A set of tools for extracting data from the (now dated) bumps CD-ROM. To use
these tools, you need to start with a copy of the CD-ROM.
## Extracting data files from the install CD
1. Install [unshield](https://github.com/twogood/unshield). On MacOS, `brew
install unshield` should work.
2. Extract the data files from the installer CD.
```bash
$ cd $CD_PATH
$ mkdir -p data
$ unshield x -d data INSTALL/data1.cab
$ ls data
Data_Files Help_Files Program_Executable_Files Text_Files
```
The `Data_Files` directory contains a number of .dat files, which are encrypted
using a simple algorithm, described in `src/decode.rs`.
## Decoding data files
Use the `decode` tool.
```bash
$ cd $THIS_REPO_PATH
$ cargo run -q -- decode --file $CD_PATH/data/Data_Files/Data/Colleges.dat
!
! NAME FILE
!
[1st Trinity]
29 1 158
1st Trinity Black Prince blackp
1st Trinity 1trin
1st Trinity 2 1trin2
1st Trinity 3 1trin3
...
```
## Querying results
Use the `query` tool.
```bash
$ cd $THIS_REPO_PATH
$ cargo run -q -- query --competition men-mays --crew kings --year 1998 --data-dir $CD_PATH/data/Data_Files
year: 1998
crew name: King's 3
crew alias: kings3
results: [78, 79, 80, 81, 81]
```