Add ScottishWater WaterCompany class

[Copilot]

Scottish Water recently released a public near-real-time EDM API. This PR adds a ScottishWater subclass of WaterCompany to match the existing pattern for all other supported companies.

Key differences from existing companies

• Different API format: Scottish Water's endpoint (GET /overflow-event-monitoring/v1/near-real-time) returns {"results": [...]} rather than the ArcGIS features[].attributes structure, so _fetch_current_status_df is overridden entirely.
• OSGB coordinates provided directly: No lat/long conversion needed — the API supplies DISCHARGE_OVERFLOW_LOCATION_X/Y in OSGB36 already.
• ISO 8601 UTC timestamps: A _parse_datetime helper strips tzinfo for consistency with how other companies handle naive datetimes.
• 4-state status mapping:
  • 13 → Discharge (currently overflowing)
  • 14 → NoDischarge + discharge_in_last_48h=True (recent overflow)
  • 15 → NoDischarge (no overflow; checks OVERFLOW_END_DATETIME for 48h window)
  • 16 → Offline (no data)
• No historical API: _fetch_monitor_history / set_all_histories are stubs, matching companies like AnglianWater and NorthumbrianWater.
• D8 file pending: D8_FILE_URL and D8_FILE_HASH are set to "PLACEHOLDER" — update once the Scotland D8 file is uploaded to Zenodo. The corresponding test's check_watercompany() call is commented out until then.

Usage

from poopy.companies import ScottishWater

sw = ScottishWater()
print(sw.discharging_monitors)
print(sw.recently_discharging_monitors)

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• api.scottishwater.co.uk
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)
• zenodo.org
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)
  • Triggering command: /usr/bin/curl curl -s REDACTED (dns block)
  • Triggering command: /usr/bin/curl curl -s --max-time 10 REDACTED (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.