Skip to content

Quarto projeto desenvolvido pelo bootcamp @Laboratoria . [BACK-END] Markdown Links (md-links) é uma lib para identificar links em arquivos markdown, bem como seus respectivos status https. Criada usando NodeJS, pode ser executada através de CLI.

Keilaoliveira0112/SAP009-md-links

 
 

Repository files navigation

Markdown Links


Jest Rafa-Js git git vscode

Desenvolvido por :

Keila Oliveira
Linkedin | Github


Índice


1. Sobre o projeto

Neste projeto focado em Back-End, foi criado uma ferramenta de linha de comando (CLI) que tem como objetivo permitir que o usuário execute a biblioteca diretamente do terminal, através de um módulo do Node.js que analisa e identifica links em arquivos Markdown, e verifica o status https de cada um deles.

2. Instalação e comandos

  • Para instalar, execute o seguinte comando no terminal:

    npm i md-links-keila-oliveira

  • Após a instalação, é possível executar os seguintes comandos:

    md-links ./nomeDoDiretório/caminhoDoArquivo

    Esse comando lê o arquivo Markdown especificado e imprime o caminho do arquivo, os links encontrados e seus textos correspondentes.

    md-links ./nomeDoDiretório/caminhoDoArquivo --validate

    Ao adicionar a flag --validate, o módulo fará uma requisição HTTP para verificar se cada link funciona ou não. Se o link existir e funcionar, será considerado como um link válido. Caso contrário, será marcado como inválido.

    md-links ./nomeDoDiretório/caminhoDoArquivo --stats

    Ao adicionar a flag --stats, será exibido um resumo estatístico dos links encontrados no arquivo especificado. Será mostrado o número total de links e o número de links únicos.

    md-links ./nomeDoDiretório/caminhoDoArquivo --validate --stats

    Ao adicionar as flags --stats e --validate juntas, além das informações de total de links e links únicos, também será exibido o número de links inválidos (broken) encontrados.

3. Ferramentas utilizadas

  • Node.js
  • JavaScript
  • Jest
  • GitHub
  • Miró (Fluxograma)

4. Arquivos do projeto

  • README.md com descrição do módulo, instruções de instalação e uso, documentação da API e exemplos.
  • index.js: este arquivo deve exportar a função mdLinks.
  • package.json deve possuir o nome, versão, descrição, autor, licença, dependências e scripts.
  • .editorconfig com a configuração para o editor de texto. Este arquivo não deve ser alterado.
  • .eslintrc com a configuração para o linter. Este arquivo contém uma configuração básica para ESLint, se quiser colocar regras adicionais, você deverá modificar este arquivo.
  • .gitignore para ignorar o node_modules e outras pastas que não devem ser incluídas no controle de versão (git).
  • test/md-links.spec.js deve conter os testes unitários para a função mdLinks(). A sua implementação deve rodar estes testes.

5. Backlog

fluxograma

Fluxograma para as etapas do desenvolvimento do projeto.

About

Quarto projeto desenvolvido pelo bootcamp @Laboratoria . [BACK-END] Markdown Links (md-links) é uma lib para identificar links em arquivos markdown, bem como seus respectivos status https. Criada usando NodeJS, pode ser executada através de CLI.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 99.2%
  • HTML 0.8%