First commit

tests/README.md

@@ -0,0 +1,36 @@
+# Tests for valid.nsupdate_zone collection
+
+This directory contains tests for the nsupdate_zone module.
+
+## Unit Tests
+
+Unit tests are located in `unit/plugins/modules/` and test individual module functions.
+
+To run unit tests:
+```bash
+ansible-test units --docker
+```
+
+## Integration Tests
+
+Integration tests are located in `integration/targets/` and test actual DNS operations.
+
+**Note**: Integration tests require a running DNS server with AXFR and UPDATE enabled.
+
+To run integration tests:
+```bash
+ansible-test integration --docker
+```
+
+## Manual Testing
+
+For manual testing, see the examples in `docs/`:
+- `docs/nsupdate_zone_example.yml` - Comprehensive example playbook
+- `docs/sample_zone_format.yml` - Sample zone file format
+- `docs/QUICK_START.md` - Quick start guide
+
+## Test Requirements
+
+- DNS server (BIND recommended) with AXFR and UPDATE enabled
+- TSIG key configured
+- Python package: dnspython