#ifndef OBJTOOLS_FORMAT___FLAT_FILE_CONFIG__HPP
#define OBJTOOLS_FORMAT___FLAT_FILE_CONFIG__HPP

/*  $Id: flat_file_config.hpp 693505 2025-02-13 14:43:47Z ivanov $
 * ===========================================================================
 *
 *                            PUBLIC DOMAIN NOTICE
 *               National Center for Biotechnology Information
 *
 *  This software/database is a "United States Government Work" under the
 *  terms of the United States Copyright Act.  It was written as part of
 *  the author's official duties as a United States Government employee and
 *  thus cannot be copyrighted.  This software/database is freely available
 *  to the public for use. The National Library of Medicine and the U.S.
 *  Government have not placed any restriction on its use or reproduction.
 *
 *  Although all reasonable efforts have been taken to ensure the accuracy
 *  and reliability of the software and data, the NLM and the U.S.
 *  Government do not and cannot warrant the performance or results that
 *  may be obtained by using this software or data. The NLM and the U.S.
 *  Government disclaim all warranties, express or implied, including
 *  warranties of performance, merchantability or fitness for any particular
 *  purpose.
 *
 *  Please cite the author in any work or product based on this material.
 *
 * ===========================================================================
 *
 * Authors:  Mati Shomrat, NCBI
 *
 * File Description:
 *    Configuration class for flat-file generator
 */
#include <corelib/ncbistd.hpp>
#include <corelib/ncbiobj.hpp>

#include <util/icanceled.hpp>

BEGIN_NCBI_SCOPE

class CArgDescriptions;
class CArgs;

BEGIN_SCOPE(objects)

class CBioseqContext;
class CStartSectionItem;
class CHtmlAnchorItem;
class CLocusItem;
class CDeflineItem;
class CAccessionItem;
class CVersionItem;
class CGenomeProjectItem;
class CDBSourceItem;
class CKeywordsItem;
class CSegmentItem;
class CSourceItem;
class CReferenceItem;
class CCacheItem;
class CCommentItem;
class CPrimaryItem;
class CFeatHeaderItem;
class CSourceFeatureItem;
class CFeatureItem;
class CGapItem;
class CBaseCountItem;
class COriginItem;
class CSequenceItem;
class CContigItem;
class CWGSItem;
class CTSAItem;
class CEndSectionItem;
class IFlatItem;
class CSeq_id;
class CSeq_loc;
struct SModelEvidance;

// --- Flat File configuration class

class NCBI_FORMAT_EXPORT IHTMLFormatter: public CObject
{
public:
    virtual ~IHTMLFormatter() {}

    virtual void FormatProteinId(string& str, const CSeq_id& seq_id, const string& prot_id) const = 0;
    virtual void FormatTranscriptId(string& str, const CSeq_id& seq_id, const string& nuc_id) const = 0;
    virtual void FormatNucSearch(ostream& os, const string& id) const = 0;
    virtual void FormatNucId(string& str, const CSeq_id& seq_id, TIntId gi, const string& acc_id) const = 0;
    virtual void FormatTaxid(string& str, const TTaxId taxid, const string& taxname) const = 0;
    virtual void FormatLocation(string& str, const CSeq_loc& loc, TIntId gi, const string& visible_text) const = 0;
    virtual void FormatModelEvidence(string& str, const SModelEvidance& me) const = 0;
    virtual void FormatTranscript(string& str, const string& name) const = 0;
    virtual void FormatGeneralId(ostream& os, const string& id) const = 0;
    virtual void FormatGapLink(ostream& os, TSeqPos gap_size, const string& id, bool is_prot) const = 0;
    virtual void FormatUniProtId(string& str, const string& prot_id) const = 0;
};

class NCBI_FORMAT_EXPORT CHTMLEmptyFormatter : public IHTMLFormatter
{
public:
    ~CHTMLEmptyFormatter() override {}

    void FormatProteinId(string& str, const CSeq_id& seq_id, const string& prot_id) const override;
    void FormatTranscriptId(string& str, const CSeq_id& seq_id, const string& nuc_id) const override;
    void FormatNucSearch(ostream& os, const string& id) const override;
    void FormatNucId(string& str, const CSeq_id& seq_id, TIntId gi, const string& acc_id) const override;
    void FormatTaxid(string& str, const TTaxId taxid, const string& taxname) const override;
    void FormatLocation(string& str, const CSeq_loc& loc, TIntId gi, const string& visible_text) const override;
    void FormatModelEvidence(string& str, const SModelEvidance& me) const override;
    void FormatTranscript(string& str, const string& name) const override;
    void FormatGeneralId(ostream& os, const string& id) const override;
    void FormatGapLink(ostream& os, TSeqPos gap_size, const string& id, bool is_prot) const override;
    void FormatUniProtId(string& str, const string& prot_id) const override;
};

