swagger-angularjs-client

###Example swagger client for angular (using nodejs)

ANTES DE EMPEZAR TIENES QUE TENER INSTALADO nodejs Y npm

1.- ENTRAR A 'http://editor.swagger.io/#!/'

2.- CREA LA DOCUMENTACION DE TU API EN EL EDITOR DE SWAGGER (para documentar tu API apoyate de la especificación 'OpenAPI Specification' https://swagger.io/specification y de este ejemplo https://github.com/OAI/OpenAPI-Specification/blob/master/examples/v2.0/yaml/uber.yaml), LOS FORMATOS QUE MANEJA SWAGGER SON 'YAML' Y 'JSON'

3.- EN LA CARPETA DEL PROYECTO (AÚN VACIA) EJECUTA 'npm init -y' E INSTALA LA DEPENDENCIA swagger-js-codegen 'npm install swagger-js-codegen --save' QUIEN NOS AYUDARÁ A GENERAR NUESTRO CLIENTE (para mas info 'https://github.com/wcandillon/swagger-js-codegen')

4.- CREA TU ARCHIVO .js EN MI CASO LLAMADO "app.js" CON LAS SIGUIENTES LINEAS DE CÓDIGO

////////INICIO//////////
//módulo para manipulación de archivos
var fs = require('fs');
//módulo para generar el cliente js
var CodeGen = require('swagger-js-codegen').CodeGen;
//https://github.com/wcandillon/swagger-js-codegen

//archivo .json generado desde el editor de swagger
var fileJSON = 'swagger/swaggerUber.json';
//http://editor.swagger.io/

var swagger = JSON.parse(fs.readFileSync(fileJSON, 'UTF-8'));
//elegimos generar el cliente para angularjs
var angularjsSourceCode = CodeGen.getAngularCode({ className: 'clientSwagger', swagger: swagger });

//nombre del archivo donde se guardará el cliente angularjs generado
var dirAjs = './clientAngularSwagger.js';

//función que crea o sobre-escribe en el archivo
function generaAngularJS(file,client){
	fs.exists(file, function(res) {
		if(res)
			fs.writeFile(file, client, function(err) {
				if( err ){
					console.log(err);
				}
				else{
					console.log('Se sobre-escribió y generó el archivo '+file);
				}
			});
		else{
			var wstream = fs.createWriteStream(file);
			wstream.write(client)
			wstream.end(function () {
				console.log('archivo creado y generado '+file); 
			});
		}
	});	
}
generaAngularJS(dirAjs,angularjsSourceCode);
////////FIN//////////

5.- UNA VEZ CREADA LA DOCUMENTACIÓN DE TU API DESDE EL EDITOR DEL SWAGGER, LO DESCARGAMOS EN FORMATO JSON, CREAMOS UNA CARPETA EN MI CASO 'swagger' Y PEGAMOS EL ARCHIVOS JSON Y LE PONES EL NOMBRE QUE GUSTES EN MI CASO 'swaggerUber.json'

NOTA: SI QUIERES OMITIR ESTE PUNTO AQUI ESTA EL EJEMPLO DE UBER 'https://github.com/OAI/OpenAPI-Specification/blob/master/examples/v2.0/json/uber.json' ESTO PARA HACER TU PRUEBA Y GENERAR TU CLIENTE ANGULARJS

6.- EJECUTAMOS EL SIGUIENTE COMANDO 'node app' EN LA RAIZ DEL PROYECTO

7.- LISTO SE GENERÓ NUESTRO CLIENTE PARA ANGULARJS