Go to file
Jochen Sprickerhof 6ab4b99a5f Merge branch 'jdk17' into 'master'
checkupdates: add a bookworm blocklist item

See merge request fdroid/fdroidserver!1458
2024-03-15 07:15:26 +00:00
.vscode fix vscode setting 2021-06-24 12:15:01 +00:00
buildserver use full base docker image 2024-03-14 13:14:40 +01:00
completion [checkupdates] Remove --gplay option 2023-11-21 07:18:17 +00:00
docs [docs] Enable intersphinx 2023-10-22 20:43:52 +02:00
examples fixups from "feat: add servergitmirrors as a dict support" 2024-02-14 18:10:29 +01:00
fdroidserver checkupdates: add a bookworm blocklist item 2024-03-14 21:44:32 +08:00
hooks download looseversion to vendor 2023-12-08 10:42:27 +01:00
locale locale/ro: Fix template string 2023-09-22 09:37:33 +02:00
tests fix `Could not initialize class org.codehaus.groovy.runtime.InvokerHelper` 2024-03-14 13:14:41 +01:00
.bandit add vscode settings 2021-06-18 06:50:50 +00:00
.editorconfig Add .editorconfig 2022-09-20 14:08:04 +00:00
.gitignore metadata: test to check that metadata/*.yml overrides .fdroid.yml 2023-05-11 10:37:45 +02:00
.gitlab-ci.yml update docker image tag 2024-03-14 13:14:41 +01:00
.mailmap add myself to .mailmap !1347 2023-04-21 08:01:44 +02:00
.safety-policy.yml safety: ignore CVE-2024-22190 it only affects Windows 2024-02-14 17:46:12 +01:00
.weblate add weblate config for wlc CLI tool 2019-05-01 21:16:15 +02:00
.yamllint hooks/pre-commit: run yamllint on more YAML files 2023-04-28 10:55:21 +02:00
CHANGELOG.md remove last `maven:` quirks and make it always a string 2023-04-24 11:08:48 +02:00
CONTRIBUTING.md update CONTRIBUTING.md 2023-05-22 14:16:31 +00:00
LICENSE Rename COPYING to LICENSE 2015-08-24 10:54:20 -07:00
MANIFEST.in ⛰️ make ipa related test cases more robust 2024-01-11 12:02:53 +01:00
README.md update README to fix out of date things 2023-05-22 14:16:31 +00:00
fdroid fix tests on old python version 2020-01-28 11:43:09 +01:00
gradlew-fdroid drop gradle support before 2.0 2024-03-14 13:14:41 +01:00
jenkins-build-all Upgrade Buildserver VM 2022-10-10 21:22:59 +02:00
jenkins-setup-build-environment buildserver: move config to buildserver/Vagrantfile.yaml 2022-11-03 13:27:16 +01:00
jenkins-test Upgrade Buildserver VM 2022-10-10 21:22:59 +02:00
makebuildserver upgrade basebox to 12.20231211.1 2024-03-14 13:14:41 +01:00
pyproject.toml convert tests/testcommon.py to black code format 2024-03-06 13:31:46 +00:00
setup.cfg make linting and formatting rules consistent 2023-05-04 14:12:08 +00:00
setup.py use appdirs to get easy cross-platform standard directories 2024-03-14 12:43:02 +00:00

README.md

F-Droid Server

Tools for maintaining an F-Droid repository system.


What is F-Droid Server?

fdroidserver is a suite of tools to publish and work with collections of Android apps (APK files) and other kinds of packages. It is used to maintain the f-droid.org application repository. These same tools can be used to create additional or alternative repositories for publishing, or to assist in creating, testing and submitting metadata to the f-droid.org repository, also known as fdroiddata.

For documentation, please see https://f-droid.org/docs.

In the beginning, fdroidserver was the complete server-side setup that ran f-droid.org. Since then, the website and other parts have been split out into their own projects. The name for this suite of tooling has stayed fdroidserver even though it no longer contains any proper server component.

Installing

There are many ways to install fdroidserver, including using a range of package managers. All of the options are documented on the website: https://f-droid.org/docs/Installing_the_Server_and_Repo_Tools

Tests

To run the full test suite:

tests/run-tests

To run the tests for individual Python modules, see the .TestCase files, e.g.:

tests/metadata.TestCase

It is also possible to run individual tests:

tests/metadata.TestCase MetadataTest.test_rewrite_yaml_special_build_params

There is a growing test suite that has good coverage on a number of key parts of this code base. It does not yet cover all the code, and there are some parts where the technical debt makes it difficult to write unit tests. New tests should be standard Python unittest test cases. Whenever possible, the old tests written in bash in tests/run-tests should be ported to Python.

This test suite has built over time a bit haphazardly, so it is not as clean, organized, or complete as it could be. We welcome contributions. The goal is to move towards standard Python testing patterns and to expand the unit test coverage. Before rearchitecting any parts of it, be sure to contact us to discuss the changes beforehand.

Additional tests for different linux distributions

These tests are also run on various configurations through GitLab CI. This is only enabled for master@fdroid/fdroidserver because it takes longer to complete than the regular CI tests. Most of the time you won't need to worry about them, but sometimes it might make sense to also run them for your merge request. In that case you need to remove these lines from .gitlab-ci.yml and push this to a new branch of your fork.

Alternatively run them locally like this: gitlab-runner exec docker ubuntu_lts

Buildserver

The tests for the whole build server setup are entirely separate because they require at least 200 GB of disk space, and 8 GB of RAM. These test scripts are in the root of the project, all starting with jenkins- since they used to be run on https://jenkins.debian.net.

Documentation

The API documentation based on the docstrings gets automatically published here on every commit on the master branch.

It can be built locally via

pip install -e .[docs]
cd docs
sphinx-apidoc -o ./source ../fdroidserver -M -e
sphinx-autogen -o generated source/*.rst
make html

To additionally lint the code call

pydocstyle fdroidserver --count

When writing docstrings you should follow the numpy style guide.

Translation

Everything can be translated. See Translation and Localization for more info.

View translation status for all languages.