Skip to content

Commit

Permalink
Rewrite README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
clzls committed Mar 10, 2023
1 parent 540d8ee commit 86114c9
Showing 1 changed file with 13 additions and 11 deletions.
24 changes: 13 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,15 @@
# MHTifier
Un/packs an MHT (MHTML) archive into/from separate files, writing/reading them in directories to match their Content-Location.
# MHTifier 2
Un/packs a MHT (MHTML) archive into/from separate files, writing/reading them
in directories to match their Content-Location.

Whole [story](http://decodecode.net/elitist/2013/01/mhtifier/) is in my devlog.
A fork from [Modified/MHTifier](https://github.com/Modified/MHTifier).

# Issues
1. Cleanest would've been to use stdin/out, but turned out inconvenient, annoying even, so added command line options.
2. Python's stdlib module's performance (premature optimization?):
`email.message_from_bytes(mht.read()) # Parser is "conducive to incremental parsing of email messages, such as would be necessary when reading the text of an email message from a source that can block", so I guess it's more efficient to have it read stdin directly, rather than buffering.`
3. Encodings (ascii, UTF-8) and de/coding was painful, and probably still buggy.
4. base64 encoded binaries: my editor, Geany, suffocates, I think, when wrapping these long lines?
1. Verify index.html is present!?
1. A few un/Pythonisms, idioms,I guess.
Under development, so no public API should be assumed.

## Known Issues
1. Cleanest would've been to use stdin/out, but turned out inconvenient,
annoying even, so added command line options.
2. Verify index.html is present!?
3. A few un/Pythonisms, idioms,I guess.
4. Rewrite whole program to provide stable public APIs. Preferably, keep it as
a single file with no dependency other than Python 3 and its standard libraries.

0 comments on commit 86114c9

Please sign in to comment.