{"id":13768414,"url":"https://github.com/jfoclpf/words-pt","last_synced_at":"2025-06-15T08:07:37.222Z","repository":{"id":37872511,"uuid":"244400879","full_name":"jfoclpf/words-pt","owner":"jfoclpf","description":"The list of all the words in Portuguese, including all possible combinations and variations (masculine, feminine, plural, singular, verbal conjugations, etc.)","archived":false,"fork":false,"pushed_at":"2024-07-21T21:17:06.000Z","size":11223,"stargazers_count":33,"open_issues_count":8,"forks_count":8,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-13T00:11:11.444Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jfoclpf.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-02T15:08:26.000Z","updated_at":"2025-06-01T17:53:56.000Z","dependencies_parsed_at":"2024-06-11T16:54:32.148Z","dependency_job_id":"1268171c-d33a-40dc-8611-99e3eef928f9","html_url":"https://github.com/jfoclpf/words-pt","commit_stats":{"total_commits":79,"total_committers":3,"mean_commits":"26.333333333333332","dds":"0.025316455696202556","last_synced_commit":"cced78e688777b6a6dfe074edc96735f11ea2098"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jfoclpf/words-pt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jfoclpf%2Fwords-pt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jfoclpf%2Fwords-pt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jfoclpf%2Fwords-pt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jfoclpf%2Fwords-pt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jfoclpf","download_url":"https://codeload.github.com/jfoclpf/words-pt/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jfoclpf%2Fwords-pt/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259942788,"owners_count":22935329,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T16:01:21.122Z","updated_at":"2025-06-15T08:07:37.194Z","avatar_url":"https://github.com/jfoclpf.png","language":"JavaScript","funding_links":[],"categories":["Portuguese Wordlists","Portuguese wordlists"],"sub_categories":[],"readme":"[![Node.js CI](https://github.com/jfoclpf/words-pt/actions/workflows/node.js.yml/badge.svg)](https://github.com/jfoclpf/words-pt/actions/workflows/node.js.yml)\n[![Coverage Status](https://coveralls.io/repos/github/jfoclpf/words-pt/badge.svg?branch=master)](https://coveralls.io/github/jfoclpf/words-pt?branch=master)\n[![Known Vulnerabilities](https://snyk.io/test/github/jfoclpf/words-pt/badge.svg?targetFile=package.json)](https://snyk.io/test/github/jfoclpf/words-pt?targetFile=package.json)\n[![js-standard-style][js-standard-style_img]][js-standard-style_url]\n\n[js-standard-style_img]: https://img.shields.io/badge/code%20style-standard-brightgreen.svg\n[js-standard-style_url]: https://standardjs.com/\n\nThe list of all the words in Portuguese, including all possible combinations and variations (masculine, feminine, plural, singular, verbal conjugations, etc.). This is based on the great work from the professors of the University of Minho, and the all the files can be accessed [here](https://natura.di.uminho.pt/download/sources/Dictionaries/wordlists/).\n\n## Install\n\n```sh\nnpm i words-pt\n```\n\n## How to use\n\n```js\nconst wordsPt = require('words-pt')\n\n// { removeNames: true } removes names such as 'Lisboa' or 'António'\nwordsPt.init({ removeNames: true }, err =\u003e {\n  if (err) {\n    // handle the error\n    return\n  }\n  wordsPt.isWord('ser') // true\n  wordsPt.isWord('serei') // true\n  wordsPt.isWord('abafar-nos-ão') // true\n  wordsPt.isWord('hello') // false\n\n  wordsPt.randomWord() // grafonolas (any random word)\n  wordsPt.randomWord('a') // amealhará (starting with 'a')\n  wordsPt.randomWord('abc') // abcissa (starting with 'abc')\n  // words.Pt.randomWord('abc') is equivalent to words.Pt.randomWord('abc', '*', '*')  \n\n  // words.Pt.randomWord(beginningPart, middlePart, endPart)\n  wordsPt.randomWord('ab', '*', '*') // 'abcesso'\n  wordsPt.randomWord('a', 'e', '*') // 'abcesso' but not 'abade'\n  wordsPt.randomWord('*', 's', '*') // 'espesso' but not 'sapato' nor 'mamas'\n  wordsPt.randomWord('*', '*', 's') // 'mamas'\n  wordsPt.randomWord('t', '*', 's') // 'tetas'\n  wordsPt.randomWord('t', 'et', 'as') // 'tetanizarias'\n  wordsPt.randomWord('se', 'o', 's') // 'seios'\n  wordsPt.randomWord('sa', 'a', 'to') // 'salteamento'\n\n  // exactly the same as randomWord, but gets all the words\n  wordsPt.getArray() // array with all the words\n  wordsPt.getArray('abc') // ['abcesso', 'abcessos', 'abcissa', 'abcissas']\n  wordsPt.getArray('t', 'et', 'as') // ['tabuletas', 'tchetchenas', 'telefotometrias', 'telemetrias', ... ]\n  wordsPt.getArray('tet', 'a', 's') // ['tetanizadas', 'tetanizados', 'tetanizais' , 'tetanizamos', ... ]\n\n  words.Pt.biggestWord() // constitucionalizar-lhes-íamos\n  // do something more\n})\n```\n\n## Just the file\n\nIf you simply want for the plain file, wherein the words are separated by newlines `\\n`, check the present file [wordsList.zip](wordsList.zip?raw=true). The corresponding unzipped file is encoded in `ISO-8859-1`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjfoclpf%2Fwords-pt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjfoclpf%2Fwords-pt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjfoclpf%2Fwords-pt/lists"}