feat: convert examples to testable examples for pkg.go.dev

Amer Khaledrequested to merge
gitlab-community/gitlab-org/api/client-go:amrkhald777/convert-examples-to-testable-examples into main

Convert all examples from examples/ directory to testable examples that integrate with pkg.go.dev documentation system.

Changes:

  • Add 24 testable example files with package gitlab_test
  • Implement httptest mocking for all examples (no GitLab instance required)
  • Add Output comments for go test verification
  • All examples pass 'go test' successfully
  • Remove old examples/ directory

Examples include:

  • Applications, BasicAuth, ClusterAgents, Deployments
  • Impersonation, Import (Bitbucket Cloud/Server), Labels
  • Languages, MergeRequests (standard and auto-merge)
  • OAuth2, Pagination (standard and keyset)
  • PersonalAccessTokens (list, revoke, rotate)
  • Pipelines, Projects, Repositories, Services, Topics, Webhooks

Benefits:

  • Examples verified by CI/CD through go test
  • Examples display on pkg.go.dev with syntax highlighting
  • Users can copy/paste working code directly
  • API changes caught by example tests

Closes #2194 (closed)

Merge request reports