# @odg/latam-test > reza a deus por esse teste Latest version **1.3.2** (published 2023-03-02) · MIT license · 0 weekly downloads ## Install ```sh npm install @odg/latam-test pnpm add @odg/latam-test yarn add @odg/latam-test bun add @odg/latam-test ``` ## Health **Score 25/100 (F)** — status: abandoned. Positive: has types; no vulnerabilities; high quality score. Warnings: low downloads; no esm support. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 1.3.2 | | Published | 2023-03-02 | | First published | 2023-02-10 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | CommonJS | | Dependencies | 16 | | Unpacked size | 182.5 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Author | Dragons Gamers | | Maintainers | dragonsgamers | ## Links - npm: https://www.npmjs.com/package/@odg/latam-test - npm.io page: https://npm.io/package/@odg/latam-test ## Dependencies (16) - [chalk](https://npm.io/package/chalk.md) ^4 - [@odg/log](https://npm.io/package/@odg/log.md) * - [inversify](https://npm.io/package/inversify.md) ^6.0.1 - [@odg/axios](https://npm.io/package/@odg/axios.md) * - [playwright](https://npm.io/package/playwright.md) ^1.30.0 - [@odg/events](https://npm.io/package/@odg/events.md) * - [@odg/message](https://npm.io/package/@odg/message.md) * - [@odg/json-log](https://npm.io/package/@odg/json-log.md) * - [@odg/exception](https://npm.io/package/@odg/exception.md) * - [@odg/chemical-x](https://npm.io/package/@odg/chemical-x.md) * - [playwright-core](https://npm.io/package/playwright-core.md) ^1.30.0 - [playwright-extra](https://npm.io/package/playwright-extra.md) ^4.3.5 - [reflect-metadata](https://npm.io/package/reflect-metadata.md) ^0.1.13 - [fingerprint-generator](https://npm.io/package/fingerprint-generator.md) ^2.1.10 - [puppeteer-extra-plugin](https://npm.io/package/puppeteer-extra-plugin.md) ^3.2.2 - [puppeteer-extra-plugin-stealth](https://npm.io/package/puppeteer-extra-plugin-stealth.md) ^2.11.1 ## Recent versions - 1.3.2 (latest) — 2023-03-02 - 1.3.1 — 2023-02-26 - 1.3.0 — 2023-02-25 - 1.2.4 — 2023-02-25 - 1.2.3 — 2023-02-25 - 1.2.2 — 2023-02-24 - 1.2.1 — 2023-02-23 - 1.2.0 — 2023-02-22 - 1.1.0 — 2023-02-16 - 1.0.2 — 2023-02-15 - 1.0.1 — 2023-02-10 - 1.0.0 — 2023-02-10 ## README

Stanley Imagem
Stanley Crawler With Events By Dragons Gamers

Template Stanley for Crawler Puppeteer/Playwright project 🤖!

