Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add function docs to non-deprecated packages #1500

Merged
merged 3 commits into from
Dec 18, 2024

Conversation

Tofel
Copy link
Contributor

@Tofel Tofel commented Dec 17, 2024


Below is a summarization created by an LLM (gpt-4-0125-preview). Be mindful of hallucinations and verify accuracy.

Why

The changes introduce enhancements and new functionalities across various components like GitHub, mock servers, PostgreSQL, RPC clients, Docker containers for blockchain environments, and Grafana integration. These updates improve developer experience, facilitate testing, and expand the capabilities of the software in areas such as blockchain testing, data storage, and monitoring.

What

  • lib/client/github.go
    • Added documentation for NewGithubClient function.
  • lib/client/mockserver.go
    • Added SetAnyValueResponse method documentation.
  • lib/client/postgres.go
    • Added documentation for ConnectDB function.
  • lib/client/rpc.go
    • Documented GethSetHead and StartAnvil functions.
  • lib/docker/docker.go
    • Added comments for CreateNetwork function.
  • lib/docker/test_env/besu_base.go
    • Added comments for methods like WithTestInstance, StartContainer, GetInternalExecutionURL, etc.
  • lib/docker/test_env/env_component.go
    • Documented methods like WithContainerName, WithStartupTimeout, WithContainerImageWithVersion, etc.
  • lib/docker/test_env/erigon_base.go
    • Added documentation for methods like WithTestInstance, StartContainer, GetInternalExecutionURL, etc.
  • lib/docker/test_env/eth2_init_helpers.go
    • Added comments for NewInitHelper and WithTestInstance.
  • lib/docker/test_env/eth_common.go
    • Updated GethConsensusMechanism to GetConsensusMechanism in the interface.
  • lib/docker/test_env/ethereum_env.go
    • Documented the EthereumNetworkBuilder and its methods.
  • lib/docker/test_env/genesis_generator.go
    • Added documentation for NewEthGenesisGenerator, WithTestInstance, and StartContainer.
  • lib/docker/test_env/genesis_generator_helpers.go
    • Documented NewExitCodeStrategy and its methods.
  • lib/docker/test_env/geth_base.go
    • Added comments for WithTestInstance, StartContainer, GetInternalExecutionURL, etc.
  • lib/docker/test_env/job_distributor/jd.go
    • Documented methods like StartContainer, New, WithTestInstance, etc.
  • lib/docker/test_env/kafka.go
    • Added comments for NewKafka, WithTestInstance, WithContainerName, etc.
  • lib/docker/test_env/killgrave.go
    • Documented NewKillgrave, WithTestInstance, StartContainer, etc.
  • lib/docker/test_env/mockserver.go
    • Added documentation for NewMockServer, WithTestInstance, SetExternalAdapterMocks, and StartContainer.
  • lib/docker/test_env/nethermind_base.go
    • Added comments for methods like WithTestInstance, StartContainer, GetInternalExecutionURL, etc.
  • lib/docker/test_env/postgres.go
    • Documented options and methods for PostgreSQL database setup.
  • lib/docker/test_env/prysm.go
    • Added documentation for NewPrysmBeaconChain, WithTestInstance, and StartContainer.
  • lib/docker/test_env/reth_base.go
    • Documented WithTestInstance, StartContainer, GetInternalExecutionURL, etc.
  • lib/docker/test_env/schema_registry.go
    • Added comments for NewSchemaRegistry, WithTestInstance, WithContainerName, and StartContainer.
  • lib/docker/test_env/utils.go
    • Documented utility functions like NatPortFormat, NatPort, GetEndpoint, etc.
  • lib/docker/test_env/validator_keys_generator.go
    • Added documentation for NewValKeysGeneretor, WithTestInstance, and StartContainer.
  • lib/docker/test_env/wait_strategy.go
    • Documented strategies for waiting on services like HTTP and WebSocket.
  • lib/docker/test_env/zookeeper.go
    • Added comments for NewZookeeper, WithTestInstance, WithContainerName, and StartContainer.
  • lib/grafana/client.go
    • Documented Grafana client and its methods related to alerts, annotations, and dashboards.
  • lib/logging/log.go
    • Added documentation for Write, Printf, and Init methods.

@Tofel Tofel marked this pull request as ready for review December 18, 2024 15:51
@Tofel Tofel requested review from sebawo and a team as code owners December 18, 2024 15:51
@cl-sonarqube-production
Copy link

@Tofel Tofel merged commit ed7d19c into main Dec 18, 2024
52 of 53 checks passed
@Tofel Tofel deleted the tt-1717_tt-1719_tt-1724-function-docs branch December 18, 2024 16:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants