GenPod (Podcast Markdown Generator)

Uma ferramenta de linha de comando (CLI) construída em Node.js e TypeScript para extrair automaticamente os dados de um episódio de podcast no Spotify e no YouTube para gerar um arquivo Markdown (.md) pronto para publicação.

A princípio, desenhada para capturar os dados do podcast "Os Programadores", buscando o Título, Nome do Convidado, Data de Lançamento, Descrição e Links Mencionados, para no final renderizar o banner de vídeo em conjunto a um ID do YouTube fornecido para ser publicado no Hugo do site Os Programadores.

Requisitos

• Node.js v20+

Como Usar (via NPX)

Como o pacote está publicado no NPM, você nem precisa baixar o projeto. Basta usar o npx na pasta onde você deseja que o arquivo .md do episódio seja gerado:

npx @titenq/genpod

A ferramenta iniciará de forma interativa e fará as seguintes perguntas no seu terminal:

1. Spotify ID: (Ex: 5zUhdGz7S7sbLLhIbQ0Igb)
2. YouTube ID: (Ex: T85DXulOA6A)

(Opcionalmente, você também pode passar esses valores diretamente como argumentos: npx @titenq/genpod <spotify_id> <youtube_id>)

E pronto! O script fará a extração em background e o arquivo podcast-XXX.md será criado no diretório atual de onde você executou o comando.

Como Testar e Contribuir Localmente

Caso queira fazer modificações na ferramenta ou testá-la antes de subi-la pro NPM, siga os passos abaixo:

1. Instale as dependências:

npm install

2. Compile o código TypeScript para JavaScript: O nosso arquivo executável usa a pasta /dist gerada após a compilação:

npm run build

3. Crie um link global (Simulando uma instalação CLI na sua máquina) Para não precisar digitar node dist/index.js, você pode criar um link global mágico usando:

npm link

A partir desse momento, o comando genpod estará disponível pra você rodar de qualquer terminal no seu computador como se você tivesse baixado a sua ferramenta. Tente rodar genpod na sua pasta Documentos, por exemplo!

(Quando quiser remover o atalho: npm unlink -g @titenq/genpod)

Como publicar/atualizar o pacote no NPM (apenas para mantenedores)

Quando você finalizar seus testes locais e quiser atualizar a ferramenta oficial que todo mundo baixa via npx, siga os passos:

1. Atualize a versão no atributo "version" do seu package.json (Ex: 0.0.1, 0.0.2...)
2. Faça o login na sua conta do npm:

npm login

3. O build será executado automaticamente pelo script prepublishOnly, então basta rodar o comando de publicação com acesso público (já que é do escopo @titenq/):

npm publish --access public

Se o NPM pedir um código de autenticação (OTP), você precisará gerar um no site do NPM (na área de configurações de segurança) e colá-lo no terminal.

npm publish --access public --otp=SEU_CODIGO_AQUI

Feito! Em poucos minutos a nova versão já estará disponível para uso com o npx.