swh.lister.dlang package#

Submodules#

Module contents#

Dlang lister#

D is a general-purpose programming language with static typing, systems-level access, and C-like syntax.

The Dlang lister list origins from its packages manager registry DUB.

The registry provides an http api endpoint that helps in getting the packages index with name, url, versions and dates.

As of July 2023 DUB list 2364 package names.

Origins retrieving strategy#

To build a list of origins we make a GET request to an http api endpoint that returns a JSON-formatted array of objects. The origin url for each package is constructed with the information of corresponding repository entry which represents Git based projects hosted on Github, GitLab or Bitbucket.

Page listing#

There is only one page listing all origins url.

Origins from page#

The lister is stateless and yields all origins url from one page. It is a list of package url with last update information.

Running tests#

Activate the virtualenv and run from within swh-lister directory:

pytest -s -vv --log-cli-level=DEBUG swh/lister/dlang/tests

Testing with Docker#

Change directory to swh/docker then launch the docker environment:

docker compose up -d

Then schedule a dlang listing task:

docker compose exec swh-scheduler swh scheduler task add -p oneshot list-dlang

You can follow lister execution by displaying logs of swh-lister service:

docker compose logs -f swh-lister
swh.lister.dlang.register()[source]#