001/*license*\
002   Codelet: Copyright (C) 2014, Jeff Epstein (aliteralmind __DASH__ github __AT__ yahoo __DOT__ com)
003
004   This software is dual-licensed under the:
005   - Lesser General Public License (LGPL) version 3.0 or, at your option, any later version;
006   - Apache Software License (ASL) version 2.0.
007
008   Either license may be applied at your discretion. More information may be found at
009   - http://en.wikipedia.org/wiki/Multi-licensing.
010
011   The text of both licenses is available in the root directory of this project, under the names "LICENSE_lgpl-3.0.txt" and "LICENSE_asl-2.0.txt". The latest copies may be downloaded at:
012   - LGPL 3.0: https://www.gnu.org/licenses/lgpl-3.0.txt
013   - ASL 2.0: http://www.apache.org/licenses/LICENSE-2.0.txt
014\*license*/
015package  com.github.aliteralmind.codelet.type;
016   import  com.github.xbn.text.StringUtil;
017   import  com.github.aliteralmind.codelet.CustomizationInstructions;
018   import  com.github.aliteralmind.codelet.CodeletInstance;
019   import  com.github.aliteralmind.codelet.CodeletType;
020   import  com.github.aliteralmind.codelet.TagletOfTypeProcessor;
021   import  com.github.aliteralmind.codelet.simplesig.SimpleMethodSignature;
022   import  java.nio.file.AccessDeniedException;
023   import  java.nio.file.NoSuchFileException;
024   import  java.util.Iterator;
025   import  static com.github.aliteralmind.codelet.CodeletBaseConfig.*;
026/**
027   <p>Reads a {@link com.github.aliteralmind.codelet.CodeletType#SOURCE_AND_OUT {@.codelet.and.out}} taglet and outputs its replacement text.</p>
028
029 * @since  0.1.0
030 * @author  Copyright (C) 2014, Jeff Epstein ({@code aliteralmind __DASH__ github __AT__ yahoo __DOT__ com}), dual-licensed under the LGPL (version 3.0 or later) or the ASL (version 2.0). See source code for details. <a href="http://codelet.aliteralmind.com">{@code http://codelet.aliteralmind.com}</a>, <a href="https://github.com/aliteralmind/codelet">{@code https://github.com/aliteralmind/codelet}</a>
031 **/
032public class SourceAndOutProcessor extends TagletOfTypeProcessor<SourceAndOutTemplate>  {
033   /**
034      <p>Create a new instance from an {@code CodeletInstance}.</p>
035
036    * <p>Equal to <code>{@link com.github.aliteralmind.codelet.TagletOfTypeProcessor#TagletOfTypeProcessor(CodeletType, CodeletInstance) super}(CodeletType.SOURCE_AND_OUT, instance)</code>
037    */
038   public SourceAndOutProcessor(CodeletInstance instance) throws ClassNotFoundException, NoSuchMethodException, NoSuchFileException, AccessDeniedException  {
039      super(CodeletType.SOURCE_AND_OUT, instance);
040
041      Iterator<String> srcLineItr = getSourceCodeLineIterator(instance);
042      CustomizationInstructions<SourceAndOutTemplate> instructions =
043         getCustomizationInstructions(CodeletType.SOURCE_CODE);
044      String customizedSourceCode = instructions.getCustomizedBody(instance, srcLineItr);
045
046      //Only one template for source and out together, and it must come from
047      //the (potential) source-code customizer. This allows custom templates
048      //to be set.
049      SourceAndOutTemplate template = getTemplateFromInstructionsOverrideOrDefault(
050         instructions);
051
052      //Output
053         String consoleOut = SimpleMethodSignature.getForMainFromStringSig(
054               getExampleCodeStringSig(),
055               getDebugApblIfOn(instance,
056                  "zzConsoleOutProcessor.consoleoutputfromexamplecodestringsig")).
057            invokeGetMainOutputNoExtraParams("Executing example code");
058
059         Iterator<String> consoleOutLineItr = StringUtil.getLineIterator(consoleOut);
060
061         instructions = newInstructionsForDefaults(
062            new CustomizationInstructions<SourceAndOutTemplate>(
063                  instance, CodeletType.CONSOLE_OUT));
064         String outputCustomized = instructions.getCustomizedBody(instance, consoleOutLineItr);
065
066
067      String finalOutput = template.
068         fillSourceCodeBody(customizedSourceCode).
069         fillConsoleOutputBody(outputCustomized).
070         getRendered(instance);
071
072      setFullyProcessedOutput(finalOutput);
073   }
074}