Resources

Troubleshooting

Common errors and environmental hurdles with solutions

Pytest permissions and temp lockouts on Windows

Symptom: Running pytest fails instantly with permission errors when creating temp folders.

Solution: The system default temp paths may have access restrictions. Override standard temp paths by pointing environment variables directly to a folder inside the workspace before invoking the test suite:

bash

1$ nv:TMP=".pytest_tmp"
2$ nv:TEMP=".pytest_tmp"
3uv run pytest

Import Linter constraints violation

Symptom: Running lint-imports triggers a contract failure: Import of internal core module is not allowed from surface wrappers.

Solution: Ensure your custom CLI or dashboard modifications only import from featuresmith.api. Importing from internal submodules (like featuresmith.rules.engine or featuresmith.connectors.csv_connector) is forbidden.