ezc/src/generator.h

/*
 * This file is a part of EZC -- Easy templating in C++ library
 * and is distributed under the 2-Clause BSD licence.
 * Author: Tomasz Sowa <t.sowa@ttmath.org>
 */

/* 
 * Copyright (c) 2007-2024, Tomasz Sowa
 * All rights reserved.
 * 
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 * 1. Redistributions of source code must retain the above copyright notice,
 * this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright
 * notice, this list of conditions and the following disclaimer in the
 * documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 *
 */


#ifndef headerfile_ezc_generator
#define headerfile_ezc_generator

#include <sstream>
#include <fstream>
#include <vector>
#include "blocks.h"
#include "pattern.h"
#include "functions.h"
#include "objects.h"
#include "outstreams.h"
#include "expressionparser.h"
#include "models.h"
#include "log/log.h"
#include "utf8/utf8.h"



#ifdef EZC_HAS_MORM_LIBRARY
#include "model.h"
#endif

namespace Ezc
{



/*
StreamType
 we use only method write(const wchar_t * str, size_t len) from the stream
*/
template<class StreamType, bool is_pikotools_stream = false, bool is_autoescape_stream = false>
class Generator
{
public:

	Generator();
	Generator(const Generator & n);
	Generator & operator=(const Generator & n);
	~Generator();

	void SetPattern(Pattern & pattern);
	void SetBlocks(Blocks & blocks);
	void SetFunctions(Functions<StreamType> & functions);
	void SetObjects(Objects<StreamType> & objects);
	void SetVariables(Vars & variables); // [def] and [let]

	void SetLogger(pt::Log & logger);

#ifdef EZC_HAS_MORM_LIBRARY
	void SetModels(Models & models);
#endif

	void SetMax(size_t max_items_, size_t max_for_items_);

	// recognizing some special characters in text patterns (item_text in Patterns)
	// \r will be a carriage return (13)
	// \n will be a new line (10)
	// \t will be a tabulator (9)
	// \s will be a space
	// \\ will be one '\'
	// if the second character is different from those shown above the first slash will be printed
	// so "\x" gives "\x"
	// default: false
	void RecognizeSpecialChars(bool spec);

	// trimming white characters (at the beginning and at the end of an item_text)
	// (special char \s if enabled is not treated as a white character here)
	// default: false 
	void TrimWhite(bool trim);

	// skipping new line characters (from the whole string in an item_text)
	// but you can use a new line character written as "\n" (if special chars are turn on)
	// default: false
	void SkipNewLine(bool skip);

	// default: 20
	void SetMaxFilters(size_t new_len);

	// default stack size: 300
	void SetStackSize(size_t new_stack_size);

	// set whether or not we can use cache for functions or blocks
	// true by default
	void CanUseCache(bool can_use_cache);

	// set whether or not we can use variables: [def ...] statement
	// true by default
	void CanUseVars(bool can_use_variables);

	void SetProgramMode(bool program_mode);

	void SetExpressionParser(ExpressionParser * expression_parser);

	// some optimization when generating the output
	// if provided frames then only such frames will be generated
	// call OnlyFrames(nullptr) to disable it (default)
	void OnlyFrames(const std::vector<std::wstring> & frames);
	void OnlyFrames(const std::vector<std::wstring> * frames);

	// some optimization when generating the output
	// whether or not the main stream should be produced (true by default)
	void UseMainStream(bool use_main_stream);

	// the main methods for generating
	void Generate(StreamType & out);
	void Generate(StreamType & out, OutStreams<StreamType, is_pikotools_stream> & out_streams);
	void Generate(OutStreams<StreamType, is_pikotools_stream> & out_streams);



private:
	

	struct FindHelper
	{
		std::wstring * fun_name;

		BaseObj<StreamType> * base_obj;
		int method_index;
		typename Functions<StreamType>::UserFunction * function;
		Item * item_block;
		Var * variable;

	#ifdef EZC_HAS_MORM_LIBRARY
		morm::Wrapper * wrapper;
		size_t field_index;
	#endif

		FindHelper()
		{
			fun_name = nullptr;

			base_obj = nullptr;
			method_index = -1;
			function = nullptr;
			item_block = nullptr;
			variable = nullptr;

#ifdef EZC_HAS_MORM_LIBRARY
			wrapper = nullptr;
			field_index = 0;
#endif
		}
	};


	struct BlockStack
	{
		std::vector<Var> args;
		StreamType * out_stream;
		bool was_return;
	};

	std::vector<BlockStack> block_stack_tab;
	size_t block_stack_index;
	size_t block_stack_size;

	// current output stream (can be null)
	// at the beginning it is pointing to the main stream (to the StreamType argument passsed to Generate method)
	StreamType * output_stream;

	Pattern    * ppattern;
	Blocks     * pblocks;
	Functions<StreamType> * pfunctions;
	Objects<StreamType> * pobjects;
#ifdef EZC_HAS_MORM_LIBRARY
	Models * pmodels;
#endif
	Vars * pvars;

	pt::Log * plog;

	// pointer to the output streams map (can be null)
	// output stream will be created when [ezc frame "stream_name"] statement is found
	OutStreams<StreamType, is_pikotools_stream> * output_frames_streams;

	// temporary error messages
	std::wstring temp_msg;

	bool break_generating;
	size_t current_item;
	size_t max_items;
	size_t max_for_items;
	bool special_chars;
	bool trim_white;
	bool skip_new_line;

	size_t ezc_frames_stack_index;
	size_t ezc_frames_stack_size;

	size_t stack_index;
	size_t stack_size;

	size_t filter_index;
	size_t filter_size;
	// we have to use a pointers table because standard streams such
	// as std::wostringstream are not copyable
	std::vector<StreamType*> filter_tab;
	std::vector<StreamType*> ezc_frame_stack_tab;
	const StreamType empty_stream;

	// temporary streams used in [if..] [for...] or [def ...]
	// or if output_stream is null and an ezc function should be called
	StreamType stream_temp1, stream_temp_define;

	// last result from a user function (FunInfo::res)
	bool last_res;

	// true if this Generator is working now
	bool is_generator_working;

	// true if the Generator is working with [for ...], [if ...] etc.
	bool is_generating_for;
	bool is_generating_if;
	bool is_generating_if_def;
	bool is_generating_if_not_def;
	bool is_generating_normal;
	bool is_generating_filter;

	// an empty string for FunInfo objects
	// when there is no any parameters
	const std::wstring empty;

	// a stack for [for] statements
	std::vector<Stack> stack_tab;

	bool can_use_vars;
	bool can_find_in_cache;
	bool program_mode;

	const std::vector<std::wstring> * only_frames;
	bool is_output_stream_allowed;
	bool use_main_stream;

	ExpressionParser * expression_parser;


	void ResizeStreamStack(std::vector<StreamType*> & stream_tab, size_t stream_tab_max_size);
	void ResizeFilterTab();
	void ResizeStack();
	void ResizeBlockStack();
	void ResizeEzcFrameStack();

	void ClearStreamStack(std::vector<StreamType*> & stream_tab);
	void ClearFilterTab();
	void ClearForStack();
	void ClearBlockStack();
	void ClearEzcFrameTab();

	void ClearStream(StreamType & str);
	void CopyStreamToString(StreamType & src_stream, std::wstring & dst_string);
	void CopyStream(StreamType & src_stream, StreamType & dst_stream);
	void CopyStream(pt::WTextStream & src_stream, StreamType & dst_stream, bool should_escape);


	void RemoveStackFunData(Stack & sitem);

	bool ConvertToBool(const std::wstring & str);

	template<class CharType>
	CharType ToLower(CharType c);

	bool IsTestingFunctionExistence();

	bool CheckBlockArgument(int arg_index, FindHelper & find_helper);

	bool FindInCache(Item::Function & item_fun, FindHelper & find_helper);

#ifdef EZC_HAS_MORM_LIBRARY
	bool FindInModels(FindHelper & find_helper);
#endif

	bool FindInFunctionsAndBlocks(const std::wstring & name, FindHelper & find_helper);
	bool FindInVariables(const std::wstring & name, FindHelper & find_helper);
	bool Find(Item::Function & item_fun, FindHelper & find_helper);

	void PrepareEnvStruct(FunInfo<StreamType> & info);

	void CallFunction(typename Functions<StreamType>::UserFunction & function, FunInfo<StreamType> & info);

	void CallFunction(typename Functions<StreamType>::UserFunction & function,
					  std::vector<Var> & parameters,
					  StreamType & out_stream,
					  const StreamType & in_stream);

	bool CallBlock(Item & item_block,
				   std::vector<Var> & parameters,
				   StreamType & out_stream);

	void CallObject(BaseObj<StreamType> & base_obj, int method_index, FunInfo<StreamType> & info);

	void PrintDate(pt::Date * date, std::vector<Var> & parameters, StreamType & out_stream);
	bool PrintDatePart(pt::Date * date, const std::wstring & field, std::vector<Var> & parameters, StreamType & out_stream);

