Organizing settings for Python 3

Author: thomasjm

modules/kernels/python/default.nix

@@ -13,7 +13,8 @@
 , settingsSchema
 }:
 
-with { inherit (settings) packages attrs extensions; };
+with { inherit (settings) packages; };
+with { inherit (settings.interface) attrs extensions; };
 
 let
   common = callPackage ../common.nix {};
@@ -56,7 +57,7 @@ symlinkJoin {
     (callPackage ./kernel.nix {
       python = pythonToUse;
       inherit displayName kernelName attrs extensions;
-      enableVariableInspector = settings.enableVariableInspector;
+      enableVariableInspector = settings.misc.enableVariableInspector;
     })
 
     pythonToUse

modules/kernels/python/module.nix

@@ -19,12 +19,15 @@ let
 
     python3Package = packageOption;
 
-    attrs = mkOption {
+    interface.attrs = mkOption {
+      example = "Notebook attributes";
+      description = "Notebook cells that have these attributes will match this kernel, allowing it to run the code.";
       type = types.listOf types.str;
       default = ["python"];
     };
-
-    extensions = mkOption {
+    interface.extensions = mkOption {
+      example = "File extensions";
+      description = "Files with these extensions will match against this kernel, allowing you to run the code as if it were a Jupyter cell.";
       type = types.listOf types.str;
       default = ["py"];
     };
@@ -70,14 +73,15 @@ let
       default = false;
     };
 
-    permitUserSite = mkOption {
+    misc.permitUserSite = mkOption {
       example = "Permit user site-packages";
       description = "Skip setting the PYTHONNOUSERSITE variable. This will allow your Python code to import local packages (e.g. from ~/.local/lib). This is useful if you want to use pip to install Python packages independently of Nix.";
       type = types.bool;
       default = false;
     };
-    enableVariableInspector = mkOption {
-      description = "Enable the variable inspector";
+    misc.enableVariableInspector = mkOption {
+      example = "Enable the variable inspector";
+      description = "This will show a summary of the currently defined variables in the UI.";
       type = types.bool;
       default = true;
     };

sample_environments/mega.nix

@@ -41,16 +41,16 @@ codedown.makeEnvironment {
 
   kernels.python3.enable = true;
   kernels.python3.packages = ["matplotlib" "scipy" "rope"];
-  kernels.python3.permitUserSite = false;
   kernels.python3.lsp.jedi.enable = true;
   kernels.python3.lsp.pyright.enable = true;
   kernels.python3.lsp.pylint.enable = true;
   kernels.python3.lsp.flake8.enable = true;
   kernels.python3.lsp.pycodestyle.enable = true;
   kernels.python3.lsp.python-lsp-server.enable = true;
+  kernels.python3.misc.permitUserSite = false;
 
   # kernels.pypy3.enable = true;
-  # kernels.pypy3.permitUserSite = false;
+  # kernels.pypy3.misc.permitUserSite = false;
 
   kernels.ruby.enable = true;
 

sample_environments/python3.nix

@@ -11,8 +11,6 @@ codedown.makeEnvironment {
     "rope"
   ];
 
-  kernels.python3.permitUserSite = false;
-
   kernels.python3.lsp = {
     jedi.enable = true;
     pyright.enable = true;
@@ -21,4 +19,6 @@ codedown.makeEnvironment {
     pycodestyle.enable = true;
     python-lsp-server.enable = true;
   };
+
+  kernels.python3.misc.permitUserSite = false;
 }