Features

Files
file	gnc-features.h
	Utility functions for file access.

Functions
gchar *	gnc_features_test_unknown (QofBook *book)
	Test if the current book relies on features only introduced in a more recent version of GnuCash. More...
void	gnc_features_set_unused (QofBook *book, const gchar *feature)
	Indicate that the current book does not use the given feature. More...
void	gnc_features_set_used (QofBook *book, const gchar *feature)
	Indicate that the current book uses the given feature. More...
gboolean	gnc_features_check_used (QofBook *, char const *feature)

Defined features
#define	GNC_FEATURE_CREDIT_NOTES   "Credit Notes"
#define	GNC_FEATURE_NUM_FIELD_SOURCE   "Number Field Source"
#define	GNC_FEATURE_KVP_EXTRA_DATA   "Extra data in addresses, jobs or invoice entries"
#define	GNC_FEATURE_BOOK_CURRENCY   "Use a Book-Currency"
#define	GNC_FEATURE_GUID_BAYESIAN   "Account GUID based Bayesian data"
#define	GNC_FEATURE_GUID_FLAT_BAYESIAN   "Account GUID based bayesian with flat KVP"
#define	GNC_FEATURE_SQLITE3_ISO_DATES   "ISO-8601 formatted date strings in SQLite3 databases."
#define	GNC_FEATURE_REG_SORT_FILTER   "Register sort and filter settings stored in .gcm file"
#define	GNC_FEATURE_BUDGET_UNREVERSED   "Use natural signs in budget amounts"
#define	GNC_FEATURE_BUDGET_SHOW_EXTRA_ACCOUNT_COLS   "Show extra account columns in the Budget View"
#define	GNC_FEATURE_EQUITY_TYPE_OPENING_BALANCE   "Use a dedicated opening balance account identified by an 'equity-type' slot"

Detailed Description

Function Documentation

gnc_features_set_unused()

void gnc_features_set_unused	(	QofBook *	book,
		const gchar *	feature
	)

Indicate that the current book does not use the given feature.

This will allow older versions of GnuCash that don't support this feature to load this book.

Definition at line 124 of file gnc-features.cpp.

{
    g_return_if_fail (book);
    g_return_if_fail (feature);

    /* Can't set an unknown feature */
    auto iter = features_table.find (feature);
    if (iter == features_table.end ())
    {
        PWARN("Tried to set unknown feature as unused.");
        return;
    }

    qof_book_unset_feature (book, feature);
}

gnc_features_set_used()

void gnc_features_set_used	(	QofBook *	book,
		const gchar *	feature
	)

Indicate that the current book uses the given feature.

This will prevent older versions of GnuCash that don't support this feature to refuse to load this book.

Definition at line 107 of file gnc-features.cpp.

{
    g_return_if_fail (book);
    g_return_if_fail (feature);

    /* Can't set an unknown feature */
    auto iter = features_table.find (feature);
    if (iter == features_table.end ())
    {
        PWARN("Tried to set unknown feature as used.");
        return;
    }

    qof_book_set_feature (book, feature, iter->second.data());
}

gnc_features_test_unknown()

gchar* gnc_features_test_unknown

(

QofBook *

book

)

Test if the current book relies on features only introduced in a more recent version of GnuCash.

Returns a message to display if we found unknown features, NULL if we're okay.

Definition at line 82 of file gnc-features.cpp.

{
    auto unknowns {qof_book_get_unknown_features (book, features_table)};
    if (unknowns.empty())
        return nullptr;

    auto obsolete = std::remove_if(unknowns.begin(), unknowns.end(),
                                   [](auto& unknown){
                                       return obsolete_features.find(unknown.first) != obsolete_features.end();
                                   });
    while (obsolete != unknowns.end())
    {
        qof_book_unset_feature(book, obsolete->first.data());
        obsolete = unknowns.erase(obsolete);
    }

    if (unknowns.empty())
        return nullptr;

    auto accum = [](const auto& a, const auto& b){ return a + "\n* " + b.second.data(); };
    auto msg {std::accumulate (unknowns.begin(), unknowns.end(),
                                   std::string (_(header)), accum)};
    return g_strdup (msg.c_str());
}