policy.c

Go to the documentation of this file.

/********************************************************************\
 * policy.c -- Implement FIFO Accounting Policy                     *
 *                                                                  *
 * This program is free software; you can redistribute it and/or    *
 * modify it under the terms of the GNU General Public License as   *
 * published by the Free Software Foundation; either version 2 of   *
 * the License, or (at your option) any later version.              *
 *                                                                  *
 * This program is distributed in the hope that it will be useful,  *
 * but WITHOUT ANY WARRANTY; without even the implied warranty of   *
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the    *
 * GNU General Public License for more details.                     *
 *                                                                  *
 * You should have received a copy of the GNU General Public License*
 * along with this program; if not, contact:                        *
 *                                                                  *
 * Free Software Foundation           Voice:  +1-617-542-5942       *
 * 51 Franklin Street, Fifth Floor    Fax:    +1-617-542-2652       *
 * Boston, MA  02110-1301,  USA       gnu@gnu.org                   *
\********************************************************************/

#include "config.h"

#include <glib.h>

#include "Account.h"
#include "Transaction.h"
#include "TransactionP.h"
#include "cap-gains.h"
#include "gnc-engine.h"
#include "gnc-lot.h"
#include "gnc-lot-p.h"
#include "policy.h"
#include "policy-p.h"

//static QofLogModule log_module = GNC_MOD_LOT;

static Split * 
DirectionPolicyGetSplit (GNCPolicy *pcy, GNCLot *lot, short reverse)
{
   Split *split;
   SplitList *node;
   gnc_commodity *common_currency;
   gboolean want_positive;
   gnc_numeric baln;
   Split *osplit;
   Transaction *otrans;
   Timespec open_ts;

   if (!pcy || !lot || !lot->account || !lot->splits) return NULL;

   /* Recomputing the balance re-evaluates the lot closure */
   baln = gnc_lot_get_balance (lot);
   if (gnc_lot_is_closed(lot)) return NULL;

   want_positive = gnc_numeric_negative_p (baln);

   /* All splits in lot must share a common transaction currency. */
   split = lot->splits->data;
   common_currency = split->parent->common_currency;
   
   /* Don't add a split to the lot unless it will be the new last
      split in the lot.  Otherwise our balance tests will be wrong
      and the lot may end up too thin or too fat. */
   osplit = gnc_lot_get_latest_split (lot);
   otrans = osplit ? xaccSplitGetParent (osplit) : 0;
   open_ts = xaccTransRetDatePostedTS (otrans);

   /* Walk over *all* splits in the account, till we find one that
    * hasn't been assigned to a lot.  Return that split.
    * Make use of the fact that the splits in an account are 
    * already in date order; so we don't have to sort. */
   node = xaccAccountGetSplitList (lot->account);
   if (reverse)
   {
       node = g_list_last (node);
   }
   while (node)
   {
      gboolean is_match;
      gboolean is_positive;
      Timespec this_ts;
      split = node->data;
      if (split->lot) goto donext;

      /* Skip it if it's too early */
      this_ts = xaccTransRetDatePostedTS ( xaccSplitGetParent (split));
      if ((this_ts.tv_sec < open_ts.tv_sec) ||
          ((this_ts.tv_sec == open_ts.tv_sec) && 
            (this_ts.tv_nsec < open_ts.tv_nsec)))
      {
         if (reverse)
            /* Going backwards, no point in looking further */
            break;
         goto donext;
      }
      
      /* Allow equiv currencies */
      is_match = gnc_commodity_equiv (common_currency, 
                                      split->parent->common_currency);
      if (FALSE == is_match) goto donext;

      /* Disallow zero-amount splits in general. */
      if (gnc_numeric_zero_p(split->amount)) goto donext;

      is_positive = gnc_numeric_positive_p (split->amount);
      if ((want_positive && is_positive) ||
          ((!want_positive) && (!is_positive))) return split;
donext:
      if (reverse)
      {
         node=node->prev;
      }
      else
      {
         node=node->next;
      }
   }
   return NULL;
}

/* ============================================================== */