class NCBI_FORMAT_EXPORT CFlatFileConfig
{
public:

    enum EFormat {
        // formatting styles
        eFormat_GenBank,
        eFormat_EMBL,
        eFormat_DDBJ,
        eFormat_GBSeq,
        eFormat_INSDSeq,
        eFormat_FTable,
        eFormat_FeaturesOnly,
        eFormat_SAM,
        eFormat_AGP,
        eFormat_Lite
    };

    enum EMode {
        // determines the tradeoff between strictness and completeness
        eMode_Release = 0, // strict -- for official public releases
        eMode_Entrez,      // somewhat laxer -- for CGIs
        eMode_GBench,      // even laxer -- for editing submissions
        eMode_Dump         // shows everything, regardless of validity
    };


    enum EStyle {
        // determines handling of segmented records
        eStyle_Normal,  // default -- show segments iff they're near
        eStyle_Segment, // always show segments
        eStyle_Master,  // merge segments into a single virtual record
        eStyle_Contig   // just an index of segments -- no actual sequence
    };

    enum EFlags {
        // customization flags
        fDoHTML                = 1,
        fShowContigFeatures    = 1 << 1,  // not just source features
        fShowContigSources     = 1 << 2,  // not just focus
        fShowFarTranslations   = 1 << 3,
        fTranslateIfNoProduct  = 1 << 4,
        fAlwaysTranslateCDS    = 1 << 5,
        fOnlyNearFeatures      = 1 << 6,
        fFavorFarFeatures      = 1 << 7,  // ignore near feats on segs w/far feats
        fCopyCDSFromCDNA       = 1 << 8,  // for gen-prod sets
        fCopyGeneToCDNA        = 1 << 9,  // for gen-prod sets
        fShowContigInMaster    = 1 << 10,
        fHideImpFeatures       = 1 << 11,
        fHideRemoteImpFeatures = 1 << 12,
        fHideSNPFeatures       = 1 << 13,
        fHideExonFeatures      = 1 << 14,
        fHideIntronFeatures    = 1 << 15,
        fHideMiscFeatures      = 1 << 16,
        fHideCDSProdFeatures   = 1 << 17,
        fHideCDDFeatures       = 1 << 18,
        fShowTranscript        = 1 << 19,
        fShowPeptides          = 1 << 20,
        fHideGeneRIFs          = 1 << 21,
        fOnlyGeneRIFs          = 1 << 22,
        fLatestGeneRIFs        = 1 << 23,
        fShowContigAndSeq      = 1 << 24,
        fHideSourceFeatures    = 1 << 25,
        fShowFtableRefs        = 1 << 26,
        fOldFeaturesOrder      = 1 << 27,
        fHideGapFeatures       = 1 << 28,
        fNeverTranslateCDS     = 1 << 29,
        fShowSeqSpans          = 1 << 30
    };

    enum ECustom {
        // additional customization flags
        fHideProteinID         = 1,
        fHideGI                = 1 << 1,
        fLongLocusNames        = 1 << 2,
        fExpandGaps            = 1 << 3,
        fShowSNPFeatures       = 1 << 6,
        fShowCDDFeatures       = 1 << 7,
        fShowDebugTiming       = 1 << 8,
        fFasterReleaseSets     = 1 << 9,
        fDisableAnnotRefs      = 1 << 10,
        fUseSeqEntryIndexer    = 1 << 11,
        fUseAutoDef            = 1 << 12,
        fIgnoreExistingTitle   = 1 << 13,
        fGeneRNACDSFeatures    = 1 << 14,
        fShowFtablePeptides    = 1 << 15,
        fDisableReferenceCache = 1 << 16,
        fShowDeflineModifiers  = 1 << 17,
        fDoNotUseAutoDef       = 1 << 18,
        fOldTpaDisplay         = 1 << 19,
        fDisableDefaultIndex   = 1 << 20,
        fGeoLocNameCountry     = 1 << 21,
        fLeavePrefixSuffix     = 1 << 22
    };

    enum EView {
        // determines which Bioseqs in an entry to view
        fViewNucleotides  = 0x1,
        fViewProteins     = 0x2,
        fViewAll          = (fViewNucleotides | fViewProteins),
        fViewFirst        = 0x4
    };

    enum EPolicy {
        // far feature fetch policy
        ePolicy_Adaptive = 0,
        ePolicy_Internal = 1,
        ePolicy_External = 2,
        ePolicy_Exhaustive = 3,
        ePolicy_Ftp = 4,
        ePolicy_Web = 5,
        ePolicy_Genomes = 6
    };