	bool CallDate(FindHelper & find_helper, std::vector<std::wstring> & fields, std::vector<Var> & parameters, StreamType & out_stream);

	void PrintLastSpaceField(pt::Space * space, std::vector<Var> & parameters, StreamType & out_stream);
	void CallSpaceObjectForLastField(std::vector<Var> & parameters, StreamType & out_stream, pt::Space * space);
	pt::Space * CallSpaceObjectForMiddleField(std::wstring & root_space_name, std::vector<std::wstring> & fields, size_t field_index, pt::Space * space);

	void CallSpaceTableForLastField(morm::SpaceWrapper & space_wrapper, std::vector<Var> & parameters, StreamType & out_stream,
									pt::Space * space, size_t model_wrapper_space_table_index);

	pt::Space * CallSpaceTableForMiddleField(morm::SpaceWrapper & space_wrapper, std::wstring & root_space_name, std::vector<std::wstring> & fields,
											 size_t field_index, pt::Space * space, size_t model_wrapper_space_table_index);

	bool CallSpace(FindHelper & find_helper, std::vector<std::wstring> & fields, std::vector<Var> & parameters, StreamType & out_stream);

#ifdef EZC_HAS_MORM_LIBRARY
	bool CallModelField(morm::Model & model, const std::wstring & field, std::vector<Var> & parameters, StreamType & out_stream, const StreamType & in_stream);
	bool CallModel(morm::Model & model, FindHelper & find_helper, std::vector<std::wstring> & fields, std::vector<Var> & parameters, StreamType & out_stream, const StreamType & in_stream);
	void FindLastModelWrapper(FindHelper & find_helper, std::vector<std::wstring> & fields);
	bool CallWrapper(FindHelper & find_helper, std::vector<std::wstring> & fields, std::vector<Var> & parameters, StreamType & out_stream, const StreamType & in_stream);
#endif

	void CallObject(BaseObj<StreamType> & base_obj,
					int method_index,
					std::vector<Var> & parameters,
					StreamType & out_stream,
					const StreamType & in_stream);

	bool CallVariable(Item::Function & item_fun,
					  Var & variable,
					  std::vector<Var> & parameters,
					  StreamType & out_stream,
					  const StreamType & in_stream);

	bool Call(Item::Function & item_fun,
			  std::wstring * fun_name,
			  StreamType & out_stream,
			  bool clear_out_stream,
			  const StreamType & in_stream);

	bool Call(Item::Function & item_fun);

	wchar_t CreateSpecialChar(wchar_t c);
	const wchar_t * PrintSpecialChar(const wchar_t * start, const wchar_t * end);
	void PrintSpecialText(const wchar_t * start, const wchar_t * end);
	void PrintNormalText(const wchar_t * start, const wchar_t * end);
	bool IsWhite(wchar_t c);
	void TrimWhite(const wchar_t *& start, const wchar_t *& end);
	void SkipWhite(const wchar_t *& str);
	size_t StrToSize(const wchar_t * str, const wchar_t ** str_end = 0);

	bool HasParam(std::vector<Var> & parameters, const wchar_t * param1, const wchar_t * param2 = nullptr);
	bool ShouldMakeSpaceDump(std::vector<Var> & parameters);
	bool ShouldMakeJsonDump(std::vector<Var> & parameters);
	bool IsPrettyPrint(std::vector<Var> & parameters);

	void DumpSpaceIfNeeded(std::vector<Var> & parameters, StreamType & out_stream, pt::Space * space);
	void DumpModelIfNeeded(morm::Model & model, std::vector<Var> & parameters, StreamType & out_stream);

	StreamType * FindAddOutputStream(const std::wstring & name);
	void CopyTmpStreamToOutputStreams(Item::Function & fun, StreamType & ezc_out_tmp_stream);

	void CreateMsg(const wchar_t * type, const std::wstring & model_name, std::vector<std::wstring> & fields, size_t how_many_fields_print,
				   const wchar_t * arg = nullptr, const wchar_t * arg2 = nullptr, const wchar_t * arg3 = nullptr);

	void CreateMsg(const wchar_t * type, const std::wstring & model_name, std::vector<std::wstring> & fields,
				   const wchar_t * arg = nullptr, const wchar_t * arg2 = nullptr, const wchar_t * arg3 = nullptr);

	void CreateMsg(const wchar_t * type, const wchar_t * arg = nullptr);
	void CreateMsg(const std::wstring & type, const std::wstring & arg);
	void CreateMsg(const std::wstring & type);

	bool LimitAchieved();

	void EvaluateProgramNode(Item & item);
	bool HasAskForSuchFrame(Item::Function & fun);
	bool HasAskForSuchFrame(const std::wstring & name);

	StreamType * GetNewStreamForFrame();
	void DecrementFramesStackIndex();

	void MakeTextIf_go(Item & item, bool result);
	void MakeTextIf(Item & item);
	void MakeTextIfDef(Item & item);
	void MakeTextIfNotDef(Item & item);
	void MakeTextFor(Item & item);
	void MakeItemText(Item & item);
	void MakeTextContainer(Item & item);
	void MakeTextFunction(Item & item);
	void MakeTextDefine(Item & item, Var & var);
	void MakeTextDefine(Item & item);
	void MakeTextDefineIfNotSet(Item & item);
	void MakeTextLet(Item & item, Var & var);
	void MakeTextLet(Item & item);
	void MakeTextLetIfNotSet(Item & item);
	void MakeTextFilter(Item & item);
	void MakeTextEzc(Item & item);
	void MakeTextReturn(Item & item);
	void MakeText(Item & item);
	void MakeEzcFrame2(Item & item);
	void MakeEzcFrame(Item & item);

