Código fuente Transbank SDK de Ruby
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
lib/transbank
test
.built
.bundled
.gitignore
.travis.yml
CHANGELOG.md
Dockerfile
Gemfile
LICENSE.md
Makefile
README.md
Rakefile
docker-compose.yml
sdk_test.sh
transbank-sdk.gemspec

README.md

Transbank SDK Ruby

SDK Oficial de Transbank

Requisitos:

  • Ruby 2.2+

Instalación

Puedes instalar el SDK directamente

gem install transbank-sdk

o añadirlo a tu Gemfile

gem 'transbank-sdk'

y luego ejecutar

bundle install

Documentación

Puedes encontrar toda la documentación de cómo usar este SDK en el sitio https://www.transbankdevelopers.cl.

Actualmente este SDK contiene sólo Onepay.

La documentación relevante para usar este SDK es:

Información para contribuir y desarrollar este SDK

Requerimientos

  • Docker
  • Make
  • Plugin de editorconfig para tu editor favorito.

Standares

  • Para los commits respetamos las siguientes normas: https://chris.beams.io/posts/git-commit/
  • Usamos ingles, para los mensajes de commit.
  • Se pueden usar tokens como WIP, en el subject de un commit, separando el token con :, por ejemplo: WIP: This is a useful commit message
  • Para los nombres de ramas también usamos ingles.
  • Se asume, que una rama de feature no mezclada, es un feature no terminado.
  • El nombre de las ramas va en minúsculas.
  • Las palabras se separan con -.
  • Las ramas comienzan con alguno de los short lead tokens definidos, por ejemplo: feat/tokens-configuration

Short lead tokens

Commits
  • WIP = Trabajo en progreso.
Ramas
  • feat = Nuevos features
  • chore = Tareas, que no son visibles al usuario.
  • bug = Resolución de bugs.

Todas las mezclas a master se hacen mediante Pull Request.

Test

Primero y solamente una vez para instalar gemas debes usar el siguiente comando en una terminal.

make build

Para ejecutar los test localmente debes usar el siguiente comando en una terminal.

make

Deploy de una nueva versión.

Para generar una nueva versión, se debe crear un PR (con un título "Prepare release X.Y.Z" con los valores que correspondan para X, Y y Z). Se debe seguir el estándar semver para determinar si se incrementa el valor de X (si hay cambios no retrocompatibles), Y (para mejoras retrocompatibles) o Z (si sólo hubo correcciones a bugs).

En ese PR deben incluirse los siguientes cambios:

Modificar el archivo CHANGELOG.md para incluir una nueva entrada (al comienzo) para X.Y.Z que explique en español los cambios de cara al usuario del SDK.

Modificar este README.md para que los ejemplos usen la nueva versión X.Y.Z

Modificar version.rb para poner la nueva versión que corresponde

Luego de obtener aprobación del pull request, debe mezclarse a master e inmediatamente generar un release en GitHub con el tag vX.Y.Z. En la descripción del release debes poner lo mismo que agregaste al changelog.

Con eso Travis CI generará automáticamente una nueva versión de la librería y la publicará en RubyGems.