Initialize development environment and testing configuration with Nix; add flake.lock and flake.nix for dependency management; update Makefile for pip installation options.

Author: terryyin

.cursorrules

@@ -0,0 +1,25 @@
+## Development Environment
+
+### Getting Started
+
+**Important:** Run `nix develop` in every new terminal session to activate the development environment with all required dependencies and correct Python paths.
+
+## Testing
+
+### How to Run Tests
+
+**For humans:**
+- Run tests using pytest: `pytest` or `make test`
+- The test configuration is in `pytest.ini`
+- Tests are located in the `tests/` directory
+
+**For AI assistants:**
+- Use `nix develop -c pytest` to run tests in the Nix development environment
+- Use `nix develop -c make test` to run tests via Makefile
+- This ensures tests run in the correct environment with all dependencies
+
+### Test Configuration
+- Test paths: `tests/`
+- Coverage reporting: enabled with `--cov=translate`
+- Verbose output: `-vv` flag enabled by default
+

Makefile

@@ -18,12 +18,12 @@ lint:
 	pre-commit run -av
 
 pip-install:
-	pip install --user -r requirements-dev.txt
+	pip install --user --break-system-packages -r requirements-dev.txt
 pip-install-build:
-	pip install --user -r requirements-build.txt
+	pip install --user --break-system-packages -r requirements-build.txt
 
 pip-upgrade:
-	pip install --user --upgrade -r requirements-dev.txt
+	pip install --user --upgrade --break-system-packages -r requirements-dev.txt
 
 cov:
 	coverage report -m

flake.lock

@@ -0,0 +1,52 @@
+{
+  description = "Python translate CLI development environment";
+
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
+    flake-utils.url = "github:numtide/flake-utils";
+  };
+
+  outputs = { self, nixpkgs, flake-utils }:
+    flake-utils.lib.eachDefaultSystem (system:
+      let
+        pkgs = import nixpkgs {
+          inherit system;
+        };
+        python = pkgs.python3;
+        pythonPackages = pkgs.python3Packages;
+      in
+      {
+        devShells.default = pkgs.mkShell {
+          name = "translate-python";
+          
+          MYSQL_HOME = builtins.getEnv "MYSQL_HOME";
+          MYSQL_DATADIR = builtins.getEnv "MYSQL_DATADIR";
+          
+          buildInputs = with pkgs; [
+            python
+            pythonPackages.pip
+            pythonPackages.setuptools
+            pythonPackages.wheel
+            vim
+            git
+          ];
+          
+          shellHook = ''
+            export PYTHONUSERBASE=$PWD/.local
+            export USER_SITE=$(python -c "import site; print(site.USER_SITE)")
+            
+            # Fix Python version in USER_SITE path if needed
+            export USER_SITE=${"\$\{USER_SITE//3.8/3.9}"}
+            
+            export PYTHONPATH=$PYTHONPATH:$USER_SITE
+            export PATH=$PATH:$PYTHONUSERBASE/bin
+            
+            echo "Development environment ready!"
+            echo "Install dependencies with: pip install --user -r requirements-dev.txt"
+            echo "Run tests with: pytest"
+          '';
+        };
+      }
+    );
+}
+