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.aliteralmind.codelet.CodeletFormatException;
017   import  com.github.aliteralmind.codelet.CodeletInstance;
018   import  com.github.aliteralmind.codelet.CodeletType;
019   import  com.github.aliteralmind.codelet.CustomizationInstructions;
020   import  com.github.aliteralmind.codelet.TagletOfTypeProcessor;
021   import  java.nio.file.AccessDeniedException;
022   import  java.nio.file.NoSuchFileException;
023   import  java.util.Iterator;
024   import  static com.github.aliteralmind.codelet.CodeletBaseConfig.*;
025/**
026   <p>Reads a (source-code) {@link com.github.aliteralmind.codelet.CodeletType#SOURCE_CODE {@.codelet}} taglet and outputs its replacement text.</p>
027
028 * @since  0.1.0
029 * @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>
030 **/
031public class SourceCodeProcessor extends TagletOfTypeProcessor<SourceCodeTemplate>  {
032   /**
033      <p>Create a new instance from an {@code CodeletInstance}.</p>
034
035    * <p>Equal to <code>{@link com.github.aliteralmind.codelet.TagletOfTypeProcessor#TagletOfTypeProcessor(CodeletType, CodeletInstance) super}(CodeletType.SOURCE_CODE, instance)</code>
036    */
037   public SourceCodeProcessor(CodeletInstance instance) throws ClassNotFoundException, NoSuchMethodException, NoSuchFileException, AccessDeniedException  {
038      super(CodeletType.SOURCE_CODE, instance);
039
040      if(getClassOrFilePortion().contains("("))  {
041         throw  new CodeletFormatException(instance, "Source code taglets cannot contain command-line parameters");
042      }
043
044      Iterator<String> srcLineItr = getSourceCodeLineIterator(instance);
045
046      CustomizationInstructions<SourceCodeTemplate> instructions =
047         getCustomizationInstructions(CodeletType.SOURCE_CODE);
048
049      String customizedSourceCode = instructions.getCustomizedBody(
050         instance, srcLineItr);
051
052      boolean doDebug = isDebugOn(instance, "zzSourceCodeProcessor.progress");
053
054      if(doDebug)  {
055         debugln("   Getting template.");
056      }
057
058      SourceCodeTemplate template = getTemplateFromInstructionsOverrideOrDefault(
059         instructions);
060
061      if(doDebug)  {
062         debugln("   Filling body text.");
063      }
064
065      String finalOutput = template.fillBody(customizedSourceCode).getRendered(instance);
066
067      if(doDebug)  {
068         debugln("   Setting fully-processed output.");
069      }
070
071      setFullyProcessedOutput(finalOutput);
072   }
073}