Ryan Malloy
0bea793a09
Starlight automatically renders the frontmatter title as H1, so having a duplicate # Title in the body creates redundancy. Removed from 29 content files across all sections.
173 lines
6.1 KiB
Plaintext
173 lines
6.1 KiB
Plaintext
---
|
|
title: Credits & Attributions
|
|
description: The open source projects and cultural references that make mcwaddams possible.
|
|
---
|
|
|
|
import { Aside, Card, CardGrid, LinkCard } from '@astrojs/starlight/components';
|
|
|
|
> *"It's not just about me and my dream of doing nothing."*
|
|
|
|
mcwaddams stands on the shoulders of giants — both technical and cinematic.
|
|
|
|
---
|
|
|
|
## Open Source Dependencies
|
|
|
|
The tools that make document extraction possible.
|
|
|
|
<CardGrid>
|
|
<Card title="python-docx" icon="document">
|
|
Modern Word document processing. The workhorse of `.docx` extraction.
|
|
<br/><small>MIT License</small>
|
|
</Card>
|
|
<Card title="openpyxl" icon="document">
|
|
Excel XLSX file processing with full formula support.
|
|
<br/><small>MIT License</small>
|
|
</Card>
|
|
<Card title="python-pptx" icon="document">
|
|
PowerPoint PPTX processing for slides and speaker notes.
|
|
<br/><small>MIT License</small>
|
|
</Card>
|
|
<Card title="mammoth" icon="document">
|
|
Enhanced Word to HTML/Markdown conversion. Our fallback hero.
|
|
<br/><small>BSD-2-Clause</small>
|
|
</Card>
|
|
</CardGrid>
|
|
|
|
<CardGrid>
|
|
<Card title="pandas" icon="document">
|
|
Data analysis powerhouse. Handles CSV and Excel fallbacks.
|
|
<br/><small>BSD-3-Clause</small>
|
|
</Card>
|
|
<Card title="olefile" icon="document">
|
|
OLE Compound Document parsing for legacy `.doc`, `.xls`, `.ppt`.
|
|
<br/><small>BSD-2-Clause</small>
|
|
</Card>
|
|
<Card title="xlrd" icon="document">
|
|
Legacy Excel XLS support. Because 2003 never really left.
|
|
<br/><small>BSD License</small>
|
|
</Card>
|
|
<Card title="Pillow" icon="document">
|
|
Image processing for embedded graphics extraction.
|
|
<br/><small>HPND License</small>
|
|
</Card>
|
|
</CardGrid>
|
|
|
|
### Framework & Tools
|
|
|
|
| Project | Purpose | License |
|
|
|---------|---------|---------|
|
|
| [FastMCP](https://github.com/jlowin/fastmcp) | MCP server framework | MIT |
|
|
| [Astro](https://astro.build) | This documentation site | MIT |
|
|
| [Starlight](https://starlight.astro.build) | Documentation theme | MIT |
|
|
| [Tailwind CSS](https://tailwindcss.com) | Styling | MIT |
|
|
|
|
---
|
|
|
|
## Office Space
|
|
|
|
The cultural foundation of this project.
|
|
|
|
<Aside type="tip" title="Why Office Space?">
|
|
Mike Judge's 1999 film isn't just a comedy — it's a documentary about corporate dysfunction that resonates with anyone who's ever debugged a printer or processed legacy documents.
|
|
</Aside>
|
|
|
|
### The References
|
|
|
|
| Reference | Location | Why It Fits |
|
|
|-----------|----------|-------------|
|
|
| **Milton Waddams** | Project name | Relegated to the basement with legacy documents |
|
|
| **TPS Reports** | Test section | "Testing Painful Stuff" — `.doc` from 1997 is painful |
|
|
| **Red Swingline** | Logo/branding | The small things that matter |
|
|
| **"Did you get the memo?"** | Throughout | Clear documentation is essential |
|
|
| **"I could set the building on fire"** | Footer | But we'd rather process documents |
|
|
| **Pieces of Flair** | Badge system | Gamification for the bureaucratic soul |
|
|
|
|
### Key Quotes Used
|
|
|
|
> *"I was told there would be document extraction."*
|
|
|
|
Adaptation of Milton's "I was told there would be cake" — except here, there actually is document extraction.
|
|
|
|
> *"Did you get the memo about the TPS reports?"*
|
|
|
|
Our test section is literally called TPS Reports. Because testing legacy formats is painful, and we test it so you don't have to.
|
|
|
|
> *"I believe you have my stapler..."*
|
|
|
|
The persistence of caring about the small things. Like proper Unicode handling in a `.doc` from 1997.
|
|
|
|
---
|
|
|
|
## Author
|
|
|
|
<Card title="Ryan Malloy" icon="external">
|
|
Built by Ryan Malloy at [Supported Systems](https://supported.systems).
|
|
<br/><br/>
|
|
- [ryanmalloy.com](https://ryanmalloy.com) — Personal site
|
|
- [GitHub](https://github.com/ryanmalloy) — Open source work
|
|
<br/><br/>
|
|
<small>
|
|
Read: [AI Discernment vs AI Criticism](https://ryanmalloy.com/collaborations/ai-discernment-vs-criticism/) —
|
|
On building with AI while maintaining craft standards.
|
|
</small>
|
|
</Card>
|
|
|
|
---
|
|
|
|
## Special Thanks
|
|
|
|
### The Python Community
|
|
|
|
For building and maintaining the libraries that make Office document processing possible. Every commit to `python-docx` or `openpyxl` makes legacy document handling slightly less painful.
|
|
|
|
### The MCP Ecosystem
|
|
|
|
For creating a protocol that lets AI agents access tools without reinventing the wheel. mcwaddams exists because FastMCP made it trivial to build.
|
|
|
|
### Mike Judge
|
|
|
|
For creating Office Space and giving the tech industry a shared vocabulary for describing workplace dysfunction. The red stapler is a symbol of what happens when you ignore the people doing the actual work.
|
|
|
|
The hero image — featuring THE actual film slate and red Swingline from production — is courtesy of [Mike Judge on X](https://x.com/MikeJudge).
|
|
|
|
Additional Office Space screenshots and character images sourced from the [Office Space Wiki](https://officespace.fandom.com/wiki/Office_Space_Wiki). Initech logo from the [Initech wiki page](https://officespace.fandom.com/wiki/Initech). Box of Flair merchandise image from the [Office Space Box of Flair wiki page](https://officespace.fandom.com/wiki/Office_Space_Box_of_Flair).
|
|
|
|
### Swingline
|
|
|
|
For actually manufacturing a red stapler after the movie came out. Sometimes life imitates art. (Fun fact: the prop department painted a black stapler red because Swingline didn't make that color in 1999.)
|
|
|
|
---
|
|
|
|
## License
|
|
|
|
mcwaddams is released under the MIT License.
|
|
|
|
```
|
|
MIT License
|
|
|
|
Copyright (c) 2024 Ryan Malloy
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in all
|
|
copies or substantial portions of the Software.
|
|
```
|
|
|
|
---
|
|
|
|
<div style="text-align: center; margin-top: 3rem;">
|
|
|
|
🔴
|
|
|
|
*I believe you have my documentation...*
|
|
|
|
<small>Unlike Milton's stapler, this one's MIT licensed. Take it.</small>
|
|
|
|
</div>
|