Forem: Rodrigo Juarez

LiteDB with Blazor sample app

Rodrigo Juarez — Thu, 11 Mar 2021 00:00:00 +0000

My LiteDB with Blazor demo app is at https://blazorlitedb.herokuapp.com

Source code available at https://github.com/rodrigojuarez/blazorlitedbdemo

External access to your API in development with Conveyor

Rodrigo Juarez — Sat, 06 Mar 2021 18:11:50 +0000

In my usual workflow, when I’m developing an API with Visual Studio, and I need to access it from a mobile app, I publish the API to Azure or a local IIS server.

I need to do this because, by default, IIS express publish your API with the localhost endpoint, and it can’t be easily used outside the running machine.

I was looking for a quick fix when I found Conveyor, a Visual Studio extension that automatically provides our API’s external access. Additionally, I created an account on their website to enable public access to my API (outside of the local network).

After installing the extension, it would start when I run my project in Debug mode.

In the following screenshot, you can see which ones are the enabled endpoints.

Enabled endpoints

We can also enable the use of certificates for HTTPS access.

A great addition to my toolbox, easy to install and use

Xamarin.Forms deploy to Android 11 emulator in Windows

Rodrigo Juarez — Thu, 25 Feb 2021 14:40:20 +0000

I’m usually using the Android emulator while I’m working with VS, and today I was trying to build and deploy to a newly created Android 11 emulator with no luck.

As always, Stack Overflow to the rescue!

In this link, they comment that the problem is that with Android 11 we need a different way of sign the apk.

I didn’t found the option to do it using the UI, so, we need to add the following tag to our Android csproj file for the debug configuration.

<AndroidUseApkSigner>true</AndroidUseApkSigner>

I also needed to disable the use of Shared Runtime and Fast Deployment in the Android project properties

After all the changes, my app is deploying to the Android 11 emulator without issues!

Create your blog with Jekyll

Rodrigo Juarez — Sat, 08 Aug 2020 13:32:11 +0000

Some time ago, I was looking for some alternatives to WordPress or Blogger.
I wanted something lighter and faster.
I was already using markdown for notes and documentation, and looking for a way to use my markdown notes, I found Jekyll.

Content

What is Jekyll and why you should use it
Install Jekyll (Windows)
Our first post
Publish using GitHub Pages
Next Steps
References and additional information

What is Jekyll and why you should use it

Jekyll is a static site generator.
It uses your text files in your favorite markup language to create a static website.
You can modify how your site looks, the data displayed and more.
Jekyll is blog-aware, it provide helpers to work with categories, pages, post, etc.
The website generated is fast and can be deployed in any hosting provider, you don't need to configure any database, just deploy your site.

Install Jekyll (Windows)

Jekyll is written in Ruby, the following install steps are for Windows (my every day OS), but you can use Linux or Mac.

Install Ruby version 2.5.0 or above

Download Ruby for windows

Execute the installer, accept the license and continue with default options
Check the installation running the following commands in a command prompt

ruby -v
gem -v

After this step I restarted my computer to be sure any configuration change would be applied.

Install Jekyll

Jekyll is a Ruby Gem (Gem is a package manager for Ruby)

To install Jekyll open a command prompt and run the command

gem install bundler jekyll

Create a blank site

Use the command

jekyll new my-new-blog

Change to your new site and run it

cd my-new-blog
bundle exec jekyll serve

Access your new site

Browse to https://localhost:4000

Basic configuration

Edit the _config.yml file in the root of your new site to change the configuration.
You can change the title, social media links, etc.
If you stop jekyll and start it again, it will re generate your site with the new configuration.

First post

In the recently created site, you will see a folder _posts.

In there you can put the pages that you want to see in your blog.

For that, we are going to use Markdown, it's a markup language used for example in the readme files in GitHub (at the end of the post you will see links with additional information about Markdown)

Create a file with a name using the following format YYYY-MM-DD-Title.md in the _posts folder using your favorite text editor and put the following text

