chiark / gitweb /
use utf-8 as default encoding for config.py
[fdroidserver.git] / examples / config.py
index 427342be6c6b882ee74c97daf291489848df3121..339e99609267558fcf7157284772a93f3f49d164 100644 (file)
@@ -1,38 +1,46 @@
 #!/usr/bin/env python2
+# -*- coding: utf-8 -*-
 
 # Copy this file to config.py, then amend the settings below according to
 # your system configuration.
 
 # Custom path to the Android SDK, defaults to $ANDROID_HOME
-# sdk_path = "/opt/android-sdk"
+# sdk_path = "$ANDROID_HOME"
 
 # Custom paths to various versions of the Android NDK, defaults to 'r10e' set
-# to $ANDROID_NDK.  Most users will have the latest at $ANDROID_NDK, which is
-# used by default.  If a version is missing or assigned to None, it is assumed
+# to $ANDROID_NDK. Most users will have the latest at $ANDROID_NDK, which is
+# used by default. If a version is missing or assigned to None, it is assumed
 # not installed.
 # ndk_paths = {
-#    'r9b': "/opt/android-ndk-r9b",
-#    'r10e': "/opt/android-ndk",
+#     'r9b': None,
+#     'r10e': "$ANDROID_NDK",
+# }
+
+# If you want to build apps that use retrolambda and Java 1.8, you'll need to
+# have both 1.7 and 1.8 installed.
+# java_paths = {
+#     '1.7': "/usr/lib/jvm/java-7-openjdk",
+#     '1.8': None,
 # }
 
 # Build tools version to be used
-build_tools = "22.0.1"
+# build_tools = "23.0.2"
 
 # Command or path to binary for running Ant
-ant = "ant"
+ant = "ant"
 
 # Command or path to binary for running maven 3
-mvn3 = "mvn"
+mvn3 = "mvn"
 
 # Command or path to binary for running Gradle
-gradle = "gradle"
+gradle = "gradle"
 
 # Set the maximum age (in days) of an index that a client should accept from
 # this repo. Setting it to 0 or not setting it at all disables this
 # functionality. If you do set this to a non-zero value, you need to ensure
 # that your index is updated much more frequently than the specified interval.
 # The same policy is applied to the archive repo, if there is one.
-repo_maxage = 0
+repo_maxage = 0
 
 repo_url = "https://MyFirstFDroidRepo.org/fdroid/repo"
 repo_name = "My First F-Droid Repo Demo"
