Skip to content

home / reference / troubleshooting / developer

Developer Troubleshooting

Common issues developers encounter when contributing to Tux and their solutions.

Development Setup Issues

Environment Setup

  • Check Python version - Ensure Python 3.11+ is installed
  • Check virtual environment - Verify you're using the correct virtual environment
  • Check dependencies - Ensure all development dependencies are installed

Database Issues

  • Check database connection - Verify PostgreSQL is running and accessible
  • Check migrations - Ensure database migrations are up to date
  • Check test database - Verify test database is properly configured

Code Issues

Import Errors

  • Check Python path - Ensure the project root is in your Python path
  • Check virtual environment - Verify you're using the correct virtual environment
  • Check dependencies - Ensure all required packages are installed

Type Checking Issues

  • Check type annotations - Verify all functions have proper type hints
  • Check mypy configuration - Ensure mypy is properly configured
  • Check type stubs - Verify type stubs are available for external libraries

Testing Issues

Test Failures

  • Check test database - Verify test database is properly configured
  • Check test data - Ensure test fixtures are properly loaded
  • Check test environment - Verify test environment variables are set

Coverage Issues

  • Check coverage configuration - Ensure coverage is properly configured
  • Check test execution - Verify all tests are running
  • Check coverage thresholds - Ensure coverage meets project requirements

Getting Help

If you can't resolve your issue: 1. Check the FAQ for common solutions 2. Join our Discord server for community support 3. File an issue on GitHub for bugs