tck-lambdas 0.3.4 → 0.3.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c61dd189f557744f188d942c50b07ea1e1c1843b
-  data.tar.gz: 047c35b22c77f15ff2164f3e5e677f1d77c69d32
+  metadata.gz: 001e87d8e5dd72a88c0f00dd71add5f25d9c42b3
+  data.tar.gz: 3f0c00c70b605ba3fe112ca5e8ecc29f9bf3972d
 SHA512:
-  metadata.gz: be15a18f604cf72e2efb8dad9b1d13015b15c3aeee01a0347963f9e5b9506799f5cd8801010748bd98813f84b2aee2477450dc291a5e4bc0d4041cadf211f491
-  data.tar.gz: acd672f52eca004beee5f72fba7acb52398479c96b6118cc634f07e2f31a793e586326ab470262e42230999928dda581fee1f59ca880865659e5c689dbc8b477
+  metadata.gz: d96d1df1677df8fbe282b008172c2d907986ce7b536fa18f14fa89182d820c55f42d906bb8f46a276b7036a31acf1d8cac40129746fe964a4959c9988fb8da22
+  data.tar.gz: 72ccc188951e708880389dd7544629f2d1cd2012522078a95f525cecb26d50091dd1708ffcaead1836ee1043d36ac3bcc04232e6b99c9dcdcddce7ed8aef351c

data/README.md

@@ -16,18 +16,49 @@ Si sólo tenemos esa _lambda_ en el proyecto, creando el _alias_ necesario en nu
 
     $ rake deploy_lambda
 
-Usando una _lambda_
--------------------
+Comandos de _tck-lambdas_
+-------------------------
 
-Vamos a meter un _formulario de contacto_ en nuestro **proyecto Amazing** y queremos usar la *lambda contact_form*. Instalamos la _gema Tck::Lambdas_ y le indicamos que nuestro proyecto hace uso de la _lambda_ llamada *contact_form*:
+Si lanzamos su ayuda nos cuenta lo siguiente:
+
+    $ tck-lambdas help
+    Commands:
+      tck-lambdas all             # List all AWS Lambdas currently available in tck-lambdas.
+      tck-lambdas help [COMMAND]  # Describe available commands or one specific command
+      tck-lambdas roles           # List current AWS IAM roles (running 'aws iam list-roles [...]').
+      tck-lambdas use NAME        # Use the AWS Lambda function known as NAME at The Cocktail.
+      tck-lambdas used            # List functions currently used by this project.
+
+**GOTCHA**: Tenemos también el *indocumentado comando* ``tck-lambdas list``, que es un _alias_ de ``tck-lambdas used``, **NO** de ``tck-lambdas all`` :)
+
+Caso de Uso: *lambda contact_form*
+----------------------------------
+
+Vamos a meter un _formulario de contacto_ en nuestro proyecto **Amazing** y queremos usar la *lambda contact_form*. Instalamos la _gema Tck::Lambdas_ y le indicamos que nuestro proyecto hace uso de la _lambda_ llamada *contact_form*:
 
     $ echo "gem 'tck-lambdas'" >> Gemfile      # Metemos la gema en nuestro Gemfile...
     $ bundle                                   #  - la instalamos...
     $ cp Rakefile Rakefile.orig                #  - nos guardamos nuestro Rakefile...
-    $ bundle exec tck-lambdas use contact_form #  - y usamos la lambda:
-    => lambdas/contact_form/ created with the lambda sources & tests.
-    => task/lambdas/contact_form.rake created with common tasks.
-    => .lambdas.yml created with the contact_form lambda conf.
+    $ tck-lambdas use contact_form             #  - y usamos la lambda:
+    /usr/lib/ruby/gems/[...]/lib/tck/lambdas/contact_form
+          create  Rakefile
+          create  Gemfile.example
+          create  .lambdas.yml
+          create  lib/tasks/lambdas.rake
+          create  lib/tck/lambdas/aws_function.rb
+          create  lambdas/test.rb
+          create  lambdas/contact_form
+          create  lambdas/contact_form/source/conf.js
+          create  lambdas/contact_form/source/contact_form.js
+          create  lambdas/contact_form/source/utils.js
+          create  lambdas/contact_form/test/failed/domain_empty.json
+          create  lambdas/contact_form/test/failed/domain_not_found.json
+          create  lambdas/contact_form/test/failed/email_empty.json
+          create  lambdas/contact_form/test/failed/email_format.json
+          create  lambdas/contact_form/test/failed/message_empty.json
+          create  lambdas/contact_form/test/succeeded/basic.json
+          create  lambdas/contact_form/test/succeeded/with_cc.json
+    $
  
 Tal y como nos avisa ha creado, entre otras cosas, el fichero *.lambdas.yml* con la configuración para nuestra función _lambda_ con el siguiente contenido:
 
