puka-http-beta
v3.3.12
Published
Versión beta de PukaHTTP (pre lanzamiento).
Downloads
69
Readme
/$$$$$$$ /$$ /$$ /$$ /$$ /$$$$$$ /$$ /$$ /$$$$$$$$ /$$$$$$$$ /$$$$$$$
| $$__ $$| $$ | $$| $$ /$$/ /$$__ $$ | $$ | $$|__ $$__/|__ $$__/| $$__ $$
| $$ \ $$| $$ | $$| $$ /$$/ | $$ \ $$ | $$ | $$ | $$ | $$ | $$ \ $$
| $$$$$$$/| $$ | $$| $$$$$/ | $$$$$$$$ /$$$$$$| $$$$$$$$ | $$ | $$ | $$$$$$$/
| $$____/ | $$ | $$| $$ $$ | $$__ $$|______/| $$__ $$ | $$ | $$ | $$____/
| $$ | $$ | $$| $$\ $$ | $$ | $$ | $$ | $$ | $$ | $$ | $$
| $$ | $$$$$$/| $$ \ $$| $$ | $$ | $$ | $$ | $$ | $$ | $$
|__/ \______/ |__/ \__/|__/ |__/ |__/ |__/ |__/ |__/ |__/
Servicio de impresión para la impresion de tickets en impresoras termicas.
Indice 📖
Instalación 🔧
- PukaHTTP esta disponible para su descarga en su ultima version: Pagina de descarga.
- Despues de instalar, al abrir PukaHTTP por primera vez, se tendra que configurar la IP y el Puerto del
servidor local http opcionalmente se le puede configurar un logo.
IMPORTANTE!!: El IP tiene que ser el mismo ip que la maquina host (se puede averiguar con el comando **ipconfig ** en windows y ifconfig de net-tools en linux y mac). Por defecto Puka tratara de identificar la IP de la maquina host, pero puede no ser tan certero.
- Luego de aceptar la configuración, para maquinas con S.O Windows y Mac se mostrara un TrayIcon en en la bandeja de sistema del entorno de escritorio del sistema operativo, para maquinas con S.O Linux u otro se habilitara una ventana como alternativa al trayIcon, esto debido a problemas de soporte de trayicon en S.O Linux.
Api 📖
Test connection service online:
"/" -> HTTP METHOD: GET
Mandar un trabajo de impresión:
/print -> HTTP METHOD: POST
El body de la petición http puede ser un array o un objeto que represente un trabajo de impresión, cada uno de estos objetos se puede construir con la libreria smeargle de php.
[ { "printer": { "name": "BIXOLON SRP-E300", "type": "system" }, "times": 2, "data": ["hello word"] } ]
Obtener elementos en cola, (para impresoras tipo SYSTEM, la cola de impresión lo maneja el propio sistema operativo):
"/print/queue" -> HTTP METHOD: GET
Reimprimir elementos en cola, (para impresoras tipo SYSTEM, la cola de impresión lo maneja el propio sistema operativo):
"/print/queue" -> HTTP METHOD: PUT
Liberar elementos en cola, (para impresoras tipo SYSTEM, la cola de impresión lo maneja el propio sistema operativo):
"/print/queue" -> HTTP METHOD: DELETE
Actualizar logo mediante http
"/logo" -> HTTP METHOD: PUT
Para desarrolladores ☕ 🍺
Comenzando 🚀
- Prerequisitos:
- JAVA openjdk 17 o superior.
- Apache Maven , algunos IDE's ya tren maven incluido, ejm. Intellij IDEA. (Aunque se recomienda su instalación independiente del IDE)
Clonar el repositorio Utilizando su IDE favorito o por medio de linea de comandos.
git clone [email protected]:puyu-pe/puka-http.git
Ejecutar proyecto Utilando su IDE favorito debe ejecutar la acciones maven clean compile y javafx:run, o por medio de linea de comandos:
mvn clean compile javafx:run
Despliegue 📦
Preparar una nueva versión 🛠️
Tener instalado git-flow y git-flow-hooks
- Ejecutar git flow hotfix o release
ógit flow release start
git flow hotfix start
- Ejecutar el script update-package.sh
./update-package.sh
Nota: El script funciona solo en maquinas Linux y Mac, en windows modificar la versión en package.develop.json y package.production.json de forma manual
- Confirmar los cambios
git add . && git commit
- Finalizar la rama del hotfix o release
'o'git flow hotfix finish
git flow release finish
- Hacer push -all y a la ultima etiqueta generada
git push --all && git push origin $(cat VERSION)
Warning: No ejecutar git push --tags, ya que puede entrar en conflicto con el tag jdeploy
Generar instaladores multiplataforma 🎁
Existe dos formas en la que podemos generar los instaladores para windows, mac y distribuciones linux. Siendo la mas sencilla y recomedada JDeploy, por que automatiza de mejor forma la generación de instaladores, y trae integrado un mecanismo de actualización automatica para las aplicaciones y tambien integración con github actions. El otro mecanismo es utilizando JPackage, que es la forma en la que se generaba anteriormente los instaladores de PukaHTTP, es mas complejo y no soporta compilación cruzada, este modo estará deprecado por lo que no se actualizara su documentación y su forma de trabajo con puka.