static GNCLot * 
FIFOPolicyGetLot (GNCPolicy *pcy, Split *split)
{
   if (!split) return NULL;
   return xaccAccountFindEarliestOpenLot (split->acc, split->amount,
                                          split->parent->common_currency);
}

static Split * 
FIFOPolicyGetSplit (GNCPolicy *pcy, GNCLot *lot)
{
   return DirectionPolicyGetSplit (pcy, lot, 0);
}

static void
FIFOPolicyGetLotOpening (GNCPolicy *pcy,
        GNCLot *lot,
        gnc_numeric *ret_amount, gnc_numeric *ret_value,
        gnc_commodity **ret_currency)
{
   Split *opening_split;
   opening_split = gnc_lot_get_earliest_split(lot);

   if (ret_amount) *ret_amount = opening_split->amount;
   if (ret_value) *ret_value = opening_split->value;
   if (ret_currency) *ret_currency = opening_split->parent->common_currency;
}

static gboolean
FIFOPolicyIsOpeningSplit (GNCPolicy *pcy, GNCLot *lot, Split *split)
{
   Split *opening_split;
   opening_split = gnc_lot_get_earliest_split(lot);
   return (split == opening_split);
}

/* ============================================================== */
/* Define a single, static policy, since we have no per-object data.
 * I suppose this could change, but we don't need any better at the
 * moment ... */

GNCPolicy *
xaccGetFIFOPolicy (void)
{
   static GNCPolicy *pcy = NULL;

   if (!pcy)
   {
      pcy = g_new (GNCPolicy, 1);
      pcy->PolicyGetLot = FIFOPolicyGetLot;
      pcy->PolicyGetSplit = FIFOPolicyGetSplit;
      pcy->PolicyGetLotOpening = FIFOPolicyGetLotOpening;
      pcy->PolicyIsOpeningSplit = FIFOPolicyIsOpeningSplit;
   }
   return pcy;
}

/* ============================================================== */
/* Stab at implementing the LIFO policy.  This is untested. 
 * I'm not sure I got it right.
 */

static GNCLot * 
LIFOPolicyGetLot (GNCPolicy *pcy, Split *split)
{
   if (!split) return NULL;
   return xaccAccountFindLatestOpenLot (split->acc, split->amount,
                                        split->parent->common_currency);
}

static Split * 
LIFOPolicyGetSplit (GNCPolicy *pcy, GNCLot *lot)
{
   return DirectionPolicyGetSplit (pcy, lot, 1);
}

/* This routine is actually identical to FIFO... */
static void
LIFOPolicyGetLotOpening (GNCPolicy *pcy,
        GNCLot *lot,
        gnc_numeric *ret_amount, gnc_numeric *ret_value,
        gnc_commodity **ret_currency)
{
   Split *opening_split;
   opening_split = gnc_lot_get_earliest_split(lot);

   if (ret_amount) *ret_amount = opening_split->amount;
   if (ret_value) *ret_value = opening_split->value;
   if (ret_currency) *ret_currency = opening_split->parent->common_currency;
}

/* This routine is actually identical to FIFO... */
static gboolean
LIFOPolicyIsOpeningSplit (GNCPolicy *pcy, GNCLot *lot, Split *split)
{
   Split *opening_split;
   opening_split = gnc_lot_get_earliest_split(lot);
   return (split == opening_split);
}

/* ============================================================== */

/* Define a single, static policy, since we have no per-object data.
 * I suppose this could change, but we don't need any better at the
 * moment ... */

GNCPolicy *
xaccGetLIFOPolicy (void)
{
   static GNCPolicy *pcy = NULL;

   if (!pcy)
   {
      pcy = g_new (GNCPolicy, 1);
      pcy->PolicyGetLot = LIFOPolicyGetLot;
      pcy->PolicyGetSplit = LIFOPolicyGetSplit;
      pcy->PolicyGetLotOpening = LIFOPolicyGetLotOpening;
      pcy->PolicyIsOpeningSplit = LIFOPolicyIsOpeningSplit;
   }
   return pcy;
}

/* =========================== END OF FILE ======================= */

---