module overhaul

module

example/shell.nix

@@ -1,11 +1,41 @@
 let
-  pkgs = import <nixpkgs> {};
-  ides = import (fetchGit {
+  pkgs = import <nixpkgs> { };
+
+  ides = fetchGit {
     url = "https://git.atagen.co/atagen/ides";
-  });
-  mkShell = ides.use pkgs;
+  };
+
+  # create an instance of ides to spawn shells from
+  mkIdes = import ides {
+    # all args here are optional
+
+    # define the pkgs instance to work with
+    inherit pkgs;
+
+    # shell function to wrap -
+    # could also use pkgs.mkShellNoCC, but override demonstrates
+    # more clearly how to change any aspect of the shell
+    shell = pkgs.mkShell.override {
+      stdenv = pkgs.stdenvNoCC;
+    };
+
+    # input for extra modules that provide service options
+    # see modules/redis.nix in ides source for example
+    modules = [ ];
+    # if you want to include a premade service def,
+    # use `imports` in the shell instead
+  };
 in
-  mkShell {
-    noCC = true;
-    services.caddy = import ./caddy.nix;
-  }
+mkIdes {
+  # import a concrete service definition
+  imports = [ ./caddy.nix ];
+  # use the options provided by a module
+  services.redis = {
+    enable = true;
+    port = 6889;
+    logLevel = "verbose";
+  };
+  # use normal mkShell options
+  nativeBuildInputs = [ pkgs.hello ];
+  someEnv = "this";
+}