tarzi 0.2.3

Rust-native lite search for AI applications
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

#!/usr/bin/env python3
"""
Basic usage example for the tarzi Python library.
"""

import tarzi


def main():
    html_input = """
    <html>
        <head><title>Example Page</title></head>
        <body>
            <h1>Welcome to Tarzi</h1>
            <p>This is a <strong>test</strong> page with <a href="https://example.com">a link</a>.</p>
            <img src="image.jpg" alt="Test image">
        </body>
    </html>
    """

    # Converter
    converter = tarzi.Converter()
    yaml_output = converter.convert(html_input, "yaml")
    print(f"YAML output:\n{yaml_output}\n")

    # WebFetcher (plain HTTP → headless browser cascade)
    fetcher = tarzi.WebFetcher()
    try:
        content = fetcher.fetch("https://httpbin.org/html", "html")
        print(f"Fetched content length: {len(content)}")

        raw_content = fetcher.fetch_raw("https://httpbin.org/html")
        print(f"Raw fetch content length: {len(raw_content)}")
    except Exception as e:
        print(f"Fetch failed: {e}")

    # SearchEngine (default: duckduckgo,bing,brave + access cascade)
    search_engine = tarzi.SearchEngine()
    try:
        results = search_engine.search("machine learning", 2)
        print(f"Found {len(results)} search results:")
        for i, result in enumerate(results):
            print(f"  {i+1}. {result.title} ({result.url})")
            print(f"     {result.snippet}")
    except Exception as e:
        print(f"Search failed: {e}")
    finally:
        search_engine.shutdown()

    # Configuration-based usage
    try:
        config_str = """
[fetcher]
timeout = 30
format = "markdown"
web_driver = "chromedriver"
browser = true

[search]
engine = "brave,duckduckgo"
browser = true
limit = 3
"""
        config = tarzi.Config.from_str(config_str)
        print("Created config from string successfully")

        tarzi.WebFetcher.from_config(config)
        print("Created fetcher from config successfully")

        tarzi.SearchEngine.from_config(config)
        print("Created search engine from config successfully")
        print("Tip: set BRAVE_API_KEY / SERPER_API_KEY for API path; see examples/search_cascade.py")

    except Exception as e:
        print(f"Configuration usage failed: {e}")


if __name__ == "__main__":
    main()