all lists on lists.proxmox.com
 help / color / mirror / Atom feed
From: Stefan Hanreich <s.hanreich@proxmox.com>
To: pve-devel@lists.proxmox.com
Subject: Re: [PATCH proxmox-ve-rs 5/9] frr: add template serializer and serialize fabrics using templates
Date: Fri, 27 Feb 2026 12:49:42 +0100	[thread overview]
Message-ID: <f0150078-35aa-4d92-8bb1-5cc081e658db@proxmox.com> (raw)
In-Reply-To: <yac7x5njtjzp2vkn726v54y2kjft6u6mt6hpirzbv6f2okbe74@f4w33nhbhtuq>

On 2/25/26 5:29 PM, Gabriel Goller wrote:
> On 25.02.2026 14:43, Stefan Hanreich wrote:
>> A lot of structs here derive Builder, but we don't use any of the
>> generated builder functionality atm and just instantiate the structs
>> directly in ve-config since all the properties are pub. We should imo
>> settle on one approach, preferably now, and then use that consistently.
>>
>> We use many collection/map types here, and with bon we'd have to write
>> some boilerplate for those [1] and add validation for e.g. duplicate
>> route_maps [2]. In the case of the BGP router this could become quite
>> tricky imo, since for instance the value of ASN / remote-as / .. depends
>> on whether we have a BGP controller / fabric / ...
>>
>> Additionally, we're creating an instance of FrrConfig in the Perl part,
>> by just building the hash in a way that serializes / deserializes into
>> the FrrConfig in Rust. With the builder pattern we'd have to expose the
>> builder functionality to the perl side somehow. I think directly
>> instantiating/mutating + (de)serializing is the better way here for that
>> reason, since we get a partial FrrConfig from Perl already and then just
>> incrementally add stuff in Rust. So it'd make sense to remove all
>> Builder functionality from here for now to save on dependencies /
>> compile-time?
>>
>> For future additions, e.g. route-maps, we could utilize the Builder
>> pattern, since it is entirely contained to Rust and would make sense
>> there - but I'd then introduce it in that patch series.
>>
>> [1] https://bon-rs.com/guide/typestate-api/builder-fields#custom-fields
>> [2] https://bon-rs.com/guide/patterns/fallible-builders#fallible-builders
> 
> Good point -- I'm definitely going through and removing the derive where it
> isn't needed.
> 
> As discussed offlist, this is not super-urgent as the api of proxmox-frr isn't
> really stable or critical or something. Nevertheless we should check how much
> the compilation-time overhead is for deriving bon for every struct, as bon is
> not really lighweight (uses the type-state builder pattern).
> 
> We also need to check if we want to add some validation here or if we don't need
> that. If we need some validation, I'd go with bon, because it's a uniform method
> of doing this, instead of mixing new() methods and TryInto,TryFrom
> implementations, etc.
> Quickly went over the build_fabrics code and didn't notice any struct that needs
> "different" validations, so e.g. sometimes append, sometimes overwrite (so bon
> would still work and we wouldn't need two creation methods).
> 
> Don't know if we should clean this up and continue with bon, or rip it out
> (which wouldn't be much work because we don't use it that heavy) and maybe add
> this later on.
> 
> Open for some other arguments or opinions!
Had some further off-list discussion and settled on the current
approach, without utilizing bon::Builder for now - mostly because it's
hard to expose for the Perl side atm and we build part of the FRR
configuration there still.




  parent reply	other threads:[~2026-02-27 11:49 UTC|newest]

Thread overview: 50+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-02-03 16:01 [PATCH docs/manager/network/proxmox{-ve-rs,-perl-rs} 00/23] Generate frr config using jinja templates and rust types Gabriel Goller
2026-02-03 16:01 ` [PATCH proxmox-ve-rs 1/9] ve-config: firewall: cargo fmt Gabriel Goller
2026-02-03 16:01 ` [PATCH proxmox-ve-rs 2/9] frr: add proxmox-frr-templates package that contains templates Gabriel Goller
2026-02-03 16:01 ` [PATCH proxmox-ve-rs 3/9] ve-config: remove FrrConfigBuilder struct Gabriel Goller
2026-02-03 16:01 ` [PATCH proxmox-ve-rs 4/9] sdn-types: support variable-length NET identifier Gabriel Goller
2026-02-03 16:01 ` [PATCH proxmox-ve-rs 5/9] frr: add template serializer and serialize fabrics using templates Gabriel Goller
2026-02-25 13:43   ` Stefan Hanreich
2026-02-25 16:29     ` Gabriel Goller
2026-02-25 17:03       ` Gabriel Goller
2026-02-27 11:49       ` Stefan Hanreich [this message]
2026-02-03 16:01 ` [PATCH proxmox-ve-rs 6/9] frr: add isis configuration and templates Gabriel Goller
2026-02-03 16:01 ` [PATCH proxmox-ve-rs 7/9] frr: support custom frr configuration lines Gabriel Goller
2026-02-19 12:17   ` Hannes Laimer
2026-02-19 15:01     ` Gabriel Goller
2026-02-03 16:01 ` [PATCH proxmox-ve-rs 8/9] frr: add bgp support with templates and serialization Gabriel Goller
2026-02-27 11:56   ` Stefan Hanreich
2026-02-27 13:19     ` Gabriel Goller
2026-02-03 16:01 ` [PATCH proxmox-ve-rs 9/9] frr: store frr template content as a const map Gabriel Goller
2026-02-25  9:23   ` Stefan Hanreich
2026-02-25 10:08     ` Gabriel Goller
2026-02-03 16:01 ` [PATCH proxmox-perl-rs 1/2] sdn: add function to generate the frr config for all daemons Gabriel Goller
2026-02-03 16:01 ` [PATCH proxmox-perl-rs 2/2] sdn: add method to get a frr template Gabriel Goller
2026-02-03 16:01 ` [PATCH pve-network 01/10] sdn: remove duplicate comment line '!' in frr config Gabriel Goller
2026-02-03 16:01 ` [PATCH pve-network 02/10] sdn: tests: add missing comment " Gabriel Goller
2026-02-03 16:01 ` [PATCH pve-network 03/10] tests: use Test::Differences to make test assertions Gabriel Goller
2026-02-03 16:01 ` [PATCH pve-network 04/10] sdn: write structured frr config that can be rendered using templates Gabriel Goller
2026-02-19 13:52   ` Hannes Laimer
2026-02-19 15:36     ` Gabriel Goller
2026-02-19 15:44       ` Gabriel Goller
2026-02-27 11:41   ` Stefan Hanreich
2026-02-27 14:15     ` Gabriel Goller
2026-02-03 16:01 ` [PATCH pve-network 05/10] tests: rearrange some statements in the frr config Gabriel Goller
2026-02-03 16:01 ` [PATCH pve-network 06/10] sdn: adjust frr.conf.local merging to rust template types Gabriel Goller
2026-02-03 16:01 ` [PATCH pve-network 07/10] cli: add pvesdn cli tool for managing frr template overrides Gabriel Goller
2026-02-19 12:39   ` Hannes Laimer
2026-02-19 15:49     ` Gabriel Goller
2026-02-24 14:05   ` Stefan Hanreich
2026-02-03 16:01 ` [PATCH pve-network 08/10] debian: handle user modifications to FRR templates via ucf Gabriel Goller
2026-02-03 16:01 ` [PATCH pve-network 09/10] api: add dry-run endpoint for sdn apply to preview changes Gabriel Goller
2026-02-24 13:53   ` Stefan Hanreich
2026-02-03 16:01 ` [PATCH pve-network 10/10] test: add test for frr.conf.local merging Gabriel Goller
2026-02-24 13:27   ` Stefan Hanreich
2026-02-25 15:52     ` Gabriel Goller
2026-02-03 16:01 ` [PATCH pve-manager 1/1] sdn: add dry-run view for sdn apply Gabriel Goller
2026-02-24 12:49   ` Stefan Hanreich
2026-02-03 16:01 ` [PATCH pve-docs 1/1] docs: add man page for the `pvesdn` cli Gabriel Goller
2026-02-23 16:09 ` [PATCH docs/manager/network/proxmox{-ve-rs,-perl-rs} 00/23] Generate frr config using jinja templates and rust types Hannes Laimer
2026-02-24 11:09   ` Stefan Hanreich
2026-02-27 12:29 ` Stefan Hanreich
2026-03-02 13:00 ` Gabriel Goller

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=f0150078-35aa-4d92-8bb1-5cc081e658db@proxmox.com \
    --to=s.hanreich@proxmox.com \
    --cc=pve-devel@lists.proxmox.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.
Service provided by Proxmox Server Solutions GmbH | Privacy | Legal