mirror of https://github.com/renovatebot/renovate.git synced 2026-11-01 18:19:51 +00:00

Files

T

Punsoong Khut 795d083264 feat(datasource): add APK datasource support (#40250 )

* feat(datasource): add APK datasource support

* remove missing manager link for now

* lint docs

* update tests

* replace binary fixtures

* fix coverage

* Update lib/modules/datasource/apk/readme.md

Co-authored-by: Jamie Tanna <github@jamietanna.co.uk>

* Apply suggestion from @viceice

Co-authored-by: Michael Kriese <michael.kriese@gmx.de>

* use tar instead of tar-stream

* use codeBlock

* add ignore back

* make method private

* use an async extract instead of list

* add usage example

* stream apkindex download and parse line-by-line

* refactor(datasource): address review comments on APK datasource

Co-authored-by: Cursor <cursoragent@cursor.com>

* chore: sync pnpm-lock.yaml after merge

Co-authored-by: Cursor <cursoragent@cursor.com>

* test: remove ignored lines

As they seem to be covered, anyway.

* fixup! Merge remote-tracking branch 'origin/HEAD' into apk-datasource

* fixup! fixup! Merge remote-tracking branch 'origin/HEAD' into apk-datasource

* lint: use `node:` prefix

* Update lib/modules/datasource/apk/index.ts

Co-authored-by: Michael Kriese <michael.kriese@gmx.de>

* refactor(datasource/apk): use asTimestamp millis instead of new Date

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor(datasource/apk): rename uncached method to _getPackages

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor(datasource/apk): encode registry URL parts as query parameters

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(datasource/apk): reject invalid registry URLs, skip caching empty indexes

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(datasource/apk): throw on unparseable registry URL and drop unset sourceUrl support

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs(datasource/apk): show how registry URL parameters build the index URLs

Co-authored-by: Cursor <cursoragent@cursor.com>

* Apply suggestions from code review

Co-authored-by: RahulGautamSingh <rahultesnik@gmail.com>

* fix(datasource/apk): keep credentials and port in component URLs

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(datasource/apk): extract APKINDEX by basename and key packages by name

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(datasource/apk): report a version served by two components only once

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Jamie Tanna <github@jamietanna.co.uk>
Co-authored-by: Michael Kriese <michael.kriese@gmx.de>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Jamie Tanna <jamie.tanna@mend.io>
Co-authored-by: RahulGautamSingh <rahultesnik@gmail.com>

2026-09-04 12:25:21 +00:00

apk

feat(datasource): add APK datasource support (#40250 )

2026-09-04 12:25:21 +00:00

artifactory

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

aws-eks-addon

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

aws-machine-image

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

aws-rds

docs(tool-calling): centralise AWS configuration (#45586 )

2026-09-03 08:25:17 +00:00

azure-bicep-resource

refactor(linters): add prefer-coerce-array rule (#45492 )

2026-08-28 09:27:58 +00:00

azure-pipelines-tasks

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

azure-tags

test(linter): add renovate/no-redundant-mock-reset rule (#44557 )

2026-07-14 11:26:20 +00:00

bazel

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

bitbucket-server-tags

refactor(schemas): prefer Nullish schema utils instead of z.nullish() (#44565 )

2026-07-14 10:15:55 +00:00

bitbucket-tags

test(datasource): replace file snapshots with explicit assertions (#45655 )

2026-09-03 14:31:08 +00:00

bitrise

fix(linters): forbid inert counts in v8 coverage-ignore comments (#45287 )

2026-08-22 11:25:31 +00:00

buildpacks-registry

chore: migrate from zod/v3 to zod/v4 (#43691 )

2026-05-30 16:01:58 +00:00

cdnjs

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

clojure

test(datasource): replace file snapshots with explicit assertions (#45655 )

2026-09-03 14:31:08 +00:00

conan

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

conda

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

cpan

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

crate

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

custom

refactor(linters): add prefer-coerce-array rule (#45492 )

2026-08-28 09:27:58 +00:00

dart

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

dart-version

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

deb

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

deno

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

devbox

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

docker

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

dotnet-version

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

elm-package

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

endoflife-date

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

flutter-version

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

forgejo-releases

chore: migrate from zod/v3 to zod/v4 (#43691 )

2026-05-30 16:01:58 +00:00

forgejo-tags

chore: migrate from zod/v3 to zod/v4 (#43691 )

2026-05-30 16:01:58 +00:00

galaxy

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

galaxy-collection

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

git-refs

test(datasource): replace file snapshots with explicit assertions (#45655 )

2026-09-03 14:31:08 +00:00

git-tags

test(datasource): replace file snapshots with explicit assertions (#45655 )

2026-09-03 14:31:08 +00:00

gitea-releases

chore: migrate from zod/v3 to zod/v4 (#43691 )

2026-05-30 16:01:58 +00:00

gitea-tags

chore: migrate from zod/v3 to zod/v4 (#43691 )

2026-05-30 16:01:58 +00:00

github-digest

feat: Add github-digest datasource (#40226 )

2026-02-02 10:58:43 +00:00

github-release-attachments

test(linters): add linting rule to enforce usage of host rules test util (#44692 )

2026-07-19 10:36:12 +00:00

github-releases

test(linters): add linting rule to enforce usage of host rules test util (#44692 )

2026-07-19 10:36:12 +00:00

github-runners

feat(datasource/github-runners): add macOS Intel labels (#43540 )

2026-06-11 20:28:57 +00:00

github-tags

fix(datasource/github-tags): use GitHub Release published_at for releaseTimestamp (#43451 )

2026-05-19 09:35:38 +00:00

gitlab-packages

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

gitlab-releases

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

gitlab-tags

test(datasource): replace file snapshots with explicit assertions (#45655 )

2026-09-03 14:31:08 +00:00

glasskube-packages

refactor(linters): add prefer-coerce-array rule (#45492 )

2026-08-28 09:27:58 +00:00

test(datasource): replace file snapshots with explicit assertions (#45655 )

2026-09-03 14:31:08 +00:00

golang-version

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

gradle-version

test: shrink oversized fixtures to representative examples (#45666 )

2026-09-04 10:40:45 +00:00

hackage

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

helm

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

hermit

refactor(oxlint): enable vitest/require-to-throw-message (#44421 )

2026-07-07 17:47:04 +00:00

hex

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

hexpm-bob

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

java-version

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

jenkins-plugins

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

jsr

fix(datasource/jsr): accept scopes shorter than the JSR registration minimum (#45547 )

2026-09-01 12:59:23 +00:00

kubernetes-api

refactor: Rewrite imports with .ts extensions (#40700 )

2026-01-26 22:48:17 +00:00

maven

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

nextcloud

docs: ensure that config in documentation is error and warning free (#43727 )

2026-06-02 13:29:48 +00:00

node-version

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

npm

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

nuget

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

orb

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

packagist

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

pod

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

puppet-forge

refactor(schemas): prefer Nullish schema utils instead of z.nullish() (#44565 )

2026-07-14 10:15:55 +00:00

pypi

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

python-version

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

repology

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

rpm

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

ruby-version

test: shrink oversized fixtures to representative examples (#45666 )

2026-09-04 10:40:45 +00:00

rubygems

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

rust-version

refactor(lint): add types-location rule and enable it for lib/modules (#45497 )

2026-08-27 19:52:09 +00:00

sbt-package

test: shrink oversized fixtures to representative examples (#45666 )

2026-09-04 10:40:45 +00:00

sbt-plugin

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

terraform-module

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

terraform-provider

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

typst

chore: migrate from zod/v3 to zod/v4 (#43691 )

2026-05-30 16:01:58 +00:00

unity3d

refactor(linters): enable oxlint rule prefer-named-capture-group (#44714 )

2026-09-03 09:54:40 +00:00

unity3d-packages

docs: ensure that config in documentation is error and warning free (#43727 )

2026-06-02 13:29:48 +00:00

api.ts

feat(datasource): add APK datasource support (#40250 )

2026-09-04 12:25:21 +00:00

common.spec.ts

refactor(linter): oxlint prefer partial typed casts for consts (#45239 )

2026-08-12 08:50:57 +00:00

common.ts

chore(datasource): downgrade log level to TRACE (#43010 )

2026-04-30 19:49:52 +00:00

datasource.spec.ts

refactor(lint): Organize imports with biome (#40966 )

2026-02-06 13:40:01 +00:00

datasource.ts

refactor(oxlint): enable no-else-return and unicorn/no-lonely-if (#44553 )

2026-07-14 12:11:21 +00:00

index.spec.ts

test: use expect().resolves instead of awaiting inside expect (#45672 )

2026-09-04 10:40:46 +00:00

index.ts

refactor(linters): add prefer-coerce-array rule (#45492 )

2026-08-28 09:27:58 +00:00

metadata-manual.ts

feat!: Switch to ESM modules (#40756 )

2026-01-29 14:21:41 +00:00

metadata.spec.ts

test(datasource): replace file snapshots with explicit assertions (#45655 )

2026-09-03 14:31:08 +00:00

metadata.ts

refactor: Rewrite imports with .ts extensions (#40700 )

2026-01-26 22:48:17 +00:00

postprocess-release.spec.ts

fix(datasource): use release-level registryUrl in postprocessRelease (#45096 )

2026-09-04 11:23:50 +00:00

postprocess-release.ts

fix(datasource): use release-level registryUrl in postprocessRelease (#45096 )

2026-09-04 11:23:50 +00:00

readme.md

docs: use unicode arrow (→) instead of ASCII (->) (#42896 )

2026-04-27 07:11:16 +00:00

schema.ts

chore: migrate from zod/v3 to zod/v4 (#43691 )

2026-05-30 16:01:58 +00:00

span-processor.spec.ts

test(oxlint): enable vitest/consistent-test-it (#44554 )

2026-07-14 12:28:52 +00:00

span-processor.ts

chore(instrumentation): add timing statistics for getReleases (#42523 )

2026-04-14 17:36:37 +00:00

types.ts

docs: add inline JSDoc for RegistryStrategy (#43364 )

2026-05-15 08:31:47 +00:00

util.spec.ts

test: replace env operation with vi.stubEnv() (#45490 )

2026-08-28 09:26:20 +00:00

util.ts

fix(datasource/nuget): don't follow Link headers with different hosts

2026-08-04 08:56:59 +01:00

utils.spec.ts

refactor(oxlint): enable typescript/no-unnecessary-type-arguments (#44555 )

2026-07-14 12:33:42 +00:00

readme.md

Datasources

Datasources are used in Renovate primarily to fetch released versions of packages.

Follow the class-based programming style

New datasources must follow the class-based programming style. Use the java-version datasource as a reference.

Add the datasource to the API in api.ts so that the new datasource is usable. If you find Unused HTTP mocks errors in the Vitest tests and your mocked URLs are correct, make sure the datasource is correctly registered.

getReleases

The minimum exported interface for a datasource is a function called getReleases that takes a lookup config as input.

The config has:

packageName: the package's full name including scope if present (e.g. @foo/bar)
registryUrls: an array of registry URLs to try

getReleases should return an object having:

releases: an array of strings of matched versions. This is the only mandatory field
deprecationMessage: a string description of the package's deprecation notice, if applicable
sourceUrl: a HTTP URL pointing to the source code (for example on GitHub)
homepage: a HTTP URL for the package's homepage. Ideally should be empty if the homepage and sourceUrl are the same
changelogUrl: a URL pointing to the package's changelog (could be a Markdown file, for example). If not present then Renovate will search the sourceUrl for a changelog file
tags: an object mapping tag → version, for example tags: { latest: '3.0.0' }. This is only used by the followTags function

getDigest

Datasources that support digests (like Docker digests and Git commit hashes) can export a getDigest function.

The getDigest function has two inputs:

config: the Renovate config for the package being updated, has the same fields as getReleases
newValue: the version or value to retrieve the digest for

The getDigest function returns a string output representing the digest value. If no digest is found, the getDigest function should return null.