Summary  
This chapter covers the object-oriented composition pattern, where complex functionality is built by containing and delegating to independent component objects—using constructor and setter injection—to achieve modularity, flexibility, and testability.  

General domain of usage  
E-commerce order processing

La composición se centra en construir objetos complejos combinando componentes más simples e independientes. En lugar de depender de la herencia, que crea jerarquías rígidas, la composición permite que las clases colaboren a través de objetos contenidos. Este enfoque hace que los sistemas sean más **flexibles**, **modulares** y **fáciles de mantener**, ya que los componentes pueden ser reemplazados o ampliados sin afectar toda la estructura.

class Payment:
    def pay(self, amount):
        return f"Paid {amount}"


class Inventory:
    def reserve(self, item):
        return f"{item} reserved"


class Shipping:
    def ship(self, item):
        return f"{item} shipped"


class Order:
    def __init__(self, item, price, payment, inventory, shipping):
        self.item = item
        self.price = price
        self.payment = payment
        self.inventory = inventory
        self.shipping = shipping

    def process(self):
        return " | ".join([
            self.inventory.reserve(self.item),
            self.payment.pay(self.price),
            self.shipping.ship(self.item)
        ])


order = Order("Laptop", 1200, Payment(), Inventory(), Shipping())
print(order.process())

`Order` no implementa la lógica de pago, inventario o envío por sí mismo.
En su lugar, **tiene** objetos separados (`Payment`, `Inventory`, `Shipping`) y los utiliza para completar su trabajo.

Cada componente tiene una responsabilidad, y `Order` solo los coordina.
Si se desea cambiar cómo funciona el pago o el envío, se puede reemplazar el componente sin modificar la clase `Order`.


Algunos inconvenientes a tener en cuenta al usar composición son la creación de **objetos dios** que agrupan demasiados componentes y se vuelven difíciles de gestionar, **filtrar las APIs de los componentes** a través de la clase externa en lugar de mantener una interfaz limpia, e introducir **acoplamiento oculto** cuando los componentes dependen demasiado de los detalles internos de otros.

Un objeto dios intenta hacer demasiado. Contiene muchos componentes y maneja muchas responsabilidades, lo que hace que la clase sea difícil de entender, probar y mantener.

Objetos dios

Esto ocurre cuando la clase externa expone los métodos o atributos internos de sus componentes. En lugar de proporcionar su propia interfaz limpia, obliga a los usuarios a interactuar directamente con los objetos internos.

Filtración de APIs de componentes

Los componentes se conectan estrechamente a través de detalles internos. Cambiar una parte rompe inesperadamente otra porque dependen de la estructura interna de cada uno en lugar de contratos claros.

Acoplamiento oculto

¿Cuál es un riesgo común al usar composición que puede dificultar el mantenimiento del diseño?

Aprende a construir aplicaciones limpias, seguras y escalables con Programación Orientada a Objetos en Python. Cubre los fundamentos de clases y objetos, y luego avanza hacia conceptos avanzados como herencia, composición, polimorfismo y encapsulamiento. Con explicaciones claras y ejemplos prácticos, desarrollarás la capacidad de diseñar programas en Python que sean potentes, mantenibles y listos para su uso en el mundo real.

Aprenda los conceptos fundamentales de la programación orientada a objetos en Python. Esta sección abarca clases, objetos, métodos y variables, proporcionando una base sólida para comprender cómo la POO organiza y estructura el código.

Explora cómo las clases pueden compartir y extender funcionalidades. Aprenderás diferentes patrones de herencia, desde jerarquías simples hasta herencia múltiple y clases abstractas, y verás cómo permiten la reutilización de código y la escalabilidad.

Descubra cómo construir sistemas flexibles combinando objetos. En lugar de depender únicamente de la herencia, verá cómo la composición permite ensamblar comportamientos de manera modular y adaptable.

Comprender cómo diferentes objetos pueden compartir una interfaz común mientras se comportan de manera propia. Esta sección muestra cómo la sobrescritura de métodos, las interfaces y los protocolos hacen que el código sea más dinámico y reutilizable.

Aprenda a proteger los datos internos y controlar el acceso a los atributos de clase. Se explorarán los atributos privados, los métodos getter y setter, y las técnicas de ocultamiento de datos que mantienen sus clases seguras y mantenibles.

Core Principles of Composition