Implement network update API for enabled, ipv4 and ipv6

[lmagyar]

Proposed Changes

Based on https://developers.home-assistant.io/docs/api/supervisor/endpoints/#network

Changing enabled option is trivial.

New IPv4 and IPv6 functions use JSON for input/output: I've experimented with it, and even the docs says that all the fields are optional, in reality we have to specify eg. address, nameservers and gateway together. So it makes sense to get them in a JSON struct (not only with the current individual get functions), and setting them with JSON is way more simple then coding one-by-one, and AFAIK this is the standard around this library.

Wifi had no individual getter methods, so I didn't created a JSON get/set function for Wifi.

Related Issues

Summary by CodeRabbit

• New Features
  • Network interface status can now be configured programmatically
  • Added support for configuring IPv4 settings per network interface
  • Added support for configuring IPv6 settings per network interface

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

The changes enhance network configuration capabilities by adding a setter mode to the existing enabled function and introducing two new functions for managing IPv4 and IPv6 settings per network interface, all following established API update and cache-flushing patterns.

Changes

Cohort / File(s)	Summary
Network Interface Configuration lib/network.sh	Enhanced bashio::network.enabled() with optional setter parameter to validate and post state updates to Supervisor API. Added bashio::network.ipv4() and bashio::network.ipv6() functions for reading/writing IPv4 and IPv6 configuration per interface via Supervisor API with cache invalidation.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Poem

🐰 A fluffy hop through networks bright,
IPv4 and IPv6 set just right,
Enabled states now dance and play,
Configuration flows the bashio way! ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'Implement network update API for enabled, ipv4 and ipv6' directly and accurately summarizes the main changes, which add setter capability to the enabled function and introduce two new functions (ipv4 and ipv6) for managing network interface settings via the Supervisor API.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

There hasn't been any activity on this pull request recently. This pull request has been automatically marked as stale because of that and will be closed if no further activity occurs within 7 days. Thank you for your contributions.

[lmagyar]

not stale

[github-actions]

There hasn't been any activity on this pull request recently. This pull request has been automatically marked as stale because of that and will be closed if no further activity occurs within 7 days. Thank you for your contributions.

[lmagyar]

not stale

[Copilot]

Pull request overview

Adds support in Bashio’s network helpers to update interface configuration (enabled state plus IPv4/IPv6 settings) via the Home Assistant Supervisor network update endpoint.

Changes:

• Extend bashio::network.enabled to optionally set the enabled state via /network/interface/<iface>/update.
• Add bashio::network.ipv4 getter/setter that reads .ipv4 and updates IPv4 settings using a JSON payload.
• Add bashio::network.ipv6 getter/setter that reads .ipv6 and updates IPv6 settings using a JSON payload.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[frenck]

Thanks, @lmagyar 👍
../Frenck

                       

Blogging my personal ramblings at frenck.dev