	void Generate();



}; // class Generator






template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::Generator() : empty_stream()
{
	ppattern      = nullptr;
	pblocks       = nullptr;
	pfunctions    = nullptr;
	pobjects      = nullptr;
	pvars         = nullptr;
	plog          = nullptr;

#ifdef EZC_HAS_MORM_LIBRARY
	pmodels       = nullptr;
#endif

	max_items     = 50000;
	max_for_items = 5000;
	filter_size   = 20;
	special_chars = false;
	trim_white    = false;
	skip_new_line = false;
	is_generator_working = false;
	stack_size    = 300;
	block_stack_size = 64;
	ezc_frames_stack_size = 16;
	can_find_in_cache = true;
	can_use_vars = true;
	expression_parser = nullptr;
	program_mode = false;
	only_frames  = nullptr;
	is_output_stream_allowed = true;
	use_main_stream = true;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::Generator(const Generator<StreamType, is_pikotools_stream, is_autoescape_stream> & n)
{
	operator=(n);
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
Generator<StreamType, is_pikotools_stream, is_autoescape_stream> &
Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::operator=(const Generator<StreamType, is_pikotools_stream, is_autoescape_stream> & n)
{
	ppattern       = n.ppattern;
	pblocks        = n.pblocks;
	pfunctions     = n.pfunctions;
	pobjects       = n.pobjects;
	pvars          = n.pvars;
	plog           = n.plog;

#ifdef EZC_HAS_MORM_LIBRARY
	pmodels        = n.pmodels;
#endif

	max_items      = n.max_items;
	max_for_items  = n.max_for_items;
	special_chars  = n.special_chars;
	trim_white     = n.trim_white;
	skip_new_line  = n.skip_new_line;
	can_find_in_cache = n.can_find_in_cache;
	can_use_vars   = n.can_use_vars;

	// filter, stack and block_stack will be auto resized when calling Generate() method
	filter_size      = n.filter_size;
	stack_size       = n.stack_size;
	block_stack_size = n.block_stack_size;
	ezc_frames_stack_size = n.ezc_frames_stack_size;
	expression_parser= n.expression_parser;
	program_mode     = n.program_mode;
	only_frames      = n.only_frames;
	is_output_stream_allowed   = n.is_output_stream_allowed;
	use_main_stream  = n.use_main_stream;

	// vars doesn't have to be copied

	// don't copy filter tab
	// don't copy stack
	// don't copy ezc_frame_stack_tab
	// don't copy output_stream and output_frames_streams

	// !! CHECK ME
	// may copying should be denied when generator is working?
	// don't copy 'is_generator_working' flag
	is_generator_working = false;

return *this;
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::~Generator()
{
	ClearFilterTab();
	ClearForStack();
	ClearBlockStack();
	ClearEzcFrameTab();
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::SetPattern(Pattern & pattern)
{
	ppattern = &pattern;
}




template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::SetBlocks(Blocks & blocks)
{
	pblocks = &blocks;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::SetFunctions(Functions<StreamType> & functions)
{
	pfunctions = &functions;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::SetObjects(Objects<StreamType> & objects)
{
	pobjects = &objects;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::SetVariables(Vars & variables)
{
	pvars = &variables;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::SetLogger(pt::Log & logger)
{
	plog = &logger;
}



#ifdef EZC_HAS_MORM_LIBRARY
template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::SetModels(Models & models)
{
	pmodels = &models;
}
#endif

template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CanUseCache(bool can_use_cache)
{
	can_find_in_cache = can_use_cache;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CanUseVars(bool can_use_variables)
{
	can_use_vars = can_use_variables;
}

template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::SetProgramMode(bool set_program_mode)
{
	this->program_mode = set_program_mode;
}

template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::SetExpressionParser(ExpressionParser * expression_parser)
{
	this->expression_parser = expression_parser;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::OnlyFrames(const std::vector<std::wstring> & frames)
{
	this->only_frames = &frames;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::OnlyFrames(const std::vector<std::wstring> * frames)
{
	this->only_frames = frames;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::UseMainStream(bool use_main_stream)
{
	this->use_main_stream = use_main_stream;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::ResizeStack()
{
	if( stack_tab.size() != stack_size )
	{
		if( stack_tab.size() > stack_size )
		{
			for(size_t i=stack_size ; i<stack_tab.size() ; ++i)
				RemoveStackFunData(stack_tab[i]);
		}

		stack_tab.resize(stack_size);
	}
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::ResizeStreamStack(std::vector<StreamType*> & stream_tab, size_t stream_tab_max_size)
{
	if( stream_tab.size() != stream_tab_max_size )
	{
		if( stream_tab.size() < stream_tab_max_size )
		{
			size_t i = stream_tab.size();
			stream_tab.resize(stream_tab_max_size);

			for( ; i<stream_tab.size() ; ++i)
				stream_tab[i] = new StreamType();
		}
		else
		{
			for(size_t i=stream_tab_max_size ; i<stream_tab.size() ; ++i)
				delete stream_tab[i];
			
			stream_tab.resize(stream_tab_max_size);
		}
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::ResizeFilterTab()
{
	ResizeStreamStack(filter_tab, filter_size);
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::ResizeEzcFrameStack()
{
	ResizeStreamStack(ezc_frame_stack_tab, ezc_frames_stack_size);
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::ResizeBlockStack()
{
	if( block_stack_tab.size() != block_stack_size )
	{
		if( block_stack_tab.size() < block_stack_size )
		{
			size_t i = block_stack_tab.size();
			block_stack_tab.resize(block_stack_size);

			for( ; i<block_stack_tab.size() ; ++i)
				block_stack_tab[i].out_stream = new StreamType();
		}
		else
		{
			for(size_t i=block_stack_size ; i<block_stack_tab.size() ; ++i)
				delete block_stack_tab[i].out_stream;
			
			block_stack_tab.resize(block_stack_size);
		}
	}
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::ClearStreamStack(std::vector<StreamType*> & stream_tab)
{
	for(size_t i=0 ; i<stream_tab.size() ; ++i)
		delete stream_tab[i];
	
	stream_tab.clear();
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::ClearFilterTab()
{
	ClearStreamStack(filter_tab);
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::ClearEzcFrameTab()
{
	ClearStreamStack(ezc_frame_stack_tab);
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::ClearBlockStack()
{
	for(size_t i=0 ; i<block_stack_tab.size() ; ++i)
		delete block_stack_tab[i].out_stream;

	block_stack_tab.clear();
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::ClearForStack()
{
	for(size_t i=0 ; i<stack_tab.size() ; ++i)
		RemoveStackFunData(stack_tab[i]);
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::ClearStream(StreamType & str)
{
	if constexpr(is_pikotools_stream)
	{
		str.clear();
	}
	else
	{
		str.str(L"");
	}
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CopyStreamToString(StreamType & src_stream, std::wstring & dst_string)
{
	if constexpr (sizeof(wchar_t) == sizeof(typename StreamType::char_type))
	{
		if constexpr(is_pikotools_stream)
		{
			src_stream.to_str(dst_string);
		}
		else
		{
			dst_string = src_stream.str();
		}
	}
	else
	{
		if constexpr(is_pikotools_stream)
		{
			src_stream.to_str(dst_string);
		}
		else
		{
			std::string tmp = src_stream.str();
			pt::utf8_to_wide(tmp, dst_string);
		}
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CopyStream(StreamType & src_stream, StreamType & dst_stream)
{
	if constexpr(is_pikotools_stream)
	{
		dst_stream << src_stream;
	}
	else
	{
		dst_stream << src_stream.str();
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CopyStream(pt::WTextStream & src_stream, StreamType & dst_stream, bool should_escape)
{
	if constexpr(is_autoescape_stream)
	{
		dst_stream.Escape(should_escape);
		dst_stream << src_stream;
	}
	else
	{
		if constexpr(is_pikotools_stream)
		{
			dst_stream << src_stream;
		}
		else
		{
			if constexpr(sizeof(char) == sizeof(typename StreamType::char_type))
			{
				wide_stream_to_utf8(src_stream, dst_stream, false);
			}
			else
			{
				dst_stream << src_stream.to_str();
			}
		}
	}
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::RemoveStackFunData(Stack & s)
{
	if( s.fun_data && s.auto_remove )
	{
		delete s.fun_data;
		s.fun_data = 0;
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
template<class CharType>
CharType Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::ToLower(CharType c)
{
	if( c>='A' && c<='Z' )
		return c - 'A' + 'a';

return c;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::ConvertToBool(const std::wstring & str)
{
	return !str.empty();
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::SetMax(size_t max_items_, size_t max_for_items_)
{
	max_items     = max_items_;
	max_for_items = max_for_items_;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::RecognizeSpecialChars(bool spec)
{
	special_chars = spec;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::TrimWhite(bool trim)
{
	trim_white = trim;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::SkipNewLine(bool skip)
{
	skip_new_line = skip;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::SetMaxFilters(size_t new_len)
{
	// the table will be resized when Generate() method is called
	filter_size = new_len;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::SetStackSize(size_t new_stack_size)
{
	// the stack will be resized when Generate() method is called
	stack_size = new_stack_size;
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::Generate()
{
	if( is_generator_working )
	{
		CreateMsg(L"generator busy");
		return;
	}

	break_generating = false;
	current_item     = 0;

	// in the case that there something has left on the stack
	// from previous call to Generate()
	// (an exception could have been thrown)
	ClearForStack();

	ResizeFilterTab();
	ResizeStack();
	ResizeBlockStack();
	ResizeEzcFrameStack();
	filter_index = 0;
	stack_index  = 0;
	ezc_frames_stack_index = 0;
	is_output_stream_allowed = use_main_stream;
	block_stack_index = 0;

	if( ppattern )
	{
		try
		{
			is_generator_working = true;
			MakeText( ppattern->item_root );
			// !! IMPROVE ME we can print an error message if the stacks are not empty
			// (some [end] statements has been omited)
			is_generator_working = false;
		}
		catch(...)
		{
			is_generator_working = false;
			throw;
		}
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::Generate(StreamType & out)
{
	output_stream = &out;
	output_frames_streams = nullptr;
	Generate();
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::Generate(StreamType & out, OutStreams<StreamType, is_pikotools_stream> & out_streams)
{
	output_stream = &out;
	output_frames_streams = &out_streams;
	Generate();
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::Generate(OutStreams<StreamType, is_pikotools_stream> & out_streams)
{
	output_stream = nullptr;
	output_frames_streams = &out_streams;
	Generate();
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::IsTestingFunctionExistence()
{
	return is_generating_if_def || is_generating_if_not_def;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CheckBlockArgument(int arg_index, FindHelper & find_helper)
{
	if( arg_index < 0 )
		return false;

	// it's a numeric function -- an argument to a block e.g.: [1]
	if( block_stack_index > 0 )
	{
		BlockStack & block_stack = block_stack_tab[block_stack_index-1];

		if( size_t(arg_index) < block_stack.args.size() )
		{
			find_helper.variable = &block_stack.args[arg_index];
			return true;
		}
	}

	return false;
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::FindInCache(Item::Function & item_fun, FindHelper & find_helper)
{
	if( can_find_in_cache )
	{
		if( item_fun.base_obj )
		{
			find_helper.base_obj = reinterpret_cast<BaseObj<StreamType> * >(item_fun.base_obj);
			find_helper.method_index = item_fun.method_index;
			return true;
		}

		if( item_fun.fun_cache )
		{
			find_helper.function = reinterpret_cast<typename Functions<StreamType>::UserFunction*>(item_fun.fun_cache);
			return true;
		}

		if( item_fun.item_block )
		{
			find_helper.item_block = item_fun.item_block;
			return true;
		}
	}

return false;
}



#ifdef EZC_HAS_MORM_LIBRARY

template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::FindInModels(FindHelper & find_helper)
{
	if( pmodels )
	{
		morm::Wrapper * m = pmodels->Find(*find_helper.fun_name);

		if( m )
		{
			find_helper.wrapper = m;
			return true;
		}
	}

	return false;
}

#endif


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::FindInFunctionsAndBlocks(const std::wstring & name, FindHelper & find_helper)
{
	if( pobjects )
	{
		typename Objects<StreamType>::Iterator i = pobjects->Find(name, find_helper.method_index);

		if( i != pobjects->End() )
		{
			find_helper.base_obj = *i;
			return true;
		}
	}

	if( pfunctions )
	{
		typename Functions<StreamType>::Iterator i = pfunctions->Find(name);

		if( i != pfunctions->End() )
		{
			find_helper.function = &i->second;
			return true;
		}
	}

	if( pblocks )
	{
		Blocks::Iterator i = pblocks->Find(name);

		if( i != pblocks->End() )
		{
			find_helper.item_block = &i->second;
			return true;
		}
	}

return false;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::FindInVariables(const std::wstring & name, FindHelper & find_helper)
{
	if( pvars )
	{
		Vars::iterator i = pvars->find(name);

		if( i != pvars->end() )
		{
			find_helper.variable = &(i->second);
			return true;
		}
	}

	return false;
}



/*
 * fun_name can be null, it is used only with [let ...] statements
 * and if not null then means: as a funcion name we are not using item_fun.name but fun_name
 */
template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::Find(Item::Function & item_fun, FindHelper & find_helper)
{
	if( CheckBlockArgument(item_fun.arg, find_helper) )
		return true;

	#ifdef EZC_HAS_MORM_LIBRARY
		if( FindInModels(find_helper) )
			return true;

		if( !item_fun.fields.empty() && !IsTestingFunctionExistence() )
		{
			CreateMsg(L"unknown model", find_helper.fun_name->c_str());
			return false;
		}

	#endif

	if( FindInCache(item_fun, find_helper) )
		return true;

	if( FindInFunctionsAndBlocks(*find_helper.fun_name, find_helper) )
		return true;

	if( FindInVariables(*find_helper.fun_name, find_helper) )
		return true;

	if( !IsTestingFunctionExistence() )
		CreateMsg(L"unknown function", find_helper.fun_name->c_str());

	return false;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::PrepareEnvStruct(FunInfo<StreamType> & info)
{
	info.Clear();

	info.is_for        = is_generating_for;
	info.is_if         = is_generating_if;
	info.is_if_def     = is_generating_if_def;
	info.is_if_not_def = is_generating_if_not_def;
	info.is_normal     = is_generating_normal;
	info.is_filter     = is_generating_filter;
	info.iter          = info.stack.iter;
	info.stack_tab     = stack_tab.data();
	info.stack_index   = stack_index-1;
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CallFunction(typename Functions<StreamType>::UserFunction & function, FunInfo<StreamType> & info)
{
	PrepareEnvStruct(info);
	(function)(info);
	last_res = info.res;
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CallFunction(typename Functions<StreamType>::UserFunction & function,
										 std::vector<Var> & parameters,
										 StreamType & out_stream,
										 const StreamType & in_stream)
{
	if( !IsTestingFunctionExistence() )
	{
		if( parameters.empty() )
		{
			FunInfo<StreamType> info(out_stream, parameters, empty, in_stream, stack_tab[stack_index-1], *stack_tab[stack_index-1].item);
			CallFunction(function, info);
		}
		else
		{
			FunInfo<StreamType> info(out_stream, parameters, parameters[0].str, in_stream, stack_tab[stack_index-1], *stack_tab[stack_index-1].item);
			CallFunction(function, info);
		}
	}
}




template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CallObject(BaseObj<StreamType> & base_obj, int method_index, FunInfo<StreamType> & info)
{
	PrepareEnvStruct(info);
	base_obj.CallFun(method_index, info);
	last_res = info.res;
}




template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::HasParam(std::vector<Var> & parameters, const wchar_t * param1, const wchar_t * param2)
{
	for(Var & var : parameters)
	{
		if( !var.is_function )
		{
			if( var.str == param1 || (param2 && var.str == param2) )
			{
				return true;
			}
		}
	}

	return false;
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::ShouldMakeSpaceDump(std::vector<Var> & parameters)
{
	return HasParam(parameters, L"dump", L"dump_to_space");
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::ShouldMakeJsonDump(std::vector<Var> & parameters)
{
	return HasParam(parameters, L"dump_to_json");
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::IsPrettyPrint(std::vector<Var> & parameters)
{
	return HasParam(parameters, L"pretty");
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::DumpSpaceIfNeeded(std::vector<Var> & parameters, StreamType & out_stream, pt::Space * space)
{
	bool dump_space = ShouldMakeSpaceDump(parameters);
	bool dump_json = ShouldMakeJsonDump(parameters);

	if( dump_space || dump_json )
	{
		bool pretty = IsPrettyPrint(parameters);

		if( dump_space )
		{
			space->serialize_to_space_stream(out_stream, pretty);
		}
		else
		if( dump_json )
		{
			space->serialize_to_json_stream(out_stream, pretty);
		}
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::DumpModelIfNeeded(morm::Model & model, std::vector<Var> & parameters, StreamType & out_stream)
{
	bool dump_space = ShouldMakeSpaceDump(parameters);
	bool dump_json = ShouldMakeJsonDump(parameters);

	if( dump_space || dump_json )
	{
		//bool pretty = IsPrettyPrint(parameters);

		if( dump_space )
		{
			// not implemented yet
		}
		else
		if( dump_json )
		{
			// IMPLEMENT ME
			// depends on the model_connector (flat connector)
			// need to be made in a different way
			pt::TextStream temp_str;
			model.to_text(temp_str, false, false);
			out_stream << temp_str;
		}
	}
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::PrintDate(pt::Date * date, std::vector<Var> & parameters, StreamType & out_stream)
{
	bool is_roman = HasParam(parameters, L"roman");
	bool is_no_sec = HasParam(parameters, L"no_sec");
	bool only_date = HasParam(parameters, L"only_date");
	bool only_time = HasParam(parameters, L"only_time");

	if( only_date )
	{
		date->SerializeYearMonthDay(out_stream, is_roman);
	}
	else
	if( only_time )
	{
		if( is_no_sec )
			date->SerializeHourMin(out_stream);
		else
			date->SerializeHourMinSec(out_stream);
	}
	else
	{
		date->Serialize(out_stream, is_roman, !is_no_sec);
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::PrintDatePart(pt::Date * date, const std::wstring & field, std::vector<Var> & parameters, StreamType & out_stream)
{
	bool is_test = IsTestingFunctionExistence();

	if( field == L"year" )
	{
		if( !is_test )
			out_stream << date->year;
	}
	else
	if( field == L"month" )
	{
		if( !is_test )
		{
			bool is_roman = HasParam(parameters, L"roman");

			if( is_roman )
				pt::Date::SerializeMonthAsRoman(out_stream, date->month);
			else
				out_stream << date->month;
		}
	}
	else
	if( field == L"day" )
	{
		if( !is_test )
			out_stream << date->day;
	}
	else
	if( field == L"hour" )
	{
		if( !is_test )
			out_stream << date->hour;
	}
	else
	if( field == L"min" )
	{
		if( !is_test )
			out_stream << date->min;
	}
	else
	if( field == L"sec" )
	{
		if( !is_test )
			out_stream << date->sec;
	}
	else
	{
		return false;
	}

	return true;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CallDate(FindHelper & find_helper, std::vector<std::wstring> & fields, std::vector<Var> & parameters, StreamType & out_stream)
{
	bool found = true;
	bool all_fields_known = (find_helper.field_index == fields.size());
	bool last_field_not_known = (find_helper.field_index + 1 == fields.size());

	if( all_fields_known )
	{
		PrintDate(find_helper.wrapper->date, parameters, out_stream);
	}
	else
	if( last_field_not_known )
	{
		if( !PrintDatePart(find_helper.wrapper->date, fields[find_helper.field_index], parameters, out_stream) )
		{
			if( !IsTestingFunctionExistence() )
			{
				CreateMsg(L"cannot find ", *find_helper.fun_name, fields, L", unknown property ", fields[find_helper.field_index].c_str(), L" of date object");
			}

			found = false;
		}
	}
	else
	{
		if( !IsTestingFunctionExistence() )
		{
			CreateMsg(L"cannot find ", *find_helper.fun_name, fields, L", ", fields[find_helper.field_index].c_str(), L" is not a model nor a model container nor a space");
		}

		found = false;
	}

	return found;
}




template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CallSpaceObjectForLastField(std::vector<Var> & parameters, StreamType & out_stream, pt::Space * space)
{
	if( IsTestingFunctionExistence() )
	{
		last_res = true;
	}
	else
	{
		DumpSpaceIfNeeded(parameters, out_stream, space);
		last_res = space->object_size() > 0;
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
pt::Space * Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CallSpaceObjectForMiddleField(std::wstring & root_space_name, std::vector<std::wstring> & fields, size_t field_index, pt::Space * space)
{
	std::wstring & next_field = fields[field_index];
	space = space->get_space(next_field);

	if( !space && !IsTestingFunctionExistence() )
	{
		CreateMsg(L"cannot find space field: ", root_space_name, fields, field_index + 1);
	}

	return space;
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CallSpaceTableForLastField(
	morm::SpaceWrapper & space_wrapper, std::vector<Var> & parameters, StreamType & out_stream,	pt::Space * space, size_t model_wrapper_space_table_index)
{
	pt::Space::TableType * table = space->get_table();

	if( is_generating_for )
	{
		// we are in [for...]statement, increment iterator and check the range
		space_wrapper.increment_iterator(model_wrapper_space_table_index, table->size());
		space_wrapper.invalidate_iterators(model_wrapper_space_table_index + 1);
		size_t iterator_value = space_wrapper.get_space_iterator_value(model_wrapper_space_table_index);
		last_res = (iterator_value < table->size());
	}
	else
	{
		// we are not in [for..], it can be for example [if...], return true if the table is not empty
		if( IsTestingFunctionExistence() )
		{
			last_res = true;
		}
		else
		{
			last_res = !table->empty();
		}
	}

	if( !IsTestingFunctionExistence() )
	{
		DumpSpaceIfNeeded(parameters, out_stream, space);

		if( HasParam(parameters, L"index") )
		{
			out_stream << space_wrapper.get_space_iterator_value(model_wrapper_space_table_index);
		}

		if( HasParam(parameters, L"index-one") )
		{
			out_stream << (space_wrapper.get_space_iterator_value(model_wrapper_space_table_index) + 1);
		}
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
pt::Space * Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CallSpaceTableForMiddleField(morm::SpaceWrapper & space_wrapper, std::wstring & root_space_name, std::vector<std::wstring> & fields,
																size_t field_index, pt::Space * space, size_t model_wrapper_space_table_index)
{
	pt::Space::TableType * table = space->get_table();

	// check the current iterator, if it is correct then select the item from the table
	size_t iterator_value = space_wrapper.get_space_iterator_value(model_wrapper_space_table_index);

	if( iterator_value < table->size() )
	{
		space = (*table)[iterator_value];
	}
	else
	{
		// this message can be print even for [if-def...]
		CreateMsg(L"space table: ", root_space_name, fields, field_index, L" is not initialized, have you forgotten to use [for...] statement?");
		space = nullptr;
	}

	return space;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::PrintLastSpaceField(pt::Space * space, std::vector<Var> & parameters, StreamType & out_stream)
{
	bool no_escape = HasParam(parameters, L"raw", L"noescape");

	if( no_escape )
	{
		pt::WTextStream str;
		space->serialize_to_string(str);
		CopyStream(str, out_stream, false);
	}
	else
	{
		space->serialize_to_string(out_stream);
	}
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CallSpace(FindHelper & find_helper, std::vector<std::wstring> & fields, std::vector<Var> & parameters, StreamType & out_stream)
{
	morm::SpaceWrapper * space_wrapper = find_helper.wrapper->space_wrapper;
	pt::Space * space = space_wrapper->get_space();
	last_res = false;
	size_t field_index = find_helper.field_index;
	size_t model_wrapper_space_table_index = 0;

	/*
	 *
	 * we are iterating through such objects:
	 * [root_space, fields[field_index], fields[field_index+1], fields[field_index+2], fields[field_index+3] ...]
	 * the first item is the root_space with a find_helper.fun_name name
	 *
	 */
	while( (field_index < fields.size() + 1) && space )
	{
		bool is_last_field = (field_index == fields.size());

		if( space->is_object() )
		{
			if( is_last_field )
			{
				CallSpaceObjectForLastField(parameters, out_stream, space);
			}
			else
			{
				space = CallSpaceObjectForMiddleField(*find_helper.fun_name, fields, field_index, space);
			}

			field_index += 1;
		}
		else
		if( space->is_table() )
		{
			if( model_wrapper_space_table_index < space_wrapper->space_indices_table_size() )
			{
				if( is_last_field )
				{
					CallSpaceTableForLastField(*space_wrapper, parameters, out_stream, space, model_wrapper_space_table_index);
					field_index += 1;
				}
				else
				{
					space = CallSpaceTableForMiddleField(*space_wrapper, *find_helper.fun_name, fields, field_index, space, model_wrapper_space_table_index);
					// increment field_index only if next_field is 'this' and space is not an object

					if( space && !space->is_object() )
					{
						std::wstring & next_field = fields[field_index];

						if( next_field == L"this" )
						{
							field_index += 1;
						}
					}
				}
			}
			else
			{
				CreateMsg(L"", *find_helper.fun_name, fields, field_index, L" exceeded the maximum number of fields for a space object");
				space = nullptr;
			}
		}
		else
		{
			if( is_last_field )
			{
				if( IsTestingFunctionExistence() )
				{
					last_res = true;
				}
				else
				{
					PrintLastSpaceField(space, parameters, out_stream);
					last_res = space->to_bool();
				}

				field_index += 1;
			}
			else
			{
				if( !IsTestingFunctionExistence() )
				{
					CreateMsg(L"", *find_helper.fun_name, fields, field_index, L" of a space is not an object nor a table");
				}

				space = nullptr;
			}
		}

		model_wrapper_space_table_index += 1;
	}

	return space != nullptr;
}



#ifdef EZC_HAS_MORM_LIBRARY

template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CallModelField(
			morm::Model & model, const std::wstring & field, std::vector<Var> & parameters, StreamType & out_stream, const StreamType & in_stream)
{
	/*
	 * if 'field' is a POD type then 'str' will be used in get_raw_value()
	 * if 'field' is a getter method with pt::Stream then 'str' will be used too
	 * if 'field' is a getter method which takes FunInfo<> then out_stream will be used and 'str' will be empty
	 *
	 */
	pt::WTextStream str;
	bool found = false;

	if( parameters.empty() )
	{
		FunInfo<StreamType> info(out_stream, parameters, empty, in_stream, stack_tab[stack_index-1], *stack_tab[stack_index-1].item);
		PrepareEnvStruct(info);
		found = model.get_raw_value(nullptr, field.c_str(), nullptr, info, str, false);
		last_res = info.res;
	}
	else
	{
		FunInfo<StreamType> info(out_stream, parameters, parameters[0].str, in_stream, stack_tab[stack_index-1], *stack_tab[stack_index-1].item);
		PrepareEnvStruct(info);
		found = model.get_raw_value(nullptr, field.c_str(), nullptr, info, str, false);
		last_res = info.res;
	}

	if( found && !str.empty())
	{
		bool no_escape = HasParam(parameters, L"raw", L"noescape");
		CopyStream(str, out_stream, !no_escape);
	}

	return found;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CallModel(morm::Model & model, FindHelper & find_helper, std::vector<std::wstring> & fields,
									  std::vector<Var> & parameters, StreamType & out_stream, const StreamType & in_stream)
{
	bool found = true;

	if( find_helper.field_index == fields.size() )
	{
		// all fields items are models or models containers
		// at the moment we do not set last_res
		// we don't know whether the last object has properties (fields) or not
		if( !IsTestingFunctionExistence() )
		{
			DumpModelIfNeeded(model, parameters, out_stream);
		}
	}
	else
	if( find_helper.field_index + 1 == fields.size() )
	{
		// last field is not a model nor a models container
		if( !CallModelField(model, fields[find_helper.field_index], parameters, out_stream, in_stream) )
		{
			if( !IsTestingFunctionExistence() )
			{
				CreateMsg(L"cannot find ", *find_helper.fun_name, fields, L", unknown property ", fields[find_helper.field_index].c_str(), L" of a model object");
			}

			found = false;
		}
	}
	else
	{
		if( !IsTestingFunctionExistence() )
		{
			CreateMsg(L"cannot find ", *find_helper.fun_name, fields, L", ", fields[find_helper.field_index].c_str(), L" is not a model nor a model container nor a space");
		}

		found = false;
	}

	return found;
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::FindLastModelWrapper(FindHelper & find_helper, std::vector<std::wstring> & fields)
{
	for(find_helper.field_index = 0 ; find_helper.field_index < fields.size() && find_helper.wrapper->has_model_object() ; ++find_helper.field_index)
	{
		std::wstring & field = fields[find_helper.field_index];
		morm::Wrapper * child_wrapper = find_helper.wrapper->find_child(field);

		if( !child_wrapper )
		{
			morm::Model * model = nullptr;

			if( find_helper.wrapper->model )
			{
				model = find_helper.wrapper->model;
			}
			else
			if( find_helper.wrapper->model_container_wrapper )
			{
				model = find_helper.wrapper->model_container_wrapper->get_model();
				// this can return null for lists/vectors in a case when the iterator is not pointing to a valid item
			}

			if( model )
			{
				morm::Wrapper new_wrapper = model->get_wrapper(nullptr, field.c_str());

				if( new_wrapper.has_object() )
				{
					child_wrapper = find_helper.wrapper->add_child(field, new_wrapper);
				}
			}
		}

		if( !child_wrapper )
			break;

		find_helper.wrapper = child_wrapper;
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CallWrapper(FindHelper & find_helper, std::vector<std::wstring> & fields,
										   std::vector<Var> & parameters, StreamType & out_stream, const StreamType & in_stream)
{
	bool found = true;
	last_res = false;
	FindLastModelWrapper(find_helper, fields);

	// if:
	// helper.field_index == fields.size()    - all fields items are either models, models containers, space or a date
	// helper.field_index == fields.size()-1  - only the last field is not known
	// helper.field_index < fields.size()-1   - there are more not known fields

	bool all_fields_known = (find_helper.field_index == fields.size());
	bool last_field_not_known = (find_helper.field_index + 1 == fields.size());

	if( find_helper.wrapper->space_wrapper )
	{
		found = CallSpace(find_helper, fields, parameters, out_stream);
	}

	if( find_helper.wrapper->date )
	{
		found = CallDate(find_helper, fields, parameters, out_stream);
	}

	if( find_helper.wrapper->model )
	{
		found = CallModel(*find_helper.wrapper->model, find_helper, fields, parameters, out_stream, in_stream);
	}

	if( find_helper.wrapper->model_container_wrapper )
	{
		morm::Model * model = find_helper.wrapper->model_container_wrapper->get_model();

		if( model )
		{
			found = CallModel(*model, find_helper, fields, parameters, out_stream, in_stream);
		}
		else
		{
			if( last_field_not_known )
			{
				// can be printed even for [if-def...]
				CreateMsg(L"model ", *find_helper.fun_name, fields, L" is not initialized, have you forgotten to use [for ...] statement?");
				found = false;
			}
		}

		if( all_fields_known )
		{
			if( is_generating_for )
			{
				find_helper.wrapper->model_container_wrapper->increment_iterator();
				find_helper.wrapper->clear_childs();
				last_res = find_helper.wrapper->model_container_wrapper->is_iterator_correct();
			}
			else
			{
				// for [if-def...] last_res will be set later
				last_res = !find_helper.wrapper->model_container_wrapper->is_container_empty();
			}
		}
	}

	return found;
}

#endif



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CallObject(BaseObj<StreamType> & base_obj,
										int method_index,
										std::vector<Var> & parameters,
										StreamType & out_stream,
										const StreamType & in_stream)
{
	if( !IsTestingFunctionExistence() )
	{
		if( parameters.empty() )
		{
			FunInfo<StreamType> info(out_stream, parameters, empty, in_stream, stack_tab[stack_index-1], *stack_tab[stack_index-1].item);
			CallObject(base_obj, method_index, info);
		}
		else
		{
			FunInfo<StreamType> info(out_stream, parameters, parameters[0].str, in_stream, stack_tab[stack_index-1], *stack_tab[stack_index-1].item);
			CallObject(base_obj, method_index, info);
		}
	}
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CallBlock(Item & item_block,
									  std::vector<Var> & parameters,
									  StreamType & out_stream)
{
	if( block_stack_index >= block_stack_tab.size() )
	{
		CreateMsg(L"Generator exceeded allowed number of blocks");
		return false;
	}

	if( !IsTestingFunctionExistence() )
	{
		StreamType * old_stream = output_stream;
		BlockStack & block_stack = block_stack_tab[block_stack_index];

		block_stack.was_return = false;
		block_stack.args = parameters;

		output_stream = block_stack.out_stream;
		ClearStream(*output_stream);
		block_stack_index += 1;

		MakeText(item_block);

		CopyStream(*output_stream, out_stream);
		// last_res is set by [return ...] statement or other last evaluated function

		ClearStream(*output_stream);
		output_stream = old_stream;
		block_stack_index -= 1;
	}

return true;
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CallVariable(Item::Function & item_fun, Var & variable, std::vector<Var> & parameters, StreamType & out_stream, const StreamType & in_stream)
{
	if( variable.is_function )
	{
		return Call(item_fun, &variable.str, out_stream, false, in_stream);
	}
	else
	{
		if( !IsTestingFunctionExistence() )
		{
			out_stream << variable.str;
			last_res = variable.res;
		}

		return true;
	}
}


/*
 * fun_name can be null, it is used only with [let ...] statements
 * and if not null then means: as a funcion name we are not using item_fun.name but fun_name
 *
 * return: true if a function, variable or block was found and called (evaluated)
 */
template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::Call(Item::Function & item_fun,
								 std::wstring * fun_name,
								 StreamType & out_stream,
								 bool clear_out_stream,
								 const StreamType & in_stream)
{
FindHelper find_helper;
std::vector<Var> parameters;

	if( clear_out_stream )
		ClearStream(out_stream);

	if constexpr(is_autoescape_stream)
		out_stream.Escape(true);

	find_helper.fun_name = fun_name;

	if( !find_helper.fun_name )
		find_helper.fun_name = &item_fun.name;

	if( !Find(item_fun, find_helper) )
		return false;

	parameters.resize(item_fun.parameters.size());

	for(size_t i=0 ; i<item_fun.parameters.size() ; ++i)
	{
		Item::Function & fun_child = *item_fun.parameters[i];

		if( fun_child.is_function )
		{
			StreamType local_temp_stream;
			Call(fun_child, nullptr, local_temp_stream, true, empty_stream);

			CopyStreamToString(local_temp_stream, parameters[i].str);
			parameters[i].res = last_res;
		}
		else
		{
			parameters[i].str = fun_child.name;
			parameters[i].res = ConvertToBool(fun_child.name);
		}
	}

#ifdef EZC_HAS_MORM_LIBRARY
	if( find_helper.wrapper )
		return CallWrapper(find_helper, item_fun.fields, parameters, out_stream, in_stream);
	else
#endif
	if( find_helper.base_obj )
		CallObject(*find_helper.base_obj, find_helper.method_index, parameters, out_stream, in_stream);
	else
	if( find_helper.function )
		CallFunction(*find_helper.function, parameters, out_stream, in_stream);
	else
	if( find_helper.item_block )
		return CallBlock(*find_helper.item_block, parameters, out_stream);
	else
	if( find_helper.variable )
		return CallVariable(item_fun, *find_helper.variable, parameters, out_stream, in_stream);

	return true;
}



// return: true if a function or variable was found and called
template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::Call(Item::Function & item_fun)
{
	bool status = Call(item_fun, nullptr, stream_temp1, true, empty_stream);
	ClearStream(stream_temp1);
	return status;
}




template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
wchar_t Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CreateSpecialChar(wchar_t c)
{
wchar_t res = 0;

	if( c == 'r' )
		res = '\r';
	else
	if( c == 'n' )
		res = '\n';
	else
	if( c == 't' )
		res = '\t';
	else
	if( c == 's' )
		res = ' ';
	else
	if( c == '\\' )
		res = '\\';

return res;
}



// a special character is precedeed by a slash '\'
// if the special character is unknown the first slash is printing
// so "\t" gives one character of code 9
// and "\x" gives "\x" 
template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
const wchar_t * Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::PrintSpecialChar(const wchar_t * start, const wchar_t * end)
{
wchar_t special = 0;

	if( *start == '\\' && (start+1) != end )
		special = CreateSpecialChar(*(start+1));

	if( special )
	{
		output_stream->write(&special, 1);
		start += 2;
	}
	else
	{
		if( !skip_new_line || *start != 10 )
			output_stream->write(start, 1);

		start += 1;
	}

return start;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::PrintSpecialText(const wchar_t * start, const wchar_t * end)
{
	if( output_stream )
	{
		while( start != end )
		{
			const wchar_t * end2 = start;

			// looking for a first new line character or a special char
			// (for new line only if skip_new_line is true)
			while( end2 != end && *end2 != '\\' && (!skip_new_line || *end2 != 10) )
				end2 += 1;

			// printing the first part of the text
			if( start != end2 )
				output_stream->write(start, end2 - start);

			start = end2;
			
			// skipping one or more new line characters or special chars
			// (new lines only if skip_new_line is true)
			while( start != end && (*start == '\\' || (skip_new_line && *start == 10)) )
				start = PrintSpecialChar(start, end);
		}
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::PrintNormalText(const wchar_t * start, const wchar_t * end)
{
	if( output_stream )
	{
		if( skip_new_line )
		{
			while( start != end )
			{
				const wchar_t * end2 = start;

				// looking for a first new line character
				while( end2 != end && *end2 != 10 )
					end2 += 1;

				// printing the first part of the text (until the new line)
				if( start != end2 )
					output_stream->write(start, end2 - start);

				start = end2;
				
				// skipping one or more new line characters
				while( start != end && *start == 10 )
					start += 1;
			}
		}
		else
		{
			if( start != end )
				output_stream->write(start, end - start);
		}
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::IsWhite(wchar_t c)
{
	// 13 (\r) is from a dos file at the end of a line (\r\n)
	// 160 is a non-breaking space

	if( c==' ' || c=='\t' || c==13 || c==160 || c==10 )
		return true;

return false;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::TrimWhite(const wchar_t *& start, const wchar_t *& end)
{
	while( start != end && IsWhite(*start) )
		++start;

	while( start != end && IsWhite(*(end-1)) )
		--end;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::SkipWhite(const wchar_t *& str)
{
	while( IsWhite(*str) )
		str += 1;
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
size_t Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::StrToSize(const wchar_t * str, const wchar_t ** str_end)
{
size_t res = 0;

	SkipWhite(str);

	// !! IMPROVE ME
	// overflow is not checked

	while( *str>='0' && *str<='9' )
	{
		res *= 10;
		res += *str - '0';
		str += 1;
	}

	SkipWhite(str);

	if( str_end )
		*str_end = str;

return res;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
StreamType * Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::FindAddOutputStream(const std::wstring & name)
{
	StreamType * stream = nullptr;

	if( output_frames_streams )
	{
		auto imap = output_frames_streams->streams_map.find(name);

		if( imap == output_frames_streams->streams_map.end() )
		{
			if( output_frames_streams->streams_map.size() < output_frames_streams->streams_tab.size() )
			{
				/* a new stream from the pool (output_stream_tab) is taken */
				stream = output_frames_streams->streams_tab[output_frames_streams->streams_map.size()];
				output_frames_streams->streams_map.insert(std::make_pair(name, stream));
				ClearStream(*stream);
			}
			else
			{
				CreateMsg(L"limit of output streams in OutStreams<> has been reached");
			}
		}
		else
		{
			stream = imap->second;
		}
	}

	return stream;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CopyTmpStreamToOutputStreams(Item::Function & fun, StreamType & ezc_out_tmp_stream)
{
	if( output_frames_streams )
	{
		for(size_t s=0 ; s < fun.parameters.size() ; ++s)
		{
			std::wstring & name = fun.parameters[s]->name;

			if( HasAskForSuchFrame(name) )
			{
				StreamType * stream = FindAddOutputStream(name);

				if( stream )
				{
					CopyStream(ezc_out_tmp_stream, *stream);
				}
			}
		}
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CreateMsg(const wchar_t * type, const wchar_t * arg)
{
	if( plog )
	{
		(*plog) << pt::Log::log2 << "Ezc: " << type;

		if( arg )
		{
			(*plog) << ' ' << arg;
		}

		(*plog) << pt::Log::logend;
	}
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CreateMsg(const wchar_t * type, const std::wstring & model_name, std::vector<std::wstring> & fields, size_t how_many_fields_print,
									  const wchar_t * arg, const wchar_t * arg2, const wchar_t * arg3)
{
	if( plog )
	{
		(*plog) << pt::Log::log2 << L"Ezc: " << type << model_name;

		for(size_t i=0 ; i < how_many_fields_print && i < fields.size() ; ++i)
		{
			(*plog) << '.' << fields[i];
		}

		if( arg )
		{
			(*plog) << arg;
		}

		if( arg2 )
		{
			(*plog) << arg2;
		}

		if( arg3 )
		{
			(*plog) << arg3;
		}

		(*plog) << pt::Log::logend;
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CreateMsg(const wchar_t * type, const std::wstring & model_name, std::vector<std::wstring> & fields,
									  const wchar_t * arg, const wchar_t * arg2, const wchar_t * arg3)
{

	CreateMsg(type, model_name, fields, fields.size(), arg, arg2, arg3);
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CreateMsg(const std::wstring & type, const std::wstring & arg)
{
	CreateMsg(type.c_str(), arg.c_str());
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::CreateMsg(const std::wstring & type)
{
	CreateMsg(type.c_str());
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::EvaluateProgramNode(Item & item)
{
	if( output_stream )
	{
		if( item.type == Item::item_function )
			*output_stream << " expression: " << item.text;

		if( item.type == Item::item_if )
			*output_stream << " if: " << item.text;

		if( item.type == Item::item_for )
			*output_stream << " for: " << item.text;
	}

	last_res = false;

	if( expression_parser )
	{
		if( expression_parser->Parse(item.text) )
		{
			last_res = expression_parser->LastResultToBool();

			if( output_stream )
			{
				*output_stream << " -> " << expression_parser->LastResult();
			}
		}
		else
		{
			if( output_stream )
			{
				*output_stream << " -> syntax error when evaluating expression: error code: " << (int)expression_parser->LastError();
			}
		}
	}

	if( output_stream )
	{
		*output_stream << "\n";
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::HasAskForSuchFrame(Item::Function & fun)
{
	if( only_frames )
	{
		for(size_t s=0 ; s < fun.parameters.size() ; ++s)
		{
			std::wstring & name = fun.parameters[s]->name;

			for(size_t f=0 ; f < only_frames->size() ; ++f)
			{
				const std::wstring & frame = (*only_frames)[f];

				if( name == frame )
					return true;
			}
		}

		return false;
	}
	else
	{
		return true;
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::HasAskForSuchFrame(const std::wstring & name)
{
	if( only_frames )
	{
		for(size_t f=0 ; f < only_frames->size() ; ++f)
		{
			const std::wstring & frame = (*only_frames)[f];

			if( name == frame )
				return true;
		}

		return false;
	}
	else
	{
		return true;
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeItemText(Item & item)
{
	if( is_output_stream_allowed )
	{
		const wchar_t * start = item.text.c_str();
		const wchar_t * end   = item.text.c_str() + item.text.size();

		if( trim_white )
			TrimWhite(start, end);

		if( special_chars )
			PrintSpecialText(start, end);
		else
			PrintNormalText(start, end);
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeTextContainer(Item & item)
{
	std::vector<Item*>::iterator i = item.item_tab.begin();

	for( ; i != item.item_tab.end() && !break_generating ; ++i )
		MakeText(**i);
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeTextFunction(Item & item)
{
	is_generating_normal = true;

	if( program_mode )
	{
		EvaluateProgramNode(item);
	}
	else
	{
		if( output_stream && is_output_stream_allowed )
		{
			Call(item.function, nullptr, *output_stream, false, empty_stream);
		}
		else
		{
			Call(item.function, nullptr, stream_temp1, false, empty_stream);
			ClearStream(stream_temp1);
		}
	}
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeTextIf_go(Item & item, bool result)
{
	if( result )
	{
		if( item.item_tab.size() > 0 )
			MakeText( *item.item_tab[0] );
	}
	else
	{
		// second element can be (or not -- it's from [else])
		if( item.item_tab.size() > 1 )
			MakeText( *item.item_tab[1] );
	}
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeTextIf(Item & item)
{
	is_generating_if = true;

	if( program_mode )
	{
		EvaluateProgramNode(item);
	}
	else
	{
		if( !Call(item.function) )
			return;
	}

	MakeTextIf_go(item, last_res);
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeTextIfDef(Item & item)
{
	is_generating_if_def = true;

	if( program_mode )
	{
		//CHECKME
		//EvaluateProgramNode(item);
	}
	else
	{
		last_res = Call(item.function);
	}

	MakeTextIf_go(item, last_res);
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeTextIfNotDef(Item & item)
{
	is_generating_if_not_def = true;

	if( program_mode )
	{
		//CHECKME
		//EvaluateProgramNode(item);
	}
	else
	{
		last_res = !Call(item.function);
	}

	MakeTextIf_go(item, last_res);
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeTextFor(Item & item)
{
	stack_tab[stack_index-1].is_for = true;

	for( ; !break_generating ; stack_tab[stack_index-1].iter += 1 )
	{
		if( stack_tab[stack_index-1].iter >= max_for_items )
		{
			CreateMsg(item.function.name.c_str(),
					  L"function exceeded a limit for a [for] statement");	
			break;
		}

		// is_generating_for will be changed by next call to MakeText()
		// so we should set it in each iterations
		is_generating_for = true;

		if( program_mode )
		{
			EvaluateProgramNode(item);
		}
		else
		{
			if( !Call(item.function, nullptr, stream_temp1, true, empty_stream) )
				return;
		}

		if( !last_res )
			break;

		if( !item.item_tab.empty() )
			MakeText( *item.item_tab[0] ); // should be only one item
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeTextDefine(Item & item, Var & var)
{
	var.str.clear();
	var.res = ConvertToBool(var.str);
	var.is_function = false;

	if( item.function.parameters.empty() )
	{
		return;
	}

	if( item.function.parameters.size() > 1 )
	{
		CreateMsg(L"[def] can have only one parameter");
		return;
	}

	Item::Function & fun = *item.function.parameters[0];

	if( fun.is_function )
	{
		// call function
		if( Call(fun, nullptr, stream_temp_define, true, empty_stream) )
		{
			CopyStreamToString(stream_temp_define, var.str);
			var.res = last_res;
		}
		else
		{
			CreateMsg(L"[def] unknown function/block/variable", item.function.name);
		}
	}
	else
	{
		var.str = fun.name;
		var.res = ConvertToBool(fun.name);
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeTextDefine(Item & item)
{
	if( !can_use_vars || !pvars )
	{
		CreateMsg(L"[def] statement not available");
		return;
	}

	Var & var = (*pvars)[item.function.name];
	MakeTextDefine(item, var);
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeTextDefineIfNotSet(Item & item)
{
	if( !can_use_vars || !pvars )
	{
		CreateMsg(L"[def?] statement not available");
		return;
	}

	Vars::iterator vi = pvars->find(item.function.name);

	if( vi == pvars->end() )
	{
		Var & var = (*pvars)[item.function.name];
		MakeTextDefine(item, var);
	}
}




template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeTextLet(Item & item, Var & var)
{
	var.str.clear();
	var.res = ConvertToBool(var.str);
	var.is_function = true;

	if( item.function.parameters.empty() )
	{
		var.is_function = false;
		return;
	}

	if( item.function.parameters.size() > 1 )
	{
		CreateMsg(L"[let] can have only one parameter");
		return;
	}

	Item::Function & fun = *item.function.parameters[0];
	var.str = fun.name;
	var.is_function = fun.is_function;

	if( !fun.is_function )
	{
		var.res = ConvertToBool(var.str);
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeTextLet(Item & item)
{
	if( !can_use_vars || !pvars )
	{
		CreateMsg(L"[let] statement not available");
		return;
	}

	Var & var = (*pvars)[item.function.name];
	MakeTextLet(item, var);
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeTextLetIfNotSet(Item & item)
{
	if( !can_use_vars || !pvars )
	{
		CreateMsg(L"[let?] statement not available");
		return;
	}

	Vars::iterator vi = pvars->find(item.function.name);

	if( vi == pvars->end() )
	{
		Var & var = (*pvars)[item.function.name];
		MakeTextLet(item, var);
	}
}



template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeTextFilter(Item & item)
{
	if( filter_index >= filter_tab.size() )
	{
		CreateMsg(L"Generator exceeded allowed number of filters");
		return;
	}
	
	StreamType * old_stream = output_stream;
	output_stream = filter_tab[filter_index];
	ClearStream(*output_stream);

	filter_index += 1;

	if( !item.item_tab.empty() )
		MakeText( *item.item_tab[0] ); // should be only one item - item_container

	is_generating_filter = true;

	if( old_stream && is_output_stream_allowed )
	{
		Call(item.function, nullptr, *old_stream, false, *output_stream);
	}
	else
	{
		Call(item.function, nullptr, stream_temp1, true, *output_stream);
		ClearStream(stream_temp1);
	}

	ClearStream(*output_stream);
	output_stream = old_stream;
	filter_index -= 1;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
StreamType * Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::GetNewStreamForFrame()
{
	if( ezc_frames_stack_index >= ezc_frame_stack_tab.size() )
	{
		CreateMsg(L"Generator exceeded allowed number of [ezc frame] statements");
		return nullptr;
	}

	StreamType * stream = ezc_frame_stack_tab[ezc_frames_stack_index];
	ClearStream(*stream);
	ezc_frames_stack_index += 1;

	return stream;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::DecrementFramesStackIndex()
{
	if( ezc_frames_stack_index > 0 )
	{
		ezc_frames_stack_index -= 1;
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeEzcFrame2(Item & item)
{
	StreamType * old_stream = output_stream;
	bool old_is_output_stream_allowed = is_output_stream_allowed;
	bool put_directly = false;
	bool is_current_frame_allowed = HasAskForSuchFrame(item.function);

	if( !is_output_stream_allowed && is_current_frame_allowed )
	{
		is_output_stream_allowed = true;
	}

	if( !old_is_output_stream_allowed && is_current_frame_allowed && item.function.parameters.size() == 1)
	{
		/*
		 * some optimization, put directly to the frame stream
		 */
		put_directly = true;
		output_stream = FindAddOutputStream(item.function.parameters[0]->name);
	}
	else
	if( old_is_output_stream_allowed && !is_current_frame_allowed )
	{
		/*
		 * some optimization, put directly to the old stream
		 */
		put_directly = true;
		// do not modify output_stream here
	}
	else
	{
		output_stream = GetNewStreamForFrame();
	}

	if( output_stream )
	{
		if( !item.item_tab.empty() )
			MakeText( *item.item_tab[0] ); // should be only one item - item_container

		if( !put_directly )
		{
			if( old_is_output_stream_allowed )
			{
				CopyStream(*output_stream, *old_stream);
			}

			if( is_current_frame_allowed )
			{
				CopyTmpStreamToOutputStreams(item.function, *output_stream);
			}

			ClearStream(*output_stream);
			DecrementFramesStackIndex();
		}
	}

	is_output_stream_allowed = old_is_output_stream_allowed;
	output_stream = old_stream;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeEzcFrame(Item & item)
{
	/*
		if we encounter the first ezc frame statement without arguments e.g. [ezc frame] or just [frame]
		then we can simply ignore it
	*/
	if( item.function.parameters.empty() && ezc_frames_stack_index == 0 )
	{
		if( !item.item_tab.empty() )
			MakeText( *item.item_tab[0] ); // should be only one item - item_container
	}
	else
	{
		MakeEzcFrame2(item);
	}
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeTextEzc(Item & item)
{
	if( item.function.name == L"frame" )
	{
		MakeEzcFrame(item);
	}
	else
	if( item.function.name == L"clear_all_white_nodes" || item.function.name == L"trim_text_nodes" )
	{
		// text nodes are already cleared/trimmed by PatternParser
		MakeTextContainer(item);
	}

	// in the future we can use more builtin functions
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeTextReturn(Item & item)
{
	last_res = false;

	if( block_stack_index == 0 )
	{
		// the [return] statement is not called from a [block]
		CreateMsg(L"[return] should be called from a [block]");
		return;
	}

	BlockStack & block_stack = block_stack_tab[block_stack_index - 1];
	block_stack.was_return = true;

	if( item.has_function )
	{
		// output stream in [return] statement is ignored (we use only the stream produced by the whole block)
		// this Call() sets last_res which is used later when we return to CallBlock()
		Call(item.function, nullptr, stream_temp1, false, empty_stream);
		ClearStream(stream_temp1);
	}
}




template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
bool Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::LimitAchieved()
{
	if( break_generating )
		return true;

	if( current_item >= max_items )
	{
		break_generating = true;
		CreateMsg(L"Generator exceeded allowed number of elements");	
		return true;
	}

	if( stack_index >= stack_tab.size() )
	{
		break_generating = true;
		CreateMsg(L"Generator exceeded the stack size");	
		return true;
	}

	if( block_stack_index > 0 )
	{
		BlockStack & block_stack = block_stack_tab[block_stack_index - 1];

		if( block_stack.was_return )
			return true;
	}

return false;
}


template<class StreamType, bool is_pikotools_stream, bool is_autoescape_stream>
void Generator<StreamType, is_pikotools_stream, is_autoescape_stream>::MakeText(Item & item)
{
	if( LimitAchieved() )
		return;

	current_item             += 1;
	stack_index              += 1;
	is_generating_for        = false;
	is_generating_if         = false;
	is_generating_if_def     = false;
	is_generating_if_not_def = false;
	is_generating_normal     = false;
	is_generating_filter     = false;

	stack_tab[stack_index-1].Clear();
	stack_tab[stack_index-1].item = &item;

	if     ( item.type == Item::item_text )				MakeItemText(item);
	else if( item.type == Item::item_container )		MakeTextContainer(item);
	else if( item.type == Item::item_function )			MakeTextFunction(item);
	else if( item.type == Item::item_if )				MakeTextIf(item);
	else if( item.type == Item::item_if_def )			MakeTextIfDef(item);
	else if( item.type == Item::item_if_not_def )		MakeTextIfNotDef(item);
	else if( item.type == Item::item_def )				MakeTextDefine(item);
	else if( item.type == Item::item_def_if_not_set )	MakeTextDefineIfNotSet(item);
	else if( item.type == Item::item_let )				MakeTextLet(item);
	else if( item.type == Item::item_let_if_not_set )	MakeTextLetIfNotSet(item);
	else if( item.type == Item::item_for )				MakeTextFor(item);
	else if( item.type == Item::item_filter )			MakeTextFilter(item);
	else if( item.type == Item::item_ezc )				MakeTextEzc(item);
	else if( item.type == Item::item_return )			MakeTextReturn(item);
	else if( item.type == Item::item_err )
		CreateMsg(L"a wrong directive");

	RemoveStackFunData(stack_tab[stack_index-1]);
	stack_index -=1;
}


} // namespace Ezc


#endif