[![codecov](https://codecov.io/gh/ODGodinho/Stanley-TheTemplate-Typescript/branch/main/graph/badge.svg?token=HNBNLLPZ3J)](https://codecov.io/gh/ODGodinho/Stanley-TheTemplate-Typescript) [![Stargazers](https://img.shields.io/github/stars/ODGodinho/Stanley-Crawler-Event?color=F430A4)](https://github.com/ODGodinho/Stanley-Crawler-Event/stargazers) [![Made by ODGodinho](https://img.shields.io/badge/made%20by-ODGodinho-%2304A361)](https://www.linkedin.com/in/victor-alves-odgodinho/) [![Forks](https://img.shields.io/github/forks/ODGodinho/Stanley-Crawler-Event?color=CD4D34)](https://github.com/ODGodinho/Stanley-Crawler-Event/network/members) ![Repository size](https://img.shields.io/github/repo-size/ODGodinho/Stanley-Crawler-Event) [![GitHub last commit](https://img.shields.io/github/last-commit/ODGodinho/Stanley-Crawler-Event)](https://github.com/ODGodinho/Stanley-Crawler-Event/commits/master) [![License](https://img.shields.io/badge/license-MIT-brightgreen)](https://opensource.org/licenses/MIT) [![StyleCI](https://github.styleci.io/repos/577106458/shield?branch=main)](https://github.styleci.io/repos/577106458?branch=main)

# Table of Contents - [🎇 Benefits](#-benefits) - [📗 Libraries](#-libraries) - [📁 Dependencies](#-dependencies) - [🔘 Use Template](#-use-template) - [🙈 Change to Puppeteer](#-change-to-puppeteer) - [⏩ Get Started](#-get-started) - [🦻 Event / Listeners](#-event-listeners) - [↖️ Selector](#-selector) - [⚙️ Container Bind](#-container-bind) - [❕ Extract Text Helper](#-extract-text-helper) - [🟢 Make File](#-make-file) - [💓 Cycle Time](#-cycle-time) - [📽️ Project Life Cycle](#-project-life-cycle) - [🐠 Service Life Cycle](#-service-life-cycle) - [💦 Page Life Cycle](#-page-life-cycle) - [🀄 Handler Life Cycle](#-handler-life-cycle) - [💻 Prepare to develop](#-prepare-to-develop) - [📍 Start Project](#-start-project) - [📨 Build and Run](#-build-and-run) - [🧪 Teste Code](#-teste-code) --- ## 🎇 Benefits - 🚀 Speed start new crawler using typescript - 🚨 Over 800 rules for pattern, possible errors and errors in Linter - 🎇 Code quality guaranteed - 📢 AutoReview when opening a pull-request/merge ![AutoReview Comment example](https://user-images.githubusercontent.com/3797062/97085944-87233a80-165b-11eb-94a8-0a47d5e24905.png) - 🧪 Automatic Test when opening pull-request/merge - 📦 Automatic Package and release generate on merge - ⚙️ IOT/IOC (Inversion of Control) for easy use of libraries - 🟢 Make:Files Command to make base files ## 📗 Libraries - [Node.js 18](https://nodejs.org/?n=dragonsgamers) - [Typescript](https://www.typescriptlang.org/?n=dragonsgamers) - [Eslint](https://eslint.org/?n=dragonsgamers) - [ODG-Linter-JS](https://github.com/ODGodinho/ODG-Linter-Js?n=dragonsgamers) - [EditorConfig](https://editorconfig.org/?n=dragonsgamers) - [ReviewDog](https://github.com/reviewdog/action-eslint) ## 📁 Dependencies - [Node.js](https://nodejs.org) 18 or later - [Yarn](https://yarnpkg.com/) Optional/Recommended - [Playwright](https://playwright.dev/) - For web scraping / crawling / automation - [@odg/axios](https://www.npmjs.com/package/@odg/axios) - Example to message request with axios - [@odg/chemical-x](https://www.npmjs.com/package/@odg/chemical-x) - Base For crawlers and helpers project - [@odg/command](https://www.npmjs.com/package/@odg/command) - Commands to make:files - [@odg/events](https://www.npmjs.com/package/@odg/events) - Abstract Events with async events - [@odg/exception](https://www.npmjs.com/package/@odg/exception) - Create custom exception to debug and history - [@odg/json-log](https://www.npmjs.com/package/@odg/json-log) - Convert your logs exception, request, in JSON before send - [@odg/log](https://www.npmjs.com/package/@odg/log) - Interface of logs - [@odg/message](https://www.npmjs.com/package/@odg/message) - Interface of request and messages - [@odg/tsconfig](https://www.npmjs.com/package/@odg/tsconfig) - Base Tsconfig to build project ### 🔘 Use Template Click in use this template button and clone your template project ![Use Template](https://raw.githubusercontent.com/ODGodinho/Stanley-TheTemplate/main/public/images/UseTemplate.png) #### 🙈 Change to Puppeteer To change you crawler to use puppeteer you change `./engine.ts` file for: ```typescript import puppeteer, { type Browser, type PuppeteerLaunchOptions, type Page, type BrowserContext, type PuppeteerNode, } from "puppeteer"; export type BrowserTypeEngine = PuppeteerNode; export type BrowserClassEngine = Browser; export type ContextClassEngine = BrowserContext; export type PageClassEngine = Page; export type BrowserOptionsEngine = PuppeteerLaunchOptions; export const browserEngine = puppeteer; ``` ## ⏩ Get Started --- ### 🦻 Event / Listeners Events can be fired with EventBusInterface Example Include the execution of your page in an event so that you can execute any page at any time ```typescript export class ExampleEventListener implements EventListenerInterface { @inject(ContainerName.Logger) public readonly log!: LoggerInterface; public async handler(_receivedData: unknown) { await this.log.info('Example Event Listener'); } } ``` > Register all Events name in `./src/app/Enums/EventName.ts` --- > Register all Events Types in `./@types/EventsInterface.ts` --- > Register your events in EventServiceProvider to automatic listeners. ### ↖️ Selector The selectors are in the selectors folder ```typescript export const googleSearchSelector = { searchInput: "input[name=\"q\"]", buttons: { submit: "input[name=\"btnK\"] >> visible=true", }, }; export type GoogleSearchSelectorType = typeof googleSearchSelector; ``` > Register all Selectors in `./src/app/Selectors/index.ts` ### ⚙️ Container Bind ```typescript this.bind( ContainerName.Logger, ).to(ConsoleLogger).inSingletonScope(); ``` > Register all Container name in `src/app/Enums/ContainerName.ts` > Register all Container Inject in `src/app/Container.ts` ### ❕ Extract Text Helper Use Str, Num, Arr helpers class to manipulate Text, Numbers and Arrays ```typescript import { Str } from "@odg/chemical-x"; const value = new Str( this.page.locator("#money").innerText(), ).money(); ``` ### 🟢 Make File To Make a file run command > Use this to make Page, Handler, Selectors... ```powershell yarn odg make ``` #### Example to make Page File ```powershell yarn odg make:page Search # help with yarn odg make:page --help ``` ## 💓 Cycle Time ### 📽️ Project Life Cycle Project Life cycle ![LifeCycle](./public/images/LifeCycle.jpg) ### 🐠 Service Life Cycle Example Service Life Cycle ![LifeCycle](./public/images/ServiceLifeCycle.jpg) ### 💦 Page Life Cycle Example Page Life Cycle ![LifeCycle](./public/images/PageLifeCycle.jpg) ### 🀄 Handler Life Cycle Example Handler Life Cycle ![LifeCycle](./public/images/HandlerLifeCycle.jpg) ## 💻 Prepare To Develop Copy `.env.example` to `.env` and add the values according to your needs. ### 📍 Start Project First install dependencies with the following command ```bash yarn install # or npm install ``` ## 📨 Build and Run To build the project, you can use the following command > if you change files, you need to run `yarn build` and `yarn start` again ```bash yarn build && yarn start # or yarn dev ``` ## 🧪 Teste Code To Test execute this command ```bash yarn test # or yarn test:watch ``` --- _Source: https://npm.io/package/@odg/latam-test · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._