---
layout: post
title:  "Markdown Resources"
---
# Markdown resources
- [Markdown](https://www.markdownguide.org/)
- [Markdown Cheatsheet](https://www.markdownguide.org/cheat-sheet/)

The first part, beetween the dashed lines is a YAML front matter block, and is used by Jekyll to process the file.

The second part is standard Markdown text

You can generate the site again at any time running the bundle exec jekyll serve command.
If you didn't close your previous command prompt window, your site would be regenerated automatically.

Publish using GitHub Pages

GitHub Pages is a service provided by GitHub that allows you to use a repository to create a web site. The service is powered with Jekyll.
For users or organizations, create a repository with the name username.github.io
Push your jekyll site to the repo
Navigate to your new site
Every time that you push changes to the master branch of the repo, your site will be automatically updated

Next Steps

This is only an introduction, you should check other topics like

References and additional information

Usando especificaciones OpenAPI

Rodrigo Juarez — Wed, 01 Apr 2020 03:00:00 +0000

Que es esto que me enviaron cuando pedi documentacion de una API?!?

Te han pedido incorporar una API de terceros en tu aplicacion y cuando pedis la documentacion, te envian un archivo json o una url indicandote que alli esta la especificacion OpenAPI (o la documentacion Swagger) …

Y ahora? Esto como se come?

Bien, la especificacion OpenAPI (anteriormente conocida como especificacion Swagger) es un formato para describir APIs REST. Podes encontrar mas info sobre OpenAPI en el sitio oficial (en ingles)

Supongamos que queremos integrar una API que nos da acceso a la biblia a nuestra aplicacion, y nos indican que la documentacion se encuentra en https://api.scripture.api.bible/v1/swagger.json

Si intentamos acceder en nuestro navegador, veremos el contenido del archivo json, con gran cantidad de informacion

Una mejor forma de acceder, es utilizando el editor que OpenAPI nos provee, el mismo se encuentra en https://editor.swagger.io/ y veremos en primer lugar una documentacion de ejemplo de la API Petstore

Para cargar nuestra documentacion de biblia, debemos utilizar el menu File -> Import URL y alli pegar la URL de la documentacion

Veremos a nuestra izquierda, el archivo json formateado y a la derecha paneles que nos permitiran interactuar con las distintas direcciones que provee la API

Podemos acceder a detalles de una direccion en particular

Y utilizando el boton Try it out, podemos ejecutar llamadas de prueba, ver parametros de entrada y ejemplos de salida.

En el caso de esta API de biblia, antes de poder hacer llamadas tenemos que tener acceso a un token de autorizacion, el mismo se carga en la opcion Authorize, otras APIs pueden tener distintas implementaciones de seguridad, por lo que la informacion a ingresar aqui depende de cada caso.

Espero que este breve tutorial les haya sido de utilidad y les sirva como punto de entrada para comenzar a utilizar swagger de forma mas sencilla y eficiente

Nos leemos!

Using screenshots in markdown with VS Code

Rodrigo Juarez — Sat, 18 Jan 2020 04:50:54 +0000

Original post in spanish

This post is about using Visual Studio Code to include screenshots in markdown files, so you can publish your files without upload the images or change the links (something sometimes you can't do at all)

For that we are going to use Imgur and a VS Code extension called vscode-imgur

Installing vscode-imgur

We can install it from the Extensions panel in VS Code, searching for vscode-imgur
We need to configure the Imgur credentials
- Open the VS Code configuration with CTRL + , then search and replace the following keys
  - Client_id
  - Client_secret
  - Album_id
  - User upload en true
With your VS Code window active, you can paste an image in your clipboard using CTRL + ALT + V, this command will upload our image to Imgur and will add the link in our markdown file
The first time we use it, we will be redirected to the Imgur for confirmation. Copy the provided pin and paste it in VS Code

Get your album id in imgur

Rodrigo Juarez — Sat, 18 Jan 2020 04:40:08 +0000

Original post in spanish

I want to use my Imgur account as storage for the screenshots in my posts.

I'm using Visual Studio Code as my markdown editor, and I found this awesome extension that makes my life easier: vscode-imgur.

When I started to configure the extension, I needed the id of the album used as storage in Imgur.

I didn't found details for the albums, but if you select the Images option in your user menu

You can open any existing album or create a new one

And in the dropdown Edit this album you can select the Embed Album option

In that code, the highlighted part is the album id, everything after a/ in the data-id attribute

Configurando git en Windows para utilizarlo desde la linea de comandos

Rodrigo Juarez — Fri, 17 Jan 2020 03:00:00 +0000

Uno de mis objetivos de este 2020 es aprender a utilizar Git desde la linea de comandos

En mi maquina de desarrollo principal utilizo Windows, por lo que aqui veremos los pasos que sigo para configurarlo

El enlace de descarga
Seleccion de componentes, en general dejo las opciones por defecto, agrego algunos comentarios y los pasos en los que cambie los valores iniciales

Como editor selecciono VS Code (que ya tengo previamente instalado)

En relacion a la configuracion del PATH, dejo el valor recomendado, que me va a dar acceso al comando git cuando abra la linea de comandos

Como aplicacion de terminal, selecciono la aplicacion por defecto de windows

Luego de finalizada la instalacion, ejecuto el siguiente comando desde la consola, para asegurarme que todo esta correctamente instalado

git --version

Other language support?

Rodrigo Juarez — Mon, 09 Dec 2019 13:12:13 +0000

Hi dev.to members!

Does dev.to support post in another language than English?
I want to create some content in Spanish, but I'm not sure if I could or if there are any particular considerations.

Free resources to learn .NET?

Rodrigo Juarez — Tue, 29 Oct 2019 14:06:53 +0000

Good morning everyone!

I'm doing some coaching, and I want to have a good list of free resources that you can recommend.

I will start with https://dotnet.microsoft.com/learn/videos

Thanks!

Unpopular opinion? I don't do puzzle coding tests.

Rodrigo Juarez — Fri, 25 Oct 2019 01:19:32 +0000

So, today, as part of a screening process for a freelancers agency, they sent me a puzzle coding test. I respectfully declined and said that probably I'm not a good fit.
What is your position?

Utilizando db MS SQL con docker en Windows

Rodrigo Juarez — Sat, 19 Oct 2019 03:00:00 +0000

Este post es simplemente un recordatorio para referencia futura sobre la configuracion de docker para poder utilizar bases de datos de Microsoft SQL Server en windows

Entorno
Estoy utilizando una pc con Windows 10 Version 1903
Tengo habilitado Hyper-V
Tengo instalado Docker Desktop 19.03.2
Docker esta configurado para utilizar Windows Containers

docker-db-init.ps1

He creado un script de powershell para configurar la db.La primera vez que ejecutamos este script, se descargaran todas las imagenes para que sql server funcione, por lo que son varios gigabytes.

docker 
    run -v 'c:\db:c:\db'
    --name mi_sql
    -p 1433:1433
    -e 'sa_password=mi_pass'
    -e 'ACCEPT_EULA=Y'
    -e attach_dbs="[{'dbName':'DataDb','dbFiles':['c:\\db\\datadb.mdf','c:\\db\\datadb_1.ldf']},{'dbName':'LoggingDb','dbFiles':['c:\\db\\loggingdb.mdf','c:\\db\\loggingdb_1.ldf']}]"
    -rm microsoft/mssql-server-windows-developer

-v: Adjuntar una carpeta que sera utilizada como persistencia, se indica la carpeta en el host y la de docker

–name: Darle un nombre al container para re utilizarlo posteriormente

-p 1433:1433: Puerto en el host y en docker de sql server

-e ‘sa_password=mi_pass’: El password del usuario sa que queremos utilizar

-e ‘ACCEPT_EULA=Y’: Requerido por Microsoft para aceptar el acuerdo de licencia

-e attach_dbs=”[{‘dbName’:’DataDb’,’dbFiles’:[‘c:\db\datadb.mdf’,’c:\db\datadb_1.ldf’]},{‘dbName’:’LoggingDb’,’dbFiles’:[‘c:\db\loggingdb.mdf’,’c:\db\loggingdb_1.ldf’]}]”: las bases de datos que queremos adjuntar, que deben estar en la carpeta que definimos con el parametro -v

-rm microsoft/mssql-server-windows-developer: la imagen de docker que estamos utilizando

configure-db.bat

Para facilitar la ejecucion del script powershell tengo el siguiente archivo bat

Powershell.exe -executionpolicy remotesigned -File C:\Desarrollo\proyecto\docker-db-init.ps1
pause

start-db.bat

Una vez que la base de datos esta configurada, utilizo el siguiente archivo bat para iniciar el contenedor de docker

docker start mi_sql
docker stats

Luego podremos conectarnos a la base de datos que estara disponible en localhost