mime 0.9.5

  • README.md
  • CHANGELOG.md
  • Installing
  • Versions
  • 96

Package for working with MIME type definitions and for processing streams of MIME multipart media types.

Determining the MIME type for a file

The MimeTypeResolver class can be used to determine the MIME type of a file. It supports both using the extension of the file name and looking at magic bytes from the beginning of the file.

There is a builtin instance of MimeTypeResolver accessible through the top level function lookupMimeType. This builtin instance has the most common file name extensions and magic bytes registered.

print(lookupMimeType('test.html'));  // Will print text/html
print(lookupMimeType('test', [0xFF, 0xD8]));  // Will print image/jpeg
print(lookupMimeType('test.html', [0xFF, 0xD8]));  // Will print image/jpeg

You can build you own resolver by creating an instance of MimeTypeResolver and adding file name extensions and magic bytes using addExtension and addMagicNumber.

Processing MIME multipart media types

The class MimeMultipartTransformer is used to process a Stream of bytes encoded using a MIME multipart media types encoding. The transformer provides a new Stream of MimeMultipart objects each of which have the headers and the content of each part. The content of a part is provided as a stream of bytes.

Below is an example showing how to process an HTTP request and print the length of the content of each part.

// HTTP request with content type multipart/form-data.
HttpRequest request = ...;
// Determine the boundary form the content type header
String boundary = request.headers.contentType.parameters['boundary'];

// Process the body just calculating the length of each part.
request
    .transform(new MimeMultipartTransformer(boundary))
    .map((part) => part.fold(0, (p, d) => p + d))
    .listen((length) => print('Part with length $length'));

Take a look at the HttpBodyHandler in the http_server package for handling different content types in an HTTP request.

Features and bugs

Please file feature requests and bugs at the issue tracker.

0.9.5

  • Add support for the WebAssembly format.

0.9.4

  • Updated Dart SDK requirement to >= 1.8.3 <2.0.0

  • Strong-mode clean.

  • Added support for glTF text and binary formats.

0.9.3

  • Fixed erroneous behavior for listening and when pausing/resuming stream of parts.

0.9.2

  • Fixed erroneous behavior when pausing/canceling stream of parts but already listened to one part.

0.9.1

  • Handle parsing of MIME multipart content with no parts.

1. Depend on it

Add this to your package's pubspec.yaml file:


dependencies:
  mime: "^0.9.5"

2. Install it

You can install packages from the command line:

with pub:


$ pub get

with Flutter:


$ flutter packages get

Alternatively, your editor might support pub get or packages get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:


import 'package:mime/mime.dart';
        
Version Uploaded Documentation Archive
0.9.5 Dec 7, 2017 Go to the documentation of mime 0.9.5 Download mime 0.9.5 archive
0.9.4 Oct 25, 2017 Go to the documentation of mime 0.9.4 Download mime 0.9.4 archive
0.9.3 Feb 18, 2015 Go to the documentation of mime 0.9.3 Download mime 0.9.3 archive
0.9.2 Feb 12, 2015 Go to the documentation of mime 0.9.2 Download mime 0.9.2 archive
0.9.1 Dec 3, 2014 Go to the documentation of mime 0.9.1 Download mime 0.9.1 archive
0.9.0+3 May 30, 2014 Go to the documentation of mime 0.9.0+3 Download mime 0.9.0+3 archive
0.9.0+1 May 13, 2014 Go to the documentation of mime 0.9.0+1 Download mime 0.9.0+1 archive
0.9.0 Nov 6, 2013 Go to the documentation of mime 0.9.0 Download mime 0.9.0 archive
0.8.10+4 Nov 5, 2013 Go to the documentation of mime 0.8.10+4 Download mime 0.8.10+4 archive
0.8.10+3 Nov 4, 2013 Go to the documentation of mime 0.8.10+3 Download mime 0.8.10+3 archive

All 49 versions...

Analysis

This feature is new.
We welcome feedback.

We analyzed this package, and provided a score, details, and suggestions below.

  • completed on Dec 7, 2017
  • Dart: 2.0.0-dev.8.0
  • pana: 0.7.3+1

Scores

Popularity:
Describes how popular the package is relative to other packages. [more]
92
Health:
Code health derived from static analysis. [more]
100
Maintenance:
Reflects how tidy and up-to-date the package is. [more]
99
Overall score:
Weighted score of the above. [more]
96

Platforms

Detected platforms: Flutter, server, web

All libraries agree

Dependencies

Package Constraint Resolved Available
Dev dependencies
test ^0.12.0