Goscry

🚀 Project Introduction

This is an automation tool project implemented in Go language. The following content includes a complete technical documentation and usage instructions.

🚀 Quick Start

📦 Installation

Download the source code

go get github.com/your-username/your-repo-name

Start the service

go run main.go

✨ Features

Core Features Implemented in Go

1. Task Execution Engine

   • Supports a variety of operation instructions, including click, input, select, scroll, take screenshots, get DOM, run scripts, etc.

2. DOM AST Extractor

   • Based on the Chrome Debugging Protocol (ChromeDP), it provides web page structure analysis capabilities. Supports CSS selector positioning and returns a structured DOM Abstract Syntax Tree (AST).

3. Automation Testing Framework

   • Provides an interface for writing and executing automated tests, supporting multiple browser operations.

Command-line Tool

your-command [flags] [arguments]

Optional Flags

• -v: Enable debug mode.
• -c <config>: Specify the path to the configuration file.
• --help: Display help information and exit.

💻 Usage Examples

Basic Usage

The following are examples of using the API interfaces:

Task Execution Interface

curl -X POST http://localhost:8080/api/v1/task \
-H "Content-Type: application/json" \
-H "X-API-Key: your-api-key" \
-d '{
    "actions": [
        {"type": "click", "selector": "#submit-btn"},
        {"type": "type", "selector": "#username", "text": "admin"}
    ]
}'

DOM AST API

curl -X POST http://localhost:8080/api/v1/dom/ast \
-H "Content-Type: application/json" \
-H "X-API-Key: your-api-key" \
-d '{
    "url": "https://example.com",
    "parent_selector": "#main-content"
  }'

📚 Documentation

API Interfaces

Task Execution Interface

This interface is used to execute tasks. You can send a POST request to the specified URL with the required actions.

DOM AST API

This API is used to extract the DOM AST of a web page. You need to provide the URL of the web page and the CSS selector of the parent element.

🔧 Technical Details

Core Functionality Implemented in Go

The core functionality of this project is implemented in Go, which provides high performance and concurrency. The main components include:

• Task Execution Engine: Supports a wide range of operation instructions, making it suitable for various automation scenarios.
• DOM AST Extractor: Based on the Chrome Debugging Protocol, it can accurately analyze the web page structure and return a structured DOM AST.
• Automation Testing Framework: Provides an easy-to-use interface for writing and executing automated tests.

Command-line Tool

The command-line tool provides a convenient way to interact with the system. You can use different flags to control the behavior of the tool.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.