Como utilizar Bower y bitbucket para crear nuestro propio package privado.

1. Bower + Bitbucket A package manager for the web + Distributed revision control system

2. Empezando con bower
Para utilizar bower necesitamos tener instalado:
● node js
● npm
● bower ( npm install -g bower ).

3. Crear nuestro package
$ bower init .
Definición de bower.json
The bower.json spec defines several options, including:
● name (required): Nombre del package
● version: A semantic version number (see semver). (http:
//semver.org/lang/es/)
● main string or array: The primary acting files necessary
to use your package.
● ignore array: An array of paths not needed in production
that you want Bower to ignore when installing your
package.
● keywords array of string: (recommended) helps make
your package easier to discover
● dependencies hash: Packages your package depends
upon in production. Note that you can specify ranges of
versions for your dependencies.
● devDependencies hash: Development dependencies.
● private boolean: package privado
Bower.json
{
"name": "widget-webgl",
"version": "1.0.0",
"main": “ [ webglticketing.js,orbitalcontroller.js] si utilizamos mas de un
archivo lo agregamos en un array.
"license": "MIT",
“private”:true, esto es para que el repositorio sea privado y no este
registrado en bower.
"ignore": [
"**/.*",
"node_modules",
"bower_components",
"test",
"tests",
".git",
".gitignore",
],
"dependencies": {
"threejs": "r69" => package externo
} }

4. Bitbucket y Bower
crear una release de nuestro código en bitbucket.
Se debe tener en cuenta que número de versión en bower.json, debe coincidir con el tag creado en bitbucket.
Ejemplo:
Bower.json
{
"name": "widget-webgl",
"version": "1.0.0",
"main": "WebglTicketing.js",
...
$ git commit -am “v1.0.0”
$ git tag 1.0.0
$ git push
$ git push origin --tags

5. Registrar el package en Bower
Si queremos que nuestro package sea público debemos registrarlo en bower (github).
$ bower register <my-package-name> <git-endpoint>
# for example
$ bower register example git://github.com/user/example.git
Unregister
$ curl -X DELETE "https://bower.herokuapp.com/packages/<package>?access_token=<token>"

6. Instalar package público
# registered package
$ bower install jquery
# GitHub shorthand
$ bower install desandro/masonry
# Git endpoint
$ bower install git://github.com/user/package.git
# URL
$ bower install http://example.com/script.js *
*bower documentation (http://bower.io/)

7. Instalar package propio
Una vez que tengamos nuestro package creado, la manera de utilizarlo en cualquiera de nuestros proyectos es simple.
$ bower install git@bitbucket.org:teamname/widget-webgl.git#1.0.0
Para este proyecto estamos instando la versión 1.0.0 del widget-webgl
Otra forma más completa de instalar un package consiste en iniciar bower
$ bower init .
Completar los datos
Y a continuación instalamos los package que necesitemos.
$ bower install git@bitbucket.org:teamname/widget-webgl.git#1.0.2 --save*
$ bower install <package> --save-dev
*la opción save guarda la dependencia en bower.json, de esta manera a la hora de compartir el proyecto simplemente utilizando el comando
bower install se instalar todas las dependencias necesarias para este proyecto.

8. Configuracíon de bower
.bowerrc
{
"directory": "lib/",
"analytics": false
}

9. Api
● cache list | clean (Manage bower cache)
● help
● home (Opens a package homepage into your favorite browser.)
● info (Displays overall information of a package or of a particular version.)
● init
● install
● link
● list
● lookup
● prune
● register
● search
● update
● uninstall
● version
*bower documentation (http://bower.io/docs/api )

10. [Recursos]
http://bower.io/docs/creating-packages/
http://nodejs.org/
http://es.wikipedia.org/wiki/Fases_del_desarrollo_de_software
http://semver.org/lang/es/