    // These flags are used to select the GenBank sections to print or skip.
    enum FGenbankBlocks {
        // default is all sections
        fGenbankBlocks_All        = (~0u),
        fGenbankBlocks_None       = 0,

        // or, specify individual sections to print.
        // or, specify individual sections to skip
        // (via (fGenbankBlocks_All & ~fGenbankBlocks_Locus), for example)
        // Note that these flags do NOT have a one-to-one relationship
        // with the notify() functions in CGenbankBlockCallback.
        // For example, fGenbankBlocks_FeatAndGap is used to turn
        // on both the CFeatureItem and CGapItem notify functions.
        fGenbankBlocks_Head       = (1u <<  0),
        fGenbankBlocks_Locus      = (1u <<  1),
        fGenbankBlocks_Defline    = (1u <<  2),
        fGenbankBlocks_Accession  = (1u <<  3),
        fGenbankBlocks_Version    = (1u <<  4),
        fGenbankBlocks_Project    = (1u <<  5),
        fGenbankBlocks_Dbsource   = (1u <<  6),
        fGenbankBlocks_Keywords   = (1u <<  7),
        fGenbankBlocks_Segment    = (1u <<  8),
        fGenbankBlocks_Source     = (1u <<  9),
        fGenbankBlocks_Reference  = (1u << 10),
        fGenbankBlocks_Comment    = (1u << 11),
        fGenbankBlocks_Primary    = (1u << 12),
        fGenbankBlocks_Featheader = (1u << 13),
        fGenbankBlocks_Sourcefeat = (1u << 14),
        fGenbankBlocks_FeatAndGap = (1u << 15),
        fGenbankBlocks_Basecount  = (1u << 16),
        fGenbankBlocks_Origin     = (1u << 17),
        fGenbankBlocks_Sequence   = (1u << 18),
        fGenbankBlocks_Contig     = (1u << 19),
        fGenbankBlocks_Wgs        = (1u << 20),
        fGenbankBlocks_Tsa        = (1u << 21),
        fGenbankBlocks_Slash      = (1u << 22),
        fGenbankBlocks_Cache      = (1u << 23)
    };

    // types
    typedef EFormat         TFormat;
    typedef EMode           TMode;
    typedef EStyle          TStyle;
    typedef EPolicy         TPolicy;
    typedef unsigned int    TFlags; // binary OR of "EFlags"
    typedef unsigned int    TView;
    typedef unsigned int    TGenbankBlocks;
    typedef unsigned int    TCustom; // binary OR of "ECustom"

    class NCBI_FORMAT_EXPORT CGenbankBlockCallback : public CObject {
    public:
        enum EAction {
            /// the normal case
            eAction_Default,
            /// skip this block (i.e. don't print it)
            eAction_Skip,
            /// If for some reason you don't want the rest of the flatfile generated,
            /// this will trigger a CFlatException of type eHaltRequested
            eAction_HaltFlatfileGeneration
        };

        enum EBioseqSkip {
            eBioseqSkip_No,
            eBioseqSkip_Yes
        };

        virtual ~CGenbankBlockCallback(void) { }

        // It is intentional that CBioseqContext is non-const here,
        // but const in the other notify functions.
        virtual EBioseqSkip notify_bioseq( CBioseqContext& ctx );

        // please note that these notify functions let you change the block_text
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CStartSectionItem & head_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CHtmlAnchorItem & anchor_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CLocusItem &locus_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CDeflineItem & defline_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CAccessionItem & accession_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CVersionItem & version_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CGenomeProjectItem & project_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CDBSourceItem & dbsource_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CKeywordsItem & keywords_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CSegmentItem & segment_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CSourceItem & source_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CReferenceItem & ref_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CCacheItem & cache_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CCommentItem & comment_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CPrimaryItem & primary_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CFeatHeaderItem & featheader_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CSourceFeatureItem & sourcefeat_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CFeatureItem & feature_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CGapItem & feature_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CBaseCountItem & basecount_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const COriginItem & origin_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CSequenceItem & sequence_chunk_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CContigItem & contig_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CWGSItem & wgs_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CTSAItem & tsa_item );
        virtual EAction notify( string & block_text,
                                const CBioseqContext& ctx,
                                const CEndSectionItem & slash_item );

        // add more overridable functions if more blocks are invented


