uri_content

Description:

uri content

uri_content enables you to fetch the content of a URI without generating any temporary files during the process.
It supports the following schemes: file, data, http/https, content (Android only)
Getting Started #
import 'package:uri_content/uri_content.dart';
copied to clipboard
There are two ways to use this package: extension methods that allow you to fetch content directly from a URI like it was a native method, or through a UriContent instance.
UriContent #
UriContent is preferred because it offers additional options such as custom HTTP headers and the ability to adjust the default buffer size for content schemes. It also facilitates code testing since you can mock its instance.
import 'package:uri_content/uri_content.dart';

final uriContent = UriContent();
copied to clipboard
Future<void> getReadmeLength() async {
try {
final content = await uriContent.from(Uri.parse(
"https://raw.githubusercontent.com/talesbarreto/pull_request_coverage/main/README.md",
));
print("Content length is ${content.length}");
} catch (e, s) {
print("An error happened $e\n$s");
}
}
copied to clipboard
getContentStream()
This method retrieves a Stream of Uint8List where each event represents a chunk of content from the specified URI. This approach is more suitable when you don't need the entire content at once, such as in a request provider or when directly saving the bytes into a File. Handling small chunks significantly reduces memory consumption.
Stream<Uint8List> contentStream = uriContent.getContentStream(uri);
copied to clipboard
from()
This method retrieves the entire content at once. Be cautious as it may crash your app when attempting to retrieve a large file.

Throws exception if it was nos possible to get the content

Future<Uint8List> content = uriContent.from(uri);
copied to clipboard
fromOrNull()
Similar to from, but returns null instead of throwing an exception when an error happens.
Future<Uint8List?> content = uriContent.fromOrNull(uri);
copied to clipboard
canFetchContent()
This method checks if it is possible to fetch the content from the specified Uri. If it is a file, it checks if it exists. If it is a http/https Uri, it checks if it is reachable.
Future<bool> canFetch = uriContent.canFetchContent(uri);
copied to clipboard
getContentLength()
returns the content length in bytes of the specified Uri.

It relies on metadata to get the content length so it may not be accurate.
It may throw an exception if the content is not reachable.
If the content length is not available, it returns null.

Future<int?> contentLength = uriContent.getContentLength(uri);
copied to clipboard
getContentLengthOrNull()
Similar to getContentLength, but return null on errors.
Note that null is ambiguous; it may indicate that the content is not reachable or the content length is unavailable. Hence, it is recommended to use `getContentLength() and handle its exceptions.
Future<int?> contentLength = uriContent.getContentLengthOrNull(uri);
copied to clipboard
Using getContent() extension #
A handy extension method for Uri allows direct fetching of URI content.
Future<void> getReadmeContent() async {
try {
final uri = Uri.parse(
"https://raw.githubusercontent.com/talesbarreto/pull_request_coverage/main/README.md",
);
print(await (uri.getContent().then(utf8.decode)));
} catch (e, s) {
print("An error happened $e\n$s");
}
}

copied to clipboard

getContentOrNull() is also available, returning null instead of throwing an exception when an error happens.