Por qué las funciones públicas no deben llamar a otras públicas

Fuentes: Why public functions should not call other public functions

Una práctica fundamental en el diseño de software es evitar que las funciones públicas llamen a otras funciones públicas. Esta regla, aunque simple, resuelve tensiones críticas en la arquitectura de la API. Cuando una función pública 'foo' depende de otra pública 'bar', se genera un conflicto entre la conveniencia para el usuario externo y la cohesión interna. La tendencia natural de reutilizar código ('DRY') suele provocar que las funciones públicas acumulen parámetros opcionales que el usuario nunca debería establecer, degradando la interfaz con el tiempo.

La solución recomendada es crear una función privada compartida que implemente la lógica común, permitiendo que 'foo' y 'bar' la llamen. Al mantener la implementación privada, se elimina la tensión de la interfaz pública, ya que los cambios en la firma de la función auxiliar son locales y baratos de corregir. Esta práctica protege la estabilidad de la API para el usuario final.

Sin embargo, existe una excepción notable: las 'shortcut APIs' (APIs de atajo). En estos casos, una función pública representa una cadena de llamadas a otras funciones públicas para ofrecer una experiencia de usuario más fluida. Aquí, la regla se invierte: no se permiten llamadas privadas para garantizar que la función sea un atajo genuino y no un error de capa intermedia. Además, el texto destaca que esta recomendación no debe seguirse ciegamente por conveniencia, sino por comprender la razón subyacente: la facilidad de pruebas y la claridad de la abstracción. El objetivo final es que la API funcione mejor en el sitio de llamada, no en la implementación interna.