new: Add vpc field to Instance(...).ips property method result - #379

📝 Description

This change adds support for the vpc structure in the Instance(...).ips (networking information list) property method. Entries in this struct are stored as objects of the new VPCIPAddress class, which is necessary to expose certain VPC-specific fields and to prevent attempted refreshes on VPC IP addresses.

✔️ How to Test

The following test steps assume you have pulled down this PR locally and run make install.

Unit Testing

make testunit

Integration Testing

make testint

Manual Testing

1. In a linode_api4 sandbox environment (e.g. dx-devenv), run the following:

import os

from linode_api4 import LinodeClient
from linode_api4.objects import ConfigInterface

client = LinodeClient(os.getenv("LINODE_TOKEN"))

vpc = client.vpcs.create(
    "test-vpc",
    "us-mia",
)

subnet = vpc.subnet_create(
    "test-subnet",
    ipv4="10.0.0.0/24"
)

inst, _ = client.linode.instance_create(
    "g6-nanode-1",
    "us-mia",
    label="test-instance",
    image="linode/alpine3.19",
    interfaces=[
        ConfigInterface(
            purpose="vpc",
            subnet_id=subnet.id,
        )
    ]
)

print(inst.ips.ipv4.vpc)

2. Ensure the output looks similar to the following:

[VPCIPAddress(address='10.0.0.2', gateway='10.0.0.1', region='us-mia', subnet_mask='255.255.255.0', vpc_id=40874, subnet_id=40952, linode_id=55940621, config_id=59073074, interface_id=1190879, prefix=24, active=False, address_range=None, nat_1_1=None)]