2022-04-24 13:17:38 +02:00
|
|
|
Command line interface
|
|
|
|
|
######################
|
|
|
|
|
|
2022-09-19 18:49:25 +02:00
|
|
|
A command line interface (CLI) is available to manage database, OAuth2 tokens and users.
|
2022-04-24 13:17:38 +02:00
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
|
|
|
|
$ ftcli
|
|
|
|
|
Usage: ftcli [OPTIONS] COMMAND [ARGS]...
|
|
|
|
|
|
|
|
|
|
FitTrackee Command Line Interface
|
|
|
|
|
|
|
|
|
|
Options:
|
|
|
|
|
--help Show this message and exit.
|
|
|
|
|
|
|
|
|
|
Commands:
|
2022-08-27 16:50:29 +02:00
|
|
|
db Manage database.
|
|
|
|
|
oauth2 Manage OAuth2 tokens.
|
|
|
|
|
users Manage users.
|
2022-04-24 13:17:38 +02:00
|
|
|
|
|
|
|
|
.. warning::
|
|
|
|
|
| The following commands are now deprecated and will be removed in a next version:
|
|
|
|
|
| - ``fittrackee_set_admin``
|
|
|
|
|
| - ``fittrackee_upgrade_db``
|
2022-11-27 12:06:42 +01:00
|
|
|
| - ``fittrackee_worker`` (disabled)
|
2022-04-24 13:17:38 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
Database
|
|
|
|
|
~~~~~~~~
|
|
|
|
|
|
|
|
|
|
``ftcli db upgrade``
|
|
|
|
|
""""""""""""""""""""
|
|
|
|
|
.. versionadded:: 0.6.5
|
|
|
|
|
|
|
|
|
|
Apply migrations.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
``ftcli db drop``
|
|
|
|
|
"""""""""""""""""
|
|
|
|
|
.. versionadded:: 0.6.5
|
|
|
|
|
|
|
|
|
|
Empty database and delete uploaded files, only on development environments.
|
|
|
|
|
|
|
|
|
|
|
2022-08-27 16:50:29 +02:00
|
|
|
OAuth2
|
|
|
|
|
~~~~~~
|
|
|
|
|
|
|
|
|
|
``ftcli oauth2 clean``
|
|
|
|
|
""""""""""""""""""""""
|
|
|
|
|
.. versionadded:: 0.7.0
|
|
|
|
|
|
|
|
|
|
Remove tokens expired for more than provided number of days
|
|
|
|
|
|
|
|
|
|
.. cssclass:: table-bordered
|
|
|
|
|
.. list-table::
|
|
|
|
|
:widths: 25 50
|
|
|
|
|
:header-rows: 1
|
|
|
|
|
|
|
|
|
|
* - Options
|
|
|
|
|
- Description
|
|
|
|
|
* - ``--days``
|
|
|
|
|
- Number of days.
|
|
|
|
|
|
|
|
|
|
|
2022-04-24 13:17:38 +02:00
|
|
|
|
|
|
|
|
Users
|
|
|
|
|
~~~~~
|
|
|
|
|
|
2022-09-15 16:11:13 +02:00
|
|
|
``ftcli users clean_tokens``
|
|
|
|
|
""""""""""""""""""""""""""""
|
|
|
|
|
.. versionadded:: 0.7.0
|
|
|
|
|
|
|
|
|
|
Remove blacklisted tokens expired for more than provided number of days.
|
|
|
|
|
|
|
|
|
|
.. cssclass:: table-bordered
|
|
|
|
|
.. list-table::
|
|
|
|
|
:widths: 25 50
|
|
|
|
|
:header-rows: 1
|
|
|
|
|
|
|
|
|
|
* - Options
|
|
|
|
|
- Description
|
|
|
|
|
* - ``--days``
|
|
|
|
|
- Number of days.
|
|
|
|
|
|
|
|
|
|
|
2022-04-24 13:17:38 +02:00
|
|
|
``ftcli users update``
|
|
|
|
|
""""""""""""""""""""""
|
|
|
|
|
.. versionadded:: 0.6.5
|
|
|
|
|
|
|
|
|
|
Modify a user account (admin rights, active status, email and password).
|
|
|
|
|
|
|
|
|
|
.. cssclass:: table-bordered
|
|
|
|
|
.. list-table::
|
|
|
|
|
:widths: 25 50
|
|
|
|
|
:header-rows: 1
|
|
|
|
|
|
|
|
|
|
* - Options
|
|
|
|
|
- Description
|
|
|
|
|
* - ``--set-admin BOOLEAN``
|
|
|
|
|
- Add/remove admin rights (when adding admin rights, it also activates user account if not active).
|
|
|
|
|
* - ``--activate``
|
|
|
|
|
- Activate user account.
|
|
|
|
|
* - ``--reset-password``
|
|
|
|
|
- Reset user password (a new password will be displayed).
|
|
|
|
|
* - ``--update-email EMAIL``
|
|
|
|
|
- Update user email.
|
