diff options
author | pennae <github@quasiparticle.net> | 2022-08-05 19:39:00 +0200 |
---|---|---|
committer | pennae <github@quasiparticle.net> | 2022-08-06 20:39:12 +0200 |
commit | 087472b1e5230ffc8ba642b1e4f9218adf4634a2 (patch) | |
tree | ba5c8e457072dce9aa13a92f26bb7e6a47d45776 /nixos/modules/services/development | |
parent | 423545fe4865d126e86721ba30da116e29c65004 (diff) | |
download | nixlib-087472b1e5230ffc8ba642b1e4f9218adf4634a2.tar nixlib-087472b1e5230ffc8ba642b1e4f9218adf4634a2.tar.gz nixlib-087472b1e5230ffc8ba642b1e4f9218adf4634a2.tar.bz2 nixlib-087472b1e5230ffc8ba642b1e4f9218adf4634a2.tar.lz nixlib-087472b1e5230ffc8ba642b1e4f9218adf4634a2.tar.xz nixlib-087472b1e5230ffc8ba642b1e4f9218adf4634a2.tar.zst nixlib-087472b1e5230ffc8ba642b1e4f9218adf4634a2.zip |
nixos/*: automatically convert option docs
Diffstat (limited to 'nixos/modules/services/development')
3 files changed, 24 insertions, 24 deletions
diff --git a/nixos/modules/services/development/jupyter/default.nix b/nixos/modules/services/development/jupyter/default.nix index 7c86e8b64785..b77f5adbd5e9 100644 --- a/nixos/modules/services/development/jupyter/default.nix +++ b/nixos/modules/services/development/jupyter/default.nix @@ -29,7 +29,7 @@ in { ip = mkOption { type = types.str; default = "localhost"; - description = '' + description = lib.mdDoc '' IP address Jupyter will be listening on. ''; }; @@ -41,7 +41,7 @@ in { # saving a rebuild. default = pkgs.python3.pkgs.notebook; defaultText = literalExpression "pkgs.python3.pkgs.notebook"; - description = '' + description = lib.mdDoc '' Jupyter package to use. ''; }; @@ -50,7 +50,7 @@ in { type = types.str; default = "jupyter-notebook"; example = "jupyter-lab"; - description = '' + description = lib.mdDoc '' Which command the service runs. Note that not all jupyter packages have all commands, e.g. jupyter-lab isn't present in the default package. ''; @@ -59,7 +59,7 @@ in { port = mkOption { type = types.int; default = 8888; - description = '' + description = lib.mdDoc '' Port number Jupyter will be listening on. ''; }; @@ -67,7 +67,7 @@ in { notebookDir = mkOption { type = types.str; default = "~/"; - description = '' + description = lib.mdDoc '' Root directory for notebooks. ''; }; @@ -75,7 +75,7 @@ in { user = mkOption { type = types.str; default = "jupyter"; - description = '' + description = lib.mdDoc '' Name of the user used to run the jupyter service. For security reason, jupyter should really not be run as root. If not set (jupyter), the service will create a jupyter user with appropriate settings. @@ -86,7 +86,7 @@ in { group = mkOption { type = types.str; default = "jupyter"; - description = '' + description = lib.mdDoc '' Name of the group used to run the jupyter service. Use this if you want to create a group of users that are able to view the notebook directory's content. ''; @@ -95,7 +95,7 @@ in { password = mkOption { type = types.str; - description = '' + description = lib.mdDoc '' Password to use with notebook. Can be generated using: In [1]: from notebook.auth import passwd @@ -112,7 +112,7 @@ in { notebookConfig = mkOption { type = types.lines; default = ""; - description = '' + description = lib.mdDoc '' Raw jupyter config. ''; }; diff --git a/nixos/modules/services/development/jupyter/kernel-options.nix b/nixos/modules/services/development/jupyter/kernel-options.nix index 0a9eaafa3185..42af47aeb3c8 100644 --- a/nixos/modules/services/development/jupyter/kernel-options.nix +++ b/nixos/modules/services/development/jupyter/kernel-options.nix @@ -13,7 +13,7 @@ with lib; "Python 3" "Python 3 for Data Science" ''; - description = '' + description = lib.mdDoc '' Name that will be shown to the user. ''; }; @@ -27,7 +27,7 @@ with lib; "-f" "{connection_file}" ]; - description = '' + description = lib.mdDoc '' Command and arguments to start the kernel. ''; }; @@ -35,7 +35,7 @@ with lib; language = mkOption { type = types.str; example = "python"; - description = '' + description = lib.mdDoc '' Language of the environment. Typically the name of the binary. ''; }; @@ -44,7 +44,7 @@ with lib; type = types.nullOr types.path; default = null; example = literalExpression ''"''${env.sitePackages}/ipykernel/resources/logo-32x32.png"''; - description = '' + description = lib.mdDoc '' Path to 32x32 logo png. ''; }; @@ -52,7 +52,7 @@ with lib; type = types.nullOr types.path; default = null; example = literalExpression ''"''${env.sitePackages}/ipykernel/resources/logo-64x64.png"''; - description = '' + description = lib.mdDoc '' Path to 64x64 logo png. ''; }; @@ -61,7 +61,7 @@ with lib; type = types.attrsOf types.path; default = { }; example = literalExpression ''"{ examples = ''${env.sitePack}/IRkernel/kernelspec/kernel.js"; }''; - description = '' + description = lib.mdDoc '' Extra paths to link in kernel directory ''; }; diff --git a/nixos/modules/services/development/jupyterhub/default.nix b/nixos/modules/services/development/jupyterhub/default.nix index fa6b3be960ab..bd8a5f0bd258 100644 --- a/nixos/modules/services/development/jupyterhub/default.nix +++ b/nixos/modules/services/development/jupyterhub/default.nix @@ -35,7 +35,7 @@ in { authentication = mkOption { type = types.str; default = "jupyterhub.auth.PAMAuthenticator"; - description = '' + description = lib.mdDoc '' Jupyterhub authentication to use There are many authenticators available including: oauth, pam, @@ -46,7 +46,7 @@ in { spawner = mkOption { type = types.str; default = "systemdspawner.SystemdSpawner"; - description = '' + description = lib.mdDoc '' Jupyterhub spawner to use There are many spawners available including: local process, @@ -57,7 +57,7 @@ in { extraConfig = mkOption { type = types.lines; default = ""; - description = '' + description = lib.mdDoc '' Extra contents appended to the jupyterhub configuration Jupyterhub configuration is a normal python file using @@ -84,7 +84,7 @@ in { jupyterhub-systemdspawner ]) ''; - description = '' + description = lib.mdDoc '' Python environment to run jupyterhub Customizing will affect the packages available in the hub and @@ -106,7 +106,7 @@ in { jupyterlab ]) ''; - description = '' + description = lib.mdDoc '' Python environment to run jupyterlab Customizing will affect the packages available in the @@ -146,7 +146,7 @@ in { }; } ''; - description = '' + description = lib.mdDoc '' Declarative kernel config Kernels can be declared in any language that supports and has @@ -159,7 +159,7 @@ in { port = mkOption { type = types.port; default = 8000; - description = '' + description = lib.mdDoc '' Port number Jupyterhub will be listening on ''; }; @@ -167,7 +167,7 @@ in { host = mkOption { type = types.str; default = "0.0.0.0"; - description = '' + description = lib.mdDoc '' Bind IP JupyterHub will be listening on ''; }; @@ -175,7 +175,7 @@ in { stateDirectory = mkOption { type = types.str; default = "jupyterhub"; - description = '' + description = lib.mdDoc '' Directory for jupyterhub state (token + database) ''; }; |