[HOW] Variant renamer

[Unichord]

I'd like to change some resistor/microcontroller value with different variants on the same project.

I have created these fields in the component (the variant is simply 'S'):

As per documentation (https://kibot.readthedocs.io/en/latest/configuration/filters/var_rename.html#variant-renamer), but I don't understand how to implement this filter/variant.

I expected these fields to work globally, once I defined them, but it's not working, as I'm surely missing something.

Here are the yaml files I'm using. If you need some more information let me know.
bom.kibot.yaml
position.kibot.yaml

Thanks in advance.

[set-soft]

Take a look at the example: tests/yaml_samples/var_rename_footprint.kibot.yaml
https://github.com/INTI-CMNB/KiBot/blob/master/tests/yaml_samples/var_rename_footprint.kibot.yaml
https://github.com/INTI-CMNB/KiBot/blob/master/tests/board_samples/kicad_9/var_rename_footprint.kicad_pcb

And other YAML files in the yaml_samples dir.

[Unichord]

Ok, so it doesn't work with this structure?

variants:
- name: 'default'
  type: kibom
  file_id: ''
  variant: ''
  pre_transform: 'var_rename'
- name: 'S'
  type: kibom
  file_id: 'S'
  variant: 'S'
  pre_transform: 'var_rename'

In my opinion it should be "automatically" applied once I apply a variant. It would be more logical and also simpler. Am I missing something? Is there a reason why it's not done this way?

[set-soft]

Ok, so it doesn't work with this structure?

variants:
- name: 'default'
  type: kibom
  file_id: ''
  variant: ''
  pre_transform: 'var_rename'
- name: 'S'
  type: kibom
  file_id: 'S'
  variant: 'S'
  pre_transform: 'var_rename'

Nope, var_rename is a type of filter, not the name of a filter.
Use _var_rename, this is the name for the default var_rename filter: https://kibot.readthedocs.io/en/latest/configuration/filters.html#built-in-filters

In my opinion it should be "automatically" applied once I apply a variant. It would be more logical and also simpler. Am I missing something? Is there a reason why it's not done this way?

Because then you can't disable it. The fact that some tools interprets fields named VARIANT:FIELD doesn't mean all people uses it this way. In fact we have two different mechanisms. KiCost variant renamer uses kicost.VARIANT:FIELD.
Which one should be the default? How people will be able to remove them? What about customization?

So this is just a filter, you can use it or not. You can customize it, and you can insert it in a chain of filters, and in the order you need.

Built-in filters are there to make things easier. They are the most common versions of the filters, so you don't need to define them. But you need to apply them.

[Unichord]

I see, it makes sense. Thank you for the explanation.

Now it works, meaning that the value is correct, but since Kicad somehow added the fields S:MPN and S:LCSCPN to all the components (I don't know if this is the expected behavior), I have this, of course:

EMXJ4S_simpleBOM.csv
EMXJ4_simpleBOM.csv

I had to delete manually the fields from every components in the schematic and in the PCB file. Now it works properly. It would be neat to have a fallback to the MPN field if S:MPN is empty.