# catlistener

> 'A task automator, and whit terminal commands, to run NPM or Git, without leaving the server or other service.'

Latest version **0.0.11** (published 2017-07-29) · ISC license · 0 weekly downloads

## Install

```sh
npm install catlistener
pnpm add catlistener
yarn add catlistener
bun add catlistener
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.11 |
| Published | 2017-07-29 |
| First published | 2016-01-29 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | Benjamin De la cruz Martinez |
| Maintainers | benjamindelacruz |

## Links

- npm: https://www.npmjs.com/package/catlistener
- Repository: https://github.com/kimvex/catlistener
- Homepage: https://github.com/kimvex/catlistener#readme
- Issues: https://github.com/kimvex/catlistener/issues
- npm.io page: https://npm.io/package/catlistener

## Recent versions

- 0.0.11 (latest) — 2017-07-29
- 0.0.9 — 2016-05-15
- 0.0.8 — 2016-02-03
- 0.0.7 — 2016-02-03
- 0.0.6 — 2016-02-02
- 0.0.5 — 2016-02-01
- 0.0.4 — 2016-01-29
- 0.0.3 — 2016-01-29
- 0.0.2 — 2016-01-29
- 0.0.1 — 2016-01-29

## README

# Catlistener
![imagen](https://raw.githubusercontent.com/kimvex/tweet-service/master/chalistener.png)

## English
## Instalation

### npm

`npm install catlistener`

## Using 

This is the simplest way to use:
```js
var cat = require('catlistener');

cat.server({
  enviroment:{
    ENV: dev
  },
  node: 'node',
  debug: '--debug',
  app: 'server'
});

```
## Using server

In enviroment section, place the enviroment variables that be useful for our project, "enviroment" should be always initial.


In the Node section we can use of any module for start our server: 

#### node

#### supervisor

#### babel-node


### Using stylus
```js
cat.stylus({
  options: ['compiles','listener', 'watch'],
  css: './app/staticos/css/',
  stylus: './app/staticos/stylus/estilo.styl'
});
```
In options we can customize the options that stylus contain.

In css add the route where our css compiled going to be saved.

In stylus add the route of our styl file.

## Using Browserify
```js
cat.browserify({
  original: './app/staticos/js/script.js',
  compilado: './app/staticos/js/compilado.js',
  presets: ['es2015']
});
```
In "original" put the direction of our original Js.

In "compilado" put the direction and the name of our Js files compilated in Ecmascript 6.

"Presets" it´s able to put if you want, use Ecmascript 6 compilated with Babelify

IMPORTANT: For this function to Browserify works must download babel-preset-es2015 or other version of babel.

In addition we can use multi bundle, which allows us to compile different files that we pass through an array.

In the same way we can pass an array of presets that allow us to extend the power of babel.

Example:

```js
cat.browserify({
  original: ['./app/static/js/escript.js', './app/static/js/inicio/inicio.js'],
  compilado: ['./app/static/js/script.js', './app/static/js/inicio.js'],
  common: ['./app/static/js/global.js'],
  presets: ['es2015','react', 'stage-2']
});
```
When using the multi bundle we added a new `common` property in which we save all the modules that share the files, avoiding to reload those modules.

More information on multi-blundle operation
[Multi-bundle](https://webpack.github.io/docs/multiple-entry-points.html)

In order to use multi bundle we must install a new module:

`npm install factor-bundle`

Now we have support for React.js but it is necessary to install `babel-preset-react` and sweat the preset `'react'`.

Important Note: To use the Stylus and Browserify modules, these modules must be installed separately.

In the case of stylus:

`npm install -g stylus`

In the case of Browserify you need to have downloaded more modules such as:

`npm install babelify`

`npm install babel-preset-ES2015`

`npm install browserify`

`npm install -g watchify`

## Terminal Commands 

The use of Terminal Commands is actually ilimited, we can use most of the Git commands, whitout leaving to get response about pour server and stylus, similarly we can install npm modules whitout stop the server.

## Implementation

To use this module, just create a file where put all previous that you want and it begin like the example:

```
Node fileCreated
```

As easy as that Catlistener Module will be executing.

## Español
Un automatizador de tareas y con comandos de terminal para poder ejecutar npm o git sin dejar de ejecutar el servidor u otro servicio.

## Instalación

### npm

`npm install catlistener`

## Uso

La forma de usar es la siguiente:
```js
var cat = require('catlistener');

cat.server({
  enviroment:{
    ENV: dev
  },
  node: 'node',
  debug: '--debug',
  app: 'server'
});

```

### Uso del servidor

En la sección de enviroment colocamos las variables de entorno que utilizaremos para nuestro proyecto, enviroment siempre debe de ir primero.

En la sección `node` podemos hacer uso de cualquier módulo para levantar nuestro servidor:

#### node

#### supervisor

#### babel-node


### Uso de stylus
```js
cat.stylus({
  options: ['compila','escucha', 'observa'],
  css: './app/staticos/css/',
  stylus: './app/staticos/stylus/estilo.styl'
});
```
En `options` colocamos las opciones que queramos usar en nuestro stylus.

En `css` colocamos la dirección donde se guardara nuestro css compilado.

En `stylus` colocamos la dirección de nuestro archivo styl.

### Uso de browserify
```js
cat.browserify({
  original: './app/staticos/js/script.js',
  compilado: './app/staticos/js/compilado.js',
  presets: ['es2015']
});
```
En `original` colocamos la dirección de nuestro js original.

En `compilado` colocamos la dirección y el nombre de nuestros js compilado en ecmascript 6.

En `presets` podemos colocar si queremos que use ecmascript 6 compilado con babelify

NOTA: Para que la función de browserify funcione debes de descargar babel-preset-es2015 u otra version de babel.

Además, podemos usar multi bundle, lo que nos permite compilar diferentes archivos que pasamos a través de un array.

De la misma manera podemos pasar una serie de presets que nos permiten extender el poder de babel.

Ejemplo:

```js
cat.browserify({
  original: ['./app/static/js/escript.js', './app/static/js/inicio/inicio.js'],
  compilado: ['./app/static/js/script.js', './app/static/js/inicio.js'],
  common: ['./app/static/js/global.js'],
  presets: ['es2015','react', 'stage-2']
});
```

Al usar el multi bundle agregamos una nueva propiedad `common en el cual guardamos todos los módulos que comparten los archivos, evitando volver a cargar esos modulos.

Mas informacion del funcionamiento de multi blundle.
[Multi-bundle](https://webpack.github.io/docs/multiple-entry-points.html)

Para poder hacer uso de multi bundle debemos instalar un nuevo módulo.

`npm install factor-bundle`

Ahora tenemos soporte para React.js pero es necesario instalar `babel-preset-react` y suar el el preset `'react'`.

Nota importante: Para poder hacer uso de los modulos Stylus y Browserify, debera instalar esos modulos por separado.

En el caso de stylus:

`npm install stylus -g`

En el caso de Browserify usted necesita tener descargado más modulos como lo son:

`npm install babelify`

`npm install babel-preset-es2015`

`npm install browserify`

`npm install watchify -g`

## Comandos de terminal

El uso de los comandos es limitado, podemos usar la mayoría de los comandos de git sin dejar de obtener respuesta de lo que ocurre en nuestro servidor y stylus, de igual forma podemos instalar módulos de npm sin detener el servidor.

## Ejecución

Para poder hacer uso del módulo, solo crea un archivo donde coloques todo lo anterior que desees e inicia así:

```
node archivoCreado
```

Y asi de facil catlistener se estará ejecutando.

---
_Source: https://npm.io/package/catlistener · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._