        // ...or override
        // this if you want only a single entry-point for
        // notifications.
        virtual EAction unified_notify(
            string & /*block_text*/,
            const CBioseqContext& /*ctx*/,
            const IFlatItem & /*flat_item*/,
            FGenbankBlocks /*which_block*/ ) { return eAction_Default; }
    };

    // constructor
    CFlatFileConfig(TFormat format = eFormat_GenBank,
                    TMode   mode = eMode_GBench,
                    TStyle  style = eStyle_Normal,
                    TFlags  flags = 0,
                    TView   view = fViewNucleotides,
                    TPolicy policy = ePolicy_Adaptive,
                    TCustom custom = 0);

    // destructor
    ~CFlatFileConfig(void);

    void SetHTMLFormatter(CRef<IHTMLFormatter> html_fmt)
    {
        m_html_formatter = html_fmt;
    }
    const IHTMLFormatter& GetHTMLFormatter() const
    {
        return *m_html_formatter;
    }

    // -- Format
    // getters
    const TFormat& GetFormat(void) const { return m_Format; }
    bool IsFormatGenbank(void) const { return m_Format == eFormat_GenBank; }
    bool IsFormatEMBL   (void) const { return m_Format == eFormat_EMBL;    }
    bool IsFormatDDBJ   (void) const { return m_Format == eFormat_DDBJ;    }
    bool IsFormatGBSeq  (void) const { return m_Format == eFormat_GBSeq;   }
    bool IsFormatINSDSeq(void) const { return m_Format == eFormat_INSDSeq; }
    bool IsFormatFTable (void) const { return m_Format == eFormat_FTable;  }
    bool IsFormatAGP    (void) const { return m_Format == eFormat_AGP;     }
    bool IsFormatLite   (void) const { return m_Format == eFormat_Lite;    }

    // setters
    void SetFormat(const TFormat& format) { m_Format = format; }
    void SetFormatGenbank(void) { m_Format = eFormat_GenBank;  }
    void SetFormatEMBL   (void) { m_Format = eFormat_EMBL;     }
    void SetFormatDDBJ   (void) { m_Format = eFormat_DDBJ;     }
    void SetFormatGBSeq  (void) { m_Format = eFormat_GBSeq;    }
    void SetFormatINSDSeq(void) { m_Format = eFormat_INSDSeq;  }
    void SetFormatFTable (void) { m_Format = eFormat_FTable;   }
    void SetFormatAGP    (void) { m_Format = eFormat_AGP;      }
    void SetFormatLite   (void) { m_Format = eFormat_Lite;     }

    // -- Mode
    // getters
    const TMode& GetMode(void) const { return m_Mode; }
    bool IsModeRelease(void) const { return m_Mode == eMode_Release; }
    bool IsModeEntrez (void) const { return m_Mode == eMode_Entrez;  }
    bool IsModeGBench (void) const { return m_Mode == eMode_GBench;  }
    bool IsModeDump   (void) const { return m_Mode == eMode_Dump;    }
    // setters
    void SetMode(const TMode& mode) { m_Mode = mode; }
    void SetModeRelease(void) { m_Mode = eMode_Release; }
    void SetModeEntrez (void) { m_Mode = eMode_Entrez;  }
    void SetModeGBench (void) { m_Mode = eMode_GBench;  }
    void SetModeDump   (void) { m_Mode = eMode_Dump;    }

    // -- Style
    // getters
    const TStyle& GetStyle(void) const { return m_Style; }
    bool IsStyleNormal (void) const { return m_Style == eStyle_Normal;  }
    bool IsStyleSegment(void) const { return m_Style == eStyle_Segment; }
    bool IsStyleMaster (void) const { return m_Style == eStyle_Master;  }
    bool IsStyleContig (void) const { return m_Style == eStyle_Contig;  }
    // setters
    void SetStyle(const TStyle& style) { m_Style = style;  }
    void SetStyleNormal (void) { m_Style = eStyle_Normal;  }
    void SetStyleSegment(void) { m_Style = eStyle_Segment; }
    void SetStyleMaster (void) { m_Style = eStyle_Master;  }
    void SetStyleContig (void) { m_Style = eStyle_Contig;  }

    // -- View
    // getters
    const TView& GetView(void) const { return m_View; }
    bool IsViewNuc (void) const { return (m_View & fViewNucleotides) != 0; }
    bool IsViewProt(void) const { return (m_View & fViewProteins)    != 0; }
    bool IsViewAll (void) const { return IsViewNuc()  &&  IsViewProt();    }
    bool IsViewFirst (void) const { return (m_View & fViewFirst) != 0; }
    // setters
    void SetView(const TView& view) { m_View = view; }
    inline void SetViewNuc (void)
    {
       m_View = (m_View & ~fViewAll) | fViewNucleotides;
    }
    inline void SetViewProt (void)
    {
       m_View = (m_View & ~fViewAll) | fViewProteins;
    }
    inline void SetViewAll (void)
    {
       m_View |= fViewAll;
    }
    inline void SetViewFirst (bool enabled)
    {
       if (enabled) {
           m_View |= fViewFirst;
       } else {
           m_View &= ~fViewFirst;
       }
    }

    // -- Policy
    // getters
    const TPolicy& GetPolicy(void) const { return m_Policy; }
    bool IsPolicyAdaptive (void) const { return m_Policy == ePolicy_Adaptive;  }
    bool IsPolicyInternal(void) const { return m_Policy == ePolicy_Internal; }
    bool IsPolicyExternal (void) const { return m_Policy == ePolicy_External;  }
    bool IsPolicyExhaustive (void) const { return m_Policy == ePolicy_Exhaustive;  }
    bool IsPolicyFtp (void) const { return m_Policy == ePolicy_Ftp;  }
    bool IsPolicyWeb (void) const { return m_Policy == ePolicy_Web;  }
    bool IsPolicyGenomes (void) const { return m_Policy == ePolicy_Genomes;  }
    // setters
    void SetPolicy(const TPolicy& Policy) { m_Policy = Policy;  }
    void SetPolicyAdaptive (void) { m_Policy = ePolicy_Adaptive;  }
    void SetPolicyInternal(void) { m_Policy = ePolicy_Internal; }
    void SetPolicyExternal (void) { m_Policy = ePolicy_External;  }
    void SetPolicyExhaustive (void) { m_Policy = ePolicy_Exhaustive;  }
    void SetPolicyFtp (void) { m_Policy = ePolicy_Ftp;  }
    void SetPolicyWeb (void) { m_Policy = ePolicy_Web;  }
    void SetPolicyGenomes (void) { m_Policy = ePolicy_Genomes;  }

    // -- Flags
    // getters
    const TFlags& GetFlags(void) const { return m_Flags; }
    // customizable flags
    bool DoHTML                (void) const;
    bool HideImpFeatures       (void) const;
    bool HideSNPFeatures       (void) const;
    bool HideExonFeatures      (void) const;
    bool HideIntronFeatures    (void) const;
    bool HideMiscFeatures      (void) const;
    bool HideRemoteImpFeatures (void) const;
    bool HideGeneRIFs          (void) const;
    bool OnlyGeneRIFs          (void) const;
    bool HideCDSProdFeatures   (void) const;
    bool HideCDDFeatures       (void) const;
    bool LatestGeneRIFs        (void) const;
    bool ShowContigFeatures    (void) const;
    bool ShowContigSources     (void) const;
    bool ShowContigAndSeq      (void) const;
    bool CopyGeneToCDNA        (void) const;
    bool ShowContigInMaster    (void) const;
    bool CopyCDSFromCDNA       (void) const;
    bool HideSourceFeatures    (void) const;
    bool AlwaysTranslateCDS    (void) const;
    bool OnlyNearFeatures      (void) const;
    bool FavorFarFeatures      (void) const;
    bool ShowFarTranslations   (void) const;
    bool TranslateIfNoProduct  (void) const;
    bool ShowTranscript        (void) const;
    bool ShowPeptides          (void) const;
    bool ShowFtableRefs        (void) const;
    bool OldFeaturesOrder      (void) const;
    bool HideGapFeatures       (void) const;
    bool NeverTranslateCDS     (void) const;
    bool ShowSeqSpans          (void) const;
    // mode dependant flags
    bool SuppressLocalId     (void) const;
    bool ValidateFeatures    (void) const;
    bool IgnorePatPubs       (void) const;
    bool DropShortAA         (void) const;
    bool AvoidLocusColl      (void) const;
    bool IupacaaOnly         (void) const;
    bool DropBadCitGens      (void) const;
    bool NoAffilOnUnpub      (void) const;
    bool DropIllegalQuals    (void) const;
    bool CheckQualSyntax     (void) const;
    bool NeedRequiredQuals   (void) const;
    bool NeedOrganismQual    (void) const;
    bool NeedAtLeastOneRef   (void) const;
    bool CitArtIsoJta        (void) const;
    bool DropBadDbxref       (void) const;
    bool UseEmblMolType      (void) const;
    bool HideBankItComment   (void) const;
    bool CheckCDSProductId   (void) const;
    bool FrequencyToNote     (void) const;
    bool SrcQualsToNote      (void) const;
    bool HideEmptySource     (void) const;
    bool GoQualsToNote       (void) const;
    bool SelenocysteineToNote(void) const;
    bool ForGBRelease        (void) const;
    bool HideUnclassPartial  (void) const;
    bool CodonRecognizedToNote(void) const;
    bool GoQualsEachMerge    (void) const;
    bool ShowOutOfBoundsFeats(void) const;
    bool HideSpecificGeneMaps(void) const;

    // setters (for customization flags)
    void SetFlags(const TFlags& flags) { m_Flags = flags; }
    CFlatFileConfig& SetDoHTML               (bool val = true);
    CFlatFileConfig& SetHideImpFeatures      (bool val = true);
    CFlatFileConfig& SetHideSNPFeatures      (bool val = true);
    CFlatFileConfig& SetHideExonFeatures     (bool val = true);
    CFlatFileConfig& SetHideIntronFeatures   (bool val = true);
    CFlatFileConfig& SetHideMiscFeatures     (bool val = true);
    CFlatFileConfig& SetHideRemoteImpFeatures(bool val = true);
    CFlatFileConfig& SetHideGeneRIFs         (bool val = true);
    CFlatFileConfig& SetOnlyGeneRIFs         (bool val = true);
    CFlatFileConfig& SetHideCDSProdFeatures  (bool val = true);
    CFlatFileConfig& SetHideCDDFeatures      (bool val = true);
    CFlatFileConfig& SetLatestGeneRIFs       (bool val = true);
    CFlatFileConfig& SetShowContigFeatures   (bool val = true);
    CFlatFileConfig& SetShowContigSources    (bool val = true);
    CFlatFileConfig& SetShowContigAndSeq     (bool val = true);
    CFlatFileConfig& SetCopyGeneToCDNA       (bool val = true);
    CFlatFileConfig& SetShowContigInMaster   (bool val = true);
    CFlatFileConfig& SetCopyCDSFromCDNA      (bool val = true);
    CFlatFileConfig& SetHideSourceFeatures   (bool val = true);
    CFlatFileConfig& SetAlwaysTranslateCDS   (bool val = true);
    CFlatFileConfig& SetOnlyNearFeatures     (bool val = true);
    CFlatFileConfig& SetFavorFarFeatures     (bool val = true);
    CFlatFileConfig& SetShowFarTranslations  (bool val = true);
    CFlatFileConfig& SetTranslateIfNoProduct (bool val = true);
    CFlatFileConfig& SetShowTranscript       (bool val = true);
    CFlatFileConfig& SetShowPeptides         (bool val = true);
    CFlatFileConfig& SetShowFtableRefs       (bool val = true);
    CFlatFileConfig& SetOldFeaturesOrder     (bool val = true);
    CFlatFileConfig& SetHideGapFeatures      (bool val = true);
    CFlatFileConfig& SetNeverTranslateCDS    (bool val = true);
    CFlatFileConfig& SetShowSeqSpans         (bool val = true);

    // -- Custom
    // getters
    const TCustom& GetCustom(void) const { return m_Custom; }
    bool HideProteinID         (void) const;
    bool HideGI                (void) const;
    bool LongLocusNames        (void) const;
    bool ExpandGaps            (void) const;
    bool ShowSNPFeatures       (void) const;
    bool ShowCDDFeatures       (void) const;
    bool ShowDebugTiming       (void) const;
    bool FasterReleaseSets     (void) const;
    bool DisableAnnotRefs      (void) const;
    bool UseSeqEntryIndexer    (void) const;
    bool UseAutoDef            (void) const;
    bool IgnoreExistingTitle   (void) const;
    bool GeneRNACDSFeatures    (void) const;
    bool ShowFtablePeptides    (void) const;
    bool DisableReferenceCache (void) const;
    bool ShowDeflineModifiers  (void) const;
    bool DoNotUseAutoDef       (void) const;
    bool OldTpaDisplay         (void) const;
    bool DisableDefaultIndex   (void) const;
    bool GeoLocNameCountry     (void) const;
    bool LeavePrefixSuffix     (void) const;

    // setters
    void SetCustom(const TCustom& custom) { m_Custom = custom; }
    CFlatFileConfig& SetHideProteinID         (bool val = true);
    CFlatFileConfig& SetHideGI                (bool val = true);
    CFlatFileConfig& SetLongLocusNames        (bool val = true);
    CFlatFileConfig& SetExpandGaps            (bool val = true);
    CFlatFileConfig& SetShowSNPFeatures       (bool val = true);
    CFlatFileConfig& SetShowCDDFeatures       (bool val = true);
    CFlatFileConfig& SetShowDebugTiming       (bool val = true);
    CFlatFileConfig& SetFasterReleaseSets     (bool val = true);
    CFlatFileConfig& SetDisableAnnotRefs      (bool val = true);
    CFlatFileConfig& SetUseSeqEntryIndexer    (bool val = true);
    CFlatFileConfig& SetUseAutoDef            (bool val = true);
    CFlatFileConfig& SetIgnoreExistingTitle   (bool val = true);
    CFlatFileConfig& SetGeneRNACDSFeatures    (bool val = true);
    CFlatFileConfig& SetShowFtablePeptides    (bool val = true);
    CFlatFileConfig& SetDisableReferenceCache (bool val = true);
    CFlatFileConfig& SetShowDeflineModifiers  (bool val = true);
    CFlatFileConfig& SetDoNotUseAutoDef       (bool val = true);
    CFlatFileConfig& SetOldTpaDisplay         (bool val = true);
    CFlatFileConfig& SetDisableDefaultIndex   (bool val = true);
    CFlatFileConfig& SetGeoLocNameCountry     (bool val = true);
    CFlatFileConfig& SetLeavePrefixSuffix     (bool val = true);

    // adjust mode dependant flags for RefSeq
    void SetRefSeqConventions(void);

    // -- Single Accession filter
    void SetSingleAccession(const string& accn) { m_SingleAccession = accn; }
    const string& GetSingleAccession(void) const { return m_SingleAccession; }

    int GetFeatDepth(void) const { return m_FeatDepth; }
    void SetFeatDepth(const int featDepth) { m_FeatDepth = featDepth; }

    int GetGapDepth(void) const { return m_GapDepth; }
    void SetGapDepth(const int gapDepth) { m_GapDepth = gapDepth; }


    void SetGenbankBlocks(const TGenbankBlocks& genbank_blocks)
    {
        m_fGenbankBlocks = genbank_blocks;
    };

    // check if the given section is shown
    bool IsShownGenbankBlock(FGenbankBlocks fTGenbankBlocksMask) const
    {
        return m_fGenbankBlocks & fTGenbankBlocksMask;
    }

    // set the given section to be shown
    void ShowGenbankBlock(FGenbankBlocks fTGenbankBlocksMask)
    {
        m_fGenbankBlocks |= (fTGenbankBlocksMask);
    }

    // set the given section to be skipped
    // (that is, not shown or even processed)
    void SkipGenbankBlock(FGenbankBlocks fTGenbankBlocksMask)
    {
        m_fGenbankBlocks &= (~fTGenbankBlocksMask);
    }

    // throws on error
    static FGenbankBlocks StringToGenbankBlock(const string & str);
    // returns the set of all possible genbank strings
    // "head, "locus", etc.  Guaranteed to be sorted.
    static const vector<string> & GetAllGenbankStrings(void);

    // return non-const callback even if the CFlatFileConfig is const
    CRef<CGenbankBlockCallback> GetGenbankBlockCallback(void) const {
        return m_GenbankBlockCallback; }
    void SetGenbankBlockCallback(CGenbankBlockCallback* pGenbankBlockCallback) {
        m_GenbankBlockCallback = pGenbankBlockCallback;
    }

    const ICanceled * GetCanceledCallback(void) const {
        return m_pCanceledCallback;
    }
    void SetCanceledCallback(ICanceled * pCallback) {
        m_pCanceledCallback = pCallback;
    }

    // -- BasicCleanup
    // getters
    bool BasicCleanup(void) const { return m_BasicCleanup; }
    // setters
    void BasicCleanup(bool clean) { m_BasicCleanup = clean; }

    /// This throws a CFlatException if
    /// flatfile generation cancellation has been requested via ICanceled.
    void ThrowIfCanceled(void) const {
        if( m_pCanceledCallback && m_pCanceledCallback->IsCanceled() ) {
            // halt requested, so throw the appropriate exception
            x_ThrowHaltNow();
        }
    }

    // options to share between applications related to flatfile
    static void AddArgumentDescriptions(CArgDescriptions& args);
    void FromArguments(const CArgs& args);

