1.0.8 • Published 2 years ago

@andsfonseca/palavras-pt-br v1.0.8

Weekly downloads
-
License
MIT
Repository
github
Last release
2 years ago

Palavras PT-br

Código criado com o intuito de ajudar a ter uma lista de todas as palavras em português brasileiro

O que é?

Um pacote com uma listagem de palavras em português brasileiro

Instalação

Instale o pacote globalmente através do repositório npmjs.com.

npm i @andsfonseca/palavras-pt-br

Uso

Importação

Para realizar a importação via Javascript

var Word = require('@andsfonseca/palavras-pt-br').Word;

Para realizar a importação via Typescript

import { Word } from '@andsfonseca/palavras-pt-br'

Funções

  • getAllWords (limit: number = 0, removeAccents: boolean = true, includeCompounds: boolean = true, includeSpecialCharacters: boolean = false, includeProperNouns: boolean = false)

    Método que retorna um array de palavras da base com a filtragem escolhida pelo usuário.

ArgumentoDescriçãoObrigatório
limitLimite de caracteres da palavra, caso seja menor ou igual a 0 serão considerada todas.Não, padrão 0
removeAccentsInforma se deve remover os acentos nas palavras.Não, padrão false
includeCompoundsInforma se deve incluir palavras compostas.Não, padrão true
includeSpecialCharactersInforma se deve incluir palavras com caracateres especiais.Não, padrão false
includeProperNounsInforma se deve incluir nomes próprios.Não, padrão false
let words: string[] = Word.getAllWords()
  • getRandomWord (limit: number = 0, removeAccents: boolean = true, includeCompounds: boolean = true, includeSpecialCharacters: boolean = false, includeProperNouns: boolean = false)

Método que retorna uma palavra aleatória da base com a filtragem escolhida pelo usuário.

Os argumentos são descritos no método getAllWords

let randomWord: string = Word.getRandomWord()
  • getDailyWord (limit: number = 0, removeAccents: boolean = true, includeCompounds: boolean = true, includeSpecialCharacters: boolean = false, includeProperNouns: boolean = false)

Método que retorna uma palavra aleatória por dia da base com a filtragem escolhida pelo usuário.

Os argumentos são descritos no método getAllWords

let randomWord: string = Word.getDailyWord()
  • checkValid (word: string, limit: number = 0, removeAccents: boolean = true, includeCompounds: boolean = true, includeSpecialCharacters: boolean = false, includeProperNouns: boolean = false)

Método que verifica se uma palavra está na base, com a filtragem escolhida pelo usuário.

ArgumentoDescriçãoObrigatório
wordPalavra a ser verificada.✅ Sim

O restante dos argumentos são descritos no método getAllWords

let valid: boolean = Word.checkValid("teste")
  • wordleValidator(trueWord: string, triedWord: string)

Método que verifica a proximidade entre duas palavras, no estilo Wordle. Retorna informações sobre a validação da palavra

ArgumentoDescriçãoObrigatório
trueWordPalavra verdadeira.✅ Sim
triedWordPalavra a ser verificada.✅ Sim
let validation: IWordleValidation[] = Word.wordleValidator("tesla", "testu")

A interface IWordleValidation é descrita nesta seção

Interfaces

  • IWordleValidation

Representação da Validação do Wordle

interface IWordleValidation {
    word: string,
    contains: boolean,
    exact: boolean
}
PropriedadeDescrição
wordLetra.
containsSe a letra está na palavra.
exactSe a letra está na posição correta.

Base de Dados

Bases Padrões

As bases de dados usados nesta biblioteca são:

Dicionário
Dicionário br.ispell
pythonprobr
@un-versed Termoo v2

Podem ser importadas da seguinte maneira

import { BRISPELL, PYTHONPROBR, UNVERSEDV2 } from '@andsfonseca/palavras-pt-br'

Por padrão a biblioteca @un-versed Termoo v2 é usada.

Você pode customizar a biblioteca da seguinte maneira:

Word.library = PYTHONPROBR
//Word.library = ["Outras", "Palavras", "Da", "Sua", "Base"]

Issues

Sinta-se livre para contribuir com o projeto.

Contribuições

  1. Crie uma cópia do projeto (fork)
  2. Crie uma branch com sua modificação (git checkout -b my-new-resource)
  3. Faça um commit commit (git commit -am 'Adding a new resource...')
  4. Push (git push origin my-new-resource)
  5. Crie uma Pull Request
1.0.8

2 years ago

1.0.7

2 years ago

1.0.6

2 years ago

1.0.5

2 years ago

1.0.4

2 years ago

1.0.3

2 years ago

1.0.2

2 years ago

1.0.1

2 years ago

1.0.0

2 years ago