py project init

This commit is contained in:
chrisbell committed 2026-11-20 16:18:06 -06:00
1 parent 3030627214
commit 65f63b05d3
26 files changed
+139 -1225

No files matched your search

+133 -29
View File
@@ -1,39 +1,117 @@
{
description = "Simple vanilla web dev shell: VSCodium + HTML/JS extensions + Python http.server";
description = "Alabama Progress dev shell: Python static site builder + Discord bot + VSCodium";
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";
};
outputs = { self, nixpkgs }:
outputs =
{ self, nixpkgs }:
let
systems = [ "x86_64-linux" "aarch64-linux" "x86_64-darwin" "aarch64-darwin" ];
systems = [
"x86_64-linux"
"aarch64-linux"
"x86_64-darwin"
"aarch64-darwin"
];
forAllSystems = f: nixpkgs.lib.genAttrs systems (system: f nixpkgs.legacyPackages.${system});
in
{
devShells = forAllSystems (pkgs:
devShells = forAllSystems (
pkgs:
let
lib = pkgs.lib;
# Python with everything the builder and the bot will need.
# Declared here so the dev shell and (later) the server module can share it.
python = pkgs.python3.withPackages (
ps: with ps; [
jinja2 # templates
mistune # Markdown -> HTML for news posts
python-frontmatter # parse front matter in .md files
pyyaml # config / front matter
nh3 # HTML sanitizer for rendered post bodies
pillow # resize/convert uploaded images to WebP
python-slugify # safe slugs from titles
discordpy # the bot
watchfiles # rebuild on change during development
pytest # tests for the builder / slugging / validation
]
);
# Extensions as attribute paths under pkgs.vscode-extensions.
# Any that don't exist in your nixpkgs revision are silently skipped
# instead of breaking the whole shell.
wanted = [
[ "esbenp" "prettier-vscode" ] # formatter
[ "dbaeumer" "vscode-eslint" ] # JS linting
[ "ritwickdey" "liveserver" ] # live reload server
[ "formulahendry" "auto-rename-tag" ] # rename paired HTML tags
[ "formulahendry" "auto-close-tag" ] # auto-close HTML tags
[ "christian-kohler" "path-intellisense" ] # file path autocomplete
[ "usernamehw" "errorlens" ] # inline error messages
[ "editorconfig" "editorconfig" ] # .editorconfig support
[ "bradlc" "vscode-tailwindcss" ] # harmless if unused
[ "ms-python" "python" ] # Python support
[ "continue" "continue" ] # local line-completion
[
"esbenp"
"prettier-vscode"
] # formatter (HTML/CSS/JS/MD)
[
"dbaeumer"
"vscode-eslint"
] # JS linting (join form, etc.)
[
"ritwickdey"
"liveserver"
] # live reload for public/
[
"formulahendry"
"auto-rename-tag"
] # rename paired HTML tags
[
"formulahendry"
"auto-close-tag"
] # auto-close HTML tags
[
"christian-kohler"
"path-intellisense"
] # file path autocomplete
[
"usernamehw"
"errorlens"
] # inline error messages
[
"editorconfig"
"editorconfig"
] # .editorconfig support
[
"ms-python"
"python"
] # Python support
[
"charliermarsh"
"ruff"
] # Python lint + format
[
"samuelcolvin"
"jinjahtml"
] # Jinja2 syntax highlighting
[
"jnoortheen"
"nix-ide"
] # Nix syntax/LSP
[
"mkhl"
"direnv"
] # auto-load the flake env (if you use direnv)
[
"redhat"
"vscode-yaml"
] # YAML (front matter, configs)
[
"yzhang"
"markdown-all-in-one"
] # Markdown preview/shortcuts for posts
[
"continue"
"continue"
] # local line-completion
];
extensions = lib.filter (e: e != null)
(map (path: lib.attrByPath path null pkgs.vscode-extensions) wanted);
extensions = lib.filter (e: e != null) (
map (path: lib.attrByPath path null pkgs.vscode-extensions) wanted
);
codium = pkgs.vscode-with-extensions.override {
vscode = pkgs.vscodium;
@@ -42,27 +120,53 @@
in
{
default = pkgs.mkShell {
name = "web-dev";
name = "alabama-progress";
packages = [
codium
pkgs.python3 # `python -m http.server` for static serving
pkgs.nodejs # optional: npm, eslint, prettier CLIs, etc.
python
pkgs.ruff # CLI for lint/format
pkgs.djlint # lint/format Jinja + HTML templates
pkgs.lychee # link checker: catches broken links in public/ (good for SEO)
pkgs.prettier
pkgs.git
pkgs.nixpkgs-fmt
];
shellHook = ''
# Serve current directory: `serve` or `serve 3000`
serve() {
local port="''${1:-8000}"
echo "Serving $(pwd) at http://localhost:$port"
python3 -m http.server "$port"
# Build the site (expects build.py in the current directory)
build() {
python build.py "$@"
}
echo "Web dev shell ready."
echo " codium . - open the editor in this directory"
echo " serve [p] - start a static server (default port 8000)"
# Build, then serve public/ at http://localhost:8000 (or `serve 3000`)
serve() {
local port="''${1:-8000}"
python build.py || return 1
echo "Serving public/ at http://localhost:$port"
python -m http.server "$port" --directory public
}
# Rebuild automatically whenever templates, pages, static files, or posts change.
# Run `serve` in one terminal and `watch` in another.
watch() {
watchfiles "python build.py" templates pages static ../content
}
# Check public/ for broken internal links
linkcheck() {
lychee --offline --no-progress public
}
echo "Alabama Progress dev shell ready."
echo " codium . - open the editor in this directory"
echo " build - generate public/"
echo " serve [p] - build, then serve public/ (default port 8000)"
echo " watch - rebuild on file changes"
echo " linkcheck - scan public/ for broken links"
'';
};
});
}
);
};
}