public inbox for pve-devel@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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
Service provided by Proxmox Server Solutions GmbH | Privacy | Legal