2
0
Fork 0
wuttjamaican/docs/glossary.rst

78 lines
2.6 KiB
ReStructuredText
Raw Permalink Normal View History

.. _glossary:
Glossary
========
.. glossary::
:sorted:
app
Depending on context, may refer to the software application
overall, or the :term:`app handler`.
app database
The main database used by the :term:`app`. There is normally
just one database (for simple apps) which uses PostgreSQL for the
backend.
2023-11-22 00:01:46 -06:00
app dir
Folder containing app-specific config files, log files, etc.
Usually this is named ``app`` and is located at the root of the
virtual environment.
app handler
Python object representing the core of the :term:`app`. There is
normally just one "global" app handler, which is an instance of
:class:`~wuttjamaican.app.AppHandler`.
app name
The code-friendly name for the :term:`app`
(e.g. ``wutta_poser``). This is available on the :term:`config
object` within Python as
:attr:`~wuttjamaican.conf.WuttaConfig.appname`.
See also the human-friendly :term:`app title`.
app title
The human-friendly name for the :term:`app` (e.g. "Wutta Poser").
See also the code-friendly :term:`app name`.
command
A top-level command line interface for the app. Note that
top-level commands don't really "do" anything per se, and are
mostly a way to group :term:`subcommands<subcommand>`. See also
:class:`~wuttjamaican.commands.base.Command`.
config
Depending on context, may refer to any of: :term:`config file`,
:term:`config object`, :term:`config setting`. See also
:doc:`narr/config/index`.
config file
A file which contains :term:`config settings<config setting>`.
See also :doc:`narr/config/files`.
config object
Python object representing the full set of :term:`config
settings<config setting>` for the :term:`app`. Usually it gets
some of the settings from :term:`config files<config file>`, but
it may also get some from the :term:`settings table`. See also
:doc:`narr/config/object`.
config setting
The value of a setting as obtained from a :term:`config object`.
Depending on context, sometimes this refers specifically to
values obtained from the :term:`settings table` as opposed to
:term:`config file`. See also :doc:`narr/config/settings`.
settings table
Table in the :term:`app database` which is used to store
:term:`config settings<config setting>`.
subcommand
A top-level :term:`command` may expose one or more subcommands,
for the overall command line interface. Subcommands are the real
workhorse; each can perform a different function. See also
:class:`~wuttjamaican.commands.base.Subcommand`.