繁體中文

⚠️ IMPORTANT WARNING

🚫 DO NOT USE FOR PRODUCTION TESTING 🚫

This test suite performs CRUD operations (Create, Read, Update, Delete) that will directly modify database content. Only use in Local and Development environments.

Backend API test suite using Hurl.

api-tests/
├── .env.hurl          # Environment configuration file (create your own)
├── .env.hurl.example  # Environment configuration template
├── .gitignore         # Git ignore settings
├── run_all.sh         # Run all tests
├── run_test.sh        # Run a single test
├── tests/             # Test directory
│   └── test_*.hurl    # Test files for each resource
└── README.md          # This file

# macOS
brew install hurl

# For other platforms: https://hurl.dev/docs/installation.html

Create a .env.hurl file in the project root directory:

# .env.hurl
base_url=http://localhost:8080

⚠️ Note: .env.hurl is included in .gitignore. Do not commit files containing actual environment information to Git.

Double check: Ensure that base_url points to a development or testing environment. Never point to production.

# Run all tests
./run_all.sh

# Run a single test (you can omit the test_ prefix and .hurl extension)
./run_test.sh shelters
./run_test.sh health
./run_test.sh supplies

# Run all tests
hurl --test --variables-file .env.hurl tests/*.hurl

# Run a single test file
hurl --test --variables-file .env.hurl tests/test_health.hurl

• ✅ Each test file is independent and creates its own test data
• ✅ Some tests depend on previously created resource IDs (captured via [Captures])
• ✅ Tests will create actual data in the database
• ⚠️ Make sure to use a test environment to avoid polluting production data
• ⚠️ Always verify the base_url setting in .env.hurl before running tests

• Hurl Official Documentation
• Hurl Examples

🔒 If you need to add sensitive information (such as API keys) to .env.hurl:

1. Ensure .env.hurl is included in .gitignore
2. Never commit configuration files containing sensitive information to version control
3. Create .env.hurl.example as a template for other developers to reference