@@ -57,18 +65,18 @@ The repository of older versions of applications from the main demo repository.
 """
 
 # Normally, all apps are collected into a single app repository, like on
-# https://f-droid.org.  For certain situations, it is better to make a repo
-# that is made up of APKs only from a single app.  For example, an automated
+# https://f-droid.org. For certain situations, it is better to make a repo
+# that is made up of APKs only from a single app. For example, an automated
 # build server that publishes nightly builds.
 # per_app_repos = True
 
 # `fdroid update` will create a link to the current version of a given app.
-# This provides a static path to the current APK.  To disable the creation of
+# This provides a static path to the current APK. To disable the creation of
 # this link, uncomment this:
 # make_current_version_link = False
 
 # By default, the "current version" link will be based on the "Name" of the
-# app from the metadata.  You can change it to use a different field from the
+# app from the metadata. You can change it to use a different field from the
 # metadata here:
 # current_version_name_source = 'id'
 
@@ -79,8 +87,8 @@ The repository of older versions of applications from the main demo repository.
 # gpgkey = '1DBA2E89'
 
 # The key (from the keystore defined below) to be used for signing the
-# repository itself.  This is the same name you would give to keytool or
-# jarsigner using -alias.  (Not needed in an unsigned repository).
+# repository itself. This is the same name you would give to keytool or
+# jarsigner using -alias. (Not needed in an unsigned repository).
 # repo_keyalias = "fdroidrepo"
 
 # Optionally, the public key for the key defined by repo_keyalias above can
@@ -94,7 +102,7 @@ The repository of older versions of applications from the main demo repository.
 # somewhere safe and secure, and backed up!  The best way to manage these
 # sensitive keys is to use a "smartcard" (aka Hardware Security Module). To
 # configure F-Droid to use a smartcard, set the keystore file using the keyword
-# "NONE" (i.e. keystore = "NONE").  That makes Java find the keystore on the
+# "NONE" (i.e. keystore = "NONE"). That makes Java find the keystore on the
 # smartcard based on 'smartcardoptions' below.
 # keystore = "~/.local/share/fdroidserver/keystore.jks"
 
@@ -104,34 +112,34 @@ The repository of older versions of applications from the main demo repository.
 #    -providerClass sun.security.pkcs11.SunPKCS11 \
 #    -providerArg opensc-fdroid.cfg"
 
-# The password for the keystore (at least 6 characters).  If this password is
+# The password for the keystore (at least 6 characters). If this password is
 # different than the keypass below, it can be OK to store the password in this
-# file for real use.  But in general, sensitive passwords should not be stored
+# file for real use. But in general, sensitive passwords should not be stored
 # in text files!
 # keystorepass = "password1"
 
 # The password for keys - the same is used for each auto-generated key as well
-# as for the repository key.  You should not normally store this password in a
+# as for the repository key. You should not normally store this password in a
 # file since it is a sensitive password.
 # keypass = "password2"
 
 # The distinguished name used for all keys.
-keydname = "CN=Birdman, OU=Cell, O=Alcatraz, L=Alcatraz, S=California, C=US"
+keydname = "CN=Birdman, OU=Cell, O=Alcatraz, L=Alcatraz, S=California, C=US"
 
 # Use this to override the auto-generated key aliases with specific ones
 # for particular applications. Normally, just leave it empty.
-keyaliases = {}
-keyaliases['com.example.app'] = 'example'
+keyaliases = {}
+keyaliases['com.example.app'] = 'example'
 # You can also force an app to use the same key alias as another one, using
 # the @ prefix.
-keyaliases['com.example.another.plugin'] = '@com.example.another'
+keyaliases['com.example.another.plugin'] = '@com.example.another'
 
 
-# The full path to the root of the repository.  It must be specified in
+# The full path to the root of the repository. It must be specified in
 # rsync/ssh format for a remote host/path. This is used for syncing a locally
-# generated repo to the server that is it hosted on.  It must end in the
+# generated repo to the server that is it hosted on. It must end in the
 # standard public repo name of "/fdroid", but can be in up to three levels of
-# sub-directories (i.e. /var/www/packagerepos/fdroid).  You can include
+# sub-directories (i.e. /var/www/packagerepos/fdroid). You can include
 # multiple servers to sync to by wrapping the whole thing in {} or [], and
 # including the serverwebroot strings in a comma-separated list.
 #
@@ -149,9 +157,9 @@ keyaliases['com.example.another.plugin'] = '@com.example.another'
 
 # If you are running the repo signing process on a completely offline machine,
 # which provides the best security, then you can specify a folder to sync the
-# repo to when running `fdroid server update`.  This is most likely going to
-# be a USB thumb drive, SD Card, or some other kind of removable media.  Make
-# sure it is mounted before running `fdroid server update`.  Using the
+# repo to when running `fdroid server update`. This is most likely going to
+# be a USB thumb drive, SD Card, or some other kind of removable media. Make
+# sure it is mounted before running `fdroid server update`. Using the
 # standard folder called 'fdroid' as the specified folder is recommended, like
 # with serverwebroot.
 #
@@ -160,7 +168,7 @@ keyaliases['com.example.another.plugin'] = '@com.example.another'
 
 # If you are using local_copy_dir on an offline build/signing server, once the
 # thumb drive has been plugged into the online machine, it will need to be
-# synced to the copy on the online machine.  To make that happen
+# synced to the copy on the online machine. To make that happen
 # automatically, set sync_from_local_copy_dir to True:
 #
 # sync_from_local_copy_dir = True
@@ -182,45 +190,45 @@ keyaliases['com.example.another.plugin'] = '@com.example.another'
 # nonstandardwebroot = False
 
 
-# Wiki details
-wiki_protocol = "http"
-wiki_server = "server"
-wiki_path = "/wiki/"
-wiki_user = "login"
-wiki_password = "1234"
+# The build logs can be posted to a mediawiki instance, like on f-droid.org.
+wiki_protocol = "http"
+wiki_server = "server"
+wiki_path = "/wiki/"
+wiki_user = "login"
+wiki_password = "1234"
 
 # Only set this to true when running a repository where you want to generate
 # stats, and only then on the master build servers, not a development
 # machine.
-update_stats = False
+# update_stats = True
 
 # When used with stats, this is a list of IP addresses that are ignored for
 # calculation purposes.
-stats_ignore = []
+stats_ignore = []
 
 # Server stats logs are retrieved from. Required when update_stats is True.
-stats_server = "example.com"
+stats_server = "example.com"
 
 # User stats logs are retrieved from. Required when update_stats is True.
-stats_user = "bob"
+stats_user = "bob"
 
 # Use the following to push stats to a Carbon instance:
-stats_to_carbon = False
-carbon_host = '0.0.0.0'
-carbon_port = 2003
+stats_to_carbon = False
+carbon_host = '0.0.0.0'
+carbon_port = 2003
 
 # Set this to true to always use a build server. This saves specifying the
 # --server option on dedicated secure build server hosts.
-build_server_always = False
+# build_server_always = True
 
-# By default, fdroid will use YAML and the custom .txt metadata formats.  It
-# is also possible to have metadata in JSON and XML. You can enable your
-# preferred formats by setting them in a list:
-# accepted_formats = ['json', 'txt', 'xml', 'yaml']
+# By default, fdroid will use YAML and the custom .txt metadata formats. It
+# is also possible to have metadata in JSON and XML by adding 'json' and
+# 'xml'.
+# accepted_formats = ['txt', 'yaml']
 
 # Limit in number of characters that fields can take up
 # Only the fields listed here are supported, defaults shown
-char_limits = {
-    'Summary': 50,
-    'Description': 1500,
-}
+char_limits = {
+#     'Summary': 80,
+#     'Description': 4000,
+}