public:
    static const size_t SMARTFEATLIMIT = 1000000;

private:
    // mode specific flags
    static const bool sm_ModeFlags[4][32];

    void x_ThrowHaltNow(void) const;

    // data
    TFormat     m_Format;
    TMode       m_Mode;
    TStyle      m_Style;
    TFlags      m_Flags;  // custom flags
    TView       m_View;
    TPolicy     m_Policy;
    bool        m_RefSeqConventions;
    TGenbankBlocks m_fGenbankBlocks;
    CRef<CGenbankBlockCallback> m_GenbankBlockCallback;
    const ICanceled * m_pCanceledCallback; // instance does NOT own it
    bool        m_BasicCleanup;
    TCustom     m_Custom;
    int         m_FeatDepth;
    int         m_GapDepth;
    string      m_SingleAccession;
    CRef<IHTMLFormatter> m_html_formatter;
};


/////////////////////////////////////////////////////////////////////////////
// inilne methods

// custom flags
#define FLAG_ARG_GET(x) \
inline \
bool CFlatFileConfig::x(void) const \
{ \
    return (m_Flags & f##x) != 0; \
}

#define FLAG_ARG_SET(x) inline \
CFlatFileConfig& CFlatFileConfig::Set##x(bool val) \
{ \
    if ( val ) { \
        m_Flags |= f##x; \
    } else { \
        m_Flags &= ~f##x; \
    } \
    return *this; \
}

#define FLAG_ARG_IMP(x) \
FLAG_ARG_GET(x) \
FLAG_ARG_SET(x)

FLAG_ARG_IMP(DoHTML)
FLAG_ARG_IMP(HideImpFeatures)
FLAG_ARG_IMP(HideSNPFeatures)
FLAG_ARG_IMP(HideExonFeatures)
FLAG_ARG_IMP(HideIntronFeatures)
FLAG_ARG_IMP(HideMiscFeatures)
FLAG_ARG_IMP(HideRemoteImpFeatures)
FLAG_ARG_IMP(HideGeneRIFs)
FLAG_ARG_IMP(OnlyGeneRIFs)
FLAG_ARG_IMP(HideCDSProdFeatures)
FLAG_ARG_IMP(HideCDDFeatures)
FLAG_ARG_IMP(LatestGeneRIFs)
FLAG_ARG_IMP(ShowContigFeatures)
FLAG_ARG_IMP(ShowContigSources)
FLAG_ARG_IMP(ShowContigAndSeq)
FLAG_ARG_IMP(CopyGeneToCDNA)
FLAG_ARG_IMP(ShowContigInMaster)
FLAG_ARG_IMP(CopyCDSFromCDNA)
FLAG_ARG_IMP(HideSourceFeatures)
FLAG_ARG_IMP(AlwaysTranslateCDS)
FLAG_ARG_IMP(OnlyNearFeatures)
FLAG_ARG_IMP(FavorFarFeatures)
FLAG_ARG_IMP(ShowFarTranslations)
FLAG_ARG_IMP(TranslateIfNoProduct)
FLAG_ARG_IMP(ShowTranscript)
FLAG_ARG_IMP(ShowPeptides)
FLAG_ARG_IMP(ShowFtableRefs)
FLAG_ARG_IMP(OldFeaturesOrder)
FLAG_ARG_IMP(HideGapFeatures)
FLAG_ARG_IMP(NeverTranslateCDS)
FLAG_ARG_IMP(ShowSeqSpans)

// custom flags
#define CUSTOM_ARG_GET(x) \
inline \
bool CFlatFileConfig::x(void) const \
{ \
    return (m_Custom & f##x) != 0; \
}

#define CUSTOM_ARG_SET(x) inline \
CFlatFileConfig& CFlatFileConfig::Set##x(bool val) \
{ \
    if ( val ) { \
        m_Custom |= f##x; \
    } else { \
        m_Custom &= ~f##x; \
    } \
    return *this; \
}

#define CUSTOM_ARG_IMP(x) \
CUSTOM_ARG_GET(x) \
CUSTOM_ARG_SET(x)

CUSTOM_ARG_IMP(HideProteinID)
CUSTOM_ARG_IMP(HideGI)
CUSTOM_ARG_IMP(LongLocusNames)
CUSTOM_ARG_IMP(ExpandGaps)
CUSTOM_ARG_IMP(ShowSNPFeatures)
CUSTOM_ARG_IMP(ShowCDDFeatures)
CUSTOM_ARG_IMP(ShowDebugTiming)
CUSTOM_ARG_IMP(FasterReleaseSets)
CUSTOM_ARG_IMP(DisableAnnotRefs)
CUSTOM_ARG_IMP(UseSeqEntryIndexer)
CUSTOM_ARG_IMP(UseAutoDef)
CUSTOM_ARG_IMP(IgnoreExistingTitle)
CUSTOM_ARG_IMP(GeneRNACDSFeatures)
CUSTOM_ARG_IMP(ShowFtablePeptides)
CUSTOM_ARG_IMP(DisableReferenceCache)
CUSTOM_ARG_IMP(ShowDeflineModifiers)
CUSTOM_ARG_IMP(DoNotUseAutoDef)
CUSTOM_ARG_IMP(OldTpaDisplay)
CUSTOM_ARG_IMP(DisableDefaultIndex)
CUSTOM_ARG_IMP(GeoLocNameCountry)
CUSTOM_ARG_IMP(LeavePrefixSuffix)

#undef FLAG_ARG_IMP
#undef FLAG_ARG_GET
#undef FLAG_ARG_SET

#undef CUSTOM_ARG_IMP
#undef CUSTOM_ARG_GET
#undef CUSTOM_ARG_SET

inline
void CFlatFileConfig::SetRefSeqConventions(void)
{
    m_RefSeqConventions = true;
}

// end of inline methods
/////////////////////////////////////////////////////////////////////////////

END_SCOPE(objects)
END_NCBI_SCOPE

#endif  /* OBJTOOLS_FORMAT___FLAT_FILE_CONFIG__HPP */
