Skip to content

Commit 42982b6

Browse files
committed
release v1.3.0
1 parent 0b122ee commit 42982b6

File tree

6 files changed

+19
-7
lines changed

6 files changed

+19
-7
lines changed

CHANGELOG.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,6 @@
1+
## 1.3.0
2+
- Do not include the `enough_mail` package automatically to keep documentation simpler
3+
14
## 1.2.0
25
- Add `HtmlToPlainTextConverter` with HTML to plain text conversion
36

README.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
Generate html code from any email mime message for displaying it.
22

33
## Usage
4-
The `enough_mail_html` package defines the `decodeTextHtmlForDisplay()` extension method on `MimeMessage` of the [enough_mail](https://pub.dev/packages/enough_mail) package.
4+
The `enough_mail_html` package defines the `transformToHtml()` extension method on `MimeMessage` of the [enough_mail](https://pub.dev/packages/enough_mail) package.
55

66
This method will always generate HTML, specifically also for plain text or empty messages.
77
You can define your custom processors
@@ -19,6 +19,10 @@ String generateHtml(MimeMessage mimeMessage) {
1919
return mimeMessage.transformToHtml(
2020
blockExternalImages: false, emptyMessageText: 'Nothing here, move on!');
2121
}
22+
23+
String generatePlainText(String htmlText) {
24+
return HtmlToPlainTextConverter.convert(htmlText);
25+
}
2226
```
2327

2428
More examples:
@@ -63,7 +67,7 @@ Add this dependency your pubspec.yaml file:
6367

6468
```
6569
dependencies:
66-
enough_mail_html: ^1.0.0
70+
enough_mail_html: ^1.3.0
6771
```
6872
The latest version or `enough_mail_html` is [![enough_mail_html version](https://img.shields.io/pub/v/enough_mail_html.svg)](https://pub.dartlang.org/packages/enough_mail_html).
6973

example/enough_mail_html_example.dart

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,10 @@ String simpleTransformExample(MimeMessage mimeMessage) {
66
return mimeMessage.transformToHtml();
77
}
88

9+
String generatePlainText(String htmlText) {
10+
return HtmlToPlainTextConverter.convert(htmlText);
11+
}
12+
913
String configureImageBlockingOrEmptyMessage(MimeMessage mimeMessage) {
1014
return mimeMessage.transformToHtml(
1115
blockExternalImages: true, emptyMessageText: 'Nothing here, move on!');

lib/enough_mail_html.dart

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,5 +5,3 @@ library enough_mail_html;
55

66
export 'src/enough_mail_html_base.dart';
77
export 'src/converter.dart';
8-
9-
export 'package:enough_mail/enough_mail.dart';

lib/src/converter.dart

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,19 @@
11
/// Converts HTML text into a plain text message.
22
class HtmlToPlainTextConverter {
33
static final _htmlEntityRegex = RegExp(r'&(#?)([a-zA-Z0-9]+?);');
4-
static final htmlTagRegex =
4+
static final _htmlTagRegex =
55
RegExp(r'<[^>]*>', multiLine: true, caseSensitive: true);
66

7+
// disallow instantiation:
8+
HtmlToPlainTextConverter._();
9+
710
/// Converts the given [htmlText] into plain text.
811
///
912
/// - It keeps code untouched in the <pre> elements
1013
/// - Blockquotes are transformed into lines starting with `>`
1114
/// - HTML entities are transformed to their plain text representation
1215
static String convert(final String htmlText) {
13-
final matches = htmlTagRegex.allMatches(htmlText).toList();
16+
final matches = _htmlTagRegex.allMatches(htmlText).toList();
1417
final plainTextBuffer = StringBuffer();
1518
var lastMatchIndex = 0;
1619
for (var i = 0; i < matches.length; i++) {

pubspec.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
name: enough_mail_html
22
description: Generate HTML from an email mime message and creates plain text from HTML. Eases handling of `MimeMessage` in the `enough_mail` package.
3-
version: 1.2.0
3+
version: 1.3.0
44
homepage: https://github.com/Enough-Software/enough_mail_html
55

66
environment:

0 commit comments

Comments
 (0)