https://github.com/github/email_reply_parser

Small library to parse plain text email content
https://github.com/github/email_reply_parser

Last synced: 27 days ago
JSON representation

Small library to parse plain text email content

• Host: GitHub
• URL: https://github.com/github/email_reply_parser
• Owner: github
• License: mit
• Created: 2011-02-23T02:13:11.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2024-04-02T17:39:26.000Z (7 months ago)
• Last Synced: 2024-09-30T00:05:34.073Z (about 1 month ago)
• Language: Ruby
• Homepage:
• Size: 117 KB
• Stars: 668
• Watchers: 294
• Forks: 155
• Open Issues: 28
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Email Reply Parser

EmailReplyParser is a small library to parse plain text email content.

See the rocco-documented source code for specifics on how it works.

This is what GitHub uses to display comments that were created from

email replies.  This code is being open sourced in an effort to

crowdsource the quality of our email representation.

See the [Ruby docs][rubydocs] for more information.

[rubydocs]: http://rubydoc.info/gems/email_reply_parser/

## Usage

To parse reply body:

`parsed_body = EmailReplyParser.parse_reply(email_body)`

## Problem?

If you have a question about the behavior and formatting of email replies on GitHub, check out [support][support].  If you have a specific issue regarding this library, then hit up the [Issues][issues].

[support]: https://github.com/support

[issues]: https://github.com/github/email_reply_parser/issues

## Installation

Get it from [GitHub][github] or `gem install email_reply_parser`.  Run `rake` to run the tests.

[github]: https://github.com/github/email_reply_parser

## Contribute

If you'd like to hack on EmailReplyParser, start by forking the repo on GitHub:

https://github.com/github/email_reply_parser

The best way to get your changes merged back into core is as follows:

* Clone down your fork

* Create a thoughtfully named topic branch to contain your change

* Hack away

* Add tests and make sure everything still passes by running rake

* If you are adding new functionality, document it in the README

* Do not change the version number, I will do that on my end

* If necessary, rebase your commits into logical chunks, without errors

* Push the branch up to GitHub

* Send a pull request to the `github/email_reply_parser` project.

## Known Issues

### Quoted Headers

Quoted headers aren't picked up if the email client breaks it up into multiple

lines.  GMail breaks up any lines over 80 characters for you.

    On , 

    wrote:

    > blah

Not to mention that we're searching for "on" and "wrote".  It won't work

with other languages.

Possible solution: Remove "[email protected]" lines...

### Weird Signatures

Lines starting with `-` or `_` sometimes mark the beginning of

signatures:

    Hello

    --

    Rick

Not everyone follows this convention:

    Hello

    Mr Rick Olson

    Galactic President Superstar Mc Awesomeville

    GitHub

    **********************DISCLAIMER***********************************

    * Note: blah blah blah                                            *

    **********************DISCLAIMER***********************************