calculations.lua
-------------------------------------

Functions used for the ingame help windows.

.. function:: programs_wares_count(tribe, building, ware_description)

   Examines the :ref:`production site programs <productionsite_programs>`
   and returns three tables.

   :arg tribe: The :class:`wl.map.TribeDescription` for the tribe that consumes the ware
   :arg building: The :class:`wl.map.BuildingDescription`
   :arg ware_description: A :class:`wl.map.WareDecription`

   :returns (in this order):
      * An :class:`array` of program_names this production site has
      * A :class:`table` of ``{program_name,wares_count}``
      * A :class:`table` of ``{program_name,formatted_string(s)}``


.. function:: programs_workers_count(tribe, building, worker_description)

   Examines the :ref:`production site programs <productionsite_programs>`
   and returns three tables.

   :arg tribe: The :class:`wl.map.TribeDescription` for the tribe that consumes the ware
   :arg building: The :class:`wl.map.BuildingDescription`
   :arg worker_description: A :class:`wl.map.WorkerDecription`

   :returns (in this order):
      * An :class:`array` of program_names this production site has
      * A :class:`table` of ``{program_name,workers_count}``
      * A :class:`table` of ``{program_name,formatted_string(s)}``