Config

Fontlib can be configured with a configuration file (see basic config and logging setup) and/or with command line arguments (see fontlib options). If nothing is given, the application defaults and logging defaults come to the effect.

basic config and logging setup

To install templates for indiviual configuration use the config install command:

$ fontlib config install ~/.fontlib
using workspace: ~/.fontlib
set log level of logger: fontlib (WARNING)
log goes to:
 - <StreamHandler <stderr> (DEBUG)>
install:  ~/.fontlib/config.ini
install:  ~/.fontlib/log.ini

This will setup a workspace folder .fontlib in your home folder where templates for application defaults and logging defaults are copied in. To activate the configuration in .fontlib/log.ini just un-comment the config line:

[logging]
...
config = %(workspace)s/log.ini

inspect configuration

With command fontlib config show you can inspect current configuration options. To show your current configuration use fontlib config show. With switch --verbose you will get some more information.:

$ fontlib --verbose config show
using workspace: ~/.fontlib
set log level of logger: fontlib (WARNING)
log goes to:
- <StreamHandler <stderr> (DEBUG)>

config.ini
==========

[DEFAULT]
workspace = ~/.fontlib

[fontstack]
builtin fonts = cantarell, dejavu
entry points = fonts_ttf, fonts_otf, fonts_woff, fonts_woff2
cache = fontlib.urlcache.SimpleURLCache
...

log.ini
=======

[loggers]
keys = root, fontlib
...

application defaults

The default application configuration is taken from the git://fontlib/config.ini file:

# -*- coding: utf-8; mode: ini -*-

[DEFAULT]

workspace = ~/.fontlib

# persistence of fontlib's applications
# https://docs.sqlalchemy.org/engines.html#database-urls
fontlib_db = sqlite:////%(workspace)s/fontlib.db
# fontlib_db = sqlite:///:memory:

[fontstack]

# Fonts loaded from builtins.
builtin fonts = cantarell, dejavu

# Fonts loaded from entry points.
entry points = fonts_ttf, fonts_otf, fonts_woff, fonts_woff2

# Full qualified name of the URL-cache implementation.  Subclass of
# fontlib.urlcache.URLCache.  e.g.: fontlib.urlcache.SimpleURLCache
# or fontlib.urlcache.NoCache
cache = fontlib.urlcache.SimpleURLCache

[google fonts]

# Select font families from https://fonts.google.com/
family base url = https://fonts.googleapis.com/css?family=

# https://github.com/googlefonts/robotoslab
# https://github.com/googlefonts/staatliches
# https://github.com/graphicore/librebarcode
fonts = Roboto Slab, Staatliches, Libre Barcode 39 Extended Text, Leckerli One

[logging]

# Threshold for the logger
# Value: debug | info | warning | error | critical
level = warning

# activate this line to use the logger configuration from your workspace
# config = %(workspace)s/log.ini

logging defaults

Fontlib uses the standard py-logging facility. The default logging configuration is taken from the git://fontlib/log.ini file (shown below). For details options see py-logging INI format.

# -*- coding: utf-8; mode: ini -*-
#
# fontlib logging configuration
#
# https://docs.python.org/3/library/logging.config.html#configuration-file-format
#

[loggers]
keys = root, fontlib, sqlalchemy_engine

[logger_root]
level = NOTSET
handlers = null

[logger_fontlib]
level = WARNING
#handlers = console, logfile
handlers = console
# The qualname entry is the hierarchical channel name of the logger, that is to
# say the name used by the application to get the logger.
qualname = fontlib
propagate = 1

[logger_sqlalchemy_engine]
level = WARNING
#handlers = console, logfile
handlers = console
qualname = sqlalchemy.engine
propagate = 1

[handlers]
keys = null, console, logfile

[handler_null]
class = NullHandler
level = NOTSET
args = ()

[handler_console]
class = StreamHandler
level = DEBUG
formatter = console
# https://docs.python.org/3.7/library/logging.handlers.html#logging.StreamHandler
args = (sys.stderr, )

[handler_logfile]
class = handlers.RotatingFileHandler
level = DEBUG
formatter = logfile
# https://docs.python.org/3.7/library/logging.handlers.html#logging.handlers.RotatingFileHandler
args = ('%(WORKSPACE)s/%(APP)s.log', )
kwargs = {'maxBytes' : 1024 * 1024, 'backupCount' : 10 }

[formatters]
keys = console, logfile

[formatter_console]
format = ~~ LOG.%(levelname)s [%(name)-12s] %(message)s

[formatter_logfile]
format = %(asctime)s| %(levelname)-8s|%(name)-12s| %(message)s

Source Code Remarks

Implementation of application’s configuration class Config.