@@ -38,18 +69,17 @@ Tal y como nos avisa ha creado, entre otras cosas, el fichero *.lambdas.yml* con
       memory-size: 128
       runtime: nodejs4.3
       role: lambda_contact_form_role
+      description: Project-Name instance of the Tck's contact_form lambda
 
-Todos los valores por defecto deberían ser válidos excepto el nombre de la función (_function-name_), su manejador (_handler_), y su rol.
+Todos los valores por defecto deberían ser válidos excepto el nombre de la función (_function-name_), su manejador (_handler_), y su rol (_role_).
 
 En el nombre de la función y su manejador tenemos que sustituir *project_name* por el nombre de nuestro proyecto (quedándonos con *amazing_contact_form* y *amazing_contact_form.handler* respectivamente).
 
-El rol tenemos que sustituirlo por **el _ARN_ completo** de un rol que tenga permisos para ejecutar los servicios que necesite nuestra _lambda_. El _ARN_ correspondiente lo podemos obtener desde la línea de comandos con ``aws iam list-roles``:
-
-    aws iam list-roles --query "Roles[].[RoleName,Arn]"
+El rol tenemos que sustituirlo por **el _ARN_ completo** de un rol que tenga permisos para ejecutar los servicios que necesite nuestra _lambda_. El comando **tck-lambdas roles** nos devuelve los _ARN_ de los distintos roles que tenemos a nuestra disposición en _AWS Lambda_.
 
 Con dichos cambios en nuestro *.lambdas.yml* ejecutamos la siguiente tarea de _rake_:
 
-    $ bundle exec rake lambdas:contact_form:create_lambda
+    $ rake lambdas:contact_form:create_lambda
 
 Dicha orden nos creará, **además de la función _lambda_** necesaria para el entorno de producción, **otra con el mismo nombre terminada en *_test* para la ejecución de sus tests** (en nuestro ejemplo si lanzamos ``aws lambda list-functions`` deberíamos tener dos nuevas funciones llamadas *amazing_contact_form* y *amazing_contact_form_test*).
 

data/lib/tck/lambdas/chistacojs/source/chistacojs.js

@@ -1,10 +1,11 @@
 /* Copyright 2016 The Cocktail Experience, S.L. */
 var conf = require('./conf'),
     http = require('request'),
-    post = require('post_chistaco'),
+    post = require('./post_chistaco'),
     // Chistacojs modules
     refreshing_matter = require('./refreshing_matter'),
