mime 0.9.6

  • README.md
  • CHANGELOG.md
  • Installing
  • Versions
  • 97

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.6

  • Updates to support Dart 2.0 core library changes (wave 2.2). See issue 31847 for details.

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.6"

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.6 Feb 1, 2018 Go to the documentation of mime 0.9.6 Download mime 0.9.6 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

All 50 versions...

Analysis

This feature is new.
We welcome feedback.
More details: scoring.

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

  • completed on Feb 3, 2018
  • Dart: 2.0.0-dev.20.0
  • pana: 0.10.1

Scores

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

Platforms

Detected platforms: Flutter, web, other

No platform restriction found in primary library package:mime/mime.dart.

Suggestions

  • The description is too short.

    Add more detail about the package, what it does and what is its target use case. Try to write at least 60 characters.

  • Package is pre-v1 release.

    While there is nothing inherently wrong with versions of 0.*.*, it usually means that the author is still experimenting with the general direction API.

  • Maintain an example.

    Create a short demo in the example/ directory to show how to use this package. Common file name patterns include: main.dart, example.dart or you could also use mime.dart.

Dependencies

Package Constraint Resolved Available
Direct dependencies
Dart SDK >=2.0.0-dev.20.0 <2.0.0
Dev dependencies
test ^0.12.0