package pythondocs import ( "strings" "testing" "github.com/PuerkitoBio/goquery" ) const testModulePageHTML = `

`test` — Regression tests package¶

The test package contains all regression tests for Python.

This is additional documentation.

class test. TestCase (methodName='runTest') ¶: A test case class.

test. run_test (name, verbose=False) ¶: Run a single test.

exception test. TestFailed ¶: Exception raised when a test fails.

test. verbose ¶: True when verbose output is enabled.

` const testClassHTML = `

class test. TestCase (methodName='runTest')

A test case class that provides testing functionality.

test.TestCase. setUp (): Set up the test fixture.

test.TestCase. tearDown (): Tear down the test fixture.

classmethod test.TestCase. setUpClass (): Set up the test class.

test.TestCase. maxDiff: Maximum diff length.

` const testSearchHTML = `

test (Python module, in test — Regression tests package)
unittest (Python module, in unittest — Unit testing framework)
keyword — Testing for Python keywords
This module allows a Python program to determine if a string is a keyword.

` func TestParseModulePage(t *testing.T) { parser := NewParser() module, err := parser.ParseModulePage(testModulePageHTML, "https://docs.python.org/3/library/test.html") if err != nil { t.Fatalf("ParseModulePage failed: %v", err) } if module.Name == "" { t.Error("Expected non-empty module name") } if module.Doc == "" { t.Error("Expected non-empty doc") } if len(module.Classes) == 0 { t.Error("Expected at least one class") } if len(module.Functions) == 0 { t.Error("Expected at least one function") } if len(module.Exceptions) == 0 { t.Error("Expected at least one exception") } if len(module.Constants) == 0 { t.Error("Expected at least one constant/data") } } func TestParseSearchResults(t *testing.T) { parser := NewParser() results, err := parser.ParseSearchResults(testSearchHTML) if err != nil { t.Fatalf("ParseSearchResults failed: %v", err) } if len(results) < 2 { t.Fatalf("Expected at least 2 results, got %d", len(results)) } first := results[0] if first.Name == "" { t.Error("Expected non-empty name") } if first.DocURL == "" { t.Error("Expected non-empty doc URL") } } func TestExtractClasses(t *testing.T) { parser := NewParser() doc, err := goquery.NewDocumentFromReader(strings.NewReader(testClassHTML)) if err != nil { t.Fatalf("Failed to parse HTML: %v", err) } classes := parser.extractClasses(doc, "test", "https://docs.python.org/3/library/test.html") if len(classes) == 0 { t.Fatal("Expected at least one class") } tc := classes[0] if tc.Name == "" { t.Error("Expected non-empty class name") } if len(tc.Methods) < 2 { t.Errorf("Expected at least 2 methods, got %d", len(tc.Methods)) } if len(tc.ClassMethods) == 0 { t.Error("Expected at least one classmethod") } if len(tc.Attributes) == 0 { t.Error("Expected at least one attribute") } } func TestExtractFunctions(t *testing.T) { parser := NewParser() doc, err := goquery.NewDocumentFromReader(strings.NewReader(testModulePageHTML)) if err != nil { t.Fatalf("Failed to parse HTML: %v", err) } functions := parser.extractFunctions(doc, "test", "https://docs.python.org/3/library/test.html") if len(functions) == 0 { t.Fatal("Expected at least one function") } fn := functions[0] if fn.Name == "" { t.Error("Expected non-empty function name") } if fn.Signature == "" { t.Error("Expected non-empty signature") } } func TestResolveURL(t *testing.T) { tests := []struct { base string href string expected string }{ {"https://docs.python.org", "/library/test.html", "https://docs.python.org/library/test.html"}, {"https://docs.python.org", "https://example.com/page", "https://example.com/page"}, } for _, tt := range tests { t.Run(tt.href, func(t *testing.T) { got := resolveURL(tt.base, tt.href) if got != tt.expected { t.Errorf("resolveURL(%q, %q) = %q, want %q", tt.base, tt.href, got, tt.expected) } }) } } func TestExtractPathFromURL(t *testing.T) { tests := []struct { href string expected string }{ {"/library/test.html", "library/test"}, {"library/test.html", "library/test"}, {"/library/test.html#module-test", "library/test"}, } for _, tt := range tests { t.Run(tt.href, func(t *testing.T) { got := extractPathFromURL(tt.href) if got != tt.expected { t.Errorf("extractPathFromURL(%q) = %q, want %q", tt.href, got, tt.expected) } }) } }

test — Regression tests package¶

`test` — Regression tests package¶