-    chistescortos = require('./chistescortos');
+    chistescortos     = require('./chistescortos'),
+    chyton            = require('./chyton');
 
 exports.handler = function(event, context) {
   console.log('Received event:', JSON.stringify(event, null, 2));
@@ -19,11 +20,14 @@ exports.handler = function(event, context) {
   };
 
   switch(chistacojs_param) {
+    case 'refreshing':
+      chistacojs_module = refreshing_matter(conf.modules[0]);
+      break;
     case 'chistescortos':
-      chistacojs_module = chistescortos(conf);
+      chistacojs_module = chistescortos(conf.modules[1]);
       break;
-    case 'refreshing':
-      chistacojs_module = refreshing_matter(conf);
+    case 'chyton':
+      chistacojs_module = chyton(conf.modules[2]);
       break;
     default:
       context.fail('module: not found');

data/lib/tck/lambdas/chistacojs/source/chistescortos.js

@@ -1,7 +1,6 @@
 /* Copyright 2016 The Cocktail Experience, S.L. */
-module.exports = function(tck_lambdas_conf) {
-  var conf = tck_lambdas_conf.modules[1], // "chistescortos"
-      module = {
+module.exports = function(conf) {
+  var module = {
         name: conf.name,
         conf: conf,
         call: function(request, callback) {

data/lib/tck/lambdas/chistacojs/source/chyton.js

@@ -0,0 +1,24 @@
+/* Copyright 2016 The Cocktail Experience, S.L. */
+/* inspired by Ardor's Chyton lambda(*)
+(*) https://gist.github.com/andor-pierdelacabeza/31509208af7b65448b4d743ae6f11035 */
+module.exports = function(conf) {
+  var module = {
+        name: conf.name,
+        conf: conf,
+        call: function(request, callback) {
+          request(conf.url, function (error, response, body) {
+            if (!error && response.statusCode == 200) {
+              var xpath = require('xpath'),
+                  dom = require('xmldom').DOMParser,
+                  doc = new dom().parseFromString(body),
+                  nodes = xpath.select(conf.xpath, doc);
+              callback(null, nodes[conf.index].toString());
+            }
+            else {
+              callback(error, response.statusCode);
+            }
+          })
+        }
+      };
+  return(module);
+}

data/lib/tck/lambdas/chistacojs/source/conf.js

@@ -16,6 +16,13 @@ module.exports = {
       name: "ChistesCortos.eu",
       url: 'http://www.chistescortos.eu/random',
       selector: '.post .oldlink'
+    },
+    {
+      param: 'chyton',
+      name: 'Chyton',
+      url: 'http://pagina-del-dia.euroresidentes.es/chiste-del-dia/gadget-chiste-del-dia.php?modo=2',
+      xpath: '//td',
+      index: 2
     }
   ]
 }

data/lib/tck/lambdas/chistacojs/source/node_modules/xmldom/__package__.js

@@ -0,0 +1,4 @@
+this.addScript('dom.js',['DOMImplementation','XMLSerializer']);
+this.addScript('dom-parser.js',['DOMHandler','DOMParser'],
+		['DOMImplementation','XMLReader']);
+this.addScript('sax.js','XMLReader');

data/lib/tck/lambdas/chistacojs/source/node_modules/xmldom/component.json

@@ -0,0 +1,10 @@
+{
+  "name": "xmldom",
+  "version": "0.1.15",
+  "main": "dom-parser.js",
+  "ignore": [
+    "**/.*",
+    "node_modules",
+    "components"
+  ]
+}

data/lib/tck/lambdas/chistacojs/source/node_modules/xmldom/dom-parser.js

@@ -0,0 +1,249 @@
+function DOMParser(options){
+	this.options = options ||{locator:{}};
+	
+}
+DOMParser.prototype.parseFromString = function(source,mimeType){	
+	var options = this.options;
+	var sax =  new XMLReader();
+	var domBuilder = options.domBuilder || new DOMHandler();//contentHandler and LexicalHandler
+	var errorHandler = options.errorHandler;
+	var locator = options.locator;
+	var defaultNSMap = options.xmlns||{};
+	var entityMap = {'lt':'<','gt':'>','amp':'&','quot':'"','apos':"'"}
+	if(locator){
+		domBuilder.setDocumentLocator(locator)
+	}
+	
+	sax.errorHandler = buildErrorHandler(errorHandler,domBuilder,locator);
+	sax.domBuilder = options.domBuilder || domBuilder;
+	if(/\/x?html?$/.test(mimeType)){
+		entityMap.nbsp = '\xa0';
+		entityMap.copy = '\xa9';
+		defaultNSMap['']= 'http://www.w3.org/1999/xhtml';
+	}
+	defaultNSMap.xml = defaultNSMap.xml || 'http://www.w3.org/XML/1998/namespace';
+	if(source){
+		sax.parse(source,defaultNSMap,entityMap);
+	}else{
+		sax.errorHandler.error("invalid document source");
+	}
+	return domBuilder.document;
+}
+function buildErrorHandler(errorImpl,domBuilder,locator){
+	if(!errorImpl){
+		if(domBuilder instanceof DOMHandler){
+			return domBuilder;
+		}
+		errorImpl = domBuilder ;
+	}
+	var errorHandler = {}
+	var isCallback = errorImpl instanceof Function;
+	locator = locator||{}
+	function build(key){
+		var fn = errorImpl[key];
+		if(!fn && isCallback){
+			fn = errorImpl.length == 2?function(msg){errorImpl(key,msg)}:errorImpl;
+		}
+		errorHandler[key] = fn && function(msg){
+			fn('[xmldom '+key+']\t'+msg+_locator(locator));
+		}||function(){};
+	}
+	build('warning');
+	build('error');
+	build('fatalError');
+	return errorHandler;
+}
+
+//console.log('#\n\n\n\n\n\n\n####')
+/**
+ * +ContentHandler+ErrorHandler
+ * +LexicalHandler+EntityResolver2
+ * -DeclHandler-DTDHandler 
+ * 
+ * DefaultHandler:EntityResolver, DTDHandler, ContentHandler, ErrorHandler
+ * DefaultHandler2:DefaultHandler,LexicalHandler, DeclHandler, EntityResolver2
+ * @link http://www.saxproject.org/apidoc/org/xml/sax/helpers/DefaultHandler.html
+ */
+function DOMHandler() {
+    this.cdata = false;
+}
+function position(locator,node){
+	node.lineNumber = locator.lineNumber;
+	node.columnNumber = locator.columnNumber;
+}
+/**
+ * @see org.xml.sax.ContentHandler#startDocument
+ * @link http://www.saxproject.org/apidoc/org/xml/sax/ContentHandler.html
+ */ 
+DOMHandler.prototype = {
+	startDocument : function() {
+    	this.document = new DOMImplementation().createDocument(null, null, null);
+    	if (this.locator) {
+        	this.document.documentURI = this.locator.systemId;
+    	}
+	},
+	startElement:function(namespaceURI, localName, qName, attrs) {
+		var doc = this.document;
+	    var el = doc.createElementNS(namespaceURI, qName||localName);
+	    var len = attrs.length;
+	    appendElement(this, el);
+	    this.currentElement = el;
+	    
+		this.locator && position(this.locator,el)
+	    for (var i = 0 ; i < len; i++) {
+	        var namespaceURI = attrs.getURI(i);
+	        var value = attrs.getValue(i);
+	        var qName = attrs.getQName(i);
+			var attr = doc.createAttributeNS(namespaceURI, qName);
+			if( attr.getOffset){
+				position(attr.getOffset(1),attr)
+			}
+			attr.value = attr.nodeValue = value;
+			el.setAttributeNode(attr)
+	    }
+	},
+	endElement:function(namespaceURI, localName, qName) {
+		var current = this.currentElement
+	    var tagName = current.tagName;
+	    this.currentElement = current.parentNode;
+	},
+	startPrefixMapping:function(prefix, uri) {
+	},
+	endPrefixMapping:function(prefix) {
+	},
+	processingInstruction:function(target, data) {
+	    var ins = this.document.createProcessingInstruction(target, data);
+	    this.locator && position(this.locator,ins)
+	    appendElement(this, ins);
+	},
+	ignorableWhitespace:function(ch, start, length) {
+	},
+	characters:function(chars, start, length) {
+		chars = _toString.apply(this,arguments)
+		//console.log(chars)
+		if(this.currentElement && chars){
+			if (this.cdata) {
+				var charNode = this.document.createCDATASection(chars);
+				this.currentElement.appendChild(charNode);
+			} else {
+				var charNode = this.document.createTextNode(chars);
+				this.currentElement.appendChild(charNode);
+			}
+			this.locator && position(this.locator,charNode)
+		}
+	},
+	skippedEntity:function(name) {
+	},
+	endDocument:function() {
+		this.document.normalize();
+	},
+	setDocumentLocator:function (locator) {
+	    if(this.locator = locator){// && !('lineNumber' in locator)){
+	    	locator.lineNumber = 0;
+	    }
+	},
+	//LexicalHandler
+	comment:function(chars, start, length) {
+		chars = _toString.apply(this,arguments)
+	    var comm = this.document.createComment(chars);
+	    this.locator && position(this.locator,comm)
+	    appendElement(this, comm);
+	},
+	
+	startCDATA:function() {
+	    //used in characters() methods
+	    this.cdata = true;
+	},
+	endCDATA:function() {
+	    this.cdata = false;
+	},
+	
+	startDTD:function(name, publicId, systemId) {
+		var impl = this.document.implementation;
+	    if (impl && impl.createDocumentType) {
+	        var dt = impl.createDocumentType(name, publicId, systemId);
+	        this.locator && position(this.locator,dt)
+	        appendElement(this, dt);
+	    }
+	},
+	/**
+	 * @see org.xml.sax.ErrorHandler
+	 * @link http://www.saxproject.org/apidoc/org/xml/sax/ErrorHandler.html
+	 */
+	warning:function(error) {
+		console.warn('[xmldom warning]\t'+error,_locator(this.locator));
+	},
+	error:function(error) {
+		console.error('[xmldom error]\t'+error,_locator(this.locator));
+	},
+	fatalError:function(error) {
+		console.error('[xmldom fatalError]\t'+error,_locator(this.locator));
+	    throw error;
+	}
+}
+function _locator(l){
+	if(l){
+		return '\n@'+(l.systemId ||'')+'#[line:'+l.lineNumber+',col:'+l.columnNumber+']'
+	}
+}
+function _toString(chars,start,length){
+	if(typeof chars == 'string'){
+		return chars.substr(start,length)
+	}else{//java sax connect width xmldom on rhino(what about: "? && !(chars instanceof String)")
+		if(chars.length >= start+length || start){
+			return new java.lang.String(chars,start,length)+'';
+		}
+		return chars;
+	}
+}
+
+/*
+ * @link http://www.saxproject.org/apidoc/org/xml/sax/ext/LexicalHandler.html
+ * used method of org.xml.sax.ext.LexicalHandler:
+ *  #comment(chars, start, length)
+ *  #startCDATA()
+ *  #endCDATA()
+ *  #startDTD(name, publicId, systemId)
+ *
+ *
+ * IGNORED method of org.xml.sax.ext.LexicalHandler:
+ *  #endDTD()
+ *  #startEntity(name)
+ *  #endEntity(name)
+ *
+ *
+ * @link http://www.saxproject.org/apidoc/org/xml/sax/ext/DeclHandler.html
+ * IGNORED method of org.xml.sax.ext.DeclHandler
+ * 	#attributeDecl(eName, aName, type, mode, value)
+ *  #elementDecl(name, model)
+ *  #externalEntityDecl(name, publicId, systemId)
+ *  #internalEntityDecl(name, value)
+ * @link http://www.saxproject.org/apidoc/org/xml/sax/ext/EntityResolver2.html
+ * IGNORED method of org.xml.sax.EntityResolver2
+ *  #resolveEntity(String name,String publicId,String baseURI,String systemId)
+ *  #resolveEntity(publicId, systemId)
+ *  #getExternalSubset(name, baseURI)
+ * @link http://www.saxproject.org/apidoc/org/xml/sax/DTDHandler.html
+ * IGNORED method of org.xml.sax.DTDHandler
+ *  #notationDecl(name, publicId, systemId) {};
+ *  #unparsedEntityDecl(name, publicId, systemId, notationName) {};
+ */
+"endDTD,startEntity,endEntity,attributeDecl,elementDecl,externalEntityDecl,internalEntityDecl,resolveEntity,getExternalSubset,notationDecl,unparsedEntityDecl".replace(/\w+/g,function(key){
+	DOMHandler.prototype[key] = function(){return null}
+})
+
+/* Private static helpers treated below as private instance methods, so don't need to add these to the public API; we might use a Relator to also get rid of non-standard public properties */
+function appendElement (hander,node) {
+    if (!hander.currentElement) {
+        hander.document.appendChild(node);
+    } else {
+        hander.currentElement.appendChild(node);
+    }
+}//appendChild and setAttributeNS are preformance key
+
+if(typeof require == 'function'){
+	var XMLReader = require('./sax').XMLReader;
+	var DOMImplementation = exports.DOMImplementation = require('./dom').DOMImplementation;
+	exports.XMLSerializer = require('./dom').XMLSerializer ;
+	exports.DOMParser = DOMParser;
+}