download/org.fdroid.download

Package-level declarations

Types

BytesReceiver

fun interface BytesReceiver

CustomDns

actual typealias CustomDns = Dns

typealias CustomDns = Dns

expect interface CustomDns

actual interface CustomDns

Custom DNS isn't support for JVM at the moment.

Downloader

abstract class Downloader(indexFile: IndexFile, outputFile: File)

DownloadRequest

data class DownloadRequest(val indexFile: ERROR CLASS: Symbol not found for IndexFile, val mirrors: List<Mirror>, val proxy: ERROR CLASS: Symbol not found for ProxyConfig?? = null, val username: String? = null, val password: String? = null, val tryFirstMirror: Mirror? = null)

HeadInfo

data class HeadInfo(val eTagChanged: Boolean, val eTag: String?, val contentLength: Long?, val lastModified: String?)

HttpDownloader

class ~~HttpDownloader~~(httpManager: HttpManager, request: DownloadRequest, destFile: File) : Downloader

Download files over HTTP, with support for proxies, .onion addresses, HTTP Basic Auth, etc.

HttpDownloaderV2

class HttpDownloaderV2(httpManager: HttpManager, request: DownloadRequest, destFile: File) : Downloader

Download files over HTTP, with support for proxies, .onion addresses, HTTP Basic Auth, etc.

HttpManager

open class HttpManager(userAgent: String, queryString: String? = null, proxyConfig: ERROR CLASS: Symbol not found for ProxyConfig?? = null, customDns: CustomDns? = null, mirrorParameterManager: MirrorParameterManager? = null, highTimeouts: Boolean = false, mirrorChooser: MirrorChooser = MirrorChooserWithParameters(mirrorParameterManager), httpClientEngineFactory: ERROR CLASS: Symbol not found for HttpClientEngineFactory<*> = getHttpClientEngineFactory(customDns))

HttpPoster

class HttpPoster(httpManager: HttpManager, url: String)

HTTP POST a JSON string to the URL configured in the constructor.

Mirror

data class Mirror(val baseUrl: String, val countryCode: String? = null, val ipv4Addresses: List<String> = emptyList(), val ipv6Addresses: List<String> = emptyList(), val isIpfsGateway: Boolean = false)

MirrorChooser

interface MirrorChooser

MirrorParameterManager

interface MirrorParameterManager

This is an interface for providing access to stored parameters for mirrors without adding additional dependencies. The expectation is that this will be used to store and retrieve data about mirror performance to use when ordering mirror for subsequent tests.

NoResumeException

class NoResumeException : Exception

Thrown if we tried to resume a download, but the current mirror server does not offer resuming.

NotFoundException

class NotFoundException(e: Throwable? = null) : Exception

Thrown when a file was not found. Catching this is useful when checking if a new index version exists and then falling back to an older version.

Functions

getDigestInputStream

suspend fun HttpManager.getDigestInputStream(request: DownloadRequest): DigestInputStream

Gets the InputStream for the given request as a DigestInputStream, so you can verify the SHA-256 hash. If you don't need to verify the hash, use getInputStream instead.

getInputStream

suspend fun HttpManager.getInputStream(request: DownloadRequest): InputStream

isInvalidHttpUrl

fun isInvalidHttpUrl(url: String): Boolean