[ { "path": ".errcheck-excludes", "content": "(go.mongodb.org/mongo-driver/x/mongo/driver.Connection).Close\n(*go.mongodb.org/mongo-driver/x/network/connection.connection).Close\n(go.mongodb.org/mongo-driver/x/network/connection.Connection).Close\n(*go.mongodb.org/mongo-driver/x/mongo/driver/topology.connection).close\n(*go.mongodb.org/mongo-driver/x/mongo/driver/topology.Topology).Unsubscribe\n(*go.mongodb.org/mongo-driver/x/mongo/driver/topology.Server).Close\n(*go.mongodb.org/mongo-driver/x/network/connection.pool).closeConnection\n(*go.mongodb.org/mongo-driver/x/mongo/driver/topology.pool).close\n(go.mongodb.org/mongo-driver/x/network/wiremessage.ReadWriteCloser).Close\n(*go.mongodb.org/mongo-driver/mongo.Cursor).Close\n(*go.mongodb.org/mongo-driver/mongo.ChangeStream).Close\n(*go.mongodb.org/mongo-driver/mongo.Client).Disconnect\n(net.Conn).Close\nencoding/pem.Encode\nfmt.Fprintf\nfmt.Fprint\n" }, { "path": ".evergreen/config.yml", "content": "########################################\n# Evergreen Template for MongoDB Drivers\n########################################\n\n# When a task that used to pass starts to fail\n# Go through all versions that may have been skipped to detect\n# when the task started failing\nstepback: true\n# Mark a failure as a system/bootstrap failure (purple box) rather then a task\n# failure by default.\n# Actual testing tasks are marked with `type: test`\ncommand_type: setup\n# Fail builds when pre tasks fail.\npre_error_fails_task: true\n# Protect the CI from long or indefinite runtimes.\nexec_timeout_secs: 3600\n# What to do when evergreen hits the timeout (`post:` tasks are run automatically)\ntimeout:\n - command: subprocess.exec\n params:\n binary: bash\n args: [ls, -la]\nfunctions:\n setup-system:\n # Executes clone and applies the submitted patch, if any\n - command: git.get_project\n type: system\n params:\n directory: src/go.mongodb.org/mongo-driver\n - command: shell.exec\n params:\n working_dir: \"src/go.mongodb.org/mongo-driver\"\n script: |\n git submodule update --init\n # Make an env.sh and evergreen expansion file with dynamic values\n - command: subprocess.exec\n params:\n binary: bash\n working_dir: src/go.mongodb.org/mongo-driver\n env:\n GOROOT: ${GO_DIST}\n IS_PATCH: ${is_patch}\n VERSION_ID: ${version_id}\n # Define an alias for the task runner script.\n TASK_RUNNER_ALIAS: &task-runner src/go.mongodb.org/mongo-driver/.evergreen/run-task.sh\n args: [.evergreen/setup-system.sh]\n - command: expansions.update\n params:\n file: src/go.mongodb.org/mongo-driver/expansion.yml\n - command: subprocess.exec\n params:\n binary: bash\n include_expansions_in_env: [\"PROJECT_DIRECTORY\"]\n args:\n - \"${DRIVERS_TOOLS}/.evergreen/setup.sh\"\n handle-test-artifacts:\n - command: gotest.parse_files\n params:\n optional_output: \"true\"\n files:\n - \"src/go.mongodb.org/mongo-driver/*.suite\"\n - command: ec2.assume_role\n params:\n role_arn: ${assume_role_arn}\n - command: s3.put\n params:\n aws_key: ${AWS_ACCESS_KEY_ID}\n aws_secret: ${AWS_SECRET_ACCESS_KEY}\n aws_session_token: ${AWS_SESSION_TOKEN}\n local_file: ${DRIVERS_TOOLS}/.evergreen/test_logs.tar.gz\n remote_file: ${build_variant}/${revision}/${version_id}/${build_id}/logs/${task_id}-${execution}-drivers-tools-logs.tar.gz\n bucket: ${aws_bucket}\n permissions: public-read\n content_type: ${content_type|application/x-gzip}\n display_name: \"drivers-tools-logs.tar.gz\"\n - command: s3.put\n params:\n aws_key: ${AWS_ACCESS_KEY_ID}\n aws_secret: ${AWS_SECRET_ACCESS_KEY}\n aws_session_token: ${AWS_SESSION_TOKEN}\n optional: true\n local_file: ${PROJECT_DIRECTORY}/fuzz.tgz\n remote_file: ${build_variant}/${revision}/${version_id}/${build_id}/${task_id}-${execution}-fuzz.tgz\n bucket: ${aws_bucket}\n permissions: public-read\n content_type: application/x-gzip\n display_name: \"fuzz.tgz\"\n - command: subprocess.exec\n params:\n binary: bash\n args: [*task-runner, evg-gather-test-suites]\n - command: s3.put\n params:\n aws_key: ${AWS_ACCESS_KEY_ID}\n aws_secret: ${AWS_SECRET_ACCESS_KEY}\n aws_session_token: ${AWS_SESSION_TOKEN}\n local_file: src/go.mongodb.org/mongo-driver/test_suite.tgz\n optional: true\n remote_file: ${build_variant}/${revision}/${version_id}/${build_id}/logs/${task_id}-${execution}-test_suite.tgz\n bucket: ${aws_bucket}\n permissions: public-read\n content_type: ${content_type|text/plain}\n display_name: test_suite.tgz\n bootstrap-mongohoused:\n - command: ec2.assume_role\n params:\n role_arn: ${aws_test_secrets_role}\n - command: subprocess.exec\n params:\n binary: bash\n add_expansions_to_env: true\n args:\n - ${DRIVERS_TOOLS}/.evergreen/atlas_data_lake/pull-mongohouse-image.sh\n - command: subprocess.exec\n params:\n binary: bash\n args:\n - ${DRIVERS_TOOLS}/.evergreen/atlas_data_lake/run-mongohouse-image.sh\n bootstrap-mongo-orchestration:\n - command: subprocess.exec\n params:\n binary: bash\n env:\n MONGODB_VERSION: ${VERSION}\n include_expansions_in_env: [TOPOLOGY, AUTH, SSL, ORCHESTRATION_FILE, REQUIRE_API_VERSION, LOAD_BALANCER]\n args: [\"${DRIVERS_TOOLS}/.evergreen/run-orchestration.sh\"]\n - command: expansions.update\n params:\n file: mo-expansion.yml\n ocsp-bootstrap-mongo-orchestration:\n - command: subprocess.exec\n params:\n binary: bash\n env:\n MONGODB_VERSION: ${VERSION}\n include_expansions_in_env: [TOPOLOGY, AUTH, SSL, ORCHESTRATION_FILE]\n args: [\"${DRIVERS_TOOLS}/.evergreen/run-orchestration.sh\"]\n - command: expansions.update\n params:\n file: mo-expansion.yml\n teardown:\n - command: subprocess.exec\n params:\n binary: bash\n args:\n # Ensure the instance profile is reassigned for aws tests.\n - ${DRIVERS_TOOLS}/.evergreen/auth_aws/teardown.sh\n - command: subprocess.exec\n params:\n binary: bash\n args:\n - ${DRIVERS_TOOLS}/.evergreen/csfle/teardown.sh\n - command: subprocess.exec\n params:\n binary: bash\n args:\n - ${DRIVERS_TOOLS}/.evergreen/ocsp/teardown.sh\n - command: subprocess.exec\n params:\n binary: bash\n args:\n - ${DRIVERS_TOOLS}/.evergreen/teardown.sh\n assume-test-secrets-ec2-role:\n - command: ec2.assume_role\n params:\n role_arn: ${aws_test_secrets_role}\n duration_seconds: 1800\n run-oidc-auth-test-with-test-credentials:\n - command: subprocess.exec\n type: test\n params:\n binary: bash\n env:\n OIDC: oidc\n include_expansions_in_env: [DRIVERS_TOOLS, AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN]\n args: [*task-runner, test-oidc]\n run-tests:\n - command: subprocess.exec\n params:\n binary: bash\n env:\n GO_BUILD_TAGS: \"cse,mongointernal\"\n include_expansions_in_env: [\"TOPOLOGY\", \"AUTH\", \"SSL\", \"SKIP_CSOT_TESTS\", \"MONGODB_URI\", \"CRYPT_SHARED_LIB_PATH\", \"SKIP_CRYPT_SHARED_LIB\", \"RACE\", \"MONGO_GO_DRIVER_COMPRESSOR\", \"REQUIRE_API_VERSION\", \"LOAD_BALANCER\"]\n args: [*task-runner, setup-test]\n - command: subprocess.exec\n type: test\n retry_on_failure: true\n params:\n binary: bash\n args: [*task-runner, \"${DEFAULT_TASK}\"]\n create-api-report:\n - command: subprocess.exec\n type: test\n params:\n binary: bash\n add_expansions_to_env: true\n env:\n BASE_SHA: \"${revision}\"\n HEAD_SHA: \"${github_commit}\"\n args: [*task-runner, api-report]\n \"backport pr\":\n - command: subprocess.exec\n type: test\n params:\n binary: bash\n env:\n COMMIT: \"${github_commit}\"\n PR_TASK: backport-pr\n args: [*task-runner, pr-task]\n send-perf-data:\n # Here we begin to generate the request to send the data to SPS\n - command: shell.exec\n params:\n script: |\n # We use the requester expansion to determine whether the data is from a mainline evergreen run or not\n if [ \"${requester}\" == \"commit\" ]; then\n is_mainline=true\n else\n is_mainline=false\n fi\n\n # We parse the username out of the order_id as patches append that in and SPS does not need that information\n parsed_order_id=$(echo \"${revision_order_id}\" | awk -F'_' '{print $NF}')\n # Submit the performance data to the SPS endpoint\n response=$(curl -s -w \"\\nHTTP_STATUS:%{http_code}\" -X 'POST' \\\n \"https://performance-monitoring-api.corp.mongodb.com/raw_perf_results/cedar_report?project=${project_id}&version=${version_id}&variant=${build_variant}&order=$parsed_order_id&task_name=${task_name}&task_id=${task_id}&execution=${execution}&mainline=$is_mainline\" \\\n -H 'accept: application/json' \\\n -H 'Content-Type: application/json' \\\n -d @src/go.mongodb.org/mongo-driver/perf.json)\n\n http_status=$(echo \"$response\" | grep \"HTTP_STATUS\" | awk -F':' '{print $2}')\n response_body=$(echo \"$response\" | sed '/HTTP_STATUS/d')\n\n # We want to throw an error if the data was not successfully submitted\n if [ \"$http_status\" -ne 200 ]; then\n echo \"Error: Received HTTP status $http_status\"\n echo \"Response Body: $response_body\"\n exit 1\n fi\n\n echo \"Response Body: $response_body\"\n echo \"HTTP Status: $http_status\"\n send-perf-pr-comment:\n - command: subprocess.exec\n type: test\n params:\n binary: bash\n add_expansions_to_env: true\n env:\n VERSION_ID: ${version_id}\n BASE_SHA: \"${revision}\"\n HEAD_SHA: \"${github_commit}\"\n include_expansions_in_env: [PERF_URI_PRIVATE_ENDPOINT]\n args: [*task-runner, perf-pr-comment]\n run-enterprise-auth-tests:\n - command: ec2.assume_role\n params:\n role_arn: \"${aws_test_secrets_role}\"\n - command: subprocess.exec\n params:\n binary: bash\n include_expansions_in_env: [AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN]\n env:\n TEST_ENTERPRISE_AUTH: plain\n args: [*task-runner, setup-test]\n - command: subprocess.exec\n type: test\n retry_on_failure: true\n params:\n binary: bash\n args: [*task-runner, --silent, evg-test-enterprise-auth]\n run-enterprise-gssapi-auth-tests:\n - command: ec2.assume_role\n params:\n role_arn: \"${aws_test_secrets_role}\"\n - command: subprocess.exec\n params:\n binary: bash\n include_expansions_in_env: [AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN]\n env:\n TEST_ENTERPRISE_AUTH: gssapi\n args: [*task-runner, setup-test]\n - command: subprocess.exec\n type: test\n retry_on_failure: true\n params:\n binary: bash\n args: [*task-runner, --silent, evg-test-enterprise-auth]\n run-atlas-test:\n - command: ec2.assume_role\n params:\n role_arn: \"${aws_test_secrets_role}\"\n - command: subprocess.exec\n params:\n binary: bash\n include_expansions_in_env: [AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN]\n env:\n TEST_ATLAS_CONNECT: \"1\"\n args: [*task-runner, setup-test]\n - command: subprocess.exec\n type: test\n retry_on_failure: true\n params:\n binary: bash\n args: [*task-runner, test-atlas-connect]\n run-ocsp-test:\n - command: subprocess.exec\n params:\n binary: bash\n env:\n TOPOLOGY: server\n AUTH: auth\n SSL: ssl\n include_expansions_in_env: [OCSP_ALGORITHM, MONGODB_URI]\n args: [*task-runner, setup-test]\n - command: subprocess.exec\n type: test\n retry_on_failure: true\n params:\n binary: bash\n include_expansions_in_env: [OCSP_TLS_SHOULD_SUCCEED]\n args: [*task-runner, evg-test-ocsp]\n run-versioned-api-test:\n - command: subprocess.exec\n params:\n binary: bash\n env:\n GO_BUILD_TAGS: cse\n include_expansions_in_env: [AUTH, SSL, MONGODB_URI, TOPOLOGY, MONGO_GO_DRIVER_COMPRESSOR, REQUIRE_API_VERSION, SKIP_CRYPT_SHARED_LIB, CRYPT_SHARED_LIB_PATH]\n args: [*task-runner, setup-test]\n - command: subprocess.exec\n type: test\n retry_on_failure: true\n params:\n binary: bash\n args: [*task-runner, evg-test-versioned-api]\n run-load-balancer-tests:\n - command: subprocess.exec\n params:\n binary: bash\n include_expansions_in_env: [SINGLE_MONGOS_LB_URI, MULTI_MONGOS_LB_URI, AUTH, SSL, MONGO_GO_DRIVER_COMPRESSOR]\n env:\n LOAD_BALANCER: \"true\"\n args: [*task-runner, setup-test]\n - command: subprocess.exec\n type: test\n retry_on_failure: true\n params:\n binary: bash\n args: [*task-runner, evg-test-load-balancers]\n run-docker-test:\n - command: subprocess.exec\n type: test\n params:\n binary: \"bash\"\n env:\n TASKFILE_TARGET: test-short\n args: [*task-runner, run-docker]\n - command: subprocess.exec\n type: test\n params:\n binary: \"bash\"\n env:\n TOPOLOGY: sharded_cluster\n TASKFILE_TARGET: test-short\n args: [*task-runner, run-docker]\n run-goleak-test:\n - command: subprocess.exec\n type: test\n params:\n binary: \"bash\"\n include_expansions_in_env: [\"MONGODB_URI\"]\n args: [*task-runner, test-goleak]\n \"run oidc k8s test\":\n - command: subprocess.exec\n type: test\n params:\n binary: bash\n include_expansions_in_env: [AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, VARIANT, DRIVERS_TOOLS]\n env:\n OIDC_ENV: k8s\n args: [*task-runner, test-oidc-remote]\n run-ocsp-server:\n - command: subprocess.exec\n params:\n binary: bash\n background: true\n include_expansions_in_env: [SERVER_TYPE, OCSP_ALGORITHM]\n args:\n - ${DRIVERS_TOOLS}/.evergreen/ocsp/setup.sh\n run-load-balancer:\n - command: subprocess.exec\n params:\n binary: \"bash\"\n include_expansions_in_env: [\"MONGODB-AWS\", \"MONGODB_URI\"]\n args: [\"${DRIVERS_TOOLS}/.evergreen/run-load-balancer.sh\", start]\n - command: expansions.update\n params:\n file: lb-expansion.yml\n run-search-index-tests:\n - command: subprocess.exec\n type: test\n params:\n binary: \"bash\"\n env:\n SEARCH_INDEX_URI: \"${SEARCH_INDEX_URI}\"\n args: [*task-runner, evg-test-search-index]\n add-aws-auth-variables-to-file:\n - command: ec2.assume_role\n params:\n role_arn: ${aws_test_secrets_role}\n - command: subprocess.exec\n type: test\n params:\n include_expansions_in_env: [\"AWS_ACCESS_KEY_ID\", \"AWS_SECRET_ACCESS_KEY\", \"AWS_SESSION_TOKEN\"]\n binary: \"bash\"\n args:\n - ${DRIVERS_TOOLS}/.evergreen/auth_aws/setup-secrets.sh\n run-aws-auth-test-with-regular-aws-credentials:\n - command: subprocess.exec\n type: test\n params:\n binary: \"bash\"\n env:\n AWS_TEST: regular\n args: [*task-runner, evg-test-aws]\n run-aws-auth-test-with-assume-role-credentials:\n - command: subprocess.exec\n type: test\n params:\n binary: \"bash\"\n env:\n AWS_TEST: assume-role\n args: [*task-runner, evg-test-aws]\n run-aws-auth-test-with-aws-EC2-credentials:\n - command: subprocess.exec\n type: test\n params:\n binary: bash\n include_expansions_in_env: [SKIP_EC2_AUTH_TEST]\n env:\n AWS_TEST: ec2\n args: [*task-runner, evg-test-aws]\n run-aws-auth-test-with-aws-credentials-as-environment-variables:\n - command: subprocess.exec\n type: test\n params:\n binary: \"bash\"\n env:\n AWS_TEST: env-creds\n args: [*task-runner, evg-test-aws]\n run-aws-auth-test-with-aws-credentials-and-session-token-as-environment-variables:\n - command: subprocess.exec\n type: test\n params:\n binary: \"bash\"\n env:\n AWS_TEST: session-creds\n args: [*task-runner, evg-test-aws]\n run-aws-ECS-auth-test:\n - command: subprocess.exec\n type: test\n params:\n binary: \"bash\"\n include_expansions_in_env: [SKIP_ECS_AUTH_TEST]\n args: [*task-runner, evg-test-aws-ecs]\n run-aws-auth-test-with-aws-web-identity-credentials:\n - command: subprocess.exec\n type: test\n params:\n binary: bash\n include_expansions_in_env: [SKIP_WEB_IDENTITY_AUTH_TEST]\n env:\n AWS_TEST: web-identity\n args: [*task-runner, evg-test-aws]\n - command: subprocess.exec\n type: test\n params:\n binary: bash\n env:\n AWS_ROLE_SESSION_NAME: test\n AWS_TEST: web-identity\n include_expansions_in_env: [SKIP_WEB_IDENTITY_AUTH_TEST]\n args: [*task-runner, evg-test-aws]\n start-cse-servers:\n - command: ec2.assume_role\n params:\n role_arn: ${aws_test_secrets_role}\n - command: subprocess.exec\n params:\n working_dir: src/go.mongodb.org/mongo-driver\n binary: bash\n background: true\n include_expansions_in_env: [\"AWS_ACCESS_KEY_ID\", \"AWS_SECRET_ACCESS_KEY\", \"AWS_SESSION_TOKEN\", \"DRIVERS_TOOLS\"]\n # This cannot use task because it will hang on Windows.\n args: [etc/setup-encryption.sh]\n - command: subprocess.exec\n params:\n binary: bash\n args: [\"${DRIVERS_TOOLS}/.evergreen/csfle/await-servers.sh\"]\n run-kmip-tests:\n - command: subprocess.exec\n params:\n binary: \"bash\"\n env:\n GO_BUILD_TAGS: cse\n include_expansions_in_env: [AUTH, SSL, MONGODB_URI, TOPOLOGY, MONGO_GO_DRIVER_COMPRESSOR]\n args: [*task-runner, setup-test]\n - command: subprocess.exec\n type: test\n retry_on_failure: true\n params:\n binary: \"bash\"\n env:\n KMS_MOCK_SERVERS_RUNNING: \"true\"\n args: [*task-runner, evg-test-kmip]\n run-client-side-encryption-test:\n - command: subprocess.exec\n params:\n binary: \"bash\"\n env:\n GO_BUILD_TAGS: cse\n include_expansions_in_env: [AUTH, SSL, MONGODB_URI, TOPOLOGY, MONGO_GO_DRIVER_COMPRESSOR, CRYPT_SHARED_LIB_PATH]\n args: [*task-runner, setup-test]\n - command: subprocess.exec\n type: test\n retry_on_failure: true\n params:\n binary: \"bash\"\n env:\n KMS_MOCK_SERVERS_RUNNING: \"true\"\n KMS_FAILPOINT_CA_FILE: \"${DRIVERS_TOOLS}/.evergreen/x509gen/ca.pem\"\n KMS_FAILPOINT_SERVER_RUNNING: \"true\"\n args: [*task-runner, evg-test-client-side-encryption]\n run-fuzz-tests:\n - command: subprocess.exec\n type: test\n params:\n binary: \"bash\"\n args: [*task-runner, run-fuzz]\npre:\n - func: setup-system\npost:\n - func: teardown\n - func: handle-test-artifacts\ntasks:\n - name: static-analysis\n tags: [\"static-analysis\"]\n commands:\n - command: subprocess.exec\n params:\n binary: bash\n args: [*task-runner, check-fmt, check-license, check-modules, lint]\n - name: govulncheck\n tags: [\"static-analysis\"]\n commands:\n - command: subprocess.exec\n type: test\n params:\n binary: bash\n args: [*task-runner, govulncheck]\n - name: pull-request-helpers\n allowed_requesters: [\"patch\", \"github_pr\"]\n commands:\n - func: assume-test-secrets-ec2-role\n - func: \"create-api-report\"\n - name: backport-pr\n allowed_requesters: [\"commit\"]\n commands:\n - func: \"backport pr\"\n - name: perf\n tags: [\"performance\"]\n exec_timeout_secs: 7200\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n VERSION: \"v6.0-perf\"\n TOPOLOGY: \"server\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n SKIP_LEGACY_SHELL: \"true\"\n - command: subprocess.exec\n params:\n binary: bash\n args: [*task-runner, driver-benchmark]\n - func: assume-test-secrets-ec2-role\n - func: send-perf-data\n - func: send-perf-pr-comment\n - name: test-standalone-noauth-nossl\n tags: [\"test\", \"standalone\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - name: test-standalone-noauth-nossl-snappy-compression\n tags: [\"test\", \"standalone\", \"compression\", \"snappy\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n MONGO_GO_DRIVER_COMPRESSOR: \"snappy\"\n - name: test-standalone-noauth-nossl-zlib-compression\n tags: [\"test\", \"standalone\", \"compression\", \"zlib\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n MONGO_GO_DRIVER_COMPRESSOR: \"zlib\"\n - name: test-standalone-noauth-nossl-zstd-compression\n tags: [\"test\", \"standalone\", \"compression\", \"zstd\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n MONGO_GO_DRIVER_COMPRESSOR: \"zstd\"\n - name: test-standalone-auth-ssl\n tags: [\"test\", \"standalone\", \"authssl\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n - name: test-standalone-auth-nossl\n tags: [\"test\", \"standalone\", \"authssl\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"auth\"\n SSL: \"nossl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"auth\"\n SSL: \"nossl\"\n - name: test-standalone-auth-ssl-snappy-compression\n tags: [\"test\", \"standalone\", \"authssl\", \"compression\", \"snappy\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n MONGO_GO_DRIVER_COMPRESSOR: \"snappy\"\n - name: test-standalone-auth-ssl-zlib-compression\n tags: [\"test\", \"standalone\", \"authssl\", \"compression\", \"zlib\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n MONGO_GO_DRIVER_COMPRESSOR: \"zlib\"\n - name: test-standalone-auth-ssl-zstd-compression\n tags: [\"test\", \"standalone\", \"authssl\", \"compression\", \"zstd\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n MONGO_GO_DRIVER_COMPRESSOR: \"zstd\"\n - name: test-ocsp-rsa-valid-cert-server-staples\n tags: [\"ocsp\", \"ocsp-rsa\", \"ocsp-staple\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"rsa\"\n SERVER_TYPE: valid\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"rsa-basic-tls-ocsp-mustStaple.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"rsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"true\"\n - name: test-ocsp-rsa-invalid-cert-server-staples\n tags: [\"ocsp\", \"ocsp-rsa\", \"ocsp-staple\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"rsa\"\n SERVER_TYPE: revoked\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"rsa-basic-tls-ocsp-mustStaple.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"rsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"false\"\n - name: test-ocsp-rsa-valid-cert-server-does-not-staple\n tags: [\"ocsp\", \"ocsp-rsa\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"rsa\"\n SERVER_TYPE: valid\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"rsa-basic-tls-ocsp-disableStapling.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"rsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"true\"\n - name: test-ocsp-rsa-invalid-cert-server-does-not-staple\n tags: [\"ocsp\", \"ocsp-rsa\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"rsa\"\n SERVER_TYPE: revoked\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"rsa-basic-tls-ocsp-disableStapling.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"rsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"false\"\n - name: test-ocsp-rsa-soft-fail\n tags: [\"ocsp\", \"ocsp-rsa\"]\n commands:\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"rsa-basic-tls-ocsp-disableStapling.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"rsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"true\"\n - name: test-ocsp-rsa-malicious-invalid-cert-mustStaple-server-does-not-staple\n tags: [\"ocsp\", \"ocsp-rsa\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"rsa\"\n SERVER_TYPE: revoked\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"rsa-basic-tls-ocsp-mustStaple-disableStapling.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"rsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"false\"\n - name: test-ocsp-rsa-malicious-no-responder-mustStaple-server-does-not-staple\n tags: [\"ocsp\", \"ocsp-rsa\"]\n commands:\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"rsa-basic-tls-ocsp-mustStaple-disableStapling.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"rsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"false\"\n - name: test-ocsp-rsa-delegate-valid-cert-server-staples\n tags: [\"ocsp\", \"ocsp-rsa\", \"ocsp-staple\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"rsa\"\n SERVER_TYPE: valid-delegate\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"rsa-basic-tls-ocsp-mustStaple.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"rsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"true\"\n - name: test-ocsp-rsa-delegate-invalid-cert-server-staples\n tags: [\"ocsp\", \"ocsp-rsa\", \"ocsp-staple\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"rsa\"\n SERVER_TYPE: revoked-delegate\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"rsa-basic-tls-ocsp-mustStaple.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"rsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"false\"\n - name: test-ocsp-rsa-delegate-valid-cert-server-does-not-staple\n tags: [\"ocsp\", \"ocsp-rsa\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"rsa\"\n SERVER_TYPE: valid-delegate\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"rsa-basic-tls-ocsp-disableStapling.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"rsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"true\"\n - name: test-ocsp-rsa-delegate-invalid-cert-server-does-not-staple\n tags: [\"ocsp\", \"ocsp-rsa\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"rsa\"\n SERVER_TYPE: revoked-delegate\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"rsa-basic-tls-ocsp-disableStapling.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"rsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"false\"\n - name: test-ocsp-rsa-delegate-malicious-invalid-cert-mustStaple-server-does-not-staple\n tags: [\"ocsp\", \"ocsp-rsa\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"rsa\"\n SERVER_TYPE: revoked-delegate\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"rsa-basic-tls-ocsp-mustStaple-disableStapling.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"rsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"false\"\n - name: test-ocsp-ecdsa-valid-cert-server-staples\n tags: [\"ocsp\", \"ocsp-ecdsa\", \"ocsp-staple\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n SERVER_TYPE: valid\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"ecdsa-basic-tls-ocsp-mustStaple.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"true\"\n - name: test-ocsp-ecdsa-invalid-cert-server-staples\n tags: [\"ocsp\", \"ocsp-ecdsa\", \"ocsp-staple\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n SERVER_TYPE: revoked\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"ecdsa-basic-tls-ocsp-mustStaple.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"false\"\n - name: test-ocsp-ecdsa-valid-cert-server-does-not-staple\n tags: [\"ocsp\", \"ocsp-ecdsa\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n SERVER_TYPE: valid\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"ecdsa-basic-tls-ocsp-disableStapling.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"true\"\n - name: test-ocsp-ecdsa-invalid-cert-server-does-not-staple\n tags: [\"ocsp\", \"ocsp-ecdsa\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n SERVER_TYPE: revoked\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"ecdsa-basic-tls-ocsp-disableStapling.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"false\"\n - name: test-ocsp-ecdsa-soft-fail\n tags: [\"ocsp\", \"ocsp-ecdsa\"]\n commands:\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"ecdsa-basic-tls-ocsp-disableStapling.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"true\"\n - name: test-ocsp-ecdsa-malicious-invalid-cert-mustStaple-server-does-not-staple\n tags: [\"ocsp\", \"ocsp-ecdsa\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n SERVER_TYPE: revoked\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"ecdsa-basic-tls-ocsp-mustStaple-disableStapling.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"false\"\n - name: test-ocsp-ecdsa-malicious-no-responder-mustStaple-server-does-not-staple\n tags: [\"ocsp\", \"ocsp-ecdsa\"]\n commands:\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"ecdsa-basic-tls-ocsp-mustStaple-disableStapling.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"false\"\n - name: test-ocsp-ecdsa-delegate-valid-cert-server-staples\n tags: [\"ocsp\", \"ocsp-ecdsa\", \"ocsp-staple\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n SERVER_TYPE: valid-delegate\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"ecdsa-basic-tls-ocsp-mustStaple.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"true\"\n - name: test-ocsp-ecdsa-delegate-invalid-cert-server-staples\n tags: [\"ocsp\", \"ocsp-ecdsa\", \"ocsp-staple\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n SERVER_TYPE: revoked-delegate\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"ecdsa-basic-tls-ocsp-mustStaple.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"false\"\n - name: test-ocsp-ecdsa-delegate-valid-cert-server-does-not-staple\n tags: [\"ocsp\", \"ocsp-ecdsa\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n SERVER_TYPE: valid-delegate\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"ecdsa-basic-tls-ocsp-disableStapling.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"true\"\n - name: test-ocsp-ecdsa-delegate-invalid-cert-server-does-not-staple\n tags: [\"ocsp\", \"ocsp-ecdsa\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n SERVER_TYPE: revoked-delegate\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"ecdsa-basic-tls-ocsp-disableStapling.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"false\"\n - name: test-ocsp-ecdsa-delegate-malicious-invalid-cert-mustStaple-server-does-not-staple\n tags: [\"ocsp\", \"ocsp-ecdsa\"]\n commands:\n - func: run-ocsp-server\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n SERVER_TYPE: revoked-delegate\n - func: ocsp-bootstrap-mongo-orchestration\n vars:\n ORCHESTRATION_FILE: \"ecdsa-basic-tls-ocsp-mustStaple-disableStapling.json\"\n - func: run-ocsp-test\n vars:\n OCSP_ALGORITHM: \"ecdsa\"\n OCSP_TLS_SHOULD_SUCCEED: \"false\"\n - name: test-docker-runner\n commands:\n - func: bootstrap-mongo-orchestration\n - func: run-docker-test\n - name: test-goroutine-leaks-replicaset\n tags: [\"goleak\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"replica_set\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - func: run-goleak-test\n - name: test-goroutine-leaks-sharded\n tags: [\"goleak\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - func: run-goleak-test\n - name: test-load-balancer-noauth-nossl\n tags: [\"load-balancer\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n LOAD_BALANCER: \"true\"\n - func: run-load-balancer\n - func: run-load-balancer-tests\n vars:\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - name: test-load-balancer-auth-ssl\n tags: [\"load-balancer\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n LOAD_BALANCER: \"true\"\n - func: run-load-balancer\n - func: run-load-balancer-tests\n vars:\n AUTH: \"auth\"\n SSL: \"ssl\"\n - name: test-race\n tags: [\"race\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"replica_set\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"replica_set\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n RACE: \"-race\"\n - name: test-replicaset-noauth-nossl\n tags: [\"test\", \"replicaset\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"replica_set\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"replica_set\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - name: test-replicaset-auth-ssl\n tags: [\"test\", \"replicaset\", \"authssl\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"replica_set\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"replica_set\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n - name: test-replicaset-auth-ssl-mongocryptd\n tags: [\"test\", \"replicaset\", \"authssl\", \"mongocryptd\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"replica_set\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"replica_set\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n # Don't use the crypt_shared library, which should cause all of the tests to fall\n # back to using mongocryptd instead of crypt_shared.\n SKIP_CRYPT_SHARED_LIB: \"true\"\n - name: test-replicaset-auth-nossl\n tags: [\"test\", \"replicaset\", \"authssl\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"replica_set\"\n AUTH: \"auth\"\n SSL: \"nossl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"replica_set\"\n AUTH: \"auth\"\n SSL: \"nossl\"\n - name: test-sharded-noauth-nossl\n tags: [\"test\", \"sharded\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - name: test-sharded-noauth-nossl-snappy-compression\n tags: [\"test\", \"sharded\", \"compression\", \"snappy\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n MONGO_GO_DRIVER_COMPRESSOR: \"snappy\"\n - name: test-sharded-noauth-nossl-zlib-compression\n tags: [\"test\", \"sharded\", \"compression\", \"zlib\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n MONGO_GO_DRIVER_COMPRESSOR: \"zlib\"\n - name: test-sharded-noauth-nossl-zstd-compression\n tags: [\"test\", \"sharded\", \"compression\", \"zstd\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n MONGO_GO_DRIVER_COMPRESSOR: \"zstd\"\n - name: test-sharded-auth-ssl\n tags: [\"test\", \"sharded\", \"authssl\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n - name: test-sharded-auth-ssl-snappy-compression\n tags: [\"test\", \"sharded\", \"authssl\", \"compression\", \"snappy\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n MONGO_GO_DRIVER_COMPRESSOR: \"snappy\"\n - name: test-sharded-auth-ssl-zlib-compression\n tags: [\"test\", \"sharded\", \"authssl\", \"compression\", \"zlib\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n MONGO_GO_DRIVER_COMPRESSOR: \"zlib\"\n - name: test-sharded-auth-ssl-zstd-compression\n tags: [\"test\", \"sharded\", \"authssl\", \"compression\", \"zstd\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"auth\"\n SSL: \"ssl\"\n MONGO_GO_DRIVER_COMPRESSOR: \"zstd\"\n - name: test-sharded-auth-nossl\n tags: [\"test\", \"sharded\", \"authssl\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"auth\"\n SSL: \"nossl\"\n - func: start-cse-servers\n - func: run-tests\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"auth\"\n SSL: \"nossl\"\n - name: test-enterprise-auth-plain\n tags: [\"test\", \"enterprise-auth\"]\n commands:\n - func: run-enterprise-auth-tests\n - name: test-enterprise-auth-gssapi\n tags: [\"test\", \"enterprise-auth\"]\n commands:\n - func: run-enterprise-gssapi-auth-tests\n vars:\n MONGO_GO_DRIVER_COMPRESSOR: \"snappy\"\n # Build the compilecheck submodule with all supported versions of Go >=\n # the minimum supported version.\n - name: go-build\n tags: [\"compile-check\"]\n commands:\n - command: subprocess.exec\n params:\n binary: bash\n args: [*task-runner, build-compile-check-all]\n # Build with the same Go version that we're using for tests.\n - name: build\n tags: [\"compile-check\"]\n commands:\n - command: subprocess.exec\n params:\n binary: bash\n # Set the GO_VERSION to empty string to use the Go installation in the\n # PATH.\n env:\n GO_VERSION: \"\"\n args: [*task-runner, build]\n - name: \"atlas-test\"\n commands:\n - func: \"run-atlas-test\"\n - name: \"aws-auth-test\"\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n AUTH: \"auth\"\n ORCHESTRATION_FILE: \"auth-aws.json\"\n TOPOLOGY: \"server\"\n - func: add-aws-auth-variables-to-file\n - func: run-aws-auth-test-with-regular-aws-credentials\n - func: run-aws-auth-test-with-assume-role-credentials\n - func: run-aws-auth-test-with-aws-credentials-as-environment-variables\n - func: run-aws-auth-test-with-aws-credentials-and-session-token-as-environment-variables\n - func: run-aws-auth-test-with-aws-EC2-credentials\n - func: run-aws-ECS-auth-test\n - func: run-aws-auth-test-with-aws-web-identity-credentials\n - name: \"test-standalone-versioned-api\"\n tags: [\"versioned-api\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"auth\"\n SSL: \"nossl\"\n REQUIRE_API_VERSION: true\n - func: start-cse-servers\n - func: run-versioned-api-test\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"auth\"\n SSL: \"nossl\"\n REQUIRE_API_VERSION: true\n - name: \"test-sharded-versioned-api\"\n tags: [\"versioned-api\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"auth\"\n SSL: \"nossl\"\n REQUIRE_API_VERSION: true\n - func: start-cse-servers\n - func: run-versioned-api-test\n vars:\n TOPOLOGY: \"sharded_cluster\"\n AUTH: \"auth\"\n SSL: \"nossl\"\n REQUIRE_API_VERSION: true\n - name: \"test-standalone-versioned-api-test-commands\"\n tags: [\"versioned-api\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n ORCHESTRATION_FILE: \"versioned-api-testing.json\"\n - func: start-cse-servers\n - func: run-versioned-api-test\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - name: \"test-kms-kmip\"\n tags: [\"kms-kmip\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - func: start-cse-servers\n - func: run-kmip-tests\n vars:\n TOPOLOGY: \"server\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - name: \"test-client-side-encryption\"\n tags: [\"client-side-encryption-test\"]\n commands:\n - func: bootstrap-mongo-orchestration\n vars:\n TOPOLOGY: \"replica_set\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - func: start-cse-servers\n - func: run-client-side-encryption-test\n vars:\n TOPOLOGY: \"replica_set\"\n AUTH: \"noauth\"\n SSL: \"nossl\"\n - name: \"testgcpkms-task\"\n commands:\n - command: subprocess.exec\n type: test\n params:\n binary: bash\n args: [*task-runner, test-gcpkms]\n - name: \"testgcpkms-fail-task\"\n # testgcpkms-fail-task runs in a non-GCE environment.\n # It is expected to fail to obtain GCE credentials.\n commands:\n - command: subprocess.exec\n type: test\n params:\n binary: bash\n env:\n EXPECT_ERROR: \"1\"\n args: [*task-runner, test-gcpkms]\n - name: \"testawskms-task\"\n commands:\n - func: assume-test-secrets-ec2-role\n - command: subprocess.exec\n type: test\n params:\n binary: \"bash\"\n add_expansions_to_env: true\n args: [*task-runner, test-awskms]\n - name: \"testawskms-fail-task\"\n # testawskms-fail-task runs without environment variables.\n # It is expected to fail to obtain credentials.\n commands:\n - func: assume-test-secrets-ec2-role\n - command: subprocess.exec\n type: test\n params:\n binary: \"bash\"\n add_expansions_to_env: true\n env:\n EXPECT_ERROR: 'status=400'\n args: [*task-runner, test-awskms]\n - name: \"testazurekms-task\"\n commands:\n - command: subprocess.exec\n type: test\n params:\n binary: bash\n add_expansions_to_env: true\n args: [*task-runner, test-azurekms]\n - name: \"testazurekms-fail-task\"\n # testazurekms-fail-task runs without environment variables.\n # It is expected to fail to obtain credentials.\n commands:\n - func: assume-test-secrets-ec2-role\n - command: subprocess.exec\n type: test\n params:\n binary: bash\n add_expansions_to_env: true\n env:\n EXPECT_ERROR: \"1\"\n args: [*task-runner, test-azurekms]\n - name: \"test-fuzz\"\n commands:\n - func: bootstrap-mongo-orchestration\n - func: run-fuzz-tests\n - name: \"test-aws-lambda-deployed\"\n commands:\n - command: subprocess.exec\n type: test\n params:\n binary: bash\n add_expansions_to_env: true\n env:\n TEST_LAMBDA_DIRECTORY: ${PROJECT_DIRECTORY}/internal/cmd/faas/awslambda\n LAMBDA_STACK_NAME: dbx-go-lambda\n AWS_REGION: us-east-1\n args: [*task-runner, evg-test-deployed-lambda-aws]\n - name: \"oidc-auth-test\"\n commands:\n - func: \"run-oidc-auth-test-with-test-credentials\"\n - name: \"oidc-auth-test-azure\"\n commands:\n - command: subprocess.exec\n type: test\n params:\n binary: bash\n env:\n OIDC_ENV: azure\n args: [*task-runner, test-oidc-remote]\n - name: \"oidc-auth-test-gcp\"\n commands:\n - command: subprocess.exec\n type: test\n params:\n binary: bash\n env:\n OIDC_ENV: gcp\n args: [*task-runner, test-oidc-remote]\n - name: \"oidc-auth-test-k8s\"\n commands:\n - func: assume-test-secrets-ec2-role\n - func: \"run oidc k8s test\"\n vars:\n VARIANT: eks\n - func: \"run oidc k8s test\"\n vars:\n VARIANT: gke\n - func: \"run oidc k8s test\"\n vars:\n VARIANT: aks\n - name: \"test-search-index\"\n commands:\n - func: \"bootstrap-mongo-orchestration\"\n vars:\n VERSION: \"latest\"\n TOPOLOGY: \"replica_set\"\n - func: \"run-search-index-tests\"\naxes:\n - id: version\n display_name: MongoDB Version\n values:\n - id: \"8.0\"\n display_name: \"8.0\"\n variables:\n VERSION: \"8.0\"\n - id: \"7.0\"\n display_name: \"7.0\"\n variables:\n VERSION: \"7.0\"\n - id: \"6.0\"\n display_name: \"6.0\"\n variables:\n VERSION: \"6.0\"\n - id: \"5.0\"\n display_name: \"5.0\"\n variables:\n VERSION: \"5.0\"\n - id: \"4.4\"\n display_name: \"4.4\"\n variables:\n VERSION: \"4.4\"\n - id: \"4.2\"\n display_name: \"4.2\"\n variables:\n VERSION: \"4.2\"\n - id: \"rapid\"\n display_name: \"rapid\"\n variables:\n VERSION: \"rapid\"\n - id: \"latest\"\n display_name: \"latest\"\n variables:\n VERSION: \"latest\"\n # OSes that require >= 3.2 for SSL\n - id: os-ssl-32\n display_name: OS\n values:\n - id: \"windows-64\"\n display_name: \"Windows 64-bit\"\n run_on:\n - windows-2022-latest-small\n variables:\n GCC_PATH: \"/cygdrive/c/ProgramData/chocolatey/lib/mingw/tools/install/mingw64/bin\"\n GO_DIST: \"C:\\\\golang\\\\go1.25\"\n VENV_BIN_DIR: \"Scripts\"\n DEFAULT_TASK: evg-test\n # CSOT tests are unreliable on our slow Windows hosts.\n SKIP_CSOT_TESTS: true\n - id: \"rhel87-64\"\n display_name: \"RHEL 8.7\"\n run_on: rhel8.7-large\n variables:\n GO_DIST: \"/opt/golang/go1.25\"\n DEFAULT_TASK: evg-test\n - id: \"macos\"\n display_name: \"MacOS 14.0\"\n run_on: macos-14\n batchtime: 1440 # Run at most once per 24 hours.\n variables:\n GO_DIST: \"/opt/golang/go1.25\"\n DEFAULT_TASK: evg-test-load-balancers\n # CSOT tests are unreliable on our slow macOS hosts.\n SKIP_CSOT_TESTS: true\n # OSes that require >= 4.0 for SSL\n - id: os-ssl-40\n display_name: OS\n values:\n - id: \"windows-64\"\n display_name: \"Windows 64-bit\"\n run_on:\n - windows-2022-latest-small\n variables:\n GCC_PATH: \"/cygdrive/c/ProgramData/chocolatey/lib/mingw/tools/install/mingw64/bin\"\n GO_DIST: \"C:\\\\golang\\\\go1.25\"\n VENV_BIN_DIR: \"Scripts\"\n DEFAULT_TASK: evg-test\n # CSOT tests are unreliable on our slow Windows hosts.\n SKIP_CSOT_TESTS: true\n - id: \"rhel87-64\"\n display_name: \"RHEL 8.7\"\n run_on: rhel8.7-large\n variables:\n GO_DIST: \"/opt/golang/go1.25\"\n DEFAULT_TASK: evg-test\n - id: \"macos\"\n display_name: \"MacOS 14.0\"\n run_on: macos-14\n batchtime: 1440 # Run at most once per 24 hours.\n variables:\n GO_DIST: \"/opt/golang/go1.25\"\n DEFAULT_TASK: evg-test-load-balancers\n # CSOT tests are unreliable on our slow macOS hosts.\n SKIP_CSOT_TESTS: true\n - id: ocsp-rhel-87\n display_name: OS\n values:\n - id: \"rhel87\"\n display_name: \"RHEL 8.7\"\n run_on: rhel8.7-large\n variables:\n GO_DIST: \"/opt/golang/go1.25\"\n DEFAULT_TASK: evg-test\n - id: os-aws-auth\n display_name: OS\n values:\n - id: \"windows-64-2022-latest-small\"\n display_name: \"Windows 64-bit\"\n run_on:\n - windows-2022-latest-small\n variables:\n GCC_PATH: \"/cygdrive/c/ProgramData/chocolatey/lib/mingw/tools/install/mingw64/bin\"\n GO_DIST: \"C:\\\\golang\\\\go1.25\"\n SKIP_ECS_AUTH_TEST: true\n DEFAULT_TASK: evg-test\n # CSOT tests are unreliable on our slow Windows hosts.\n SKIP_CSOT_TESTS: true\n - id: \"ubuntu2004-64\"\n display_name: \"Ubuntu 20.04\"\n run_on: ubuntu2004-test\n variables:\n GO_DIST: \"/opt/golang/go1.25\"\n DEFAULT_TASK: evg-test\n - id: \"macos\"\n display_name: \"MacOS 14.0\"\n run_on: macos-14\n batchtime: 1440 # Run at most once per 24 hours.\n variables:\n GO_DIST: \"/opt/golang/go1.25\"\n SKIP_ECS_AUTH_TEST: true\n SKIP_EC2_AUTH_TEST: true\n SKIP_WEB_IDENTITY_AUTH_TEST: true\n DEFAULT_TASK: evg-test-load-balancers\n # CSOT tests are unreliable on our slow macOS hosts.\n SKIP_CSOT_TESTS: true\n - id: os-faas-80\n display_name: OS\n values:\n - id: \"rhel87-large\"\n display_name: \"RHEL 8.7\"\n run_on: rhel8.7-large\n variables:\n GO_DIST: \"/opt/golang/go1.25\"\ntask_groups:\n - name: testgcpkms_task_group\n setup_group_can_fail_task: true\n setup_group_timeout_secs: 1800 # 30 minutes\n setup_group:\n - func: setup-system\n - func: assume-test-secrets-ec2-role\n - command: subprocess.exec\n params:\n binary: \"bash\"\n add_expansions_to_env: true\n args:\n - ${DRIVERS_TOOLS}/.evergreen/csfle/gcpkms/setup.sh\n teardown_group:\n - command: subprocess.exec\n params:\n binary: \"bash\"\n args:\n - ${DRIVERS_TOOLS}/.evergreen/csfle/gcpkms/teardown.sh\n - func: teardown\n - func: handle-test-artifacts\n tasks:\n - testgcpkms-task\n - name: testazurekms_task_group\n setup_group_can_fail_task: true\n teardown_task_can_fail_task: true\n setup_group_timeout_secs: 1800 # 30 minutes\n setup_group:\n - func: setup-system\n - func: assume-test-secrets-ec2-role\n - command: subprocess.exec\n params:\n binary: bash\n add_expansions_to_env: true\n env:\n AZUREKMS_VMNAME_PREFIX: GODRIVER\n args:\n - ${DRIVERS_TOOLS}/.evergreen/csfle/azurekms/setup.sh\n teardown_group:\n - command: subprocess.exec\n params:\n binary: \"bash\"\n args:\n - ${DRIVERS_TOOLS}/.evergreen/csfle/azurekms/teardown.sh\n - func: teardown\n - func: handle-test-artifacts\n tasks:\n - testazurekms-task\n - name: testoidc_task_group\n setup_group_can_fail_task: true\n setup_group_timeout_secs: 1800\n # TODO(DRIVERS-3141): Uncomment the following line once the teardown bug is\n # fixed. See DRIVERS-3141 for more context.\n #\n # teardown_task_can_fail_task: true\n teardown_group_timeout_secs: 180 # 3 minutes (max allowed time)\n setup_group:\n - func: setup-system\n - func: assume-test-secrets-ec2-role\n - command: subprocess.exec\n params:\n binary: bash\n include_expansions_in_env: [\"AWS_ACCESS_KEY_ID\", \"AWS_SECRET_ACCESS_KEY\", \"AWS_SESSION_TOKEN\"]\n env:\n MONGODB_VERSION: \"8.0\"\n args:\n - ${DRIVERS_TOOLS}/.evergreen/auth_oidc/setup.sh\n teardown_task:\n - command: subprocess.exec\n params:\n binary: bash\n args:\n - ${DRIVERS_TOOLS}/.evergreen/auth_oidc/teardown.sh\n - func: teardown\n - func: handle-test-artifacts\n tasks:\n - oidc-auth-test\n - name: testazureoidc_task_group\n setup_group_can_fail_task: true\n setup_group_timeout_secs: 1800\n teardown_task_can_fail_task: true\n teardown_group_timeout_secs: 180 # 3 minutes (max allowed time)\n setup_group:\n - func: setup-system\n - func: assume-test-secrets-ec2-role\n - command: subprocess.exec\n params:\n binary: bash\n add_expansions_to_env: true\n env:\n AZUREOIDC_VMNAME_PREFIX: \"GO_DRIVER\"\n args:\n - ${DRIVERS_TOOLS}/.evergreen/auth_oidc/azure/setup.sh\n teardown_task:\n - command: subprocess.exec\n params:\n binary: bash\n args:\n - ${DRIVERS_TOOLS}/.evergreen/auth_oidc/azure/teardown.sh\n - func: teardown\n - func: handle-test-artifacts\n tasks:\n - oidc-auth-test-azure\n - name: testgcpoidc_task_group\n setup_group_can_fail_task: true\n setup_group_timeout_secs: 1800\n teardown_task_can_fail_task: true\n teardown_group_timeout_secs: 180 # 3 minutes (max allowed time)\n setup_group:\n - func: setup-system\n - func: assume-test-secrets-ec2-role\n - command: subprocess.exec\n params:\n binary: bash\n add_expansions_to_env: true\n env:\n AZUREOIDC_VMNAME_PREFIX: \"GO_DRIVER\"\n args:\n - ${DRIVERS_TOOLS}/.evergreen/auth_oidc/gcp/setup.sh\n teardown_task:\n - command: subprocess.exec\n params:\n binary: bash\n args:\n - ${DRIVERS_TOOLS}/.evergreen/auth_oidc/gcp/teardown.sh\n - func: teardown\n - func: handle-test-artifacts\n tasks:\n - oidc-auth-test-gcp\n - name: testk8soidc_task_group\n setup_group_can_fail_task: true\n setup_group_timeout_secs: 1800\n teardown_task_can_fail_task: true\n teardown_group_timeout_secs: 180 # 3 minutes (max allowed time)\n setup_group:\n - func: setup-system\n - func: assume-test-secrets-ec2-role\n - command: subprocess.exec\n params:\n binary: bash\n include_expansions_in_env: [\"AWS_ACCESS_KEY_ID\", \"AWS_SECRET_ACCESS_KEY\", \"AWS_SESSION_TOKEN\"]\n args:\n - ${DRIVERS_TOOLS}/.evergreen/auth_oidc/k8s/setup.sh\n teardown_group:\n - command: subprocess.exec\n params:\n binary: bash\n args:\n - ${DRIVERS_TOOLS}/.evergreen/auth_oidc/k8s/teardown.sh\n - func: teardown\n - func: handle-test-artifacts\n tasks:\n - oidc-auth-test-k8s\n - name: test-aws-lambda-task-group\n setup_group:\n - func: setup-system\n - func: assume-test-secrets-ec2-role\n - command: subprocess.exec\n params:\n working_dir: src/go.mongodb.org/mongo-driver\n binary: bash\n include_expansions_in_env: [AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN]\n env:\n MONGODB_VERSION: ${VERSION}\n LAMBDA_STACK_NAME: dbx-go-lambda\n args:\n - ${DRIVERS_TOOLS}/.evergreen/atlas/setup.sh\n teardown_group:\n - command: subprocess.exec\n params:\n working_dir: src/go.mongodb.org/mongo-driver\n binary: bash\n add_expansions_to_env: true\n env:\n LAMBDA_STACK_NAME: dbx-go-lambda\n AWS_REGION: us-east-1\n args:\n - ${DRIVERS_TOOLS}/.evergreen/atlas/teardown.sh\n - func: teardown\n - func: handle-test-artifacts\n setup_group_can_fail_task: true\n setup_group_timeout_secs: 1800\n tasks:\n - test-aws-lambda-deployed\n - name: test-search-index-task-group\n setup_group:\n - func: setup-system\n - func: assume-test-secrets-ec2-role\n - command: subprocess.exec\n params:\n working_dir: src/go.mongodb.org/mongo-driver\n binary: bash\n include_expansions_in_env: [AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, MONGODB_URI]\n env:\n MONGODB_VERSION: ${VERSION}\n LAMBDA_STACK_NAME: dbx-go-lambda\n args:\n - ${DRIVERS_TOOLS}/.evergreen/atlas/setup.sh\n - command: expansions.update\n params:\n file: src/go.mongodb.org/mongo-driver/atlas-expansion.yml\n - command: shell.exec\n params:\n working_dir: src/go.mongodb.org/mongo-driver\n shell: bash\n script: |-\n echo \"SEARCH_INDEX_URI: ${MONGODB_URI}\" > atlas-expansion.yml\n - command: expansions.update\n params:\n file: src/go.mongodb.org/mongo-driver/atlas-expansion.yml\n teardown_group:\n - command: subprocess.exec\n params:\n working_dir: src/go.mongodb.org/mongo-driver\n binary: bash\n args:\n - ${DRIVERS_TOOLS}/.evergreen/atlas/teardown.sh\n - func: teardown\n - func: handle-test-artifacts\n setup_group_can_fail_task: true\n setup_group_timeout_secs: 1800\n tasks:\n - test-search-index\nbuildvariants:\n - name: static-analysis\n tags: [\"pullrequest\"]\n display_name: \"Static Analysis\"\n run_on:\n - rhel8.7-small\n expansions:\n # Keep this in sync with go version used in etc/golangci-lint.sh\n GO_DIST: \"/opt/golang/go1.25\"\n tasks:\n - name: \".static-analysis\"\n - name: pull-request-helpers\n tags: [\"pullrequest\"]\n display_name: \"Pull Request Helpers\"\n run_on:\n - rhel8.7-small\n expansions:\n GO_DIST: \"/opt/golang/go1.25\"\n tasks:\n - name: \"pull-request-helpers\"\n - name: perf\n tags: [\"pullrequest\"]\n display_name: \"Performance\"\n run_on: rhel90-dbx-perf-large\n expansions:\n GO_DIST: \"/opt/golang/go1.25\"\n tasks:\n - name: \".performance\"\n - name: build-check\n tags: [\"pullrequest\"]\n display_name: \"Compile Only Checks\"\n run_on:\n - ubuntu2204-small\n expansions:\n GO_DIST: \"/opt/golang/go1.25\"\n tasks:\n - name: \".compile-check\"\n - name: backport-pr\n display_name: \"Backport PR\"\n run_on:\n - rhel8.7-small\n expansions:\n GO_DIST: \"/opt/golang/go1.25\"\n tasks:\n - name: \"backport-pr\"\n - name: atlas-test\n tags: [\"pullrequest\"]\n display_name: \"Atlas test\"\n run_on:\n - rhel8.7-large\n expansions:\n GO_DIST: \"/opt/golang/go1.25\"\n tasks:\n - name: \"atlas-test\"\n - name: docker-runner-test\n tags: [\"pullrequest\"]\n display_name: \"Docker Runner Test\"\n run_on:\n - ubuntu2204-large\n expansions:\n GO_DIST: \"/opt/golang/go1.25\"\n tasks:\n - name: \"test-docker-runner\"\n - name: goroutine-leaks-test\n tags: [\"pullrequest\"]\n display_name: \"Goroutine Leaks Test\"\n run_on:\n - ubuntu2204-large\n expansions:\n GO_DIST: \"/opt/golang/go1.25\"\n tasks:\n - name: \".goleak\"\n - matrix_name: \"tests-rhel-44-plus-zlib-zstd-support\"\n tags: [\"pullrequest\"]\n matrix_spec: {version: [\"4.2\", \"4.4\", \"5.0\", \"6.0\", \"7.0\", \"8.0\"], os-ssl-40: [\"rhel87-64\"]}\n display_name: \"${version} ${os-ssl-40}\"\n tasks:\n - name: \".test !.enterprise-auth !.snappy\"\n - matrix_name: \"tests-windows-42-plus-zlib-zstd-support\"\n matrix_spec: {version: [\"4.2\", \"4.4\", \"5.0\", \"6.0\", \"7.0\"], os-ssl-40: [\"windows-64\"]}\n display_name: \"${version} ${os-ssl-40}\"\n tasks:\n - name: \".test !.enterprise-auth !.snappy\"\n - matrix_name: \"tests-windows-80-zlib-zstd-support\"\n tags: [\"pullrequest\"]\n matrix_spec: {version: [\"8.0\"], os-ssl-40: [\"windows-64\"]}\n display_name: \"${version} ${os-ssl-40}\"\n tasks:\n - name: \".test !.enterprise-auth !.snappy\"\n - matrix_name: \"tests-latest-rapid-zlib-zstd-support\"\n matrix_spec: {version: [\"latest\", \"rapid\"], os-ssl-40: [\"windows-64\", \"rhel87-64\"]}\n display_name: \"${version} ${os-ssl-40}\"\n tasks:\n - name: \".test !.enterprise-auth !.snappy\"\n - matrix_name: \"enterprise-auth-tests\"\n matrix_spec: {os-ssl-32: \"*\"}\n display_name: \"Enterprise Auth - ${os-ssl-32}\"\n tasks:\n - name: \".test .enterprise-auth\"\n - matrix_name: \"aws-auth-test\"\n matrix_spec: {version: [\"4.4\", \"5.0\", \"6.0\", \"7.0\", \"8.0\", \"latest\", \"rapid\"], os-aws-auth: \"*\"}\n display_name: \"MONGODB-AWS Auth ${version} ${os-aws-auth}\"\n tasks:\n - name: \"aws-auth-test\"\n - matrix_name: \"ocsp-test\"\n matrix_spec: {version: [\"4.4\", \"5.0\", \"6.0\", \"7.0\", \"8.0\", \"latest\", \"rapid\"], ocsp-rhel-87: [\"rhel87\"]}\n display_name: \"OCSP ${version} ${ocsp-rhel-87}\"\n batchtime: 20160 # Use a batchtime of 14 days as suggested by the OCSP test README\n tasks:\n - name: \".ocsp\"\n - matrix_name: \"ocsp-test-windows\"\n matrix_spec: {version: [\"4.4\", \"5.0\", \"6.0\", \"7.0\", \"8.0\", \"latest\", \"rapid\"], os-ssl-40: [\"windows-64\"]}\n display_name: \"OCSP ${version} ${os-ssl-40}\"\n batchtime: 20160 # Use a batchtime of 14 days as suggested by the OCSP test README\n tasks:\n # Windows MongoDB servers do not staple OCSP responses and only support RSA.\n - name: \".ocsp-rsa !.ocsp-staple\"\n - matrix_name: \"ocsp-test-macos\"\n matrix_spec: {version: [\"4.4\", \"5.0\", \"6.0\", \"7.0\", \"8.0\", \"latest\", \"rapid\"], os-ssl-40: [\"macos\"]}\n display_name: \"OCSP ${version} ${os-ssl-40}\"\n batchtime: 20160 # Use a batchtime of 14 days as suggested by the OCSP test README\n tasks:\n # macos MongoDB servers do not staple OCSP responses and only support RSA.\n - name: \".ocsp-rsa !.ocsp-staple\"\n - matrix_name: \"race-test\"\n tags: [\"pullrequest\"]\n matrix_spec: {version: [\"7.0\"], os-ssl-40: [\"rhel87-64\"]}\n display_name: \"Race Detector Test\"\n tasks:\n - name: \".race\"\n - matrix_name: \"versioned-api-test\"\n tags: [\"pullrequest\"]\n matrix_spec: {version: [\"5.0\", \"6.0\", \"7.0\", \"8.0\"], os-ssl-40: [\"windows-64\", \"rhel87-64\"]}\n display_name: \"API Version ${version} ${os-ssl-40}\"\n tasks:\n - name: \".versioned-api\"\n - matrix_name: \"versioned-api-latest-rapid-test\"\n matrix_spec: {version: [\"latest\", \"rapid\"], os-ssl-40: [\"windows-64\", \"rhel87-64\"]}\n display_name: \"API Version ${version} ${os-ssl-40}\"\n tasks:\n - name: \".versioned-api\"\n - matrix_name: \"client-side-encryption-test\"\n matrix_spec: {version: [\"latest\", \"rapid\"], os-ssl-40: [\"rhel87-64\"]}\n display_name: \"Client Side Encryption Tests ${version} ${os-ssl-40}\"\n tasks:\n - name: \".client-side-encryption-test\"\n - matrix_name: \"load-balancer-test\"\n tags: [\"pullrequest\"]\n matrix_spec: {version: [\"5.0\", \"6.0\", \"7.0\", \"8.0\"], os-ssl-40: [\"rhel87-64\"]}\n display_name: \"Load Balancer Support ${version} ${os-ssl-40}\"\n tasks:\n - name: \".load-balancer\"\n - matrix_name: \"load-balancer-latest-rapid-test\"\n matrix_spec: {version: [\"latest\", \"rapid\"], os-ssl-40: [\"rhel87-64\"]}\n display_name: \"Load Balancer Support ${version} ${os-ssl-40}\"\n tasks:\n - name: \".load-balancer\"\n - matrix_name: \"kms-kmip-test\"\n matrix_spec: {version: [\"7.0\"], os-ssl-40: [\"rhel87-64\"]}\n display_name: \"KMS KMIP ${os-ssl-40}\"\n tasks:\n - name: \".kms-kmip\"\n - matrix_name: \"fuzz-test\"\n matrix_spec: {version: [\"5.0\"], os-ssl-40: [\"rhel87-64\"]}\n display_name: \"Fuzz ${version} ${os-ssl-40}\"\n tasks:\n - name: \"test-fuzz\"\n batchtime: 1440 # Run at most once per 24 hours.\n - matrix_name: \"faas-test\"\n matrix_spec: {version: [\"7.0\"], os-faas-80: [\"rhel87-large\"]}\n display_name: \"FaaS ${version} ${os-faas-80}\"\n tasks:\n - test-aws-lambda-task-group\n - matrix_name: \"searchindex-test\"\n matrix_spec: {version: [\"7.0\"], os-faas-80: [\"rhel87-large\"]}\n display_name: \"Search Index ${version} ${os-faas-80}\"\n tasks:\n - test-search-index-task-group\n - name: testgcpkms-variant\n display_name: \"GCP KMS\"\n run_on:\n - rhel8.7-small\n expansions:\n GO_DIST: \"/opt/golang/go1.25\"\n tasks:\n - name: testgcpkms_task_group\n batchtime: 20160 # Use a batchtime of 14 days as suggested by the CSFLE test README\n - testgcpkms-fail-task\n - name: testawskms-variant\n display_name: \"AWS KMS\"\n run_on:\n - rhel8.7-small\n expansions:\n GO_DIST: \"/opt/golang/go1.25\"\n tasks:\n - testawskms-task\n - testawskms-fail-task\n - name: testazurekms-variant\n display_name: \"AZURE KMS\"\n run_on:\n - rhel8.7-small\n expansions:\n GO_DIST: \"/opt/golang/go1.25\"\n tasks:\n - name: testazurekms_task_group\n batchtime: 20160 # Use a batchtime of 14 days as suggested by the CSFLE test README\n - testazurekms-fail-task\n - name: testoidc-variant\n display_name: \"OIDC\"\n run_on:\n - ubuntu2204-small\n expansions:\n GO_DIST: \"/opt/golang/go1.25\"\n tasks:\n - name: testoidc_task_group\n - name: testazureoidc_task_group\n - name: testgcpoidc_task_group\n - name: testk8soidc_task_group\n" }, { "path": ".evergreen/krb5.config", "content": "[realms]\n LDAPTEST.10GEN.CC = {\n kdc = ldaptest.10gen.cc\n admin_server = ldaptest.10gen.cc\n }\n\n[libdefaults]\n rdns = false\n" }, { "path": ".evergreen/ocsp-requirements.txt", "content": "asn1crypto==1.3.0\nbottle==0.12.20\noscrypto==1.2.0\n" }, { "path": ".evergreen/run-mongodb-aws-ecs-test.sh", "content": "#!/bin/bash\n\nset -o errexit # Exit the script with error if any of the commands fail\n\n############################################\n# Main Program #\n############################################\n\nif [[ -z \"$1\" ]]; then\n echo \"usage: $0 \"\n exit 1\nfi\nexport MONGODB_URI=\"$1\"\n\necho \"Running MONGODB-AWS ECS authentication tests\"\n\nif echo \"$MONGODB_URI\" | grep -q \"@\"; then\n echo \"MONGODB_URI unexpectedly contains user credentials in ECS test!\";\n exit 1\nfi\n\n./src/main\n" }, { "path": ".evergreen/run-task.sh", "content": "#!/usr/bin/env bash\n#\n# Source the env.sh file and run the given task\nset -eu\n\nSCRIPT_DIR=$( cd -- \"$( dirname -- \"${BASH_SOURCE[0]}\" )\" &> /dev/null && pwd )\nPROJECT_DIRECTORY=$(dirname $SCRIPT_DIR)\npushd ${PROJECT_DIRECTORY} > /dev/null\n\nsource env.sh\ntask \"$@\"\n\npopd > /dev/null\n" }, { "path": ".evergreen/setup-system.sh", "content": "#!/usr/bin/env bash\n#\n# Set up environment and write env.sh and expansion.yml files.\nset -eu\n\n# Set up default environment variables.\nSCRIPT_DIR=$( cd -- \"$( dirname -- \"${BASH_SOURCE[0]}\" )\" &> /dev/null && pwd )\nPROJECT_DIRECTORY=$(dirname $SCRIPT_DIR)\npushd $PROJECT_DIRECTORY\nROOT_DIR=$(dirname $PROJECT_DIRECTORY)\nDRIVERS_TOOLS=${DRIVERS_TOOLS:-${ROOT_DIR}/drivers-evergreen-tools}\nMONGO_ORCHESTRATION_HOME=\"${DRIVERS_TOOLS}/.evergreen/orchestration\"\nMONGODB_BINARIES=\"${DRIVERS_TOOLS}/mongodb/bin\"\nOS=\"${OS:-\"\"}\"\n\n# Set Golang environment vars. GOROOT is wherever current Go distribution is, and is set in evergreen config.\n# GOPATH is always 3 directories up from pwd on EVG; GOCACHE is under .cache in the pwd.\nGOROOT=${GOROOT:-$(dirname \"$(dirname \"$(which go)\")\")}\nexport GOPATH=${GOPATH:-$ROOT_DIR}\nexport GOCACHE=\"${GO_CACHE:-$PROJECT_DIRECTORY/.cache}\"\n\n# Handle paths on Windows.\nif [ \"Windows_NT\" = \"${OS:-}\" ]; then # Magic variable in cygwin\n GOPATH=$(cygpath -m $GOPATH)\n GOCACHE=$(cygpath -w $GOCACHE)\n DRIVERS_TOOLS=$(cygpath -m $DRIVERS_TOOLS)\n PROJECT_DIRECTORY=$(cygpath -m $PROJECT_DIRECTORY)\n EXTRA_PATH=/cygdrive/c/libmongocrypt/bin\n MONGO_ORCHESTRATION_HOME=$(cygpath -m $MONGO_ORCHESTRATION_HOME)\n MONGODB_BINARIES=$(cygpath -m $MONGODB_BINARIES)\n # Set home variables for Windows, too.\n USERPROFILE=$(cygpath -w \"$ROOT_DIR\")\n HOME=$USERPROFILE\nelse\n EXTRA_PATH=${GCC:-}\nfi\n\n# Add binaries to the path.\nPATH=\"${GOROOT}/bin:${GOPATH}/bin:${MONGODB_BINARIES}:${EXTRA_PATH}:${PATH}\"\n\n# Get the current unique version of this checkout.\nif [ \"${IS_PATCH:-}\" = \"true\" ]; then\n CURRENT_VERSION=$(git describe)-patch-${VERSION_ID}\nelse\n CURRENT_VERSION=latest\nfi\n\n# Ensure a checkout of drivers-tools.\nif [ ! -d \"$DRIVERS_TOOLS\" ]; then\n git clone https://github.com/mongodb-labs/drivers-evergreen-tools $DRIVERS_TOOLS\nfi\n\n# Write the .env file for drivers-tools.\ncat < ${DRIVERS_TOOLS}/.env\nSKIP_LEGACY_SHELL=1\nDRIVERS_TOOLS=\"$DRIVERS_TOOLS\"\nMONGO_ORCHESTRATION_HOME=\"$MONGO_ORCHESTRATION_HOME\"\nMONGODB_BINARIES=\"$MONGODB_BINARIES\"\nTMPDIR=\"$MONGO_ORCHESTRATION_HOME/db\"\nEOT\n\n# Check Go installation.\ngo version\ngo env\n\n# Install taskfile.\ngo install github.com/go-task/task/v3/cmd/task@v3.39.1\n\n# Write our own env file.\ncat < env.sh\nexport GOROOT=\"$GOROOT\"\nexport GOPATH=\"$GOPATH\"\nexport GOCACHE=\"$GOCACHE\"\nexport DRIVERS_TOOLS=\"$DRIVERS_TOOLS\"\nexport PROJECT_DIRECTORY=\"$PROJECT_DIRECTORY\"\nexport MONGODB_BINARIES=\"$MONGODB_BINARIES\"\nexport PATH=\"$PATH\"\nEOT\n\nif [ \"Windows_NT\" = \"$OS\" ]; then\n echo \"export USERPROFILE=$USERPROFILE\" >> env.sh\n echo \"export HOME=$HOME\" >> env.sh\nfi\n\n# source the env.sh file and write the expansion file.\ncat < expansion.yml\nCURRENT_VERSION: \"$CURRENT_VERSION\"\nDRIVERS_TOOLS: \"$DRIVERS_TOOLS\"\nPROJECT_DIRECTORY: \"$PROJECT_DIRECTORY\"\nRUN_TASK: \"$PROJECT_DIRECTORY/.evergreen/run-task.sh\"\nEOT\n\ncat env.sh\npopd\n" }, { "path": ".github/dependabot.yml", "content": "version: 2\nupdates:\n - package-ecosystem: \"github-actions\"\n directory: \"/\"\n schedule:\n interval: \"weekly\"\n groups:\n actions:\n patterns:\n - \"*\"\n - package-ecosystem: gomod\n directory: /\n schedule:\n interval: \"weekly\"\n - package-ecosystem: \"gitsubmodule\"\n directory: \"/\"\n schedule:\n interval: \"monthly\"\n" }, { "path": ".github/labeler.yml", "content": "review-priority-normal:\n - changed-files:\n - any-glob-to-any-file: \"*\"\ndocumentation:\n - changed-files:\n - any-glob-to-any-file:\n - docs/**\n - examples/**\ndependencies:\n - changed-files:\n - any-glob-to-any-file:\n - go.mod\n" }, { "path": ".github/release.yml", "content": "changelog:\n exclude:\n labels:\n - ignore-for-release\n - github_actions\n - submodules\n authors:\n - mongodb-drivers-pr-bot\n categories:\n - title: ⚠️ Breaking Changes\n labels:\n - breaking\n - title: ✨ New Features\n labels:\n - enhancement\n - feature\n - title: 🐛 Fixed\n labels:\n - bug\n - title: 📦 Dependency Updates\n labels:\n - dependencies\n - title: 📝 Other Changes\n labels:\n - \"*\"\n" }, { "path": ".github/workflows/check-labels.yml", "content": "name: Label Checker\non:\n pull_request:\n types:\n - opened\n - synchronize\n - reopened\n - labeled\n - unlabeled\npermissions:\n pull-requests: read\njobs:\n check_labels:\n name: Check labels\n runs-on: ubuntu-latest\n steps:\n - uses: docker://agilepathway/pull-request-label-checker@sha256:65e57fd98ba3ab6ca4fcbc5a0aef288dd984ee4ab988f124d83424d19b55b801\n with:\n one_of: bug,feature,enhancement,documentation,dependencies,ignore-for-release,ci/cd\n repo_token: ${{ secrets.GITHUB_TOKEN }}\n" }, { "path": ".github/workflows/codeql.yml", "content": "name: \"CodeQL\"\non:\n push:\n branches:\n - \"v1\"\n - \"cloud-*\"\n - \"master\"\n - \"release/*\"\n - \"feature/*\"\n pull_request:\n branches:\n - \"v1\"\n - \"cloud-*\"\n - \"master\"\n - \"release/*\"\n - \"feature/*\"\n schedule:\n - cron: \"36 17 * * 0\"\n workflow_call:\n inputs:\n ref:\n required: true\n type: string\npermissions:\n contents: read\njobs:\n analyze:\n name: Analyze (go)\n runs-on: \"ubuntu-latest\"\n timeout-minutes: 360\n permissions:\n # required for all workflows\n contents: read\n security-events: write\n steps:\n - name: Checkout repository\n uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd #v6.0.2\n - name: Set up Go\n uses: actions/setup-go@4b73464bb391d4059bd26b0524d20df3927bd417 #v6.3.0\n with:\n go-version: \"1.25.0\"\n # Initializes the CodeQL tools for scanning.\n - name: Initialize CodeQL\n uses: github/codeql-action/init@v4.33.0 #immutable\n with:\n languages: go\n build-mode: manual\n - name: Build (CodeQL-instrumented)\n shell: bash\n run: |\n # TODO(GODRIVER-3723): Run using taskfile targets.\n go build ./...\n go test -short -run ^$$ ./...\n\n go test -v ./internal/test/compilecheck -run '^TestCompileCheck/go:1\\.19$'\n - name: Perform CodeQL Analysis\n uses: github/codeql-action/analyze@v4.33.0 #immutable\n with:\n category: \"/language:go\"\n" }, { "path": ".github/workflows/create-release-branch.yml", "content": "name: Create Release Branch\non:\n workflow_dispatch:\n inputs:\n branch_name:\n description: The name of the new branch\n required: true\n version:\n description: The version to set on the branch\n required: true\n base_ref:\n description: The base reference for the branch\n push_changes:\n description: Whether to push the changes\n default: \"true\"\npermissions:\n contents: read\nconcurrency:\n group: create-branch-${{ github.ref }}\n cancel-in-progress: true\ndefaults:\n run:\n shell: bash -eux {0}\njobs:\n create-branch:\n environment: release\n runs-on: ubuntu-latest\n permissions:\n id-token: write\n contents: write\n outputs:\n version: ${{ steps.pre-publish.outputs.version }}\n steps:\n - uses: mongodb-labs/drivers-github-tools/secure-checkout@fac300d2aa6fe2ddd6316aa673df485941b882f0 #v3\n with:\n app_id: ${{ vars.APP_ID }}\n private_key: ${{ secrets.APP_PRIVATE_KEY }}\n - uses: mongodb-labs/drivers-github-tools/setup@fac300d2aa6fe2ddd6316aa673df485941b882f0 #v3\n with:\n aws_role_arn: ${{ secrets.AWS_ROLE_ARN }}\n aws_region_name: ${{ vars.AWS_REGION_NAME }}\n aws_secret_id: ${{ secrets.AWS_SECRET_ID }}\n artifactory_username: ${{ vars.ARTIFACTORY_USERNAME }}\n - uses: mongodb-labs/drivers-github-tools/create-branch@fac300d2aa6fe2ddd6316aa673df485941b882f0 #v3\n id: create-branch\n with:\n branch_name: ${{ inputs.branch_name }}\n version: ${{ inputs.version }}\n base_ref: ${{ inputs.base_ref }}\n push_changes: ${{ inputs.push_changes }}\n version_bump_script: \"go run ${{ github.action_path }}/bump-version.go\"\n evergreen_project: mongo-go-driver-release\n release_workflow_path: ./.github/workflows/release.yml\n" }, { "path": ".github/workflows/labeler.yml", "content": "name: \"Pull Request Labeler\"\non:\n - pull_request_target\npermissions:\n contents: read\njobs:\n labeler:\n permissions:\n contents: read\n pull-requests: write\n runs-on: ubuntu-latest\n steps:\n - uses: actions/labeler@634933edcd8ababfe52f92936142cc22ac488b1b #v6.0.1\n" }, { "path": ".github/workflows/merge-up.yml", "content": "name: Merge up\non:\n push:\n branches:\n - release/*.*\n - v*\npermissions:\n contents: read\njobs:\n merge-up:\n name: Create merge up pull request\n runs-on: ubuntu-latest\n permissions:\n id-token: write\n contents: write\n pull-requests: write\n steps:\n - uses: mongodb-labs/drivers-github-tools/secure-checkout@fac300d2aa6fe2ddd6316aa673df485941b882f0 #v3\n with:\n app_id: ${{ vars.PR_APP_ID }}\n private_key: ${{ secrets.PR_APP_PRIVATE_KEY }}\n # Make sure to include fetch-depth 0 so all branches are fetched, not\n # just the current one\n fetch-depth: 0\n - name: Create pull request\n id: create-pull-request\n uses: alcaeus/automatic-merge-up-action@e23e7c71d58f12531cbaba73473bbe78fd14baf0 #v1.0.1\n with:\n ref: ${{ github.ref_name }}\n branchNamePattern: \"release/.\"\n devBranchNamePattern: \"v\"\n fallbackBranch: \"master\"\n ignoredBranches: ${{ vars.IGNORED_MERGE_UP_BRANCHES }}\n enableAutoMerge: true\n" }, { "path": ".github/workflows/release.yml", "content": "name: Release\non:\n workflow_dispatch:\n inputs:\n version:\n description: \"The new version to set\"\n required: true\n prev_version:\n description: \"The previous tagged version\"\n required: true\n push_changes:\n description: \"Push changes?\"\n default: true\n type: boolean\npermissions:\n contents: read\ndefaults:\n run:\n shell: bash -eux {0}\nenv:\n # Changes per branch\n SILK_ASSET_GROUP: mongodb-go-driver\n EVERGREEN_PROJECT: mongo-go-driver\njobs:\n pre-publish:\n environment: release\n runs-on: ubuntu-latest\n permissions:\n id-token: write\n contents: write\n outputs:\n prev_version: ${{ steps.pre-publish.outputs.prev_version }}\n steps:\n - uses: mongodb-labs/drivers-github-tools/secure-checkout@fac300d2aa6fe2ddd6316aa673df485941b882f0 #v3\n with:\n app_id: ${{ vars.APP_ID }}\n private_key: ${{ secrets.APP_PRIVATE_KEY }}\n - uses: mongodb-labs/drivers-github-tools/setup@fac300d2aa6fe2ddd6316aa673df485941b882f0 #v3\n with:\n aws_role_arn: ${{ secrets.AWS_ROLE_ARN }}\n aws_region_name: ${{ vars.AWS_REGION_NAME }}\n aws_secret_id: ${{ secrets.AWS_SECRET_ID }}\n artifactory_username: ${{ vars.ARTIFACTORY_USERNAME }}\n - name: Pre Publish\n id: pre-publish\n uses: mongodb-labs/drivers-github-tools/golang/pre-publish@fac300d2aa6fe2ddd6316aa673df485941b882f0 #v3\n with:\n version: ${{ inputs.version }}\n push_changes: ${{ inputs.push_changes }}\n ignored_branches: ${{ vars.IGNORED_MERGE_UP_BRANCHES }}\n static-scan:\n needs: [pre-publish]\n permissions:\n contents: read\n security-events: write\n uses: ./.github/workflows/codeql.yml\n with:\n ref: ${{ github.ref }}\n publish:\n needs: [pre-publish, static-scan]\n runs-on: ubuntu-latest\n environment: release\n permissions:\n id-token: write\n contents: write\n security-events: read\n steps:\n - uses: mongodb-labs/drivers-github-tools/secure-checkout@fac300d2aa6fe2ddd6316aa673df485941b882f0 #v3\n with:\n app_id: ${{ vars.APP_ID }}\n private_key: ${{ secrets.APP_PRIVATE_KEY }}\n - uses: mongodb-labs/drivers-github-tools/setup@fac300d2aa6fe2ddd6316aa673df485941b882f0 #v3\n with:\n aws_role_arn: ${{ secrets.AWS_ROLE_ARN }}\n aws_region_name: ${{ vars.AWS_REGION_NAME }}\n aws_secret_id: ${{ secrets.AWS_SECRET_ID }}\n artifactory_username: ${{ vars.ARTIFACTORY_USERNAME }}\n - name: Publish\n uses: mongodb-labs/drivers-github-tools/golang/publish@fac300d2aa6fe2ddd6316aa673df485941b882f0 #v3\n with:\n version: ${{ inputs.version }}\n silk_asset_group: ${{ env.SILK_ASSET_GROUP }}\n evergreen_project: ${{ env.EVERGREEN_PROJECT }}\n prev_version: ${{ inputs.prev_version }}\n push_changes: ${{ inputs.push_changes }}\n token: ${{ env.GH_TOKEN }}\n" }, { "path": ".github/workflows/scorecard.yml", "content": "# This workflow uses actions that are not certified by GitHub. They are provided\n# by a third-party and are governed by separate terms of service, privacy\n# policy, and support documentation.\n\nname: Scorecard supply-chain security\non:\n # For Branch-Protection check. Only the default branch is supported. See\n # https://github.com/ossf/scorecard/blob/main/docs/checks.md#branch-protection\n branch_protection_rule:\n # To guarantee Maintained check is occasionally updated. See\n # https://github.com/ossf/scorecard/blob/main/docs/checks.md#maintained\n schedule:\n - cron: \"24 21 * * 1\"\n push:\n branches: [\"master\"]\n# Declare default permissions as read only.\npermissions: read-all\njobs:\n analysis:\n name: Scorecard analysis\n runs-on: ubuntu-latest\n # `publish_results: true` only works when run from the default branch. conditional can be removed if disabled.\n if: github.event.repository.default_branch == github.ref_name || github.event_name == 'pull_request'\n permissions:\n # Needed to upload the results to code-scanning dashboard.\n security-events: write\n # Needed to publish results and get a badge (see publish_results below).\n id-token: write\n # Uncomment the permissions below if installing in a private repository.\n # contents: read\n # actions: read\n steps:\n - name: \"Checkout code\"\n uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd #v6.0.2\n with:\n persist-credentials: false\n - name: \"Run analysis\"\n uses: ossf/scorecard-action@4eaacf0543bb3f2c246792bd56e8cdeffafb205a # v2.4.3\n with:\n results_file: results.sarif\n results_format: sarif\n # (Optional) \"write\" PAT token. Uncomment the `repo_token` line below if:\n # - you want to enable the Branch-Protection check on a *public* repository, or\n # - you are installing Scorecard on a *private* repository\n # To create the PAT, follow the steps in https://github.com/ossf/scorecard-action?tab=readme-ov-file#authentication-with-fine-grained-pat-optional.\n # repo_token: ${{ secrets.SCORECARD_TOKEN }}\n\n # Public repositories:\n # - Publish results to OpenSSF REST API for easy access by consumers\n # - Allows the repository to include the Scorecard badge.\n # - See https://github.com/ossf/scorecard-action#publishing-results.\n # For private repositories:\n # - `publish_results` will always be set to `false`, regardless\n # of the value entered here.\n publish_results: true\n # (Optional) Uncomment file_mode if you have a .gitattributes with files marked export-ignore\n # file_mode: git\n # Upload the results as artifacts (optional). Commenting out will disable uploads of run results in SARIF\n # format to the repository Actions tab.\n - name: \"Upload artifact\"\n uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0\n with:\n name: SARIF file\n path: results.sarif\n retention-days: 5\n # Upload the results to GitHub's code scanning dashboard (optional).\n # Commenting out will disable upload of results to your repo's Code Scanning dashboard\n - name: \"Upload to code-scanning\"\n uses: github/codeql-action/upload-sarif@v4.33.0 #immutable\n with:\n sarif_file: results.sarif\n" }, { "path": ".github/workflows/test.yml", "content": "name: GoDriver Tests\non:\n push:\n pull_request:\npermissions:\n contents: read\nconcurrency:\n group: test-${{ github.ref }}\n cancel-in-progress: true\ndefaults:\n run:\n shell: bash -eux {0}\njobs:\n pre_commit:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd #v6.0.2\n - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 #v6.2.0\n - uses: actions/setup-go@4b73464bb391d4059bd26b0524d20df3927bd417 #v6.3.0\n with:\n go-version: 'stable'\n - uses: pre-commit/action@2c7b3805fd2a0fd8c1884dcaebf91fc102a13ecd #v3.0.1\n" }, { "path": ".gitignore", "content": ".vscode\ndebug\n.idea\n*.iml\n*.ipr\n*.iws\n.idea\n*.sublime-project\n*.sublime-workspace\ndriver-test-data.tar.gz\nperf\nperf.json\nperf.suite\n**mongocryptd.pid\n*.test\n.DS_Store\ninstall\nmain.so\n.cache\ninstall\nlibmongocrypt\nvenv\ntest.suite\ngo.work.sum\n.task\nenv.sh\nexpansion.yml\nbin\n\n# AWS SAM-generated files\ninternal/cmd/faas/awslambda/.aws-sam\ninternal/cmd/faas/awslambda/events/event.json\n\n# Ignore api report files\napi-report.md\napi-report.txt\n\n# Ignore perf report files\nperf-report.md\nperf-report.txt\n\n# Ignore secrets files\nsecrets-expansion.yml\nsecrets-export.sh\n.test.env\n" }, { "path": ".gitmodules", "content": "[submodule \"specifications\"]\n\tpath = testdata/specifications\n\turl = https://github.com/mongodb/specifications\n" }, { "path": ".golangci.yml", "content": "version: \"2\"\nlinters:\n default: none\n enable:\n - errcheck\n - gocritic\n # TODO(GODRIVER-3712): Enable gosec in golangci-lint version 2.8.0\n #- gosec\n - govet\n - ineffassign\n - makezero\n - misspell\n - nakedret\n - paralleltest\n - prealloc\n - revive\n - staticcheck\n - unconvert\n - unparam\n - unused\n settings:\n errcheck:\n exclude-functions:\n - .errcheck-excludes\n govet:\n disable:\n - cgocall\n - composites\n paralleltest:\n # Ignore missing calls to `t.Parallel()` and only report incorrect uses of\n # `t.Parallel()`.\n ignore-missing: true\n staticcheck:\n checks:\n - all\n # Disable deprecation warnings for now.\n - -SA1012\n # Disable \"do not pass a nil Context\" to allow testing nil contexts in\n # tests.\n - -SA1019\n exclusions:\n generated: lax\n rules:\n # Ignore some linters for example code that is intentionally simplified.\n - linters:\n - errcheck\n - revive\n path: examples/\n # Disable \"unused\" linter for code files that depend on the\n # \"mongocrypt.MongoCrypt\" type because the linter build doesn't work\n # correctly with CGO enabled. As a result, all calls to a\n # \"mongocrypt.MongoCrypt\" API appear to always panic (see\n # mongocrypt_not_enabled.go), leading to confusing messages about unused\n # code.\n - linters:\n - unused\n path: x/mongo/driver/crypt.go|mongo/(crypt_retrievers|mongocryptd).go\n # Ignore \"TLS MinVersion too low\", \"TLS InsecureSkipVerify set true\", and\n # \"Use of weak random number generator (math/rand instead of crypto/rand)\"\n # in tests. Disable gosec entirely for test files to reduce noise.\n - linters:\n - gosec\n path: _test\\.go\n # Ignore prealloc warnings for test files.\n - linters:\n - prealloc\n path: _test\\.go\n # Ignore missing comments for exported variable/function/type for code in\n # the \"internal\" and \"benchmark\" directories.\n - path: (internal\\/|benchmark\\/)\n text: exported (.+) should have comment( \\(or a comment on this block\\))? or be unexported\n # Ignore missing package comments for directories that aren't frequently\n # used by external users.\n - path: (internal\\/|benchmark\\/|x\\/|cmd\\/|mongo\\/integration\\/)\n text: should have a package comment\n # Add all default excluded issues except issues related to exported\n # types/functions not having comments; we want those warnings. The\n # defaults are copied from the \"--exclude-use-default\" documentation on\n # https://golangci-lint.run/usage/configuration/#command-line-options\n #\n ## Defaults ##\n #\n # EXC0001 errcheck: Almost all programs ignore errors on these functions\n # and in most cases it's ok\n - path: (.+)\\.go$\n text: Error return value of .((os\\.)?std(out|err)\\..*|.*Close|.*Flush|os\\.Remove(All)?|.*print(f|ln)?|os\\.(Un)?Setenv). is not checked\n # EXC0003 golint: False positive when tests are defined in package 'test'\n - path: (.+)\\.go$\n text: func name will be used as test\\.Test.* by other packages, and that stutters; consider calling this\n # EXC0004 govet: Common false positives\n - path: (.+)\\.go$\n text: (possible misuse of unsafe.Pointer|should have signature)\n # EXC0005 staticcheck: Developers tend to write in C-style with an explicit 'break' in a 'switch', so it's ok to ignore\n - path: (.+)\\.go$\n text: ineffective break statement. Did you mean to break out of the outer loop\n # EXC0006 gosec: Too many false-positives on 'unsafe' usage\n - path: (.+)\\.go$\n text: Use of unsafe calls should be audited\n # EXC0007 gosec: Too many false-positives for parametrized shell calls\n - path: (.+)\\.go$\n text: Subprocess launch(ed with variable|ing should be audited)\n # EXC0008 gosec: Duplicated errcheck checks\n - path: (.+)\\.go$\n text: (G104|G307)\n # EXC0009 gosec: Too many issues in popular repos\n - path: (.+)\\.go$\n text: (Expect directory permissions to be 0750 or less|Expect file permissions to be 0600 or less)\n # EXC0010 gosec: False positive is triggered by\n # 'src, err := ioutil.ReadFile(filename)'\n - path: (.+)\\.go$\n text: Potential file inclusion via variable\n ## End Defaults ##\n # Ignore capitalization warning for this weird field name.\n - path: (.+)\\.go$\n text: \"var-naming: struct field CqCssWxW should be CqCSSWxW\"\n # Ignore warnings for common \"wiremessage.Read...\" usage because the\n # safest way to use that API is by assigning possibly unused returned byte\n # buffers.\n - path: (.+)\\.go$\n text: \"SA4006: this value of `wm` is never used\"\n - path: (.+)\\.go$\n text: \"SA4006: this value of `rem` is never used\"\n - path: (.+)\\.go$\n text: ineffectual assignment to wm\n - path: (.+)\\.go$\n text: ineffectual assignment to rem\n paths:\n - (^|/)testdata($|/)\n - (^|/)etc($|/)\n # Disable all linters for copied third-party code.\n - internal/rand\n - internal/aws\n - internal/assert\nformatters:\n enable:\n - goimports\n exclusions:\n generated: lax\n paths:\n - (^|/)testdata($|/)\n - (^|/)etc($|/)\n - internal/rand\n - internal/aws\n - internal/assert\n" }, { "path": ".pre-commit-config.yaml", "content": "repos:\n - repo: https://github.com/pre-commit/pre-commit-hooks\n rev: v6.0.0\n hooks:\n - id: check-case-conflict\n - id: check-executables-have-shebangs\n - id: check-added-large-files\n - id: check-case-conflict\n - id: check-merge-conflict\n - id: check-json\n - id: end-of-file-fixer\n exclude: ^(vendor/|bson/testdata/lorem.txt)\n exclude_types: [json, yaml]\n - id: trailing-whitespace\n exclude: ^(vendor/|internal/assert/assertions_test.go|bson/testdata/lorem.txt)\n exclude_types: [json, yaml]\n - repo: https://github.com/executablebooks/mdformat\n rev: 0.7.17\n hooks:\n - id: mdformat\n exclude: ^vendor/\n - repo: https://github.com/python-jsonschema/check-jsonschema\n rev: 0.27.0\n hooks:\n - id: check-github-workflows\n # We use the Python version instead of the original version which seems to require Docker\n # https://github.com/koalaman/shellcheck-precommit\n - repo: https://github.com/shellcheck-py/shellcheck-py\n rev: v0.9.0.6\n hooks:\n - id: shellcheck\n name: shellcheck\n args: [\"--severity=warning\"]\n - repo: https://github.com/codespell-project/codespell\n rev: \"v2.2.6\"\n hooks:\n - id: codespell\n args: [\"-L\", \"te,fo,fle,alo,nin,compres,wil,collone,asess,sav,ot,wll,dne,nulll,hellow,aks\"]\n exclude: ^(vendor/|internal/cmd/benchmark/operation_test.go|bson/testdata/)\n exclude_types: [json, yaml, pem]\n - repo: https://github.com/tcort/markdown-link-check\n rev: v3.11.2\n hooks:\n - id: markdown-link-check\n exclude: ^(vendor)\n # If the endpoint returns HTTP 429 (Too Many Requests), consider it a\n # successful check.\n args: [\"-a 200,206,429\"]\n - repo: local\n hooks:\n - id: executable-shell\n name: executable-shell\n entry: chmod +x\n language: system\n types: [shell]\n - id: gofumpt\n name: gofumpt\n entry: gofumpt -w\n language: golang\n types: [go]\n exclude: ^vendor/\n additional_dependencies: [mvdan.cc/gofumpt@v0.9.2]\n - id: golangci-lint\n name: golangci-lint\n language: system\n types: [go]\n require_serial: true\n pass_filenames: false\n entry: etc/golangci-lint.sh\n - id: check-licenses\n name: check-licenses\n language: system\n types: [go]\n entry: etc/check_license.sh\n - repo: https://github.com/google/yamlfmt\n rev: v0.10.0\n hooks:\n - id: yamlfmt\n" }, { "path": "Dockerfile", "content": "# Dockerfile for Go Driver local development.\n# sha found via this command: docker inspect --format='{{index .RepoDigests 0}}' golang:1.25.6-trixie\nFROM golang:1.25.6-trixie@sha256:fb4b74a39c7318d53539ebda43ccd3ecba6e447a78591889c0efc0a7235ea8b3 AS base\n\n# Build libmongocrypt in a separate build stage.\nFROM base AS libmongocrypt\n\nRUN apt-get -qq update && \\\n apt-get -qqy install --no-install-recommends \\\n git \\\n ca-certificates \\\n curl \\\n build-essential \\\n libssl-dev \\\n pkg-config \\\n python3 \\\n python3-packaging \\\n python-is-python3 && \\\n rm -rf /var/lib/apt/lists/*\n\nCOPY etc/install-libmongocrypt.sh /root/install-libmongocrypt.sh\nRUN cd /root && bash ./install-libmongocrypt.sh\n\n\n# Final dev image (already has Go 1.25.x).\nFROM base\n\nRUN export DEBIAN_FRONTEND=noninteractive && \\\n export TZ=Etc/UTC && \\\n apt-get -qq update && \\\n apt-get -qqy install --reinstall --no-install-recommends \\\n git \\\n ca-certificates \\\n curl \\\n wget \\\n tzdata \\\n pkg-config \\\n gpg \\\n apt-utils \\\n libc6-dev \\\n gcc \\\n make \\\n libkrb5-dev && \\\n update-ca-certificates && \\\n rm -rf /var/lib/apt/lists/*\n\n# Install taskfile\nRUN go install github.com/go-task/task/v3/cmd/task@v3.39.2\n\nCOPY etc/docker_entry.sh /root/docker_entry.sh\nCOPY --from=libmongocrypt /root/install /root/install\n\n# Copy the Go driver source for local development and compile checks.\nCOPY . /mongo-go-driver\n\nENV DOCKER_RUNNING=true\nENTRYPOINT [\"/bin/bash\", \"/root/docker_entry.sh\"]\n" }, { "path": "LICENSE", "content": " Apache License\n Version 2.0, January 2004\n http://www.apache.org/licenses/\n\n TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n 1. Definitions.\n\n \"License\" shall mean the terms and conditions for use, reproduction,\n and distribution as defined by Sections 1 through 9 of this document.\n\n \"Licensor\" shall mean the copyright owner or entity authorized by\n the copyright owner that is granting the License.\n\n \"Legal Entity\" shall mean the union of the acting entity and all\n other entities that control, are controlled by, or are under common\n control with that entity. For the purposes of this definition,\n \"control\" means (i) the power, direct or indirect, to cause the\n direction or management of such entity, whether by contract or\n otherwise, or (ii) ownership of fifty percent (50%) or more of the\n outstanding shares, or (iii) beneficial ownership of such entity.\n\n \"You\" (or \"Your\") shall mean an individual or Legal Entity\n exercising permissions granted by this License.\n\n \"Source\" form shall mean the preferred form for making modifications,\n including but not limited to software source code, documentation\n source, and configuration files.\n\n \"Object\" form shall mean any form resulting from mechanical\n transformation or translation of a Source form, including but\n not limited to compiled object code, generated documentation,\n and conversions to other media types.\n\n \"Work\" shall mean the work of authorship, whether in Source or\n Object form, made available under the License, as indicated by a\n copyright notice that is included in or attached to the work\n (an example is provided in the Appendix below).\n\n \"Derivative Works\" shall mean any work, whether in Source or Object\n form, that is based on (or derived from) the Work and for which the\n editorial revisions, annotations, elaborations, or other modifications\n represent, as a whole, an original work of authorship. For the purposes\n of this License, Derivative Works shall not include works that remain\n separable from, or merely link (or bind by name) to the interfaces of,\n the Work and Derivative Works thereof.\n\n \"Contribution\" shall mean any work of authorship, including\n the original version of the Work and any modifications or additions\n to that Work or Derivative Works thereof, that is intentionally\n submitted to Licensor for inclusion in the Work by the copyright owner\n or by an individual or Legal Entity authorized to submit on behalf of\n the copyright owner. For the purposes of this definition, \"submitted\"\n means any form of electronic, verbal, or written communication sent\n to the Licensor or its representatives, including but not limited to\n communication on electronic mailing lists, source code control systems,\n and issue tracking systems that are managed by, or on behalf of, the\n Licensor for the purpose of discussing and improving the Work, but\n excluding communication that is conspicuously marked or otherwise\n designated in writing by the copyright owner as \"Not a Contribution.\"\n\n \"Contributor\" shall mean Licensor and any individual or Legal Entity\n on behalf of whom a Contribution has been received by Licensor and\n subsequently incorporated within the Work.\n\n 2. Grant of Copyright License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n copyright license to reproduce, prepare Derivative Works of,\n publicly display, publicly perform, sublicense, and distribute the\n Work and such Derivative Works in Source or Object form.\n\n 3. Grant of Patent License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n (except as stated in this section) patent license to make, have made,\n use, offer to sell, sell, import, and otherwise transfer the Work,\n where such license applies only to those patent claims licensable\n by such Contributor that are necessarily infringed by their\n Contribution(s) alone or by combination of their Contribution(s)\n with the Work to which such Contribution(s) was submitted. If You\n institute patent litigation against any entity (including a\n cross-claim or counterclaim in a lawsuit) alleging that the Work\n or a Contribution incorporated within the Work constitutes direct\n or contributory patent infringement, then any patent licenses\n granted to You under this License for that Work shall terminate\n as of the date such litigation is filed.\n\n 4. Redistribution. You may reproduce and distribute copies of the\n Work or Derivative Works thereof in any medium, with or without\n modifications, and in Source or Object form, provided that You\n meet the following conditions:\n\n (a) You must give any other recipients of the Work or\n Derivative Works a copy of this License; and\n\n (b) You must cause any modified files to carry prominent notices\n stating that You changed the files; and\n\n (c) You must retain, in the Source form of any Derivative Works\n that You distribute, all copyright, patent, trademark, and\n attribution notices from the Source form of the Work,\n excluding those notices that do not pertain to any part of\n the Derivative Works; and\n\n (d) If the Work includes a \"NOTICE\" text file as part of its\n distribution, then any Derivative Works that You distribute must\n include a readable copy of the attribution notices contained\n within such NOTICE file, excluding those notices that do not\n pertain to any part of the Derivative Works, in at least one\n of the following places: within a NOTICE text file distributed\n as part of the Derivative Works; within the Source form or\n documentation, if provided along with the Derivative Works; or,\n within a display generated by the Derivative Works, if and\n wherever such third-party notices normally appear. The contents\n of the NOTICE file are for informational purposes only and\n do not modify the License. You may add Your own attribution\n notices within Derivative Works that You distribute, alongside\n or as an addendum to the NOTICE text from the Work, provided\n that such additional attribution notices cannot be construed\n as modifying the License.\n\n You may add Your own copyright statement to Your modifications and\n may provide additional or different license terms and conditions\n for use, reproduction, or distribution of Your modifications, or\n for any such Derivative Works as a whole, provided Your use,\n reproduction, and distribution of the Work otherwise complies with\n the conditions stated in this License.\n\n 5. Submission of Contributions. Unless You explicitly state otherwise,\n any Contribution intentionally submitted for inclusion in the Work\n by You to the Licensor shall be under the terms and conditions of\n this License, without any additional terms or conditions.\n Notwithstanding the above, nothing herein shall supersede or modify\n the terms of any separate license agreement you may have executed\n with Licensor regarding such Contributions.\n\n 6. Trademarks. This License does not grant permission to use the trade\n names, trademarks, service marks, or product names of the Licensor,\n except as required for reasonable and customary use in describing the\n origin of the Work and reproducing the content of the NOTICE file.\n\n 7. Disclaimer of Warranty. Unless required by applicable law or\n agreed to in writing, Licensor provides the Work (and each\n Contributor provides its Contributions) on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n implied, including, without limitation, any warranties or conditions\n of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n PARTICULAR PURPOSE. You are solely responsible for determining the\n appropriateness of using or redistributing the Work and assume any\n risks associated with Your exercise of permissions under this License.\n\n 8. Limitation of Liability. In no event and under no legal theory,\n whether in tort (including negligence), contract, or otherwise,\n unless required by applicable law (such as deliberate and grossly\n negligent acts) or agreed to in writing, shall any Contributor be\n liable to You for damages, including any direct, indirect, special,\n incidental, or consequential damages of any character arising as a\n result of this License or out of the use or inability to use the\n Work (including but not limited to damages for loss of goodwill,\n work stoppage, computer failure or malfunction, or any and all\n other commercial damages or losses), even if such Contributor\n has been advised of the possibility of such damages.\n\n 9. Accepting Warranty or Additional Liability. While redistributing\n the Work or Derivative Works thereof, You may choose to offer,\n and charge a fee for, acceptance of support, warranty, indemnity,\n or other liability obligations and/or rights consistent with this\n License. However, in accepting such obligations, You may act only\n on Your own behalf and on Your sole responsibility, not on behalf\n of any other Contributor, and only if You agree to indemnify,\n defend, and hold each Contributor harmless for any liability\n incurred by, or claims asserted against, such Contributor by reason\n of your accepting any such warranty or additional liability.\n\n END OF TERMS AND CONDITIONS\n\n APPENDIX: How to apply the Apache License to your work.\n\n To apply the Apache License to your work, attach the following\n boilerplate notice, with the fields enclosed by brackets \"[]\"\n replaced with your own identifying information. (Don't include\n the brackets!) The text should be enclosed in the appropriate\n comment syntax for the file format. We also recommend that a\n file or class name and description of purpose be included on the\n same \"printed page\" as the copyright notice for easier\n identification within third-party archives.\n\n Copyright [yyyy] [name of copyright owner]\n\n Licensed under the Apache License, Version 2.0 (the \"License\");\n you may not use this file except in compliance with the License.\n You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing, software\n distributed under the License is distributed on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n See the License for the specific language governing permissions and\n limitations under the License.\n" }, { "path": "README.md", "content": "

\n

\n \n \"docs\"\n \"docs\"\n \n \n \"OpenSSF\n \n

\n\n# MongoDB Go Driver\n\nThe MongoDB supported driver for Go.\n\nSee the following resources to learn more about upgrading from version 1.x to 2.0.:\n\n- [v2.0 Migration Guide](docs/migration-2.0.md)\n- [v2.0 What's New](https://www.mongodb.com/docs/drivers/go/upcoming/whats-new/#what-s-new-in-2.0)\n\nThe MongoDB Go driver follows [semantic versioning](https://semver.org/) for its releases.\n\n## Requirements\n\n- Go 1.19 or higher. We aim to support the latest versions of Go.\n- Go 1.25 or higher is required to run the driver test suite.\n- MongoDB 4.2 and higher.\n\n## Installation\n\nThe recommended way to get started using the MongoDB Go driver is by using Go modules to install the dependency in\nyour project. This can be done either by importing packages from `go.mongodb.org/mongo-driver` and having the build\nstep install the dependency or by explicitly running\n\n```bash\ngo get go.mongodb.org/mongo-driver/v2/mongo\n```\n\nWhen using a version of Go that does not support modules, the driver can be installed using `dep` by running\n\n```bash\ndep ensure -add \"go.mongodb.org/mongo-driver/v2/mongo\"\n```\n\n## Usage\n\nTo get started with the driver, import the `mongo` package and create a `mongo.Client` with the `Connect` function:\n\n```go\nimport (\n \"context\"\n \"time\"\n\n \"go.mongodb.org/mongo-driver/v2/mongo\"\n \"go.mongodb.org/mongo-driver/v2/mongo/options\"\n \"go.mongodb.org/mongo-driver/v2/mongo/readpref\"\n)\n\nclient, _ := mongo.Connect(options.Client().ApplyURI(\"mongodb://localhost:27017\"))\n```\n\nMake sure to defer a call to `Disconnect` after instantiating your client:\n\n```go\ndefer func() {\n if err := client.Disconnect(ctx); err != nil {\n panic(err)\n }\n}()\n```\n\nFor more advanced configuration and authentication, see the [documentation for mongo.Connect](https://pkg.go.dev/go.mongodb.org/mongo-driver/v2/mongo#Connect).\n\nCalling `Connect` does not block for server discovery. If you wish to know if a MongoDB server has been found and connected to,\nuse the `Ping` method:\n\n```go\nctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)\ndefer cancel()\n\n_ = client.Ping(ctx, readpref.Primary())\n```\n\nTo insert a document into a collection, first retrieve a `Database` and then `Collection` instance from the `Client`:\n\n```go\ncollection := client.Database(\"testing\").Collection(\"numbers\")\n```\n\nThe `Collection` instance can then be used to insert documents:\n\n```go\nctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)\ndefer cancel()\n\nres, _ := collection.InsertOne(ctx, bson.D{{\"name\", \"pi\"}, {\"value\", 3.14159}})\nid := res.InsertedID\n```\n\nTo use `bson.D`, you will need to add `\"go.mongodb.org/mongo-driver/v2/bson\"` to your imports.\n\nYour import statement should now look like this:\n\n```go\nimport (\n \"context\"\n \"log\"\n \"time\"\n\n \"go.mongodb.org/mongo-driver/v2/bson\"\n \"go.mongodb.org/mongo-driver/v2/mongo\"\n \"go.mongodb.org/mongo-driver/v2/mongo/options\"\n \"go.mongodb.org/mongo-driver/v2/mongo/readpref\"\n)\n```\n\nSeveral query methods return a cursor, which can be used like this:\n\n```go\nctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)\ndefer cancel()\n\ncur, err := collection.Find(ctx, bson.D{})\nif err != nil {\n log.Fatal(err)\n}\n\ndefer cur.Close(ctx)\nfor cur.Next(ctx) {\n var result bson.D\n if err := cur.Decode(&result); err != nil {\n log.Fatal(err)\n }\n\n // do something with result....\n}\n\nif err := cur.Err(); err != nil {\n log.Fatal(err)\n}\n```\n\nFor methods that return a single item, a `SingleResult` instance is returned:\n\n```go\nvar result struct {\n Value float64\n}\n\nfilter := bson.D{{\"name\", \"pi\"}}\nctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)\ndefer cancel()\n\nerr := collection.FindOne(ctx, filter).Decode(&result)\nif errors.Is(err, mongo.ErrNoDocuments) {\n // Do something when no record was found\n} else if err != nil {\n log.Fatal(err)\n}\n\n// Do something with result...\n```\n\nAdditional examples and documentation can be found under the examples directory and [on the MongoDB Documentation website](https://www.mongodb.com/docs/drivers/go/current/).\n\n### Network Compression\n\nNetwork compression will reduce bandwidth requirements between MongoDB and the application.\n\nThe Go Driver supports the following compression algorithms:\n\n1. [Snappy](https://google.github.io/snappy/) (`snappy`): available in MongoDB 3.4 and later.\n1. [Zlib](https://zlib.net/) (`zlib`): available in MongoDB 3.6 and later.\n1. [Zstandard](https://github.com/facebook/zstd/) (`zstd`): available in MongoDB 4.2 and later.\n\n#### Specify Compression Algorithms\n\nCompression can be enabled using the `compressors` parameter on the connection string or by using [`ClientOptions.SetCompressors`](https://pkg.go.dev/go.mongodb.org/mongo-driver/mongo/options#ClientOptions.SetCompressors):\n\n```go\nopts := options.Client().ApplyURI(\"mongodb://localhost:27017/?compressors=snappy,zlib,zstd\")\nclient, _ := mongo.Connect(opts)\n```\n\n```go\nopts := options.Client().SetCompressors([]string{\"snappy\", \"zlib\", \"zstd\"})\nclient, _ := mongo.Connect(opts)\n```\n\nIf compressors are set, the Go Driver negotiates with the server to select the first common compressor. For server configuration and defaults, refer to [`networkMessageCompressors`](https://www.mongodb.com/docs/manual/reference/program/mongod/#std-option-mongod.--networkMessageCompressors).\n\nMessages compress when both parties enable network compression; otherwise, messages remain uncompressed\n\n## Support / Feedback\n\nFor issues with, questions about, or feedback for the Go Driver, please look into our [support channels](https://www.mongodb.com/docs/manual/support/), including [StackOverflow](https://stackoverflow.com/questions/tagged/mongodb%20go?sort=Newest).\n\nNew features and bugs can be reported on the [GODRIVER Jira project](https://jira.mongodb.org/browse/GODRIVER).\n\n## Contribution\n\nCheck out the [GODRIVER Jira project](https://jira.mongodb.org/browse/GODRIVER) for tickets that need completing. See our [contribution guidelines](docs/CONTRIBUTING.md) for details.\n\n## Continuous Integration\n\nCommits to master are run automatically on [evergreen](https://evergreen.mongodb.com/waterfall/mongo-go-driver).\n\n## Frequently Encountered Issues\n\nSee our [common issues](docs/common-issues.md) documentation for troubleshooting frequently encountered issues.\n\n## Thanks and Acknowledgement\n\n- The Go Gopher artwork by [@ashleymcnamara](https://github.com/ashleymcnamara)\n- The original Go Gopher was designed by [Renee French](http://reneefrench.blogspot.com/)\n\n## License\n\nThe MongoDB Go Driver is licensed under the [Apache License](LICENSE).\n" }, { "path": "THIRD-PARTY-NOTICES", "content": "----------------------------------------------------------------------\nLicense notice for AWS V4 signing code from github.com/aws/aws-sdk-go\nAWS SDK for Go\nCopyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved.\nCopyright 2014-2015 Stripe, Inc.\n----------------------------------------------------------------------\n\n\n Apache License\n Version 2.0, January 2004\n http://www.apache.org/licenses/\n\n TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n 1. Definitions.\n\n \"License\" shall mean the terms and conditions for use, reproduction,\n and distribution as defined by Sections 1 through 9 of this document.\n\n \"Licensor\" shall mean the copyright owner or entity authorized by\n the copyright owner that is granting the License.\n\n \"Legal Entity\" shall mean the union of the acting entity and all\n other entities that control, are controlled by, or are under common\n control with that entity. For the purposes of this definition,\n \"control\" means (i) the power, direct or indirect, to cause the\n direction or management of such entity, whether by contract or\n otherwise, or (ii) ownership of fifty percent (50%) or more of the\n outstanding shares, or (iii) beneficial ownership of such entity.\n\n \"You\" (or \"Your\") shall mean an individual or Legal Entity\n exercising permissions granted by this License.\n\n \"Source\" form shall mean the preferred form for making modifications,\n including but not limited to software source code, documentation\n source, and configuration files.\n\n \"Object\" form shall mean any form resulting from mechanical\n transformation or translation of a Source form, including but\n not limited to compiled object code, generated documentation,\n and conversions to other media types.\n\n \"Work\" shall mean the work of authorship, whether in Source or\n Object form, made available under the License, as indicated by a\n copyright notice that is included in or attached to the work\n (an example is provided in the Appendix below).\n\n \"Derivative Works\" shall mean any work, whether in Source or Object\n form, that is based on (or derived from) the Work and for which the\n editorial revisions, annotations, elaborations, or other modifications\n represent, as a whole, an original work of authorship. For the purposes\n of this License, Derivative Works shall not include works that remain\n separable from, or merely link (or bind by name) to the interfaces of,\n the Work and Derivative Works thereof.\n\n \"Contribution\" shall mean any work of authorship, including\n the original version of the Work and any modifications or additions\n to that Work or Derivative Works thereof, that is intentionally\n submitted to Licensor for inclusion in the Work by the copyright owner\n or by an individual or Legal Entity authorized to submit on behalf of\n the copyright owner. For the purposes of this definition, \"submitted\"\n means any form of electronic, verbal, or written communication sent\n to the Licensor or its representatives, including but not limited to\n communication on electronic mailing lists, source code control systems,\n and issue tracking systems that are managed by, or on behalf of, the\n Licensor for the purpose of discussing and improving the Work, but\n excluding communication that is conspicuously marked or otherwise\n designated in writing by the copyright owner as \"Not a Contribution.\"\n\n \"Contributor\" shall mean Licensor and any individual or Legal Entity\n on behalf of whom a Contribution has been received by Licensor and\n subsequently incorporated within the Work.\n\n 2. Grant of Copyright License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n copyright license to reproduce, prepare Derivative Works of,\n publicly display, publicly perform, sublicense, and distribute the\n Work and such Derivative Works in Source or Object form.\n\n 3. Grant of Patent License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n (except as stated in this section) patent license to make, have made,\n use, offer to sell, sell, import, and otherwise transfer the Work,\n where such license applies only to those patent claims licensable\n by such Contributor that are necessarily infringed by their\n Contribution(s) alone or by combination of their Contribution(s)\n with the Work to which such Contribution(s) was submitted. If You\n institute patent litigation against any entity (including a\n cross-claim or counterclaim in a lawsuit) alleging that the Work\n or a Contribution incorporated within the Work constitutes direct\n or contributory patent infringement, then any patent licenses\n granted to You under this License for that Work shall terminate\n as of the date such litigation is filed.\n\n 4. Redistribution. You may reproduce and distribute copies of the\n Work or Derivative Works thereof in any medium, with or without\n modifications, and in Source or Object form, provided that You\n meet the following conditions:\n\n (a) You must give any other recipients of the Work or\n Derivative Works a copy of this License; and\n\n (b) You must cause any modified files to carry prominent notices\n stating that You changed the files; and\n\n (c) You must retain, in the Source form of any Derivative Works\n that You distribute, all copyright, patent, trademark, and\n attribution notices from the Source form of the Work,\n excluding those notices that do not pertain to any part of\n the Derivative Works; and\n\n (d) If the Work includes a \"NOTICE\" text file as part of its\n distribution, then any Derivative Works that You distribute must\n include a readable copy of the attribution notices contained\n within such NOTICE file, excluding those notices that do not\n pertain to any part of the Derivative Works, in at least one\n of the following places: within a NOTICE text file distributed\n as part of the Derivative Works; within the Source form or\n documentation, if provided along with the Derivative Works; or,\n within a display generated by the Derivative Works, if and\n wherever such third-party notices normally appear. The contents\n of the NOTICE file are for informational purposes only and\n do not modify the License. You may add Your own attribution\n notices within Derivative Works that You distribute, alongside\n or as an addendum to the NOTICE text from the Work, provided\n that such additional attribution notices cannot be construed\n as modifying the License.\n\n You may add Your own copyright statement to Your modifications and\n may provide additional or different license terms and conditions\n for use, reproduction, or distribution of Your modifications, or\n for any such Derivative Works as a whole, provided Your use,\n reproduction, and distribution of the Work otherwise complies with\n the conditions stated in this License.\n\n 5. Submission of Contributions. Unless You explicitly state otherwise,\n any Contribution intentionally submitted for inclusion in the Work\n by You to the Licensor shall be under the terms and conditions of\n this License, without any additional terms or conditions.\n Notwithstanding the above, nothing herein shall supersede or modify\n the terms of any separate license agreement you may have executed\n with Licensor regarding such Contributions.\n\n 6. Trademarks. This License does not grant permission to use the trade\n names, trademarks, service marks, or product names of the Licensor,\n except as required for reasonable and customary use in describing the\n origin of the Work and reproducing the content of the NOTICE file.\n\n 7. Disclaimer of Warranty. Unless required by applicable law or\n agreed to in writing, Licensor provides the Work (and each\n Contributor provides its Contributions) on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n implied, including, without limitation, any warranties or conditions\n of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n PARTICULAR PURPOSE. You are solely responsible for determining the\n appropriateness of using or redistributing the Work and assume any\n risks associated with Your exercise of permissions under this License.\n\n 8. Limitation of Liability. In no event and under no legal theory,\n whether in tort (including negligence), contract, or otherwise,\n unless required by applicable law (such as deliberate and grossly\n negligent acts) or agreed to in writing, shall any Contributor be\n liable to You for damages, including any direct, indirect, special,\n incidental, or consequential damages of any character arising as a\n result of this License or out of the use or inability to use the\n Work (including but not limited to damages for loss of goodwill,\n work stoppage, computer failure or malfunction, or any and all\n other commercial damages or losses), even if such Contributor\n has been advised of the possibility of such damages.\n\n 9. Accepting Warranty or Additional Liability. While redistributing\n the Work or Derivative Works thereof, You may choose to offer,\n and charge a fee for, acceptance of support, warranty, indemnity,\n or other liability obligations and/or rights consistent with this\n License. However, in accepting such obligations, You may act only\n on Your own behalf and on Your sole responsibility, not on behalf\n of any other Contributor, and only if You agree to indemnify,\n defend, and hold each Contributor harmless for any liability\n incurred by, or claims asserted against, such Contributor by reason\n of your accepting any such warranty or additional liability.\n\n---------------------------------------------------------------------\nLicense notice for gopkg.in/mgo.v2/bson\n---------------------------------------------------------------------\n\nBSON library for Go\n\nCopyright (c) 2010-2013 - Gustavo Niemeyer \n\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are met:\n\n1. Redistributions of source code must retain the above copyright notice, this\n list of conditions and the following disclaimer.\n2. Redistributions in binary form must reproduce the above copyright notice,\n this list of conditions and the following disclaimer in the documentation\n and/or other materials provided with the distribution.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\nWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\nDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR\nANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\nLOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND\nON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\nSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n---------------------------------------------------------------------\nLicense notice for JSON and CSV code from github.com/golang/go\n---------------------------------------------------------------------\n\nCopyright (c) 2009 The Go Authors. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n * Redistributions of source code must retain the above copyright\nnotice, this list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above\ncopyright notice, this list of conditions and the following disclaimer\nin the documentation and/or other materials provided with the\ndistribution.\n * Neither the name of Google Inc. nor the names of its\ncontributors may be used to endorse or promote products derived from\nthis software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\nOWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\nLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\nDATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\nTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n---------------------------------------------------------------------\nLicense notice for rand code from golang.org/x/exp\n---------------------------------------------------------------------\n\nCopyright (c) 2009 The Go Authors. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n * Redistributions of source code must retain the above copyright\nnotice, this list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above\ncopyright notice, this list of conditions and the following disclaimer\nin the documentation and/or other materials provided with the\ndistribution.\n * Neither the name of Google Inc. nor the names of its\ncontributors may be used to endorse or promote products derived from\nthis software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\nOWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\nLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\nDATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\nTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n---------------------------------------------------------------------\nLicense notice for Add64 and Mul64 code from github.com/golang/go\n---------------------------------------------------------------------\n\nCopyright (c) 2009 The Go Authors. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n * Redistributions of source code must retain the above copyright\nnotice, this list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above\ncopyright notice, this list of conditions and the following disclaimer\nin the documentation and/or other materials provided with the\ndistribution.\n * Neither the name of Google Inc. nor the names of its\ncontributors may be used to endorse or promote products derived from\nthis software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\nOWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\nLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\nDATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\nTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n----------------------------------------------------------------------\nLicense notice for github.com/davecgh/go-spew\n----------------------------------------------------------------------\n\nISC License\n\nCopyright (c) 2012-2016 Dave Collins \n\nPermission to use, copy, modify, and/or distribute this software for any\npurpose with or without fee is hereby granted, provided that the above\ncopyright notice and this permission notice appear in all copies.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES\nWITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF\nMERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR\nANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES\nWHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN\nACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF\nOR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.\n\n----------------------------------------------------------------------\nLicense notice for github.com/google/go-cmp\n----------------------------------------------------------------------\n\nCopyright (c) 2017 The Go Authors. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n * Redistributions of source code must retain the above copyright\nnotice, this list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above\ncopyright notice, this list of conditions and the following disclaimer\nin the documentation and/or other materials provided with the\ndistribution.\n * Neither the name of Google Inc. nor the names of its\ncontributors may be used to endorse or promote products derived from\nthis software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\nOWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\nLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\nDATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\nTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n----------------------------------------------------------------------\nLicense notice for github.com/klauspost/compress\n----------------------------------------------------------------------\n\nCopyright (c) 2012 The Go Authors. All rights reserved.\nCopyright (c) 2019 Klaus Post. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n * Redistributions of source code must retain the above copyright\nnotice, this list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above\ncopyright notice, this list of conditions and the following disclaimer\nin the documentation and/or other materials provided with the\ndistribution.\n * Neither the name of Google Inc. nor the names of its\ncontributors may be used to endorse or promote products derived from\nthis software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\nOWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\nLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\nDATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\nTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n----------------------------------------------------------------------\nLicense notice for github.com/klauspost/compress/snappy\n----------------------------------------------------------------------\n\nCopyright (c) 2011 The Snappy-Go Authors. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n * Redistributions of source code must retain the above copyright\nnotice, this list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above\ncopyright notice, this list of conditions and the following disclaimer\nin the documentation and/or other materials provided with the\ndistribution.\n * Neither the name of Google Inc. nor the names of its\ncontributors may be used to endorse or promote products derived from\nthis software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\nOWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\nLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\nDATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\nTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n----------------------------------------------------------------------\nLicense notice for github.com/konsorten/go-windows-terminal-sequences\n----------------------------------------------------------------------\n\n(The MIT License)\n\nCopyright (c) 2017 marvin + konsorten GmbH (open-source@konsorten.de)\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\n----------------------------------------------------------------------\nLicense notice for github.com/markbates/oncer\n----------------------------------------------------------------------\n\nThe MIT License (MIT)\n\nCopyright (c) 2018 Mark Bates\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n----------------------------------------------------------------------\nLicense notice for github.com/markbates/safe\n----------------------------------------------------------------------\n\nThe MIT License (MIT)\n\nCopyright (c) 2018 Mark Bates\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n----------------------------------------------------------------------\nLicense notice for github.com/montanaflynn/stats\n----------------------------------------------------------------------\n\nThe MIT License (MIT)\n\nCopyright (c) 2014-2015 Montana Flynn (https://anonfunction.com)\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n----------------------------------------------------------------------\nLicense notice for github.com/pkg/errors\n----------------------------------------------------------------------\n\nCopyright (c) 2015, Dave Cheney \nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are met:\n\n* Redistributions of source code must retain the above copyright notice, this\n list of conditions and the following disclaimer.\n\n* Redistributions in binary form must reproduce the above copyright notice,\n this list of conditions and the following disclaimer in the documentation\n and/or other materials provided with the distribution.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\"\nAND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\nDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\nSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER\nCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,\nOR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n----------------------------------------------------------------------\nLicense notice for github.com/pmezard/go-difflib\n----------------------------------------------------------------------\n\nCopyright (c) 2013, Patrick Mezard\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n Redistributions of source code must retain the above copyright\nnotice, this list of conditions and the following disclaimer.\n Redistributions in binary form must reproduce the above copyright\nnotice, this list of conditions and the following disclaimer in the\ndocumentation and/or other materials provided with the distribution.\n The names of its contributors may not be used to endorse or promote\nproducts derived from this software without specific prior written\npermission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS\nIS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED\nTO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A\nPARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\nHOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED\nTO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR\nPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF\nLIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\nNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\nSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n----------------------------------------------------------------------\nLicense notice for github.com/rogpeppe/go-internal\n----------------------------------------------------------------------\n\nCopyright (c) 2018 The Go Authors. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n * Redistributions of source code must retain the above copyright\nnotice, this list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above\ncopyright notice, this list of conditions and the following disclaimer\nin the documentation and/or other materials provided with the\ndistribution.\n * Neither the name of Google Inc. nor the names of its\ncontributors may be used to endorse or promote products derived from\nthis software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\nOWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\nLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\nDATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\nTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n----------------------------------------------------------------------\nLicense notice for github.com/stretchr/testify\n----------------------------------------------------------------------\n\nMIT License\n\nCopyright (c) 2012-2020 Mat Ryer, Tyler Bunnell and contributors.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n----------------------------------------------------------------------\nLicense notice for github.com/xdg-go/pbkdf2\n----------------------------------------------------------------------\n\n\n Apache License\n Version 2.0, January 2004\n http://www.apache.org/licenses/\n\n TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n 1. Definitions.\n\n \"License\" shall mean the terms and conditions for use, reproduction,\n and distribution as defined by Sections 1 through 9 of this document.\n\n \"Licensor\" shall mean the copyright owner or entity authorized by\n the copyright owner that is granting the License.\n\n \"Legal Entity\" shall mean the union of the acting entity and all\n other entities that control, are controlled by, or are under common\n control with that entity. For the purposes of this definition,\n \"control\" means (i) the power, direct or indirect, to cause the\n direction or management of such entity, whether by contract or\n otherwise, or (ii) ownership of fifty percent (50%) or more of the\n outstanding shares, or (iii) beneficial ownership of such entity.\n\n \"You\" (or \"Your\") shall mean an individual or Legal Entity\n exercising permissions granted by this License.\n\n \"Source\" form shall mean the preferred form for making modifications,\n including but not limited to software source code, documentation\n source, and configuration files.\n\n \"Object\" form shall mean any form resulting from mechanical\n transformation or translation of a Source form, including but\n not limited to compiled object code, generated documentation,\n and conversions to other media types.\n\n \"Work\" shall mean the work of authorship, whether in Source or\n Object form, made available under the License, as indicated by a\n copyright notice that is included in or attached to the work\n (an example is provided in the Appendix below).\n\n \"Derivative Works\" shall mean any work, whether in Source or Object\n form, that is based on (or derived from) the Work and for which the\n editorial revisions, annotations, elaborations, or other modifications\n represent, as a whole, an original work of authorship. For the purposes\n of this License, Derivative Works shall not include works that remain\n separable from, or merely link (or bind by name) to the interfaces of,\n the Work and Derivative Works thereof.\n\n \"Contribution\" shall mean any work of authorship, including\n the original version of the Work and any modifications or additions\n to that Work or Derivative Works thereof, that is intentionally\n submitted to Licensor for inclusion in the Work by the copyright owner\n or by an individual or Legal Entity authorized to submit on behalf of\n the copyright owner. For the purposes of this definition, \"submitted\"\n means any form of electronic, verbal, or written communication sent\n to the Licensor or its representatives, including but not limited to\n communication on electronic mailing lists, source code control systems,\n and issue tracking systems that are managed by, or on behalf of, the\n Licensor for the purpose of discussing and improving the Work, but\n excluding communication that is conspicuously marked or otherwise\n designated in writing by the copyright owner as \"Not a Contribution.\"\n\n \"Contributor\" shall mean Licensor and any individual or Legal Entity\n on behalf of whom a Contribution has been received by Licensor and\n subsequently incorporated within the Work.\n\n 2. Grant of Copyright License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n copyright license to reproduce, prepare Derivative Works of,\n publicly display, publicly perform, sublicense, and distribute the\n Work and such Derivative Works in Source or Object form.\n\n 3. Grant of Patent License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n (except as stated in this section) patent license to make, have made,\n use, offer to sell, sell, import, and otherwise transfer the Work,\n where such license applies only to those patent claims licensable\n by such Contributor that are necessarily infringed by their\n Contribution(s) alone or by combination of their Contribution(s)\n with the Work to which such Contribution(s) was submitted. If You\n institute patent litigation against any entity (including a\n cross-claim or counterclaim in a lawsuit) alleging that the Work\n or a Contribution incorporated within the Work constitutes direct\n or contributory patent infringement, then any patent licenses\n granted to You under this License for that Work shall terminate\n as of the date such litigation is filed.\n\n 4. Redistribution. You may reproduce and distribute copies of the\n Work or Derivative Works thereof in any medium, with or without\n modifications, and in Source or Object form, provided that You\n meet the following conditions:\n\n (a) You must give any other recipients of the Work or\n Derivative Works a copy of this License; and\n\n (b) You must cause any modified files to carry prominent notices\n stating that You changed the files; and\n\n (c) You must retain, in the Source form of any Derivative Works\n that You distribute, all copyright, patent, trademark, and\n attribution notices from the Source form of the Work,\n excluding those notices that do not pertain to any part of\n the Derivative Works; and\n\n (d) If the Work includes a \"NOTICE\" text file as part of its\n distribution, then any Derivative Works that You distribute must\n include a readable copy of the attribution notices contained\n within such NOTICE file, excluding those notices that do not\n pertain to any part of the Derivative Works, in at least one\n of the following places: within a NOTICE text file distributed\n as part of the Derivative Works; within the Source form or\n documentation, if provided along with the Derivative Works; or,\n within a display generated by the Derivative Works, if and\n wherever such third-party notices normally appear. The contents\n of the NOTICE file are for informational purposes only and\n do not modify the License. You may add Your own attribution\n notices within Derivative Works that You distribute, alongside\n or as an addendum to the NOTICE text from the Work, provided\n that such additional attribution notices cannot be construed\n as modifying the License.\n\n You may add Your own copyright statement to Your modifications and\n may provide additional or different license terms and conditions\n for use, reproduction, or distribution of Your modifications, or\n for any such Derivative Works as a whole, provided Your use,\n reproduction, and distribution of the Work otherwise complies with\n the conditions stated in this License.\n\n 5. Submission of Contributions. Unless You explicitly state otherwise,\n any Contribution intentionally submitted for inclusion in the Work\n by You to the Licensor shall be under the terms and conditions of\n this License, without any additional terms or conditions.\n Notwithstanding the above, nothing herein shall supersede or modify\n the terms of any separate license agreement you may have executed\n with Licensor regarding such Contributions.\n\n 6. Trademarks. This License does not grant permission to use the trade\n names, trademarks, service marks, or product names of the Licensor,\n except as required for reasonable and customary use in describing the\n origin of the Work and reproducing the content of the NOTICE file.\n\n 7. Disclaimer of Warranty. Unless required by applicable law or\n agreed to in writing, Licensor provides the Work (and each\n Contributor provides its Contributions) on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n implied, including, without limitation, any warranties or conditions\n of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n PARTICULAR PURPOSE. You are solely responsible for determining the\n appropriateness of using or redistributing the Work and assume any\n risks associated with Your exercise of permissions under this License.\n\n 8. Limitation of Liability. In no event and under no legal theory,\n whether in tort (including negligence), contract, or otherwise,\n unless required by applicable law (such as deliberate and grossly\n negligent acts) or agreed to in writing, shall any Contributor be\n liable to You for damages, including any direct, indirect, special,\n incidental, or consequential damages of any character arising as a\n result of this License or out of the use or inability to use the\n Work (including but not limited to damages for loss of goodwill,\n work stoppage, computer failure or malfunction, or any and all\n other commercial damages or losses), even if such Contributor\n has been advised of the possibility of such damages.\n\n 9. Accepting Warranty or Additional Liability. While redistributing\n the Work or Derivative Works thereof, You may choose to offer,\n and charge a fee for, acceptance of support, warranty, indemnity,\n or other liability obligations and/or rights consistent with this\n License. However, in accepting such obligations, You may act only\n on Your own behalf and on Your sole responsibility, not on behalf\n of any other Contributor, and only if You agree to indemnify,\n defend, and hold each Contributor harmless for any liability\n incurred by, or claims asserted against, such Contributor by reason\n of your accepting any such warranty or additional liability.\n\n----------------------------------------------------------------------\nLicense notice for github.com/xdg-go/scram\n----------------------------------------------------------------------\n\n\n Apache License\n Version 2.0, January 2004\n http://www.apache.org/licenses/\n\n TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n 1. Definitions.\n\n \"License\" shall mean the terms and conditions for use, reproduction,\n and distribution as defined by Sections 1 through 9 of this document.\n\n \"Licensor\" shall mean the copyright owner or entity authorized by\n the copyright owner that is granting the License.\n\n \"Legal Entity\" shall mean the union of the acting entity and all\n other entities that control, are controlled by, or are under common\n control with that entity. For the purposes of this definition,\n \"control\" means (i) the power, direct or indirect, to cause the\n direction or management of such entity, whether by contract or\n otherwise, or (ii) ownership of fifty percent (50%) or more of the\n outstanding shares, or (iii) beneficial ownership of such entity.\n\n \"You\" (or \"Your\") shall mean an individual or Legal Entity\n exercising permissions granted by this License.\n\n \"Source\" form shall mean the preferred form for making modifications,\n including but not limited to software source code, documentation\n source, and configuration files.\n\n \"Object\" form shall mean any form resulting from mechanical\n transformation or translation of a Source form, including but\n not limited to compiled object code, generated documentation,\n and conversions to other media types.\n\n \"Work\" shall mean the work of authorship, whether in Source or\n Object form, made available under the License, as indicated by a\n copyright notice that is included in or attached to the work\n (an example is provided in the Appendix below).\n\n \"Derivative Works\" shall mean any work, whether in Source or Object\n form, that is based on (or derived from) the Work and for which the\n editorial revisions, annotations, elaborations, or other modifications\n represent, as a whole, an original work of authorship. For the purposes\n of this License, Derivative Works shall not include works that remain\n separable from, or merely link (or bind by name) to the interfaces of,\n the Work and Derivative Works thereof.\n\n \"Contribution\" shall mean any work of authorship, including\n the original version of the Work and any modifications or additions\n to that Work or Derivative Works thereof, that is intentionally\n submitted to Licensor for inclusion in the Work by the copyright owner\n or by an individual or Legal Entity authorized to submit on behalf of\n the copyright owner. For the purposes of this definition, \"submitted\"\n means any form of electronic, verbal, or written communication sent\n to the Licensor or its representatives, including but not limited to\n communication on electronic mailing lists, source code control systems,\n and issue tracking systems that are managed by, or on behalf of, the\n Licensor for the purpose of discussing and improving the Work, but\n excluding communication that is conspicuously marked or otherwise\n designated in writing by the copyright owner as \"Not a Contribution.\"\n\n \"Contributor\" shall mean Licensor and any individual or Legal Entity\n on behalf of whom a Contribution has been received by Licensor and\n subsequently incorporated within the Work.\n\n 2. Grant of Copyright License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n copyright license to reproduce, prepare Derivative Works of,\n publicly display, publicly perform, sublicense, and distribute the\n Work and such Derivative Works in Source or Object form.\n\n 3. Grant of Patent License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n (except as stated in this section) patent license to make, have made,\n use, offer to sell, sell, import, and otherwise transfer the Work,\n where such license applies only to those patent claims licensable\n by such Contributor that are necessarily infringed by their\n Contribution(s) alone or by combination of their Contribution(s)\n with the Work to which such Contribution(s) was submitted. If You\n institute patent litigation against any entity (including a\n cross-claim or counterclaim in a lawsuit) alleging that the Work\n or a Contribution incorporated within the Work constitutes direct\n or contributory patent infringement, then any patent licenses\n granted to You under this License for that Work shall terminate\n as of the date such litigation is filed.\n\n 4. Redistribution. You may reproduce and distribute copies of the\n Work or Derivative Works thereof in any medium, with or without\n modifications, and in Source or Object form, provided that You\n meet the following conditions:\n\n (a) You must give any other recipients of the Work or\n Derivative Works a copy of this License; and\n\n (b) You must cause any modified files to carry prominent notices\n stating that You changed the files; and\n\n (c) You must retain, in the Source form of any Derivative Works\n that You distribute, all copyright, patent, trademark, and\n attribution notices from the Source form of the Work,\n excluding those notices that do not pertain to any part of\n the Derivative Works; and\n\n (d) If the Work includes a \"NOTICE\" text file as part of its\n distribution, then any Derivative Works that You distribute must\n include a readable copy of the attribution notices contained\n within such NOTICE file, excluding those notices that do not\n pertain to any part of the Derivative Works, in at least one\n of the following places: within a NOTICE text file distributed\n as part of the Derivative Works; within the Source form or\n documentation, if provided along with the Derivative Works; or,\n within a display generated by the Derivative Works, if and\n wherever such third-party notices normally appear. The contents\n of the NOTICE file are for informational purposes only and\n do not modify the License. You may add Your own attribution\n notices within Derivative Works that You distribute, alongside\n or as an addendum to the NOTICE text from the Work, provided\n that such additional attribution notices cannot be construed\n as modifying the License.\n\n You may add Your own copyright statement to Your modifications and\n may provide additional or different license terms and conditions\n for use, reproduction, or distribution of Your modifications, or\n for any such Derivative Works as a whole, provided Your use,\n reproduction, and distribution of the Work otherwise complies with\n the conditions stated in this License.\n\n 5. Submission of Contributions. Unless You explicitly state otherwise,\n any Contribution intentionally submitted for inclusion in the Work\n by You to the Licensor shall be under the terms and conditions of\n this License, without any additional terms or conditions.\n Notwithstanding the above, nothing herein shall supersede or modify\n the terms of any separate license agreement you may have executed\n with Licensor regarding such Contributions.\n\n 6. Trademarks. This License does not grant permission to use the trade\n names, trademarks, service marks, or product names of the Licensor,\n except as required for reasonable and customary use in describing the\n origin of the Work and reproducing the content of the NOTICE file.\n\n 7. Disclaimer of Warranty. Unless required by applicable law or\n agreed to in writing, Licensor provides the Work (and each\n Contributor provides its Contributions) on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n implied, including, without limitation, any warranties or conditions\n of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n PARTICULAR PURPOSE. You are solely responsible for determining the\n appropriateness of using or redistributing the Work and assume any\n risks associated with Your exercise of permissions under this License.\n\n 8. Limitation of Liability. In no event and under no legal theory,\n whether in tort (including negligence), contract, or otherwise,\n unless required by applicable law (such as deliberate and grossly\n negligent acts) or agreed to in writing, shall any Contributor be\n liable to You for damages, including any direct, indirect, special,\n incidental, or consequential damages of any character arising as a\n result of this License or out of the use or inability to use the\n Work (including but not limited to damages for loss of goodwill,\n work stoppage, computer failure or malfunction, or any and all\n other commercial damages or losses), even if such Contributor\n has been advised of the possibility of such damages.\n\n 9. Accepting Warranty or Additional Liability. While redistributing\n the Work or Derivative Works thereof, You may choose to offer,\n and charge a fee for, acceptance of support, warranty, indemnity,\n or other liability obligations and/or rights consistent with this\n License. However, in accepting such obligations, You may act only\n on Your own behalf and on Your sole responsibility, not on behalf\n of any other Contributor, and only if You agree to indemnify,\n defend, and hold each Contributor harmless for any liability\n incurred by, or claims asserted against, such Contributor by reason\n of your accepting any such warranty or additional liability.\n\n----------------------------------------------------------------------\nLicense notice for github.com/xdg-go/stringprep\n----------------------------------------------------------------------\n\n\n Apache License\n Version 2.0, January 2004\n http://www.apache.org/licenses/\n\n TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n 1. Definitions.\n\n \"License\" shall mean the terms and conditions for use, reproduction,\n and distribution as defined by Sections 1 through 9 of this document.\n\n \"Licensor\" shall mean the copyright owner or entity authorized by\n the copyright owner that is granting the License.\n\n \"Legal Entity\" shall mean the union of the acting entity and all\n other entities that control, are controlled by, or are under common\n control with that entity. For the purposes of this definition,\n \"control\" means (i) the power, direct or indirect, to cause the\n direction or management of such entity, whether by contract or\n otherwise, or (ii) ownership of fifty percent (50%) or more of the\n outstanding shares, or (iii) beneficial ownership of such entity.\n\n \"You\" (or \"Your\") shall mean an individual or Legal Entity\n exercising permissions granted by this License.\n\n \"Source\" form shall mean the preferred form for making modifications,\n including but not limited to software source code, documentation\n source, and configuration files.\n\n \"Object\" form shall mean any form resulting from mechanical\n transformation or translation of a Source form, including but\n not limited to compiled object code, generated documentation,\n and conversions to other media types.\n\n \"Work\" shall mean the work of authorship, whether in Source or\n Object form, made available under the License, as indicated by a\n copyright notice that is included in or attached to the work\n (an example is provided in the Appendix below).\n\n \"Derivative Works\" shall mean any work, whether in Source or Object\n form, that is based on (or derived from) the Work and for which the\n editorial revisions, annotations, elaborations, or other modifications\n represent, as a whole, an original work of authorship. For the purposes\n of this License, Derivative Works shall not include works that remain\n separable from, or merely link (or bind by name) to the interfaces of,\n the Work and Derivative Works thereof.\n\n \"Contribution\" shall mean any work of authorship, including\n the original version of the Work and any modifications or additions\n to that Work or Derivative Works thereof, that is intentionally\n submitted to Licensor for inclusion in the Work by the copyright owner\n or by an individual or Legal Entity authorized to submit on behalf of\n the copyright owner. For the purposes of this definition, \"submitted\"\n means any form of electronic, verbal, or written communication sent\n to the Licensor or its representatives, including but not limited to\n communication on electronic mailing lists, source code control systems,\n and issue tracking systems that are managed by, or on behalf of, the\n Licensor for the purpose of discussing and improving the Work, but\n excluding communication that is conspicuously marked or otherwise\n designated in writing by the copyright owner as \"Not a Contribution.\"\n\n \"Contributor\" shall mean Licensor and any individual or Legal Entity\n on behalf of whom a Contribution has been received by Licensor and\n subsequently incorporated within the Work.\n\n 2. Grant of Copyright License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n copyright license to reproduce, prepare Derivative Works of,\n publicly display, publicly perform, sublicense, and distribute the\n Work and such Derivative Works in Source or Object form.\n\n 3. Grant of Patent License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n (except as stated in this section) patent license to make, have made,\n use, offer to sell, sell, import, and otherwise transfer the Work,\n where such license applies only to those patent claims licensable\n by such Contributor that are necessarily infringed by their\n Contribution(s) alone or by combination of their Contribution(s)\n with the Work to which such Contribution(s) was submitted. If You\n institute patent litigation against any entity (including a\n cross-claim or counterclaim in a lawsuit) alleging that the Work\n or a Contribution incorporated within the Work constitutes direct\n or contributory patent infringement, then any patent licenses\n granted to You under this License for that Work shall terminate\n as of the date such litigation is filed.\n\n 4. Redistribution. You may reproduce and distribute copies of the\n Work or Derivative Works thereof in any medium, with or without\n modifications, and in Source or Object form, provided that You\n meet the following conditions:\n\n (a) You must give any other recipients of the Work or\n Derivative Works a copy of this License; and\n\n (b) You must cause any modified files to carry prominent notices\n stating that You changed the files; and\n\n (c) You must retain, in the Source form of any Derivative Works\n that You distribute, all copyright, patent, trademark, and\n attribution notices from the Source form of the Work,\n excluding those notices that do not pertain to any part of\n the Derivative Works; and\n\n (d) If the Work includes a \"NOTICE\" text file as part of its\n distribution, then any Derivative Works that You distribute must\n include a readable copy of the attribution notices contained\n within such NOTICE file, excluding those notices that do not\n pertain to any part of the Derivative Works, in at least one\n of the following places: within a NOTICE text file distributed\n as part of the Derivative Works; within the Source form or\n documentation, if provided along with the Derivative Works; or,\n within a display generated by the Derivative Works, if and\n wherever such third-party notices normally appear. The contents\n of the NOTICE file are for informational purposes only and\n do not modify the License. You may add Your own attribution\n notices within Derivative Works that You distribute, alongside\n or as an addendum to the NOTICE text from the Work, provided\n that such additional attribution notices cannot be construed\n as modifying the License.\n\n You may add Your own copyright statement to Your modifications and\n may provide additional or different license terms and conditions\n for use, reproduction, or distribution of Your modifications, or\n for any such Derivative Works as a whole, provided Your use,\n reproduction, and distribution of the Work otherwise complies with\n the conditions stated in this License.\n\n 5. Submission of Contributions. Unless You explicitly state otherwise,\n any Contribution intentionally submitted for inclusion in the Work\n by You to the Licensor shall be under the terms and conditions of\n this License, without any additional terms or conditions.\n Notwithstanding the above, nothing herein shall supersede or modify\n the terms of any separate license agreement you may have executed\n with Licensor regarding such Contributions.\n\n 6. Trademarks. This License does not grant permission to use the trade\n names, trademarks, service marks, or product names of the Licensor,\n except as required for reasonable and customary use in describing the\n origin of the Work and reproducing the content of the NOTICE file.\n\n 7. Disclaimer of Warranty. Unless required by applicable law or\n agreed to in writing, Licensor provides the Work (and each\n Contributor provides its Contributions) on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n implied, including, without limitation, any warranties or conditions\n of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n PARTICULAR PURPOSE. You are solely responsible for determining the\n appropriateness of using or redistributing the Work and assume any\n risks associated with Your exercise of permissions under this License.\n\n 8. Limitation of Liability. In no event and under no legal theory,\n whether in tort (including negligence), contract, or otherwise,\n unless required by applicable law (such as deliberate and grossly\n negligent acts) or agreed to in writing, shall any Contributor be\n liable to You for damages, including any direct, indirect, special,\n incidental, or consequential damages of any character arising as a\n result of this License or out of the use or inability to use the\n Work (including but not limited to damages for loss of goodwill,\n work stoppage, computer failure or malfunction, or any and all\n other commercial damages or losses), even if such Contributor\n has been advised of the possibility of such damages.\n\n 9. Accepting Warranty or Additional Liability. While redistributing\n the Work or Derivative Works thereof, You may choose to offer,\n and charge a fee for, acceptance of support, warranty, indemnity,\n or other liability obligations and/or rights consistent with this\n License. However, in accepting such obligations, You may act only\n on Your own behalf and on Your sole responsibility, not on behalf\n of any other Contributor, and only if You agree to indemnify,\n defend, and hold each Contributor harmless for any liability\n incurred by, or claims asserted against, such Contributor by reason\n of your accepting any such warranty or additional liability.\n\n----------------------------------------------------------------------\nLicense notice for github.com/youmark/pkcs8\n----------------------------------------------------------------------\n\nThe MIT License (MIT)\n\nCopyright (c) 2014 youmark\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n----------------------------------------------------------------------\nLicense notice for golang.org/x/crypto\n----------------------------------------------------------------------\n\nCopyright (c) 2009 The Go Authors. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n * Redistributions of source code must retain the above copyright\nnotice, this list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above\ncopyright notice, this list of conditions and the following disclaimer\nin the documentation and/or other materials provided with the\ndistribution.\n * Neither the name of Google Inc. nor the names of its\ncontributors may be used to endorse or promote products derived from\nthis software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\nOWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\nLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\nDATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\nTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n----------------------------------------------------------------------\nLicense notice for golang.org/x/sync\n----------------------------------------------------------------------\n\nCopyright (c) 2009 The Go Authors. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n * Redistributions of source code must retain the above copyright\nnotice, this list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above\ncopyright notice, this list of conditions and the following disclaimer\nin the documentation and/or other materials provided with the\ndistribution.\n * Neither the name of Google Inc. nor the names of its\ncontributors may be used to endorse or promote products derived from\nthis software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\nOWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\nLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\nDATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\nTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n----------------------------------------------------------------------\nLicense notice for golang.org/x/sys\n----------------------------------------------------------------------\n\nCopyright (c) 2009 The Go Authors. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n * Redistributions of source code must retain the above copyright\nnotice, this list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above\ncopyright notice, this list of conditions and the following disclaimer\nin the documentation and/or other materials provided with the\ndistribution.\n * Neither the name of Google Inc. nor the names of its\ncontributors may be used to endorse or promote products derived from\nthis software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\nOWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\nLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\nDATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\nTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n----------------------------------------------------------------------\nLicense notice for golang.org/x/text\n----------------------------------------------------------------------\n\nCopyright (c) 2009 The Go Authors. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n * Redistributions of source code must retain the above copyright\nnotice, this list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above\ncopyright notice, this list of conditions and the following disclaimer\nin the documentation and/or other materials provided with the\ndistribution.\n * Neither the name of Google Inc. nor the names of its\ncontributors may be used to endorse or promote products derived from\nthis software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\nOWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\nLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\nDATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\nTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n----------------------------------------------------------------------\nLicense notice for golang.org/x/tools\n----------------------------------------------------------------------\n\nCopyright (c) 2009 The Go Authors. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n * Redistributions of source code must retain the above copyright\nnotice, this list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above\ncopyright notice, this list of conditions and the following disclaimer\nin the documentation and/or other materials provided with the\ndistribution.\n * Neither the name of Google Inc. nor the names of its\ncontributors may be used to endorse or promote products derived from\nthis software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\nOWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\nLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\nDATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\nTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n----------------------------------------------------------------------\nLicense notice for golang.org/x/xerrors\n----------------------------------------------------------------------\n\nCopyright (c) 2019 The Go Authors. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n * Redistributions of source code must retain the above copyright\nnotice, this list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above\ncopyright notice, this list of conditions and the following disclaimer\nin the documentation and/or other materials provided with the\ndistribution.\n * Neither the name of Google Inc. nor the names of its\ncontributors may be used to endorse or promote products derived from\nthis software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\nOWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\nLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\nDATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\nTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n----------------------------------------------------------------------\nLicense notice for gopkg.in/yaml.v3\n----------------------------------------------------------------------\n\n\nThis project is covered by two different licenses: MIT and Apache.\n\n#### MIT License ####\n\nThe following files were ported to Go from C files of libyaml, and thus\nare still covered by their original MIT license, with the additional\ncopyright staring in 2011 when the project was ported over:\n\n apic.go emitterc.go parserc.go readerc.go scannerc.go\n writerc.go yamlh.go yamlprivateh.go\n\nCopyright (c) 2006-2010 Kirill Simonov\nCopyright (c) 2006-2011 Kirill Simonov\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of\nthis software and associated documentation files (the \"Software\"), to deal in\nthe Software without restriction, including without limitation the rights to\nuse, copy, modify, merge, publish, distribute, sublicense, and/or sell copies\nof the Software, and to permit persons to whom the Software is furnished to do\nso, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n### Apache License ###\n\nAll the remaining project files are covered by the Apache license:\n\nCopyright (c) 2011-2019 Canonical Ltd\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n" }, { "path": "Taskfile.yml", "content": "# See https://taskfile.dev/usage/\nversion: \"3\"\nenv:\n TEST_TIMEOUT: 1800\n LONG_TEST_TIMEOUT: 3600\ndotenv: [\".test.env\"]\ntasks:\n ### Utility tasks. ###\n default:\n deps: [build, check-license, check-fmt, check-modules, lint, test-short]\n add-license: bash etc/check_license.sh -a\n check-license: bash etc/check_license.sh\n init-submodule: git submodule update --init\n build:\n deps: [install-libmongocrypt]\n cmds:\n - go build ./...\n - go build ${BUILD_TAGS} ./...\n - task: build-tests\n - task: compilecheck-119\n build-tests: go test -short ${BUILD_TAGS} -run ^$$ ./...\n compilecheck-119:\n dir: internal/test/compilecheck\n cmds:\n - go mod download\n - GOTOOLCHAIN=auto go test -v -run '^TestCompileCheck/go:1\\.19$'\n build-compile-check-all: bash etc/run-compile-check-test.sh\n build-aws-ecs-test: go test -c ./internal/test/aws -o aws.testbin\n check-fmt:\n deps: [install-lll, install-gofumpt]\n cmds:\n - bash etc/check_fmt.sh\n check-modules: bash etc/check_modules.sh\n doc: godoc -http=:6060 -index\n fmt:\n deps: [install-gofumpt]\n cmds:\n - gofumpt -w .\n api-report: bash etc/api_report.sh\n install-libmongocrypt:\n cmds: [bash etc/install-libmongocrypt.sh]\n status:\n - test -d install || test -d /cygdrive/c/libmongocrypt/bin\n run-docker: bash etc/run_docker.sh\n run-fuzz: bash etc/run-fuzz.sh\n cherry-picker: bash etc/cherry-picker.sh\n pr-task: bash etc/pr-task.sh\n perf-pr-comment: bash etc/perf-pr-comment.sh\n # Lint with various GOOS and GOARCH tasks to catch static analysis failures that may only affect\n # specific operating systems or architectures. For example, staticcheck will only check for 64-bit\n # alignment of atomically accessed variables on 32-bit architectures (see\n # https://staticcheck.io/docs/checks#SA1027)\n lint:\n cmds:\n - GOOS=linux GOARCH=386 etc/golangci-lint.sh\n - GOOS=linux GOARCH=arm etc/golangci-lint.sh\n - GOOS=linux GOARCH=arm64 etc/golangci-lint.sh\n - GOOS=linux GOARCH=amd64 etc/golangci-lint.sh\n - GOOS=linux GOARCH=ppc64le etc/golangci-lint.sh\n - GOOS=linux GOARCH=s390x etc/golangci-lint.sh\n govulncheck: bash etc/govulncheck.sh\n update-notices: bash etc/generate_notices.pl > THIRD-PARTY-NOTICES\n ### Local testing tasks. ###\n test: go test ${BUILD_TAGS} -timeout {{.TEST_TIMEOUT}}s -p 1 ./...\n test-cover:\n - go test ${BUILD_TAGS} -timeout {{.TEST_TIMEOUT}}s -cover ${COVER_ARGS} -p 1 ./...\n test-race:\n - go test ${BUILD_TAGS} -timeout {{.TEST_TIMEOUT}}s -race -p 1 ./...\n test-short: go test ${BUILD_TAGS} -timeout 60s -short -race ./...\n test-oidc: bash etc/run-oidc-test.sh\n test-oidc-remote: bash etc/run-oidc-remote-test.sh\n test-atlas-connect:\n - go test -v -run ^TestAtlas$ go.mongodb.org/mongo-driver/v2/internal/cmd/testatlas -tags atlastest >> test.suite\n test-awskms: bash etc/run-awskms-test.sh\n test-azurekms: bash etc/run-azurekms-test.sh\n test-gcpkms: bash etc/run-gcpkms-test.sh\n test-goleak: bash etc/run-goleak-test.sh\n ### Local FaaS tasks. ###\n build-faas-awslambda:\n requires:\n vars: [MONGODB_URI]\n cmds:\n - make -c internal/cmd/faas/awslambda\n ### Evergreen specific tasks. ###\n setup-test: bash etc/setup-test.sh\n setup-encryption: bash etc/setup-encryption.sh\n evg-test:\n - go test -exec \"env PKG_CONFIG_PATH=${PKG_CONFIG_PATH} LD_LIBRARY_PATH=${LD_LIBRARY_PATH} DYLD_LIBRARY_PATH=$MACOS_LIBRARY_PATH}\" ${BUILD_TAGS} -v -timeout {{.TEST_TIMEOUT}}s -p 1 ./... >> test.suite\n evg-test-enterprise-auth:\n - go run -tags gssapi ./internal/cmd/testentauth/main.go\n evg-test-oidc-auth:\n - go test -v ./internal/test/oidcauth/... >> test.suite\n - go test -v -race ./internal/test/oidcauth/... >> test.suite\n evg-test-kmip:\n - go test -exec \"env PKG_CONFIG_PATH=${PKG_CONFIG_PATH} LD_LIBRARY_PATH=${LD_LIBRARY_PATH} DYLD_LIBRARY_PATH=${MACOS_LIBRARY_PATH}\" ${BUILD_TAGS} -v -timeout {{.TEST_TIMEOUT}}s ./internal/integration -run TestClientSideEncryptionSpec/kmipKMS >> test.suite\n evg-test-client-side-encryption:\n - go test -exec \"env PKG_CONFIG_PATH=${PKG_CONFIG_PATH} LD_LIBRARY_PATH=${LD_LIBRARY_PATH} DYLD_LIBRARY_PATH=${MACOS_LIBRARY_PATH}\" ${BUILD_TAGS} -v -timeout {{.TEST_TIMEOUT}}s ./internal/integration -run TestClientSideEncryptionProse >> test.suite\n evg-test-load-balancers:\n # Load balancer should be tested with all unified tests as well as tests in the following\n # components: retryable reads, retryable writes, change streams, initial DNS seedlist discovery.\n - go test ${BUILD_TAGS} ./internal/integration -run TestInitialDNSSeedlistDiscoverySpec/load_balanced -v -timeout {{.TEST_TIMEOUT}}s >> test.suite\n - go test ${BUILD_TAGS} ./internal/integration -run TestLoadBalancerSupport -v -timeout {{.TEST_TIMEOUT}}s >> test.suite\n - go test ${BUILD_TAGS} ./internal/integration -run TestLoadBalancedConnectionHandshake -v -timeout {{.TEST_TIMEOUT}}s >> test.suite\n - go test ${BUILD_TAGS} ./internal/integration/unified -run TestUnifiedSpec -v -timeout {{.TEST_TIMEOUT}}s >> test.suite\n evg-test-search-index:\n # Use the long timeout to wait for the responses from the server.\n - go test ./internal/integration -run TestSearchIndexProse -v -timeout {{.LONG_TEST_TIMEOUT}}s >> test.suite\n evg-test-ocsp:\n - go test -v ./mongo -run TestOCSP ${OCSP_TLS_SHOULD_SUCCEED} >> test.suite\n evg-test-versioned-api:\n # Versioned API related tests are in the mongo, integration and unified packages.\n - go test -exec \"env PKG_CONFIG_PATH=${PKG_CONFIG_PATH} LD_LIBRARY_PATH=${LD_LIBRARY_PATH} DYLD_LIBRARY_PATH=${MACOS_LIBRARY_PATH}\" ${BUILD_TAGS} -v -timeout {{.TEST_TIMEOUT}}s ./mongo >> test.suite\n - go test -exec \"env PKG_CONFIG_PATH=${PKG_CONFIG_PATH} LD_LIBRARY_PATH=${LD_LIBRARY_PATH} DYLD_LIBRARY_PATH=${MACOS_LIBRARY_PATH}\" ${BUILD_TAGS} -v -timeout {{.TEST_TIMEOUT}}s ./internal/integration >> test.suite\n - go test -exec \"env PKG_CONFIG_PATH=${PKG_CONFIG_PATH} LD_LIBRARY_PATH=${LD_LIBRARY_PATH} DYLD_LIBRARY_PATH=${MACOS_LIBRARY_PATH}\" ${BUILD_TAGS} -v -timeout {{.TEST_TIMEOUT}}s ./internal/integration/unified >> test.suite\n evg-test-aws: bash etc/run-mongodb-aws-test.sh\n evg-test-aws-ecs: bash etc/run-mongodb-aws-ecs-test.sh\n evg-test-deployed-lambda-aws: bash ${DRIVERS_TOOLS}/.evergreen/aws_lambda/run-deployed-lambda-aws-tests.sh\n evg-gather-test-suites: find . -name \\*.suite | xargs --no-run-if-empty tar czf test_suite.tgz\n build-kms-test: go build ${BUILD_TAGS} ./internal/cmd/testkms\n ### Benchmark specific tasks and support. ###\n benchmark:\n deps: [perf-files]\n cmds:\n - go test ${BUILD_TAGS} -benchmem -bench=. ./benchmark | test benchmark.suite\n driver-benchmark:\n cmds:\n - go test ./internal/cmd/benchmark -v --fullRun | tee perf.suite\n ### Internal tasks. ###\n install-gofumpt:\n internal: true\n cmds:\n - go install mvdan.cc/gofumpt@v0.9.2\n status:\n - command -v gofumpt\n install-lll:\n internal: true\n cmds:\n - go install github.com/walle/lll/...@latest\n" }, { "path": "bson/array_codec.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"fmt\"\n\t\"reflect\"\n\n\t\"go.mongodb.org/mongo-driver/v2/x/bsonx/bsoncore\"\n)\n\n// arrayCodec is the Codec used for bsoncore.Array values.\ntype arrayCodec struct{}\n\n// EncodeValue is the ValueEncoder for bsoncore.Array values.\nfunc (ac *arrayCodec) EncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tCoreArray {\n\t\treturn ValueEncoderError{Name: \"CoreArrayEncodeValue\", Types: []reflect.Type{tCoreArray}, Received: val}\n\t}\n\n\tarr := val.Interface().(bsoncore.Array)\n\treturn copyArrayFromBytes(vw, arr)\n}\n\n// DecodeValue is the ValueDecoder for bsoncore.Array values.\nfunc (ac *arrayCodec) DecodeValue(_ DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tCoreArray {\n\t\treturn ValueDecoderError{Name: \"CoreArrayDecodeValue\", Types: []reflect.Type{tCoreArray}, Received: val}\n\t}\n\tif vrType := vr.Type(); vrType != TypeArray {\n\t\treturn fmt.Errorf(\"cannot decode %v into a %s\", vrType, val.Type())\n\t}\n\n\tif val.IsNil() {\n\t\tval.Set(reflect.MakeSlice(val.Type(), 0, 0))\n\t}\n\n\tval.SetLen(0)\n\tarr, err := appendArrayBytes(val.Interface().(bsoncore.Array), vr)\n\tval.Set(reflect.ValueOf(arr))\n\treturn err\n}\n" }, { "path": "bson/benchmark_test.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"bytes\"\n\t\"compress/gzip\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"io\"\n\t\"io/ioutil\"\n\t\"os\"\n\t\"path\"\n\t\"sync\"\n\t\"testing\"\n)\n\nvar encodetestBsonD D\n\nfunc init() {\n\tb, err := Marshal(encodetestInstance)\n\tif err != nil {\n\t\tpanic(fmt.Sprintf(\"error marshling struct: %v\", err))\n\t}\n\n\terr = Unmarshal(b, &encodetestBsonD)\n\tif err != nil {\n\t\tpanic(fmt.Sprintf(\"error unmarshaling BSON: %v\", err))\n\t}\n}\n\ntype encodetest struct {\n\tField1String string\n\tField1Int64 int64\n\tField1Float64 float64\n\tField2String string\n\tField2Int64 int64\n\tField2Float64 float64\n\tField3String string\n\tField3Int64 int64\n\tField3Float64 float64\n\tField4String string\n\tField4Int64 int64\n\tField4Float64 float64\n}\n\ntype nestedtest1 struct {\n\tNested nestedtest2\n}\n\ntype nestedtest2 struct {\n\tNested nestedtest3\n}\n\ntype nestedtest3 struct {\n\tNested nestedtest4\n}\n\ntype nestedtest4 struct {\n\tNested nestedtest5\n}\n\ntype nestedtest5 struct {\n\tNested nestedtest6\n}\n\ntype nestedtest6 struct {\n\tNested nestedtest7\n}\n\ntype nestedtest7 struct {\n\tNested nestedtest8\n}\n\ntype nestedtest8 struct {\n\tNested nestedtest9\n}\n\ntype nestedtest9 struct {\n\tNested nestedtest10\n}\n\ntype nestedtest10 struct {\n\tNested nestedtest11\n}\n\ntype nestedtest11 struct {\n\tNested encodetest\n}\n\nvar encodetestInstance = encodetest{\n\tField1String: \"foo\",\n\tField1Int64: 1,\n\tField1Float64: 3.0,\n\tField2String: \"bar\",\n\tField2Int64: 2,\n\tField2Float64: 3.1,\n\tField3String: \"baz\",\n\tField3Int64: 3,\n\tField3Float64: 3.14,\n\tField4String: \"qux\",\n\tField4Int64: 4,\n\tField4Float64: 3.141,\n}\n\nvar nestedInstance = nestedtest1{\n\tnestedtest2{\n\t\tnestedtest3{\n\t\t\tnestedtest4{\n\t\t\t\tnestedtest5{\n\t\t\t\t\tnestedtest6{\n\t\t\t\t\t\tnestedtest7{\n\t\t\t\t\t\t\tnestedtest8{\n\t\t\t\t\t\t\t\tnestedtest9{\n\t\t\t\t\t\t\t\t\tnestedtest10{\n\t\t\t\t\t\t\t\t\t\tnestedtest11{\n\t\t\t\t\t\t\t\t\t\t\tencodetest{\n\t\t\t\t\t\t\t\t\t\t\t\tField1String: \"foo\",\n\t\t\t\t\t\t\t\t\t\t\t\tField1Int64: 1,\n\t\t\t\t\t\t\t\t\t\t\t\tField1Float64: 3.0,\n\t\t\t\t\t\t\t\t\t\t\t\tField2String: \"bar\",\n\t\t\t\t\t\t\t\t\t\t\t\tField2Int64: 2,\n\t\t\t\t\t\t\t\t\t\t\t\tField2Float64: 3.1,\n\t\t\t\t\t\t\t\t\t\t\t\tField3String: \"baz\",\n\t\t\t\t\t\t\t\t\t\t\t\tField3Int64: 3,\n\t\t\t\t\t\t\t\t\t\t\t\tField3Float64: 3.14,\n\t\t\t\t\t\t\t\t\t\t\t\tField4String: \"qux\",\n\t\t\t\t\t\t\t\t\t\t\t\tField4Int64: 4,\n\t\t\t\t\t\t\t\t\t\t\t\tField4Float64: 3.141,\n\t\t\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t},\n}\n\nconst extendedBSONDir = \"../testdata/extended_bson\"\n\nvar (\n\textJSONFiles map[string]map[string]any\n\textJSONFilesMu sync.Mutex\n)\n\n// readExtJSONFile reads the GZIP-compressed extended JSON document from the given filename in the\n// \"extended BSON\" test data directory (../testdata/extended_bson) and returns it as a\n// map[string]any. It panics on any errors.\nfunc readExtJSONFile(filename string) map[string]any {\n\textJSONFilesMu.Lock()\n\tdefer extJSONFilesMu.Unlock()\n\tif v, ok := extJSONFiles[filename]; ok {\n\t\treturn v\n\t}\n\tfilePath := path.Join(extendedBSONDir, filename)\n\tfile, err := os.Open(filePath)\n\tif err != nil {\n\t\tpanic(fmt.Sprintf(\"error opening file %q: %s\", filePath, err))\n\t}\n\tdefer func() {\n\t\t_ = file.Close()\n\t}()\n\n\tgz, err := gzip.NewReader(file)\n\tif err != nil {\n\t\tpanic(fmt.Sprintf(\"error creating GZIP reader: %s\", err))\n\t}\n\tdefer func() {\n\t\t_ = gz.Close()\n\t}()\n\n\tdata, err := ioutil.ReadAll(gz)\n\tif err != nil {\n\t\tpanic(fmt.Sprintf(\"error reading GZIP contents of file: %s\", err))\n\t}\n\n\tvar v map[string]any\n\terr = UnmarshalExtJSON(data, false, &v)\n\tif err != nil {\n\t\tpanic(fmt.Sprintf(\"error unmarshalling extended JSON: %s\", err))\n\t}\n\n\tif extJSONFiles == nil {\n\t\textJSONFiles = make(map[string]map[string]any)\n\t}\n\textJSONFiles[filename] = v\n\treturn v\n}\n\nfunc BenchmarkMarshal(b *testing.B) {\n\tcases := []struct {\n\t\tdesc string\n\t\tvalue any\n\t}{\n\t\t{\n\t\t\tdesc: \"simple struct\",\n\t\t\tvalue: encodetestInstance,\n\t\t},\n\t\t{\n\t\t\tdesc: \"nested struct\",\n\t\t\tvalue: nestedInstance,\n\t\t},\n\t\t{\n\t\t\tdesc: \"simple D\",\n\t\t\tvalue: encodetestBsonD,\n\t\t},\n\t\t{\n\t\t\tdesc: \"deep_bson.json.gz\",\n\t\t\tvalue: readExtJSONFile(\"deep_bson.json.gz\"),\n\t\t},\n\t\t{\n\t\t\tdesc: \"flat_bson.json.gz\",\n\t\t\tvalue: readExtJSONFile(\"flat_bson.json.gz\"),\n\t\t},\n\t\t{\n\t\t\tdesc: \"full_bson.json.gz\",\n\t\t\tvalue: readExtJSONFile(\"full_bson.json.gz\"),\n\t\t},\n\t}\n\n\tb.Run(\"BSON\", func(b *testing.B) {\n\t\tfor _, tc := range cases {\n\t\t\ttc := tc // Capture range variable.\n\n\t\t\tb.Run(tc.desc, func(b *testing.B) {\n\t\t\t\tb.ReportAllocs()\n\t\t\t\tb.RunParallel(func(pb *testing.PB) {\n\t\t\t\t\tfor pb.Next() {\n\t\t\t\t\t\t_, err := Marshal(tc.value)\n\t\t\t\t\t\tif err != nil {\n\t\t\t\t\t\t\tb.Errorf(\"error marshalling BSON: %s\", err)\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t})\n\t\t}\n\t})\n\n\tb.Run(\"extJSON\", func(b *testing.B) {\n\t\tfor _, tc := range cases {\n\t\t\ttc := tc // Capture range variable.\n\n\t\t\tb.Run(tc.desc, func(b *testing.B) {\n\t\t\t\tb.ReportAllocs()\n\t\t\t\tb.RunParallel(func(pb *testing.PB) {\n\t\t\t\t\tfor pb.Next() {\n\t\t\t\t\t\t_, err := MarshalExtJSON(tc.value, true, false)\n\t\t\t\t\t\tif err != nil {\n\t\t\t\t\t\t\tb.Errorf(\"error marshalling extended JSON: %s\", err)\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t})\n\t\t}\n\t})\n\n\tb.Run(\"JSON\", func(b *testing.B) {\n\t\tfor _, tc := range cases {\n\t\t\ttc := tc // Capture range variable.\n\n\t\t\tb.Run(tc.desc, func(b *testing.B) {\n\t\t\t\tb.ReportAllocs()\n\t\t\t\tb.RunParallel(func(pb *testing.PB) {\n\t\t\t\t\tfor pb.Next() {\n\t\t\t\t\t\t_, err := json.Marshal(tc.value)\n\t\t\t\t\t\tif err != nil {\n\t\t\t\t\t\t\tb.Errorf(\"error marshalling JSON: %s\", err)\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t})\n\t\t}\n\t})\n}\n\nfunc BenchmarkUnmarshal(b *testing.B) {\n\ttype testcase struct {\n\t\tdesc string\n\t\tvalue any\n\t\tdst func() any\n\t}\n\n\tcases := []testcase{\n\t\t{\n\t\t\tdesc: \"simple struct\",\n\t\t\tvalue: encodetestInstance,\n\t\t\tdst: func() any { return &encodetest{} },\n\t\t},\n\t\t{\n\t\t\tdesc: \"nested struct\",\n\t\t\tvalue: nestedInstance,\n\t\t\tdst: func() any { return &encodetest{} },\n\t\t},\n\t}\n\n\tinputs := []struct {\n\t\tname string\n\t\tvalue any\n\t}{\n\t\t{\n\t\t\tname: \"simple\",\n\t\t\tvalue: encodetestInstance,\n\t\t},\n\t\t{\n\t\t\tname: \"nested\",\n\t\t\tvalue: nestedInstance,\n\t\t},\n\t\t{\n\t\t\tname: \"deep_bson.json.gz\",\n\t\t\tvalue: readExtJSONFile(\"deep_bson.json.gz\"),\n\t\t},\n\t\t{\n\t\t\tname: \"flat_bson.json.gz\",\n\t\t\tvalue: readExtJSONFile(\"flat_bson.json.gz\"),\n\t\t},\n\t\t{\n\t\t\tname: \"full_bson.json.gz\",\n\t\t\tvalue: readExtJSONFile(\"full_bson.json.gz\"),\n\t\t},\n\t}\n\n\tdestinations := []struct {\n\t\tname string\n\t\tdst func() any\n\t}{\n\t\t{\n\t\t\tname: \"to map\",\n\t\t\tdst: func() any { return &map[string]any{} },\n\t\t},\n\t\t{\n\t\t\tname: \"to D\",\n\t\t\tdst: func() any { return &D{} },\n\t\t},\n\t}\n\n\tfor _, input := range inputs {\n\t\tfor _, dest := range destinations {\n\t\t\tcases = append(cases, testcase{\n\t\t\t\tdesc: input.name + \" \" + dest.name,\n\t\t\t\tvalue: input.value,\n\t\t\t\tdst: dest.dst,\n\t\t\t})\n\t\t}\n\t}\n\n\tb.Run(\"BSON\", func(b *testing.B) {\n\t\tfor _, tc := range cases {\n\t\t\ttc := tc // Capture range variable.\n\n\t\t\tb.Run(tc.desc, func(b *testing.B) {\n\t\t\t\tb.ReportAllocs()\n\t\t\t\tdata, err := Marshal(tc.value)\n\t\t\t\tif err != nil {\n\t\t\t\t\tb.Errorf(\"error marshalling BSON: %s\", err)\n\t\t\t\t\treturn\n\t\t\t\t}\n\n\t\t\t\tb.SetBytes(int64(len(data)))\n\t\t\t\tb.ResetTimer()\n\t\t\t\tb.RunParallel(func(pb *testing.PB) {\n\t\t\t\t\tfor pb.Next() {\n\t\t\t\t\t\tval := tc.dst()\n\t\t\t\t\t\terr := Unmarshal(data, val)\n\t\t\t\t\t\tif err != nil {\n\t\t\t\t\t\t\tb.Errorf(\"error unmarshalling BSON: %s\", err)\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t})\n\t\t}\n\t})\n\n\tb.Run(\"extJSON\", func(b *testing.B) {\n\t\tfor _, tc := range cases {\n\t\t\ttc := tc // Capture range variable.\n\n\t\t\tb.Run(tc.desc, func(b *testing.B) {\n\t\t\t\tb.ReportAllocs()\n\t\t\t\tdata, err := MarshalExtJSON(tc.value, true, false)\n\t\t\t\tif err != nil {\n\t\t\t\t\tb.Errorf(\"error marshalling extended JSON: %s\", err)\n\t\t\t\t\treturn\n\t\t\t\t}\n\n\t\t\t\tb.SetBytes(int64(len(data)))\n\t\t\t\tb.ResetTimer()\n\t\t\t\tb.RunParallel(func(pb *testing.PB) {\n\t\t\t\t\tfor pb.Next() {\n\t\t\t\t\t\tval := tc.dst()\n\t\t\t\t\t\terr := UnmarshalExtJSON(data, true, val)\n\t\t\t\t\t\tif err != nil {\n\t\t\t\t\t\t\tb.Errorf(\"error unmarshalling extended JSON: %s\", err)\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t})\n\t\t}\n\t})\n\n\tb.Run(\"JSON\", func(b *testing.B) {\n\t\tfor _, tc := range cases {\n\t\t\ttc := tc // Capture range variable.\n\n\t\t\tb.Run(tc.desc, func(b *testing.B) {\n\t\t\t\tb.ReportAllocs()\n\t\t\t\tdata, err := json.Marshal(tc.value)\n\t\t\t\tif err != nil {\n\t\t\t\t\tb.Errorf(\"error marshalling JSON: %s\", err)\n\t\t\t\t\treturn\n\t\t\t\t}\n\n\t\t\t\tb.SetBytes(int64(len(data)))\n\t\t\t\tb.ResetTimer()\n\t\t\t\tb.RunParallel(func(pb *testing.PB) {\n\t\t\t\t\tfor pb.Next() {\n\t\t\t\t\t\tval := tc.dst()\n\t\t\t\t\t\terr := json.Unmarshal(data, val)\n\t\t\t\t\t\tif err != nil {\n\t\t\t\t\t\t\tb.Errorf(\"error unmarshalling JSON: %s\", err)\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t})\n\t\t}\n\t})\n}\n\n// The following benchmarks are copied from the Go standard library's\n// encoding/json package.\n\ntype codeResponse struct {\n\tTree *codeNode `json:\"tree\"`\n\tUsername string `json:\"username\"`\n}\n\ntype codeNode struct {\n\tName string `json:\"name\"`\n\tKids []*codeNode `json:\"kids\"`\n\tCLWeight float64 `json:\"cl_weight\"`\n\tTouches int `json:\"touches\"`\n\tMinT int64 `json:\"min_t\"`\n\tMaxT int64 `json:\"max_t\"`\n\tMeanT int64 `json:\"mean_t\"`\n}\n\nvar (\n\tcodeJSON []byte\n\tcodeBSON []byte\n\tcodeStruct codeResponse\n)\n\nfunc codeInit() {\n\tf, err := os.Open(\"testdata/code.json.gz\")\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer f.Close()\n\tgz, err := gzip.NewReader(f)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdata, err := io.ReadAll(gz)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tcodeJSON = data\n\n\tif err := json.Unmarshal(codeJSON, &codeStruct); err != nil {\n\t\tpanic(\"json.Unmarshal code.json: \" + err.Error())\n\t}\n\n\tif data, err = json.Marshal(&codeStruct); err != nil {\n\t\tpanic(\"json.Marshal code.json: \" + err.Error())\n\t}\n\n\tif codeBSON, err = Marshal(&codeStruct); err != nil {\n\t\tpanic(\"Marshal code.json: \" + err.Error())\n\t}\n\n\tif !bytes.Equal(data, codeJSON) {\n\t\tprintln(\"different lengths\", len(data), len(codeJSON))\n\t\tfor i := 0; i < len(data) && i < len(codeJSON); i++ {\n\t\t\tif data[i] != codeJSON[i] {\n\t\t\t\tprintln(\"re-marshal: changed at byte\", i)\n\t\t\t\tprintln(\"orig: \", string(codeJSON[i-10:i+10]))\n\t\t\t\tprintln(\"new: \", string(data[i-10:i+10]))\n\t\t\t\tbreak\n\t\t\t}\n\t\t}\n\t\tpanic(\"re-marshal code.json: different result\")\n\t}\n}\n\nfunc BenchmarkCodeUnmarshal(b *testing.B) {\n\tif codeJSON == nil {\n\t\tb.StopTimer()\n\t\tcodeInit()\n\t\tb.StartTimer()\n\t}\n\tb.Run(\"BSON\", func(b *testing.B) {\n\t\tb.ReportAllocs()\n\t\tb.RunParallel(func(pb *testing.PB) {\n\t\t\tfor pb.Next() {\n\t\t\t\tvar r codeResponse\n\t\t\t\tif err := Unmarshal(codeBSON, &r); err != nil {\n\t\t\t\t\tb.Fatal(\"Unmarshal:\", err)\n\t\t\t\t}\n\t\t\t}\n\t\t})\n\t\tb.SetBytes(int64(len(codeBSON)))\n\t})\n\tb.Run(\"JSON\", func(b *testing.B) {\n\t\tb.ReportAllocs()\n\t\tb.RunParallel(func(pb *testing.PB) {\n\t\t\tfor pb.Next() {\n\t\t\t\tvar r codeResponse\n\t\t\t\tif err := json.Unmarshal(codeJSON, &r); err != nil {\n\t\t\t\t\tb.Fatal(\"json.Unmarshal:\", err)\n\t\t\t\t}\n\t\t\t}\n\t\t})\n\t\tb.SetBytes(int64(len(codeJSON)))\n\t})\n}\n\nfunc BenchmarkCodeMarshal(b *testing.B) {\n\tif codeJSON == nil {\n\t\tb.StopTimer()\n\t\tcodeInit()\n\t\tb.StartTimer()\n\t}\n\tb.Run(\"BSON\", func(b *testing.B) {\n\t\tb.ReportAllocs()\n\t\tb.RunParallel(func(pb *testing.PB) {\n\t\t\tfor pb.Next() {\n\t\t\t\tif _, err := Marshal(&codeStruct); err != nil {\n\t\t\t\t\tb.Fatal(\"Marshal:\", err)\n\t\t\t\t}\n\t\t\t}\n\t\t})\n\t\tb.SetBytes(int64(len(codeBSON)))\n\t})\n\tb.Run(\"JSON\", func(b *testing.B) {\n\t\tb.ReportAllocs()\n\t\tb.RunParallel(func(pb *testing.PB) {\n\t\t\tfor pb.Next() {\n\t\t\t\tif _, err := json.Marshal(&codeStruct); err != nil {\n\t\t\t\t\tb.Fatal(\"json.Marshal:\", err)\n\t\t\t\t}\n\t\t\t}\n\t\t})\n\t\tb.SetBytes(int64(len(codeJSON)))\n\t})\n}\n" }, { "path": "bson/bson_binary_vector_spec_test.go", "content": "// Copyright (C) MongoDB, Inc. 2024-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"encoding/hex\"\n\t\"encoding/json\"\n\t\"os\"\n\t\"path\"\n\t\"testing\"\n\n\t\"go.mongodb.org/mongo-driver/v2/internal/require\"\n\t\"go.mongodb.org/mongo-driver/v2/internal/spectest\"\n)\n\nvar bsonBinaryVectorDir = spectest.Path(\"bson-binary-vector\")\n\ntype bsonBinaryVectorTests struct {\n\tDescription string `json:\"description\"`\n\tTestKey string `json:\"test_key\"`\n\tTests []bsonBinaryVectorTestCase `json:\"tests\"`\n}\n\ntype bsonBinaryVectorTestCase struct {\n\tDescription string `json:\"description\"`\n\tValid bool `json:\"valid\"`\n\tVector json.RawMessage `json:\"vector\"`\n\tDtypeHex string `json:\"dtype_hex\"`\n\tDtypeAlias string `json:\"dtype_alias\"`\n\tPadding int `json:\"padding\"`\n\tCanonicalBson string `json:\"canonical_bson\"`\n}\n\nfunc TestBsonBinaryVectorSpec(t *testing.T) {\n\tt.Parallel()\n\n\tjsonFiles, err := findJSONFilesInDir(bsonBinaryVectorDir)\n\trequire.NoErrorf(t, err, \"error finding JSON files in %s: %v\", bsonBinaryVectorDir, err)\n\n\tfor _, file := range jsonFiles {\n\t\tfilepath := path.Join(bsonBinaryVectorDir, file)\n\t\tcontent, err := os.ReadFile(filepath)\n\t\trequire.NoErrorf(t, err, \"reading test file %s\", filepath)\n\n\t\tvar tests bsonBinaryVectorTests\n\t\trequire.NoErrorf(t, json.Unmarshal(content, &tests), \"parsing test file %s\", filepath)\n\n\t\tt.Run(tests.Description, func(t *testing.T) {\n\t\t\tt.Parallel()\n\n\t\t\tfor _, test := range tests.Tests {\n\t\t\t\ttest := test\n\t\t\t\tt.Run(test.Description, func(t *testing.T) {\n\t\t\t\t\tt.Parallel()\n\n\t\t\t\t\trunBsonBinaryVectorTest(t, tests.TestKey, test)\n\t\t\t\t})\n\t\t\t}\n\t\t})\n\t}\n\n\tt.Run(\"Padding specified with no vector data PACKED_BIT\", func(t *testing.T) {\n\t\tt.Parallel()\n\n\t\tt.Run(\"Marshaling\", func(t *testing.T) {\n\t\t\t_, err := NewPackedBitVector(nil, 1)\n\t\t\trequire.EqualError(t, err, errNonZeroVectorPadding.Error())\n\t\t})\n\t})\n\n\tt.Run(\"Exceeding maximum padding PACKED_BIT\", func(t *testing.T) {\n\t\tt.Parallel()\n\n\t\tt.Run(\"Marshaling\", func(t *testing.T) {\n\t\t\t_, err := NewPackedBitVector(nil, 8)\n\t\t\trequire.EqualError(t, err, errVectorPaddingTooLarge.Error())\n\t\t})\n\t})\n}\n\nfunc decodeTestSlice[T int8 | float32 | byte](t *testing.T, data []byte) []T {\n\tt.Helper()\n\n\tif len(data) == 0 {\n\t\treturn nil\n\t}\n\tvar s []float64\n\terr := UnmarshalExtJSON(data, true, &s)\n\trequire.NoError(t, err)\n\n\tv := make([]T, len(s))\n\tfor i, e := range s {\n\t\tv[i] = T(e)\n\t}\n\treturn v\n}\n\nfunc runBsonBinaryVectorTest(t *testing.T, testKey string, test bsonBinaryVectorTestCase) {\n\ttestVector := make(map[string]Vector)\n\tswitch alias := test.DtypeHex; alias {\n\tcase \"0x03\":\n\t\ttestVector[testKey] = Vector{\n\t\t\tdType: Int8Vector,\n\t\t\tint8Data: decodeTestSlice[int8](t, test.Vector),\n\t\t}\n\tcase \"0x27\":\n\t\ttestVector[testKey] = Vector{\n\t\t\tdType: Float32Vector,\n\t\t\tfloat32Data: decodeTestSlice[float32](t, test.Vector),\n\t\t}\n\tcase \"0x10\":\n\t\ttestVector[testKey] = Vector{\n\t\t\tdType: PackedBitVector,\n\t\t\tbitData: decodeTestSlice[byte](t, test.Vector),\n\t\t\tbitPadding: uint8(test.Padding),\n\t\t}\n\tdefault:\n\t\tt.Fatalf(\"unsupported vector type: %s\", alias)\n\t}\n\n\ttestBSON, err := hex.DecodeString(test.CanonicalBson)\n\trequire.NoError(t, err, \"decoding canonical BSON\")\n\n\tt.Run(\"Unmarshaling\", func(t *testing.T) {\n\t\tspectest.CheckSkip(t)\n\n\t\terrMap := map[string]string{\n\t\t\t\"FLOAT32 with padding\": \"padding must be 0\",\n\t\t\t\"INT8 with padding\": \"padding must be 0\",\n\t\t\t\"Padding specified with no vector data PACKED_BIT\": \"padding must be 0\",\n\t\t\t\"Exceeding maximum padding PACKED_BIT\": \"padding cannot be larger than 7\",\n\t\t}\n\n\t\tt.Parallel()\n\n\t\tvar got map[string]Vector\n\t\terr := Unmarshal(testBSON, &got)\n\t\tif test.Valid {\n\t\t\trequire.NoError(t, err)\n\t\t\trequire.Equal(t, testVector, got)\n\t\t} else if errMsg, ok := errMap[test.Description]; ok {\n\t\t\trequire.ErrorContains(t, err, errMsg)\n\t\t} else {\n\t\t\trequire.Error(t, err)\n\t\t}\n\t})\n\n\tt.Run(\"Marshaling\", func(t *testing.T) {\n\t\tspectest.CheckSkip(t)\n\n\t\tt.Parallel()\n\n\t\tgot, err := Marshal(testVector)\n\t\trequire.NoError(t, err)\n\t\trequire.Equal(t, testBSON, got)\n\t})\n}\n" }, { "path": "bson/bson_corpus_spec_test.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"bytes\"\n\t\"encoding/hex\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"os\"\n\t\"path\"\n\t\"reflect\"\n\t\"strconv\"\n\t\"strings\"\n\t\"testing\"\n\t\"unicode\"\n\t\"unicode/utf8\"\n\n\t\"github.com/google/go-cmp/cmp\"\n\t\"go.mongodb.org/mongo-driver/v2/internal/assert\"\n\t\"go.mongodb.org/mongo-driver/v2/internal/require\"\n\t\"go.mongodb.org/mongo-driver/v2/internal/spectest\"\n)\n\ntype testCase struct {\n\tDescription string `json:\"description\"`\n\tBsonType string `json:\"bson_type\"`\n\tTestKey *string `json:\"test_key\"`\n\tValid []validityTestCase `json:\"valid\"`\n\tDecodeErrors []decodeErrorTestCase `json:\"decodeErrors\"`\n\tParseErrors []parseErrorTestCase `json:\"parseErrors\"`\n\tDeprecated *bool `json:\"deprecated\"`\n}\n\ntype validityTestCase struct {\n\tDescription string `json:\"description\"`\n\tCanonicalBson string `json:\"canonical_bson\"`\n\tCanonicalExtJSON string `json:\"canonical_extjson\"`\n\tRelaxedExtJSON *string `json:\"relaxed_extjson\"`\n\tDegenerateBSON *string `json:\"degenerate_bson\"`\n\tDegenerateExtJSON *string `json:\"degenerate_extjson\"`\n\tConvertedBSON *string `json:\"converted_bson\"`\n\tConvertedExtJSON *string `json:\"converted_extjson\"`\n\tLossy *bool `json:\"lossy\"`\n}\n\ntype decodeErrorTestCase struct {\n\tDescription string `json:\"description\"`\n\tBson string `json:\"bson\"`\n}\n\ntype parseErrorTestCase struct {\n\tDescription string `json:\"description\"`\n\tString string `json:\"string\"`\n}\n\nvar dataDir = spectest.Path(\"bson-corpus/tests\")\n\nfunc findJSONFilesInDir(dir string) ([]string, error) {\n\tfiles := make([]string, 0)\n\n\tentries, err := os.ReadDir(dir)\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\n\tfor _, entry := range entries {\n\t\tif entry.IsDir() || path.Ext(entry.Name()) != \".json\" {\n\t\t\tcontinue\n\t\t}\n\n\t\tfiles = append(files, entry.Name())\n\t}\n\n\treturn files, nil\n}\n\n// seedExtJSON will add the byte representation of the \"extJSON\" string to the fuzzer's coprus.\nfunc seedExtJSON(f *testing.F, extJSON string, extJSONType string, desc string) {\n\tjbytes, err := jsonToBytes(extJSON, extJSONType, desc)\n\tif err != nil {\n\t\tf.Fatalf(\"failed to convert JSON to bytes: %v\", err)\n\t}\n\n\tf.Add(jbytes)\n}\n\n// seedTestCase will add the byte representation for each \"extJSON\" string of each valid test case to the fuzzer's\n// corpus.\nfunc seedTestCase(f *testing.F, tcase *testCase) {\n\tfor _, vtc := range tcase.Valid {\n\t\tseedExtJSON(f, vtc.CanonicalExtJSON, \"canonical\", vtc.Description)\n\n\t\t// Seed the relaxed extended JSON.\n\t\tif vtc.RelaxedExtJSON != nil {\n\t\t\tseedExtJSON(f, *vtc.RelaxedExtJSON, \"relaxed\", vtc.Description)\n\t\t}\n\n\t\t// Seed the degenerate extended JSON.\n\t\tif vtc.DegenerateExtJSON != nil {\n\t\t\tseedExtJSON(f, *vtc.DegenerateExtJSON, \"degenerate\", vtc.Description)\n\t\t}\n\n\t\t// Seed the converted extended JSON.\n\t\tif vtc.ConvertedExtJSON != nil {\n\t\t\tseedExtJSON(f, *vtc.ConvertedExtJSON, \"converted\", vtc.Description)\n\t\t}\n\t}\n}\n\n// seedBSONCorpus will unmarshal the data from \"testdata/bson-corpus\" into a slice of \"testCase\" structs and then\n// marshal the \"*_extjson\" field of each \"validityTestCase\" into a slice of bytes to seed the fuzz corpus.\nfunc seedBSONCorpus(f *testing.F) {\n\tfileNames, err := findJSONFilesInDir(dataDir)\n\tif err != nil {\n\t\tf.Fatalf(\"failed to find JSON files in directory %q: %v\", dataDir, err)\n\t}\n\n\tfor _, fileName := range fileNames {\n\t\tfilePath := path.Join(dataDir, fileName)\n\n\t\tfile, err := os.Open(filePath)\n\t\tif err != nil {\n\t\t\tf.Fatalf(\"failed to open file %q: %v\", filePath, err)\n\t\t}\n\n\t\tvar tcase testCase\n\t\tif err := json.NewDecoder(file).Decode(&tcase); err != nil {\n\t\t\tf.Fatal(err)\n\t\t}\n\n\t\tseedTestCase(f, &tcase)\n\t}\n}\n\nfunc needsEscapedUnicode(bsonType string) bool {\n\treturn bsonType == \"0x02\" || bsonType == \"0x0D\" || bsonType == \"0x0E\" || bsonType == \"0x0F\"\n}\n\nfunc unescapeUnicode(s, bsonType string) string {\n\tif !needsEscapedUnicode(bsonType) {\n\t\treturn s\n\t}\n\n\tnewS := \"\"\n\n\tfor i := 0; i < len(s); i++ {\n\t\tc := s[i]\n\t\tswitch c {\n\t\tcase '\\\\':\n\t\t\tswitch s[i+1] {\n\t\t\tcase 'u':\n\t\t\t\tus := s[i : i+6]\n\t\t\t\tu, err := strconv.Unquote(strings.Replace(strconv.Quote(us), `\\\\u`, `\\u`, 1))\n\t\t\t\tif err != nil {\n\t\t\t\t\treturn \"\"\n\t\t\t\t}\n\t\t\t\tfor _, r := range u {\n\t\t\t\t\tif r < ' ' {\n\t\t\t\t\t\tnewS += fmt.Sprintf(`\\u%04x`, r)\n\t\t\t\t\t} else {\n\t\t\t\t\t\tnewS += string(r)\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\ti += 5\n\t\t\tdefault:\n\t\t\t\tnewS += string(c)\n\t\t\t}\n\t\tdefault:\n\t\t\tif c > unicode.MaxASCII {\n\t\t\t\tr, size := utf8.DecodeRune([]byte(s[i:]))\n\t\t\t\tnewS += string(r)\n\t\t\t\ti += size - 1\n\t\t\t} else {\n\t\t\t\tnewS += string(c)\n\t\t\t}\n\t\t}\n\t}\n\n\treturn newS\n}\n\nfunc normalizeCanonicalDouble(t *testing.T, key string, cEJ string) string {\n\t// Unmarshal string into map\n\tcEJMap := make(map[string]map[string]string)\n\terr := json.Unmarshal([]byte(cEJ), &cEJMap)\n\trequire.NoError(t, err)\n\n\t// Parse the float contained by the map.\n\texpectedString := cEJMap[key][\"$numberDouble\"]\n\texpectedFloat, err := strconv.ParseFloat(expectedString, 64)\n\trequire.NoError(t, err)\n\n\t// Normalize the string\n\treturn fmt.Sprintf(`{\"%s\":{\"$numberDouble\":\"%s\"}}`, key, formatDouble(expectedFloat))\n}\n\nfunc normalizeRelaxedDouble(t *testing.T, key string, rEJ string) string {\n\t// Unmarshal string into map\n\trEJMap := make(map[string]float64)\n\terr := json.Unmarshal([]byte(rEJ), &rEJMap)\n\tif err != nil {\n\t\treturn normalizeCanonicalDouble(t, key, rEJ)\n\t}\n\n\t// Parse the float contained by the map.\n\texpectedFloat := rEJMap[key]\n\n\t// Normalize the string\n\treturn fmt.Sprintf(`{\"%s\":%s}`, key, formatDouble(expectedFloat))\n}\n\n// bsonToNative decodes the BSON bytes (b) into a native Document\nfunc bsonToNative(t *testing.T, b []byte, bType, testDesc string) D {\n\tvar doc D\n\terr := Unmarshal(b, &doc)\n\trequire.NoErrorf(t, err, \"%s: decoding %s BSON\", testDesc, bType)\n\treturn doc\n}\n\n// nativeToBSON encodes the native Document (doc) into canonical BSON and compares it to the expected\n// canonical BSON (cB)\nfunc nativeToBSON(t *testing.T, cB []byte, doc D, testDesc, bType, docSrcDesc string) {\n\tactual, err := Marshal(doc)\n\trequire.NoErrorf(t, err, \"%s: encoding %s BSON\", testDesc, bType)\n\n\tif diff := cmp.Diff(cB, actual); diff != \"\" {\n\t\tt.Errorf(\"%s: 'native_to_bson(%s) = cB' failed (-want, +got):\\n-%v\\n+%v\\n\",\n\t\t\ttestDesc, docSrcDesc, cB, actual)\n\t\tt.FailNow()\n\t}\n}\n\n// jsonToNative decodes the extended JSON string (ej) into a native Document\nfunc jsonToNative(ej, ejType, testDesc string) (D, error) {\n\tvar doc D\n\tif err := UnmarshalExtJSON([]byte(ej), ejType != \"relaxed\", &doc); err != nil {\n\t\treturn nil, fmt.Errorf(\"%s: decoding %s extended JSON: %w\", testDesc, ejType, err)\n\t}\n\treturn doc, nil\n}\n\n// jsonToBytes decodes the extended JSON string (ej) into canonical BSON and then encodes it into a byte slice.\nfunc jsonToBytes(ej, ejType, testDesc string) ([]byte, error) {\n\tnative, err := jsonToNative(ej, ejType, testDesc)\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\n\tb, err := Marshal(native)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"%s: encoding %s BSON: %w\", testDesc, ejType, err)\n\t}\n\n\treturn b, nil\n}\n\n// nativeToJSON encodes the native Document (doc) into an extended JSON string\nfunc nativeToJSON(t *testing.T, ej string, doc D, testDesc, ejType, ejShortName, docSrcDesc string) {\n\tactualEJ, err := MarshalExtJSON(doc, ejType != \"relaxed\", true)\n\trequire.NoErrorf(t, err, \"%s: encoding %s extended JSON\", testDesc, ejType)\n\n\tif diff := cmp.Diff(ej, string(actualEJ)); diff != \"\" {\n\t\tt.Errorf(\"%s: 'native_to_%s_extended_json(%s) = %s' failed (-want, +got):\\n%s\\n\",\n\t\t\ttestDesc, ejType, docSrcDesc, ejShortName, diff)\n\t\tt.FailNow()\n\t}\n}\n\nfunc runTest(t *testing.T, file string) {\n\tfilepath := path.Join(dataDir, file)\n\tcontent, err := os.ReadFile(filepath)\n\trequire.NoError(t, err)\n\n\tt.Run(file, func(t *testing.T) {\n\t\tvar test testCase\n\t\trequire.NoError(t, json.Unmarshal(content, &test))\n\n\t\tt.Run(\"valid\", func(t *testing.T) {\n\t\t\tfor _, v := range test.Valid {\n\t\t\t\tt.Run(v.Description, func(t *testing.T) {\n\t\t\t\t\t// get canonical BSON\n\t\t\t\t\tcB, err := hex.DecodeString(v.CanonicalBson)\n\t\t\t\t\trequire.NoErrorf(t, err, \"%s: reading canonical BSON\", v.Description)\n\n\t\t\t\t\t// get canonical extended JSON\n\t\t\t\t\tvar compactEJ bytes.Buffer\n\t\t\t\t\trequire.NoError(t, json.Compact(&compactEJ, []byte(v.CanonicalExtJSON)))\n\t\t\t\t\tcEJ := unescapeUnicode(compactEJ.String(), test.BsonType)\n\t\t\t\t\tif test.BsonType == \"0x01\" {\n\t\t\t\t\t\tcEJ = normalizeCanonicalDouble(t, *test.TestKey, cEJ)\n\t\t\t\t\t}\n\n\t\t\t\t\t/*** canonical BSON round-trip tests ***/\n\t\t\t\t\tdoc := bsonToNative(t, cB, \"canonical\", v.Description)\n\n\t\t\t\t\t// native_to_bson(bson_to_native(cB)) = cB\n\t\t\t\t\tnativeToBSON(t, cB, doc, v.Description, \"canonical\", \"bson_to_native(cB)\")\n\n\t\t\t\t\t// native_to_canonical_extended_json(bson_to_native(cB)) = cEJ\n\t\t\t\t\tnativeToJSON(t, cEJ, doc, v.Description, \"canonical\", \"cEJ\", \"bson_to_native(cB)\")\n\n\t\t\t\t\t// native_to_relaxed_extended_json(bson_to_native(cB)) = rEJ (if rEJ exists)\n\t\t\t\t\tif v.RelaxedExtJSON != nil {\n\t\t\t\t\t\tvar compactEJ bytes.Buffer\n\t\t\t\t\t\trequire.NoError(t, json.Compact(&compactEJ, []byte(*v.RelaxedExtJSON)))\n\t\t\t\t\t\trEJ := unescapeUnicode(compactEJ.String(), test.BsonType)\n\t\t\t\t\t\tif test.BsonType == \"0x01\" {\n\t\t\t\t\t\t\trEJ = normalizeRelaxedDouble(t, *test.TestKey, rEJ)\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tnativeToJSON(t, rEJ, doc, v.Description, \"relaxed\", \"rEJ\", \"bson_to_native(cB)\")\n\n\t\t\t\t\t\t/*** relaxed extended JSON round-trip tests (if exists) ***/\n\t\t\t\t\t\tdoc, err = jsonToNative(rEJ, \"relaxed\", v.Description)\n\t\t\t\t\t\trequire.NoError(t, err)\n\n\t\t\t\t\t\t// native_to_relaxed_extended_json(json_to_native(rEJ)) = rEJ\n\t\t\t\t\t\tnativeToJSON(t, rEJ, doc, v.Description, \"relaxed\", \"eJR\", \"json_to_native(rEJ)\")\n\t\t\t\t\t}\n\n\t\t\t\t\t/*** canonical extended JSON round-trip tests ***/\n\t\t\t\t\tdoc, err = jsonToNative(cEJ, \"canonical\", v.Description)\n\t\t\t\t\trequire.NoError(t, err)\n\n\t\t\t\t\t// native_to_canonical_extended_json(json_to_native(cEJ)) = cEJ\n\t\t\t\t\tnativeToJSON(t, cEJ, doc, v.Description, \"canonical\", \"cEJ\", \"json_to_native(cEJ)\")\n\n\t\t\t\t\t// native_to_bson(json_to_native(cEJ)) = cb (unless lossy)\n\t\t\t\t\tif v.Lossy == nil || !*v.Lossy {\n\t\t\t\t\t\tnativeToBSON(t, cB, doc, v.Description, \"canonical\", \"json_to_native(cEJ)\")\n\t\t\t\t\t}\n\n\t\t\t\t\t/*** degenerate BSON round-trip tests (if exists) ***/\n\t\t\t\t\tif v.DegenerateBSON != nil {\n\t\t\t\t\t\tdB, err := hex.DecodeString(*v.DegenerateBSON)\n\t\t\t\t\t\trequire.NoErrorf(t, err, \"%s: reading degenerate BSON\", v.Description)\n\n\t\t\t\t\t\tdoc = bsonToNative(t, dB, \"degenerate\", v.Description)\n\n\t\t\t\t\t\t// native_to_bson(bson_to_native(dB)) = cB\n\t\t\t\t\t\tnativeToBSON(t, cB, doc, v.Description, \"degenerate\", \"bson_to_native(dB)\")\n\t\t\t\t\t}\n\n\t\t\t\t\t/*** degenerate JSON round-trip tests (if exists) ***/\n\t\t\t\t\tif v.DegenerateExtJSON != nil {\n\t\t\t\t\t\tvar compactEJ bytes.Buffer\n\t\t\t\t\t\trequire.NoError(t, json.Compact(&compactEJ, []byte(*v.DegenerateExtJSON)))\n\t\t\t\t\t\tdEJ := unescapeUnicode(compactEJ.String(), test.BsonType)\n\t\t\t\t\t\tif test.BsonType == \"0x01\" {\n\t\t\t\t\t\t\tdEJ = normalizeCanonicalDouble(t, *test.TestKey, dEJ)\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tdoc, err = jsonToNative(dEJ, \"degenerate canonical\", v.Description)\n\t\t\t\t\t\trequire.NoError(t, err)\n\n\t\t\t\t\t\t// native_to_canonical_extended_json(json_to_native(dEJ)) = cEJ\n\t\t\t\t\t\tnativeToJSON(t, cEJ, doc, v.Description, \"degenerate canonical\", \"cEJ\", \"json_to_native(dEJ)\")\n\n\t\t\t\t\t\t// native_to_bson(json_to_native(dEJ)) = cB (unless lossy)\n\t\t\t\t\t\tif v.Lossy == nil || !*v.Lossy {\n\t\t\t\t\t\t\tnativeToBSON(t, cB, doc, v.Description, \"canonical\", \"json_to_native(dEJ)\")\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t}\n\t\t})\n\n\t\tt.Run(\"decode error\", func(t *testing.T) {\n\t\t\tfor _, d := range test.DecodeErrors {\n\t\t\t\tt.Run(d.Description, func(t *testing.T) {\n\t\t\t\t\tb, err := hex.DecodeString(d.Bson)\n\t\t\t\t\trequire.NoError(t, err, d.Description)\n\n\t\t\t\t\tvar doc D\n\t\t\t\t\terr = Unmarshal(b, &doc)\n\n\t\t\t\t\t// The driver unmarshals invalid UTF-8 strings without error. Loop over the unmarshalled elements\n\t\t\t\t\t// and assert that there was no error if any of the string or DBPointer values contain invalid UTF-8\n\t\t\t\t\t// characters.\n\t\t\t\t\tfor _, elem := range doc {\n\t\t\t\t\t\tvalue := reflect.ValueOf(elem.Value)\n\t\t\t\t\t\tinvalidString := (value.Kind() == reflect.String) && !utf8.ValidString(value.String())\n\t\t\t\t\t\tdbPtr, ok := elem.Value.(DBPointer)\n\t\t\t\t\t\tinvalidDBPtr := ok && !utf8.ValidString(dbPtr.DB)\n\n\t\t\t\t\t\tif invalidString || invalidDBPtr {\n\t\t\t\t\t\t\trequire.NoError(t, err, d.Description)\n\t\t\t\t\t\t\treturn\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\trequire.Errorf(t, err, \"%s: expected decode error\", d.Description)\n\t\t\t\t})\n\t\t\t}\n\t\t})\n\n\t\tt.Run(\"parse error\", func(t *testing.T) {\n\t\t\tfor _, p := range test.ParseErrors {\n\t\t\t\tt.Run(p.Description, func(t *testing.T) {\n\t\t\t\t\ts := unescapeUnicode(p.String, test.BsonType)\n\t\t\t\t\tif test.BsonType == \"0x13\" {\n\t\t\t\t\t\ts = fmt.Sprintf(`{\"decimal128\": {\"$numberDecimal\": \"%s\"}}`, s)\n\t\t\t\t\t}\n\n\t\t\t\t\tswitch test.BsonType {\n\t\t\t\t\tcase \"0x00\", \"0x05\", \"0x13\":\n\t\t\t\t\t\tvar doc D\n\t\t\t\t\t\terr := UnmarshalExtJSON([]byte(s), true, &doc)\n\t\t\t\t\t\t// Null bytes are validated when marshaling to BSON\n\t\t\t\t\t\tif strings.Contains(p.Description, \"Null\") {\n\t\t\t\t\t\t\t_, err = Marshal(doc)\n\t\t\t\t\t\t}\n\t\t\t\t\t\trequire.Errorf(t, err, \"%s: expected parse error\", p.Description)\n\t\t\t\t\tdefault:\n\t\t\t\t\t\tt.Errorf(\"Update test to check for parse errors for type %s\", test.BsonType)\n\t\t\t\t\t\tt.Fail()\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t}\n\t\t})\n\t})\n}\n\nfunc TestBSONCorpus(t *testing.T) {\n\tjsonFiles, err := findJSONFilesInDir(dataDir)\n\trequire.NoErrorf(t, err, \"error finding JSON files in %s: %v\", dataDir, err)\n\n\tfor _, file := range jsonFiles {\n\t\trunTest(t, file)\n\t}\n}\n\nfunc TestRelaxedUUIDValidation(t *testing.T) {\n\ttestCases := []struct {\n\t\tdescription string\n\t\tcanonicalExtJSON string\n\t\tdegenerateExtJSON string\n\t\texpectedErr string\n\t}{\n\t\t{\n\t\t\t\"valid uuid\",\n\t\t\t\"{\\\"x\\\" : { \\\"$binary\\\" : {\\\"base64\\\" : \\\"c//SZESzTGmQ6OfR38A11A==\\\", \\\"subType\\\" : \\\"04\\\"}}}\",\n\t\t\t\"{\\\"x\\\" : { \\\"$uuid\\\" : \\\"73ffd264-44b3-4c69-90e8-e7d1dfc035d4\\\"}}\",\n\t\t\t\"\",\n\t\t},\n\t\t{\n\t\t\t\"invalid uuid--no hyphens\",\n\t\t\t\"\",\n\t\t\t\"{\\\"x\\\" : { \\\"$uuid\\\" : \\\"73ffd26444b34c6990e8e7d1dfc035d4\\\"}}\",\n\t\t\t\"$uuid value does not follow RFC 4122 format regarding length and hyphens\",\n\t\t},\n\t\t{\n\t\t\t\"invalid uuid--trailing hyphens\",\n\t\t\t\"\",\n\t\t\t\"{\\\"x\\\" : { \\\"$uuid\\\" : \\\"73ffd264-44b3-4c69-90e8-e7d1dfc035--\\\"}}\",\n\t\t\t\"$uuid value does not follow RFC 4122 format regarding length and hyphens\",\n\t\t},\n\t\t{\n\t\t\t\"invalid uuid--malformed hex\",\n\t\t\t\"\",\n\t\t\t\"{\\\"x\\\" : { \\\"$uuid\\\" : \\\"q3@fd26l-44b3-4c69-90e8-e7d1dfc035d4\\\"}}\",\n\t\t\t\"$uuid value does not follow RFC 4122 format regarding hex bytes: encoding/hex: invalid byte: U+0071 'q'\",\n\t\t},\n\t}\n\n\tfor _, tc := range testCases {\n\t\tt.Run(tc.description, func(t *testing.T) {\n\t\t\t// get canonical extended JSON (if provided)\n\t\t\tcEJ := \"\"\n\t\t\tif tc.canonicalExtJSON != \"\" {\n\t\t\t\tvar compactCEJ bytes.Buffer\n\t\t\t\trequire.NoError(t, json.Compact(&compactCEJ, []byte(tc.canonicalExtJSON)))\n\t\t\t\tcEJ = unescapeUnicode(compactCEJ.String(), \"0x05\")\n\t\t\t}\n\n\t\t\t// get degenerate extended JSON\n\t\t\tvar compactDEJ bytes.Buffer\n\t\t\trequire.NoError(t, json.Compact(&compactDEJ, []byte(tc.degenerateExtJSON)))\n\t\t\tdEJ := unescapeUnicode(compactDEJ.String(), \"0x05\")\n\n\t\t\t// convert dEJ to native doc\n\t\t\tvar doc D\n\t\t\terr := UnmarshalExtJSON([]byte(dEJ), true, &doc)\n\n\t\t\tif tc.expectedErr != \"\" {\n\t\t\t\tassert.Equal(t, tc.expectedErr, err.Error(), \"expected error %v, got %v\", tc.expectedErr, err)\n\t\t\t} else {\n\t\t\t\tassert.Nil(t, err, \"expected no error, got error: %v\", err)\n\n\t\t\t\t// Marshal doc into extended JSON and compare with cEJ\n\t\t\t\tnativeToJSON(t, cEJ, doc, tc.description, \"degenerate canonical\", \"cEJ\", \"json_to_native(dEJ)\")\n\t\t\t}\n\t\t})\n\t}\n}\n" }, { "path": "bson/bson_test.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"bytes\"\n\t\"encoding/json\"\n\t\"errors\"\n\t\"fmt\"\n\t\"reflect\"\n\t\"strconv\"\n\t\"strings\"\n\t\"testing\"\n\t\"time\"\n\n\t\"github.com/google/go-cmp/cmp\"\n\t\"go.mongodb.org/mongo-driver/v2/internal/assert\"\n\t\"go.mongodb.org/mongo-driver/v2/internal/require\"\n\t\"go.mongodb.org/mongo-driver/v2/x/bsonx/bsoncore\"\n)\n\nfunc noerr(t *testing.T, err error) {\n\tif err != nil {\n\t\tt.Helper()\n\t\tt.Errorf(\"Unexpected error: (%T)%v\", err, err)\n\t\tt.FailNow()\n\t}\n}\n\nfunc TestTimestamp(t *testing.T) {\n\tt.Parallel()\n\n\ttestCases := []struct {\n\t\tdescription string\n\t\ttp Timestamp\n\t\ttp2 Timestamp\n\t\texpectedAfter bool\n\t\texpectedBefore bool\n\t\texpectedEqual bool\n\t\texpectedCompare int\n\t}{\n\t\t{\n\t\t\tdescription: \"equal\",\n\t\t\ttp: Timestamp{T: 12345, I: 67890},\n\t\t\ttp2: Timestamp{T: 12345, I: 67890},\n\t\t\texpectedBefore: false,\n\t\t\texpectedAfter: false,\n\t\t\texpectedEqual: true,\n\t\t\texpectedCompare: 0,\n\t\t},\n\t\t{\n\t\t\tdescription: \"T greater than\",\n\t\t\ttp: Timestamp{T: 12345, I: 67890},\n\t\t\ttp2: Timestamp{T: 2345, I: 67890},\n\t\t\texpectedBefore: false,\n\t\t\texpectedAfter: true,\n\t\t\texpectedEqual: false,\n\t\t\texpectedCompare: 1,\n\t\t},\n\t\t{\n\t\t\tdescription: \"I greater than\",\n\t\t\ttp: Timestamp{T: 12345, I: 67890},\n\t\t\ttp2: Timestamp{T: 12345, I: 7890},\n\t\t\texpectedBefore: false,\n\t\t\texpectedAfter: true,\n\t\t\texpectedEqual: false,\n\t\t\texpectedCompare: 1,\n\t\t},\n\t\t{\n\t\t\tdescription: \"T less than\",\n\t\t\ttp: Timestamp{T: 12345, I: 67890},\n\t\t\ttp2: Timestamp{T: 112345, I: 67890},\n\t\t\texpectedBefore: true,\n\t\t\texpectedAfter: false,\n\t\t\texpectedEqual: false,\n\t\t\texpectedCompare: -1,\n\t\t},\n\t\t{\n\t\t\tdescription: \"I less than\",\n\t\t\ttp: Timestamp{T: 12345, I: 67890},\n\t\t\ttp2: Timestamp{T: 12345, I: 167890},\n\t\t\texpectedBefore: true,\n\t\t\texpectedAfter: false,\n\t\t\texpectedEqual: false,\n\t\t\texpectedCompare: -1,\n\t\t},\n\t}\n\n\tfor _, tc := range testCases {\n\t\ttc := tc // Capture range variable.\n\n\t\tt.Run(tc.description, func(t *testing.T) {\n\t\t\tt.Parallel()\n\n\t\t\tassert.Equal(t, tc.expectedAfter, tc.tp.After(tc.tp2), \"expected After results to be the same\")\n\t\t\tassert.Equal(t, tc.expectedBefore, tc.tp.Before(tc.tp2), \"expected Before results to be the same\")\n\t\t\tassert.Equal(t, tc.expectedEqual, tc.tp.Equal(tc.tp2), \"expected Equal results to be the same\")\n\t\t\tassert.Equal(t, tc.expectedCompare, tc.tp.Compare(tc.tp2), \"expected Compare result to be the same\")\n\t\t})\n\t}\n}\n\nfunc TestPrimitiveIsZero(t *testing.T) {\n\ttestcases := []struct {\n\t\tname string\n\t\tzero Zeroer\n\t\tnonzero Zeroer\n\t}{\n\t\t{\"binary\", Binary{}, Binary{Data: []byte{0x01, 0x02, 0x03}, Subtype: 0xFF}},\n\t\t{\"decimal128\", Decimal128{}, NewDecimal128(1, 2)},\n\t\t{\"objectID\", ObjectID{}, NewObjectID()},\n\t\t{\"regex\", Regex{}, Regex{Pattern: \"foo\", Options: \"bar\"}},\n\t\t{\"dbPointer\", DBPointer{}, DBPointer{DB: \"foobar\", Pointer: ObjectID{0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0A, 0x0B, 0x0C}}},\n\t\t{\"timestamp\", Timestamp{}, Timestamp{T: 12345, I: 67890}},\n\t}\n\n\tfor _, tc := range testcases {\n\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\trequire.True(t, tc.zero.IsZero())\n\t\t\trequire.False(t, tc.nonzero.IsZero())\n\t\t})\n\t}\n}\n\nfunc TestRegexCompare(t *testing.T) {\n\ttestcases := []struct {\n\t\tname string\n\t\tr1 Regex\n\t\tr2 Regex\n\t\teq bool\n\t}{\n\t\t{\"equal\", Regex{Pattern: \"foo1\", Options: \"bar1\"}, Regex{Pattern: \"foo1\", Options: \"bar1\"}, true},\n\t\t{\"not equal\", Regex{Pattern: \"foo1\", Options: \"bar1\"}, Regex{Pattern: \"foo2\", Options: \"bar2\"}, false},\n\t\t{\"not equal\", Regex{Pattern: \"foo1\", Options: \"bar1\"}, Regex{Pattern: \"foo1\", Options: \"bar2\"}, false},\n\t\t{\"not equal\", Regex{Pattern: \"foo1\", Options: \"bar1\"}, Regex{Pattern: \"foo2\", Options: \"bar1\"}, false},\n\t}\n\n\tfor _, tc := range testcases {\n\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\trequire.True(t, tc.r1.Equal(tc.r2) == tc.eq)\n\t\t})\n\t}\n}\n\nfunc TestDateTime(t *testing.T) {\n\tt.Run(\"json\", func(t *testing.T) {\n\t\tt.Run(\"round trip\", func(t *testing.T) {\n\t\t\toriginal := DateTime(1000)\n\t\t\tjsonBytes, err := json.Marshal(original)\n\t\t\tassert.Nil(t, err, \"Marshal error: %v\", err)\n\n\t\t\tvar unmarshalled DateTime\n\t\t\terr = json.Unmarshal(jsonBytes, &unmarshalled)\n\t\t\tassert.Nil(t, err, \"Unmarshal error: %v\", err)\n\n\t\t\tassert.Equal(t, original, unmarshalled, \"expected DateTime %v, got %v\", original, unmarshalled)\n\t\t})\n\t\tt.Run(\"decode null\", func(t *testing.T) {\n\t\t\tjsonBytes := []byte(\"null\")\n\t\t\tvar dt DateTime\n\t\t\terr := json.Unmarshal(jsonBytes, &dt)\n\t\t\tassert.Nil(t, err, \"Unmarshal error: %v\", err)\n\t\t\tassert.Equal(t, DateTime(0), dt, \"expected DateTime value to be 0, got %v\", dt)\n\t\t})\n\t\tt.Run(\"UTC\", func(t *testing.T) {\n\t\t\tdt := DateTime(1681145535123)\n\t\t\tjsonBytes, err := json.Marshal(dt)\n\t\t\tassert.Nil(t, err, \"Marshal error: %v\", err)\n\t\t\tassert.Equal(t, `\"2023-04-10T16:52:15.123Z\"`, string(jsonBytes))\n\t\t})\n\t})\n\tt.Run(\"NewDateTimeFromTime\", func(t *testing.T) {\n\t\tt.Run(\"range is not limited\", func(t *testing.T) {\n\t\t\t// If the implementation internally calls time.Time.UnixNano(), the constructor cannot handle times after\n\t\t\t// the year 2262.\n\n\t\t\ttimeFormat := \"2006-01-02T15:04:05.999Z07:00\"\n\t\t\ttimeString := \"3001-01-01T00:00:00Z\"\n\t\t\ttt, err := time.Parse(timeFormat, timeString)\n\t\t\tassert.Nil(t, err, \"Parse error: %v\", err)\n\n\t\t\tdt := NewDateTimeFromTime(tt)\n\t\t\tassert.True(t, dt > 0, \"expected a valid DateTime greater than 0, got %v\", dt)\n\t\t})\n\t})\n}\n\nfunc TestTimeRoundTrip(t *testing.T) {\n\tval := struct {\n\t\tValue time.Time\n\t\tID string\n\t}{\n\t\tID: \"time-rt-test\",\n\t}\n\n\tif !val.Value.IsZero() {\n\t\tt.Errorf(\"Did not get zero time as expected.\")\n\t}\n\n\tbsonOut, err := Marshal(val)\n\tnoerr(t, err)\n\trtval := struct {\n\t\tValue time.Time\n\t\tID string\n\t}{}\n\n\terr = Unmarshal(bsonOut, &rtval)\n\tnoerr(t, err)\n\tif !cmp.Equal(val, rtval) {\n\t\tt.Errorf(\"Did not round trip properly. got %v; want %v\", val, rtval)\n\t}\n\tif !rtval.Value.IsZero() {\n\t\tt.Errorf(\"Did not get zero time as expected.\")\n\t}\n}\n\nfunc TestNonNullTimeRoundTrip(t *testing.T) {\n\tnow := time.Now()\n\tnow = time.Unix(now.Unix(), 0)\n\tval := struct {\n\t\tValue time.Time\n\t\tID string\n\t}{\n\t\tID: \"time-rt-test\",\n\t\tValue: now,\n\t}\n\n\tbsonOut, err := Marshal(val)\n\tnoerr(t, err)\n\trtval := struct {\n\t\tValue time.Time\n\t\tID string\n\t}{}\n\n\terr = Unmarshal(bsonOut, &rtval)\n\tnoerr(t, err)\n\tif !cmp.Equal(val, rtval) {\n\t\tt.Errorf(\"Did not round trip properly. got %v; want %v\", val, rtval)\n\t}\n}\n\nfunc TestD(t *testing.T) {\n\tt.Run(\"can marshal\", func(t *testing.T) {\n\t\td := D{{\"foo\", \"bar\"}, {\"hello\", \"world\"}, {\"pi\", 3.14159}}\n\t\tidx, want := bsoncore.AppendDocumentStart(nil)\n\t\twant = bsoncore.AppendStringElement(want, \"foo\", \"bar\")\n\t\twant = bsoncore.AppendStringElement(want, \"hello\", \"world\")\n\t\twant = bsoncore.AppendDoubleElement(want, \"pi\", 3.14159)\n\t\twant, err := bsoncore.AppendDocumentEnd(want, idx)\n\t\tnoerr(t, err)\n\t\tgot, err := Marshal(d)\n\t\tnoerr(t, err)\n\t\tif !bytes.Equal(got, want) {\n\t\t\tt.Errorf(\"Marshaled documents do not match. got %v; want %v\", Raw(got), Raw(want))\n\t\t}\n\t})\n\tt.Run(\"can unmarshal\", func(t *testing.T) {\n\t\twant := D{{\"foo\", \"bar\"}, {\"hello\", \"world\"}, {\"pi\", 3.14159}}\n\t\tidx, doc := bsoncore.AppendDocumentStart(nil)\n\t\tdoc = bsoncore.AppendStringElement(doc, \"foo\", \"bar\")\n\t\tdoc = bsoncore.AppendStringElement(doc, \"hello\", \"world\")\n\t\tdoc = bsoncore.AppendDoubleElement(doc, \"pi\", 3.14159)\n\t\tdoc, err := bsoncore.AppendDocumentEnd(doc, idx)\n\t\tnoerr(t, err)\n\t\tvar got D\n\t\terr = Unmarshal(doc, &got)\n\t\tnoerr(t, err)\n\t\tif !cmp.Equal(got, want) {\n\t\t\tt.Errorf(\"Unmarshaled documents do not match. got %v; want %v\", got, want)\n\t\t}\n\t})\n}\n\nfunc TestDStringer(t *testing.T) {\n\tgot := D{{\"a\", 1}, {\"b\", 2}}.String()\n\twant := `{\"a\":{\"$numberInt\":\"1\"},\"b\":{\"$numberInt\":\"2\"}}`\n\tassert.Equal(t, want, got, \"expected: %s, got: %s\", want, got)\n}\n\nfunc TestMStringer(t *testing.T) {\n\ttype msg struct {\n\t\tA json.RawMessage `json:\"a\"`\n\t\tB json.RawMessage `json:\"b\"`\n\t}\n\n\tvar res msg\n\tgot := M{\"a\": 1, \"b\": 2}.String()\n\terr := json.Unmarshal([]byte(got), &res)\n\trequire.NoError(t, err, \"Unmarshal error\")\n\n\twant := msg{\n\t\tA: json.RawMessage(`{\"$numberInt\":\"1\"}`),\n\t\tB: json.RawMessage(`{\"$numberInt\":\"2\"}`),\n\t}\n\n\tassert.Equal(t, want, res, \"returned string did not unmarshal to the expected document, returned string: %s\", got)\n}\n\nfunc TestD_MarshalJSON(t *testing.T) {\n\tt.Parallel()\n\n\ttestcases := []struct {\n\t\tname string\n\t\ttest D\n\t\texpected any\n\t}{\n\t\t{\n\t\t\t\"nil\",\n\t\t\tnil,\n\t\t\tnil,\n\t\t},\n\t\t{\n\t\t\t\"empty\",\n\t\t\tD{},\n\t\t\tstruct{}{},\n\t\t},\n\t\t{\n\t\t\t\"non-empty\",\n\t\t\tD{\n\t\t\t\t{\"a\", 42},\n\t\t\t\t{\"b\", true},\n\t\t\t\t{\"c\", \"answer\"},\n\t\t\t\t{\"d\", nil},\n\t\t\t\t{\"e\", 2.71828},\n\t\t\t\t{\"f\", A{42, true, \"answer\", nil, 2.71828}},\n\t\t\t\t{\"g\", D{{\"foo\", \"bar\"}}},\n\t\t\t},\n\t\t\tstruct {\n\t\t\t\tA int `json:\"a\"`\n\t\t\t\tB bool `json:\"b\"`\n\t\t\t\tC string `json:\"c\"`\n\t\t\t\tD any `json:\"d\"`\n\t\t\t\tE float32 `json:\"e\"`\n\t\t\t\tF []any `json:\"f\"`\n\t\t\t\tG map[string]any `json:\"g\"`\n\t\t\t}{\n\t\t\t\tA: 42,\n\t\t\t\tB: true,\n\t\t\t\tC: \"answer\",\n\t\t\t\tD: nil,\n\t\t\t\tE: 2.71828,\n\t\t\t\tF: []any{42, true, \"answer\", nil, 2.71828},\n\t\t\t\tG: map[string]any{\"foo\": \"bar\"},\n\t\t\t},\n\t\t},\n\t}\n\tfor _, tc := range testcases {\n\t\ttc := tc\n\t\tt.Run(\"json.Marshal \"+tc.name, func(t *testing.T) {\n\t\t\tt.Parallel()\n\n\t\t\tgot, err := json.Marshal(tc.test)\n\t\t\tassert.NoError(t, err)\n\t\t\twant, _ := json.Marshal(tc.expected)\n\t\t\tassert.Equal(t, want, got)\n\t\t})\n\t}\n\tfor _, tc := range testcases {\n\t\ttc := tc\n\t\tt.Run(\"json.MarshalIndent \"+tc.name, func(t *testing.T) {\n\t\t\tt.Parallel()\n\n\t\t\tgot, err := json.MarshalIndent(tc.test, \"\", \"\")\n\t\t\tassert.NoError(t, err)\n\t\t\twant, _ := json.MarshalIndent(tc.expected, \"\", \"\")\n\t\t\tassert.Equal(t, want, got)\n\t\t})\n\t}\n}\n\nfunc TestD_UnmarshalJSON(t *testing.T) {\n\tt.Parallel()\n\n\tt.Run(\"success\", func(t *testing.T) {\n\t\tt.Parallel()\n\n\t\tfor _, tc := range []struct {\n\t\t\tname string\n\t\t\ttest []byte\n\t\t\texpected D\n\t\t}{\n\t\t\t{\n\t\t\t\t\"nil\",\n\t\t\t\t[]byte(`null`),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"empty\",\n\t\t\t\t[]byte(`{}`),\n\t\t\t\tD{},\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"non-empty\",\n\t\t\t\t[]byte(`{\"hello\":\"world\",\"pi\":3.142,\"boolean\":true,\"nothing\":null,\"list\":[\"hello world\",3.142,false,null,{\"Lorem\":\"ipsum\"}],\"document\":{\"foo\":\"bar\"}}`),\n\t\t\t\tD{\n\t\t\t\t\t{\"hello\", \"world\"},\n\t\t\t\t\t{\"pi\", 3.142},\n\t\t\t\t\t{\"boolean\", true},\n\t\t\t\t\t{\"nothing\", nil},\n\t\t\t\t\t{\"list\", []any{\"hello world\", 3.142, false, nil, D{{\"Lorem\", \"ipsum\"}}}},\n\t\t\t\t\t{\"document\", D{{\"foo\", \"bar\"}}},\n\t\t\t\t},\n\t\t\t},\n\t\t} {\n\t\t\ttc := tc\n\t\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\t\tt.Parallel()\n\n\t\t\t\tvar got D\n\t\t\t\terr := json.Unmarshal(tc.test, &got)\n\t\t\t\tassert.NoError(t, err)\n\t\t\t\tassert.Equal(t, tc.expected, got)\n\t\t\t})\n\t\t}\n\t})\n\n\tt.Run(\"failure\", func(t *testing.T) {\n\t\tt.Parallel()\n\n\t\tfor _, tc := range []struct {\n\t\t\tname string\n\t\t\ttest string\n\t\t}{\n\t\t\t{\n\t\t\t\t\"illegal\",\n\t\t\t\t`nil`,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"invalid\",\n\t\t\t\t`{\"pi\": 3.142ipsum}`,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"malformatted\",\n\t\t\t\t`{\"pi\", 3.142}`,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"truncated\",\n\t\t\t\t`{\"pi\": 3.142`,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"array type\",\n\t\t\t\t`[\"pi\", 3.142]`,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"boolean type\",\n\t\t\t\t`true`,\n\t\t\t},\n\t\t} {\n\t\t\ttc := tc\n\t\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\t\tt.Parallel()\n\n\t\t\t\tvar a map[string]any\n\t\t\t\twant := json.Unmarshal([]byte(tc.test), &a)\n\t\t\t\tvar b D\n\t\t\t\tgot := json.Unmarshal([]byte(tc.test), &b)\n\t\t\t\tw := new(json.UnmarshalTypeError)\n\t\t\t\tif errors.As(want, &w) {\n\t\t\t\t\tw.Type = reflect.TypeOf(b)\n\t\t\t\t\trequire.IsType(t, want, got)\n\t\t\t\t\tg := new(json.UnmarshalTypeError)\n\t\t\t\t\tassert.True(t, errors.As(got, &g))\n\t\t\t\t\tassert.Equal(t, w, g)\n\t\t\t\t} else {\n\t\t\t\t\tassert.Equal(t, want, got)\n\t\t\t\t}\n\t\t\t})\n\t\t}\n\t})\n}\n\ntype stringerString string\n\nfunc (ss stringerString) String() string {\n\treturn \"bar\"\n}\n\ntype keyBool bool\n\nfunc (kb keyBool) MarshalKey() (string, error) {\n\treturn fmt.Sprintf(\"%v\", kb), nil\n}\n\nfunc (kb *keyBool) UnmarshalKey(key string) error {\n\tswitch key {\n\tcase \"true\":\n\t\t*kb = true\n\tcase \"false\":\n\t\t*kb = false\n\tdefault:\n\t\treturn fmt.Errorf(\"invalid bool value %v\", key)\n\t}\n\treturn nil\n}\n\ntype keyStruct struct {\n\tval int64\n}\n\nfunc (k keyStruct) MarshalText() (text []byte, err error) {\n\tstr := strconv.FormatInt(k.val, 10)\n\n\treturn []byte(str), nil\n}\n\nfunc (k *keyStruct) UnmarshalText(text []byte) error {\n\tval, err := strconv.ParseInt(string(text), 10, 64)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\t*k = keyStruct{\n\t\tval: val,\n\t}\n\n\treturn nil\n}\n\nfunc TestMapCodec(t *testing.T) {\n\tt.Run(\"EncodeKeysWithStringer\", func(t *testing.T) {\n\t\tstrstr := stringerString(\"foo\")\n\t\tmapObj := map[stringerString]int{strstr: 1}\n\t\ttestCases := []struct {\n\t\t\tname string\n\t\t\tmapCodec *mapCodec\n\t\t\tkey string\n\t\t}{\n\t\t\t{\"default\", &mapCodec{}, \"foo\"},\n\t\t\t{\"true\", &mapCodec{encodeKeysWithStringer: true}, \"bar\"},\n\t\t\t{\"false\", &mapCodec{encodeKeysWithStringer: false}, \"foo\"},\n\t\t}\n\t\tfor _, tc := range testCases {\n\t\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\t\tmapRegistry := NewRegistry()\n\t\t\t\tmapRegistry.RegisterKindEncoder(reflect.Map, tc.mapCodec)\n\t\t\t\tbuf := new(bytes.Buffer)\n\t\t\t\tvw := NewDocumentWriter(buf)\n\t\t\t\tenc := NewEncoder(vw)\n\t\t\t\tenc.SetRegistry(mapRegistry)\n\t\t\t\terr := enc.Encode(mapObj)\n\t\t\t\tassert.Nil(t, err, \"Encode error: %v\", err)\n\t\t\t\tstr := buf.String()\n\t\t\t\tassert.True(t, strings.Contains(str, tc.key), \"expected result to contain %v, got: %v\", tc.key, str)\n\t\t\t})\n\t\t}\n\t})\n\n\tt.Run(\"keys implements keyMarshaler and keyUnmarshaler\", func(t *testing.T) {\n\t\tmapObj := map[keyBool]int{keyBool(true): 1}\n\n\t\tdoc, err := Marshal(mapObj)\n\t\tassert.Nil(t, err, \"Marshal error: %v\", err)\n\t\tidx, want := bsoncore.AppendDocumentStart(nil)\n\t\twant = bsoncore.AppendInt32Element(want, \"true\", 1)\n\t\twant, _ = bsoncore.AppendDocumentEnd(want, idx)\n\t\tassert.Equal(t, want, doc, \"expected result %v, got %v\", string(want), string(doc))\n\n\t\tvar got map[keyBool]int\n\t\terr = Unmarshal(doc, &got)\n\t\tassert.Nil(t, err, \"Unmarshal error: %v\", err)\n\t\tassert.Equal(t, mapObj, got, \"expected result %v, got %v\", mapObj, got)\n\t})\n\n\tt.Run(\"keys implements encoding.TextMarshaler and encoding.TextUnmarshaler\", func(t *testing.T) {\n\t\tmapObj := map[keyStruct]int{\n\t\t\t{val: 10}: 100,\n\t\t}\n\n\t\tdoc, err := Marshal(mapObj)\n\t\tassert.Nil(t, err, \"Marshal error: %v\", err)\n\t\tidx, want := bsoncore.AppendDocumentStart(nil)\n\t\twant = bsoncore.AppendInt32Element(want, \"10\", 100)\n\t\twant, _ = bsoncore.AppendDocumentEnd(want, idx)\n\t\tassert.Equal(t, want, doc, \"expected result %v, got %v\", string(want), string(doc))\n\n\t\tvar got map[keyStruct]int\n\t\terr = Unmarshal(doc, &got)\n\t\tassert.Nil(t, err, \"Unmarshal error: %v\", err)\n\t\tassert.Equal(t, mapObj, got, \"expected result %v, got %v\", mapObj, got)\n\t})\n}\n\nfunc TestExtJSONEscapeKey(t *testing.T) {\n\tdoc := D{\n\t\t{\n\t\t\tKey: \"\\\\usb#\",\n\t\t\tValue: int32(1),\n\t\t},\n\t\t{\n\t\t\tKey: \"regex\",\n\t\t\tValue: Regex{Pattern: \"ab\\\\\\\\\\\\\\\"ab\", Options: \"\\\"\"},\n\t\t},\n\t}\n\tb, err := MarshalExtJSON(&doc, false, false)\n\tnoerr(t, err)\n\n\twant := `{\"\\\\usb#\":1,\"regex\":{\"$regularExpression\":{\"pattern\":\"ab\\\\\\\\\\\\\\\"ab\",\"options\":\"\\\"\"}}}`\n\tif diff := cmp.Diff(want, string(b)); diff != \"\" {\n\t\tt.Errorf(\"Marshaled documents do not match. got %v, want %v\", string(b), want)\n\t}\n\n\tvar got D\n\terr = UnmarshalExtJSON(b, false, &got)\n\tnoerr(t, err)\n\tif !cmp.Equal(got, doc) {\n\t\tt.Errorf(\"Unmarshaled documents do not match. got %v; want %v\", got, doc)\n\t}\n}\n\nfunc TestBsoncoreArray(t *testing.T) {\n\ttype BSONDocumentArray struct {\n\t\tArray []D `bson:\"array\"`\n\t}\n\n\ttype BSONArray struct {\n\t\tArray bsoncore.Array `bson:\"array\"`\n\t}\n\n\tbda := BSONDocumentArray{\n\t\tArray: []D{\n\t\t\t{{\"x\", 1}},\n\t\t\t{{\"x\", 2}},\n\t\t\t{{\"x\", 3}},\n\t\t},\n\t}\n\n\texpectedBSON, err := Marshal(bda)\n\tassert.Nil(t, err, \"Marshal bsoncore.Document array error: %v\", err)\n\n\tvar ba BSONArray\n\terr = Unmarshal(expectedBSON, &ba)\n\tassert.Nil(t, err, \"Unmarshal error: %v\", err)\n\n\tactualBSON, err := Marshal(ba)\n\tassert.Nil(t, err, \"Marshal bsoncore.Array error: %v\", err)\n\n\tassert.Equal(t, expectedBSON, actualBSON,\n\t\t\"expected BSON to be %v after Marshalling again; got %v\", expectedBSON, actualBSON)\n\n\tdoc := bsoncore.Document(actualBSON)\n\tv := doc.Lookup(\"array\")\n\tassert.Equal(t, bsoncore.TypeArray, v.Type, \"expected type array, got %v\", v.Type)\n}\n\nvar baseTime = time.Date(2024, 10, 11, 12, 13, 14, 12345678, time.UTC)\n\nfunc BenchmarkDateTimeMarshalJSON(b *testing.B) {\n\tt := NewDateTimeFromTime(baseTime)\n\tdata, err := t.MarshalJSON()\n\tif err != nil {\n\t\tb.Fatal(err)\n\t}\n\tb.ReportAllocs()\n\tb.SetBytes(int64(len(data)))\n\tfor i := 0; i < b.N; i++ {\n\t\tif _, err := t.MarshalJSON(); err != nil {\n\t\t\tb.Fatal(err)\n\t\t}\n\t}\n}\n\nfunc BenchmarkDateTimeUnmarshalJSON(b *testing.B) {\n\tt := NewDateTimeFromTime(baseTime)\n\tdata, err := t.MarshalJSON()\n\tif err != nil {\n\t\tb.Fatal(err)\n\t}\n\tb.ReportAllocs()\n\tb.SetBytes(int64(len(data)))\n\tfor i := 0; i < b.N; i++ {\n\t\tvar dt DateTime\n\t\tif err := dt.UnmarshalJSON(data); err != nil {\n\t\t\tb.Fatal(err)\n\t\t}\n\t}\n}\n" }, { "path": "bson/bsoncodec.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"fmt\"\n\t\"reflect\"\n\t\"strings\"\n)\n\nvar emptyValue = reflect.Value{}\n\n// ValueEncoderError is an error returned from a ValueEncoder when the provided value can't be\n// encoded by the ValueEncoder.\ntype ValueEncoderError struct {\n\tName string\n\tTypes []reflect.Type\n\tKinds []reflect.Kind\n\tReceived reflect.Value\n}\n\nfunc (vee ValueEncoderError) Error() string {\n\ttypeKinds := make([]string, 0, len(vee.Types)+len(vee.Kinds))\n\tfor _, t := range vee.Types {\n\t\ttypeKinds = append(typeKinds, t.String())\n\t}\n\tfor _, k := range vee.Kinds {\n\t\tif k == reflect.Map {\n\t\t\ttypeKinds = append(typeKinds, \"map[string]*\")\n\t\t\tcontinue\n\t\t}\n\t\ttypeKinds = append(typeKinds, k.String())\n\t}\n\treceived := vee.Received.Kind().String()\n\tif vee.Received.IsValid() {\n\t\treceived = vee.Received.Type().String()\n\t}\n\treturn fmt.Sprintf(\"%s can only encode valid %s, but got %s\", vee.Name, strings.Join(typeKinds, \", \"), received)\n}\n\n// ValueDecoderError is an error returned from a ValueDecoder when the provided value can't be\n// decoded by the ValueDecoder.\ntype ValueDecoderError struct {\n\tName string\n\tTypes []reflect.Type\n\tKinds []reflect.Kind\n\tReceived reflect.Value\n}\n\nfunc (vde ValueDecoderError) Error() string {\n\ttypeKinds := make([]string, 0, len(vde.Types)+len(vde.Kinds))\n\tfor _, t := range vde.Types {\n\t\ttypeKinds = append(typeKinds, t.String())\n\t}\n\tfor _, k := range vde.Kinds {\n\t\tif k == reflect.Map {\n\t\t\ttypeKinds = append(typeKinds, \"map[string]*\")\n\t\t\tcontinue\n\t\t}\n\t\ttypeKinds = append(typeKinds, k.String())\n\t}\n\treceived := vde.Received.Kind().String()\n\tif vde.Received.IsValid() {\n\t\treceived = vde.Received.Type().String()\n\t}\n\tif !vde.Received.CanSet() {\n\t\treceived = \"unsettable \" + received\n\t}\n\treturn fmt.Sprintf(\"%s can only decode valid and settable %s, but got %s\", vde.Name, strings.Join(typeKinds, \", \"), received)\n}\n\n// EncodeContext is the contextual information required for a Codec to encode a\n// value.\ntype EncodeContext struct {\n\t*Registry\n\n\t// minSize causes the Encoder to marshal Go integer values (int, int8, int16, int32, int64,\n\t// uint, uint8, uint16, uint32, or uint64) as the minimum BSON int size (either 32 or 64 bits)\n\t// that can represent the integer value.\n\tminSize bool\n\n\terrorOnInlineDuplicates bool\n\tstringifyMapKeysWithFmt bool\n\tnilMapAsEmpty bool\n\tnilSliceAsEmpty bool\n\tnilByteSliceAsEmpty bool\n\tomitZeroStruct bool\n\tomitEmpty bool\n\tuseJSONStructTags bool\n}\n\n// DecodeContext is the contextual information required for a Codec to decode a\n// value.\ntype DecodeContext struct {\n\t*Registry\n\n\t// truncate, if true, instructs decoders to to truncate the fractional part of BSON \"double\"\n\t// values when attempting to unmarshal them into a Go integer (int, int8, int16, int32, int64,\n\t// uint, uint8, uint16, uint32, or uint64) struct field. The truncation logic does not apply to\n\t// BSON \"decimal128\" values.\n\ttruncate bool\n\n\t// defaultDocumentType specifies the Go type to decode top-level and nested BSON documents into. In particular, the\n\t// usage for this field is restricted to data typed as \"any\" or \"map[string]any\". If DocumentType is\n\t// set to a type that a BSON document cannot be unmarshaled into (e.g. \"string\"), unmarshalling will result in an\n\t// error.\n\tdefaultDocumentType reflect.Type\n\n\tbinaryAsSlice bool\n\n\t// a false value results in a decoding error.\n\tobjectIDAsHexString bool\n\n\tuseJSONStructTags bool\n\tuseLocalTimeZone bool\n\tzeroMaps bool\n\tzeroStructs bool\n}\n\n// ValueEncoder is the interface implemented by types that can encode a provided Go type to BSON.\n// The value to encode is provided as a reflect.Value and a bson.ValueWriter is used within the\n// EncodeValue method to actually create the BSON representation. For convenience, ValueEncoderFunc\n// is provided to allow use of a function with the correct signature as a ValueEncoder. An\n// EncodeContext instance is provided to allow implementations to lookup further ValueEncoders and\n// to provide configuration information.\ntype ValueEncoder interface {\n\tEncodeValue(EncodeContext, ValueWriter, reflect.Value) error\n}\n\n// ValueEncoderFunc is an adapter function that allows a function with the correct signature to be\n// used as a ValueEncoder.\ntype ValueEncoderFunc func(EncodeContext, ValueWriter, reflect.Value) error\n\n// EncodeValue implements the ValueEncoder interface.\nfunc (fn ValueEncoderFunc) EncodeValue(ec EncodeContext, vw ValueWriter, val reflect.Value) error {\n\treturn fn(ec, vw, val)\n}\n\n// ValueDecoder is the interface implemented by types that can decode BSON to a provided Go type.\n// Implementations should ensure that the value they receive is settable. Similar to ValueEncoderFunc,\n// ValueDecoderFunc is provided to allow the use of a function with the correct signature as a\n// ValueDecoder. A DecodeContext instance is provided and serves similar functionality to the\n// EncodeContext.\ntype ValueDecoder interface {\n\tDecodeValue(DecodeContext, ValueReader, reflect.Value) error\n}\n\n// ValueDecoderFunc is an adapter function that allows a function with the correct signature to be\n// used as a ValueDecoder.\ntype ValueDecoderFunc func(DecodeContext, ValueReader, reflect.Value) error\n\n// DecodeValue implements the ValueDecoder interface.\nfunc (fn ValueDecoderFunc) DecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\treturn fn(dc, vr, val)\n}\n\n// typeDecoder is the interface implemented by types that can handle the decoding of a value given its type.\ntype typeDecoder interface {\n\tdecodeType(DecodeContext, ValueReader, reflect.Type) (reflect.Value, error)\n}\n\n// typeDecoderFunc is an adapter function that allows a function with the correct signature to be used as a typeDecoder.\ntype typeDecoderFunc func(DecodeContext, ValueReader, reflect.Type) (reflect.Value, error)\n\nfunc (fn typeDecoderFunc) decodeType(dc DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\treturn fn(dc, vr, t)\n}\n\n// decodeAdapter allows two functions with the correct signatures to be used as both a ValueDecoder and typeDecoder.\ntype decodeAdapter struct {\n\tValueDecoderFunc\n\ttypeDecoderFunc\n}\n\nvar (\n\t_ ValueDecoder = decodeAdapter{}\n\t_ typeDecoder = decodeAdapter{}\n)\n\nfunc decodeTypeOrValueWithInfo(vd ValueDecoder, dc DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif td, _ := vd.(typeDecoder); td != nil {\n\t\tval, err := td.decodeType(dc, vr, t)\n\t\tif err == nil && val.Type() != t {\n\t\t\t// This conversion step is necessary for slices and maps. If a user declares variables like:\n\t\t\t//\n\t\t\t// type myBool bool\n\t\t\t// var m map[string]myBool\n\t\t\t//\n\t\t\t// and tries to decode BSON bytes into the map, the decoding will fail if this conversion is not present\n\t\t\t// because we'll try to assign a value of type bool to one of type myBool.\n\t\t\tval = val.Convert(t)\n\t\t}\n\t\treturn val, err\n\t}\n\n\tval := reflect.New(t).Elem()\n\terr := vd.DecodeValue(dc, vr, val)\n\treturn val, err\n}\n" }, { "path": "bson/bsoncodec_test.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"fmt\"\n\t\"reflect\"\n\t\"testing\"\n)\n\nfunc ExampleValueEncoder() {\n\tvar _ ValueEncoderFunc = func(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\t\tif val.Kind() != reflect.String {\n\t\t\treturn ValueEncoderError{Name: \"StringEncodeValue\", Kinds: []reflect.Kind{reflect.String}, Received: val}\n\t\t}\n\n\t\treturn vw.WriteString(val.String())\n\t}\n}\n\nfunc ExampleValueDecoder() {\n\tvar _ ValueDecoderFunc = func(_ DecodeContext, vr ValueReader, val reflect.Value) error {\n\t\tif !val.CanSet() || val.Kind() != reflect.String {\n\t\t\treturn ValueDecoderError{Name: \"StringDecodeValue\", Kinds: []reflect.Kind{reflect.String}, Received: val}\n\t\t}\n\n\t\tif vr.Type() != TypeString {\n\t\t\treturn fmt.Errorf(\"cannot decode %v into a string type\", vr.Type())\n\t\t}\n\n\t\tstr, err := vr.ReadString()\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\tval.SetString(str)\n\t\treturn nil\n\t}\n}\n\ntype llCodec struct {\n\tt *testing.T\n\tdecodeval any\n\tencodeval any\n\terr error\n}\n\nfunc (llc *llCodec) EncodeValue(_ EncodeContext, _ ValueWriter, i any) error {\n\tif llc.err != nil {\n\t\treturn llc.err\n\t}\n\n\tllc.encodeval = i\n\treturn nil\n}\n\nfunc (llc *llCodec) DecodeValue(_ DecodeContext, _ ValueReader, val reflect.Value) error {\n\tif llc.err != nil {\n\t\treturn llc.err\n\t}\n\n\tif !reflect.TypeOf(llc.decodeval).AssignableTo(val.Type()) {\n\t\tllc.t.Errorf(\"decodeval must be assignable to val provided to DecodeValue, but is not. decodeval %T; val %T\", llc.decodeval, val)\n\t\treturn nil\n\t}\n\n\tval.Set(reflect.ValueOf(llc.decodeval))\n\treturn nil\n}\n" }, { "path": "bson/bsonrw_test.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"testing\"\n\n\t\"go.mongodb.org/mongo-driver/v2/x/bsonx/bsoncore\"\n)\n\nvar (\n\t_ ValueReader = &valueReaderWriter{}\n\t_ ValueWriter = &valueReaderWriter{}\n)\n\n// invoked is a type used to indicate what method was called last.\ntype invoked byte\n\n// These are the different methods that can be invoked.\nconst (\n\tnothing invoked = iota\n\treadArray\n\treadBinary\n\treadBoolean\n\treadDocument\n\treadCodeWithScope\n\treadDBPointer\n\treadDateTime\n\treadDecimal128\n\treadDouble\n\treadInt32\n\treadInt64\n\treadJavascript\n\treadMaxKey\n\treadMinKey\n\treadNull\n\treadObjectID\n\treadRegex\n\treadString\n\treadSymbol\n\treadTimestamp\n\treadUndefined\n\treadElement\n\treadValue\n\twriteArray\n\twriteBinary\n\twriteBinaryWithSubtype\n\twriteBoolean\n\twriteCodeWithScope\n\twriteDBPointer\n\twriteDateTime\n\twriteDecimal128\n\twriteDouble\n\twriteInt32\n\twriteInt64\n\twriteJavascript\n\twriteMaxKey\n\twriteMinKey\n\twriteNull\n\twriteObjectID\n\twriteRegex\n\twriteString\n\twriteDocument\n\twriteSymbol\n\twriteTimestamp\n\twriteUndefined\n\twriteDocumentElement\n\twriteDocumentEnd\n\twriteArrayElement\n\twriteArrayEnd\n\tskip\n)\n\nfunc (i invoked) String() string {\n\tswitch i {\n\tcase nothing:\n\t\treturn \"Nothing\"\n\tcase readArray:\n\t\treturn \"ReadArray\"\n\tcase readBinary:\n\t\treturn \"ReadBinary\"\n\tcase readBoolean:\n\t\treturn \"ReadBoolean\"\n\tcase readDocument:\n\t\treturn \"ReadDocument\"\n\tcase readCodeWithScope:\n\t\treturn \"ReadCodeWithScope\"\n\tcase readDBPointer:\n\t\treturn \"ReadDBPointer\"\n\tcase readDateTime:\n\t\treturn \"ReadDateTime\"\n\tcase readDecimal128:\n\t\treturn \"ReadDecimal128\"\n\tcase readDouble:\n\t\treturn \"ReadDouble\"\n\tcase readInt32:\n\t\treturn \"ReadInt32\"\n\tcase readInt64:\n\t\treturn \"ReadInt64\"\n\tcase readJavascript:\n\t\treturn \"ReadJavascript\"\n\tcase readMaxKey:\n\t\treturn \"ReadMaxKey\"\n\tcase readMinKey:\n\t\treturn \"ReadMinKey\"\n\tcase readNull:\n\t\treturn \"ReadNull\"\n\tcase readObjectID:\n\t\treturn \"ReadObjectID\"\n\tcase readRegex:\n\t\treturn \"ReadRegex\"\n\tcase readString:\n\t\treturn \"ReadString\"\n\tcase readSymbol:\n\t\treturn \"ReadSymbol\"\n\tcase readTimestamp:\n\t\treturn \"ReadTimestamp\"\n\tcase readUndefined:\n\t\treturn \"ReadUndefined\"\n\tcase readElement:\n\t\treturn \"ReadElement\"\n\tcase readValue:\n\t\treturn \"ReadValue\"\n\tcase writeArray:\n\t\treturn \"WriteArray\"\n\tcase writeBinary:\n\t\treturn \"WriteBinary\"\n\tcase writeBinaryWithSubtype:\n\t\treturn \"WriteBinaryWithSubtype\"\n\tcase writeBoolean:\n\t\treturn \"WriteBoolean\"\n\tcase writeCodeWithScope:\n\t\treturn \"WriteCodeWithScope\"\n\tcase writeDBPointer:\n\t\treturn \"WriteDBPointer\"\n\tcase writeDateTime:\n\t\treturn \"WriteDateTime\"\n\tcase writeDecimal128:\n\t\treturn \"WriteDecimal128\"\n\tcase writeDouble:\n\t\treturn \"WriteDouble\"\n\tcase writeInt32:\n\t\treturn \"WriteInt32\"\n\tcase writeInt64:\n\t\treturn \"WriteInt64\"\n\tcase writeJavascript:\n\t\treturn \"WriteJavascript\"\n\tcase writeMaxKey:\n\t\treturn \"WriteMaxKey\"\n\tcase writeMinKey:\n\t\treturn \"WriteMinKey\"\n\tcase writeNull:\n\t\treturn \"WriteNull\"\n\tcase writeObjectID:\n\t\treturn \"WriteObjectID\"\n\tcase writeRegex:\n\t\treturn \"WriteRegex\"\n\tcase writeString:\n\t\treturn \"WriteString\"\n\tcase writeDocument:\n\t\treturn \"WriteDocument\"\n\tcase writeSymbol:\n\t\treturn \"WriteSymbol\"\n\tcase writeTimestamp:\n\t\treturn \"WriteTimestamp\"\n\tcase writeUndefined:\n\t\treturn \"WriteUndefined\"\n\tcase writeDocumentElement:\n\t\treturn \"WriteDocumentElement\"\n\tcase writeDocumentEnd:\n\t\treturn \"WriteDocumentEnd\"\n\tcase writeArrayElement:\n\t\treturn \"WriteArrayElement\"\n\tcase writeArrayEnd:\n\t\treturn \"WriteArrayEnd\"\n\tdefault:\n\t\treturn \"\"\n\t}\n}\n\n// valueReaderWriter is a test implementation of a bsonrw.ValueReader and bsonrw.ValueWriter\ntype valueReaderWriter struct {\n\tT *testing.T\n\tinvoked invoked\n\tReturn any // Can be a primitive or a bsoncore.Value\n\tBSONType Type\n\tErr error\n\tErrAfter invoked // error after this method is called\n\tdepth uint64\n}\n\n// prevent infinite recursion.\nfunc (llvrw *valueReaderWriter) checkdepth() {\n\tllvrw.depth++\n\tif llvrw.depth > 1000 {\n\t\tpanic(\"max depth exceeded\")\n\t}\n}\n\n// Type implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) Type() Type {\n\tllvrw.checkdepth()\n\treturn llvrw.BSONType\n}\n\n// Skip implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) Skip() error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = skip\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// ReadArray implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadArray() (ArrayReader, error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readArray\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn nil, llvrw.Err\n\t}\n\n\treturn llvrw, nil\n}\n\n// ReadBinary implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadBinary() (b []byte, btype byte, err error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readBinary\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn nil, 0x00, llvrw.Err\n\t}\n\n\tswitch tt := llvrw.Return.(type) {\n\tcase bsoncore.Value:\n\t\tsubtype, data, _, ok := bsoncore.ReadBinary(tt.Data)\n\t\tif !ok {\n\t\t\tllvrw.T.Error(\"Invalid Value provided for return value of ReadBinary.\")\n\t\t\treturn nil, 0x00, nil\n\t\t}\n\t\treturn data, subtype, nil\n\tdefault:\n\t\tllvrw.T.Errorf(\"Incorrect type provided for return value of ReadBinary: %T\", llvrw.Return)\n\t\treturn nil, 0x00, nil\n\t}\n}\n\n// ReadBoolean implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadBoolean() (bool, error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readBoolean\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn false, llvrw.Err\n\t}\n\n\tswitch tt := llvrw.Return.(type) {\n\tcase bool:\n\t\treturn tt, nil\n\tcase bsoncore.Value:\n\t\tb, _, ok := bsoncore.ReadBoolean(tt.Data)\n\t\tif !ok {\n\t\t\tllvrw.T.Error(\"Invalid Value provided for return value of ReadBoolean.\")\n\t\t\treturn false, nil\n\t\t}\n\t\treturn b, nil\n\tdefault:\n\t\tllvrw.T.Errorf(\"Incorrect type provided for return value of ReadBoolean: %T\", llvrw.Return)\n\t\treturn false, nil\n\t}\n}\n\n// ReadDocument implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadDocument() (DocumentReader, error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readDocument\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn nil, llvrw.Err\n\t}\n\n\treturn llvrw, nil\n}\n\n// ReadCodeWithScope implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadCodeWithScope() (code string, dr DocumentReader, err error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readCodeWithScope\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn \"\", nil, llvrw.Err\n\t}\n\n\treturn \"\", llvrw, nil\n}\n\n// ReadDBPointer implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadDBPointer() (ns string, oid ObjectID, err error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readDBPointer\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn \"\", ObjectID{}, llvrw.Err\n\t}\n\n\tswitch tt := llvrw.Return.(type) {\n\tcase bsoncore.Value:\n\t\tns, oid, _, ok := bsoncore.ReadDBPointer(tt.Data)\n\t\tif !ok {\n\t\t\tllvrw.T.Error(\"Invalid Value instance provided for return value of ReadDBPointer\")\n\t\t\treturn \"\", ObjectID{}, nil\n\t\t}\n\t\treturn ns, oid, nil\n\tdefault:\n\t\tllvrw.T.Errorf(\"Incorrect type provided for return value of ReadDBPointer: %T\", llvrw.Return)\n\t\treturn \"\", ObjectID{}, nil\n\t}\n}\n\n// ReadDateTime implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadDateTime() (int64, error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readDateTime\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn 0, llvrw.Err\n\t}\n\n\tdt, ok := llvrw.Return.(int64)\n\tif !ok {\n\t\tllvrw.T.Errorf(\"Incorrect type provided for return value of ReadDateTime: %T\", llvrw.Return)\n\t\treturn 0, nil\n\t}\n\n\treturn dt, nil\n}\n\n// ReadDecimal128 implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadDecimal128() (Decimal128, error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readDecimal128\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn Decimal128{}, llvrw.Err\n\t}\n\n\td128, ok := llvrw.Return.(Decimal128)\n\tif !ok {\n\t\tllvrw.T.Errorf(\"Incorrect type provided for return value of ReadDecimal128: %T\", llvrw.Return)\n\t\treturn Decimal128{}, nil\n\t}\n\n\treturn d128, nil\n}\n\n// ReadDouble implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadDouble() (float64, error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readDouble\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn 0, llvrw.Err\n\t}\n\n\tf64, ok := llvrw.Return.(float64)\n\tif !ok {\n\t\tllvrw.T.Errorf(\"Incorrect type provided for return value of ReadDouble: %T\", llvrw.Return)\n\t\treturn 0, nil\n\t}\n\n\treturn f64, nil\n}\n\n// ReadInt32 implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadInt32() (int32, error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readInt32\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn 0, llvrw.Err\n\t}\n\n\ti32, ok := llvrw.Return.(int32)\n\tif !ok {\n\t\tllvrw.T.Errorf(\"Incorrect type provided for return value of ReadInt32: %T\", llvrw.Return)\n\t\treturn 0, nil\n\t}\n\n\treturn i32, nil\n}\n\n// ReadInt64 implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadInt64() (int64, error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readInt64\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn 0, llvrw.Err\n\t}\n\ti64, ok := llvrw.Return.(int64)\n\tif !ok {\n\t\tllvrw.T.Errorf(\"Incorrect type provided for return value of ReadInt64: %T\", llvrw.Return)\n\t\treturn 0, nil\n\t}\n\n\treturn i64, nil\n}\n\n// ReadJavascript implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadJavascript() (code string, err error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readJavascript\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn \"\", llvrw.Err\n\t}\n\tjs, ok := llvrw.Return.(string)\n\tif !ok {\n\t\tllvrw.T.Errorf(\"Incorrect type provided for return value of ReadJavascript: %T\", llvrw.Return)\n\t\treturn \"\", nil\n\t}\n\n\treturn js, nil\n}\n\n// ReadMaxKey implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadMaxKey() error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readMaxKey\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\n\treturn nil\n}\n\n// ReadMinKey implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadMinKey() error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readMinKey\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\n\treturn nil\n}\n\n// ReadNull implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadNull() error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readNull\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\n\treturn nil\n}\n\n// ReadObjectID implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadObjectID() (ObjectID, error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readObjectID\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn ObjectID{}, llvrw.Err\n\t}\n\toid, ok := llvrw.Return.(ObjectID)\n\tif !ok {\n\t\tllvrw.T.Errorf(\"Incorrect type provided for return value of ReadObjectID: %T\", llvrw.Return)\n\t\treturn ObjectID{}, nil\n\t}\n\n\treturn oid, nil\n}\n\n// ReadRegex implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadRegex() (pattern string, options string, err error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readRegex\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn \"\", \"\", llvrw.Err\n\t}\n\tswitch tt := llvrw.Return.(type) {\n\tcase bsoncore.Value:\n\t\tpattern, options, _, ok := bsoncore.ReadRegex(tt.Data)\n\t\tif !ok {\n\t\t\tllvrw.T.Error(\"Invalid Value instance provided for ReadRegex\")\n\t\t\treturn \"\", \"\", nil\n\t\t}\n\t\treturn pattern, options, nil\n\tdefault:\n\t\tllvrw.T.Errorf(\"Incorrect type provided for return value of ReadRegex: %T\", llvrw.Return)\n\t\treturn \"\", \"\", nil\n\t}\n}\n\n// ReadString implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadString() (string, error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readString\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn \"\", llvrw.Err\n\t}\n\tstr, ok := llvrw.Return.(string)\n\tif !ok {\n\t\tllvrw.T.Errorf(\"Incorrect type provided for return value of ReadString: %T\", llvrw.Return)\n\t\treturn \"\", nil\n\t}\n\n\treturn str, nil\n}\n\n// ReadSymbol implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadSymbol() (symbol string, err error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readSymbol\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn \"\", llvrw.Err\n\t}\n\tswitch tt := llvrw.Return.(type) {\n\tcase string:\n\t\treturn tt, nil\n\tcase bsoncore.Value:\n\t\tsymbol, _, ok := bsoncore.ReadSymbol(tt.Data)\n\t\tif !ok {\n\t\t\tllvrw.T.Error(\"Invalid Value instance provided for ReadSymbol\")\n\t\t\treturn \"\", nil\n\t\t}\n\t\treturn symbol, nil\n\tdefault:\n\t\tllvrw.T.Errorf(\"Incorrect type provided for return value of ReadSymbol: %T\", llvrw.Return)\n\t\treturn \"\", nil\n\t}\n}\n\n// ReadTimestamp implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadTimestamp() (t uint32, i uint32, err error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readTimestamp\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn 0, 0, llvrw.Err\n\t}\n\tswitch tt := llvrw.Return.(type) {\n\tcase bsoncore.Value:\n\t\tt, i, _, ok := bsoncore.ReadTimestamp(tt.Data)\n\t\tif !ok {\n\t\t\tllvrw.T.Errorf(\"Invalid Value instance provided for return value of ReadTimestamp\")\n\t\t\treturn 0, 0, nil\n\t\t}\n\t\treturn t, i, nil\n\tdefault:\n\t\tllvrw.T.Errorf(\"Incorrect type provided for return value of ReadTimestamp: %T\", llvrw.Return)\n\t\treturn 0, 0, nil\n\t}\n}\n\n// ReadUndefined implements the ValueReader interface.\nfunc (llvrw *valueReaderWriter) ReadUndefined() error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readUndefined\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\n\treturn nil\n}\n\n// WriteArray implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteArray() (ArrayWriter, error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeArray\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn nil, llvrw.Err\n\t}\n\treturn llvrw, nil\n}\n\n// WriteBinary implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteBinary([]byte) error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeBinary\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteBinaryWithSubtype implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteBinaryWithSubtype([]byte, byte) error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeBinaryWithSubtype\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteBoolean implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteBoolean(bool) error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeBoolean\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteCodeWithScope implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteCodeWithScope(string) (DocumentWriter, error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeCodeWithScope\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn nil, llvrw.Err\n\t}\n\treturn llvrw, nil\n}\n\n// WriteDBPointer implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteDBPointer(string, ObjectID) error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeDBPointer\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteDateTime implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteDateTime(int64) error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeDateTime\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteDecimal128 implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteDecimal128(Decimal128) error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeDecimal128\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteDouble implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteDouble(float64) error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeDouble\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteInt32 implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteInt32(int32) error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeInt32\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteInt64 implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteInt64(int64) error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeInt64\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteJavascript implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteJavascript(string) error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeJavascript\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteMaxKey implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteMaxKey() error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeMaxKey\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteMinKey implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteMinKey() error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeMinKey\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteNull implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteNull() error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeNull\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteObjectID implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteObjectID(ObjectID) error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeObjectID\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteRegex implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteRegex(string, string) error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeRegex\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteString implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteString(string) error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeString\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteDocument implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteDocument() (DocumentWriter, error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeDocument\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn nil, llvrw.Err\n\t}\n\treturn llvrw, nil\n}\n\n// WriteSymbol implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteSymbol(string) error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeSymbol\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteTimestamp implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteTimestamp(uint32, uint32) error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeTimestamp\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// WriteUndefined implements the ValueWriter interface.\nfunc (llvrw *valueReaderWriter) WriteUndefined() error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeUndefined\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\treturn nil\n}\n\n// ReadElement implements the DocumentReader interface.\nfunc (llvrw *valueReaderWriter) ReadElement() (string, ValueReader, error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readElement\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn \"\", nil, llvrw.Err\n\t}\n\n\treturn \"\", llvrw, nil\n}\n\n// WriteDocumentElement implements the DocumentWriter interface.\nfunc (llvrw *valueReaderWriter) WriteDocumentElement(string) (ValueWriter, error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeDocumentElement\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn nil, llvrw.Err\n\t}\n\n\treturn llvrw, nil\n}\n\n// WriteDocumentEnd implements the DocumentWriter interface.\nfunc (llvrw *valueReaderWriter) WriteDocumentEnd() error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeDocumentEnd\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\n\treturn nil\n}\n\n// ReadValue implements the ArrayReader interface.\nfunc (llvrw *valueReaderWriter) ReadValue() (ValueReader, error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = readValue\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn nil, llvrw.Err\n\t}\n\n\treturn llvrw, nil\n}\n\n// WriteArrayElement implements the ArrayWriter interface.\nfunc (llvrw *valueReaderWriter) WriteArrayElement() (ValueWriter, error) {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeArrayElement\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn nil, llvrw.Err\n\t}\n\n\treturn llvrw, nil\n}\n\n// WriteArrayEnd implements the ArrayWriter interface.\nfunc (llvrw *valueReaderWriter) WriteArrayEnd() error {\n\tllvrw.checkdepth()\n\tllvrw.invoked = writeArrayEnd\n\tif llvrw.ErrAfter == llvrw.invoked {\n\t\treturn llvrw.Err\n\t}\n\n\treturn nil\n}\n" }, { "path": "bson/buffered_byte_src.go", "content": "// Copyright (C) MongoDB, Inc. 2025-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"bytes\"\n\t\"io\"\n)\n\n// bufferedByteSrc implements the low-level byteSrc interface by reading\n// directly from an in-memory byte slice. It provides efficient, zero-copy\n// access for parsing BSON when the entire document is buffered in memory.\ntype bufferedByteSrc struct {\n\tbuf []byte // entire BSON document\n\toffset int64 // Current read index into buf\n}\n\nvar _ byteSrc = (*bufferedByteSrc)(nil)\n\n// Read reads up to len(p) bytes from the in-memory buffer, advancing the offset\n// by the number of bytes read.\nfunc (b *bufferedByteSrc) readExact(p []byte) (int, error) {\n\tif b.offset >= int64(len(b.buf)) {\n\t\treturn 0, io.EOF\n\t}\n\tn := copy(p, b.buf[b.offset:])\n\tb.offset += int64(n)\n\treturn n, nil\n}\n\n// ReadByte returns the single byte at buf[offset] and advances offset by 1.\nfunc (b *bufferedByteSrc) ReadByte() (byte, error) {\n\tif b.offset >= int64(len(b.buf)) {\n\t\treturn 0, io.EOF\n\t}\n\tb.offset++\n\treturn b.buf[b.offset-1], nil\n}\n\n// peek returns buf[offset:offset+n] without advancing offset.\nfunc (b *bufferedByteSrc) peek(n int) ([]byte, error) {\n\t// Ensure we don't read past the end of the buffer.\n\tif int64(n)+b.offset > int64(len(b.buf)) {\n\t\treturn b.buf[b.offset:], io.EOF\n\t}\n\n\t// Return the next n bytes without advancing the offset\n\treturn b.buf[b.offset : b.offset+int64(n)], nil\n}\n\n// discard advances offset by n bytes, returning the number of bytes discarded.\nfunc (b *bufferedByteSrc) discard(n int) (int, error) {\n\t// Ensure we don't read past the end of the buffer.\n\tif int64(n)+b.offset > int64(len(b.buf)) {\n\t\t// If we have exceeded the buffer length, discard only up to the end.\n\t\tleft := len(b.buf) - int(b.offset)\n\t\tb.offset = int64(len(b.buf))\n\n\t\treturn left, io.EOF\n\t}\n\n\t// Advance the read position\n\tb.offset += int64(n)\n\treturn n, nil\n}\n\n// readSlice reads buf[offset:] for the first occurrence of delim, returning\n// buf[offset:idx+1], and advances offset past it; errors if delim not found.\nfunc (b *bufferedByteSrc) readSlice(delim byte) ([]byte, error) {\n\t// Ensure we don't read past the end of the buffer.\n\tif b.offset >= int64(len(b.buf)) {\n\t\treturn nil, io.EOF\n\t}\n\n\t// Look for the delimiter in the remaining bytes\n\trem := b.buf[b.offset:]\n\tidx := bytes.IndexByte(rem, delim)\n\tif idx < 0 {\n\t\treturn nil, io.EOF\n\t}\n\n\t// Build the result slice up through the delimiter.\n\tresult := rem[:idx+1]\n\n\t// Advance the offset past the delimiter.\n\tb.offset += int64(idx + 1)\n\n\treturn result, nil\n}\n\n// pos returns the current read position in the buffer.\nfunc (b *bufferedByteSrc) pos() int64 {\n\treturn b.offset\n}\n\n// regexLength will return the total byte length of a BSON regex value.\nfunc (b *bufferedByteSrc) regexLength() (int32, error) {\n\trem := b.buf[b.offset:]\n\n\t// Find end of the first C-string (pattern).\n\ti := bytes.IndexByte(rem, 0x00)\n\tif i < 0 {\n\t\treturn 0, io.EOF\n\t}\n\n\t// Find end of second C-string (options).\n\tj := bytes.IndexByte(rem[i+1:], 0x00)\n\tif j < 0 {\n\t\treturn 0, io.EOF\n\t}\n\n\t// Total length = first C-string length (pattern) + second C-string length\n\t// (options) + 2 null terminators\n\treturn int32(i + j + 2), nil\n}\n\nfunc (*bufferedByteSrc) streamable() bool {\n\treturn false\n}\n\nfunc (b *bufferedByteSrc) reset() {\n\tb.buf = nil\n\tb.offset = 0\n}\n" }, { "path": "bson/buffered_byte_src_test.go", "content": "// Copyright (C) MongoDB, Inc. 2025-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"bytes\"\n\t\"io\"\n\t\"testing\"\n\n\t\"go.mongodb.org/mongo-driver/v2/internal/assert\"\n\t\"go.mongodb.org/mongo-driver/v2/internal/require\"\n)\n\nfunc TestBufferedvalueReader_discard(t *testing.T) {\n\ttests := []struct {\n\t\tname string\n\t\tbuf []byte\n\t\tn int\n\t\twant int\n\t\twantOffset int64\n\t\twantErr error\n\t}{\n\t\t{\n\t\t\tname: \"nothing\",\n\t\t\tbuf: bytes.Repeat([]byte(\"a\"), 1024),\n\t\t\tn: 0,\n\t\t\twant: 0,\n\t\t\twantOffset: 0,\n\t\t\twantErr: nil,\n\t\t},\n\t\t{\n\t\t\tname: \"amount less than buffer size\",\n\t\t\tbuf: bytes.Repeat([]byte(\"a\"), 1024),\n\t\t\tn: 100,\n\t\t\twant: 100,\n\t\t\twantOffset: 100,\n\t\t\twantErr: nil,\n\t\t},\n\t\t{\n\t\t\tname: \"amount greater than buffer size\",\n\t\t\tbuf: bytes.Repeat([]byte(\"a\"), 1024),\n\t\t\tn: 10000,\n\t\t\twant: 1024,\n\t\t\twantOffset: 1024,\n\t\t\twantErr: io.EOF,\n\t\t},\n\t\t{\n\t\t\tname: \"exact buffer size\",\n\t\t\tbuf: bytes.Repeat([]byte(\"a\"), 1024),\n\t\t\tn: 1024,\n\t\t\twant: 1024,\n\t\t\twantOffset: 1024,\n\t\t\twantErr: nil,\n\t\t},\n\t\t{\n\t\t\tname: \"from empty buffer\",\n\t\t\tbuf: []byte{},\n\t\t\tn: 10,\n\t\t\twant: 0,\n\t\t\twantOffset: 0,\n\t\t\twantErr: io.EOF,\n\t\t},\n\t}\n\n\tfor _, tt := range tests {\n\t\tt.Run(tt.name, func(t *testing.T) {\n\t\t\treader := &bufferedByteSrc{buf: tt.buf, offset: 0}\n\t\t\tn, err := reader.discard(tt.n)\n\t\t\tif tt.wantErr != nil {\n\t\t\t\tassert.ErrorIs(t, err, tt.wantErr, \"Expected error %v, got %v\", tt.wantErr, err)\n\t\t\t} else {\n\t\t\t\trequire.NoError(t, err, \"Expected no error when discarding %d bytes\", tt.n)\n\t\t\t}\n\n\t\t\tassert.Equal(t, tt.want, n, \"Expected to discard %d bytes, got %d\", tt.want, n)\n\t\t\tassert.Equal(t, tt.wantOffset, reader.offset, \"Expected offset to be %d, got %d\", tt.wantOffset, reader.offset)\n\t\t})\n\t}\n}\n\nfunc TestBufferedvalueReader_peek(t *testing.T) {\n\ttests := []struct {\n\t\tname string\n\t\tbuf []byte\n\t\tn int\n\t\toffset int64\n\t\twant []byte\n\t\twantErr error\n\t}{\n\t\t{\n\t\t\tname: \"nothing\",\n\t\t\tbuf: bytes.Repeat([]byte(\"a\"), 1024),\n\t\t\tn: 0,\n\t\t\twant: []byte{},\n\t\t\twantErr: nil,\n\t\t},\n\t\t{\n\t\t\tname: \"amount less than buffer size\",\n\t\t\tbuf: bytes.Repeat([]byte(\"a\"), 1024),\n\t\t\tn: 100,\n\t\t\twant: bytes.Repeat([]byte(\"a\"), 100),\n\t\t\twantErr: nil,\n\t\t},\n\t\t{\n\t\t\tname: \"amount greater than buffer size\",\n\t\t\tbuf: bytes.Repeat([]byte(\"a\"), 1024),\n\t\t\tn: 10000,\n\t\t\twant: bytes.Repeat([]byte(\"a\"), 1024),\n\t\t\twantErr: io.EOF,\n\t\t},\n\t\t{\n\t\t\tname: \"exact buffer size\",\n\t\t\tbuf: bytes.Repeat([]byte(\"a\"), 1024),\n\t\t\tn: 1024,\n\t\t\twant: bytes.Repeat([]byte(\"a\"), 1024),\n\t\t\twantErr: nil,\n\t\t},\n\t\t{\n\t\t\tname: \"from empty buffer\",\n\t\t\tbuf: []byte{},\n\t\t\tn: 10,\n\t\t\twant: []byte{},\n\t\t\twantErr: io.EOF,\n\t\t},\n\t\t{\n\t\t\tname: \"peek with offset\",\n\t\t\tbuf: append(bytes.Repeat([]byte(\"a\"), 100), bytes.Repeat([]byte(\"b\"), 100)...),\n\t\t\toffset: 100,\n\t\t\tn: 100,\n\t\t\twant: bytes.Repeat([]byte(\"b\"), 100),\n\t\t\twantErr: nil,\n\t\t},\n\t}\n\n\tfor _, tt := range tests {\n\t\tt.Run(tt.name, func(t *testing.T) {\n\t\t\treader := &bufferedByteSrc{buf: tt.buf, offset: tt.offset}\n\t\t\tn, err := reader.peek(tt.n)\n\t\t\tif tt.wantErr != nil {\n\t\t\t\tassert.ErrorIs(t, err, tt.wantErr, \"Expected error %v, got %v\", tt.wantErr, err)\n\t\t\t} else {\n\t\t\t\trequire.NoError(t, err, \"Expected no error when peeking %d bytes\", tt.n)\n\t\t\t}\n\n\t\t\tassert.Equal(t, tt.want, n, \"Expected to peek %d bytes, got %d\", len(tt.want), len(n))\n\t\t\tassert.Equal(t, tt.offset, reader.offset, \"Expected offset to be %d, got %d\", tt.offset, reader.offset)\n\t\t})\n\t}\n}\n" }, { "path": "bson/byte_slice_codec.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"fmt\"\n\t\"reflect\"\n)\n\n// byteSliceCodec is the Codec used for []byte values.\ntype byteSliceCodec struct {\n\t// encodeNilAsEmpty causes EncodeValue to marshal nil Go byte slices as empty BSON binary values\n\t// instead of BSON null.\n\tencodeNilAsEmpty bool\n}\n\n// Assert that byteSliceCodec satisfies the typeDecoder interface, which allows it to be\n// used by collection type decoders (e.g. map, slice, etc) to set individual values in a\n// collection.\nvar _ typeDecoder = &byteSliceCodec{}\n\n// EncodeValue is the ValueEncoder for []byte.\nfunc (bsc *byteSliceCodec) EncodeValue(ec EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tByteSlice {\n\t\treturn ValueEncoderError{Name: \"ByteSliceEncodeValue\", Types: []reflect.Type{tByteSlice}, Received: val}\n\t}\n\tif val.IsNil() && !bsc.encodeNilAsEmpty && !ec.nilByteSliceAsEmpty {\n\t\treturn vw.WriteNull()\n\t}\n\treturn vw.WriteBinary(val.Interface().([]byte))\n}\n\nfunc (bsc *byteSliceCodec) decodeType(_ DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tByteSlice {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"ByteSliceDecodeValue\",\n\t\t\tTypes: []reflect.Type{tByteSlice},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\tvar data []byte\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeString:\n\t\tstr, err := vr.ReadString()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\t\tdata = []byte(str)\n\tcase TypeSymbol:\n\t\tsym, err := vr.ReadSymbol()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\t\tdata = []byte(sym)\n\tcase TypeBinary:\n\t\tvar subtype byte\n\t\tdata, subtype, err = vr.ReadBinary()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\t\tif subtype != TypeBinaryGeneric && subtype != TypeBinaryBinaryOld {\n\t\t\treturn emptyValue, decodeBinaryError{subtype: subtype, typeName: \"[]byte\"}\n\t\t}\n\tcase TypeNull:\n\t\terr = vr.ReadNull()\n\tcase TypeUndefined:\n\t\terr = vr.ReadUndefined()\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into a []byte\", vrType)\n\t}\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\treturn reflect.ValueOf(data), nil\n}\n\n// DecodeValue is the ValueDecoder for []byte.\nfunc (bsc *byteSliceCodec) DecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tByteSlice {\n\t\treturn ValueDecoderError{Name: \"ByteSliceDecodeValue\", Types: []reflect.Type{tByteSlice}, Received: val}\n\t}\n\n\telem, err := bsc.decodeType(dc, vr, tByteSlice)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.Set(elem)\n\treturn nil\n}\n" }, { "path": "bson/codec_cache.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"reflect\"\n\t\"sync\"\n\t\"sync/atomic\"\n)\n\n// Runtime check that the kind encoder and decoder caches can store any valid\n// reflect.Kind constant.\nfunc init() {\n\tif s := reflect.Kind(len(kindEncoderCache{}.entries)).String(); s != \"kind27\" {\n\t\tpanic(\"The capacity of kindEncoderCache is too small.\\n\" +\n\t\t\t\"This is due to a new type being added to reflect.Kind.\")\n\t}\n}\n\n// statically assert array size\nvar (\n\t_ = (kindEncoderCache{}).entries[reflect.UnsafePointer]\n\t_ = (kindDecoderCache{}).entries[reflect.UnsafePointer]\n)\n\ntype typeEncoderCache struct {\n\tcache sync.Map // map[reflect.Type]ValueEncoder\n}\n\nfunc (c *typeEncoderCache) Store(rt reflect.Type, enc ValueEncoder) {\n\tc.cache.Store(rt, enc)\n}\n\nfunc (c *typeEncoderCache) Load(rt reflect.Type) (ValueEncoder, bool) {\n\tif v, _ := c.cache.Load(rt); v != nil {\n\t\treturn v.(ValueEncoder), true\n\t}\n\treturn nil, false\n}\n\nfunc (c *typeEncoderCache) LoadOrStore(rt reflect.Type, enc ValueEncoder) ValueEncoder {\n\tif v, loaded := c.cache.LoadOrStore(rt, enc); loaded {\n\t\tenc = v.(ValueEncoder)\n\t}\n\treturn enc\n}\n\nfunc (c *typeEncoderCache) Clone() *typeEncoderCache {\n\tcc := new(typeEncoderCache)\n\tc.cache.Range(func(k, v any) bool {\n\t\tif k != nil && v != nil {\n\t\t\tcc.cache.Store(k, v)\n\t\t}\n\t\treturn true\n\t})\n\treturn cc\n}\n\ntype typeDecoderCache struct {\n\tcache sync.Map // map[reflect.Type]ValueDecoder\n}\n\nfunc (c *typeDecoderCache) Store(rt reflect.Type, dec ValueDecoder) {\n\tc.cache.Store(rt, dec)\n}\n\nfunc (c *typeDecoderCache) Load(rt reflect.Type) (ValueDecoder, bool) {\n\tif v, _ := c.cache.Load(rt); v != nil {\n\t\treturn v.(ValueDecoder), true\n\t}\n\treturn nil, false\n}\n\nfunc (c *typeDecoderCache) LoadOrStore(rt reflect.Type, dec ValueDecoder) ValueDecoder {\n\tif v, loaded := c.cache.LoadOrStore(rt, dec); loaded {\n\t\tdec = v.(ValueDecoder)\n\t}\n\treturn dec\n}\n\nfunc (c *typeDecoderCache) Clone() *typeDecoderCache {\n\tcc := new(typeDecoderCache)\n\tc.cache.Range(func(k, v any) bool {\n\t\tif k != nil && v != nil {\n\t\t\tcc.cache.Store(k, v)\n\t\t}\n\t\treturn true\n\t})\n\treturn cc\n}\n\n// atomic.Value requires that all calls to Store() have the same concrete type\n// so we wrap the ValueEncoder with a kindEncoderCacheEntry to ensure the type\n// is always the same (since different concrete types may implement the\n// ValueEncoder interface).\ntype kindEncoderCacheEntry struct {\n\tenc ValueEncoder\n}\n\ntype kindEncoderCache struct {\n\tentries [reflect.UnsafePointer + 1]atomic.Value // *kindEncoderCacheEntry\n}\n\nfunc (c *kindEncoderCache) Store(rt reflect.Kind, enc ValueEncoder) {\n\tif enc != nil && rt < reflect.Kind(len(c.entries)) {\n\t\tc.entries[rt].Store(&kindEncoderCacheEntry{enc: enc})\n\t}\n}\n\nfunc (c *kindEncoderCache) Load(rt reflect.Kind) (ValueEncoder, bool) {\n\tif rt < reflect.Kind(len(c.entries)) {\n\t\tif ent, ok := c.entries[rt].Load().(*kindEncoderCacheEntry); ok {\n\t\t\treturn ent.enc, ent.enc != nil\n\t\t}\n\t}\n\treturn nil, false\n}\n\nfunc (c *kindEncoderCache) Clone() *kindEncoderCache {\n\tcc := new(kindEncoderCache)\n\tfor i, v := range c.entries {\n\t\tif val := v.Load(); val != nil {\n\t\t\tcc.entries[i].Store(val)\n\t\t}\n\t}\n\treturn cc\n}\n\n// atomic.Value requires that all calls to Store() have the same concrete type\n// so we wrap the ValueDecoder with a kindDecoderCacheEntry to ensure the type\n// is always the same (since different concrete types may implement the\n// ValueDecoder interface).\ntype kindDecoderCacheEntry struct {\n\tdec ValueDecoder\n}\n\ntype kindDecoderCache struct {\n\tentries [reflect.UnsafePointer + 1]atomic.Value // *kindDecoderCacheEntry\n}\n\nfunc (c *kindDecoderCache) Store(rt reflect.Kind, dec ValueDecoder) {\n\tif rt < reflect.Kind(len(c.entries)) {\n\t\tc.entries[rt].Store(&kindDecoderCacheEntry{dec: dec})\n\t}\n}\n\nfunc (c *kindDecoderCache) Load(rt reflect.Kind) (ValueDecoder, bool) {\n\tif rt < reflect.Kind(len(c.entries)) {\n\t\tif ent, ok := c.entries[rt].Load().(*kindDecoderCacheEntry); ok {\n\t\t\treturn ent.dec, ent.dec != nil\n\t\t}\n\t}\n\treturn nil, false\n}\n\nfunc (c *kindDecoderCache) Clone() *kindDecoderCache {\n\tcc := new(kindDecoderCache)\n\tfor i, v := range c.entries {\n\t\tif val := v.Load(); val != nil {\n\t\t\tcc.entries[i].Store(val)\n\t\t}\n\t}\n\treturn cc\n}\n" }, { "path": "bson/codec_cache_test.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"reflect\"\n\t\"strconv\"\n\t\"strings\"\n\t\"testing\"\n)\n\n// NB(charlie): the array size is a power of 2 because we use the remainder of\n// it (mod) in benchmarks and that is faster when the size is a power of 2.\nvar codecCacheTestTypes = [16]reflect.Type{\n\treflect.TypeOf(uint8(0)),\n\treflect.TypeOf(uint16(0)),\n\treflect.TypeOf(uint32(0)),\n\treflect.TypeOf(uint64(0)),\n\treflect.TypeOf(uint(0)),\n\treflect.TypeOf(uintptr(0)),\n\treflect.TypeOf(int8(0)),\n\treflect.TypeOf(int16(0)),\n\treflect.TypeOf(int32(0)),\n\treflect.TypeOf(int64(0)),\n\treflect.TypeOf(int(0)),\n\treflect.TypeOf(float32(0)),\n\treflect.TypeOf(float64(0)),\n\treflect.TypeOf(true),\n\treflect.TypeOf(struct{ A int }{}),\n\treflect.TypeOf(map[int]int{}),\n}\n\nfunc TestTypeCache(t *testing.T) {\n\trt := reflect.TypeOf(int(0))\n\tec := new(typeEncoderCache)\n\tdc := new(typeDecoderCache)\n\n\tcodec := new(fakeCodec)\n\tec.Store(rt, codec)\n\tdc.Store(rt, codec)\n\tif v, ok := ec.Load(rt); !ok || !reflect.DeepEqual(v, codec) {\n\t\tt.Errorf(\"Load(%s) = %v, %t; want: %v, %t\", rt, v, ok, codec, true)\n\t}\n\tif v, ok := dc.Load(rt); !ok || !reflect.DeepEqual(v, codec) {\n\t\tt.Errorf(\"Load(%s) = %v, %t; want: %v, %t\", rt, v, ok, codec, true)\n\t}\n\n\t// Make sure we overwrite the stored value with nil\n\tec.Store(rt, nil)\n\tdc.Store(rt, nil)\n\tif v, ok := ec.Load(rt); ok || v != nil {\n\t\tt.Errorf(\"Load(%s) = %v, %t; want: %v, %t\", rt, v, ok, nil, false)\n\t}\n\tif v, ok := dc.Load(rt); ok || v != nil {\n\t\tt.Errorf(\"Load(%s) = %v, %t; want: %v, %t\", rt, v, ok, nil, false)\n\t}\n}\n\nfunc TestTypeCacheClone(t *testing.T) {\n\tcodec := new(fakeCodec)\n\tec1 := new(typeEncoderCache)\n\tdc1 := new(typeDecoderCache)\n\tfor _, rt := range codecCacheTestTypes {\n\t\tec1.Store(rt, codec)\n\t\tdc1.Store(rt, codec)\n\t}\n\tec2 := ec1.Clone()\n\tdc2 := dc1.Clone()\n\tfor _, rt := range codecCacheTestTypes {\n\t\tif v, _ := ec2.Load(rt); !reflect.DeepEqual(v, codec) {\n\t\t\tt.Errorf(\"Load(%s) = %#v; want: %#v\", rt, v, codec)\n\t\t}\n\t\tif v, _ := dc2.Load(rt); !reflect.DeepEqual(v, codec) {\n\t\t\tt.Errorf(\"Load(%s) = %#v; want: %#v\", rt, v, codec)\n\t\t}\n\t}\n}\n\nfunc TestKindCacheArray(t *testing.T) {\n\t// Check array bounds\n\tvar c kindEncoderCache\n\tcodec := new(fakeCodec)\n\tc.Store(reflect.UnsafePointer, codec) // valid\n\tc.Store(reflect.UnsafePointer+1, codec) // ignored\n\tif v, ok := c.Load(reflect.UnsafePointer); !ok || v != codec {\n\t\tt.Errorf(\"Load(reflect.UnsafePointer) = %v, %t; want: %v, %t\", v, ok, codec, true)\n\t}\n\tif v, ok := c.Load(reflect.UnsafePointer + 1); ok || v != nil {\n\t\tt.Errorf(\"Load(reflect.UnsafePointer + 1) = %v, %t; want: %v, %t\", v, ok, nil, false)\n\t}\n\n\t// Make sure that reflect.UnsafePointer is the last/largest reflect.Type.\n\t//\n\t// The String() method of invalid reflect.Type types are of the format\n\t// \"kind{NUMBER}\".\n\tfor rt := reflect.UnsafePointer + 1; rt < reflect.UnsafePointer+16; rt++ {\n\t\ts := rt.String()\n\t\tif !strings.Contains(s, strconv.Itoa(int(rt))) {\n\t\t\tt.Errorf(\"reflect.Type(%d) appears to be valid: %q\", rt, s)\n\t\t}\n\t}\n}\n\nfunc TestKindCacheClone(t *testing.T) {\n\te1 := new(kindEncoderCache)\n\td1 := new(kindDecoderCache)\n\tcodec := new(fakeCodec)\n\tfor k := reflect.Invalid; k <= reflect.UnsafePointer; k++ {\n\t\te1.Store(k, codec)\n\t\td1.Store(k, codec)\n\t}\n\te2 := e1.Clone()\n\tfor k := reflect.Invalid; k <= reflect.UnsafePointer; k++ {\n\t\tv1, ok1 := e1.Load(k)\n\t\tv2, ok2 := e2.Load(k)\n\t\tif ok1 != ok2 || !reflect.DeepEqual(v1, v2) || v1 == nil || v2 == nil {\n\t\t\tt.Errorf(\"Encoder(%s): %#v, %t != %#v, %t\", k, v1, ok1, v2, ok2)\n\t\t}\n\t}\n\td2 := d1.Clone()\n\tfor k := reflect.Invalid; k <= reflect.UnsafePointer; k++ {\n\t\tv1, ok1 := d1.Load(k)\n\t\tv2, ok2 := d2.Load(k)\n\t\tif ok1 != ok2 || !reflect.DeepEqual(v1, v2) || v1 == nil || v2 == nil {\n\t\t\tt.Errorf(\"Decoder(%s): %#v, %t != %#v, %t\", k, v1, ok1, v2, ok2)\n\t\t}\n\t}\n}\n\nfunc TestKindCacheEncoderNilEncoder(t *testing.T) {\n\tt.Run(\"Encoder\", func(t *testing.T) {\n\t\tc := new(kindEncoderCache)\n\t\tc.Store(reflect.Invalid, ValueEncoder(nil))\n\t\tv, ok := c.Load(reflect.Invalid)\n\t\tif v != nil || ok {\n\t\t\tt.Errorf(\"Load of nil ValueEncoder should return: nil, false; got: %v, %t\", v, ok)\n\t\t}\n\t})\n\tt.Run(\"Decoder\", func(t *testing.T) {\n\t\tc := new(kindDecoderCache)\n\t\tc.Store(reflect.Invalid, ValueDecoder(nil))\n\t\tv, ok := c.Load(reflect.Invalid)\n\t\tif v != nil || ok {\n\t\t\tt.Errorf(\"Load of nil ValueDecoder should return: nil, false; got: %v, %t\", v, ok)\n\t\t}\n\t})\n}\n\nfunc BenchmarkEncoderCacheLoad(b *testing.B) {\n\tc := new(typeEncoderCache)\n\tcodec := new(fakeCodec)\n\ttyps := codecCacheTestTypes\n\tfor _, t := range typs {\n\t\tc.Store(t, codec)\n\t}\n\tb.RunParallel(func(pb *testing.PB) {\n\t\tfor i := 0; pb.Next(); i++ {\n\t\t\tc.Load(typs[i%len(typs)])\n\t\t}\n\t})\n}\n\nfunc BenchmarkEncoderCacheStore(b *testing.B) {\n\tc := new(typeEncoderCache)\n\tcodec := new(fakeCodec)\n\tb.RunParallel(func(pb *testing.PB) {\n\t\ttyps := codecCacheTestTypes\n\t\tfor i := 0; pb.Next(); i++ {\n\t\t\tc.Store(typs[i%len(typs)], codec)\n\t\t}\n\t})\n}\n" }, { "path": "bson/cond_addr_codec.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"reflect\"\n)\n\n// condAddrEncoder is the encoder used when a pointer to the encoding value has an encoder.\ntype condAddrEncoder struct {\n\tcanAddrEnc ValueEncoder\n\telseEnc ValueEncoder\n}\n\nvar _ ValueEncoder = &condAddrEncoder{}\n\n// newCondAddrEncoder returns an condAddrEncoder.\nfunc newCondAddrEncoder(canAddrEnc, elseEnc ValueEncoder) *condAddrEncoder {\n\tencoder := condAddrEncoder{canAddrEnc: canAddrEnc, elseEnc: elseEnc}\n\treturn &encoder\n}\n\n// EncodeValue is the ValueEncoderFunc for a value that may be addressable.\nfunc (cae *condAddrEncoder) EncodeValue(ec EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif val.CanAddr() {\n\t\treturn cae.canAddrEnc.EncodeValue(ec, vw, val)\n\t}\n\tif cae.elseEnc != nil {\n\t\treturn cae.elseEnc.EncodeValue(ec, vw, val)\n\t}\n\treturn errNoEncoder{Type: val.Type()}\n}\n\n// condAddrDecoder is the decoder used when a pointer to the value has a decoder.\ntype condAddrDecoder struct {\n\tcanAddrDec ValueDecoder\n\telseDec ValueDecoder\n}\n\nvar _ ValueDecoder = &condAddrDecoder{}\n\n// newCondAddrDecoder returns an CondAddrDecoder.\nfunc newCondAddrDecoder(canAddrDec, elseDec ValueDecoder) *condAddrDecoder {\n\tdecoder := condAddrDecoder{canAddrDec: canAddrDec, elseDec: elseDec}\n\treturn &decoder\n}\n\n// DecodeValue is the ValueDecoderFunc for a value that may be addressable.\nfunc (cad *condAddrDecoder) DecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif val.CanAddr() {\n\t\treturn cad.canAddrDec.DecodeValue(dc, vr, val)\n\t}\n\tif cad.elseDec != nil {\n\t\treturn cad.elseDec.DecodeValue(dc, vr, val)\n\t}\n\treturn errNoDecoder{Type: val.Type()}\n}\n" }, { "path": "bson/cond_addr_codec_test.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"reflect\"\n\t\"testing\"\n\n\t\"go.mongodb.org/mongo-driver/v2/internal/assert\"\n)\n\nfunc TestCondAddrCodec(t *testing.T) {\n\tvar inner int\n\tcanAddrVal := reflect.ValueOf(&inner)\n\taddressable := canAddrVal.Elem()\n\tunaddressable := reflect.ValueOf(inner)\n\trw := &valueReaderWriter{}\n\n\tt.Run(\"addressEncode\", func(t *testing.T) {\n\t\tinvoked := 0\n\t\tencode1 := ValueEncoderFunc(func(EncodeContext, ValueWriter, reflect.Value) error {\n\t\t\tinvoked = 1\n\t\t\treturn nil\n\t\t})\n\t\tencode2 := ValueEncoderFunc(func(EncodeContext, ValueWriter, reflect.Value) error {\n\t\t\tinvoked = 2\n\t\t\treturn nil\n\t\t})\n\t\tcondEncoder := newCondAddrEncoder(encode1, encode2)\n\n\t\ttestCases := []struct {\n\t\t\tname string\n\t\t\tval reflect.Value\n\t\t\tinvoked int\n\t\t}{\n\t\t\t{\"canAddr\", addressable, 1},\n\t\t\t{\"else\", unaddressable, 2},\n\t\t}\n\t\tfor _, tc := range testCases {\n\t\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\t\terr := condEncoder.EncodeValue(EncodeContext{}, rw, tc.val)\n\t\t\t\tassert.Nil(t, err, \"CondAddrEncoder error: %v\", err)\n\n\t\t\t\tassert.Equal(t, invoked, tc.invoked, \"Expected function %v to be called, called %v\", tc.invoked, invoked)\n\t\t\t})\n\t\t}\n\n\t\tt.Run(\"error\", func(t *testing.T) {\n\t\t\terrEncoder := newCondAddrEncoder(encode1, nil)\n\t\t\terr := errEncoder.EncodeValue(EncodeContext{}, rw, unaddressable)\n\t\t\twant := errNoEncoder{Type: unaddressable.Type()}\n\t\t\tassert.Equal(t, err, want, \"expected error %v, got %v\", want, err)\n\t\t})\n\t})\n\tt.Run(\"addressDecode\", func(t *testing.T) {\n\t\tinvoked := 0\n\t\tdecode1 := ValueDecoderFunc(func(DecodeContext, ValueReader, reflect.Value) error {\n\t\t\tinvoked = 1\n\t\t\treturn nil\n\t\t})\n\t\tdecode2 := ValueDecoderFunc(func(DecodeContext, ValueReader, reflect.Value) error {\n\t\t\tinvoked = 2\n\t\t\treturn nil\n\t\t})\n\t\tcondDecoder := newCondAddrDecoder(decode1, decode2)\n\n\t\ttestCases := []struct {\n\t\t\tname string\n\t\t\tval reflect.Value\n\t\t\tinvoked int\n\t\t}{\n\t\t\t{\"canAddr\", addressable, 1},\n\t\t\t{\"else\", unaddressable, 2},\n\t\t}\n\t\tfor _, tc := range testCases {\n\t\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\t\terr := condDecoder.DecodeValue(DecodeContext{}, rw, tc.val)\n\t\t\t\tassert.Nil(t, err, \"CondAddrDecoder error: %v\", err)\n\n\t\t\t\tassert.Equal(t, invoked, tc.invoked, \"Expected function %v to be called, called %v\", tc.invoked, invoked)\n\t\t\t})\n\t\t}\n\n\t\tt.Run(\"error\", func(t *testing.T) {\n\t\t\terrDecoder := newCondAddrDecoder(decode1, nil)\n\t\t\terr := errDecoder.DecodeValue(DecodeContext{}, rw, unaddressable)\n\t\t\twant := errNoDecoder{Type: unaddressable.Type()}\n\t\t\tassert.Equal(t, err, want, \"expected error %v, got %v\", want, err)\n\t\t})\n\t})\n}\n" }, { "path": "bson/copier.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"errors\"\n\t\"fmt\"\n\t\"io\"\n\n\t\"go.mongodb.org/mongo-driver/v2/x/bsonx/bsoncore\"\n)\n\n// copyDocument handles copying one document from the src to the dst.\nfunc copyDocument(dst ValueWriter, src ValueReader) error {\n\tdr, err := src.ReadDocument()\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tdw, err := dst.WriteDocument()\n\tif err != nil {\n\t\treturn err\n\t}\n\n\treturn copyDocumentCore(dw, dr)\n}\n\n// copyArrayFromBytes copies the values from a BSON array represented as a\n// []byte to a ValueWriter.\nfunc copyArrayFromBytes(dst ValueWriter, src []byte) error {\n\taw, err := dst.WriteArray()\n\tif err != nil {\n\t\treturn err\n\t}\n\n\terr = copyBytesToArrayWriter(aw, src)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\treturn aw.WriteArrayEnd()\n}\n\n// copyDocumentFromBytes copies the values from a BSON document represented as a\n// []byte to a ValueWriter.\nfunc copyDocumentFromBytes(dst ValueWriter, src []byte) error {\n\tdw, err := dst.WriteDocument()\n\tif err != nil {\n\t\treturn err\n\t}\n\n\terr = copyBytesToDocumentWriter(dw, src)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\treturn dw.WriteDocumentEnd()\n}\n\ntype writeElementFn func(key string) (ValueWriter, error)\n\n// copyBytesToArrayWriter copies the values from a BSON Array represented as a []byte to an\n// ArrayWriter.\nfunc copyBytesToArrayWriter(dst ArrayWriter, src []byte) error {\n\twef := func(_ string) (ValueWriter, error) {\n\t\treturn dst.WriteArrayElement()\n\t}\n\n\treturn copyBytesToValueWriter(src, wef)\n}\n\n// copyBytesToDocumentWriter copies the values from a BSON document represented as a []byte to a\n// DocumentWriter.\nfunc copyBytesToDocumentWriter(dst DocumentWriter, src []byte) error {\n\twef := func(key string) (ValueWriter, error) {\n\t\treturn dst.WriteDocumentElement(key)\n\t}\n\n\treturn copyBytesToValueWriter(src, wef)\n}\n\nfunc copyBytesToValueWriter(src []byte, wef writeElementFn) error {\n\t// TODO(skriptble): Create errors types here. Anything that is a tag should be a property.\n\tlength, rem, ok := bsoncore.ReadLength(src)\n\tif !ok {\n\t\treturn fmt.Errorf(\"couldn't read length from src, not enough bytes. length=%d\", len(src))\n\t}\n\tif len(src) < int(length) {\n\t\treturn fmt.Errorf(\"length read exceeds number of bytes available. length=%d bytes=%d\", len(src), length)\n\t}\n\trem = rem[:length-4]\n\n\tvar t bsoncore.Type\n\tvar key string\n\tvar val bsoncore.Value\n\tfor {\n\t\tt, rem, ok = bsoncore.ReadType(rem)\n\t\tif !ok {\n\t\t\treturn io.EOF\n\t\t}\n\t\tif t == bsoncore.Type(0) {\n\t\t\tif len(rem) != 0 {\n\t\t\t\treturn fmt.Errorf(\"document end byte found before end of document. remaining bytes=%v\", rem)\n\t\t\t}\n\t\t\tbreak\n\t\t}\n\n\t\tkey, rem, ok = bsoncore.ReadKey(rem)\n\t\tif !ok {\n\t\t\treturn fmt.Errorf(\"invalid key found. remaining bytes=%v\", rem)\n\t\t}\n\n\t\t// write as either array element or document element using writeElementFn\n\t\tvw, err := wef(key)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\n\t\tval, rem, ok = bsoncore.ReadValue(rem, t)\n\t\tif !ok {\n\t\t\treturn fmt.Errorf(\"not enough bytes available to read type. bytes=%d type=%s\", len(rem), t)\n\t\t}\n\t\terr = copyValueFromBytes(vw, Type(t), val.Data)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t}\n\treturn nil\n}\n\n// copyDocumentToBytes copies an entire document from the ValueReader and\n// returns it as bytes.\nfunc copyDocumentToBytes(src ValueReader) ([]byte, error) {\n\treturn appendDocumentBytes(nil, src)\n}\n\n// appendDocumentBytes functions the same as CopyDocumentToBytes, but will\n// append the result to dst.\nfunc appendDocumentBytes(dst []byte, src ValueReader) ([]byte, error) {\n\tif br, ok := src.(bytesReader); ok {\n\t\t_, dst, err := br.readValueBytes(dst)\n\t\treturn dst, err\n\t}\n\n\tvw := vwPool.Get().(*valueWriter)\n\tdefer putValueWriter(vw)\n\n\tvw.reset(dst)\n\n\terr := copyDocument(vw, src)\n\tdst = vw.buf\n\treturn dst, err\n}\n\n// appendArrayBytes copies an array from the ValueReader to dst.\nfunc appendArrayBytes(dst []byte, src ValueReader) ([]byte, error) {\n\tif br, ok := src.(bytesReader); ok {\n\t\t_, dst, err := br.readValueBytes(dst)\n\t\treturn dst, err\n\t}\n\n\tvw := vwPool.Get().(*valueWriter)\n\tdefer putValueWriter(vw)\n\n\tvw.reset(dst)\n\n\terr := copyArray(vw, src)\n\tdst = vw.buf\n\treturn dst, err\n}\n\n// copyValueFromBytes will write the value represtend by t and src to dst.\nfunc copyValueFromBytes(dst ValueWriter, t Type, src []byte) error {\n\tif wvb, ok := dst.(bytesWriter); ok {\n\t\treturn wvb.writeValueBytes(t, src)\n\t}\n\n\tvr := newBufferedDocumentReader(src)\n\tvr.advanceFrame()\n\n\tvr.stack[vr.frame].mode = mElement\n\tvr.stack[vr.frame].vType = t\n\n\treturn copyValue(dst, vr)\n}\n\n// copyValueToBytes copies a value from src and returns it as a Type and a\n// []byte.\nfunc copyValueToBytes(src ValueReader) (Type, []byte, error) {\n\tif br, ok := src.(bytesReader); ok {\n\t\treturn br.readValueBytes(nil)\n\t}\n\n\tvw := vwPool.Get().(*valueWriter)\n\tdefer putValueWriter(vw)\n\n\tvw.reset(nil)\n\tvw.push(mElement)\n\n\terr := copyValue(vw, src)\n\tif err != nil {\n\t\treturn 0, nil, err\n\t}\n\n\treturn Type(vw.buf[0]), vw.buf[2:], nil\n}\n\n// copyValue will copy a single value from src to dst.\nfunc copyValue(dst ValueWriter, src ValueReader) error {\n\tvar err error\n\tswitch src.Type() {\n\tcase TypeDouble:\n\t\tvar f64 float64\n\t\tf64, err = src.ReadDouble()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = dst.WriteDouble(f64)\n\tcase TypeString:\n\t\tvar str string\n\t\tstr, err = src.ReadString()\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\terr = dst.WriteString(str)\n\tcase TypeEmbeddedDocument:\n\t\terr = copyDocument(dst, src)\n\tcase TypeArray:\n\t\terr = copyArray(dst, src)\n\tcase TypeBinary:\n\t\tvar data []byte\n\t\tvar subtype byte\n\t\tdata, subtype, err = src.ReadBinary()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = dst.WriteBinaryWithSubtype(data, subtype)\n\tcase TypeUndefined:\n\t\terr = src.ReadUndefined()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = dst.WriteUndefined()\n\tcase TypeObjectID:\n\t\tvar oid ObjectID\n\t\toid, err = src.ReadObjectID()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = dst.WriteObjectID(oid)\n\tcase TypeBoolean:\n\t\tvar b bool\n\t\tb, err = src.ReadBoolean()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = dst.WriteBoolean(b)\n\tcase TypeDateTime:\n\t\tvar dt int64\n\t\tdt, err = src.ReadDateTime()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = dst.WriteDateTime(dt)\n\tcase TypeNull:\n\t\terr = src.ReadNull()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = dst.WriteNull()\n\tcase TypeRegex:\n\t\tvar pattern, options string\n\t\tpattern, options, err = src.ReadRegex()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = dst.WriteRegex(pattern, options)\n\tcase TypeDBPointer:\n\t\tvar ns string\n\t\tvar pointer ObjectID\n\t\tns, pointer, err = src.ReadDBPointer()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = dst.WriteDBPointer(ns, pointer)\n\tcase TypeJavaScript:\n\t\tvar js string\n\t\tjs, err = src.ReadJavascript()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = dst.WriteJavascript(js)\n\tcase TypeSymbol:\n\t\tvar symbol string\n\t\tsymbol, err = src.ReadSymbol()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = dst.WriteSymbol(symbol)\n\tcase TypeCodeWithScope:\n\t\tvar code string\n\t\tvar srcScope DocumentReader\n\t\tcode, srcScope, err = src.ReadCodeWithScope()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\n\t\tvar dstScope DocumentWriter\n\t\tdstScope, err = dst.WriteCodeWithScope(code)\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = copyDocumentCore(dstScope, srcScope)\n\tcase TypeInt32:\n\t\tvar i32 int32\n\t\ti32, err = src.ReadInt32()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = dst.WriteInt32(i32)\n\tcase TypeTimestamp:\n\t\tvar t, i uint32\n\t\tt, i, err = src.ReadTimestamp()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = dst.WriteTimestamp(t, i)\n\tcase TypeInt64:\n\t\tvar i64 int64\n\t\ti64, err = src.ReadInt64()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = dst.WriteInt64(i64)\n\tcase TypeDecimal128:\n\t\tvar d128 Decimal128\n\t\td128, err = src.ReadDecimal128()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = dst.WriteDecimal128(d128)\n\tcase TypeMinKey:\n\t\terr = src.ReadMinKey()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = dst.WriteMinKey()\n\tcase TypeMaxKey:\n\t\terr = src.ReadMaxKey()\n\t\tif err != nil {\n\t\t\tbreak\n\t\t}\n\t\terr = dst.WriteMaxKey()\n\tdefault:\n\t\terr = fmt.Errorf(\"cannot copy unknown BSON type %s\", src.Type())\n\t}\n\n\treturn err\n}\n\nfunc copyArray(dst ValueWriter, src ValueReader) error {\n\tar, err := src.ReadArray()\n\tif err != nil {\n\t\treturn err\n\t}\n\n\taw, err := dst.WriteArray()\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tfor {\n\t\tvr, err := ar.ReadValue()\n\t\tif errors.Is(err, ErrEOA) {\n\t\t\tbreak\n\t\t}\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\n\t\tvw, err := aw.WriteArrayElement()\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\n\t\terr = copyValue(vw, vr)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t}\n\n\treturn aw.WriteArrayEnd()\n}\n\nfunc copyDocumentCore(dw DocumentWriter, dr DocumentReader) error {\n\tfor {\n\t\tkey, vr, err := dr.ReadElement()\n\t\tif errors.Is(err, ErrEOD) {\n\t\t\tbreak\n\t\t}\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\n\t\tvw, err := dw.WriteDocumentElement(key)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\n\t\terr = copyValue(vw, vr)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t}\n\n\treturn dw.WriteDocumentEnd()\n}\n\n// bytesReader is the interface used to read BSON bytes from a valueReader.\n//\n// The bytes of the value will be appended to dst.\ntype bytesReader interface {\n\treadValueBytes(dst []byte) (Type, []byte, error)\n}\n\n// bytesWriter is the interface used to write BSON bytes to a valueWriter.\ntype bytesWriter interface {\n\twriteValueBytes(t Type, b []byte) error\n}\n" }, { "path": "bson/copier_test.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"bytes\"\n\t\"errors\"\n\t\"fmt\"\n\t\"testing\"\n\n\t\"go.mongodb.org/mongo-driver/v2/internal/assert\"\n\t\"go.mongodb.org/mongo-driver/v2/x/bsonx/bsoncore\"\n)\n\nfunc TestCopier(t *testing.T) {\n\tt.Run(\"CopyDocument\", func(t *testing.T) {\n\t\tt.Run(\"ReadDocument Error\", func(t *testing.T) {\n\t\t\twant := errors.New(\"ReadDocumentError\")\n\t\t\tsrc := &TestValueReaderWriter{t: t, err: want, errAfter: llvrwReadDocument}\n\t\t\tgot := copyDocument(nil, src)\n\t\t\tif !assert.CompareErrors(got, want) {\n\t\t\t\tt.Errorf(\"Did not receive correct error. got %v; want %v\", got, want)\n\t\t\t}\n\t\t})\n\t\tt.Run(\"WriteDocument Error\", func(t *testing.T) {\n\t\t\twant := errors.New(\"WriteDocumentError\")\n\t\t\tsrc := &TestValueReaderWriter{}\n\t\t\tdst := &TestValueReaderWriter{t: t, err: want, errAfter: llvrwWriteDocument}\n\t\t\tgot := copyDocument(dst, src)\n\t\t\tif !assert.CompareErrors(got, want) {\n\t\t\t\tt.Errorf(\"Did not receive correct error. got %v; want %v\", got, want)\n\t\t\t}\n\t\t})\n\t\tt.Run(\"success\", func(t *testing.T) {\n\t\t\tidx, doc := bsoncore.AppendDocumentStart(nil)\n\t\t\tdoc = bsoncore.AppendStringElement(doc, \"Hello\", \"world\")\n\t\t\tdoc, err := bsoncore.AppendDocumentEnd(doc, idx)\n\t\t\tnoerr(t, err)\n\t\t\tsrc := newBufferedDocumentReader(doc)\n\t\t\tdst := newValueWriterFromSlice(make([]byte, 0))\n\t\t\twant := doc\n\t\t\terr = copyDocument(dst, src)\n\t\t\tnoerr(t, err)\n\t\t\tgot := dst.buf\n\t\t\tif !bytes.Equal(got, want) {\n\t\t\t\tt.Errorf(\"Bytes are not equal. got %v; want %v\", got, want)\n\t\t\t}\n\t\t})\n\t})\n\tt.Run(\"copyArray\", func(t *testing.T) {\n\t\tt.Run(\"ReadArray Error\", func(t *testing.T) {\n\t\t\twant := errors.New(\"ReadArrayError\")\n\t\t\tsrc := &TestValueReaderWriter{t: t, err: want, errAfter: llvrwReadArray}\n\t\t\tgot := copyArray(nil, src)\n\t\t\tif !assert.CompareErrors(got, want) {\n\t\t\t\tt.Errorf(\"Did not receive correct error. got %v; want %v\", got, want)\n\t\t\t}\n\t\t})\n\t\tt.Run(\"WriteArray Error\", func(t *testing.T) {\n\t\t\twant := errors.New(\"WriteArrayError\")\n\t\t\tsrc := &TestValueReaderWriter{}\n\t\t\tdst := &TestValueReaderWriter{t: t, err: want, errAfter: llvrwWriteArray}\n\t\t\tgot := copyArray(dst, src)\n\t\t\tif !assert.CompareErrors(got, want) {\n\t\t\t\tt.Errorf(\"Did not receive correct error. got %v; want %v\", got, want)\n\t\t\t}\n\t\t})\n\t\tt.Run(\"success\", func(t *testing.T) {\n\t\t\tidx, doc := bsoncore.AppendDocumentStart(nil)\n\t\t\taidx, doc := bsoncore.AppendArrayElementStart(doc, \"foo\")\n\t\t\tdoc = bsoncore.AppendStringElement(doc, \"0\", \"Hello, world!\")\n\t\t\tdoc, err := bsoncore.AppendArrayEnd(doc, aidx)\n\t\t\tnoerr(t, err)\n\t\t\tdoc, err = bsoncore.AppendDocumentEnd(doc, idx)\n\t\t\tnoerr(t, err)\n\t\t\tsrc := newBufferedDocumentReader(doc)\n\n\t\t\t_, err = src.ReadDocument()\n\t\t\tnoerr(t, err)\n\t\t\t_, _, err = src.ReadElement()\n\t\t\tnoerr(t, err)\n\n\t\t\tdst := newValueWriterFromSlice(make([]byte, 0))\n\t\t\t_, err = dst.WriteDocument()\n\t\t\tnoerr(t, err)\n\t\t\t_, err = dst.WriteDocumentElement(\"foo\")\n\t\t\tnoerr(t, err)\n\t\t\twant := doc\n\n\t\t\terr = copyArray(dst, src)\n\t\t\tnoerr(t, err)\n\n\t\t\terr = dst.WriteDocumentEnd()\n\t\t\tnoerr(t, err)\n\n\t\t\tgot := dst.buf\n\t\t\tif !bytes.Equal(got, want) {\n\t\t\t\tt.Errorf(\"Bytes are not equal. got %v; want %v\", got, want)\n\t\t\t}\n\t\t})\n\t})\n\tt.Run(\"CopyValue\", func(t *testing.T) {\n\t\ttestCases := []struct {\n\t\t\tname string\n\t\t\tdst *TestValueReaderWriter\n\t\t\tsrc *TestValueReaderWriter\n\t\t\terr error\n\t\t}{\n\t\t\t{\n\t\t\t\t\"Double/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeDouble, err: errors.New(\"1\"), errAfter: llvrwReadDouble},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Double/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeDouble, err: errors.New(\"2\"), errAfter: llvrwWriteDouble},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeDouble, readval: float64(3.14159)},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"String/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeString, err: errors.New(\"1\"), errAfter: llvrwReadString},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"String/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeString, err: errors.New(\"2\"), errAfter: llvrwWriteString},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeString, readval: \"hello, world\"},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Document/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeEmbeddedDocument, err: errors.New(\"1\"), errAfter: llvrwReadDocument},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Array/dst/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeArray, err: errors.New(\"2\"), errAfter: llvrwReadArray},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Binary/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeBinary, err: errors.New(\"1\"), errAfter: llvrwReadBinary},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Binary/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeBinary, err: errors.New(\"2\"), errAfter: llvrwWriteBinaryWithSubtype},\n\t\t\t\t&TestValueReaderWriter{\n\t\t\t\t\tbsontype: TypeBinary,\n\t\t\t\t\treadval: bsoncore.Value{\n\t\t\t\t\t\tType: bsoncore.TypeBinary,\n\t\t\t\t\t\tData: []byte{0x03, 0x00, 0x00, 0x00, 0xFF, 0x01, 0x02, 0x03},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Undefined/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeUndefined, err: errors.New(\"1\"), errAfter: llvrwReadUndefined},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Undefined/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeUndefined, err: errors.New(\"2\"), errAfter: llvrwWriteUndefined},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeUndefined},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"ObjectID/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeObjectID, err: errors.New(\"1\"), errAfter: llvrwReadObjectID},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"ObjectID/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeObjectID, err: errors.New(\"2\"), errAfter: llvrwWriteObjectID},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeObjectID, readval: ObjectID{0x01, 0x02, 0x03}},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Boolean/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeBoolean, err: errors.New(\"1\"), errAfter: llvrwReadBoolean},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Boolean/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeBoolean, err: errors.New(\"2\"), errAfter: llvrwWriteBoolean},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeBoolean, readval: bool(true)},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"DateTime/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeDateTime, err: errors.New(\"1\"), errAfter: llvrwReadDateTime},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"DateTime/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeDateTime, err: errors.New(\"2\"), errAfter: llvrwWriteDateTime},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeDateTime, readval: int64(1234567890)},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Null/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeNull, err: errors.New(\"1\"), errAfter: llvrwReadNull},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Null/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeNull, err: errors.New(\"2\"), errAfter: llvrwWriteNull},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeNull},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Regex/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeRegex, err: errors.New(\"1\"), errAfter: llvrwReadRegex},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Regex/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeRegex, err: errors.New(\"2\"), errAfter: llvrwWriteRegex},\n\t\t\t\t&TestValueReaderWriter{\n\t\t\t\t\tbsontype: TypeRegex,\n\t\t\t\t\treadval: bsoncore.Value{\n\t\t\t\t\t\tType: bsoncore.TypeRegex,\n\t\t\t\t\t\tData: bsoncore.AppendRegex(nil, \"hello\", \"world\"),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"DBPointer/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeDBPointer, err: errors.New(\"1\"), errAfter: llvrwReadDBPointer},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"DBPointer/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeDBPointer, err: errors.New(\"2\"), errAfter: llvrwWriteDBPointer},\n\t\t\t\t&TestValueReaderWriter{\n\t\t\t\t\tbsontype: TypeDBPointer,\n\t\t\t\t\treadval: bsoncore.Value{\n\t\t\t\t\t\tType: bsoncore.TypeDBPointer,\n\t\t\t\t\t\tData: bsoncore.AppendDBPointer(nil, \"foo\", ObjectID{0x01, 0x02, 0x03}),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Javascript/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeJavaScript, err: errors.New(\"1\"), errAfter: llvrwReadJavascript},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Javascript/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeJavaScript, err: errors.New(\"2\"), errAfter: llvrwWriteJavascript},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeJavaScript, readval: \"hello, world\"},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Symbol/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeSymbol, err: errors.New(\"1\"), errAfter: llvrwReadSymbol},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Symbol/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeSymbol, err: errors.New(\"2\"), errAfter: llvrwWriteSymbol},\n\t\t\t\t&TestValueReaderWriter{\n\t\t\t\t\tbsontype: TypeSymbol,\n\t\t\t\t\treadval: bsoncore.Value{\n\t\t\t\t\t\tType: bsoncore.TypeSymbol,\n\t\t\t\t\t\tData: bsoncore.AppendSymbol(nil, \"hello, world\"),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"CodeWithScope/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeCodeWithScope, err: errors.New(\"1\"), errAfter: llvrwReadCodeWithScope},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"CodeWithScope/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeCodeWithScope, err: errors.New(\"2\"), errAfter: llvrwWriteCodeWithScope},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeCodeWithScope},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"CodeWithScope/dst/copyDocumentCore error\",\n\t\t\t\t&TestValueReaderWriter{err: errors.New(\"3\"), errAfter: llvrwWriteDocumentElement},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeCodeWithScope},\n\t\t\t\terrors.New(\"3\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Int32/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeInt32, err: errors.New(\"1\"), errAfter: llvrwReadInt32},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Int32/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeInt32, err: errors.New(\"2\"), errAfter: llvrwWriteInt32},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeInt32, readval: int32(12345)},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Timestamp/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeTimestamp, err: errors.New(\"1\"), errAfter: llvrwReadTimestamp},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Timestamp/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeTimestamp, err: errors.New(\"2\"), errAfter: llvrwWriteTimestamp},\n\t\t\t\t&TestValueReaderWriter{\n\t\t\t\t\tbsontype: TypeTimestamp,\n\t\t\t\t\treadval: bsoncore.Value{\n\t\t\t\t\t\tType: bsoncore.TypeTimestamp,\n\t\t\t\t\t\tData: bsoncore.AppendTimestamp(nil, 12345, 67890),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Int64/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeInt64, err: errors.New(\"1\"), errAfter: llvrwReadInt64},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Int64/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeInt64, err: errors.New(\"2\"), errAfter: llvrwWriteInt64},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeInt64, readval: int64(1234567890)},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Decimal128/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeDecimal128, err: errors.New(\"1\"), errAfter: llvrwReadDecimal128},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Decimal128/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeDecimal128, err: errors.New(\"2\"), errAfter: llvrwWriteDecimal128},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeDecimal128, readval: NewDecimal128(12345, 67890)},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"MinKey/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeMinKey, err: errors.New(\"1\"), errAfter: llvrwReadMinKey},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"MinKey/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeMinKey, err: errors.New(\"2\"), errAfter: llvrwWriteMinKey},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeMinKey},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"MaxKey/src/error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeMaxKey, err: errors.New(\"1\"), errAfter: llvrwReadMaxKey},\n\t\t\t\terrors.New(\"1\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"MaxKey/dst/error\",\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeMaxKey, err: errors.New(\"2\"), errAfter: llvrwWriteMaxKey},\n\t\t\t\t&TestValueReaderWriter{bsontype: TypeMaxKey},\n\t\t\t\terrors.New(\"2\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"Unknown BSON type error\",\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\t&TestValueReaderWriter{},\n\t\t\t\tfmt.Errorf(\"cannot copy unknown BSON type %s\", Type(0)),\n\t\t\t},\n\t\t}\n\n\t\tfor _, tc := range testCases {\n\t\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\t\ttc.dst.t, tc.src.t = t, t\n\t\t\t\terr := copyValue(tc.dst, tc.src)\n\t\t\t\tif !assert.CompareErrors(err, tc.err) {\n\t\t\t\t\tt.Errorf(\"Did not receive expected error. got %v; want %v\", err, tc.err)\n\t\t\t\t}\n\t\t\t})\n\t\t}\n\t})\n\tt.Run(\"CopyValueFromBytes\", func(t *testing.T) {\n\t\tt.Run(\"BytesWriter\", func(t *testing.T) {\n\t\t\tvw := newValueWriterFromSlice(make([]byte, 0))\n\t\t\t_, err := vw.WriteDocument()\n\t\t\tnoerr(t, err)\n\t\t\t_, err = vw.WriteDocumentElement(\"foo\")\n\t\t\tnoerr(t, err)\n\t\t\terr = copyValueFromBytes(vw, TypeString, bsoncore.AppendString(nil, \"bar\"))\n\t\t\tnoerr(t, err)\n\t\t\terr = vw.WriteDocumentEnd()\n\t\t\tnoerr(t, err)\n\t\t\tvar idx int32\n\t\t\twant, err := bsoncore.AppendDocumentEnd(\n\t\t\t\tbsoncore.AppendStringElement(\n\t\t\t\t\tbsoncore.AppendDocumentStartInline(nil, &idx),\n\t\t\t\t\t\"foo\", \"bar\",\n\t\t\t\t),\n\t\t\t\tidx,\n\t\t\t)\n\t\t\tnoerr(t, err)\n\t\t\tgot := vw.buf\n\t\t\tif !bytes.Equal(got, want) {\n\t\t\t\tt.Errorf(\"Bytes are not equal. got %v; want %v\", got, want)\n\t\t\t}\n\t\t})\n\t\tt.Run(\"Non BytesWriter\", func(t *testing.T) {\n\t\t\tllvrw := &TestValueReaderWriter{t: t}\n\t\t\terr := copyValueFromBytes(llvrw, TypeString, bsoncore.AppendString(nil, \"bar\"))\n\t\t\tnoerr(t, err)\n\t\t\tgot, want := llvrw.invoked, llvrwWriteString\n\t\t\tif got != want {\n\t\t\t\tt.Errorf(\"Incorrect method invoked on llvrw. got %v; want %v\", got, want)\n\t\t\t}\n\t\t})\n\t})\n\tt.Run(\"CopyValueToBytes\", func(t *testing.T) {\n\t\tt.Run(\"BytesReader\", func(t *testing.T) {\n\t\t\tvar idx int32\n\t\t\tb, err := bsoncore.AppendDocumentEnd(\n\t\t\t\tbsoncore.AppendStringElement(\n\t\t\t\t\tbsoncore.AppendDocumentStartInline(nil, &idx),\n\t\t\t\t\t\"hello\", \"world\",\n\t\t\t\t),\n\t\t\t\tidx,\n\t\t\t)\n\t\t\tnoerr(t, err)\n\t\t\tvr := newBufferedDocumentReader(b)\n\t\t\t_, err = vr.ReadDocument()\n\t\t\tnoerr(t, err)\n\t\t\t_, _, err = vr.ReadElement()\n\t\t\tnoerr(t, err)\n\t\t\tbtype, got, err := copyValueToBytes(vr)\n\t\t\tnoerr(t, err)\n\t\t\twant := bsoncore.AppendString(nil, \"world\")\n\t\t\tif btype != TypeString {\n\t\t\t\tt.Errorf(\"Incorrect type returned. got %v; want %v\", btype, TypeString)\n\t\t\t}\n\t\t\tif !bytes.Equal(got, want) {\n\t\t\t\tt.Errorf(\"Bytes do not match. got %v; want %v\", got, want)\n\t\t\t}\n\t\t})\n\t\tt.Run(\"Non BytesReader\", func(t *testing.T) {\n\t\t\tllvrw := &TestValueReaderWriter{t: t, bsontype: TypeString, readval: \"Hello, world!\"}\n\t\t\tbtype, got, err := copyValueToBytes(llvrw)\n\t\t\tnoerr(t, err)\n\t\t\twant := bsoncore.AppendString(nil, \"Hello, world!\")\n\t\t\tif btype != TypeString {\n\t\t\t\tt.Errorf(\"Incorrect type returned. got %v; want %v\", btype, TypeString)\n\t\t\t}\n\t\t\tif !bytes.Equal(got, want) {\n\t\t\t\tt.Errorf(\"Bytes do not match. got %v; want %v\", got, want)\n\t\t\t}\n\t\t})\n\t})\n\tt.Run(\"AppendValueBytes\", func(t *testing.T) {\n\t\tt.Run(\"BytesReader\", func(t *testing.T) {\n\t\t\tvar idx int32\n\t\t\tb, err := bsoncore.AppendDocumentEnd(\n\t\t\t\tbsoncore.AppendStringElement(\n\t\t\t\t\tbsoncore.AppendDocumentStartInline(nil, &idx),\n\t\t\t\t\t\"hello\", \"world\",\n\t\t\t\t),\n\t\t\t\tidx,\n\t\t\t)\n\t\t\tnoerr(t, err)\n\t\t\tvr := newBufferedDocumentReader(b)\n\t\t\t_, err = vr.ReadDocument()\n\t\t\tnoerr(t, err)\n\t\t\t_, _, err = vr.ReadElement()\n\t\t\tnoerr(t, err)\n\t\t\tbtype, got, err := copyValueToBytes(vr)\n\t\t\tnoerr(t, err)\n\t\t\twant := bsoncore.AppendString(nil, \"world\")\n\t\t\tif btype != TypeString {\n\t\t\t\tt.Errorf(\"Incorrect type returned. got %v; want %v\", btype, TypeString)\n\t\t\t}\n\t\t\tif !bytes.Equal(got, want) {\n\t\t\t\tt.Errorf(\"Bytes do not match. got %v; want %v\", got, want)\n\t\t\t}\n\t\t})\n\t\tt.Run(\"Non BytesReader\", func(t *testing.T) {\n\t\t\tllvrw := &TestValueReaderWriter{t: t, bsontype: TypeString, readval: \"Hello, world!\"}\n\t\t\tbtype, got, err := copyValueToBytes(llvrw)\n\t\t\tnoerr(t, err)\n\t\t\twant := bsoncore.AppendString(nil, \"Hello, world!\")\n\t\t\tif btype != TypeString {\n\t\t\t\tt.Errorf(\"Incorrect type returned. got %v; want %v\", btype, TypeString)\n\t\t\t}\n\t\t\tif !bytes.Equal(got, want) {\n\t\t\t\tt.Errorf(\"Bytes do not match. got %v; want %v\", got, want)\n\t\t\t}\n\t\t})\n\t\tt.Run(\"CopyValue error\", func(t *testing.T) {\n\t\t\twant := errors.New(\"CopyValue error\")\n\t\t\tllvrw := &TestValueReaderWriter{t: t, bsontype: TypeString, err: want, errAfter: llvrwReadString}\n\t\t\t_, _, got := copyValueToBytes(llvrw)\n\t\t\tif !assert.CompareErrors(got, want) {\n\t\t\t\tt.Errorf(\"Errors do not match. got %v; want %v\", got, want)\n\t\t\t}\n\t\t})\n\t})\n}\n" }, { "path": "bson/decimal.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n//\n// Based on gopkg.in/mgo.v2/bson by Gustavo Niemeyer\n// See THIRD-PARTY-NOTICES for original license terms.\n\npackage bson\n\nimport (\n\t\"encoding/json\"\n\t\"errors\"\n\t\"fmt\"\n\t\"math/big\"\n\t\"regexp\"\n\t\"strconv\"\n\t\"strings\"\n\n\t\"go.mongodb.org/mongo-driver/v2/internal/decimal128\"\n)\n\n// These constants are the maximum and minimum values for the exponent field in a decimal128 value.\nconst (\n\tMaxDecimal128Exp = 6111\n\tMinDecimal128Exp = -6176\n)\n\n// These errors are returned when an invalid value is parsed as a big.Int.\nvar (\n\tErrParseNaN = errors.New(\"cannot parse NaN as a *big.Int\")\n\tErrParseInf = errors.New(\"cannot parse Infinity as a *big.Int\")\n\tErrParseNegInf = errors.New(\"cannot parse -Infinity as a *big.Int\")\n)\n\n// Decimal128 holds decimal128 BSON values.\ntype Decimal128 struct {\n\th, l uint64\n}\n\n// NewDecimal128 creates a Decimal128 using the provide high and low uint64s.\nfunc NewDecimal128(h, l uint64) Decimal128 {\n\treturn Decimal128{h: h, l: l}\n}\n\n// GetBytes returns the underlying bytes of the BSON decimal value as two uint64 values. The first\n// contains the most first 8 bytes of the value and the second contains the latter.\nfunc (d Decimal128) GetBytes() (uint64, uint64) {\n\treturn d.h, d.l\n}\n\n// String returns a string representation of the decimal value.\nfunc (d Decimal128) String() string {\n\treturn decimal128.String(d.h, d.l)\n}\n\n// BigInt returns significand as big.Int and exponent, bi * 10 ^ exp.\nfunc (d Decimal128) BigInt() (*big.Int, int, error) {\n\thigh, low := d.GetBytes()\n\tposSign := high>>63&1 == 0 // positive sign\n\n\tswitch high >> 58 & (1<<5 - 1) {\n\tcase 0x1F:\n\t\treturn nil, 0, ErrParseNaN\n\tcase 0x1E:\n\t\tif posSign {\n\t\t\treturn nil, 0, ErrParseInf\n\t\t}\n\t\treturn nil, 0, ErrParseNegInf\n\t}\n\n\tvar exp int\n\tif high>>61&3 == 3 {\n\t\t// Bits: 1*sign 2*ignored 14*exponent 111*significand.\n\t\t// Implicit 0b100 prefix in significand.\n\t\texp = int(high >> 47 & (1<<14 - 1))\n\t\t// Spec says all of these values are out of range.\n\t\thigh, low = 0, 0\n\t} else {\n\t\t// Bits: 1*sign 14*exponent 113*significand\n\t\texp = int(high >> 49 & (1<<14 - 1))\n\t\thigh &= (1<<49 - 1)\n\t}\n\texp += MinDecimal128Exp\n\n\t// Would be handled by the logic below, but that's trivial and common.\n\tif high == 0 && low == 0 && exp == 0 {\n\t\treturn new(big.Int), 0, nil\n\t}\n\n\tbi := big.NewInt(0)\n\tconst host32bit = ^uint(0)>>32 == 0\n\tif host32bit {\n\t\tbi.SetBits([]big.Word{big.Word(low), big.Word(low >> 32), big.Word(high), big.Word(high >> 32)})\n\t} else {\n\t\tbi.SetBits([]big.Word{big.Word(low), big.Word(high)})\n\t}\n\n\tif !posSign {\n\t\treturn bi.Neg(bi), exp, nil\n\t}\n\treturn bi, exp, nil\n}\n\n// IsNaN returns whether d is NaN.\nfunc (d Decimal128) IsNaN() bool {\n\treturn d.h>>58&(1<<5-1) == 0x1F\n}\n\n// IsInf returns:\n//\n//\t+1 d == Infinity\n//\t 0 other case\n//\t-1 d == -Infinity\nfunc (d Decimal128) IsInf() int {\n\tif d.h>>58&(1<<5-1) != 0x1E {\n\t\treturn 0\n\t}\n\n\tif d.h>>63&1 == 0 {\n\t\treturn 1\n\t}\n\treturn -1\n}\n\n// IsZero returns true if d is the empty Decimal128.\nfunc (d Decimal128) IsZero() bool {\n\treturn d.h == 0 && d.l == 0\n}\n\n// MarshalJSON returns Decimal128 as a string.\nfunc (d Decimal128) MarshalJSON() ([]byte, error) {\n\treturn json.Marshal(d.String())\n}\n\n// UnmarshalJSON creates a Decimal128 from a JSON string, an extended JSON $numberDecimal value, or the string\n// \"null\". If b is a JSON string or extended JSON value, d will have the value of that string, and if b is \"null\", d will\n// be unchanged.\nfunc (d *Decimal128) UnmarshalJSON(b []byte) error {\n\t// Ignore \"null\" to keep parity with the standard library. Decoding a JSON null into a non-pointer Decimal128 field\n\t// will leave the field unchanged. For pointer values, encoding/json will set the pointer to nil and will not\n\t// enter the UnmarshalJSON hook.\n\tif string(b) == \"null\" {\n\t\treturn nil\n\t}\n\n\tvar res any\n\terr := json.Unmarshal(b, &res)\n\tif err != nil {\n\t\treturn err\n\t}\n\tstr, ok := res.(string)\n\n\t// Extended JSON\n\tif !ok {\n\t\tm, ok := res.(map[string]any)\n\t\tif !ok {\n\t\t\treturn errors.New(\"not an extended JSON Decimal128: expected document\")\n\t\t}\n\t\td128, ok := m[\"$numberDecimal\"]\n\t\tif !ok {\n\t\t\treturn errors.New(\"not an extended JSON Decimal128: expected key $numberDecimal\")\n\t\t}\n\t\tstr, ok = d128.(string)\n\t\tif !ok {\n\t\t\treturn errors.New(\"not an extended JSON Decimal128: expected decimal to be string\")\n\t\t}\n\t}\n\n\t*d, err = ParseDecimal128(str)\n\treturn err\n}\n\nvar (\n\tdNaN = Decimal128{0x1F << 58, 0}\n\tdPosInf = Decimal128{0x1E << 58, 0}\n\tdNegInf = Decimal128{0x3E << 58, 0}\n)\n\nfunc dErr(s string) (Decimal128, error) {\n\treturn dNaN, fmt.Errorf(\"cannot parse %q as a decimal128\", s)\n}\n\n// match scientific notation number, example -10.15e-18\nvar normalNumber = regexp.MustCompile(`^(?P[-+]?\\d*)?(?:\\.(?P\\d*))?(?:[Ee](?P[-+]?\\d+))?$`)\n\n// ParseDecimal128 takes the given string and attempts to parse it into a valid\n// Decimal128 value.\nfunc ParseDecimal128(s string) (Decimal128, error) {\n\tif s == \"\" {\n\t\treturn dErr(s)\n\t}\n\n\tmatches := normalNumber.FindStringSubmatch(s)\n\tif len(matches) == 0 {\n\t\torig := s\n\t\tneg := s[0] == '-'\n\t\tif neg || s[0] == '+' {\n\t\t\ts = s[1:]\n\t\t}\n\n\t\tif s == \"NaN\" || s == \"nan\" || strings.EqualFold(s, \"nan\") {\n\t\t\treturn dNaN, nil\n\t\t}\n\t\tif s == \"Inf\" || s == \"inf\" || strings.EqualFold(s, \"inf\") || strings.EqualFold(s, \"infinity\") {\n\t\t\tif neg {\n\t\t\t\treturn dNegInf, nil\n\t\t\t}\n\t\t\treturn dPosInf, nil\n\t\t}\n\t\treturn dErr(orig)\n\t}\n\n\tintPart := matches[1]\n\tdecPart := matches[2]\n\texpPart := matches[3]\n\n\tvar err error\n\texp := 0\n\tif expPart != \"\" {\n\t\texp, err = strconv.Atoi(expPart)\n\t\tif err != nil {\n\t\t\treturn dErr(s)\n\t\t}\n\t}\n\tif decPart != \"\" {\n\t\texp -= len(decPart)\n\t}\n\n\tif len(strings.Trim(intPart+decPart, \"-0\")) > 35 {\n\t\treturn dErr(s)\n\t}\n\n\t// Parse the significand (i.e. the non-exponent part) as a big.Int.\n\tbi, ok := new(big.Int).SetString(intPart+decPart, 10)\n\tif !ok {\n\t\treturn dErr(s)\n\t}\n\n\td, ok := ParseDecimal128FromBigInt(bi, exp)\n\tif !ok {\n\t\treturn dErr(s)\n\t}\n\n\tif bi.Sign() == 0 && s[0] == '-' {\n\t\td.h |= 1 << 63\n\t}\n\n\treturn d, nil\n}\n\nvar (\n\tten = big.NewInt(10)\n\tzero = new(big.Int)\n\n\tmaxS, _ = new(big.Int).SetString(\"9999999999999999999999999999999999\", 10)\n)\n\n// ParseDecimal128FromBigInt attempts to parse the given significand and exponent into a valid Decimal128 value.\nfunc ParseDecimal128FromBigInt(bi *big.Int, exp int) (Decimal128, bool) {\n\t// copy\n\tbi = new(big.Int).Set(bi)\n\n\tq := new(big.Int)\n\tr := new(big.Int)\n\n\t// If the significand is zero, the logical value will always be zero, independent of the\n\t// exponent. However, the loops for handling out-of-range exponent values below may be extremely\n\t// slow for zero values because the significand never changes. Limit the exponent value to the\n\t// supported range here to prevent entering the loops below.\n\tif bi.Cmp(zero) == 0 {\n\t\tif exp > MaxDecimal128Exp {\n\t\t\texp = MaxDecimal128Exp\n\t\t}\n\t\tif exp < MinDecimal128Exp {\n\t\t\texp = MinDecimal128Exp\n\t\t}\n\t}\n\n\tfor bigIntCmpAbs(bi, maxS) == 1 {\n\t\tbi, _ = q.QuoRem(bi, ten, r)\n\t\tif r.Cmp(zero) != 0 {\n\t\t\treturn Decimal128{}, false\n\t\t}\n\t\texp++\n\t\tif exp > MaxDecimal128Exp {\n\t\t\treturn Decimal128{}, false\n\t\t}\n\t}\n\n\tfor exp < MinDecimal128Exp {\n\t\t// Subnormal.\n\t\tbi, _ = q.QuoRem(bi, ten, r)\n\t\tif r.Cmp(zero) != 0 {\n\t\t\treturn Decimal128{}, false\n\t\t}\n\t\texp++\n\t}\n\tfor exp > MaxDecimal128Exp {\n\t\t// Clamped.\n\t\tbi.Mul(bi, ten)\n\t\tif bigIntCmpAbs(bi, maxS) == 1 {\n\t\t\treturn Decimal128{}, false\n\t\t}\n\t\texp--\n\t}\n\n\tb := bi.Bytes()\n\tvar h, l uint64\n\tfor i := 0; i < len(b); i++ {\n\t\tif i < len(b)-8 {\n\t\t\th = h<<8 | uint64(b[i])\n\t\t\tcontinue\n\t\t}\n\t\tl = l<<8 | uint64(b[i])\n\t}\n\n\th |= uint64(exp-MinDecimal128Exp) & uint64(1<<14-1) << 49\n\tif bi.Sign() == -1 {\n\t\th |= 1 << 63\n\t}\n\n\treturn Decimal128{h: h, l: l}, true\n}\n\n// bigIntCmpAbs computes big.Int.Cmp(absoluteValue(x), absoluteValue(y)).\nfunc bigIntCmpAbs(x, y *big.Int) int {\n\txAbs := bigIntAbsValue(x)\n\tyAbs := bigIntAbsValue(y)\n\treturn xAbs.Cmp(yAbs)\n}\n\n// bigIntAbsValue returns a big.Int containing the absolute value of b.\n// If b is already a non-negative number, it is returned without any changes or copies.\nfunc bigIntAbsValue(b *big.Int) *big.Int {\n\tif b.Sign() >= 0 {\n\t\treturn b // already positive\n\t}\n\treturn new(big.Int).Abs(b)\n}\n" }, { "path": "bson/decimal_test.go", "content": "// Copyright (C) MongoDB, Inc. 2022-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"math/big\"\n\t\"testing\"\n\n\t\"go.mongodb.org/mongo-driver/v2/internal/assert\"\n\t\"go.mongodb.org/mongo-driver/v2/internal/require\"\n)\n\ntype bigIntTestCase struct {\n\ts string\n\n\th uint64\n\tl uint64\n\n\tbi *big.Int\n\texp int\n\n\tremark string\n}\n\nfunc parseBigInt(s string) *big.Int {\n\tbi, _ := new(big.Int).SetString(s, 10)\n\treturn bi\n}\n\nvar (\n\tone = big.NewInt(1)\n\n\tbiMaxS = new(big.Int).SetBytes([]byte{0x1, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff})\n\tbiNMaxS = new(big.Int).Neg(biMaxS)\n\n\tbiOverflow = new(big.Int).Add(biMaxS, one)\n\tbiNOverflow = new(big.Int).Neg(biOverflow)\n\n\tbi12345 = parseBigInt(\"12345\")\n\tbiN12345 = parseBigInt(\"-12345\")\n\n\tbi9_14 = parseBigInt(\"90123456789012\")\n\tbiN9_14 = parseBigInt(\"-90123456789012\")\n\n\tbi9_34 = parseBigInt(\"9999999999999999999999999999999999\")\n\tbiN9_34 = parseBigInt(\"-9999999999999999999999999999999999\")\n)\n\nvar bigIntTestCases = []bigIntTestCase{\n\t{s: \"12345\", h: 0x3040000000000000, l: 12345, bi: bi12345},\n\t{s: \"-12345\", h: 0xB040000000000000, l: 12345, bi: biN12345},\n\n\t{s: \"90123456.789012\", h: 0x3034000000000000, l: 90123456789012, bi: bi9_14, exp: -6},\n\t{s: \"-90123456.789012\", h: 0xB034000000000000, l: 90123456789012, bi: biN9_14, exp: -6},\n\t{s: \"9.0123456789012E+22\", h: 0x3052000000000000, l: 90123456789012, bi: bi9_14, exp: 9},\n\t{s: \"-9.0123456789012E+22\", h: 0xB052000000000000, l: 90123456789012, bi: biN9_14, exp: 9},\n\t{s: \"9.0123456789012E-8\", h: 0x3016000000000000, l: 90123456789012, bi: bi9_14, exp: -21},\n\t{s: \"-9.0123456789012E-8\", h: 0xB016000000000000, l: 90123456789012, bi: biN9_14, exp: -21},\n\n\t{s: \"9999999999999999999999999999999999\", h: 3477321013416265664, l: 4003012203950112767, bi: bi9_34},\n\t{s: \"-9999999999999999999999999999999999\", h: 12700693050271041472, l: 4003012203950112767, bi: biN9_34},\n\t{s: \"0.9999999999999999999999999999999999\", h: 3458180714999941056, l: 4003012203950112767, bi: bi9_34, exp: -34},\n\t{s: \"-0.9999999999999999999999999999999999\", h: 12681552751854716864, l: 4003012203950112767, bi: biN9_34, exp: -34},\n\t{s: \"99999999999999999.99999999999999999\", h: 3467750864208103360, l: 4003012203950112767, bi: bi9_34, exp: -17},\n\t{s: \"-99999999999999999.99999999999999999\", h: 12691122901062879168, l: 4003012203950112767, bi: biN9_34, exp: -17},\n\t{s: \"9.999999999999999999999999999999999E+35\", h: 3478446913323108288, l: 4003012203950112767, bi: bi9_34, exp: 2},\n\t{s: \"-9.999999999999999999999999999999999E+35\", h: 12701818950177884096, l: 4003012203950112767, bi: biN9_34, exp: 2},\n\t{s: \"9.999999999999999999999999999999999E+40\", h: 3481261663090214848, l: 4003012203950112767, bi: bi9_34, exp: 7},\n\t{s: \"-9.999999999999999999999999999999999E+40\", h: 12704633699944990656, l: 4003012203950112767, bi: biN9_34, exp: 7},\n\t{s: \"99999999999999999999999999999.99999\", h: 3474506263649159104, l: 4003012203950112767, bi: bi9_34, exp: -5},\n\t{s: \"-99999999999999999999999999999.99999\", h: 12697878300503934912, l: 4003012203950112767, bi: biN9_34, exp: -5},\n\n\t{s: \"1.038459371706965525706099265844019E-6143\", remark: \"subnormal\", h: 0x333333333333, l: 0x3333333333333333, bi: parseBigInt(\"10384593717069655257060992658440190\"), exp: MinDecimal128Exp - 1},\n\t{s: \"-1.038459371706965525706099265844019E-6143\", remark: \"subnormal\", h: 0x8000333333333333, l: 0x3333333333333333, bi: parseBigInt(\"-10384593717069655257060992658440190\"), exp: MinDecimal128Exp - 1},\n\n\t{s: \"rounding overflow 1\", remark: \"overflow\", bi: parseBigInt(\"103845937170696552570609926584401910\"), exp: MaxDecimal128Exp},\n\t{s: \"rounding overflow 2\", remark: \"overflow\", bi: parseBigInt(\"103845937170696552570609926584401910\"), exp: MaxDecimal128Exp},\n\n\t{s: \"subnormal overflow 1\", remark: \"overflow\", bi: biMaxS, exp: MinDecimal128Exp - 1},\n\t{s: \"subnormal overflow 2\", remark: \"overflow\", bi: biNMaxS, exp: MinDecimal128Exp - 1},\n\n\t{s: \"clamped overflow 1\", remark: \"overflow\", bi: biMaxS, exp: MaxDecimal128Exp + 1},\n\t{s: \"clamped overflow 2\", remark: \"overflow\", bi: biNMaxS, exp: MaxDecimal128Exp + 1},\n\n\t{s: \"biMaxS+1 overflow\", remark: \"overflow\", bi: biOverflow, exp: MaxDecimal128Exp},\n\t{s: \"biNMaxS-1 overflow\", remark: \"overflow\", bi: biNOverflow, exp: MaxDecimal128Exp},\n\n\t{s: \"NaN\", h: 0x7c00000000000000, l: 0, remark: \"NaN\"},\n\t{s: \"Infinity\", h: 0x7800000000000000, l: 0, remark: \"Infinity\"},\n\t{s: \"-Infinity\", h: 0xf800000000000000, l: 0, remark: \"-Infinity\"},\n}\n\nfunc TestDecimal128_BigInt(t *testing.T) {\n\tfor _, c := range bigIntTestCases {\n\t\tt.Run(c.s, func(t *testing.T) {\n\t\t\tswitch c.remark {\n\t\t\tcase \"NaN\", \"Infinity\", \"-Infinity\":\n\t\t\t\td128 := NewDecimal128(c.h, c.l)\n\t\t\t\t_, _, err := d128.BigInt()\n\t\t\t\trequire.Error(t, err, \"case %s\", c.s)\n\t\t\tcase \"\":\n\t\t\t\td128 := NewDecimal128(c.h, c.l)\n\t\t\t\tbi, e, err := d128.BigInt()\n\t\t\t\trequire.NoError(t, err, \"case %s\", c.s)\n\t\t\t\trequire.Equal(t, 0, c.bi.Cmp(bi), \"case %s e:%s a:%s\", c.s, c.bi.String(), bi.String())\n\t\t\t\trequire.Equal(t, c.exp, e, \"case %s\", c.s, d128.String())\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc TestParseDecimal128FromBigInt(t *testing.T) {\n\tfor _, c := range bigIntTestCases {\n\t\tswitch c.remark {\n\t\tcase \"overflow\":\n\t\t\td128, ok := ParseDecimal128FromBigInt(c.bi, c.exp)\n\t\t\trequire.Equal(t, false, ok, \"case %s %s\", c.s, d128.String(), c.remark)\n\t\tcase \"\", \"rounding\", \"subnormal\", \"clamped\":\n\t\t\td128, ok := ParseDecimal128FromBigInt(c.bi, c.exp)\n\t\t\trequire.Equal(t, true, ok, \"case %s\", c.s)\n\t\t\trequire.Equal(t, c.s, d128.String(), \"case %s\", c.s)\n\n\t\t\trequire.Equal(t, c.h, d128.h, \"case %s\", c.s, d128.l)\n\t\t\trequire.Equal(t, c.l, d128.l, \"case %s\", c.s, d128.h)\n\t\t}\n\t}\n}\n\nfunc TestParseDecimal128(t *testing.T) {\n\tcases := make([]bigIntTestCase, 0, len(bigIntTestCases))\n\tcases = append(cases, bigIntTestCases...)\n\tcases = append(cases,\n\t\tbigIntTestCase{s: \"-0001231.453454000000565600000000E-21\", h: 0xafe6000003faa269, l: 0x81cfeceaabdb1800},\n\t\tbigIntTestCase{s: \"12345E+21\", h: 0x306a000000000000, l: 12345},\n\t\tbigIntTestCase{s: \"0.10000000000000000000000000000000000000000001\", remark: \"parse fail\"},\n\t\tbigIntTestCase{s: \".125e1\", h: 0x303c000000000000, l: 125},\n\t\tbigIntTestCase{s: \".125\", h: 0x303a000000000000, l: 125},\n\t\t// Test that parsing negative zero returns negative zero with a zero exponent.\n\t\tbigIntTestCase{s: \"-0\", h: 0xb040000000000000, l: 0},\n\t\t// Test that parsing negative zero with an in-range exponent returns negative zero and\n\t\t// preserves the specified exponent value.\n\t\tbigIntTestCase{s: \"-0E999\", h: 0xb80e000000000000, l: 0},\n\t\t// Test that parsing zero with an out-of-range positive exponent returns zero with the\n\t\t// maximum positive exponent (i.e. 0e+6111).\n\t\tbigIntTestCase{s: \"0E2000000000000\", h: 0x5ffe000000000000, l: 0},\n\t\t// Test that parsing zero with an out-of-range negative exponent returns zero with the\n\t\t// minimum negative exponent (i.e. 0e-6176).\n\t\tbigIntTestCase{s: \"-0E2000000000000\", h: 0xdffe000000000000, l: 0},\n\t\tbigIntTestCase{s: \"\", remark: \"parse fail\"})\n\n\tfor _, c := range cases {\n\t\tt.Run(c.s, func(t *testing.T) {\n\t\t\tswitch c.remark {\n\t\t\tcase \"overflow\", \"parse fail\":\n\t\t\t\t_, err := ParseDecimal128(c.s)\n\t\t\t\tassert.Error(t, err, \"ParseDecimal128(%q) should return an error\", c.s)\n\t\t\tdefault:\n\t\t\t\tgot, err := ParseDecimal128(c.s)\n\t\t\t\trequire.NoError(t, err, \"ParseDecimal128(%q) error\", c.s)\n\n\t\t\t\twant := Decimal128{h: c.h, l: c.l}\n\t\t\t\t// Decimal128 doesn't implement an equality function, so compare the expected\n\t\t\t\t// low/high uint64 values directly. Also print the string representation of each\n\t\t\t\t// number to make debugging failures easier.\n\t\t\t\tassert.Equal(t, want, got, \"ParseDecimal128(%q) = %s, want %s\", c.s, got, want)\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc TestDecimal128_JSON(t *testing.T) {\n\tt.Run(\"roundTrip\", func(t *testing.T) {\n\t\tdecimal := NewDecimal128(0x3040000000000000, 12345)\n\t\tbytes, err := json.Marshal(decimal)\n\t\tassert.Nil(t, err, \"json.Marshal error: %v\", err)\n\t\tgot := NewDecimal128(0, 0)\n\t\terr = json.Unmarshal(bytes, &got)\n\t\tassert.Nil(t, err, \"json.Unmarshal error: %v\", err)\n\t\tassert.Equal(t, decimal.h, got.h, \"expected h: %v got: %v\", decimal.h, got.h)\n\t\tassert.Equal(t, decimal.l, got.l, \"expected l: %v got: %v\", decimal.l, got.l)\n\t})\n\tt.Run(\"unmarshal extendedJSON\", func(t *testing.T) {\n\t\twant := NewDecimal128(0x3040000000000000, 12345)\n\t\textJSON := fmt.Sprintf(`{\"$numberDecimal\": %q}`, want.String())\n\n\t\tgot := NewDecimal128(0, 0)\n\t\terr := json.Unmarshal([]byte(extJSON), &got)\n\t\tassert.Nil(t, err, \"json.Unmarshal error: %v\", err)\n\t\tassert.Equal(t, want.h, got.h, \"expected h: %v got: %v\", want.h, got.h)\n\t\tassert.Equal(t, want.l, got.l, \"expected l: %v got: %v\", want.l, got.l)\n\t})\n\tt.Run(\"unmarshal null\", func(t *testing.T) {\n\t\twant := NewDecimal128(0, 0)\n\t\textJSON := `null`\n\n\t\tgot := NewDecimal128(0, 0)\n\t\terr := json.Unmarshal([]byte(extJSON), &got)\n\t\tassert.Nil(t, err, \"json.Unmarshal error: %v\", err)\n\t\tassert.Equal(t, want.h, got.h, \"expected h: %v got: %v\", want.h, got.h)\n\t\tassert.Equal(t, want.l, got.l, \"expected l: %v got: %v\", want.l, got.l)\n\t})\n\tt.Run(\"unmarshal\", func(t *testing.T) {\n\t\tcases := make([]bigIntTestCase, 0, len(bigIntTestCases))\n\t\tcases = append(cases, bigIntTestCases...)\n\t\tcases = append(cases,\n\t\t\tbigIntTestCase{s: \"-0001231.453454000000565600000000E-21\", h: 0xafe6000003faa269, l: 0x81cfeceaabdb1800},\n\t\t\tbigIntTestCase{s: \"12345E+21\", h: 0x306a000000000000, l: 12345},\n\t\t\tbigIntTestCase{s: \"0.10000000000000000000000000000000000000000001\", remark: \"parse fail\"},\n\t\t\tbigIntTestCase{s: \".125e1\", h: 0x303c000000000000, l: 125},\n\t\t\tbigIntTestCase{s: \".125\", h: 0x303a000000000000, l: 125})\n\n\t\tfor _, c := range cases {\n\t\t\tt.Run(c.s, func(t *testing.T) {\n\t\t\t\tinput := fmt.Sprintf(`{\"foo\": %q}`, c.s)\n\t\t\t\tvar got map[string]Decimal128\n\t\t\t\terr := json.Unmarshal([]byte(input), &got)\n\n\t\t\t\tswitch c.remark {\n\t\t\t\tcase \"overflow\", \"parse fail\":\n\t\t\t\t\tassert.NotNil(t, err, \"expected Unmarshal error, got nil\")\n\t\t\t\tdefault:\n\t\t\t\t\tassert.Nil(t, err, \"Unmarshal error: %v\", err)\n\t\t\t\t\tgotDecimal := got[\"foo\"]\n\t\t\t\t\tassert.Equal(t, c.h, gotDecimal.h, \"expected h: %v got: %v\", c.h, gotDecimal.l)\n\t\t\t\t\tassert.Equal(t, c.l, gotDecimal.l, \"expected l: %v got: %v\", c.l, gotDecimal.h)\n\t\t\t\t}\n\t\t\t})\n\t\t}\n\t})\n}\n" }, { "path": "bson/decode_value_fuzz_test.go", "content": "// Copyright (C) MongoDB, Inc. 2025-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"math\"\n\t\"strings\"\n\t\"testing\"\n)\n\nfunc FuzzDecodeValue(f *testing.F) {\n\t// Seed the fuzz corpus with all BSON values from the MarshalValue test\n\t// cases.\n\tfor _, tc := range marshalValueTestCases {\n\t\tf.Add(byte(tc.bsontype), tc.bytes)\n\t}\n\n\t// Also seed the fuzz corpus with special values that we want to test.\n\tvalues := []any{\n\t\t// int32, including max and min values.\n\t\tint32(0), int32(math.MaxInt32), int32(math.MinInt32),\n\t\t// int64, including max and min values.\n\t\tint64(0), int64(math.MaxInt64), int64(math.MinInt64),\n\t\t// string, including empty and large string.\n\t\t\"\", strings.Repeat(\"z\", 10_000),\n\t\t// map\n\t\tmap[string]any{\"nested\": []any{1, \"two\", map[string]any{\"three\": 3}}},\n\t\t// array\n\t\t[]any{1, 2, 3, \"four\"},\n\t}\n\n\tfor _, v := range values {\n\t\ttyp, b, err := MarshalValue(v)\n\t\tif err != nil {\n\t\t\tf.Fatal(err)\n\t\t}\n\t\tf.Add(byte(typ), b)\n\t}\n\n\tf.Fuzz(func(t *testing.T, bsonType byte, data []byte) {\n\t\tvar v any\n\t\tif err := UnmarshalValue(Type(bsonType), data, &v); err != nil {\n\t\t\treturn\n\t\t}\n\n\t\t// There is no value encoder for Go \"nil\" (nil values handled\n\t\t// differently by each type encoder), so skip anything that unmarshals\n\t\t// to \"nil\". It's not clear if MarshalValue should support \"nil\", but\n\t\t// for now we skip it.\n\t\tif v == nil {\n\t\t\tt.Logf(\"data unmarshaled to nil: %v\", data)\n\t\t\treturn\n\t\t}\n\n\t\ttyp, encoded, err := MarshalValue(v)\n\t\tif err != nil {\n\t\t\tt.Fatalf(\"failed to marshal: %v\", err)\n\t\t}\n\n\t\tvar v2 any\n\t\tif err := UnmarshalValue(typ, encoded, &v2); err != nil {\n\t\t\tt.Fatalf(\"failed to unmarshal: %v\", err)\n\t\t}\n\t})\n}\n" }, { "path": "bson/decoder.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"errors\"\n\t\"fmt\"\n\t\"reflect\"\n\t\"sync\"\n)\n\n// ErrDecodeToNil is the error returned when trying to decode to a nil value\nvar ErrDecodeToNil = errors.New(\"cannot Decode to nil value\")\n\n// This pool is used to keep the allocations of Decoders down. This is only used for the Marshal*\n// methods and is not consumable from outside of this package. The Decoders retrieved from this pool\n// must have both Reset and SetRegistry called on them.\nvar decPool = sync.Pool{\n\tNew: func() any {\n\t\treturn new(Decoder)\n\t},\n}\n\n// A Decoder reads and decodes BSON documents from a stream. It reads from a ValueReader as\n// the source of BSON data.\ntype Decoder struct {\n\tdc DecodeContext\n\tvr ValueReader\n}\n\n// NewDecoder returns a new decoder that reads from vr.\nfunc NewDecoder(vr ValueReader) *Decoder {\n\treturn &Decoder{\n\t\tdc: DecodeContext{Registry: defaultRegistry},\n\t\tvr: vr,\n\t}\n}\n\n// Decode reads the next BSON document from the stream and decodes it into the\n// value pointed to by val.\n//\n// See [Unmarshal] for details about BSON unmarshaling behavior.\nfunc (d *Decoder) Decode(val any) error {\n\tif unmarshaler, ok := val.(Unmarshaler); ok {\n\t\t// TODO(skriptble): Reuse a []byte here and use the AppendDocumentBytes method.\n\t\tbuf, err := copyDocumentToBytes(d.vr)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\treturn unmarshaler.UnmarshalBSON(buf)\n\t}\n\n\trval := reflect.ValueOf(val)\n\tswitch rval.Kind() {\n\tcase reflect.Ptr:\n\t\tif rval.IsNil() {\n\t\t\treturn ErrDecodeToNil\n\t\t}\n\t\trval = rval.Elem()\n\tcase reflect.Map:\n\t\tif rval.IsNil() {\n\t\t\treturn ErrDecodeToNil\n\t\t}\n\tdefault:\n\t\treturn fmt.Errorf(\"argument to Decode must be a pointer or a map, but got %v\", rval)\n\t}\n\tdecoder, err := d.dc.LookupDecoder(rval.Type())\n\tif err != nil {\n\t\treturn err\n\t}\n\n\treturn decoder.DecodeValue(d.dc, d.vr, rval)\n}\n\n// Reset will reset the state of the decoder, using the same *DecodeContext used in\n// the original construction but using vr for reading.\nfunc (d *Decoder) Reset(vr ValueReader) {\n\td.vr = vr\n}\n\n// SetRegistry replaces the current registry of the decoder with r.\nfunc (d *Decoder) SetRegistry(r *Registry) {\n\td.dc.Registry = r\n}\n\n// DefaultDocumentM causes the Decoder to always unmarshal documents into the bson.M type. This\n// behavior is restricted to data typed as \"any\" or \"map[string]any\".\nfunc (d *Decoder) DefaultDocumentM() {\n\td.dc.defaultDocumentType = reflect.TypeOf(M{})\n}\n\n// DefaultDocumentMap causes the Decoder to always unmarshal documents into the\n// map[string]any type. This behavior is restricted to data typed as \"any\" or\n// \"map[string]any\".\nfunc (d *Decoder) DefaultDocumentMap() {\n\td.dc.defaultDocumentType = reflect.TypeOf(map[string]any{})\n}\n\n// AllowTruncatingDoubles causes the Decoder to truncate the fractional part of BSON \"double\" values\n// when attempting to unmarshal them into a Go integer (int, int8, int16, int32, or int64) struct\n// field. The truncation logic does not apply to BSON \"decimal128\" values.\nfunc (d *Decoder) AllowTruncatingDoubles() {\n\td.dc.truncate = true\n}\n\n// BinaryAsSlice causes the Decoder to unmarshal BSON binary field values that are the \"Generic\" or\n// \"Old\" BSON binary subtype as a Go byte slice instead of a bson.Binary.\nfunc (d *Decoder) BinaryAsSlice() {\n\td.dc.binaryAsSlice = true\n}\n\n// ObjectIDAsHexString causes the Decoder to decode object IDs to their hex representation.\nfunc (d *Decoder) ObjectIDAsHexString() {\n\td.dc.objectIDAsHexString = true\n}\n\n// UseJSONStructTags causes the Decoder to fall back to using the \"json\" struct tag if a \"bson\"\n// struct tag is not specified.\nfunc (d *Decoder) UseJSONStructTags() {\n\td.dc.useJSONStructTags = true\n}\n\n// UseLocalTimeZone causes the Decoder to unmarshal time.Time values in the local timezone instead\n// of the UTC timezone.\nfunc (d *Decoder) UseLocalTimeZone() {\n\td.dc.useLocalTimeZone = true\n}\n\n// ZeroMaps causes the Decoder to delete any existing values from Go maps in the destination value\n// passed to Decode before unmarshaling BSON documents into them.\nfunc (d *Decoder) ZeroMaps() {\n\td.dc.zeroMaps = true\n}\n\n// ZeroStructs causes the Decoder to delete any existing values from Go structs in the destination\n// value passed to Decode before unmarshaling BSON documents into them.\nfunc (d *Decoder) ZeroStructs() {\n\td.dc.zeroStructs = true\n}\n" }, { "path": "bson/decoder_example_test.go", "content": "// Copyright (C) MongoDB, Inc. 2023-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson_test\n\nimport (\n\t\"bytes\"\n\t\"encoding/json\"\n\t\"errors\"\n\t\"fmt\"\n\t\"io\"\n\n\t\"go.mongodb.org/mongo-driver/v2/bson\"\n)\n\nfunc ExampleDecoder() {\n\t// Marshal a BSON document that contains the name, SKU, and price (in cents)\n\t// of a product.\n\tdoc := bson.D{\n\t\t{Key: \"name\", Value: \"Cereal Rounds\"},\n\t\t{Key: \"sku\", Value: \"AB12345\"},\n\t\t{Key: \"price_cents\", Value: 399},\n\t}\n\tdata, err := bson.Marshal(doc)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\t// Create a Decoder that reads the marshaled BSON document and use it to\n\t// unmarshal the document into a Product struct.\n\tdecoder := bson.NewDecoder(bson.NewDocumentReader(bytes.NewReader(data)))\n\n\ttype Product struct {\n\t\tName string `bson:\"name\"`\n\t\tSKU string `bson:\"sku\"`\n\t\tPrice int64 `bson:\"price_cents\"`\n\t}\n\n\tvar res Product\n\terr = decoder.Decode(&res)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tfmt.Printf(\"%+v\\n\", res)\n\t// Output: {Name:Cereal Rounds SKU:AB12345 Price:399}\n}\n\nfunc ExampleDecoder_DefaultDocumentM() {\n\t// Marshal a BSON document that contains a city name and a nested document\n\t// with various city properties.\n\tdoc := bson.D{\n\t\t{Key: \"name\", Value: \"New York\"},\n\t\t{Key: \"properties\", Value: bson.D{\n\t\t\t{Key: \"state\", Value: \"NY\"},\n\t\t\t{Key: \"population\", Value: 8_804_190},\n\t\t\t{Key: \"elevation\", Value: 10},\n\t\t}},\n\t}\n\tdata, err := bson.Marshal(doc)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\t// Create a Decoder that reads the marshaled BSON document and use it to unmarshal the document\n\t// into a City struct.\n\tdecoder := bson.NewDecoder(bson.NewDocumentReader(bytes.NewReader(data)))\n\n\ttype City struct {\n\t\tName string `bson:\"name\"`\n\t\tProperties any `bson:\"properties\"`\n\t}\n\n\t// Configure the Decoder to default to decoding BSON documents as the M\n\t// type if the decode destination has no type information. The Properties\n\t// field in the City struct will be decoded as a \"M\" (i.e. map) instead\n\t// of the default \"D\".\n\tdecoder.DefaultDocumentM()\n\n\tvar res City\n\terr = decoder.Decode(&res)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tdata, err = json.Marshal(res)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Printf(\"%+v\\n\", string(data))\n\t// Output: {\"Name\":\"New York\",\"Properties\":{\"elevation\":10,\"population\":8804190,\"state\":\"NY\"}}\n}\n\nfunc ExampleDecoder_DefaultDocumentMap() {\n\t// Marshal a BSON document that contains a city name and a nested document\n\t// with various city properties.\n\tdoc := bson.D{\n\t\t{Key: \"name\", Value: \"New York\"},\n\t\t{Key: \"properties\", Value: bson.D{\n\t\t\t{Key: \"state\", Value: \"NY\"},\n\t\t\t{Key: \"population\", Value: 8_804_190},\n\t\t\t{Key: \"elevation\", Value: 10},\n\t\t}},\n\t}\n\tdata, err := bson.Marshal(doc)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\t// Create a Decoder that reads the marshaled BSON document and use it to unmarshal the document\n\t// into a City struct.\n\tdecoder := bson.NewDecoder(bson.NewDocumentReader(bytes.NewReader(data)))\n\n\ttype City struct {\n\t\tName string `bson:\"name\"`\n\t\tProperties any `bson:\"properties\"`\n\t}\n\n\t// Configure the Decoder to default to decoding BSON documents as a\n\t// map[string]any type if the decode destination has no type information. The\n\t// Properties field in the City struct will be decoded as map[string]any\n\t// instead of the default \"D\".\n\tdecoder.DefaultDocumentMap()\n\n\tvar res City\n\terr = decoder.Decode(&res)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tdata, err = json.Marshal(res)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Printf(\"%+v\\n\", string(data))\n\t// Output: {\"Name\":\"New York\",\"Properties\":{\"elevation\":10,\"population\":8804190,\"state\":\"NY\"}}\n}\n\nfunc ExampleDecoder_UseJSONStructTags() {\n\t// Marshal a BSON document that contains the name, SKU, and price (in cents)\n\t// of a product.\n\tdoc := bson.D{\n\t\t{Key: \"name\", Value: \"Cereal Rounds\"},\n\t\t{Key: \"sku\", Value: \"AB12345\"},\n\t\t{Key: \"price_cents\", Value: 399},\n\t}\n\tdata, err := bson.Marshal(doc)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\t// Create a Decoder that reads the marshaled BSON document and use it to\n\t// unmarshal the document into a Product struct.\n\tdecoder := bson.NewDecoder(bson.NewDocumentReader(bytes.NewReader(data)))\n\n\ttype Product struct {\n\t\tName string `json:\"name\"`\n\t\tSKU string `json:\"sku\"`\n\t\tPrice int64 `json:\"price_cents\"`\n\t}\n\n\t// Configure the Decoder to use \"json\" struct tags when decoding if \"bson\"\n\t// struct tags are not present.\n\tdecoder.UseJSONStructTags()\n\n\tvar res Product\n\terr = decoder.Decode(&res)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tfmt.Printf(\"%+v\\n\", res)\n\t// Output: {Name:Cereal Rounds SKU:AB12345 Price:399}\n}\n\nfunc ExampleDecoder_extendedJSON() {\n\t// Define an Extended JSON document that contains the name, SKU, and price\n\t// (in cents) of a product.\n\tdata := []byte(`{\"name\":\"Cereal Rounds\",\"sku\":\"AB12345\",\"price_cents\":{\"$numberLong\":\"399\"}}`)\n\n\t// Create a Decoder that reads the Extended JSON document and use it to\n\t// unmarshal the document into a Product struct.\n\tvr, err := bson.NewExtJSONValueReader(bytes.NewReader(data), true)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdecoder := bson.NewDecoder(vr)\n\n\ttype Product struct {\n\t\tName string `bson:\"name\"`\n\t\tSKU string `bson:\"sku\"`\n\t\tPrice int64 `bson:\"price_cents\"`\n\t}\n\n\tvar res Product\n\terr = decoder.Decode(&res)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tfmt.Printf(\"%+v\\n\", res)\n\t// Output: {Name:Cereal Rounds SKU:AB12345 Price:399}\n}\n\nfunc ExampleDecoder_multipleExtendedJSONDocuments() {\n\t// Define a newline-separated sequence of Extended JSON documents that\n\t// contain X,Y coordinates.\n\tdata := []byte(`\n{\"x\":{\"$numberInt\":\"0\"},\"y\":{\"$numberInt\":\"0\"}}\n{\"x\":{\"$numberInt\":\"1\"},\"y\":{\"$numberInt\":\"1\"}}\n{\"x\":{\"$numberInt\":\"2\"},\"y\":{\"$numberInt\":\"2\"}}\n{\"x\":{\"$numberInt\":\"3\"},\"y\":{\"$numberInt\":\"3\"}}\n{\"x\":{\"$numberInt\":\"4\"},\"y\":{\"$numberInt\":\"4\"}}\n`)\n\n\t// Create a Decoder that reads the Extended JSON documents and use it to\n\t// unmarshal the documents Coordinate structs.\n\tvr, err := bson.NewExtJSONValueReader(bytes.NewReader(data), true)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdecoder := bson.NewDecoder(vr)\n\n\ttype Coordinate struct {\n\t\tX int\n\t\tY int\n\t}\n\n\t// Read and unmarshal each Extended JSON document from the sequence. If\n\t// Decode returns error io.EOF, that means the Decoder has reached the end\n\t// of the input, so break the loop.\n\tfor {\n\t\tvar res Coordinate\n\t\terr = decoder.Decode(&res)\n\t\tif errors.Is(err, io.EOF) {\n\t\t\tbreak\n\t\t}\n\t\tif err != nil {\n\t\t\tpanic(err)\n\t\t}\n\n\t\tfmt.Printf(\"%+v\\n\", res)\n\t}\n\t// Output:\n\t// {X:0 Y:0}\n\t// {X:1 Y:1}\n\t// {X:2 Y:2}\n\t// {X:3 Y:3}\n\t// {X:4 Y:4}\n}\n" }, { "path": "bson/decoder_test.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"bytes\"\n\t\"errors\"\n\t\"reflect\"\n\t\"testing\"\n\t\"time\"\n\n\t\"go.mongodb.org/mongo-driver/v2/internal/assert\"\n\t\"go.mongodb.org/mongo-driver/v2/internal/require\"\n\t\"go.mongodb.org/mongo-driver/v2/x/bsonx/bsoncore\"\n)\n\nfunc TestDecodeValue(t *testing.T) {\n\tt.Parallel()\n\n\tfor _, tc := range unmarshalingTestCases() {\n\t\ttc := tc\n\n\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\tt.Parallel()\n\n\t\t\tgot := reflect.New(tc.sType).Elem()\n\t\t\tvr := NewDocumentReader(bytes.NewReader(tc.data))\n\t\t\treg := defaultRegistry\n\t\t\tdecoder, err := reg.LookupDecoder(reflect.TypeOf(got))\n\t\t\tnoerr(t, err)\n\t\t\terr = decoder.DecodeValue(DecodeContext{Registry: reg}, vr, got)\n\t\t\tnoerr(t, err)\n\t\t\tassert.Equal(t, tc.want, got.Addr().Interface(), \"Results do not match.\")\n\t\t})\n\t}\n}\n\nfunc TestDecodingInterfaces(t *testing.T) {\n\tt.Parallel()\n\n\ttype testCase struct {\n\t\tname string\n\t\tstub func() ([]byte, any, func(*testing.T))\n\t}\n\ttestCases := []testCase{\n\t\t{\n\t\t\tname: \"struct with interface containing a concrete value\",\n\t\t\tstub: func() ([]byte, any, func(*testing.T)) {\n\t\t\t\ttype testStruct struct {\n\t\t\t\t\tValue any\n\t\t\t\t}\n\t\t\t\tvar value string\n\n\t\t\t\tdata := docToBytes(struct {\n\t\t\t\t\tValue string\n\t\t\t\t}{\n\t\t\t\t\tValue: \"foo\",\n\t\t\t\t})\n\n\t\t\t\treceiver := testStruct{&value}\n\n\t\t\t\tcheck := func(t *testing.T) {\n\t\t\t\t\tt.Helper()\n\t\t\t\t\tassert.Equal(t, \"foo\", value)\n\t\t\t\t}\n\n\t\t\t\treturn data, &receiver, check\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"struct with interface containing a struct\",\n\t\t\tstub: func() ([]byte, any, func(*testing.T)) {\n\t\t\t\ttype demo struct {\n\t\t\t\t\tData string\n\t\t\t\t}\n\n\t\t\t\ttype testStruct struct {\n\t\t\t\t\tValue any\n\t\t\t\t}\n\t\t\t\tvar value demo\n\n\t\t\t\tdata := docToBytes(struct {\n\t\t\t\t\tValue demo\n\t\t\t\t}{\n\t\t\t\t\tValue: demo{\"foo\"},\n\t\t\t\t})\n\n\t\t\t\treceiver := testStruct{&value}\n\n\t\t\t\tcheck := func(t *testing.T) {\n\t\t\t\t\tt.Helper()\n\t\t\t\t\tassert.Equal(t, \"foo\", value.Data)\n\t\t\t\t}\n\n\t\t\t\treturn data, &receiver, check\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"struct with interface containing a slice\",\n\t\t\tstub: func() ([]byte, any, func(*testing.T)) {\n\t\t\t\ttype testStruct struct {\n\t\t\t\t\tValues any\n\t\t\t\t}\n\t\t\t\tvar values []string\n\n\t\t\t\tdata := docToBytes(struct {\n\t\t\t\t\tValues []string\n\t\t\t\t}{\n\t\t\t\t\tValues: []string{\"foo\", \"bar\"},\n\t\t\t\t})\n\n\t\t\t\treceiver := testStruct{&values}\n\n\t\t\t\tcheck := func(t *testing.T) {\n\t\t\t\t\tt.Helper()\n\t\t\t\t\tassert.Equal(t, []string{\"foo\", \"bar\"}, values)\n\t\t\t\t}\n\n\t\t\t\treturn data, &receiver, check\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"struct with interface containing an array\",\n\t\t\tstub: func() ([]byte, any, func(*testing.T)) {\n\t\t\t\ttype testStruct struct {\n\t\t\t\t\tValues any\n\t\t\t\t}\n\t\t\t\tvar values [2]string\n\n\t\t\t\tdata := docToBytes(struct {\n\t\t\t\t\tValues []string\n\t\t\t\t}{\n\t\t\t\t\tValues: []string{\"foo\", \"bar\"},\n\t\t\t\t})\n\n\t\t\t\treceiver := testStruct{&values}\n\n\t\t\t\tcheck := func(t *testing.T) {\n\t\t\t\t\tt.Helper()\n\t\t\t\t\tassert.Equal(t, [2]string{\"foo\", \"bar\"}, values)\n\t\t\t\t}\n\n\t\t\t\treturn data, &receiver, check\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"struct with interface array containing concrete values\",\n\t\t\tstub: func() ([]byte, any, func(*testing.T)) {\n\t\t\t\ttype testStruct struct {\n\t\t\t\t\tValues [3]any\n\t\t\t\t}\n\t\t\t\tvar str string\n\t\t\t\tvar i, j int\n\n\t\t\t\tdata := docToBytes(struct {\n\t\t\t\t\tValues []any\n\t\t\t\t}{\n\t\t\t\t\tValues: []any{\"foo\", 42, nil},\n\t\t\t\t})\n\n\t\t\t\treceiver := testStruct{[3]any{&str, &i, &j}}\n\n\t\t\t\tcheck := func(t *testing.T) {\n\t\t\t\t\tt.Helper()\n\t\t\t\t\tassert.Equal(t, \"foo\", str)\n\t\t\t\t\tassert.Equal(t, 42, i)\n\t\t\t\t\tassert.Equal(t, 0, j)\n\t\t\t\t\tassert.Equal(t, testStruct{[3]any{&str, &i, nil}}, receiver)\n\t\t\t\t}\n\n\t\t\t\treturn data, &receiver, check\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"overwriting prepopulated slice\",\n\t\t\tstub: func() ([]byte, any, func(*testing.T)) {\n\t\t\t\ttype testStruct struct {\n\t\t\t\t\tValues []any\n\t\t\t\t}\n\n\t\t\t\tdata := docToBytes(struct {\n\t\t\t\t\tValues []any\n\t\t\t\t}{\n\t\t\t\t\tValues: []any{1, 2, 3},\n\t\t\t\t})\n\n\t\t\t\treceiver := testStruct{[]any{7, 8}}\n\n\t\t\t\tcheck := func(t *testing.T) {\n\t\t\t\t\tt.Helper()\n\t\t\t\t\tassert.Equal(t, testStruct{[]any{1, 2, int32(3)}}, receiver)\n\t\t\t\t}\n\n\t\t\t\treturn data, &receiver, check\n\t\t\t},\n\t\t},\n\t}\n\tfor _, tc := range testCases {\n\t\ttc := tc\n\n\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\tt.Parallel()\n\n\t\t\tdata, receiver, check := tc.stub()\n\t\t\tgot := reflect.ValueOf(receiver).Elem()\n\t\t\tvr := NewDocumentReader(bytes.NewReader(data))\n\t\t\treg := defaultRegistry\n\t\t\tdecoder, err := reg.LookupDecoder(got.Type())\n\t\t\tnoerr(t, err)\n\t\t\terr = decoder.DecodeValue(DecodeContext{Registry: reg}, vr, got)\n\t\t\tnoerr(t, err)\n\t\t\tcheck(t)\n\t\t})\n\t}\n}\n\nfunc TestDecoder(t *testing.T) {\n\tt.Parallel()\n\n\tt.Run(\"Decode\", func(t *testing.T) {\n\t\tt.Parallel()\n\n\t\tt.Run(\"basic\", func(t *testing.T) {\n\t\t\tt.Parallel()\n\n\t\t\tfor _, tc := range unmarshalingTestCases() {\n\t\t\t\ttc := tc\n\n\t\t\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\t\t\tt.Parallel()\n\n\t\t\t\t\tgot := reflect.New(tc.sType).Interface()\n\t\t\t\t\tvr := NewDocumentReader(bytes.NewReader(tc.data))\n\t\t\t\t\tdec := NewDecoder(vr)\n\t\t\t\t\terr := dec.Decode(got)\n\t\t\t\t\tnoerr(t, err)\n\t\t\t\t\tassert.Equal(t, tc.want, got, \"Results do not match.\")\n\t\t\t\t})\n\t\t\t}\n\t\t})\n\t\tt.Run(\"stream\", func(t *testing.T) {\n\t\t\tt.Parallel()\n\n\t\t\tvar buf bytes.Buffer\n\t\t\tvr := NewDocumentReader(&buf)\n\t\t\tdec := NewDecoder(vr)\n\t\t\tfor _, tc := range unmarshalingTestCases() {\n\t\t\t\ttc := tc\n\n\t\t\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\t\t\tbuf.Write(tc.data)\n\t\t\t\t\tgot := reflect.New(tc.sType).Interface()\n\t\t\t\t\terr := dec.Decode(got)\n\t\t\t\t\tnoerr(t, err)\n\t\t\t\t\tassert.Equal(t, tc.want, got, \"Results do not match.\")\n\t\t\t\t})\n\t\t\t}\n\t\t})\n\t\tt.Run(\"lookup error\", func(t *testing.T) {\n\t\t\tt.Parallel()\n\n\t\t\ttype certainlydoesntexistelsewhereihope func(string, string) string\n\t\t\t// Avoid unused code lint error.\n\t\t\t_ = certainlydoesntexistelsewhereihope(func(string, string) string { return \"\" })\n\n\t\t\tcdeih := func(string, string) string { return \"certainlydoesntexistelsewhereihope\" }\n\t\t\tdec := NewDecoder(NewDocumentReader(bytes.NewReader([]byte{})))\n\t\t\twant := errNoDecoder{Type: reflect.TypeOf(cdeih)}\n\t\t\tgot := dec.Decode(&cdeih)\n\t\t\tassert.Equal(t, want, got, \"Received unexpected error.\")\n\t\t})\n\t\tt.Run(\"Unmarshaler\", func(t *testing.T) {\n\t\t\tt.Parallel()\n\n\t\t\ttestCases := []struct {\n\t\t\t\tname string\n\t\t\t\terr error\n\t\t\t\tvr ValueReader\n\t\t\t\tinvoked bool\n\t\t\t}{\n\t\t\t\t{\n\t\t\t\t\t\"error\",\n\t\t\t\t\terrors.New(\"Unmarshaler error\"),\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeEmbeddedDocument, Err: ErrEOD, ErrAfter: readElement},\n\t\t\t\t\ttrue,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"copy error\",\n\t\t\t\t\terrors.New(\"copy error\"),\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"copy error\"), ErrAfter: readDocument},\n\t\t\t\t\tfalse,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success\",\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeEmbeddedDocument, Err: ErrEOD, ErrAfter: readElement},\n\t\t\t\t\ttrue,\n\t\t\t\t},\n\t\t\t}\n\n\t\t\tfor _, tc := range testCases {\n\t\t\t\ttc := tc\n\n\t\t\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\t\t\tt.Parallel()\n\n\t\t\t\t\tunmarshaler := &testUnmarshaler{Err: tc.err}\n\t\t\t\t\tdec := NewDecoder(tc.vr)\n\t\t\t\t\tgot := dec.Decode(unmarshaler)\n\t\t\t\t\twant := tc.err\n\t\t\t\t\tif !assert.CompareErrors(got, want) {\n\t\t\t\t\t\tt.Errorf(\"Did not receive expected error. got %v; want %v\", got, want)\n\t\t\t\t\t}\n\t\t\t\t\tif unmarshaler.Invoked != tc.invoked {\n\t\t\t\t\t\tif tc.invoked {\n\t\t\t\t\t\t\tt.Error(\"Expected to have UnmarshalBSON invoked, but it wasn't.\")\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tt.Error(\"Expected UnmarshalBSON to not be invoked, but it was.\")\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t}\n\n\t\t\tt.Run(\"Unmarshaler/success ValueReader\", func(t *testing.T) {\n\t\t\t\tt.Parallel()\n\n\t\t\t\twant := bsoncore.BuildDocument(nil, bsoncore.AppendDoubleElement(nil, \"pi\", 3.14159))\n\t\t\t\tunmarshaler := &testUnmarshaler{}\n\t\t\t\tvr := NewDocumentReader(bytes.NewReader(want))\n\t\t\t\tdec := NewDecoder(vr)\n\t\t\t\terr := dec.Decode(unmarshaler)\n\t\t\t\tnoerr(t, err)\n\t\t\t\tgot := unmarshaler.Val\n\t\t\t\tif !bytes.Equal(got, want) {\n\t\t\t\t\tt.Errorf(\"Did not unmarshal properly. got %v; want %v\", got, want)\n\t\t\t\t}\n\t\t\t})\n\t\t})\n\t})\n\tt.Run(\"NewDecoder\", func(t *testing.T) {\n\t\tt.Parallel()\n\n\t\tt.Run(\"success\", func(t *testing.T) {\n\t\t\tt.Parallel()\n\n\t\t\tgot := NewDecoder(NewDocumentReader(bytes.NewReader([]byte{})))\n\t\t\tif got == nil {\n\t\t\t\tt.Errorf(\"Was expecting a non-nil Decoder, but got \")\n\t\t\t}\n\t\t})\n\t})\n\tt.Run(\"NewDecoderWithContext\", func(t *testing.T) {\n\t\tt.Parallel()\n\n\t\tt.Run(\"success\", func(t *testing.T) {\n\t\t\tt.Parallel()\n\n\t\t\tgot := NewDecoder(NewDocumentReader(bytes.NewReader([]byte{})))\n\t\t\tif got == nil {\n\t\t\t\tt.Errorf(\"Was expecting a non-nil Decoder, but got \")\n\t\t\t}\n\t\t})\n\t})\n\tt.Run(\"Decode doesn't zero struct\", func(t *testing.T) {\n\t\tt.Parallel()\n\n\t\ttype foo struct {\n\t\t\tItem string\n\t\t\tQty int\n\t\t\tBonus int\n\t\t}\n\t\tvar got foo\n\t\tgot.Item = \"apple\"\n\t\tgot.Bonus = 2\n\t\tdata := docToBytes(D{{\"item\", \"canvas\"}, {\"qty\", 4}})\n\t\tvr := NewDocumentReader(bytes.NewReader(data))\n\t\tdec := NewDecoder(vr)\n\t\terr := dec.Decode(&got)\n\t\tnoerr(t, err)\n\t\twant := foo{Item: \"canvas\", Qty: 4, Bonus: 2}\n\t\tassert.Equal(t, want, got, \"Results do not match.\")\n\t})\n\tt.Run(\"Reset\", func(t *testing.T) {\n\t\tt.Parallel()\n\n\t\tvr1, vr2 := NewDocumentReader(bytes.NewReader([]byte{})), NewDocumentReader(bytes.NewReader([]byte{}))\n\t\tdec := NewDecoder(vr1)\n\t\tif dec.vr != vr1 {\n\t\t\tt.Errorf(\"Decoder should use the value reader provided. got %v; want %v\", dec.vr, vr1)\n\t\t}\n\t\tdec.Reset(vr2)\n\t\tif dec.vr != vr2 {\n\t\t\tt.Errorf(\"Decoder should use the value reader provided. got %v; want %v\", dec.vr, vr2)\n\t\t}\n\t})\n\tt.Run(\"SetRegistry\", func(t *testing.T) {\n\t\tt.Parallel()\n\n\t\tr1, r2 := defaultRegistry, NewRegistry()\n\t\tdc1 := DecodeContext{Registry: r1}\n\t\tdc2 := DecodeContext{Registry: r2}\n\t\tdec := NewDecoder(NewDocumentReader(bytes.NewReader([]byte{})))\n\t\tif !reflect.DeepEqual(dec.dc, dc1) {\n\t\t\tt.Errorf(\"Decoder should use the Registry provided. got %v; want %v\", dec.dc, dc1)\n\t\t}\n\t\tdec.SetRegistry(r2)\n\t\tif !reflect.DeepEqual(dec.dc, dc2) {\n\t\t\tt.Errorf(\"Decoder should use the Registry provided. got %v; want %v\", dec.dc, dc2)\n\t\t}\n\t})\n\tt.Run(\"DecodeToNil\", func(t *testing.T) {\n\t\tt.Parallel()\n\n\t\tdata := docToBytes(D{{\"item\", \"canvas\"}, {\"qty\", 4}})\n\t\tvr := NewDocumentReader(bytes.NewReader(data))\n\t\tdec := NewDecoder(vr)\n\n\t\tvar got *D\n\t\terr := dec.Decode(got)\n\t\tif !errors.Is(err, ErrDecodeToNil) {\n\t\t\tt.Fatalf(\"Decode error mismatch; expected %v, got %v\", ErrDecodeToNil, err)\n\t\t}\n\t})\n}\n\ntype testUnmarshaler struct {\n\tInvoked bool\n\tVal []byte\n\tErr error\n}\n\nfunc (tu *testUnmarshaler) UnmarshalBSON(d []byte) error {\n\ttu.Invoked = true\n\ttu.Val = d\n\treturn tu.Err\n}\n\nfunc TestDecoderConfiguration(t *testing.T) {\n\ttype truncateDoublesTest struct {\n\t\tMyInt int\n\t\tMyInt8 int8\n\t\tMyInt16 int16\n\t\tMyInt32 int32\n\t\tMyInt64 int64\n\t\tMyUint uint\n\t\tMyUint8 uint8\n\t\tMyUint16 uint16\n\t\tMyUint32 uint32\n\t\tMyUint64 uint64\n\t}\n\n\ttype objectIDTest struct {\n\t\tID string\n\t}\n\n\ttype jsonStructTest struct {\n\t\tStructFieldName string `json:\"jsonFieldName\"`\n\t}\n\n\ttype localTimeZoneTest struct {\n\t\tMyTime time.Time\n\t}\n\n\ttype zeroMapsTest struct {\n\t\tMyMap map[string]string\n\t}\n\n\ttype zeroStructsTest struct {\n\t\tMyString string\n\t\tMyInt int\n\t}\n\n\ttestCases := []struct {\n\t\tdescription string\n\t\tconfigure func(*Decoder)\n\t\tinput []byte\n\t\tdecodeInto func() any\n\t\twant any\n\t}{\n\t\t// Test that AllowTruncatingDoubles causes the Decoder to unmarshal BSON doubles with\n\t\t// fractional parts into Go integer types by truncating the fractional part.\n\t\t{\n\t\t\tdescription: \"AllowTruncatingDoubles\",\n\t\t\tconfigure: func(dec *Decoder) {\n\t\t\t\tdec.AllowTruncatingDoubles()\n\t\t\t},\n\t\t\tinput: bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendDouble(\"myInt\", 1.999).\n\t\t\t\tAppendDouble(\"myInt8\", 1.999).\n\t\t\t\tAppendDouble(\"myInt16\", 1.999).\n\t\t\t\tAppendDouble(\"myInt32\", 1.999).\n\t\t\t\tAppendDouble(\"myInt64\", 1.999).\n\t\t\t\tAppendDouble(\"myUint\", 1.999).\n\t\t\t\tAppendDouble(\"myUint8\", 1.999).\n\t\t\t\tAppendDouble(\"myUint16\", 1.999).\n\t\t\t\tAppendDouble(\"myUint32\", 1.999).\n\t\t\t\tAppendDouble(\"myUint64\", 1.999).\n\t\t\t\tBuild(),\n\t\t\tdecodeInto: func() any { return &truncateDoublesTest{} },\n\t\t\twant: &truncateDoublesTest{\n\t\t\t\tMyInt: 1,\n\t\t\t\tMyInt8: 1,\n\t\t\t\tMyInt16: 1,\n\t\t\t\tMyInt32: 1,\n\t\t\t\tMyInt64: 1,\n\t\t\t\tMyUint: 1,\n\t\t\t\tMyUint8: 1,\n\t\t\t\tMyUint16: 1,\n\t\t\t\tMyUint32: 1,\n\t\t\t\tMyUint64: 1,\n\t\t\t},\n\t\t},\n\t\t// Test that BinaryAsSlice causes the Decoder to unmarshal BSON binary fields into Go byte\n\t\t// slices when there is no type information (e.g when unmarshaling into a bson.D).\n\t\t{\n\t\t\tdescription: \"BinaryAsSlice\",\n\t\t\tconfigure: func(dec *Decoder) {\n\t\t\t\tdec.BinaryAsSlice()\n\t\t\t},\n\t\t\tinput: bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendBinary(\"myBinary\", TypeBinaryGeneric, []byte{}).\n\t\t\t\tBuild(),\n\t\t\tdecodeInto: func() any { return &D{} },\n\t\t\twant: &D{{Key: \"myBinary\", Value: []byte{}}},\n\t\t},\n\t\t// Test that the default decoder always decodes BSON documents into bson.D values,\n\t\t// independent of the top-level Go value type.\n\t\t{\n\t\t\tdescription: \"DocumentD nested by default\",\n\t\t\tconfigure: func(_ *Decoder) {},\n\t\t\tinput: bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendDocument(\"myDocument\", bsoncore.NewDocumentBuilder().\n\t\t\t\t\tAppendString(\"myString\", \"test value\").\n\t\t\t\t\tBuild()).\n\t\t\t\tBuild(),\n\t\t\tdecodeInto: func() any { return M{} },\n\t\t\twant: M{\n\t\t\t\t\"myDocument\": D{{Key: \"myString\", Value: \"test value\"}},\n\t\t\t},\n\t\t},\n\t\t// Test that DefaultDocumentM always decodes BSON documents into bson.M values,\n\t\t// independent of the top-level Go value type.\n\t\t{\n\t\t\tdescription: \"DefaultDocumentM nested\",\n\t\t\tconfigure: func(dec *Decoder) {\n\t\t\t\tdec.DefaultDocumentM()\n\t\t\t},\n\t\t\tinput: bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendDocument(\"myDocument\", bsoncore.NewDocumentBuilder().\n\t\t\t\t\tAppendString(\"myString\", \"test value\").\n\t\t\t\t\tBuild()).\n\t\t\t\tBuild(),\n\t\t\tdecodeInto: func() any { return &D{} },\n\t\t\twant: &D{\n\t\t\t\t{Key: \"myDocument\", Value: M{\"myString\": \"test value\"}},\n\t\t\t},\n\t\t},\n\t\t// Test that DefaultDocumentMap always decodes BSON documents into\n\t\t// map[string]any values, independent of the top-level Go value type.\n\t\t{\n\t\t\tdescription: \"DefaultDocumentMap nested\",\n\t\t\tconfigure: func(dec *Decoder) {\n\t\t\t\tdec.DefaultDocumentMap()\n\t\t\t},\n\t\t\tinput: bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendDocument(\"myDocument\", bsoncore.NewDocumentBuilder().\n\t\t\t\t\tAppendString(\"myString\", \"test value\").\n\t\t\t\t\tBuild()).\n\t\t\t\tBuild(),\n\t\t\tdecodeInto: func() any { return &D{} },\n\t\t\twant: &D{\n\t\t\t\t{Key: \"myDocument\", Value: map[string]any{\"myString\": \"test value\"}},\n\t\t\t},\n\t\t},\n\t\t// Test that ObjectIDAsHexString causes the Decoder to decode object ID to hex.\n\t\t{\n\t\t\tdescription: \"ObjectIDAsHexString\",\n\t\t\tconfigure: func(dec *Decoder) {\n\t\t\t\tdec.ObjectIDAsHexString()\n\t\t\t},\n\t\t\tinput: bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendObjectID(\"id\", func() ObjectID {\n\t\t\t\t\tid, _ := ObjectIDFromHex(\"5ef7fdd91c19e3222b41b839\")\n\t\t\t\t\treturn id\n\t\t\t\t}()).\n\t\t\t\tBuild(),\n\t\t\tdecodeInto: func() any { return &objectIDTest{} },\n\t\t\twant: &objectIDTest{ID: \"5ef7fdd91c19e3222b41b839\"},\n\t\t},\n\t\t// Test that UseJSONStructTags causes the Decoder to fall back to \"json\" struct tags if\n\t\t// \"bson\" struct tags are not available.\n\t\t{\n\t\t\tdescription: \"UseJSONStructTags\",\n\t\t\tconfigure: func(dec *Decoder) {\n\t\t\t\tdec.UseJSONStructTags()\n\t\t\t},\n\t\t\tinput: bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendString(\"jsonFieldName\", \"test value\").\n\t\t\t\tBuild(),\n\t\t\tdecodeInto: func() any { return &jsonStructTest{} },\n\t\t\twant: &jsonStructTest{StructFieldName: \"test value\"},\n\t\t},\n\t\t// Test that UseLocalTimeZone causes the Decoder to use the local time zone for decoded\n\t\t// time.Time values instead of UTC.\n\t\t{\n\t\t\tdescription: \"UseLocalTimeZone\",\n\t\t\tconfigure: func(dec *Decoder) {\n\t\t\t\tdec.UseLocalTimeZone()\n\t\t\t},\n\t\t\tinput: bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendDateTime(\"myTime\", 1684349179939).\n\t\t\t\tBuild(),\n\t\t\tdecodeInto: func() any { return &localTimeZoneTest{} },\n\t\t\twant: &localTimeZoneTest{MyTime: time.UnixMilli(1684349179939)},\n\t\t},\n\t\t// Test that ZeroMaps causes the Decoder to empty any Go map values before decoding BSON\n\t\t// documents into them.\n\t\t{\n\t\t\tdescription: \"ZeroMaps\",\n\t\t\tconfigure: func(dec *Decoder) {\n\t\t\t\tdec.ZeroMaps()\n\t\t\t},\n\t\t\tinput: bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendDocument(\"myMap\", bsoncore.NewDocumentBuilder().\n\t\t\t\t\tAppendString(\"myString\", \"test value\").\n\t\t\t\t\tBuild()).\n\t\t\t\tBuild(),\n\t\t\tdecodeInto: func() any {\n\t\t\t\treturn &zeroMapsTest{MyMap: map[string]string{\"myExtraValue\": \"extra value\"}}\n\t\t\t},\n\t\t\twant: &zeroMapsTest{MyMap: map[string]string{\"myString\": \"test value\"}},\n\t\t},\n\t\t// Test that ZeroStructs causes the Decoder to empty any Go struct values before decoding\n\t\t// BSON documents into them.\n\t\t{\n\t\t\tdescription: \"ZeroStructs\",\n\t\t\tconfigure: func(dec *Decoder) {\n\t\t\t\tdec.ZeroStructs()\n\t\t\t},\n\t\t\tinput: bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendString(\"myString\", \"test value\").\n\t\t\t\tBuild(),\n\t\t\tdecodeInto: func() any {\n\t\t\t\treturn &zeroStructsTest{MyInt: 1}\n\t\t\t},\n\t\t\twant: &zeroStructsTest{MyString: \"test value\"},\n\t\t},\n\t}\n\n\tfor _, tc := range testCases {\n\t\ttc := tc // Capture range variable.\n\n\t\tt.Run(tc.description, func(t *testing.T) {\n\t\t\tt.Parallel()\n\n\t\t\tdec := NewDecoder(NewDocumentReader(bytes.NewReader(tc.input)))\n\n\t\t\ttc.configure(dec)\n\n\t\t\tgot := tc.decodeInto()\n\t\t\terr := dec.Decode(got)\n\t\t\trequire.NoError(t, err, \"Decode error\")\n\n\t\t\tassert.Equal(t, tc.want, got, \"expected and actual decode results do not match\")\n\t\t})\n\t}\n\n\tt.Run(\"Decoding an object ID to string\", func(t *testing.T) {\n\t\tt.Parallel()\n\n\t\ttype objectIDTest struct {\n\t\t\tID string\n\t\t}\n\n\t\tdoc := bsoncore.NewDocumentBuilder().\n\t\t\tAppendObjectID(\"id\", func() ObjectID {\n\t\t\t\tid, _ := ObjectIDFromHex(\"5ef7fdd91c19e3222b41b839\")\n\t\t\t\treturn id\n\t\t\t}()).\n\t\t\tBuild()\n\n\t\tdec := NewDecoder(NewDocumentReader(bytes.NewReader(doc)))\n\n\t\tvar got objectIDTest\n\t\terr := dec.Decode(&got)\n\t\tconst want = \"error decoding key id: decoding an object ID into a string is not supported by default (set Decoder.ObjectIDAsHexString to enable decoding as a hexadecimal string)\"\n\t\tassert.EqualError(t, err, want)\n\t})\n\tt.Run(\"DefaultDocumentM top-level\", func(t *testing.T) {\n\t\tt.Parallel()\n\n\t\tinput := bsoncore.NewDocumentBuilder().\n\t\t\tAppendDocument(\"myDocument\", bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendString(\"myString\", \"test value\").\n\t\t\t\tBuild()).\n\t\t\tBuild()\n\n\t\tdec := NewDecoder(NewDocumentReader(bytes.NewReader(input)))\n\n\t\tdec.DefaultDocumentM()\n\n\t\tvar got any\n\t\terr := dec.Decode(&got)\n\t\trequire.NoError(t, err, \"Decode error\")\n\n\t\twant := M{\n\t\t\t\"myDocument\": M{\n\t\t\t\t\"myString\": \"test value\",\n\t\t\t},\n\t\t}\n\t\tassert.Equal(t, want, got, \"expected and actual decode results do not match\")\n\t})\n\tt.Run(\"DefaultDocumentMap top-level\", func(t *testing.T) {\n\t\tt.Parallel()\n\n\t\tinput := bsoncore.NewDocumentBuilder().\n\t\t\tAppendDocument(\"myDocument\", bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendString(\"myString\", \"test value\").\n\t\t\t\tBuild()).\n\t\t\tBuild()\n\n\t\tdec := NewDecoder(NewDocumentReader(bytes.NewReader(input)))\n\n\t\tdec.DefaultDocumentMap()\n\n\t\tvar got any\n\t\terr := dec.Decode(&got)\n\t\trequire.NoError(t, err, \"Decode error\")\n\n\t\twant := map[string]any{\n\t\t\t\"myDocument\": map[string]any{\n\t\t\t\t\"myString\": \"test value\",\n\t\t\t},\n\t\t}\n\t\tassert.Equal(t, want, got, \"expected and actual decode results do not match\")\n\t})\n\tt.Run(\"Default decodes DocumentD for top-level\", func(t *testing.T) {\n\t\tt.Parallel()\n\n\t\tinput := bsoncore.NewDocumentBuilder().\n\t\t\tAppendDocument(\"myDocument\", bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendString(\"myString\", \"test value\").\n\t\t\t\tBuild()).\n\t\t\tBuild()\n\n\t\tdec := NewDecoder(NewDocumentReader(bytes.NewReader(input)))\n\n\t\tvar got any\n\t\terr := dec.Decode(&got)\n\t\trequire.NoError(t, err, \"Decode error\")\n\n\t\twant := D{\n\t\t\t{Key: \"myDocument\", Value: D{\n\t\t\t\t{Key: \"myString\", Value: \"test value\"},\n\t\t\t}},\n\t\t}\n\t\tassert.Equal(t, want, got, \"expected and actual decode results do not match\")\n\t})\n}\n" }, { "path": "bson/default_value_decoders.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"encoding/json\"\n\t\"errors\"\n\t\"fmt\"\n\t\"math\"\n\t\"net/url\"\n\t\"reflect\"\n\t\"strconv\"\n\n\t\"go.mongodb.org/mongo-driver/v2/x/bsonx/bsoncore\"\n)\n\nvar errCannotTruncate = errors.New(\"float64 can only be truncated to a lower precision type when truncation is enabled\")\n\ntype decodeBinaryError struct {\n\tsubtype byte\n\ttypeName string\n}\n\nfunc (d decodeBinaryError) Error() string {\n\treturn fmt.Sprintf(\"only binary values with subtype 0x00 or 0x02 can be decoded into %s, but got subtype %v\", d.typeName, d.subtype)\n}\n\n// registerDefaultDecoders will register the decoder methods attached to DefaultValueDecoders with\n// the provided RegistryBuilder.\n//\n// There is no support for decoding map[string]any because there is no decoder for\n// any, so users must either register this decoder themselves or use the\n// EmptyInterfaceDecoder available in the bson package.\nfunc registerDefaultDecoders(reg *Registry) {\n\tintDecoder := decodeAdapter{intDecodeValue, intDecodeType}\n\tfloatDecoder := decodeAdapter{floatDecodeValue, floatDecodeType}\n\tuintCodec := &uintCodec{}\n\n\treg.RegisterTypeDecoder(tD, ValueDecoderFunc(dDecodeValue))\n\treg.RegisterTypeDecoder(tBinary, decodeAdapter{binaryDecodeValue, binaryDecodeType})\n\treg.RegisterTypeDecoder(tVector, decodeAdapter{vectorDecodeValue, vectorDecodeType})\n\treg.RegisterTypeDecoder(tUndefined, decodeAdapter{undefinedDecodeValue, undefinedDecodeType})\n\treg.RegisterTypeDecoder(tDateTime, decodeAdapter{dateTimeDecodeValue, dateTimeDecodeType})\n\treg.RegisterTypeDecoder(tNull, decodeAdapter{nullDecodeValue, nullDecodeType})\n\treg.RegisterTypeDecoder(tRegex, decodeAdapter{regexDecodeValue, regexDecodeType})\n\treg.RegisterTypeDecoder(tDBPointer, decodeAdapter{dbPointerDecodeValue, dbPointerDecodeType})\n\treg.RegisterTypeDecoder(tTimestamp, decodeAdapter{timestampDecodeValue, timestampDecodeType})\n\treg.RegisterTypeDecoder(tMinKey, decodeAdapter{minKeyDecodeValue, minKeyDecodeType})\n\treg.RegisterTypeDecoder(tMaxKey, decodeAdapter{maxKeyDecodeValue, maxKeyDecodeType})\n\treg.RegisterTypeDecoder(tJavaScript, decodeAdapter{javaScriptDecodeValue, javaScriptDecodeType})\n\treg.RegisterTypeDecoder(tSymbol, decodeAdapter{symbolDecodeValue, symbolDecodeType})\n\treg.RegisterTypeDecoder(tByteSlice, &byteSliceCodec{})\n\treg.RegisterTypeDecoder(tTime, &timeCodec{})\n\treg.RegisterTypeDecoder(tEmpty, &emptyInterfaceCodec{})\n\treg.RegisterTypeDecoder(tCoreArray, &arrayCodec{})\n\treg.RegisterTypeDecoder(tOID, decodeAdapter{objectIDDecodeValue, objectIDDecodeType})\n\treg.RegisterTypeDecoder(tDecimal, decodeAdapter{decimal128DecodeValue, decimal128DecodeType})\n\treg.RegisterTypeDecoder(tJSONNumber, decodeAdapter{jsonNumberDecodeValue, jsonNumberDecodeType})\n\treg.RegisterTypeDecoder(tURL, decodeAdapter{urlDecodeValue, urlDecodeType})\n\treg.RegisterTypeDecoder(tCoreDocument, ValueDecoderFunc(coreDocumentDecodeValue))\n\treg.RegisterTypeDecoder(tCodeWithScope, decodeAdapter{codeWithScopeDecodeValue, codeWithScopeDecodeType})\n\treg.RegisterKindDecoder(reflect.Bool, decodeAdapter{booleanDecodeValue, booleanDecodeType})\n\treg.RegisterKindDecoder(reflect.Int, intDecoder)\n\treg.RegisterKindDecoder(reflect.Int8, intDecoder)\n\treg.RegisterKindDecoder(reflect.Int16, intDecoder)\n\treg.RegisterKindDecoder(reflect.Int32, intDecoder)\n\treg.RegisterKindDecoder(reflect.Int64, intDecoder)\n\treg.RegisterKindDecoder(reflect.Uint, uintCodec)\n\treg.RegisterKindDecoder(reflect.Uint8, uintCodec)\n\treg.RegisterKindDecoder(reflect.Uint16, uintCodec)\n\treg.RegisterKindDecoder(reflect.Uint32, uintCodec)\n\treg.RegisterKindDecoder(reflect.Uint64, uintCodec)\n\treg.RegisterKindDecoder(reflect.Float32, floatDecoder)\n\treg.RegisterKindDecoder(reflect.Float64, floatDecoder)\n\treg.RegisterKindDecoder(reflect.Array, ValueDecoderFunc(arrayDecodeValue))\n\treg.RegisterKindDecoder(reflect.Map, &mapCodec{})\n\treg.RegisterKindDecoder(reflect.Slice, &sliceCodec{})\n\treg.RegisterKindDecoder(reflect.String, &stringCodec{})\n\treg.RegisterKindDecoder(reflect.Struct, newStructCodec(nil))\n\treg.RegisterKindDecoder(reflect.Ptr, &pointerCodec{})\n\treg.RegisterTypeMapEntry(TypeDouble, tFloat64)\n\treg.RegisterTypeMapEntry(TypeString, tString)\n\treg.RegisterTypeMapEntry(TypeArray, tA)\n\treg.RegisterTypeMapEntry(TypeBinary, tBinary)\n\treg.RegisterTypeMapEntry(TypeUndefined, tUndefined)\n\treg.RegisterTypeMapEntry(TypeObjectID, tOID)\n\treg.RegisterTypeMapEntry(TypeBoolean, tBool)\n\treg.RegisterTypeMapEntry(TypeDateTime, tDateTime)\n\treg.RegisterTypeMapEntry(TypeRegex, tRegex)\n\treg.RegisterTypeMapEntry(TypeDBPointer, tDBPointer)\n\treg.RegisterTypeMapEntry(TypeJavaScript, tJavaScript)\n\treg.RegisterTypeMapEntry(TypeSymbol, tSymbol)\n\treg.RegisterTypeMapEntry(TypeCodeWithScope, tCodeWithScope)\n\treg.RegisterTypeMapEntry(TypeInt32, tInt32)\n\treg.RegisterTypeMapEntry(TypeInt64, tInt64)\n\treg.RegisterTypeMapEntry(TypeTimestamp, tTimestamp)\n\treg.RegisterTypeMapEntry(TypeDecimal128, tDecimal)\n\treg.RegisterTypeMapEntry(TypeMinKey, tMinKey)\n\treg.RegisterTypeMapEntry(TypeMaxKey, tMaxKey)\n\treg.RegisterTypeMapEntry(Type(0), tD)\n\treg.RegisterTypeMapEntry(TypeEmbeddedDocument, tD)\n\treg.RegisterInterfaceDecoder(tValueUnmarshaler, ValueDecoderFunc(valueUnmarshalerDecodeValue))\n\treg.RegisterInterfaceDecoder(tUnmarshaler, ValueDecoderFunc(unmarshalerDecodeValue))\n}\n\n// dDecodeValue is the ValueDecoderFunc for D instances.\nfunc dDecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.IsValid() || !val.CanSet() || val.Type() != tD {\n\t\treturn ValueDecoderError{Name: \"DDecodeValue\", Kinds: []reflect.Kind{reflect.Slice}, Received: val}\n\t}\n\n\tswitch vrType := vr.Type(); vrType {\n\tcase Type(0), TypeEmbeddedDocument:\n\t\tbreak\n\tcase TypeNull:\n\t\tval.Set(reflect.Zero(val.Type()))\n\t\treturn vr.ReadNull()\n\tdefault:\n\t\treturn fmt.Errorf(\"cannot decode %v into a D\", vrType)\n\t}\n\n\tdr, err := vr.ReadDocument()\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tdecoder, err := dc.LookupDecoder(tEmpty)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\t// Use the elements in the provided value if it's non nil. Otherwise, allocate a new D instance.\n\tvar elems D\n\tif !val.IsNil() {\n\t\tval.SetLen(0)\n\t\telems = val.Interface().(D)\n\t} else {\n\t\telems = make(D, 0)\n\t}\n\n\tfor {\n\t\tkey, elemVr, err := dr.ReadElement()\n\t\tif errors.Is(err, ErrEOD) {\n\t\t\tbreak\n\t\t} else if err != nil {\n\t\t\treturn err\n\t\t}\n\n\t\tvar v any\n\t\terr = decoder.DecodeValue(dc, elemVr, reflect.ValueOf(&v).Elem())\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\n\t\telems = append(elems, E{Key: key, Value: v})\n\t}\n\n\tval.Set(reflect.ValueOf(elems))\n\treturn nil\n}\n\nfunc booleanDecodeType(_ DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t.Kind() != reflect.Bool {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"BooleanDecodeValue\",\n\t\t\tKinds: []reflect.Kind{reflect.Bool},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\tvar b bool\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeInt32:\n\t\ti32, err := vr.ReadInt32()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\t\tb = (i32 != 0)\n\tcase TypeInt64:\n\t\ti64, err := vr.ReadInt64()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\t\tb = (i64 != 0)\n\tcase TypeDouble:\n\t\tf64, err := vr.ReadDouble()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\t\tb = (f64 != 0)\n\tcase TypeBoolean:\n\t\tb, err = vr.ReadBoolean()\n\tcase TypeNull:\n\t\terr = vr.ReadNull()\n\tcase TypeUndefined:\n\t\terr = vr.ReadUndefined()\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into a boolean\", vrType)\n\t}\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\treturn reflect.ValueOf(b), nil\n}\n\n// booleanDecodeValue is the ValueDecoderFunc for bool types.\nfunc booleanDecodeValue(dctx DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.IsValid() || !val.CanSet() || val.Kind() != reflect.Bool {\n\t\treturn ValueDecoderError{Name: \"BooleanDecodeValue\", Kinds: []reflect.Kind{reflect.Bool}, Received: val}\n\t}\n\n\telem, err := booleanDecodeType(dctx, vr, val.Type())\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.SetBool(elem.Bool())\n\treturn nil\n}\n\nfunc intDecodeType(dc DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tvar i64 int64\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeInt32:\n\t\ti32, err := vr.ReadInt32()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\t\ti64 = int64(i32)\n\tcase TypeInt64:\n\t\ti64, err = vr.ReadInt64()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\tcase TypeDouble:\n\t\tf64, err := vr.ReadDouble()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\t\tif !dc.truncate && math.Floor(f64) != f64 {\n\t\t\treturn emptyValue, errCannotTruncate\n\t\t}\n\t\tif f64 > float64(math.MaxInt64) {\n\t\t\treturn emptyValue, fmt.Errorf(\"%g overflows int64\", f64)\n\t\t}\n\t\ti64 = int64(f64)\n\tcase TypeBoolean:\n\t\tb, err := vr.ReadBoolean()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\t\tif b {\n\t\t\ti64 = 1\n\t\t}\n\tcase TypeNull:\n\t\tif err = vr.ReadNull(); err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\tcase TypeUndefined:\n\t\tif err = vr.ReadUndefined(); err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into an integer type\", vrType)\n\t}\n\n\tswitch t.Kind() {\n\tcase reflect.Int8:\n\t\tif i64 < math.MinInt8 || i64 > math.MaxInt8 {\n\t\t\treturn emptyValue, fmt.Errorf(\"%d overflows int8\", i64)\n\t\t}\n\n\t\treturn reflect.ValueOf(int8(i64)), nil\n\tcase reflect.Int16:\n\t\tif i64 < math.MinInt16 || i64 > math.MaxInt16 {\n\t\t\treturn emptyValue, fmt.Errorf(\"%d overflows int16\", i64)\n\t\t}\n\n\t\treturn reflect.ValueOf(int16(i64)), nil\n\tcase reflect.Int32:\n\t\tif i64 < math.MinInt32 || i64 > math.MaxInt32 {\n\t\t\treturn emptyValue, fmt.Errorf(\"%d overflows int32\", i64)\n\t\t}\n\n\t\treturn reflect.ValueOf(int32(i64)), nil\n\tcase reflect.Int64:\n\t\treturn reflect.ValueOf(i64), nil\n\tcase reflect.Int:\n\t\tif i64 > math.MaxInt { // Can we fit this inside of an int\n\t\t\treturn emptyValue, fmt.Errorf(\"%d overflows int\", i64)\n\t\t}\n\n\t\treturn reflect.ValueOf(int(i64)), nil\n\tdefault:\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"IntDecodeValue\",\n\t\t\tKinds: []reflect.Kind{reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64, reflect.Int},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n}\n\n// intDecodeValue is the ValueDecoderFunc for int types.\nfunc intDecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() {\n\t\treturn ValueDecoderError{\n\t\t\tName: \"IntDecodeValue\",\n\t\t\tKinds: []reflect.Kind{reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64, reflect.Int},\n\t\t\tReceived: val,\n\t\t}\n\t}\n\n\telem, err := intDecodeType(dc, vr, val.Type())\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.SetInt(elem.Int())\n\treturn nil\n}\n\nfunc floatDecodeType(dc DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tvar f float64\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeInt32:\n\t\ti32, err := vr.ReadInt32()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\t\tf = float64(i32)\n\tcase TypeInt64:\n\t\ti64, err := vr.ReadInt64()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\t\tf = float64(i64)\n\tcase TypeDouble:\n\t\tf, err = vr.ReadDouble()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\tcase TypeBoolean:\n\t\tb, err := vr.ReadBoolean()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\t\tif b {\n\t\t\tf = 1\n\t\t}\n\tcase TypeNull:\n\t\tif err = vr.ReadNull(); err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\tcase TypeUndefined:\n\t\tif err = vr.ReadUndefined(); err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into a float32 or float64 type\", vrType)\n\t}\n\n\tswitch t.Kind() {\n\tcase reflect.Float32:\n\t\tif !dc.truncate && float64(float32(f)) != f {\n\t\t\treturn emptyValue, errCannotTruncate\n\t\t}\n\n\t\treturn reflect.ValueOf(float32(f)), nil\n\tcase reflect.Float64:\n\t\treturn reflect.ValueOf(f), nil\n\tdefault:\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"FloatDecodeValue\",\n\t\t\tKinds: []reflect.Kind{reflect.Float32, reflect.Float64},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n}\n\n// floatDecodeValue is the ValueDecoderFunc for float types.\nfunc floatDecodeValue(ec DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() {\n\t\treturn ValueDecoderError{\n\t\t\tName: \"FloatDecodeValue\",\n\t\t\tKinds: []reflect.Kind{reflect.Float32, reflect.Float64},\n\t\t\tReceived: val,\n\t\t}\n\t}\n\n\telem, err := floatDecodeType(ec, vr, val.Type())\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.SetFloat(elem.Float())\n\treturn nil\n}\n\nfunc javaScriptDecodeType(_ DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tJavaScript {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"JavaScriptDecodeValue\",\n\t\t\tTypes: []reflect.Type{tJavaScript},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\tvar js string\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeJavaScript:\n\t\tjs, err = vr.ReadJavascript()\n\tcase TypeNull:\n\t\terr = vr.ReadNull()\n\tcase TypeUndefined:\n\t\terr = vr.ReadUndefined()\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into a JavaScript\", vrType)\n\t}\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\treturn reflect.ValueOf(JavaScript(js)), nil\n}\n\n// javaScriptDecodeValue is the ValueDecoderFunc for the JavaScript type.\nfunc javaScriptDecodeValue(dctx DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tJavaScript {\n\t\treturn ValueDecoderError{Name: \"JavaScriptDecodeValue\", Types: []reflect.Type{tJavaScript}, Received: val}\n\t}\n\n\telem, err := javaScriptDecodeType(dctx, vr, tJavaScript)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.SetString(elem.String())\n\treturn nil\n}\n\nfunc symbolDecodeType(_ DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tSymbol {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"SymbolDecodeValue\",\n\t\t\tTypes: []reflect.Type{tSymbol},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\tvar symbol string\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeString:\n\t\tsymbol, err = vr.ReadString()\n\tcase TypeSymbol:\n\t\tsymbol, err = vr.ReadSymbol()\n\tcase TypeBinary:\n\t\tdata, subtype, err := vr.ReadBinary()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\n\t\tif subtype != TypeBinaryGeneric && subtype != TypeBinaryBinaryOld {\n\t\t\treturn emptyValue, decodeBinaryError{subtype: subtype, typeName: \"Symbol\"}\n\t\t}\n\t\tsymbol = string(data)\n\tcase TypeNull:\n\t\terr = vr.ReadNull()\n\tcase TypeUndefined:\n\t\terr = vr.ReadUndefined()\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into a Symbol\", vrType)\n\t}\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\treturn reflect.ValueOf(Symbol(symbol)), nil\n}\n\n// symbolDecodeValue is the ValueDecoderFunc for the Symbol type.\nfunc symbolDecodeValue(dctx DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tSymbol {\n\t\treturn ValueDecoderError{Name: \"SymbolDecodeValue\", Types: []reflect.Type{tSymbol}, Received: val}\n\t}\n\n\telem, err := symbolDecodeType(dctx, vr, tSymbol)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.SetString(elem.String())\n\treturn nil\n}\n\nfunc binaryDecode(vr ValueReader) (Binary, error) {\n\tvar b Binary\n\n\tvar data []byte\n\tvar subtype byte\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeBinary:\n\t\tdata, subtype, err = vr.ReadBinary()\n\tcase TypeNull:\n\t\terr = vr.ReadNull()\n\tcase TypeUndefined:\n\t\terr = vr.ReadUndefined()\n\tdefault:\n\t\treturn b, fmt.Errorf(\"cannot decode %v into a Binary\", vrType)\n\t}\n\tif err != nil {\n\t\treturn b, err\n\t}\n\tb.Subtype = subtype\n\tb.Data = data\n\n\treturn b, nil\n}\n\nfunc binaryDecodeType(_ DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tBinary {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"BinaryDecodeValue\",\n\t\t\tTypes: []reflect.Type{tBinary},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\tb, err := binaryDecode(vr)\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\treturn reflect.ValueOf(b), nil\n}\n\n// binaryDecodeValue is the ValueDecoderFunc for Binary.\nfunc binaryDecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tBinary {\n\t\treturn ValueDecoderError{Name: \"BinaryDecodeValue\", Types: []reflect.Type{tBinary}, Received: val}\n\t}\n\n\telem, err := binaryDecodeType(dc, vr, tBinary)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.Set(elem)\n\treturn nil\n}\n\nfunc vectorDecodeType(_ DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tVector {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"VectorDecodeValue\",\n\t\t\tTypes: []reflect.Type{tVector},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\tb, err := binaryDecode(vr)\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\tv, err := NewVectorFromBinary(b)\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\treturn reflect.ValueOf(v), nil\n}\n\n// vectorDecodeValue is the ValueDecoderFunc for Vector.\nfunc vectorDecodeValue(dctx DecodeContext, vr ValueReader, val reflect.Value) error {\n\tt := val.Type()\n\tif !val.CanSet() || t != tVector {\n\t\treturn ValueDecoderError{\n\t\t\tName: \"VectorDecodeValue\",\n\t\t\tTypes: []reflect.Type{tVector},\n\t\t\tReceived: val,\n\t\t}\n\t}\n\n\telem, err := vectorDecodeType(dctx, vr, t)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.Set(elem)\n\treturn nil\n}\n\nfunc undefinedDecodeType(_ DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tUndefined {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"UndefinedDecodeValue\",\n\t\t\tTypes: []reflect.Type{tUndefined},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeUndefined:\n\t\terr = vr.ReadUndefined()\n\tcase TypeNull:\n\t\terr = vr.ReadNull()\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into an Undefined\", vr.Type())\n\t}\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\treturn reflect.ValueOf(Undefined{}), nil\n}\n\n// undefinedDecodeValue is the ValueDecoderFunc for Undefined.\nfunc undefinedDecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tUndefined {\n\t\treturn ValueDecoderError{Name: \"UndefinedDecodeValue\", Types: []reflect.Type{tUndefined}, Received: val}\n\t}\n\n\telem, err := undefinedDecodeType(dc, vr, tUndefined)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.Set(elem)\n\treturn nil\n}\n\n// Accept both 12-byte string and pretty-printed 24-byte hex string formats.\nfunc objectIDDecodeType(_ DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tOID {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"ObjectIDDecodeValue\",\n\t\t\tTypes: []reflect.Type{tOID},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\tvar oid ObjectID\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeObjectID:\n\t\toid, err = vr.ReadObjectID()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\tcase TypeString:\n\t\tstr, err := vr.ReadString()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\t\tif oid, err = ObjectIDFromHex(str); err == nil {\n\t\t\tbreak\n\t\t}\n\t\tif len(str) != 12 {\n\t\t\treturn emptyValue, fmt.Errorf(\"an ObjectID string must be exactly 12 bytes long (got %v)\", len(str))\n\t\t}\n\t\tbyteArr := []byte(str)\n\t\tcopy(oid[:], byteArr)\n\tcase TypeNull:\n\t\tif err = vr.ReadNull(); err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\tcase TypeUndefined:\n\t\tif err = vr.ReadUndefined(); err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into an ObjectID\", vrType)\n\t}\n\n\treturn reflect.ValueOf(oid), nil\n}\n\n// objectIDDecodeValue is the ValueDecoderFunc for ObjectID.\nfunc objectIDDecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tOID {\n\t\treturn ValueDecoderError{Name: \"ObjectIDDecodeValue\", Types: []reflect.Type{tOID}, Received: val}\n\t}\n\n\telem, err := objectIDDecodeType(dc, vr, tOID)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.Set(elem)\n\treturn nil\n}\n\nfunc dateTimeDecodeType(_ DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tDateTime {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"DateTimeDecodeValue\",\n\t\t\tTypes: []reflect.Type{tDateTime},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\tvar dt int64\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeDateTime:\n\t\tdt, err = vr.ReadDateTime()\n\tcase TypeNull:\n\t\terr = vr.ReadNull()\n\tcase TypeUndefined:\n\t\terr = vr.ReadUndefined()\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into a DateTime\", vrType)\n\t}\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\treturn reflect.ValueOf(DateTime(dt)), nil\n}\n\n// dateTimeDecodeValue is the ValueDecoderFunc for DateTime.\nfunc dateTimeDecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tDateTime {\n\t\treturn ValueDecoderError{Name: \"DateTimeDecodeValue\", Types: []reflect.Type{tDateTime}, Received: val}\n\t}\n\n\telem, err := dateTimeDecodeType(dc, vr, tDateTime)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.Set(elem)\n\treturn nil\n}\n\nfunc nullDecodeType(_ DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tNull {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"NullDecodeValue\",\n\t\t\tTypes: []reflect.Type{tNull},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeUndefined:\n\t\terr = vr.ReadUndefined()\n\tcase TypeNull:\n\t\terr = vr.ReadNull()\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into a Null\", vr.Type())\n\t}\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\treturn reflect.ValueOf(Null{}), nil\n}\n\n// nullDecodeValue is the ValueDecoderFunc for Null.\nfunc nullDecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tNull {\n\t\treturn ValueDecoderError{Name: \"NullDecodeValue\", Types: []reflect.Type{tNull}, Received: val}\n\t}\n\n\telem, err := nullDecodeType(dc, vr, tNull)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.Set(elem)\n\treturn nil\n}\n\nfunc regexDecodeType(_ DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tRegex {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"RegexDecodeValue\",\n\t\t\tTypes: []reflect.Type{tRegex},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\tvar pattern, options string\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeRegex:\n\t\tpattern, options, err = vr.ReadRegex()\n\tcase TypeNull:\n\t\terr = vr.ReadNull()\n\tcase TypeUndefined:\n\t\terr = vr.ReadUndefined()\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into a Regex\", vrType)\n\t}\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\treturn reflect.ValueOf(Regex{Pattern: pattern, Options: options}), nil\n}\n\n// regexDecodeValue is the ValueDecoderFunc for Regex.\nfunc regexDecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tRegex {\n\t\treturn ValueDecoderError{Name: \"RegexDecodeValue\", Types: []reflect.Type{tRegex}, Received: val}\n\t}\n\n\telem, err := regexDecodeType(dc, vr, tRegex)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.Set(elem)\n\treturn nil\n}\n\nfunc dbPointerDecodeType(_ DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tDBPointer {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"DBPointerDecodeValue\",\n\t\t\tTypes: []reflect.Type{tDBPointer},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\tvar ns string\n\tvar pointer ObjectID\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeDBPointer:\n\t\tns, pointer, err = vr.ReadDBPointer()\n\tcase TypeNull:\n\t\terr = vr.ReadNull()\n\tcase TypeUndefined:\n\t\terr = vr.ReadUndefined()\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into a DBPointer\", vrType)\n\t}\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\treturn reflect.ValueOf(DBPointer{DB: ns, Pointer: pointer}), nil\n}\n\n// dbPointerDecodeValue is the ValueDecoderFunc for DBPointer.\nfunc dbPointerDecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tDBPointer {\n\t\treturn ValueDecoderError{Name: \"DBPointerDecodeValue\", Types: []reflect.Type{tDBPointer}, Received: val}\n\t}\n\n\telem, err := dbPointerDecodeType(dc, vr, tDBPointer)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.Set(elem)\n\treturn nil\n}\n\nfunc timestampDecodeType(_ DecodeContext, vr ValueReader, reflectType reflect.Type) (reflect.Value, error) {\n\tif reflectType != tTimestamp {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"TimestampDecodeValue\",\n\t\t\tTypes: []reflect.Type{tTimestamp},\n\t\t\tReceived: reflect.Zero(reflectType),\n\t\t}\n\t}\n\n\tvar t, incr uint32\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeTimestamp:\n\t\tt, incr, err = vr.ReadTimestamp()\n\tcase TypeNull:\n\t\terr = vr.ReadNull()\n\tcase TypeUndefined:\n\t\terr = vr.ReadUndefined()\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into a Timestamp\", vrType)\n\t}\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\treturn reflect.ValueOf(Timestamp{T: t, I: incr}), nil\n}\n\n// timestampDecodeValue is the ValueDecoderFunc for Timestamp.\nfunc timestampDecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tTimestamp {\n\t\treturn ValueDecoderError{Name: \"TimestampDecodeValue\", Types: []reflect.Type{tTimestamp}, Received: val}\n\t}\n\n\telem, err := timestampDecodeType(dc, vr, tTimestamp)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.Set(elem)\n\treturn nil\n}\n\nfunc minKeyDecodeType(_ DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tMinKey {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"MinKeyDecodeValue\",\n\t\t\tTypes: []reflect.Type{tMinKey},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeMinKey:\n\t\terr = vr.ReadMinKey()\n\tcase TypeNull:\n\t\terr = vr.ReadNull()\n\tcase TypeUndefined:\n\t\terr = vr.ReadUndefined()\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into a MinKey\", vr.Type())\n\t}\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\treturn reflect.ValueOf(MinKey{}), nil\n}\n\n// minKeyDecodeValue is the ValueDecoderFunc for MinKey.\nfunc minKeyDecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tMinKey {\n\t\treturn ValueDecoderError{Name: \"MinKeyDecodeValue\", Types: []reflect.Type{tMinKey}, Received: val}\n\t}\n\n\telem, err := minKeyDecodeType(dc, vr, tMinKey)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.Set(elem)\n\treturn nil\n}\n\nfunc maxKeyDecodeType(_ DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tMaxKey {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"MaxKeyDecodeValue\",\n\t\t\tTypes: []reflect.Type{tMaxKey},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeMaxKey:\n\t\terr = vr.ReadMaxKey()\n\tcase TypeNull:\n\t\terr = vr.ReadNull()\n\tcase TypeUndefined:\n\t\terr = vr.ReadUndefined()\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into a MaxKey\", vr.Type())\n\t}\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\treturn reflect.ValueOf(MaxKey{}), nil\n}\n\n// maxKeyDecodeValue is the ValueDecoderFunc for MaxKey.\nfunc maxKeyDecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tMaxKey {\n\t\treturn ValueDecoderError{Name: \"MaxKeyDecodeValue\", Types: []reflect.Type{tMaxKey}, Received: val}\n\t}\n\n\telem, err := maxKeyDecodeType(dc, vr, tMaxKey)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.Set(elem)\n\treturn nil\n}\n\nfunc decimal128DecodeType(_ DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tDecimal {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"Decimal128DecodeValue\",\n\t\t\tTypes: []reflect.Type{tDecimal},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\tvar d128 Decimal128\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeDecimal128:\n\t\td128, err = vr.ReadDecimal128()\n\tcase TypeNull:\n\t\terr = vr.ReadNull()\n\tcase TypeUndefined:\n\t\terr = vr.ReadUndefined()\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into a Decimal128\", vr.Type())\n\t}\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\treturn reflect.ValueOf(d128), nil\n}\n\n// decimal128DecodeValue is the ValueDecoderFunc for Decimal128.\nfunc decimal128DecodeValue(dctx DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tDecimal {\n\t\treturn ValueDecoderError{Name: \"Decimal128DecodeValue\", Types: []reflect.Type{tDecimal}, Received: val}\n\t}\n\n\telem, err := decimal128DecodeType(dctx, vr, tDecimal)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.Set(elem)\n\treturn nil\n}\n\nfunc jsonNumberDecodeType(_ DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tJSONNumber {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"JSONNumberDecodeValue\",\n\t\t\tTypes: []reflect.Type{tJSONNumber},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\tvar jsonNum json.Number\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeDouble:\n\t\tf64, err := vr.ReadDouble()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\t\tjsonNum = json.Number(strconv.FormatFloat(f64, 'f', -1, 64))\n\tcase TypeInt32:\n\t\ti32, err := vr.ReadInt32()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\t\tjsonNum = json.Number(strconv.FormatInt(int64(i32), 10))\n\tcase TypeInt64:\n\t\ti64, err := vr.ReadInt64()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\t\tjsonNum = json.Number(strconv.FormatInt(i64, 10))\n\tcase TypeNull:\n\t\terr = vr.ReadNull()\n\tcase TypeUndefined:\n\t\terr = vr.ReadUndefined()\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into a json.Number\", vrType)\n\t}\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\treturn reflect.ValueOf(jsonNum), nil\n}\n\n// jsonNumberDecodeValue is the ValueDecoderFunc for json.Number.\nfunc jsonNumberDecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tJSONNumber {\n\t\treturn ValueDecoderError{Name: \"JSONNumberDecodeValue\", Types: []reflect.Type{tJSONNumber}, Received: val}\n\t}\n\n\telem, err := jsonNumberDecodeType(dc, vr, tJSONNumber)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.Set(elem)\n\treturn nil\n}\n\nfunc urlDecodeType(_ DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tURL {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"URLDecodeValue\",\n\t\t\tTypes: []reflect.Type{tURL},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\turlPtr := &url.URL{}\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeString:\n\t\tvar str string // Declare str here to avoid shadowing err during the ReadString call.\n\t\tstr, err = vr.ReadString()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\n\t\turlPtr, err = url.Parse(str)\n\tcase TypeNull:\n\t\terr = vr.ReadNull()\n\tcase TypeUndefined:\n\t\terr = vr.ReadUndefined()\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into a *url.URL\", vrType)\n\t}\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\treturn reflect.ValueOf(urlPtr).Elem(), nil\n}\n\n// urlDecodeValue is the ValueDecoderFunc for url.URL.\nfunc urlDecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tURL {\n\t\treturn ValueDecoderError{Name: \"URLDecodeValue\", Types: []reflect.Type{tURL}, Received: val}\n\t}\n\n\telem, err := urlDecodeType(dc, vr, tURL)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.Set(elem)\n\treturn nil\n}\n\n// arrayDecodeValue is the ValueDecoderFunc for array types.\nfunc arrayDecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.IsValid() || val.Kind() != reflect.Array {\n\t\treturn ValueDecoderError{Name: \"ArrayDecodeValue\", Kinds: []reflect.Kind{reflect.Array}, Received: val}\n\t}\n\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeArray:\n\tcase Type(0), TypeEmbeddedDocument:\n\t\tif val.Type().Elem() != tE {\n\t\t\treturn fmt.Errorf(\"cannot decode document into %s\", val.Type())\n\t\t}\n\tcase TypeBinary:\n\t\tif val.Type().Elem() != tByte {\n\t\t\treturn fmt.Errorf(\"ArrayDecodeValue can only be used to decode binary into a byte array, got %v\", vrType)\n\t\t}\n\t\tdata, subtype, err := vr.ReadBinary()\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\tif subtype != TypeBinaryGeneric && subtype != TypeBinaryBinaryOld {\n\t\t\treturn fmt.Errorf(\"ArrayDecodeValue can only be used to decode subtype 0x00 or 0x02 for %s, got %v\", TypeBinary, subtype)\n\t\t}\n\n\t\tif len(data) > val.Len() {\n\t\t\treturn fmt.Errorf(\"more elements returned in array than can fit inside %s\", val.Type())\n\t\t}\n\n\t\tfor idx, elem := range data {\n\t\t\tval.Index(idx).Set(reflect.ValueOf(elem))\n\t\t}\n\t\treturn nil\n\tcase TypeNull:\n\t\tval.Set(reflect.Zero(val.Type()))\n\t\treturn vr.ReadNull()\n\tcase TypeUndefined:\n\t\tval.Set(reflect.Zero(val.Type()))\n\t\treturn vr.ReadUndefined()\n\tdefault:\n\t\treturn fmt.Errorf(\"cannot decode %v into an array\", vrType)\n\t}\n\n\tvar elemsFunc func(DecodeContext, ValueReader, reflect.Value) ([]reflect.Value, error)\n\tswitch val.Type().Elem() {\n\tcase tE:\n\t\telemsFunc = decodeD\n\tdefault:\n\t\telemsFunc = decodeDefault\n\t}\n\n\telems, err := elemsFunc(dc, vr, val)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tif len(elems) > val.Len() {\n\t\treturn fmt.Errorf(\"more elements returned in array than can fit inside %s, got %v elements\", val.Type(), len(elems))\n\t}\n\n\tfor idx, elem := range elems {\n\t\tval.Index(idx).Set(elem)\n\t}\n\n\treturn nil\n}\n\n// valueUnmarshalerDecodeValue is the ValueDecoderFunc for ValueUnmarshaler implementations.\nfunc valueUnmarshalerDecodeValue(_ DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.IsValid() || (!val.Type().Implements(tValueUnmarshaler) && !reflect.PtrTo(val.Type()).Implements(tValueUnmarshaler)) {\n\t\treturn ValueDecoderError{Name: \"ValueUnmarshalerDecodeValue\", Types: []reflect.Type{tValueUnmarshaler}, Received: val}\n\t}\n\n\t// If BSON value is null and the go value is a pointer, then don't call\n\t// UnmarshalBSONValue. Even if the Go pointer is already initialized (i.e.,\n\t// non-nil), encountering null in BSON will result in the pointer being\n\t// directly set to nil here. Since the pointer is being replaced with nil,\n\t// there is no opportunity (or reason) for the custom UnmarshalBSONValue logic\n\t// to be called.\n\tif vr.Type() == TypeNull && val.Kind() == reflect.Ptr {\n\t\tval.Set(reflect.Zero(val.Type()))\n\n\t\treturn vr.ReadNull()\n\t}\n\n\tif val.Kind() == reflect.Ptr && val.IsNil() {\n\t\tif !val.CanSet() {\n\t\t\treturn ValueDecoderError{Name: \"ValueUnmarshalerDecodeValue\", Types: []reflect.Type{tValueUnmarshaler}, Received: val}\n\t\t}\n\t\tval.Set(reflect.New(val.Type().Elem()))\n\t}\n\n\tif !val.Type().Implements(tValueUnmarshaler) {\n\t\tif !val.CanAddr() {\n\t\t\treturn ValueDecoderError{Name: \"ValueUnmarshalerDecodeValue\", Types: []reflect.Type{tValueUnmarshaler}, Received: val}\n\t\t}\n\t\tval = val.Addr() // If the type doesn't implement the interface, a pointer to it must.\n\t}\n\n\tt, src, err := copyValueToBytes(vr)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tm, ok := val.Interface().(ValueUnmarshaler)\n\tif !ok {\n\t\t// NB: this error should be unreachable due to the above checks\n\t\treturn ValueDecoderError{Name: \"ValueUnmarshalerDecodeValue\", Types: []reflect.Type{tValueUnmarshaler}, Received: val}\n\t}\n\treturn m.UnmarshalBSONValue(byte(t), src)\n}\n\n// unmarshalerDecodeValue is the ValueDecoderFunc for Unmarshaler implementations.\nfunc unmarshalerDecodeValue(_ DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.IsValid() || (!val.Type().Implements(tUnmarshaler) && !reflect.PtrTo(val.Type()).Implements(tUnmarshaler)) {\n\t\treturn ValueDecoderError{Name: \"UnmarshalerDecodeValue\", Types: []reflect.Type{tUnmarshaler}, Received: val}\n\t}\n\n\tif val.Kind() == reflect.Ptr && val.IsNil() {\n\t\tif !val.CanSet() {\n\t\t\treturn ValueDecoderError{Name: \"UnmarshalerDecodeValue\", Types: []reflect.Type{tUnmarshaler}, Received: val}\n\t\t}\n\t\tval.Set(reflect.New(val.Type().Elem()))\n\t}\n\n\t_, src, err := copyValueToBytes(vr)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\t// If the target Go value is a pointer and the BSON field value is empty, set the value to the\n\t// zero value of the pointer (nil) and don't call UnmarshalBSON. UnmarshalBSON has no way to\n\t// change the pointer value from within the function (only the value at the pointer address),\n\t// so it can't set the pointer to \"nil\" itself. Since the most common Go value for an empty BSON\n\t// field value is \"nil\", we set \"nil\" here and don't call UnmarshalBSON. This behavior matches\n\t// the behavior of the Go \"encoding/json\" unmarshaler when the target Go value is a pointer and\n\t// the JSON field value is \"null\".\n\tif val.Kind() == reflect.Ptr && len(src) == 0 {\n\t\tval.Set(reflect.Zero(val.Type()))\n\t\treturn nil\n\t}\n\n\tif !val.Type().Implements(tUnmarshaler) {\n\t\tif !val.CanAddr() {\n\t\t\treturn ValueDecoderError{Name: \"UnmarshalerDecodeValue\", Types: []reflect.Type{tUnmarshaler}, Received: val}\n\t\t}\n\t\tval = val.Addr() // If the type doesn't implement the interface, a pointer to it must.\n\t}\n\n\tm, ok := val.Interface().(Unmarshaler)\n\tif !ok {\n\t\t// NB: this error should be unreachable due to the above checks\n\t\treturn ValueDecoderError{Name: \"UnmarshalerDecodeValue\", Types: []reflect.Type{tUnmarshaler}, Received: val}\n\t}\n\treturn m.UnmarshalBSON(src)\n}\n\n// coreDocumentDecodeValue is the ValueDecoderFunc for bsoncore.Document.\nfunc coreDocumentDecodeValue(_ DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tCoreDocument {\n\t\treturn ValueDecoderError{Name: \"CoreDocumentDecodeValue\", Types: []reflect.Type{tCoreDocument}, Received: val}\n\t}\n\tvrType := vr.Type()\n\tisDocument := vrType == Type(0) || vrType == TypeEmbeddedDocument || vrType == TypeArray\n\tif !isDocument {\n\t\treturn fmt.Errorf(\"cannot decode %v into a %s\", vrType, val.Type())\n\t}\n\n\tif val.IsNil() {\n\t\tval.Set(reflect.MakeSlice(val.Type(), 0, 0))\n\t}\n\n\tval.SetLen(0)\n\n\tcdoc, err := appendDocumentBytes(val.Interface().(bsoncore.Document), vr)\n\tval.Set(reflect.ValueOf(cdoc))\n\treturn err\n}\n\nfunc decodeDefault(dc DecodeContext, vr ValueReader, val reflect.Value) ([]reflect.Value, error) {\n\telems := make([]reflect.Value, 0)\n\n\tar, err := vr.ReadArray()\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\n\teType := val.Type().Elem()\n\n\tisInterfaceSlice := eType.Kind() == reflect.Interface && val.Len() > 0\n\n\t// If this is not an interface slice with pre-populated elements, we can look up\n\t// the decoder for eType once.\n\tvar vDecoder ValueDecoder\n\tif !isInterfaceSlice {\n\t\tvDecoder, err = dc.LookupDecoder(eType)\n\t\tif err != nil {\n\t\t\treturn nil, err\n\t\t}\n\t}\n\n\tidx := 0\n\tfor {\n\t\tvr, err := ar.ReadValue()\n\t\tif errors.Is(err, ErrEOA) {\n\t\t\tbreak\n\t\t}\n\t\tif err != nil {\n\t\t\treturn nil, err\n\t\t}\n\n\t\tvar elem reflect.Value\n\t\tif isInterfaceSlice && idx < val.Len() {\n\t\t\t// Decode into an existing any slot.\n\n\t\t\telem = val.Index(idx).Elem()\n\t\t\tswitch {\n\t\t\tcase elem.Kind() != reflect.Ptr || elem.IsNil():\n\t\t\t\tvalueDecoder, err := dc.LookupDecoder(elem.Type())\n\t\t\t\tif err != nil {\n\t\t\t\t\treturn nil, err\n\t\t\t\t}\n\n\t\t\t\t// If an element is allocated and unsettable, it must be overwritten.\n\t\t\t\tif !elem.CanSet() {\n\t\t\t\t\telem = reflect.New(elem.Type()).Elem()\n\t\t\t\t}\n\n\t\t\t\terr = valueDecoder.DecodeValue(dc, vr, elem)\n\t\t\t\tif err != nil {\n\t\t\t\t\treturn nil, newDecodeError(strconv.Itoa(idx), err)\n\t\t\t\t}\n\t\t\tcase vr.Type() == TypeNull:\n\t\t\t\tif err = vr.ReadNull(); err != nil {\n\t\t\t\t\treturn nil, err\n\t\t\t\t}\n\t\t\t\telem = reflect.Zero(val.Index(idx).Type())\n\t\t\tdefault:\n\t\t\t\te := elem.Elem()\n\t\t\t\tvalueDecoder, err := dc.LookupDecoder(e.Type())\n\t\t\t\tif err != nil {\n\t\t\t\t\treturn nil, err\n\t\t\t\t}\n\t\t\t\terr = valueDecoder.DecodeValue(dc, vr, e)\n\t\t\t\tif err != nil {\n\t\t\t\t\treturn nil, newDecodeError(strconv.Itoa(idx), err)\n\t\t\t\t}\n\t\t\t}\n\t\t} else {\n\t\t\t// For non-interface slices, or if we've exhausted the pre-populated\n\t\t\t// slots, we create a fresh value.\n\n\t\t\tif vDecoder == nil {\n\t\t\t\tvDecoder, err = dc.LookupDecoder(eType)\n\t\t\t\tif err != nil {\n\t\t\t\t\treturn nil, err\n\t\t\t\t}\n\t\t\t}\n\t\t\telem, err = decodeTypeOrValueWithInfo(vDecoder, dc, vr, eType)\n\t\t\tif err != nil {\n\t\t\t\treturn nil, newDecodeError(strconv.Itoa(idx), err)\n\t\t\t}\n\t\t}\n\n\t\telems = append(elems, elem)\n\t\tidx++\n\t}\n\n\treturn elems, nil\n}\n\nfunc codeWithScopeDecodeType(dc DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tCodeWithScope {\n\t\treturn emptyValue, ValueDecoderError{\n\t\t\tName: \"CodeWithScopeDecodeValue\",\n\t\t\tTypes: []reflect.Type{tCodeWithScope},\n\t\t\tReceived: reflect.Zero(t),\n\t\t}\n\t}\n\n\tvar cws CodeWithScope\n\tvar err error\n\tswitch vrType := vr.Type(); vrType {\n\tcase TypeCodeWithScope:\n\t\tcode, dr, err := vr.ReadCodeWithScope()\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\n\t\tscope := reflect.New(tD).Elem()\n\t\telems, err := decodeElemsFromDocumentReader(dc, dr)\n\t\tif err != nil {\n\t\t\treturn emptyValue, err\n\t\t}\n\n\t\tscope.Set(reflect.MakeSlice(tD, 0, len(elems)))\n\t\tscope.Set(reflect.Append(scope, elems...))\n\n\t\tcws = CodeWithScope{\n\t\t\tCode: JavaScript(code),\n\t\t\tScope: scope.Interface().(D),\n\t\t}\n\tcase TypeNull:\n\t\terr = vr.ReadNull()\n\tcase TypeUndefined:\n\t\terr = vr.ReadUndefined()\n\tdefault:\n\t\treturn emptyValue, fmt.Errorf(\"cannot decode %v into a CodeWithScope\", vrType)\n\t}\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\treturn reflect.ValueOf(cws), nil\n}\n\n// codeWithScopeDecodeValue is the ValueDecoderFunc for CodeWithScope.\nfunc codeWithScopeDecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tCodeWithScope {\n\t\treturn ValueDecoderError{Name: \"CodeWithScopeDecodeValue\", Types: []reflect.Type{tCodeWithScope}, Received: val}\n\t}\n\n\telem, err := codeWithScopeDecodeType(dc, vr, tCodeWithScope)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.Set(elem)\n\treturn nil\n}\n\nfunc decodeD(dc DecodeContext, vr ValueReader, _ reflect.Value) ([]reflect.Value, error) {\n\tswitch vr.Type() {\n\tcase Type(0), TypeEmbeddedDocument:\n\tdefault:\n\t\treturn nil, fmt.Errorf(\"cannot decode %v into a D\", vr.Type())\n\t}\n\n\tdr, err := vr.ReadDocument()\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\n\treturn decodeElemsFromDocumentReader(dc, dr)\n}\n\nfunc decodeElemsFromDocumentReader(dc DecodeContext, dr DocumentReader) ([]reflect.Value, error) {\n\tdecoder, err := dc.LookupDecoder(tEmpty)\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\n\telems := make([]reflect.Value, 0)\n\tfor {\n\t\tkey, vr, err := dr.ReadElement()\n\t\tif errors.Is(err, ErrEOD) {\n\t\t\tbreak\n\t\t}\n\t\tif err != nil {\n\t\t\treturn nil, err\n\t\t}\n\n\t\tval := reflect.New(tEmpty).Elem()\n\t\terr = decoder.DecodeValue(dc, vr, val)\n\t\tif err != nil {\n\t\t\treturn nil, newDecodeError(key, err)\n\t\t}\n\n\t\telems = append(elems, reflect.ValueOf(E{Key: key, Value: val.Interface()}))\n\t}\n\n\treturn elems, nil\n}\n" }, { "path": "bson/default_value_decoders_test.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"bytes\"\n\t\"encoding/json\"\n\t\"errors\"\n\t\"fmt\"\n\t\"math\"\n\t\"net/url\"\n\t\"reflect\"\n\t\"strings\"\n\t\"testing\"\n\t\"time\"\n\n\t\"github.com/google/go-cmp/cmp\"\n\t\"go.mongodb.org/mongo-driver/v2/internal/assert\"\n\t\"go.mongodb.org/mongo-driver/v2/x/bsonx/bsoncore\"\n)\n\nfunc TestDefaultValueDecoders(t *testing.T) {\n\twrong := func(string, string) string { return \"wrong\" }\n\n\ttype mybool bool\n\ttype myint8 int8\n\ttype myint16 int16\n\ttype myint32 int32\n\ttype myint64 int64\n\ttype myint int\n\ttype myuint8 uint8\n\ttype myuint16 uint16\n\ttype myuint32 uint32\n\ttype myuint64 uint64\n\ttype myuint uint\n\ttype myfloat32 float32\n\ttype myfloat64 float64\n\ttype mystring string\n\ttype mystruct struct{}\n\n\tconst cansetreflectiontest = \"cansetreflectiontest\"\n\tconst cansettest = \"cansettest\"\n\n\tnow := time.Now().Truncate(time.Millisecond)\n\td128 := NewDecimal128(12345, 67890)\n\tpbool := func(b bool) *bool { return &b }\n\tpi32 := func(i32 int32) *int32 { return &i32 }\n\tpi64 := func(i64 int64) *int64 { return &i64 }\n\n\ttype subtest struct {\n\t\tname string\n\t\tval any\n\t\tdctx *DecodeContext\n\t\tllvrw *valueReaderWriter\n\t\tinvoke invoked\n\t\terr error\n\t}\n\n\ttestCases := []struct {\n\t\tname string\n\t\tvd ValueDecoder\n\t\tsubtests []subtest\n\t}{\n\t\t{\n\t\t\t\"BooleanDecodeValue\",\n\t\t\tValueDecoderFunc(booleanDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeBoolean},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"BooleanDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Bool},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not boolean\",\n\t\t\t\t\tbool(false),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into a boolean\", TypeString),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"fast path\",\n\t\t\t\t\tbool(true),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeBoolean, Return: bool(true)},\n\t\t\t\t\treadBoolean,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"reflection path\",\n\t\t\t\t\tmybool(true),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeBoolean, Return: bool(true)},\n\t\t\t\t\treadBoolean,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"reflection path error\",\n\t\t\t\t\tmybool(true),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeBoolean, Return: bool(true), Err: errors.New(\"ReadBoolean Error\"), ErrAfter: readBoolean},\n\t\t\t\t\treadBoolean, errors.New(\"ReadBoolean Error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"can set false\",\n\t\t\t\t\tcansettest,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeBoolean},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{Name: \"BooleanDecodeValue\", Kinds: []reflect.Kind{reflect.Bool}},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\tmybool(false),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\tmybool(false),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"IntDecodeValue\",\n\t\t\tValueDecoderFunc(intDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(0)},\n\t\t\t\t\treadInt32,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"IntDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64, reflect.Int},\n\t\t\t\t\t\tReceived: reflect.ValueOf(wrong),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not int32/int64\",\n\t\t\t\t\t0,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into an integer type\", TypeString),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadInt32 error\",\n\t\t\t\t\t0,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(0), Err: errors.New(\"ReadInt32 error\"), ErrAfter: readInt32},\n\t\t\t\t\treadInt32,\n\t\t\t\t\terrors.New(\"ReadInt32 error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadInt64 error\",\n\t\t\t\t\t0,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Return: int64(0), Err: errors.New(\"ReadInt64 error\"), ErrAfter: readInt64},\n\t\t\t\t\treadInt64,\n\t\t\t\t\terrors.New(\"ReadInt64 error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadDouble error\",\n\t\t\t\t\t0,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(0), Err: errors.New(\"ReadDouble error\"), ErrAfter: readDouble},\n\t\t\t\t\treadDouble,\n\t\t\t\t\terrors.New(\"ReadDouble error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadDouble\", int64(3), &DecodeContext{},\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(3.00)}, readDouble,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadDouble (truncate)\", int64(3), &DecodeContext{truncate: true},\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(3.14)}, readDouble,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadDouble (no truncate)\", int64(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(3.14)}, readDouble,\n\t\t\t\t\terrCannotTruncate,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadDouble overflows int64\", int64(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: math.MaxFloat64}, readDouble,\n\t\t\t\t\tfmt.Errorf(\"%g overflows int64\", math.MaxFloat64),\n\t\t\t\t},\n\t\t\t\t{\"int8/fast path\", int8(127), nil, &valueReaderWriter{BSONType: TypeInt32, Return: int32(127)}, readInt32, nil},\n\t\t\t\t{\"int16/fast path\", int16(32676), nil, &valueReaderWriter{BSONType: TypeInt32, Return: int32(32676)}, readInt32, nil},\n\t\t\t\t{\"int32/fast path\", int32(1234), nil, &valueReaderWriter{BSONType: TypeInt32, Return: int32(1234)}, readInt32, nil},\n\t\t\t\t{\"int64/fast path\", int64(1234), nil, &valueReaderWriter{BSONType: TypeInt64, Return: int64(1234)}, readInt64, nil},\n\t\t\t\t{\"int/fast path\", int(1234), nil, &valueReaderWriter{BSONType: TypeInt64, Return: int64(1234)}, readInt64, nil},\n\t\t\t\t{\n\t\t\t\t\t\"int8/fast path - nil\", (*int8)(nil), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(0)}, readInt32,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"IntDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64, reflect.Int},\n\t\t\t\t\t\tReceived: reflect.ValueOf((*int8)(nil)),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int16/fast path - nil\", (*int16)(nil), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(0)}, readInt32,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"IntDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64, reflect.Int},\n\t\t\t\t\t\tReceived: reflect.ValueOf((*int16)(nil)),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int32/fast path - nil\", (*int32)(nil), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(0)}, readInt32,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"IntDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64, reflect.Int},\n\t\t\t\t\t\tReceived: reflect.ValueOf((*int32)(nil)),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int64/fast path - nil\", (*int64)(nil), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(0)}, readInt32,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"IntDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64, reflect.Int},\n\t\t\t\t\t\tReceived: reflect.ValueOf((*int64)(nil)),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int/fast path - nil\", (*int)(nil), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(0)}, readInt32,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"IntDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64, reflect.Int},\n\t\t\t\t\t\tReceived: reflect.ValueOf((*int)(nil)),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int8/fast path - overflow\", int8(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(129)}, readInt32,\n\t\t\t\t\tfmt.Errorf(\"%d overflows int8\", 129),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int16/fast path - overflow\", int16(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(32768)}, readInt32,\n\t\t\t\t\tfmt.Errorf(\"%d overflows int16\", 32768),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int32/fast path - overflow\", int32(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Return: int64(2147483648)}, readInt64,\n\t\t\t\t\tfmt.Errorf(\"%d overflows int32\", int64(2147483648)),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int8/fast path - overflow (negative)\", int8(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(-129)}, readInt32,\n\t\t\t\t\tfmt.Errorf(\"%d overflows int8\", -129),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int16/fast path - overflow (negative)\", int16(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(-32769)}, readInt32,\n\t\t\t\t\tfmt.Errorf(\"%d overflows int16\", -32769),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int32/fast path - overflow (negative)\", int32(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Return: int64(-2147483649)}, readInt64,\n\t\t\t\t\tfmt.Errorf(\"%d overflows int32\", int64(-2147483649)),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int8/reflection path\", myint8(127), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(127)}, readInt32,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int16/reflection path\", myint16(255), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(255)}, readInt32,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int32/reflection path\", myint32(511), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(511)}, readInt32,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int64/reflection path\", myint64(1023), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(1023)}, readInt32,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int/reflection path\", myint(2047), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(2047)}, readInt32,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int8/reflection path - overflow\", myint8(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(129)}, readInt32,\n\t\t\t\t\tfmt.Errorf(\"%d overflows int8\", 129),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int16/reflection path - overflow\", myint16(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(32768)}, readInt32,\n\t\t\t\t\tfmt.Errorf(\"%d overflows int16\", 32768),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int32/reflection path - overflow\", myint32(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Return: int64(2147483648)}, readInt64,\n\t\t\t\t\tfmt.Errorf(\"%d overflows int32\", int64(2147483648)),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int8/reflection path - overflow (negative)\", myint8(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(-129)}, readInt32,\n\t\t\t\t\tfmt.Errorf(\"%d overflows int8\", -129),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int16/reflection path - overflow (negative)\", myint16(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(-32769)}, readInt32,\n\t\t\t\t\tfmt.Errorf(\"%d overflows int16\", -32769),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"int32/reflection path - overflow (negative)\", myint32(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Return: int64(-2147483649)}, readInt64,\n\t\t\t\t\tfmt.Errorf(\"%d overflows int32\", int64(-2147483649)),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"can set false\",\n\t\t\t\t\tcansettest,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(0)},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"IntDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64, reflect.Int},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\tmyint(0),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\tmyint(0),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"defaultUIntCodec.DecodeValue\",\n\t\t\t&uintCodec{},\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(0)},\n\t\t\t\t\treadInt32,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"UintDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Uint},\n\t\t\t\t\t\tReceived: reflect.ValueOf(wrong),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not int32/int64\",\n\t\t\t\t\t0,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into an integer type\", TypeString),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadInt32 error\",\n\t\t\t\t\tuint(0),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(0), Err: errors.New(\"ReadInt32 error\"), ErrAfter: readInt32},\n\t\t\t\t\treadInt32,\n\t\t\t\t\terrors.New(\"ReadInt32 error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadInt64 error\",\n\t\t\t\t\tuint(0),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Return: int64(0), Err: errors.New(\"ReadInt64 error\"), ErrAfter: readInt64},\n\t\t\t\t\treadInt64,\n\t\t\t\t\terrors.New(\"ReadInt64 error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadDouble error\",\n\t\t\t\t\t0,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(0), Err: errors.New(\"ReadDouble error\"), ErrAfter: readDouble},\n\t\t\t\t\treadDouble,\n\t\t\t\t\terrors.New(\"ReadDouble error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadDouble\", uint64(3), &DecodeContext{},\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(3.00)}, readDouble,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadDouble (truncate)\", uint64(3), &DecodeContext{truncate: true},\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(3.14)}, readDouble,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadDouble (no truncate)\", uint64(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(3.14)}, readDouble,\n\t\t\t\t\terrCannotTruncate,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadDouble overflows int64\", uint64(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: math.MaxFloat64}, readDouble,\n\t\t\t\t\tfmt.Errorf(\"%g overflows int64\", math.MaxFloat64),\n\t\t\t\t},\n\t\t\t\t{\"uint8/fast path\", uint8(127), nil, &valueReaderWriter{BSONType: TypeInt32, Return: int32(127)}, readInt32, nil},\n\t\t\t\t{\"uint16/fast path\", uint16(255), nil, &valueReaderWriter{BSONType: TypeInt32, Return: int32(255)}, readInt32, nil},\n\t\t\t\t{\"uint32/fast path\", uint32(1234), nil, &valueReaderWriter{BSONType: TypeInt32, Return: int32(1234)}, readInt32, nil},\n\t\t\t\t{\"uint64/fast path\", uint64(1234), nil, &valueReaderWriter{BSONType: TypeInt64, Return: int64(1234)}, readInt64, nil},\n\t\t\t\t{\"uint/fast path\", uint(1234), nil, &valueReaderWriter{BSONType: TypeInt64, Return: int64(1234)}, readInt64, nil},\n\t\t\t\t{\n\t\t\t\t\t\"uint8/fast path - nil\", (*uint8)(nil), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(0)}, readInt32,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"UintDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Uint},\n\t\t\t\t\t\tReceived: reflect.ValueOf((*uint8)(nil)),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint16/fast path - nil\", (*uint16)(nil), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(0)}, readInt32,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"UintDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Uint},\n\t\t\t\t\t\tReceived: reflect.ValueOf((*uint16)(nil)),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint32/fast path - nil\", (*uint32)(nil), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(0)}, readInt32,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"UintDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Uint},\n\t\t\t\t\t\tReceived: reflect.ValueOf((*uint32)(nil)),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint64/fast path - nil\", (*uint64)(nil), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(0)}, readInt32,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"UintDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Uint},\n\t\t\t\t\t\tReceived: reflect.ValueOf((*uint64)(nil)),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint/fast path - nil\", (*uint)(nil), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(0)}, readInt32,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"UintDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Uint},\n\t\t\t\t\t\tReceived: reflect.ValueOf((*uint)(nil)),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint8/fast path - overflow\", uint8(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(1 << 8)}, readInt32,\n\t\t\t\t\tfmt.Errorf(\"%d overflows uint8\", 1<<8),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint16/fast path - overflow\", uint16(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(1 << 16)}, readInt32,\n\t\t\t\t\tfmt.Errorf(\"%d overflows uint16\", 1<<16),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint32/fast path - overflow\", uint32(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Return: int64(1 << 32)}, readInt64,\n\t\t\t\t\tfmt.Errorf(\"%d overflows uint32\", int64(1<<32)),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint8/fast path - overflow (negative)\", uint8(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(-1)}, readInt32,\n\t\t\t\t\tfmt.Errorf(\"%d overflows uint8\", -1),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint16/fast path - overflow (negative)\", uint16(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(-1)}, readInt32,\n\t\t\t\t\tfmt.Errorf(\"%d overflows uint16\", -1),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint32/fast path - overflow (negative)\", uint32(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Return: int64(-1)}, readInt64,\n\t\t\t\t\tfmt.Errorf(\"%d overflows uint32\", -1),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint64/fast path - overflow (negative)\", uint64(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Return: int64(-1)}, readInt64,\n\t\t\t\t\tfmt.Errorf(\"%d overflows uint64\", -1),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint/fast path - overflow (negative)\", uint(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Return: int64(-1)}, readInt64,\n\t\t\t\t\tfmt.Errorf(\"%d overflows uint\", -1),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint8/reflection path\", myuint8(127), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(127)}, readInt32,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint16/reflection path\", myuint16(255), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(255)}, readInt32,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint32/reflection path\", myuint32(511), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(511)}, readInt32,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint64/reflection path\", myuint64(1023), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(1023)}, readInt32,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint/reflection path\", myuint(2047), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(2047)}, readInt32,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint8/reflection path - overflow\", myuint8(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(1 << 8)}, readInt32,\n\t\t\t\t\tfmt.Errorf(\"%d overflows uint8\", 1<<8),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint16/reflection path - overflow\", myuint16(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(1 << 16)}, readInt32,\n\t\t\t\t\tfmt.Errorf(\"%d overflows uint16\", 1<<16),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint32/reflection path - overflow\", myuint32(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Return: int64(1 << 32)}, readInt64,\n\t\t\t\t\tfmt.Errorf(\"%d overflows uint32\", int64(1<<32)),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint8/reflection path - overflow (negative)\", myuint8(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(-1)}, readInt32,\n\t\t\t\t\tfmt.Errorf(\"%d overflows uint8\", -1),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint16/reflection path - overflow (negative)\", myuint16(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(-1)}, readInt32,\n\t\t\t\t\tfmt.Errorf(\"%d overflows uint16\", -1),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint32/reflection path - overflow (negative)\", myuint32(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Return: int64(-1)}, readInt64,\n\t\t\t\t\tfmt.Errorf(\"%d overflows uint32\", -1),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint64/reflection path - overflow (negative)\", myuint64(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Return: int64(-1)}, readInt64,\n\t\t\t\t\tfmt.Errorf(\"%d overflows uint64\", -1),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"uint/reflection path - overflow (negative)\", myuint(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Return: int64(-1)}, readInt64,\n\t\t\t\t\tfmt.Errorf(\"%d overflows uint\", -1),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"can set false\",\n\t\t\t\t\tcansettest,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(0)},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"UintDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Uint},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"FloatDecodeValue\",\n\t\t\tValueDecoderFunc(floatDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(0)},\n\t\t\t\t\treadDouble,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"FloatDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Float32, reflect.Float64},\n\t\t\t\t\t\tReceived: reflect.ValueOf(wrong),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not double\",\n\t\t\t\t\t0,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into a float32 or float64 type\", TypeString),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadDouble error\",\n\t\t\t\t\tfloat64(0),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(0), Err: errors.New(\"ReadDouble error\"), ErrAfter: readDouble},\n\t\t\t\t\treadDouble,\n\t\t\t\t\terrors.New(\"ReadDouble error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadInt32 error\",\n\t\t\t\t\tfloat64(0),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(0), Err: errors.New(\"ReadInt32 error\"), ErrAfter: readInt32},\n\t\t\t\t\treadInt32,\n\t\t\t\t\terrors.New(\"ReadInt32 error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadInt64 error\",\n\t\t\t\t\tfloat64(0),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Return: int64(0), Err: errors.New(\"ReadInt64 error\"), ErrAfter: readInt64},\n\t\t\t\t\treadInt64,\n\t\t\t\t\terrors.New(\"ReadInt64 error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"float64/int32\", float32(32.0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(32)}, readInt32,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"float64/int64\", float32(64.0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Return: int64(64)}, readInt64,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"float32/fast path (equal)\", float32(3.0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(3.0)}, readDouble,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"float64/fast path\", float64(3.14159), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(3.14159)}, readDouble,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"float32/fast path (truncate)\", float32(3.14), &DecodeContext{truncate: true},\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(3.14)}, readDouble,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"float32/fast path (no truncate)\", float32(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(3.14)}, readDouble,\n\t\t\t\t\terrCannotTruncate,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"float32/fast path - nil\", (*float32)(nil), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(0)}, readDouble,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"FloatDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Float32, reflect.Float64},\n\t\t\t\t\t\tReceived: reflect.ValueOf((*float32)(nil)),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"float64/fast path - nil\", (*float64)(nil), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(0)}, readDouble,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"FloatDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Float32, reflect.Float64},\n\t\t\t\t\t\tReceived: reflect.ValueOf((*float64)(nil)),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"float32/reflection path (equal)\", myfloat32(3.0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(3.0)}, readDouble,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"float64/reflection path\", myfloat64(3.14159), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(3.14159)}, readDouble,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"float32/reflection path (truncate)\", myfloat32(3.14), &DecodeContext{truncate: true},\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(3.14)}, readDouble,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"float32/reflection path (no truncate)\", myfloat32(0), nil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(3.14)}, readDouble,\n\t\t\t\t\terrCannotTruncate,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"can set false\",\n\t\t\t\t\tcansettest,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(0)},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"FloatDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Float32, reflect.Float64},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"defaultTimeCodec.DecodeValue\",\n\t\t\t&timeCodec{},\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDateTime, Return: int64(0)},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"TimeDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tTime},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadDateTime error\",\n\t\t\t\t\ttime.Time{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDateTime, Return: int64(0), Err: errors.New(\"ReadDateTime error\"), ErrAfter: readDateTime},\n\t\t\t\t\treadDateTime,\n\t\t\t\t\terrors.New(\"ReadDateTime error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"time.Time\",\n\t\t\t\t\tnow,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDateTime, Return: now.UnixNano() / int64(time.Millisecond)},\n\t\t\t\t\treadDateTime,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"can set false\",\n\t\t\t\t\tcansettest,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDateTime, Return: int64(0)},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{Name: \"TimeDecodeValue\", Types: []reflect.Type{tTime}},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\ttime.Time{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\ttime.Time{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"defaultMapCodec.DecodeValue\",\n\t\t\t&mapCodec{},\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong kind\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"MapDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Map},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"wrong kind (non-string key)\",\n\t\t\t\t\tmap[bool]any{},\n\t\t\t\t\t&DecodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\treadElement,\n\t\t\t\t\tfmt.Errorf(\"unsupported key type: %T\", false),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadDocument Error\",\n\t\t\t\t\tmake(map[string]any),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"rd error\"), ErrAfter: readDocument},\n\t\t\t\t\treadDocument,\n\t\t\t\t\terrors.New(\"rd error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Lookup Error\",\n\t\t\t\t\tmap[string]string{},\n\t\t\t\t\t&DecodeContext{Registry: newTestRegistry()},\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\treadDocument,\n\t\t\t\t\terrNoDecoder{Type: reflect.TypeOf(\"\")},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadElement Error\",\n\t\t\t\t\tmake(map[string]any),\n\t\t\t\t\t&DecodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"re error\"), ErrAfter: readElement},\n\t\t\t\t\treadElement,\n\t\t\t\t\terrors.New(\"re error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"can set false\",\n\t\t\t\t\tcansettest,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{Name: \"MapDecodeValue\", Kinds: []reflect.Kind{reflect.Map}},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"wrong BSON type\",\n\t\t\t\t\tmap[string]any{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\terrors.New(\"cannot decode string into a map[string]interface {}\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\t(map[string]any)(nil),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\t(map[string]any)(nil),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"ArrayDecodeValue\",\n\t\t\tValueDecoderFunc(arrayDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong kind\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"ArrayDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Array},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"can set false\",\n\t\t\t\t\tcansettest,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{Name: \"ArrayDecodeValue\", Kinds: []reflect.Kind{reflect.Array}},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Not Type Array\",\n\t\t\t\t\t[1]any{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\terrors.New(\"cannot decode string into an array\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadArray Error\",\n\t\t\t\t\t[1]any{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"ra error\"), ErrAfter: readArray, BSONType: TypeArray},\n\t\t\t\t\treadArray,\n\t\t\t\t\terrors.New(\"ra error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Lookup Error\",\n\t\t\t\t\t[1]string{},\n\t\t\t\t\t&DecodeContext{Registry: newTestRegistry()},\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeArray},\n\t\t\t\t\treadArray,\n\t\t\t\t\terrNoDecoder{Type: reflect.TypeOf(\"\")},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadValue Error\",\n\t\t\t\t\t[1]string{},\n\t\t\t\t\t&DecodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"rv error\"), ErrAfter: readValue, BSONType: TypeArray},\n\t\t\t\t\treadValue,\n\t\t\t\t\terrors.New(\"rv error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"DecodeValue Error\",\n\t\t\t\t\t[1]string{},\n\t\t\t\t\t&DecodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeArray},\n\t\t\t\t\treadValue,\n\t\t\t\t\t&DecodeError{keys: []string{\"0\"}, wrapped: errors.New(\"cannot decode array into a string type\")},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Document but not D\",\n\t\t\t\t\t[1]string{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: Type(0)},\n\t\t\t\t\tnothing,\n\t\t\t\t\terrors.New(\"cannot decode document into [1]string\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"EmbeddedDocument but not D\",\n\t\t\t\t\t[1]string{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeEmbeddedDocument},\n\t\t\t\t\tnothing,\n\t\t\t\t\terrors.New(\"cannot decode document into [1]string\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\t[1]string{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\t[1]string{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"defaultSliceCodec.DecodeValue\",\n\t\t\t&sliceCodec{},\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong kind\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"SliceDecodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Slice},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"can set false\",\n\t\t\t\t\tcansettest,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{Name: \"SliceDecodeValue\", Kinds: []reflect.Kind{reflect.Slice}},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Not Type Array\",\n\t\t\t\t\t[]any{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32},\n\t\t\t\t\tnothing,\n\t\t\t\t\terrors.New(\"cannot decode 32-bit integer into a slice\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadArray Error\",\n\t\t\t\t\t[]any{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"ra error\"), ErrAfter: readArray, BSONType: TypeArray},\n\t\t\t\t\treadArray,\n\t\t\t\t\terrors.New(\"ra error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Lookup Error\",\n\t\t\t\t\t[]string{},\n\t\t\t\t\t&DecodeContext{Registry: newTestRegistry()},\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeArray},\n\t\t\t\t\treadArray,\n\t\t\t\t\terrNoDecoder{Type: reflect.TypeOf(\"\")},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadValue Error\",\n\t\t\t\t\t[]string{},\n\t\t\t\t\t&DecodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"rv error\"), ErrAfter: readValue, BSONType: TypeArray},\n\t\t\t\t\treadValue,\n\t\t\t\t\terrors.New(\"rv error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"DecodeValue Error\",\n\t\t\t\t\t[]string{},\n\t\t\t\t\t&DecodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeArray},\n\t\t\t\t\treadValue,\n\t\t\t\t\t&DecodeError{keys: []string{\"0\"}, wrapped: errors.New(\"cannot decode array into a string type\")},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Document but not D\",\n\t\t\t\t\t[]string{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: Type(0)},\n\t\t\t\t\tnothing,\n\t\t\t\t\terrors.New(\"cannot decode document into []string\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"EmbeddedDocument but not D\",\n\t\t\t\t\t[]string{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeEmbeddedDocument},\n\t\t\t\t\tnothing,\n\t\t\t\t\terrors.New(\"cannot decode document into []string\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\t([]string)(nil),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\t([]string)(nil),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"ObjectIDDecodeValue\",\n\t\t\tValueDecoderFunc(objectIDDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeObjectID},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"ObjectIDDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tOID},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not objectID\",\n\t\t\t\t\tObjectID{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into an ObjectID\", TypeInt32),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadObjectID Error\",\n\t\t\t\t\tObjectID{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeObjectID, Err: errors.New(\"roid error\"), ErrAfter: readObjectID},\n\t\t\t\t\treadObjectID,\n\t\t\t\t\terrors.New(\"roid error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"can set false\",\n\t\t\t\t\tcansettest,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeObjectID, Return: ObjectID{}},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{Name: \"ObjectIDDecodeValue\", Types: []reflect.Type{tOID}},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success\",\n\t\t\t\t\tObjectID{0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0A, 0x0B, 0x0C},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{\n\t\t\t\t\t\tBSONType: TypeObjectID,\n\t\t\t\t\t\tReturn: ObjectID{0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0A, 0x0B, 0x0C},\n\t\t\t\t\t},\n\t\t\t\t\treadObjectID,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success/string\",\n\t\t\t\t\tObjectID{0x30, 0x31, 0x32, 0x33, 0x34, 0x35, 0x36, 0x37, 0x38, 0x39, 0x61, 0x62},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{\n\t\t\t\t\t\tBSONType: TypeString,\n\t\t\t\t\t\tReturn: \"0123456789ab\",\n\t\t\t\t\t},\n\t\t\t\t\treadString,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success/string-hex\",\n\t\t\t\t\tObjectID{0x30, 0x31, 0x32, 0x33, 0x34, 0x35, 0x36, 0x37, 0x38, 0x39, 0x61, 0x62},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{\n\t\t\t\t\t\tBSONType: TypeString,\n\t\t\t\t\t\tReturn: \"303132333435363738396162\",\n\t\t\t\t\t},\n\t\t\t\t\treadString,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\tObjectID{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\tObjectID{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"Decimal128DecodeValue\",\n\t\t\tValueDecoderFunc(decimal128DecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDecimal128},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"Decimal128DecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tDecimal},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not decimal128\",\n\t\t\t\t\tDecimal128{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into a Decimal128\", TypeString),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadDecimal128 Error\",\n\t\t\t\t\tDecimal128{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDecimal128, Err: errors.New(\"rd128 error\"), ErrAfter: readDecimal128},\n\t\t\t\t\treadDecimal128,\n\t\t\t\t\terrors.New(\"rd128 error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"can set false\",\n\t\t\t\t\tcansettest,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDecimal128, Return: d128},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{Name: \"Decimal128DecodeValue\", Types: []reflect.Type{tDecimal}},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success\",\n\t\t\t\t\td128,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDecimal128, Return: d128},\n\t\t\t\t\treadDecimal128,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\tDecimal128{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\tDecimal128{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"JSONNumberDecodeValue\",\n\t\t\tValueDecoderFunc(jsonNumberDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeObjectID},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"JSONNumberDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tJSONNumber},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not double/int32/int64\",\n\t\t\t\t\tjson.Number(\"\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into a json.Number\", TypeString),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadDouble Error\",\n\t\t\t\t\tjson.Number(\"\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Err: errors.New(\"rd error\"), ErrAfter: readDouble},\n\t\t\t\t\treadDouble,\n\t\t\t\t\terrors.New(\"rd error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadInt32 Error\",\n\t\t\t\t\tjson.Number(\"\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Err: errors.New(\"ri32 error\"), ErrAfter: readInt32},\n\t\t\t\t\treadInt32,\n\t\t\t\t\terrors.New(\"ri32 error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadInt64 Error\",\n\t\t\t\t\tjson.Number(\"\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Err: errors.New(\"ri64 error\"), ErrAfter: readInt64},\n\t\t\t\t\treadInt64,\n\t\t\t\t\terrors.New(\"ri64 error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"can set false\",\n\t\t\t\t\tcansettest,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeObjectID, Return: ObjectID{}},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{Name: \"JSONNumberDecodeValue\", Types: []reflect.Type{tJSONNumber}},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success/double\",\n\t\t\t\t\tjson.Number(\"3.14159\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(3.14159)},\n\t\t\t\t\treadDouble,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success/int32\",\n\t\t\t\t\tjson.Number(\"12345\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32, Return: int32(12345)},\n\t\t\t\t\treadInt32,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success/int64\",\n\t\t\t\t\tjson.Number(\"1234567890\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt64, Return: int64(1234567890)},\n\t\t\t\t\treadInt64,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\tjson.Number(\"\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\tjson.Number(\"\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"URLDecodeValue\",\n\t\t\tValueDecoderFunc(urlDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\turl.URL{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into a *url.URL\", TypeInt32),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not *url.URL\",\n\t\t\t\t\tint64(0),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString, Return: \"http://example.com\"},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"URLDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tURL},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(int64(0))).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadString error\",\n\t\t\t\t\turl.URL{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString, Err: errors.New(\"rs error\"), ErrAfter: readString},\n\t\t\t\t\treadString,\n\t\t\t\t\terrors.New(\"rs error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"url.Parse error\",\n\t\t\t\t\turl.URL{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString, Return: \"not-valid-%%%%://\"},\n\t\t\t\t\treadString,\n\t\t\t\t\t&url.Error{\n\t\t\t\t\t\tOp: \"parse\",\n\t\t\t\t\t\tURL: \"not-valid-%%%%://\",\n\t\t\t\t\t\tErr: errors.New(\"first path segment in URL cannot contain colon\"),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"can set false\",\n\t\t\t\t\tcansettest,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString, Return: \"http://example.com\"},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{Name: \"URLDecodeValue\", Types: []reflect.Type{tURL}},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"url.URL\",\n\t\t\t\t\turl.URL{Scheme: \"http\", Host: \"example.com\"},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString, Return: \"http://example.com\"},\n\t\t\t\t\treadString,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\turl.URL{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\turl.URL{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"defaultByteSliceCodec.DecodeValue\",\n\t\t\t&byteSliceCodec{},\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\t[]byte{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into a []byte\", TypeInt32),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not []byte\",\n\t\t\t\t\tint64(0),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeBinary, Return: bsoncore.Value{Type: bsoncore.TypeBinary}},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"ByteSliceDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tByteSlice},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(int64(0))).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadBinary error\",\n\t\t\t\t\t[]byte{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeBinary, Err: errors.New(\"rb error\"), ErrAfter: readBinary},\n\t\t\t\t\treadBinary,\n\t\t\t\t\terrors.New(\"rb error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"incorrect subtype\",\n\t\t\t\t\t[]byte{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{\n\t\t\t\t\t\tBSONType: TypeBinary,\n\t\t\t\t\t\tReturn: bsoncore.Value{\n\t\t\t\t\t\t\tType: bsoncore.TypeBinary,\n\t\t\t\t\t\t\tData: bsoncore.AppendBinary(nil, 0xFF, []byte{0x01, 0x02, 0x03}),\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t\treadBinary,\n\t\t\t\t\tdecodeBinaryError{subtype: byte(0xFF), typeName: \"[]byte\"},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"can set false\",\n\t\t\t\t\tcansettest,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeBinary, Return: bsoncore.AppendBinary(nil, 0x00, []byte{0x01, 0x02, 0x03})},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{Name: \"ByteSliceDecodeValue\", Types: []reflect.Type{tByteSlice}},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\t([]byte)(nil),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\t([]byte)(nil),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"defaultStringCodec.DecodeValue\",\n\t\t\t&stringCodec{},\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"symbol\",\n\t\t\t\t\t\"var hello = 'world';\",\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeSymbol, Return: \"var hello = 'world';\"},\n\t\t\t\t\treadSymbol,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\t\"\",\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\t\"\",\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"ValueUnmarshalerDecodeValue\",\n\t\t\tValueDecoderFunc(valueUnmarshalerDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"ValueUnmarshalerDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tValueUnmarshaler},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"copy error\",\n\t\t\t\t\t&testValueUnmarshaler{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString, Err: errors.New(\"copy error\"), ErrAfter: readString},\n\t\t\t\t\treadString,\n\t\t\t\t\terrors.New(\"copy error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ValueUnmarshaler\",\n\t\t\t\t\t&testValueUnmarshaler{t: TypeString, val: bsoncore.AppendString(nil, \"hello, world\")},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString, Return: \"hello, world\"},\n\t\t\t\t\treadString,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"UnmarshalerDecodeValue\",\n\t\t\tValueDecoderFunc(unmarshalerDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"UnmarshalerDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tUnmarshaler},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"copy error\",\n\t\t\t\t\t&testUnmarshaler{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString, Err: errors.New(\"copy error\"), ErrAfter: readString},\n\t\t\t\t\treadString,\n\t\t\t\t\terrors.New(\"copy error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t// Only the pointer form of testUnmarshaler implements Unmarshaler\n\t\t\t\t\t\"value does not implement Unmarshaler\",\n\t\t\t\t\t&testUnmarshaler{\n\t\t\t\t\t\tInvoked: true,\n\t\t\t\t\t\tVal: bsoncore.AppendDouble(nil, 3.14159),\n\t\t\t\t\t},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(3.14159)},\n\t\t\t\t\treadDouble,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Unmarshaler\",\n\t\t\t\t\t&testUnmarshaler{\n\t\t\t\t\t\tInvoked: true,\n\t\t\t\t\t\tVal: bsoncore.AppendDouble(nil, 3.14159),\n\t\t\t\t\t},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDouble, Return: float64(3.14159)},\n\t\t\t\t\treadDouble,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"PointerCodec.DecodeValue\",\n\t\t\t&pointerCodec{},\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"not valid\", nil, nil, nil, nothing,\n\t\t\t\t\tValueDecoderError{Name: \"PointerCodec.DecodeValue\", Kinds: []reflect.Kind{reflect.Ptr}, Received: reflect.Value{}},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"can set\", cansettest, nil, nil, nothing,\n\t\t\t\t\tValueDecoderError{Name: \"PointerCodec.DecodeValue\", Kinds: []reflect.Kind{reflect.Ptr}},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"No Decoder\", &wrong, &DecodeContext{Registry: buildDefaultRegistry()}, nil, nothing,\n\t\t\t\t\terrNoDecoder{Type: reflect.TypeOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\t(*mystruct)(nil),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\t(*mystruct)(nil),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"BinaryDecodeValue\",\n\t\t\tValueDecoderFunc(binaryDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"BinaryDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tBinary},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not binary\",\n\t\t\t\t\tBinary{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into a Binary\", TypeString),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadBinary Error\",\n\t\t\t\t\tBinary{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeBinary, Err: errors.New(\"rb error\"), ErrAfter: readBinary},\n\t\t\t\t\treadBinary,\n\t\t\t\t\terrors.New(\"rb error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Binary/success\",\n\t\t\t\t\tBinary{Data: []byte{0x01, 0x02, 0x03}, Subtype: 0xFF},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{\n\t\t\t\t\t\tBSONType: TypeBinary,\n\t\t\t\t\t\tReturn: bsoncore.Value{\n\t\t\t\t\t\t\tType: bsoncore.TypeBinary,\n\t\t\t\t\t\t\tData: bsoncore.AppendBinary(nil, 0xFF, []byte{0x01, 0x02, 0x03}),\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t\treadBinary,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\tBinary{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\tBinary{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"UndefinedDecodeValue\",\n\t\t\tValueDecoderFunc(undefinedDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"UndefinedDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tUndefined},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not undefined\",\n\t\t\t\t\tUndefined{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into an Undefined\", TypeString),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadUndefined Error\",\n\t\t\t\t\tUndefined{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined, Err: errors.New(\"ru error\"), ErrAfter: readUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\terrors.New(\"ru error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadUndefined/success\",\n\t\t\t\t\tUndefined{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\tUndefined{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"DateTimeDecodeValue\",\n\t\t\tValueDecoderFunc(dateTimeDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDateTime},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"DateTimeDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tDateTime},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not datetime\",\n\t\t\t\t\tDateTime(0),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into a DateTime\", TypeString),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadDateTime Error\",\n\t\t\t\t\tDateTime(0),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDateTime, Err: errors.New(\"rdt error\"), ErrAfter: readDateTime},\n\t\t\t\t\treadDateTime,\n\t\t\t\t\terrors.New(\"rdt error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success\",\n\t\t\t\t\tDateTime(1234567890),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDateTime, Return: int64(1234567890)},\n\t\t\t\t\treadDateTime,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\tDateTime(0),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\tDateTime(0),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"NullDecodeValue\",\n\t\t\tValueDecoderFunc(nullDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"NullDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tNull},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not null\",\n\t\t\t\t\tNull{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into a Null\", TypeString),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadNull Error\",\n\t\t\t\t\tNull{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull, Err: errors.New(\"rn error\"), ErrAfter: readNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\terrors.New(\"rn error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success\",\n\t\t\t\t\tNull{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"RegexDecodeValue\",\n\t\t\tValueDecoderFunc(regexDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeRegex},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"RegexDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tRegex},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not regex\",\n\t\t\t\t\tRegex{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into a Regex\", TypeString),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadRegex Error\",\n\t\t\t\t\tRegex{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeRegex, Err: errors.New(\"rr error\"), ErrAfter: readRegex},\n\t\t\t\t\treadRegex,\n\t\t\t\t\terrors.New(\"rr error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success\",\n\t\t\t\t\tRegex{Pattern: \"foo\", Options: \"bar\"},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{\n\t\t\t\t\t\tBSONType: TypeRegex,\n\t\t\t\t\t\tReturn: bsoncore.Value{\n\t\t\t\t\t\t\tType: bsoncore.TypeRegex,\n\t\t\t\t\t\t\tData: bsoncore.AppendRegex(nil, \"foo\", \"bar\"),\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t\treadRegex,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\tRegex{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\tRegex{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"DBPointerDecodeValue\",\n\t\t\tValueDecoderFunc(dbPointerDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDBPointer},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"DBPointerDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tDBPointer},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not dbpointer\",\n\t\t\t\t\tDBPointer{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into a DBPointer\", TypeString),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadDBPointer Error\",\n\t\t\t\t\tDBPointer{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeDBPointer, Err: errors.New(\"rdbp error\"), ErrAfter: readDBPointer},\n\t\t\t\t\treadDBPointer,\n\t\t\t\t\terrors.New(\"rdbp error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success\",\n\t\t\t\t\tDBPointer{\n\t\t\t\t\t\tDB: \"foobar\",\n\t\t\t\t\t\tPointer: ObjectID{0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0A, 0x0B, 0x0C},\n\t\t\t\t\t},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{\n\t\t\t\t\t\tBSONType: TypeDBPointer,\n\t\t\t\t\t\tReturn: bsoncore.Value{\n\t\t\t\t\t\t\tType: bsoncore.TypeDBPointer,\n\t\t\t\t\t\t\tData: bsoncore.AppendDBPointer(\n\t\t\t\t\t\t\t\tnil, \"foobar\", ObjectID{0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0A, 0x0B, 0x0C},\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t\treadDBPointer,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\tDBPointer{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\tDBPointer{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"TimestampDecodeValue\",\n\t\t\tValueDecoderFunc(timestampDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeTimestamp},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"TimestampDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tTimestamp},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not timestamp\",\n\t\t\t\t\tTimestamp{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into a Timestamp\", TypeString),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadTimestamp Error\",\n\t\t\t\t\tTimestamp{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeTimestamp, Err: errors.New(\"rt error\"), ErrAfter: readTimestamp},\n\t\t\t\t\treadTimestamp,\n\t\t\t\t\terrors.New(\"rt error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success\",\n\t\t\t\t\tTimestamp{T: 12345, I: 67890},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{\n\t\t\t\t\t\tBSONType: TypeTimestamp,\n\t\t\t\t\t\tReturn: bsoncore.Value{\n\t\t\t\t\t\t\tType: bsoncore.TypeTimestamp,\n\t\t\t\t\t\t\tData: bsoncore.AppendTimestamp(nil, 12345, 67890),\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t\treadTimestamp,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\tTimestamp{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\tTimestamp{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"MinKeyDecodeValue\",\n\t\t\tValueDecoderFunc(minKeyDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeMinKey},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"MinKeyDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tMinKey},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not null\",\n\t\t\t\t\tMinKey{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into a MinKey\", TypeString),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadMinKey Error\",\n\t\t\t\t\tMinKey{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeMinKey, Err: errors.New(\"rn error\"), ErrAfter: readMinKey},\n\t\t\t\t\treadMinKey,\n\t\t\t\t\terrors.New(\"rn error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success\",\n\t\t\t\t\tMinKey{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeMinKey},\n\t\t\t\t\treadMinKey,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\tMinKey{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\tMinKey{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"MaxKeyDecodeValue\",\n\t\t\tValueDecoderFunc(maxKeyDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeMaxKey},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"MaxKeyDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tMaxKey},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not null\",\n\t\t\t\t\tMaxKey{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into a MaxKey\", TypeString),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadMaxKey Error\",\n\t\t\t\t\tMaxKey{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeMaxKey, Err: errors.New(\"rn error\"), ErrAfter: readMaxKey},\n\t\t\t\t\treadMaxKey,\n\t\t\t\t\terrors.New(\"rn error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success\",\n\t\t\t\t\tMaxKey{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeMaxKey},\n\t\t\t\t\treadMaxKey,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\tMaxKey{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\tMaxKey{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"JavaScriptDecodeValue\",\n\t\t\tValueDecoderFunc(javaScriptDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeJavaScript, Return: \"\"},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"JavaScriptDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tJavaScript},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not Javascript\",\n\t\t\t\t\tJavaScript(\"\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into a JavaScript\", TypeString),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadJavascript Error\",\n\t\t\t\t\tJavaScript(\"\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeJavaScript, Err: errors.New(\"rjs error\"), ErrAfter: readJavascript},\n\t\t\t\t\treadJavascript,\n\t\t\t\t\terrors.New(\"rjs error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"JavaScript/success\",\n\t\t\t\t\tJavaScript(\"var hello = 'world';\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeJavaScript, Return: \"var hello = 'world';\"},\n\t\t\t\t\treadJavascript,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\tJavaScript(\"\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\tJavaScript(\"\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"SymbolDecodeValue\",\n\t\t\tValueDecoderFunc(symbolDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeSymbol, Return: \"\"},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"SymbolDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tSymbol},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not Symbol\",\n\t\t\t\t\tSymbol(\"\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeInt32},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into a Symbol\", TypeInt32),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadSymbol Error\",\n\t\t\t\t\tSymbol(\"\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeSymbol, Err: errors.New(\"rjs error\"), ErrAfter: readSymbol},\n\t\t\t\t\treadSymbol,\n\t\t\t\t\terrors.New(\"rjs error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Symbol/success\",\n\t\t\t\t\tSymbol(\"var hello = 'world';\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeSymbol, Return: \"var hello = 'world';\"},\n\t\t\t\t\treadSymbol,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\tSymbol(\"\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\tSymbol(\"\"),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"CoreDocumentDecodeValue\",\n\t\t\tValueDecoderFunc(coreDocumentDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"CoreDocumentDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tCoreDocument},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"*bsoncore.Document is nil\",\n\t\t\t\t\t(*bsoncore.Document)(nil),\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"CoreDocumentDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tCoreDocument},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf((*bsoncore.Document)(nil))).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Copy error\",\n\t\t\t\t\tbsoncore.Document{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"copy error\"), ErrAfter: readDocument},\n\t\t\t\t\treadDocument,\n\t\t\t\t\terrors.New(\"copy error\"),\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"StructCodec.DecodeValue\",\n\t\t\tnewStructCodec(nil),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"Not struct\",\n\t\t\t\t\treflect.New(reflect.TypeOf(struct{ Foo string }{})).Elem().Interface(),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\terrors.New(\"cannot decode string into a struct { Foo string }\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\treflect.New(reflect.TypeOf(struct{ Foo string }{})).Elem().Interface(),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\treflect.New(reflect.TypeOf(struct{ Foo string }{})).Elem().Interface(),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"CodeWithScopeDecodeValue\",\n\t\t\tValueDecoderFunc(codeWithScopeDecodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeCodeWithScope},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"CodeWithScopeDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tCodeWithScope},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"type not codewithscope\",\n\t\t\t\t\tCodeWithScope{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeString},\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot decode %v into a CodeWithScope\", TypeString),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ReadCodeWithScope Error\",\n\t\t\t\t\tCodeWithScope{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeCodeWithScope, Err: errors.New(\"rcws error\"), ErrAfter: readCodeWithScope},\n\t\t\t\t\treadCodeWithScope,\n\t\t\t\t\terrors.New(\"rcws error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decodeDocument Error\",\n\t\t\t\t\tCodeWithScope{\n\t\t\t\t\t\tCode: \"var hello = 'world';\",\n\t\t\t\t\t\tScope: D{{\"foo\", nil}},\n\t\t\t\t\t},\n\t\t\t\t\t&DecodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeCodeWithScope, Err: errors.New(\"dd error\"), ErrAfter: readElement},\n\t\t\t\t\treadElement,\n\t\t\t\t\terrors.New(\"dd error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode null\",\n\t\t\t\t\tCodeWithScope{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeNull},\n\t\t\t\t\treadNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"decode undefined\",\n\t\t\t\t\tCodeWithScope{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{BSONType: TypeUndefined},\n\t\t\t\t\treadUndefined,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"CoreArrayDecodeValue\",\n\t\t\t&arrayCodec{},\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"CoreArrayDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tCoreArray},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf(wrong)).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"*bsoncore.Array is nil\",\n\t\t\t\t\t(*bsoncore.Array)(nil),\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueDecoderError{\n\t\t\t\t\t\tName: \"CoreArrayDecodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tCoreArray},\n\t\t\t\t\t\tReceived: reflect.New(reflect.TypeOf((*bsoncore.Array)(nil))).Elem(),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t}\n\n\tfor _, tc := range testCases {\n\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\tfor _, rc := range tc.subtests {\n\t\t\t\tt.Run(rc.name, func(t *testing.T) {\n\t\t\t\t\tvar dc DecodeContext\n\t\t\t\t\tif rc.dctx != nil {\n\t\t\t\t\t\tdc = *rc.dctx\n\t\t\t\t\t}\n\t\t\t\t\tllvrw := new(valueReaderWriter)\n\t\t\t\t\tif rc.llvrw != nil {\n\t\t\t\t\t\tllvrw = rc.llvrw\n\t\t\t\t\t}\n\t\t\t\t\tllvrw.T = t\n\t\t\t\t\t// var got any\n\t\t\t\t\tif rc.val == cansetreflectiontest { // We're doing a CanSet reflection test\n\t\t\t\t\t\terr := tc.vd.DecodeValue(dc, llvrw, reflect.Value{})\n\t\t\t\t\t\tif !assert.CompareErrors(err, rc.err) {\n\t\t\t\t\t\t\tt.Errorf(\"Errors do not match. got %v; want %v\", err, rc.err)\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tval := reflect.New(reflect.TypeOf(rc.val)).Elem()\n\t\t\t\t\t\terr = tc.vd.DecodeValue(dc, llvrw, val)\n\t\t\t\t\t\tif !assert.CompareErrors(err, rc.err) {\n\t\t\t\t\t\t\tt.Errorf(\"Errors do not match. got %v; want %v\", err, rc.err)\n\t\t\t\t\t\t}\n\t\t\t\t\t\treturn\n\t\t\t\t\t}\n\t\t\t\t\tif rc.val == cansettest { // We're doing an IsValid and CanSet test\n\t\t\t\t\t\tvar wanterr ValueDecoderError\n\t\t\t\t\t\tif !errors.As(rc.err, &wanterr) {\n\t\t\t\t\t\t\tt.Fatalf(\"Error must be a DecodeValueError, but got a %T\", rc.err)\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\terr := tc.vd.DecodeValue(dc, llvrw, reflect.Value{})\n\t\t\t\t\t\twanterr.Received = reflect.ValueOf(nil)\n\t\t\t\t\t\tif !assert.CompareErrors(err, wanterr) {\n\t\t\t\t\t\t\tt.Errorf(\"Errors do not match. got %v; want %v\", err, wanterr)\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\terr = tc.vd.DecodeValue(dc, llvrw, reflect.ValueOf(int(12345)))\n\t\t\t\t\t\twanterr.Received = reflect.ValueOf(int(12345))\n\t\t\t\t\t\tif !assert.CompareErrors(err, wanterr) {\n\t\t\t\t\t\t\tt.Errorf(\"Errors do not match. got %v; want %v\", err, wanterr)\n\t\t\t\t\t\t}\n\t\t\t\t\t\treturn\n\t\t\t\t\t}\n\t\t\t\t\tvar val reflect.Value\n\t\t\t\t\tif rtype := reflect.TypeOf(rc.val); rtype != nil {\n\t\t\t\t\t\tval = reflect.New(rtype).Elem()\n\t\t\t\t\t}\n\t\t\t\t\twant := rc.val\n\t\t\t\t\tdefer func() {\n\t\t\t\t\t\tif err := recover(); err != nil {\n\t\t\t\t\t\t\tfmt.Println(t.Name())\n\t\t\t\t\t\t\tpanic(err)\n\t\t\t\t\t\t}\n\t\t\t\t\t}()\n\t\t\t\t\terr := tc.vd.DecodeValue(dc, llvrw, val)\n\t\t\t\t\tif !assert.CompareErrors(err, rc.err) {\n\t\t\t\t\t\tt.Errorf(\"Errors do not match. got %v; want %v\", err, rc.err)\n\t\t\t\t\t}\n\t\t\t\t\tinvoked := llvrw.invoked\n\t\t\t\t\tif !cmp.Equal(invoked, rc.invoke) {\n\t\t\t\t\t\tt.Errorf(\"Incorrect method invoked. got %v; want %v\", invoked, rc.invoke)\n\t\t\t\t\t}\n\t\t\t\t\tvar got any\n\t\t\t\t\tif val.IsValid() && val.CanInterface() {\n\t\t\t\t\t\tgot = val.Interface()\n\t\t\t\t\t}\n\t\t\t\t\tif rc.err == nil && !cmp.Equal(got, want, cmp.Comparer(compareDecimal128)) {\n\t\t\t\t\t\tt.Errorf(\"Values do not match. got (%T)%v; want (%T)%v\", got, got, want, want)\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t}\n\t\t})\n\t}\n\n\tt.Run(\"CodeWithScopeCodec/DecodeValue/success\", func(t *testing.T) {\n\t\tdc := DecodeContext{Registry: buildDefaultRegistry()}\n\t\tb := bsoncore.BuildDocument(nil,\n\t\t\tbsoncore.AppendCodeWithScopeElement(\n\t\t\t\tnil, \"foo\", \"var hello = 'world';\",\n\t\t\t\tbuildDocument(bsoncore.AppendNullElement(nil, \"bar\")),\n\t\t\t),\n\t\t)\n\t\tdvr := NewDocumentReader(bytes.NewReader(b))\n\t\tdr, err := dvr.ReadDocument()\n\t\tnoerr(t, err)\n\t\t_, vr, err := dr.ReadElement()\n\t\tnoerr(t, err)\n\n\t\twant := CodeWithScope{\n\t\t\tCode: \"var hello = 'world';\",\n\t\t\tScope: D{{\"bar\", nil}},\n\t\t}\n\t\tval := reflect.New(tCodeWithScope).Elem()\n\t\terr = codeWithScopeDecodeValue(dc, vr, val)\n\t\tnoerr(t, err)\n\n\t\tgot := val.Interface().(CodeWithScope)\n\t\tif got.Code != want.Code && !cmp.Equal(got.Scope, want.Scope) {\n\t\t\tt.Errorf(\"CodeWithScopes do not match. got %v; want %v\", got, want)\n\t\t}\n\t})\n\tt.Run(\"ValueUnmarshalerDecodeValue/UnmarshalBSONValue error\", func(t *testing.T) {\n\t\tvar dc DecodeContext\n\t\tllvrw := &valueReaderWriter{BSONType: TypeString, Return: string(\"hello, world!\")}\n\t\tllvrw.T = t\n\n\t\twant := errors.New(\"ubsonv error\")\n\t\tvalUnmarshaler := &testValueUnmarshaler{err: want}\n\t\tgot := valueUnmarshalerDecodeValue(dc, llvrw, reflect.ValueOf(valUnmarshaler))\n\t\tif !assert.CompareErrors(got, want) {\n\t\t\tt.Errorf(\"Errors do not match. got %v; want %v\", got, want)\n\t\t}\n\t})\n\tt.Run(\"ValueUnmarshalerDecodeValue/Unaddressable value\", func(t *testing.T) {\n\t\tvar dc DecodeContext\n\t\tllvrw := &valueReaderWriter{BSONType: TypeString, Return: string(\"hello, world!\")}\n\t\tllvrw.T = t\n\n\t\tval := reflect.ValueOf(testValueUnmarshaler{})\n\t\twant := ValueDecoderError{Name: \"ValueUnmarshalerDecodeValue\", Types: []reflect.Type{tValueUnmarshaler}, Received: val}\n\t\tgot := valueUnmarshalerDecodeValue(dc, llvrw, val)\n\t\tif !assert.CompareErrors(got, want) {\n\t\t\tt.Errorf(\"Errors do not match. got %v; want %v\", got, want)\n\t\t}\n\t})\n\n\tt.Run(\"SliceCodec/DecodeValue/too many elements\", func(t *testing.T) {\n\t\tidx, doc := bsoncore.AppendDocumentStart(nil)\n\t\taidx, doc := bsoncore.AppendArrayElementStart(doc, \"foo\")\n\t\tdoc = bsoncore.AppendStringElement(doc, \"0\", \"foo\")\n\t\tdoc = bsoncore.AppendStringElement(doc, \"1\", \"bar\")\n\t\tdoc, err := bsoncore.AppendArrayEnd(doc, aidx)\n\t\tnoerr(t, err)\n\t\tdoc, err = bsoncore.AppendDocumentEnd(doc, idx)\n\t\tnoerr(t, err)\n\t\tdvr := NewDocumentReader(bytes.NewReader(doc))\n\t\tnoerr(t, err)\n\t\tdr, err := dvr.ReadDocument()\n\t\tnoerr(t, err)\n\t\t_, vr, err := dr.ReadElement()\n\t\tnoerr(t, err)\n\t\tvar val [1]string\n\t\twant := fmt.Errorf(\"more elements returned in array than can fit inside %T, got 2 elements\", val)\n\n\t\tdc := DecodeContext{Registry: buildDefaultRegistry()}\n\t\tgot := arrayDecodeValue(dc, vr, reflect.ValueOf(val))\n\t\tif !assert.CompareErrors(got, want) {\n\t\t\tt.Errorf(\"Errors do not match. got %v; want %v\", got, want)\n\t\t}\n\t})\n\n\tt.Run(\"success path\", func(t *testing.T) {\n\t\toid := NewObjectID()\n\t\toids := []ObjectID{NewObjectID(), NewObjectID(), NewObjectID()}\n\t\tstr := new(string)\n\t\t*str = \"bar\"\n\t\tnow := time.Now().Truncate(time.Millisecond).UTC()\n\t\tmurl, err := url.Parse(\"https://mongodb.com/random-url?hello=world\")\n\t\tif err != nil {\n\t\t\tt.Errorf(\"Error parsing URL: %v\", err)\n\t\t\tt.FailNow()\n\t\t}\n\t\tdecimal128, err := ParseDecimal128(\"1.5e10\")\n\t\tif err != nil {\n\t\t\tt.Errorf(\"Error parsing decimal128: %v\", err)\n\t\t\tt.FailNow()\n\t\t}\n\n\t\ttestCases := []struct {\n\t\t\tname string\n\t\t\tvalue any\n\t\t\tb []byte\n\t\t\terr error\n\t\t}{\n\t\t\t{\n\t\t\t\t\"map[string]int\",\n\t\t\t\tmap[string]int32{\"foo\": 1},\n\t\t\t\t[]byte{\n\t\t\t\t\t0x0E, 0x00, 0x00, 0x00,\n\t\t\t\t\t0x10, 'f', 'o', 'o', 0x00,\n\t\t\t\t\t0x01, 0x00, 0x00, 0x00,\n\t\t\t\t\t0x00,\n\t\t\t\t},\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"map[string]ObjectID\",\n\t\t\t\tmap[string]ObjectID{\"foo\": oid},\n\t\t\t\tfunc() []byte {\n\t\t\t\t\tidx, doc := bsoncore.AppendDocumentStart(nil)\n\t\t\t\t\tdoc = bsoncore.AppendObjectIDElement(doc, \"foo\", oid)\n\t\t\t\t\tdoc, _ = bsoncore.AppendDocumentEnd(doc, idx)\n\t\t\t\t\treturn doc\n\t\t\t\t}(),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"map[string][]int32\",\n\t\t\t\tmap[string][]int32{\"Z\": {1, 2, 3}},\n\t\t\t\tbuildDocumentArray(func(doc []byte) []byte {\n\t\t\t\t\tdoc = bsoncore.AppendInt32Element(doc, \"0\", 1)\n\t\t\t\t\tdoc = bsoncore.AppendInt32Element(doc, \"1\", 2)\n\t\t\t\t\treturn bsoncore.AppendInt32Element(doc, \"2\", 3)\n\t\t\t\t}),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"map[string][]ObjectID\",\n\t\t\t\tmap[string][]ObjectID{\"Z\": oids},\n\t\t\t\tbuildDocumentArray(func(doc []byte) []byte {\n\t\t\t\t\tdoc = bsoncore.AppendObjectIDElement(doc, \"0\", oids[0])\n\t\t\t\t\tdoc = bsoncore.AppendObjectIDElement(doc, \"1\", oids[1])\n\t\t\t\t\treturn bsoncore.AppendObjectIDElement(doc, \"2\", oids[2])\n\t\t\t\t}),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"map[string][]json.Number(int64)\",\n\t\t\t\tmap[string][]json.Number{\"Z\": {json.Number(\"5\"), json.Number(\"10\")}},\n\t\t\t\tbuildDocumentArray(func(doc []byte) []byte {\n\t\t\t\t\tdoc = bsoncore.AppendInt64Element(doc, \"0\", 5)\n\t\t\t\t\treturn bsoncore.AppendInt64Element(doc, \"1\", 10)\n\t\t\t\t}),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"map[string][]json.Number(float64)\",\n\t\t\t\tmap[string][]json.Number{\"Z\": {json.Number(\"5\"), json.Number(\"10.1\")}},\n\t\t\t\tbuildDocumentArray(func(doc []byte) []byte {\n\t\t\t\t\tdoc = bsoncore.AppendInt64Element(doc, \"0\", 5)\n\t\t\t\t\treturn bsoncore.AppendDoubleElement(doc, \"1\", 10.1)\n\t\t\t\t}),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"map[string][]*url.URL\",\n\t\t\t\tmap[string][]*url.URL{\"Z\": {murl}},\n\t\t\t\tbuildDocumentArray(func(doc []byte) []byte {\n\t\t\t\t\treturn bsoncore.AppendStringElement(doc, \"0\", murl.String())\n\t\t\t\t}),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"map[string][]Decimal128\",\n\t\t\t\tmap[string][]Decimal128{\"Z\": {decimal128}},\n\t\t\t\tbuildDocumentArray(func(doc []byte) []byte {\n\t\t\t\t\treturn bsoncore.AppendDecimal128Element(doc, \"0\", decimal128.h, decimal128.l)\n\t\t\t\t}),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"map[mystring]any\",\n\t\t\t\tmap[mystring]any{\"pi\": 3.14159},\n\t\t\t\tbuildDocument(bsoncore.AppendDoubleElement(nil, \"pi\", 3.14159)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"-\",\n\t\t\t\tstruct {\n\t\t\t\t\tA string `bson:\"-\"`\n\t\t\t\t}{\n\t\t\t\t\tA: \"\",\n\t\t\t\t},\n\t\t\t\t[]byte{0x05, 0x00, 0x00, 0x00, 0x00},\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"omitempty\",\n\t\t\t\tstruct {\n\t\t\t\t\tA string `bson:\",omitempty\"`\n\t\t\t\t}{\n\t\t\t\t\tA: \"\",\n\t\t\t\t},\n\t\t\t\t[]byte{0x05, 0x00, 0x00, 0x00, 0x00},\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"omitempty, empty time\",\n\t\t\t\tstruct {\n\t\t\t\t\tA time.Time `bson:\",omitempty\"`\n\t\t\t\t}{\n\t\t\t\t\tA: time.Time{},\n\t\t\t\t},\n\t\t\t\t[]byte{0x05, 0x00, 0x00, 0x00, 0x00},\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"no private fields\",\n\t\t\t\tnoPrivateFields{a: \"should be empty\"},\n\t\t\t\t[]byte{0x05, 0x00, 0x00, 0x00, 0x00},\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"minsize\",\n\t\t\t\tstruct {\n\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t}{\n\t\t\t\t\tA: 12345,\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendInt32Element(nil, \"a\", 12345)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"inline\",\n\t\t\t\tstruct {\n\t\t\t\t\tFoo struct {\n\t\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t}{\n\t\t\t\t\tFoo: struct {\n\t\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t\t}{\n\t\t\t\t\t\tA: 12345,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendInt32Element(nil, \"a\", 12345)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"inline struct pointer\",\n\t\t\t\tstruct {\n\t\t\t\t\tFoo *struct {\n\t\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t\tBar *struct {\n\t\t\t\t\t\tB int64\n\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t}{\n\t\t\t\t\tFoo: &struct {\n\t\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t\t}{\n\t\t\t\t\t\tA: 12345,\n\t\t\t\t\t},\n\t\t\t\t\tBar: nil,\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendInt32Element(nil, \"a\", 12345)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"nested inline struct pointer\",\n\t\t\t\tstruct {\n\t\t\t\t\tFoo *struct {\n\t\t\t\t\t\tBar *struct {\n\t\t\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t}{\n\t\t\t\t\tFoo: &struct {\n\t\t\t\t\t\tBar *struct {\n\t\t\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t\t}{\n\t\t\t\t\t\tBar: &struct {\n\t\t\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t\t\t}{\n\t\t\t\t\t\t\tA: 12345,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendInt32Element(nil, \"a\", 12345)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"inline nil struct pointer\",\n\t\t\t\tstruct {\n\t\t\t\t\tFoo *struct {\n\t\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t}{\n\t\t\t\t\tFoo: nil,\n\t\t\t\t},\n\t\t\t\tbuildDocument([]byte{}),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"inline overwrite\",\n\t\t\t\tstruct {\n\t\t\t\t\tFoo struct {\n\t\t\t\t\t\tA int32\n\t\t\t\t\t\tB string\n\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t\tA int64\n\t\t\t\t}{\n\t\t\t\t\tFoo: struct {\n\t\t\t\t\t\tA int32\n\t\t\t\t\t\tB string\n\t\t\t\t\t}{\n\t\t\t\t\t\tA: 0,\n\t\t\t\t\t\tB: \"foo\",\n\t\t\t\t\t},\n\t\t\t\t\tA: 54321,\n\t\t\t\t},\n\t\t\t\tbuildDocument(func(doc []byte) []byte {\n\t\t\t\t\tdoc = bsoncore.AppendStringElement(doc, \"b\", \"foo\")\n\t\t\t\t\tdoc = bsoncore.AppendInt64Element(doc, \"a\", 54321)\n\t\t\t\t\treturn doc\n\t\t\t\t}(nil)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"inline overwrite with nested structs\",\n\t\t\t\tstruct {\n\t\t\t\t\tFoo struct {\n\t\t\t\t\t\tA int32\n\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t\tBar struct {\n\t\t\t\t\t\tA int32\n\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t\tA int64\n\t\t\t\t}{\n\t\t\t\t\tFoo: struct {\n\t\t\t\t\t\tA int32\n\t\t\t\t\t}{},\n\t\t\t\t\tBar: struct {\n\t\t\t\t\t\tA int32\n\t\t\t\t\t}{},\n\t\t\t\t\tA: 54321,\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendInt64Element(nil, \"a\", 54321)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"inline map\",\n\t\t\t\tstruct {\n\t\t\t\t\tFoo map[string]string `bson:\",inline\"`\n\t\t\t\t}{\n\t\t\t\t\tFoo: map[string]string{\"foo\": \"bar\"},\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendStringElement(nil, \"foo\", \"bar\")),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"alternate name bson:name\",\n\t\t\t\tstruct {\n\t\t\t\t\tA string `bson:\"foo\"`\n\t\t\t\t}{\n\t\t\t\t\tA: \"bar\",\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendStringElement(nil, \"foo\", \"bar\")),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"alternate name\",\n\t\t\t\tstruct {\n\t\t\t\t\tA string `bson:\"foo\"`\n\t\t\t\t}{\n\t\t\t\t\tA: \"bar\",\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendStringElement(nil, \"foo\", \"bar\")),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"inline, omitempty\",\n\t\t\t\tstruct {\n\t\t\t\t\tA string\n\t\t\t\t\tFoo zeroTest `bson:\"omitempty,inline\"`\n\t\t\t\t}{\n\t\t\t\t\tA: \"bar\",\n\t\t\t\t\tFoo: zeroTest{true},\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendStringElement(nil, \"a\", \"bar\")),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"struct{}\",\n\t\t\t\tstruct {\n\t\t\t\t\tA bool\n\t\t\t\t\tB int32\n\t\t\t\t\tC int64\n\t\t\t\t\tD uint16\n\t\t\t\t\tE uint64\n\t\t\t\t\tF float64\n\t\t\t\t\tG string\n\t\t\t\t\tH map[string]string\n\t\t\t\t\tI []byte\n\t\t\t\t\tK [2]string\n\t\t\t\t\tL struct {\n\t\t\t\t\t\tM string\n\t\t\t\t\t}\n\t\t\t\t\tQ ObjectID\n\t\t\t\t\tT []struct{}\n\t\t\t\t\tY json.Number\n\t\t\t\t\tZ time.Time\n\t\t\t\t\tAA json.Number\n\t\t\t\t\tAB *url.URL\n\t\t\t\t\tAC Decimal128\n\t\t\t\t\tAD *time.Time\n\t\t\t\t\tAE *testValueUnmarshaler\n\t\t\t\t\tAF *bool\n\t\t\t\t\tAG *bool\n\t\t\t\t\tAH *int32\n\t\t\t\t\tAI *int64\n\t\t\t\t\tAJ *ObjectID\n\t\t\t\t\tAK *ObjectID\n\t\t\t\t\tAL testValueUnmarshaler\n\t\t\t\t\tAM any\n\t\t\t\t\tAN any\n\t\t\t\t\tAO any\n\t\t\t\t\tAP D\n\t\t\t\t\tAQ A\n\t\t\t\t\tAR [2]E\n\t\t\t\t\tAS []byte\n\t\t\t\t\tAT map[string]any\n\t\t\t\t\tAU CodeWithScope\n\t\t\t\t\tAV M\n\t\t\t\t\tAW D\n\t\t\t\t\tAX map[string]any\n\t\t\t\t\tAY []E\n\t\t\t\t\tAZ any\n\t\t\t\t}{\n\t\t\t\t\tA: true,\n\t\t\t\t\tB: 123,\n\t\t\t\t\tC: 456,\n\t\t\t\t\tD: 789,\n\t\t\t\t\tE: 101112,\n\t\t\t\t\tF: 3.14159,\n\t\t\t\t\tG: \"Hello, world\",\n\t\t\t\t\tH: map[string]string{\"foo\": \"bar\"},\n\t\t\t\t\tI: []byte{0x01, 0x02, 0x03},\n\t\t\t\t\tK: [2]string{\"baz\", \"qux\"},\n\t\t\t\t\tL: struct {\n\t\t\t\t\t\tM string\n\t\t\t\t\t}{\n\t\t\t\t\t\tM: \"foobar\",\n\t\t\t\t\t},\n\t\t\t\t\tQ: oid,\n\t\t\t\t\tT: nil,\n\t\t\t\t\tY: json.Number(\"5\"),\n\t\t\t\t\tZ: now,\n\t\t\t\t\tAA: json.Number(\"10.1\"),\n\t\t\t\t\tAB: murl,\n\t\t\t\t\tAC: decimal128,\n\t\t\t\t\tAD: &now,\n\t\t\t\t\tAE: &testValueUnmarshaler{t: TypeString, val: bsoncore.AppendString(nil, \"hello, world!\")},\n\t\t\t\t\tAF: func(b bool) *bool { return &b }(true),\n\t\t\t\t\tAG: nil,\n\t\t\t\t\tAH: func(i32 int32) *int32 { return &i32 }(12345),\n\t\t\t\t\tAI: func(i64 int64) *int64 { return &i64 }(1234567890),\n\t\t\t\t\tAJ: &oid,\n\t\t\t\t\tAK: nil,\n\t\t\t\t\tAL: testValueUnmarshaler{t: TypeString, val: bsoncore.AppendString(nil, \"hello, world!\")},\n\t\t\t\t\tAM: \"hello, world\",\n\t\t\t\t\tAN: int32(12345),\n\t\t\t\t\tAO: oid,\n\t\t\t\t\tAP: D{{\"foo\", \"bar\"}},\n\t\t\t\t\tAQ: A{\"foo\", \"bar\"},\n\t\t\t\t\tAR: [2]E{{\"hello\", \"world\"}, {\"pi\", 3.14159}},\n\t\t\t\t\tAS: nil,\n\t\t\t\t\tAT: nil,\n\t\t\t\t\tAU: CodeWithScope{Code: \"var hello = 'world';\", Scope: D{{\"pi\", 3.14159}}},\n\t\t\t\t\tAV: M{\"foo\": D{{\"bar\", \"baz\"}}},\n\t\t\t\t\tAW: D{{\"foo\", D{{\"bar\", \"baz\"}}}},\n\t\t\t\t\tAX: map[string]any{\"foo\": D{{\"bar\", \"baz\"}}},\n\t\t\t\t\tAY: []E{{\"foo\", D{{\"bar\", \"baz\"}}}},\n\t\t\t\t\tAZ: D{{\"foo\", D{{\"bar\", \"baz\"}}}},\n\t\t\t\t},\n\t\t\t\tbuildDocument(func(doc []byte) []byte {\n\t\t\t\t\tdoc = bsoncore.AppendBooleanElement(doc, \"a\", true)\n\t\t\t\t\tdoc = bsoncore.AppendInt32Element(doc, \"b\", 123)\n\t\t\t\t\tdoc = bsoncore.AppendInt64Element(doc, \"c\", 456)\n\t\t\t\t\tdoc = bsoncore.AppendInt32Element(doc, \"d\", 789)\n\t\t\t\t\tdoc = bsoncore.AppendInt64Element(doc, \"e\", 101112)\n\t\t\t\t\tdoc = bsoncore.AppendDoubleElement(doc, \"f\", 3.14159)\n\t\t\t\t\tdoc = bsoncore.AppendStringElement(doc, \"g\", \"Hello, world\")\n\t\t\t\t\tdoc = bsoncore.AppendDocumentElement(doc, \"h\", buildDocument(bsoncore.AppendStringElement(nil, \"foo\", \"bar\")))\n\t\t\t\t\tdoc = bsoncore.AppendBinaryElement(doc, \"i\", 0x00, []byte{0x01, 0x02, 0x03})\n\t\t\t\t\tdoc = bsoncore.AppendArrayElement(doc, \"k\",\n\t\t\t\t\t\tbuildArray(bsoncore.AppendStringElement(bsoncore.AppendStringElement(nil, \"0\", \"baz\"), \"1\", \"qux\")),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = bsoncore.AppendDocumentElement(doc, \"l\", buildDocument(bsoncore.AppendStringElement(nil, \"m\", \"foobar\")))\n\t\t\t\t\tdoc = bsoncore.AppendObjectIDElement(doc, \"q\", oid)\n\t\t\t\t\tdoc = bsoncore.AppendNullElement(doc, \"t\")\n\t\t\t\t\tdoc = bsoncore.AppendInt64Element(doc, \"y\", 5)\n\t\t\t\t\tdoc = bsoncore.AppendDateTimeElement(doc, \"z\", now.UnixNano()/int64(time.Millisecond))\n\t\t\t\t\tdoc = bsoncore.AppendDoubleElement(doc, \"aa\", 10.1)\n\t\t\t\t\tdoc = bsoncore.AppendStringElement(doc, \"ab\", murl.String())\n\t\t\t\t\tdoc = bsoncore.AppendDecimal128Element(doc, \"ac\", decimal128.h, decimal128.l)\n\t\t\t\t\tdoc = bsoncore.AppendDateTimeElement(doc, \"ad\", now.UnixNano()/int64(time.Millisecond))\n\t\t\t\t\tdoc = bsoncore.AppendStringElement(doc, \"ae\", \"hello, world!\")\n\t\t\t\t\tdoc = bsoncore.AppendBooleanElement(doc, \"af\", true)\n\t\t\t\t\tdoc = bsoncore.AppendNullElement(doc, \"ag\")\n\t\t\t\t\tdoc = bsoncore.AppendInt32Element(doc, \"ah\", 12345)\n\t\t\t\t\tdoc = bsoncore.AppendInt32Element(doc, \"ai\", 1234567890)\n\t\t\t\t\tdoc = bsoncore.AppendObjectIDElement(doc, \"aj\", oid)\n\t\t\t\t\tdoc = bsoncore.AppendNullElement(doc, \"ak\")\n\t\t\t\t\tdoc = bsoncore.AppendStringElement(doc, \"al\", \"hello, world!\")\n\t\t\t\t\tdoc = bsoncore.AppendStringElement(doc, \"am\", \"hello, world\")\n\t\t\t\t\tdoc = bsoncore.AppendInt32Element(doc, \"an\", 12345)\n\t\t\t\t\tdoc = bsoncore.AppendObjectIDElement(doc, \"ao\", oid)\n\t\t\t\t\tdoc = bsoncore.AppendDocumentElement(doc, \"ap\", buildDocument(bsoncore.AppendStringElement(nil, \"foo\", \"bar\")))\n\t\t\t\t\tdoc = bsoncore.AppendArrayElement(doc, \"aq\",\n\t\t\t\t\t\tbuildArray(bsoncore.AppendStringElement(bsoncore.AppendStringElement(nil, \"0\", \"foo\"), \"1\", \"bar\")),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = bsoncore.AppendDocumentElement(doc, \"ar\",\n\t\t\t\t\t\tbuildDocument(bsoncore.AppendDoubleElement(bsoncore.AppendStringElement(nil, \"hello\", \"world\"), \"pi\", 3.14159)),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = bsoncore.AppendNullElement(doc, \"as\")\n\t\t\t\t\tdoc = bsoncore.AppendNullElement(doc, \"at\")\n\t\t\t\t\tdoc = bsoncore.AppendCodeWithScopeElement(doc, \"au\",\n\t\t\t\t\t\t\"var hello = 'world';\", buildDocument(bsoncore.AppendDoubleElement(nil, \"pi\", 3.14159)),\n\t\t\t\t\t)\n\t\t\t\t\tfor _, name := range [5]string{\"av\", \"aw\", \"ax\", \"ay\", \"az\"} {\n\t\t\t\t\t\tdoc = bsoncore.AppendDocumentElement(doc, name, buildDocument(\n\t\t\t\t\t\t\tbsoncore.AppendDocumentElement(nil, \"foo\", buildDocument(\n\t\t\t\t\t\t\t\tbsoncore.AppendStringElement(nil, \"bar\", \"baz\"),\n\t\t\t\t\t\t\t)),\n\t\t\t\t\t\t))\n\t\t\t\t\t}\n\t\t\t\t\treturn doc\n\t\t\t\t}(nil)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"struct{[]any}\",\n\t\t\t\tstruct {\n\t\t\t\t\tA []bool\n\t\t\t\t\tB []int32\n\t\t\t\t\tC []int64\n\t\t\t\t\tD []uint16\n\t\t\t\t\tE []uint64\n\t\t\t\t\tF []float64\n\t\t\t\t\tG []string\n\t\t\t\t\tH []map[string]string\n\t\t\t\t\tI [][]byte\n\t\t\t\t\tK [1][2]string\n\t\t\t\t\tL []struct {\n\t\t\t\t\t\tM string\n\t\t\t\t\t}\n\t\t\t\t\tN [][]string\n\t\t\t\t\tR []ObjectID\n\t\t\t\t\tT []struct{}\n\t\t\t\t\tW []map[string]struct{}\n\t\t\t\t\tX []map[string]struct{}\n\t\t\t\t\tY []map[string]struct{}\n\t\t\t\t\tZ []time.Time\n\t\t\t\t\tAA []json.Number\n\t\t\t\t\tAB []*url.URL\n\t\t\t\t\tAC []Decimal128\n\t\t\t\t\tAD []*time.Time\n\t\t\t\t\tAE []*testValueUnmarshaler\n\t\t\t\t\tAF []*bool\n\t\t\t\t\tAG []*int32\n\t\t\t\t\tAH []*int64\n\t\t\t\t\tAI []*ObjectID\n\t\t\t\t\tAJ []D\n\t\t\t\t\tAK []A\n\t\t\t\t\tAL [][2]E\n\t\t\t\t}{\n\t\t\t\t\tA: []bool{true},\n\t\t\t\t\tB: []int32{123},\n\t\t\t\t\tC: []int64{456},\n\t\t\t\t\tD: []uint16{789},\n\t\t\t\t\tE: []uint64{101112},\n\t\t\t\t\tF: []float64{3.14159},\n\t\t\t\t\tG: []string{\"Hello, world\"},\n\t\t\t\t\tH: []map[string]string{{\"foo\": \"bar\"}},\n\t\t\t\t\tI: [][]byte{{0x01, 0x02, 0x03}},\n\t\t\t\t\tK: [1][2]string{{\"baz\", \"qux\"}},\n\t\t\t\t\tL: []struct {\n\t\t\t\t\t\tM string\n\t\t\t\t\t}{\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tM: \"foobar\",\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t\tN: [][]string{{\"foo\", \"bar\"}},\n\t\t\t\t\tR: oids,\n\t\t\t\t\tT: nil,\n\t\t\t\t\tW: nil,\n\t\t\t\t\tX: []map[string]struct{}{}, // Should be empty BSON Array\n\t\t\t\t\tY: []map[string]struct{}{{}}, // Should be BSON array with one element, an empty BSON SubDocument\n\t\t\t\t\tZ: []time.Time{now, now},\n\t\t\t\t\tAA: []json.Number{json.Number(\"5\"), json.Number(\"10.1\")},\n\t\t\t\t\tAB: []*url.URL{murl},\n\t\t\t\t\tAC: []Decimal128{decimal128},\n\t\t\t\t\tAD: []*time.Time{&now, &now},\n\t\t\t\t\tAE: []*testValueUnmarshaler{\n\t\t\t\t\t\t{t: TypeString, val: bsoncore.AppendString(nil, \"hello\")},\n\t\t\t\t\t\t{t: TypeString, val: bsoncore.AppendString(nil, \"world\")},\n\t\t\t\t\t},\n\t\t\t\t\tAF: []*bool{pbool(true), nil},\n\t\t\t\t\tAG: []*int32{pi32(12345), nil},\n\t\t\t\t\tAH: []*int64{pi64(1234567890), nil, pi64(9012345678)},\n\t\t\t\t\tAI: []*ObjectID{&oid, nil},\n\t\t\t\t\tAJ: []D{{{\"foo\", \"bar\"}}, nil},\n\t\t\t\t\tAK: []A{{\"foo\", \"bar\"}, nil},\n\t\t\t\t\tAL: [][2]E{{{\"hello\", \"world\"}, {\"pi\", 3.14159}}},\n\t\t\t\t},\n\t\t\t\tbuildDocument(func(doc []byte) []byte {\n\t\t\t\t\tdoc = appendArrayElement(doc, \"a\", bsoncore.AppendBooleanElement(nil, \"0\", true))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"b\", bsoncore.AppendInt32Element(nil, \"0\", 123))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"c\", bsoncore.AppendInt64Element(nil, \"0\", 456))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"d\", bsoncore.AppendInt32Element(nil, \"0\", 789))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"e\", bsoncore.AppendInt64Element(nil, \"0\", 101112))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"f\", bsoncore.AppendDoubleElement(nil, \"0\", 3.14159))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"g\", bsoncore.AppendStringElement(nil, \"0\", \"Hello, world\"))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"h\", bsoncore.BuildDocumentElement(nil, \"0\", bsoncore.AppendStringElement(nil, \"foo\", \"bar\")))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"i\", bsoncore.AppendBinaryElement(nil, \"0\", 0x00, []byte{0x01, 0x02, 0x03}))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"k\",\n\t\t\t\t\t\tappendArrayElement(nil, \"0\",\n\t\t\t\t\t\t\tbsoncore.AppendStringElement(bsoncore.AppendStringElement(nil, \"0\", \"baz\"), \"1\", \"qux\")),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = appendArrayElement(doc, \"l\", bsoncore.BuildDocumentElement(nil, \"0\", bsoncore.AppendStringElement(nil, \"m\", \"foobar\")))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"n\",\n\t\t\t\t\t\tappendArrayElement(nil, \"0\",\n\t\t\t\t\t\t\tbsoncore.AppendStringElement(bsoncore.AppendStringElement(nil, \"0\", \"foo\"), \"1\", \"bar\")),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = appendArrayElement(doc, \"r\",\n\t\t\t\t\t\tbsoncore.AppendObjectIDElement(\n\t\t\t\t\t\t\tbsoncore.AppendObjectIDElement(\n\t\t\t\t\t\t\t\tbsoncore.AppendObjectIDElement(nil,\n\t\t\t\t\t\t\t\t\t\"0\", oids[0]),\n\t\t\t\t\t\t\t\t\"1\", oids[1]),\n\t\t\t\t\t\t\t\"2\", oids[2]),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = bsoncore.AppendNullElement(doc, \"t\")\n\t\t\t\t\tdoc = bsoncore.AppendNullElement(doc, \"w\")\n\t\t\t\t\tdoc = appendArrayElement(doc, \"x\", nil)\n\t\t\t\t\tdoc = appendArrayElement(doc, \"y\", bsoncore.BuildDocumentElement(nil, \"0\", nil))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"z\",\n\t\t\t\t\t\tbsoncore.AppendDateTimeElement(\n\t\t\t\t\t\t\tbsoncore.AppendDateTimeElement(\n\t\t\t\t\t\t\t\tnil, \"0\", now.UnixNano()/int64(time.Millisecond)),\n\t\t\t\t\t\t\t\"1\", now.UnixNano()/int64(time.Millisecond)),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = appendArrayElement(doc, \"aa\", bsoncore.AppendDoubleElement(bsoncore.AppendInt64Element(nil, \"0\", 5), \"1\", 10.10))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"ab\", bsoncore.AppendStringElement(nil, \"0\", murl.String()))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"ac\", bsoncore.AppendDecimal128Element(nil, \"0\", decimal128.h, decimal128.l))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"ad\",\n\t\t\t\t\t\tbsoncore.AppendDateTimeElement(\n\t\t\t\t\t\t\tbsoncore.AppendDateTimeElement(nil, \"0\", now.UnixNano()/int64(time.Millisecond)),\n\t\t\t\t\t\t\t\"1\", now.UnixNano()/int64(time.Millisecond)),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = appendArrayElement(doc, \"ae\",\n\t\t\t\t\t\tbsoncore.AppendStringElement(bsoncore.AppendStringElement(nil, \"0\", \"hello\"), \"1\", \"world\"),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = appendArrayElement(doc, \"af\",\n\t\t\t\t\t\tbsoncore.AppendNullElement(bsoncore.AppendBooleanElement(nil, \"0\", true), \"1\"),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = appendArrayElement(doc, \"ag\",\n\t\t\t\t\t\tbsoncore.AppendNullElement(bsoncore.AppendInt32Element(nil, \"0\", 12345), \"1\"),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = appendArrayElement(doc, \"ah\",\n\t\t\t\t\t\tbsoncore.AppendInt64Element(\n\t\t\t\t\t\t\tbsoncore.AppendNullElement(bsoncore.AppendInt64Element(nil, \"0\", 1234567890), \"1\"),\n\t\t\t\t\t\t\t\"2\", 9012345678,\n\t\t\t\t\t\t),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = appendArrayElement(doc, \"ai\",\n\t\t\t\t\t\tbsoncore.AppendNullElement(bsoncore.AppendObjectIDElement(nil, \"0\", oid), \"1\"),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = appendArrayElement(doc, \"aj\",\n\t\t\t\t\t\tbsoncore.AppendNullElement(\n\t\t\t\t\t\t\tbsoncore.AppendDocumentElement(nil, \"0\", buildDocument(bsoncore.AppendStringElement(nil, \"foo\", \"bar\"))),\n\t\t\t\t\t\t\t\"1\",\n\t\t\t\t\t\t),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = appendArrayElement(doc, \"ak\",\n\t\t\t\t\t\tbsoncore.AppendNullElement(\n\t\t\t\t\t\t\tappendArrayElement(nil, \"0\",\n\t\t\t\t\t\t\t\tbsoncore.AppendStringElement(bsoncore.AppendStringElement(nil, \"0\", \"foo\"), \"1\", \"bar\"),\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\"1\",\n\t\t\t\t\t\t),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = appendArrayElement(doc, \"al\",\n\t\t\t\t\t\tbsoncore.BuildDocumentElement(nil, \"0\",\n\t\t\t\t\t\t\tbsoncore.AppendDoubleElement(bsoncore.AppendStringElement(nil, \"hello\", \"world\"), \"pi\", 3.14159),\n\t\t\t\t\t\t),\n\t\t\t\t\t)\n\t\t\t\t\treturn doc\n\t\t\t\t}(nil)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t}\n\n\t\tt.Run(\"Decode\", func(t *testing.T) {\n\t\t\tcompareTime := func(t1, t2 time.Time) bool {\n\t\t\t\tif t1.Location() != t2.Location() {\n\t\t\t\t\treturn false\n\t\t\t\t}\n\t\t\t\treturn t1.Equal(t2)\n\t\t\t}\n\n\t\t\tfor _, tc := range testCases {\n\t\t\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\t\t\tvr := NewDocumentReader(bytes.NewReader(tc.b))\n\t\t\t\t\treg := buildDefaultRegistry()\n\t\t\t\t\tvtype := reflect.TypeOf(tc.value)\n\t\t\t\t\tdec, err := reg.LookupDecoder(vtype)\n\t\t\t\t\tnoerr(t, err)\n\n\t\t\t\t\tgotVal := reflect.New(reflect.TypeOf(tc.value)).Elem()\n\t\t\t\t\terr = dec.DecodeValue(DecodeContext{Registry: reg}, vr, gotVal)\n\t\t\t\t\tnoerr(t, err)\n\n\t\t\t\t\tgot := gotVal.Interface()\n\t\t\t\t\twant := tc.value\n\t\t\t\t\tif diff := cmp.Diff(\n\t\t\t\t\t\tgot, want,\n\t\t\t\t\t\tcmp.Comparer(compareDecimal128),\n\t\t\t\t\t\tcmp.Comparer(compareNoPrivateFields),\n\t\t\t\t\t\tcmp.Comparer(compareZeroTest),\n\t\t\t\t\t\tcmp.Comparer(compareTime),\n\t\t\t\t\t); diff != \"\" {\n\t\t\t\t\t\tt.Errorf(\"difference:\\n%s\", diff)\n\t\t\t\t\t\tt.Errorf(\"Values are not equal.\\ngot: %#v\\nwant:%#v\", got, want)\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t}\n\t\t})\n\t})\n\tt.Run(\"error path\", func(t *testing.T) {\n\t\ttestCases := []struct {\n\t\t\tname string\n\t\t\tvalue any\n\t\t\tb []byte\n\t\t\terr error\n\t\t}{\n\t\t\t{\n\t\t\t\t\"duplicate name struct\",\n\t\t\t\tstruct {\n\t\t\t\t\tA int64\n\t\t\t\t\tB int64 `bson:\"a\"`\n\t\t\t\t}{\n\t\t\t\t\tA: 0,\n\t\t\t\t\tB: 54321,\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendInt32Element(nil, \"a\", 12345)),\n\t\t\t\tfmt.Errorf(\"duplicated key a\"),\n\t\t\t},\n\t\t}\n\n\t\tfor _, tc := range testCases {\n\t\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\t\tvr := NewDocumentReader(bytes.NewReader(tc.b))\n\t\t\t\treg := buildDefaultRegistry()\n\t\t\t\tvtype := reflect.TypeOf(tc.value)\n\t\t\t\tdec, err := reg.LookupDecoder(vtype)\n\t\t\t\tnoerr(t, err)\n\n\t\t\t\tgotVal := reflect.New(reflect.TypeOf(tc.value)).Elem()\n\t\t\t\terr = dec.DecodeValue(DecodeContext{Registry: reg}, vr, gotVal)\n\t\t\t\tif err == nil || !strings.Contains(err.Error(), tc.err.Error()) {\n\t\t\t\t\tt.Errorf(\"Did not receive expected error. got %v; want %v\", err, tc.err)\n\t\t\t\t}\n\t\t\t})\n\t\t}\n\t})\n\n\tt.Run(\"defaultEmptyInterfaceCodec.DecodeValue\", func(t *testing.T) {\n\t\tt.Run(\"DecodeValue\", func(t *testing.T) {\n\t\t\ttestCases := []struct {\n\t\t\t\tname string\n\t\t\t\tval any\n\t\t\t\tbsontype Type\n\t\t\t}{\n\t\t\t\t{\n\t\t\t\t\t\"Double - float64\",\n\t\t\t\t\tfloat64(3.14159),\n\t\t\t\t\tTypeDouble,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"String - string\",\n\t\t\t\t\t\"foo bar baz\",\n\t\t\t\t\tTypeString,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Array - A\",\n\t\t\t\t\tA{3.14159},\n\t\t\t\t\tTypeArray,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Binary - Binary\",\n\t\t\t\t\tBinary{Subtype: 0xFF, Data: []byte{0x01, 0x02, 0x03}},\n\t\t\t\t\tTypeBinary,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Undefined - Undefined\",\n\t\t\t\t\tUndefined{},\n\t\t\t\t\tTypeUndefined,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ObjectID - ObjectID\",\n\t\t\t\t\tObjectID{0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0A, 0x0B, 0x0C},\n\t\t\t\t\tTypeObjectID,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Boolean - bool\",\n\t\t\t\t\tbool(true),\n\t\t\t\t\tTypeBoolean,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"DateTime - DateTime\",\n\t\t\t\t\tDateTime(1234567890),\n\t\t\t\t\tTypeDateTime,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Null - Null\",\n\t\t\t\t\tnil,\n\t\t\t\t\tTypeNull,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Regex - Regex\",\n\t\t\t\t\tRegex{Pattern: \"foo\", Options: \"bar\"},\n\t\t\t\t\tTypeRegex,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"DBPointer - DBPointer\",\n\t\t\t\t\tDBPointer{\n\t\t\t\t\t\tDB: \"foobar\",\n\t\t\t\t\t\tPointer: ObjectID{0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0A, 0x0B, 0x0C},\n\t\t\t\t\t},\n\t\t\t\t\tTypeDBPointer,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"JavaScript - JavaScript\",\n\t\t\t\t\tJavaScript(\"var foo = 'bar';\"),\n\t\t\t\t\tTypeJavaScript,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Symbol - Symbol\",\n\t\t\t\t\tSymbol(\"foobarbazlolz\"),\n\t\t\t\t\tTypeSymbol,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Int32 - int32\",\n\t\t\t\t\tint32(123456),\n\t\t\t\t\tTypeInt32,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Int64 - int64\",\n\t\t\t\t\tint64(1234567890),\n\t\t\t\t\tTypeInt64,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Timestamp - Timestamp\",\n\t\t\t\t\tTimestamp{T: 12345, I: 67890},\n\t\t\t\t\tTypeTimestamp,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Decimal128 - decimal.Decimal128\",\n\t\t\t\t\tNewDecimal128(12345, 67890),\n\t\t\t\t\tTypeDecimal128,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"MinKey - MinKey\",\n\t\t\t\t\tMinKey{},\n\t\t\t\t\tTypeMinKey,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"MaxKey - MaxKey\",\n\t\t\t\t\tMaxKey{},\n\t\t\t\t\tTypeMaxKey,\n\t\t\t\t},\n\t\t\t}\n\t\t\tfor _, tc := range testCases {\n\t\t\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\t\t\tllvr := &valueReaderWriter{BSONType: tc.bsontype}\n\n\t\t\t\t\tt.Run(\"Type Map failure\", func(t *testing.T) {\n\t\t\t\t\t\tif tc.bsontype == TypeNull {\n\t\t\t\t\t\t\tt.Skip()\n\t\t\t\t\t\t}\n\t\t\t\t\t\tval := reflect.New(tEmpty).Elem()\n\t\t\t\t\t\tdc := DecodeContext{Registry: newTestRegistry()}\n\t\t\t\t\t\twant := errNoTypeMapEntry{Type: tc.bsontype}\n\t\t\t\t\t\tgot := (&emptyInterfaceCodec{}).DecodeValue(dc, llvr, val)\n\t\t\t\t\t\tif !assert.CompareErrors(got, want) {\n\t\t\t\t\t\t\tt.Errorf(\"Errors are not equal. got %v; want %v\", got, want)\n\t\t\t\t\t\t}\n\t\t\t\t\t})\n\n\t\t\t\t\tt.Run(\"Lookup failure\", func(t *testing.T) {\n\t\t\t\t\t\tif tc.bsontype == TypeNull {\n\t\t\t\t\t\t\tt.Skip()\n\t\t\t\t\t\t}\n\t\t\t\t\t\tval := reflect.New(tEmpty).Elem()\n\t\t\t\t\t\treg := newTestRegistry()\n\t\t\t\t\t\treg.RegisterTypeMapEntry(tc.bsontype, reflect.TypeOf(tc.val))\n\t\t\t\t\t\tdc := DecodeContext{\n\t\t\t\t\t\t\tRegistry: reg,\n\t\t\t\t\t\t}\n\t\t\t\t\t\twant := errNoDecoder{Type: reflect.TypeOf(tc.val)}\n\t\t\t\t\t\tgot := (&emptyInterfaceCodec{}).DecodeValue(dc, llvr, val)\n\t\t\t\t\t\tif !assert.CompareErrors(got, want) {\n\t\t\t\t\t\t\tt.Errorf(\"Errors are not equal. got %v; want %v\", got, want)\n\t\t\t\t\t\t}\n\t\t\t\t\t})\n\n\t\t\t\t\tt.Run(\"DecodeValue failure\", func(t *testing.T) {\n\t\t\t\t\t\tif tc.bsontype == TypeNull {\n\t\t\t\t\t\t\tt.Skip()\n\t\t\t\t\t\t}\n\t\t\t\t\t\twant := errors.New(\"DecodeValue failure error\")\n\t\t\t\t\t\tllc := &llCodec{t: t, err: want}\n\t\t\t\t\t\treg := newTestRegistry()\n\t\t\t\t\t\treg.RegisterTypeDecoder(reflect.TypeOf(tc.val), llc)\n\t\t\t\t\t\treg.RegisterTypeMapEntry(tc.bsontype, reflect.TypeOf(tc.val))\n\t\t\t\t\t\tdc := DecodeContext{\n\t\t\t\t\t\t\tRegistry: reg,\n\t\t\t\t\t\t}\n\t\t\t\t\t\tgot := (&emptyInterfaceCodec{}).DecodeValue(dc, llvr, reflect.New(tEmpty).Elem())\n\t\t\t\t\t\tif !assert.CompareErrors(got, want) {\n\t\t\t\t\t\t\tt.Errorf(\"Errors are not equal. got %v; want %v\", got, want)\n\t\t\t\t\t\t}\n\t\t\t\t\t})\n\n\t\t\t\t\tt.Run(\"Success\", func(t *testing.T) {\n\t\t\t\t\t\twant := tc.val\n\t\t\t\t\t\tllc := &llCodec{t: t, decodeval: tc.val}\n\t\t\t\t\t\treg := newTestRegistry()\n\t\t\t\t\t\treg.RegisterTypeDecoder(reflect.TypeOf(tc.val), llc)\n\t\t\t\t\t\treg.RegisterTypeMapEntry(tc.bsontype, reflect.TypeOf(tc.val))\n\t\t\t\t\t\tdc := DecodeContext{\n\t\t\t\t\t\t\tRegistry: reg,\n\t\t\t\t\t\t}\n\t\t\t\t\t\tgot := reflect.New(tEmpty).Elem()\n\t\t\t\t\t\terr := (&emptyInterfaceCodec{}).DecodeValue(dc, llvr, got)\n\t\t\t\t\t\tnoerr(t, err)\n\t\t\t\t\t\tif !cmp.Equal(got.Interface(), want, cmp.Comparer(compareDecimal128)) {\n\t\t\t\t\t\t\tt.Errorf(\"Did not receive expected value. got %v; want %v\", got.Interface(), want)\n\t\t\t\t\t\t}\n\t\t\t\t\t})\n\t\t\t\t})\n\t\t\t}\n\t\t})\n\n\t\tt.Run(\"non-any\", func(t *testing.T) {\n\t\t\tval := uint64(1234567890)\n\t\t\twant := ValueDecoderError{Name: \"EmptyInterfaceDecodeValue\", Types: []reflect.Type{tEmpty}, Received: reflect.ValueOf(val)}\n\t\t\tgot := (&emptyInterfaceCodec{}).DecodeValue(DecodeContext{}, nil, reflect.ValueOf(val))\n\t\t\tif !assert.CompareErrors(got, want) {\n\t\t\t\tt.Errorf(\"Errors are not equal. got %v; want %v\", got, want)\n\t\t\t}\n\t\t})\n\n\t\tt.Run(\"nil *any\", func(t *testing.T) {\n\t\t\tvar val any\n\t\t\twant := ValueDecoderError{Name: \"EmptyInterfaceDecodeValue\", Types: []reflect.Type{tEmpty}, Received: reflect.ValueOf(val)}\n\t\t\tgot := (&emptyInterfaceCodec{}).DecodeValue(DecodeContext{}, nil, reflect.ValueOf(val))\n\t\t\tif !assert.CompareErrors(got, want) {\n\t\t\t\tt.Errorf(\"Errors are not equal. got %v; want %v\", got, want)\n\t\t\t}\n\t\t})\n\n\t\tt.Run(\"no type registered\", func(t *testing.T) {\n\t\t\tllvr := &valueReaderWriter{BSONType: TypeDouble}\n\t\t\twant := errNoTypeMapEntry{Type: TypeDouble}\n\t\t\tval := reflect.New(tEmpty).Elem()\n\t\t\tgot := (&emptyInterfaceCodec{}).DecodeValue(DecodeContext{Registry: newTestRegistry()}, llvr, val)\n\t\t\tif !assert.CompareErrors(got, want) {\n\t\t\t\tt.Errorf(\"Errors are not equal. got %v; want %v\", got, want)\n\t\t\t}\n\t\t})\n\t\tt.Run(\"top level document\", func(t *testing.T) {\n\t\t\tdata := bsoncore.BuildDocument(nil, bsoncore.AppendDoubleElement(nil, \"pi\", 3.14159))\n\t\t\tvr := NewDocumentReader(bytes.NewReader(data))\n\t\t\twant := D{{\"pi\", 3.14159}}\n\t\t\tvar got any\n\t\t\tval := reflect.ValueOf(&got).Elem()\n\t\t\terr := (&emptyInterfaceCodec{}).DecodeValue(DecodeContext{Registry: buildDefaultRegistry()}, vr, val)\n\t\t\tnoerr(t, err)\n\t\t\tif !cmp.Equal(got, want) {\n\t\t\t\tt.Errorf(\"Did not get correct result. got %v; want %v\", got, want)\n\t\t\t}\n\t\t})\n\t\tt.Run(\"custom type map entry\", func(t *testing.T) {\n\t\t\t// registering a custom type map entry for both Type(0) anad TypeEmbeddedDocument should cause\n\t\t\t// the top-level to decode to registered type when unmarshalling to any\n\n\t\t\ttopLevelReg := &Registry{\n\t\t\t\ttypeEncoders: new(typeEncoderCache),\n\t\t\t\ttypeDecoders: new(typeDecoderCache),\n\t\t\t\tkindEncoders: new(kindEncoderCache),\n\t\t\t\tkindDecoders: new(kindDecoderCache),\n\t\t\t}\n\t\t\tregisterDefaultEncoders(topLevelReg)\n\t\t\tregisterDefaultDecoders(topLevelReg)\n\t\t\ttopLevelReg.RegisterTypeMapEntry(Type(0), reflect.TypeOf(M{}))\n\n\t\t\tembeddedReg := &Registry{\n\t\t\t\ttypeEncoders: new(typeEncoderCache),\n\t\t\t\ttypeDecoders: new(typeDecoderCache),\n\t\t\t\tkindEncoders: new(kindEncoderCache),\n\t\t\t\tkindDecoders: new(kindDecoderCache),\n\t\t\t}\n\t\t\tregisterDefaultEncoders(embeddedReg)\n\t\t\tregisterDefaultDecoders(embeddedReg)\n\t\t\tembeddedReg.RegisterTypeMapEntry(Type(0), reflect.TypeOf(M{}))\n\n\t\t\t// create doc {\"nested\": {\"foo\": 1}}\n\t\t\tinnerDoc := bsoncore.BuildDocument(\n\t\t\t\tnil,\n\t\t\t\tbsoncore.AppendInt32Element(nil, \"foo\", 1),\n\t\t\t)\n\t\t\tdoc := bsoncore.BuildDocument(\n\t\t\t\tnil,\n\t\t\t\tbsoncore.AppendDocumentElement(nil, \"nested\", innerDoc),\n\t\t\t)\n\t\t\twant := M{\n\t\t\t\t\"nested\": D{{\"foo\", int32(1)}},\n\t\t\t}\n\n\t\t\ttestCases := []struct {\n\t\t\t\tname string\n\t\t\t\tregistry *Registry\n\t\t\t}{\n\t\t\t\t{\"top level\", topLevelReg},\n\t\t\t\t{\"embedded\", embeddedReg},\n\t\t\t}\n\t\t\tfor _, tc := range testCases {\n\t\t\t\tvar got any\n\t\t\t\tvr := NewDocumentReader(bytes.NewReader(doc))\n\t\t\t\tval := reflect.ValueOf(&got).Elem()\n\n\t\t\t\terr := (&emptyInterfaceCodec{}).DecodeValue(DecodeContext{Registry: tc.registry}, vr, val)\n\t\t\t\tnoerr(t, err)\n\t\t\t\tif !cmp.Equal(got, want) {\n\t\t\t\t\tt.Fatalf(\"got %v, want %v\", got, want)\n\t\t\t\t}\n\t\t\t}\n\t\t})\n\t\tt.Run(\"custom type map entry is used if there is no type information\", func(t *testing.T) {\n\t\t\t// If a type map entry is registered for TypeEmbeddedDocument, the decoder should use it when\n\t\t\t// type information is not available.\n\n\t\t\treg := &Registry{\n\t\t\t\ttypeEncoders: new(typeEncoderCache),\n\t\t\t\ttypeDecoders: new(typeDecoderCache),\n\t\t\t\tkindEncoders: new(kindEncoderCache),\n\t\t\t\tkindDecoders: new(kindDecoderCache),\n\t\t\t}\n\t\t\tregisterDefaultEncoders(reg)\n\t\t\tregisterDefaultDecoders(reg)\n\t\t\treg.RegisterTypeMapEntry(TypeEmbeddedDocument, reflect.TypeOf(M{}))\n\n\t\t\t// build document {\"nested\": {\"foo\": 10}}\n\t\t\tinner := bsoncore.BuildDocument(\n\t\t\t\tnil,\n\t\t\t\tbsoncore.AppendInt32Element(nil, \"foo\", 10),\n\t\t\t)\n\t\t\tdoc := bsoncore.BuildDocument(\n\t\t\t\tnil,\n\t\t\t\tbsoncore.AppendDocumentElement(nil, \"nested\", inner),\n\t\t\t)\n\t\t\twant := D{\n\t\t\t\t{\"nested\", M{\n\t\t\t\t\t\"foo\": int32(10),\n\t\t\t\t}},\n\t\t\t}\n\n\t\t\tvar got D\n\t\t\tvr := NewDocumentReader(bytes.NewReader(doc))\n\t\t\tval := reflect.ValueOf(&got).Elem()\n\t\t\terr := (&sliceCodec{}).DecodeValue(DecodeContext{Registry: reg}, vr, val)\n\t\t\tnoerr(t, err)\n\t\t\tif !cmp.Equal(got, want) {\n\t\t\t\tt.Fatalf(\"got %v, want %v\", got, want)\n\t\t\t}\n\t\t})\n\t})\n\n\tt.Run(\"decode errors contain key information\", func(t *testing.T) {\n\t\tdecodeValueError := errors.New(\"decode value error\")\n\t\temptyInterfaceErrorDecode := func(DecodeContext, ValueReader, reflect.Value) error {\n\t\t\treturn decodeValueError\n\t\t}\n\t\temptyInterfaceErrorRegistry := newTestRegistry()\n\t\temptyInterfaceErrorRegistry.RegisterTypeDecoder(tEmpty, ValueDecoderFunc(emptyInterfaceErrorDecode))\n\n\t\t// Set up a document {foo: 10} and an error that would happen if the value were decoded into any\n\t\t// using the registry defined above.\n\t\tdocBytes := bsoncore.BuildDocumentFromElements(\n\t\t\tnil,\n\t\t\tbsoncore.AppendInt32Element(nil, \"foo\", 10),\n\t\t)\n\t\tdocEmptyInterfaceErr := &DecodeError{\n\t\t\tkeys: []string{\"foo\"},\n\t\t\twrapped: decodeValueError,\n\t\t}\n\n\t\t// Set up struct definitions where Foo maps to any and string. When decoded using the registry defined\n\t\t// above, the any struct will get an error when calling DecodeValue and the string struct will get an\n\t\t// error when looking up a decoder.\n\t\ttype emptyInterfaceStruct struct {\n\t\t\tFoo any\n\t\t}\n\t\ttype stringStruct struct {\n\t\t\tFoo string\n\t\t}\n\t\temptyInterfaceStructErr := &DecodeError{\n\t\t\tkeys: []string{\"foo\"},\n\t\t\twrapped: decodeValueError,\n\t\t}\n\t\tstringStructErr := &DecodeError{\n\t\t\tkeys: []string{\"foo\"},\n\t\t\twrapped: errNoDecoder{reflect.TypeOf(\"\")},\n\t\t}\n\n\t\t// Test a deeply nested struct mixed with maps and slices.\n\t\t// Build document {\"first\": {\"second\": {\"randomKey\": {\"third\": [{}, {\"fourth\": \"value\"}]}}}}\n\t\ttype inner3 struct{ Fourth any }\n\t\ttype inner2 struct{ Third []inner3 }\n\t\ttype inner1 struct{ Second map[string]inner2 }\n\t\ttype outer struct{ First inner1 }\n\t\tinner3EmptyDoc := buildDocument(nil)\n\t\tinner3Doc := buildDocument(bsoncore.AppendStringElement(nil, \"fourth\", \"value\"))\n\t\tinner3Array := buildArray(\n\t\t\t// buildArray takes []byte so we first append() all of the values into a single []byte\n\t\t\tappend(\n\t\t\t\tbsoncore.AppendDocumentElement(nil, \"0\", inner3EmptyDoc),\n\t\t\t\tbsoncore.AppendDocumentElement(nil, \"1\", inner3Doc)...,\n\t\t\t),\n\t\t)\n\t\tinner2Doc := buildDocument(bsoncore.AppendArrayElement(nil, \"third\", inner3Array))\n\t\tinner2Map := buildDocument(bsoncore.AppendDocumentElement(nil, \"randomKey\", inner2Doc))\n\t\tinner1Doc := buildDocument(bsoncore.AppendDocumentElement(nil, \"second\", inner2Map))\n\t\touterDoc := buildDocument(bsoncore.AppendDocumentElement(nil, \"first\", inner1Doc))\n\n\t\t// Use a registry that has all default decoders with the custom any decoder that always errors.\n\t\tnestedRegistry := &Registry{\n\t\t\ttypeEncoders: new(typeEncoderCache),\n\t\t\ttypeDecoders: new(typeDecoderCache),\n\t\t\tkindEncoders: new(kindEncoderCache),\n\t\t\tkindDecoders: new(kindDecoderCache),\n\t\t}\n\t\tregisterDefaultDecoders(nestedRegistry)\n\t\tnestedRegistry.RegisterTypeDecoder(tEmpty, ValueDecoderFunc(emptyInterfaceErrorDecode))\n\t\tnestedErr := &DecodeError{\n\t\t\tkeys: []string{\"fourth\", \"1\", \"third\", \"randomKey\", \"second\", \"first\"},\n\t\t\twrapped: decodeValueError,\n\t\t}\n\n\t\ttestCases := []struct {\n\t\t\tname string\n\t\t\tval any\n\t\t\tvr ValueReader\n\t\t\tregistry *Registry // buildDefaultRegistry will be used if this is nil\n\t\t\tdecoder ValueDecoder\n\t\t\terr error\n\t\t}{\n\t\t\t{\n\t\t\t\t// DecodeValue error when decoding into a D.\n\t\t\t\t\"D slice\",\n\t\t\t\tD{},\n\t\t\t\tNewDocumentReader(bytes.NewReader(docBytes)),\n\t\t\t\temptyInterfaceErrorRegistry,\n\t\t\t\t&sliceCodec{},\n\t\t\t\tdocEmptyInterfaceErr,\n\t\t\t},\n\t\t\t{\n\t\t\t\t// DecodeValue error when decoding into a []string.\n\t\t\t\t\"string slice\",\n\t\t\t\t[]string{},\n\t\t\t\t&valueReaderWriter{BSONType: TypeArray},\n\t\t\t\tnil,\n\t\t\t\t&sliceCodec{},\n\t\t\t\t&DecodeError{\n\t\t\t\t\tkeys: []string{\"0\"},\n\t\t\t\t\twrapped: errors.New(\"cannot decode array into a string type\"),\n\t\t\t\t},\n\t\t\t},\n\t\t\t{\n\t\t\t\t// DecodeValue error when decoding into a E array. This should have the same behavior as\n\t\t\t\t// the \"D slice\" test above because both the defaultSliceCodec and ArrayDecodeValue use\n\t\t\t\t// the decodeD helper function.\n\t\t\t\t\"D array\",\n\t\t\t\t[1]E{},\n\t\t\t\tNewDocumentReader(bytes.NewReader(docBytes)),\n\t\t\t\temptyInterfaceErrorRegistry,\n\t\t\t\tValueDecoderFunc(arrayDecodeValue),\n\t\t\t\tdocEmptyInterfaceErr,\n\t\t\t},\n\t\t\t{\n\t\t\t\t// DecodeValue error when decoding into a string array. This should have the same behavior as\n\t\t\t\t// the \"D slice\" test above because both the defaultSliceCodec and ArrayDecodeValue use\n\t\t\t\t// the decodeDefault helper function.\n\t\t\t\t\"string array\",\n\t\t\t\t[1]string{},\n\t\t\t\t&valueReaderWriter{BSONType: TypeArray},\n\t\t\t\tnil,\n\t\t\t\tValueDecoderFunc(arrayDecodeValue),\n\t\t\t\t&DecodeError{\n\t\t\t\t\tkeys: []string{\"0\"},\n\t\t\t\t\twrapped: errors.New(\"cannot decode array into a string type\"),\n\t\t\t\t},\n\t\t\t},\n\t\t\t{\n\t\t\t\t// DecodeValue error when decoding into a map.\n\t\t\t\t\"map\",\n\t\t\t\tmap[string]any{},\n\t\t\t\tNewDocumentReader(bytes.NewReader(docBytes)),\n\t\t\t\temptyInterfaceErrorRegistry,\n\t\t\t\t&mapCodec{},\n\t\t\t\tdocEmptyInterfaceErr,\n\t\t\t},\n\t\t\t{\n\t\t\t\t// DecodeValue error when decoding into a struct.\n\t\t\t\t\"struct - DecodeValue error\",\n\t\t\t\temptyInterfaceStruct{},\n\t\t\t\tNewDocumentReader(bytes.NewReader(docBytes)),\n\t\t\t\temptyInterfaceErrorRegistry,\n\t\t\t\tnewStructCodec(nil),\n\t\t\t\temptyInterfaceStructErr,\n\t\t\t},\n\t\t\t{\n\t\t\t\t// ErrNoDecoder when decoding into a struct.\n\t\t\t\t// This test uses NewRegistryBuilder().Build rather than buildDefaultRegistry to ensure that there is\n\t\t\t\t// no decoder for strings.\n\t\t\t\t\"struct - no decoder found\",\n\t\t\t\tstringStruct{},\n\t\t\t\tNewDocumentReader(bytes.NewReader(docBytes)),\n\t\t\t\tnewTestRegistry(),\n\t\t\t\tnewStructCodec(nil),\n\t\t\t\tstringStructErr,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"deeply nested struct\",\n\t\t\t\touter{},\n\t\t\t\tNewDocumentReader(bytes.NewReader(outerDoc)),\n\t\t\t\tnestedRegistry,\n\t\t\t\tnewStructCodec(nil),\n\t\t\t\tnestedErr,\n\t\t\t},\n\t\t}\n\t\tfor _, tc := range testCases {\n\t\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\t\tdc := DecodeContext{Registry: tc.registry}\n\t\t\t\tif dc.Registry == nil {\n\t\t\t\t\tdc.Registry = buildDefaultRegistry()\n\t\t\t\t}\n\n\t\t\t\tvar val reflect.Value\n\t\t\t\tif rtype := reflect.TypeOf(tc.val); rtype != nil {\n\t\t\t\t\tval = reflect.New(rtype).Elem()\n\t\t\t\t}\n\t\t\t\terr := tc.decoder.DecodeValue(dc, tc.vr, val)\n\t\t\t\tassert.Equal(t, tc.err, err, \"expected error %v, got %v\", tc.err, err)\n\t\t\t})\n\t\t}\n\n\t\tt.Run(\"keys are correctly reversed\", func(t *testing.T) {\n\t\t\tinnerBytes := bsoncore.BuildDocumentFromElements(nil, bsoncore.AppendInt32Element(nil, \"bar\", 10))\n\t\t\touterBytes := bsoncore.BuildDocumentFromElements(nil, bsoncore.AppendDocumentElement(nil, \"foo\", innerBytes))\n\n\t\t\ttype inner struct{ Bar string }\n\t\t\ttype outer struct{ Foo inner }\n\n\t\t\tdc := DecodeContext{Registry: buildDefaultRegistry()}\n\t\t\tvr := NewDocumentReader(bytes.NewReader(outerBytes))\n\t\t\tval := reflect.New(reflect.TypeOf(outer{})).Elem()\n\t\t\terr := newStructCodec(nil).DecodeValue(dc, vr, val)\n\n\t\t\tvar decodeErr *DecodeError\n\t\t\tassert.True(t, errors.As(err, &decodeErr), \"expected DecodeError, got %v of type %T\", err, err)\n\t\t\texpectedKeys := []string{\"foo\", \"bar\"}\n\t\t\tassert.Equal(t, expectedKeys, decodeErr.Keys(), \"expected keys slice %v, got %v\", expectedKeys,\n\t\t\t\tdecodeErr.Keys())\n\t\t\tkeyPath := strings.Join(expectedKeys, \".\")\n\t\t\tassert.True(t, strings.Contains(decodeErr.Error(), keyPath),\n\t\t\t\t\"expected error %v to contain key pattern %s\", decodeErr, keyPath)\n\t\t})\n\t})\n\n\tt.Run(\"values are converted\", func(t *testing.T) {\n\t\t// When decoding into a D or M, values must be converted if they are not being decoded to the default type.\n\n\t\tt.Run(\"D\", func(t *testing.T) {\n\t\t\ttrueValue := bsoncore.Value{\n\t\t\t\tType: bsoncore.TypeBoolean,\n\t\t\t\tData: bsoncore.AppendBoolean(nil, true),\n\t\t\t}\n\t\t\tdocBytes := bsoncore.BuildDocumentFromElements(nil,\n\t\t\t\tbsoncore.AppendBooleanElement(nil, \"bool\", true),\n\t\t\t\tbsoncore.BuildArrayElement(nil, \"boolArray\", trueValue),\n\t\t\t)\n\n\t\t\treg := &Registry{\n\t\t\t\ttypeEncoders: new(typeEncoderCache),\n\t\t\t\ttypeDecoders: new(typeDecoderCache),\n\t\t\t\tkindEncoders: new(kindEncoderCache),\n\t\t\t\tkindDecoders: new(kindDecoderCache),\n\t\t\t}\n\t\t\tregisterDefaultDecoders(reg)\n\t\t\treg.RegisterTypeMapEntry(TypeBoolean, reflect.TypeOf(mybool(true)))\n\n\t\t\tdc := DecodeContext{Registry: reg}\n\t\t\tvr := NewDocumentReader(bytes.NewReader(docBytes))\n\t\t\tval := reflect.New(tD).Elem()\n\t\t\terr := dDecodeValue(dc, vr, val)\n\t\t\tassert.Nil(t, err, \"DDecodeValue error: %v\", err)\n\n\t\t\twant := D{\n\t\t\t\t{\"bool\", mybool(true)},\n\t\t\t\t{\"boolArray\", A{mybool(true)}},\n\t\t\t}\n\t\t\tgot := val.Interface().(D)\n\t\t\tassert.Equal(t, want, got, \"want document %v, got %v\", want, got)\n\t\t})\n\t\tt.Run(\"M\", func(t *testing.T) {\n\t\t\tdocBytes := bsoncore.BuildDocumentFromElements(nil,\n\t\t\t\tbsoncore.AppendBooleanElement(nil, \"bool\", true),\n\t\t\t)\n\n\t\t\ttype myMap map[string]mybool\n\t\t\tdc := DecodeContext{Registry: buildDefaultRegistry()}\n\t\t\tvr := NewDocumentReader(bytes.NewReader(docBytes))\n\t\t\tval := reflect.New(reflect.TypeOf(myMap{})).Elem()\n\t\t\terr := (&mapCodec{}).DecodeValue(dc, vr, val)\n\t\t\tassert.Nil(t, err, \"DecodeValue error: %v\", err)\n\n\t\t\twant := myMap{\n\t\t\t\t\"bool\": mybool(true),\n\t\t\t}\n\t\t\tgot := val.Interface().(myMap)\n\t\t\tassert.Equal(t, want, got, \"expected map %v, got %v\", want, got)\n\t\t})\n\t})\n}\n\n// buildDocumentArray inserts vals inside of an array inside of a document.\nfunc buildDocumentArray(fn func([]byte) []byte) []byte {\n\taix, doc := bsoncore.AppendArrayElementStart(nil, \"Z\")\n\tdoc = fn(doc)\n\tdoc, _ = bsoncore.AppendArrayEnd(doc, aix)\n\treturn buildDocument(doc)\n}\n\nfunc buildArray(vals []byte) []byte {\n\taix, doc := bsoncore.AppendArrayStart(nil)\n\tdoc = append(doc, vals...)\n\tdoc, _ = bsoncore.AppendArrayEnd(doc, aix)\n\treturn doc\n}\n\nfunc appendArrayElement(dst []byte, key string, vals []byte) []byte {\n\taix, doc := bsoncore.AppendArrayElementStart(dst, key)\n\tdoc = append(doc, vals...)\n\tdoc, _ = bsoncore.AppendArrayEnd(doc, aix)\n\treturn doc\n}\n\n// buildDocument inserts elems inside of a document.\nfunc buildDocument(elems []byte) []byte {\n\tidx, doc := bsoncore.AppendDocumentStart(nil)\n\tdoc = append(doc, elems...)\n\tdoc, _ = bsoncore.AppendDocumentEnd(doc, idx)\n\treturn doc\n}\n\nfunc buildDefaultRegistry() *Registry {\n\treg := &Registry{\n\t\ttypeEncoders: new(typeEncoderCache),\n\t\ttypeDecoders: new(typeDecoderCache),\n\t\tkindEncoders: new(kindEncoderCache),\n\t\tkindDecoders: new(kindDecoderCache),\n\t}\n\tregisterDefaultEncoders(reg)\n\tregisterDefaultDecoders(reg)\n\treturn reg\n}\n" }, { "path": "bson/default_value_encoders.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"encoding/json\"\n\t\"errors\"\n\t\"math\"\n\t\"net/url\"\n\t\"reflect\"\n\t\"sync\"\n\n\t\"go.mongodb.org/mongo-driver/v2/x/bsonx/bsoncore\"\n)\n\nvar bvwPool = sync.Pool{\n\tNew: func() any {\n\t\treturn new(valueWriter)\n\t},\n}\n\nvar errInvalidValue = errors.New(\"cannot encode invalid element\")\n\nvar sliceWriterPool = sync.Pool{\n\tNew: func() any {\n\t\tsw := make(sliceWriter, 0)\n\t\treturn &sw\n\t},\n}\n\nfunc encodeElement(ec EncodeContext, dw DocumentWriter, e E) error {\n\tvw, err := dw.WriteDocumentElement(e.Key)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tif e.Value == nil {\n\t\treturn vw.WriteNull()\n\t}\n\tencoder, err := ec.LookupEncoder(reflect.TypeOf(e.Value))\n\tif err != nil {\n\t\treturn err\n\t}\n\n\terr = encoder.EncodeValue(ec, vw, reflect.ValueOf(e.Value))\n\tif err != nil {\n\t\treturn err\n\t}\n\treturn nil\n}\n\n// registerDefaultEncoders will register the encoder methods attached to DefaultValueEncoders with\n// the provided RegistryBuilder.\nfunc registerDefaultEncoders(reg *Registry) {\n\tmapEncoder := &mapCodec{}\n\tuintCodec := &uintCodec{}\n\n\treg.RegisterTypeEncoder(tByteSlice, &byteSliceCodec{})\n\treg.RegisterTypeEncoder(tTime, &timeCodec{})\n\treg.RegisterTypeEncoder(tEmpty, &emptyInterfaceCodec{})\n\treg.RegisterTypeEncoder(tCoreArray, &arrayCodec{})\n\treg.RegisterTypeEncoder(tOID, ValueEncoderFunc(objectIDEncodeValue))\n\treg.RegisterTypeEncoder(tDecimal, ValueEncoderFunc(decimal128EncodeValue))\n\treg.RegisterTypeEncoder(tJSONNumber, ValueEncoderFunc(jsonNumberEncodeValue))\n\treg.RegisterTypeEncoder(tURL, ValueEncoderFunc(urlEncodeValue))\n\treg.RegisterTypeEncoder(tJavaScript, ValueEncoderFunc(javaScriptEncodeValue))\n\treg.RegisterTypeEncoder(tSymbol, ValueEncoderFunc(symbolEncodeValue))\n\treg.RegisterTypeEncoder(tBinary, ValueEncoderFunc(binaryEncodeValue))\n\treg.RegisterTypeEncoder(tVector, ValueEncoderFunc(vectorEncodeValue))\n\treg.RegisterTypeEncoder(tUndefined, ValueEncoderFunc(undefinedEncodeValue))\n\treg.RegisterTypeEncoder(tDateTime, ValueEncoderFunc(dateTimeEncodeValue))\n\treg.RegisterTypeEncoder(tNull, ValueEncoderFunc(nullEncodeValue))\n\treg.RegisterTypeEncoder(tRegex, ValueEncoderFunc(regexEncodeValue))\n\treg.RegisterTypeEncoder(tDBPointer, ValueEncoderFunc(dbPointerEncodeValue))\n\treg.RegisterTypeEncoder(tTimestamp, ValueEncoderFunc(timestampEncodeValue))\n\treg.RegisterTypeEncoder(tMinKey, ValueEncoderFunc(minKeyEncodeValue))\n\treg.RegisterTypeEncoder(tMaxKey, ValueEncoderFunc(maxKeyEncodeValue))\n\treg.RegisterTypeEncoder(tCoreDocument, ValueEncoderFunc(coreDocumentEncodeValue))\n\treg.RegisterTypeEncoder(tCodeWithScope, ValueEncoderFunc(codeWithScopeEncodeValue))\n\treg.RegisterKindEncoder(reflect.Bool, ValueEncoderFunc(booleanEncodeValue))\n\treg.RegisterKindEncoder(reflect.Int, ValueEncoderFunc(intEncodeValue))\n\treg.RegisterKindEncoder(reflect.Int8, ValueEncoderFunc(intEncodeValue))\n\treg.RegisterKindEncoder(reflect.Int16, ValueEncoderFunc(intEncodeValue))\n\treg.RegisterKindEncoder(reflect.Int32, ValueEncoderFunc(intEncodeValue))\n\treg.RegisterKindEncoder(reflect.Int64, ValueEncoderFunc(intEncodeValue))\n\treg.RegisterKindEncoder(reflect.Uint, uintCodec)\n\treg.RegisterKindEncoder(reflect.Uint8, uintCodec)\n\treg.RegisterKindEncoder(reflect.Uint16, uintCodec)\n\treg.RegisterKindEncoder(reflect.Uint32, uintCodec)\n\treg.RegisterKindEncoder(reflect.Uint64, uintCodec)\n\treg.RegisterKindEncoder(reflect.Float32, ValueEncoderFunc(floatEncodeValue))\n\treg.RegisterKindEncoder(reflect.Float64, ValueEncoderFunc(floatEncodeValue))\n\treg.RegisterKindEncoder(reflect.Array, ValueEncoderFunc(arrayEncodeValue))\n\treg.RegisterKindEncoder(reflect.Map, mapEncoder)\n\treg.RegisterKindEncoder(reflect.Slice, &sliceCodec{})\n\treg.RegisterKindEncoder(reflect.String, &stringCodec{})\n\treg.RegisterKindEncoder(reflect.Struct, newStructCodec(mapEncoder))\n\treg.RegisterKindEncoder(reflect.Ptr, &pointerCodec{})\n\treg.RegisterInterfaceEncoder(tValueMarshaler, ValueEncoderFunc(valueMarshalerEncodeValue))\n\treg.RegisterInterfaceEncoder(tMarshaler, ValueEncoderFunc(marshalerEncodeValue))\n}\n\n// booleanEncodeValue is the ValueEncoderFunc for bool types.\nfunc booleanEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Kind() != reflect.Bool {\n\t\treturn ValueEncoderError{Name: \"BooleanEncodeValue\", Kinds: []reflect.Kind{reflect.Bool}, Received: val}\n\t}\n\treturn vw.WriteBoolean(val.Bool())\n}\n\nfunc fitsIn32Bits(i int64) bool {\n\treturn math.MinInt32 <= i && i <= math.MaxInt32\n}\n\n// intEncodeValue is the ValueEncoderFunc for int types.\nfunc intEncodeValue(ec EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tswitch val.Kind() {\n\tcase reflect.Int8, reflect.Int16, reflect.Int32:\n\t\treturn vw.WriteInt32(int32(val.Int()))\n\tcase reflect.Int:\n\t\ti64 := val.Int()\n\t\tif fitsIn32Bits(i64) {\n\t\t\treturn vw.WriteInt32(int32(i64))\n\t\t}\n\t\treturn vw.WriteInt64(i64)\n\tcase reflect.Int64:\n\t\ti64 := val.Int()\n\t\tif ec.minSize && fitsIn32Bits(i64) {\n\t\t\treturn vw.WriteInt32(int32(i64))\n\t\t}\n\t\treturn vw.WriteInt64(i64)\n\t}\n\n\treturn ValueEncoderError{\n\t\tName: \"IntEncodeValue\",\n\t\tKinds: []reflect.Kind{reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64, reflect.Int},\n\t\tReceived: val,\n\t}\n}\n\n// floatEncodeValue is the ValueEncoderFunc for float types.\nfunc floatEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tswitch val.Kind() {\n\tcase reflect.Float32, reflect.Float64:\n\t\treturn vw.WriteDouble(val.Float())\n\t}\n\n\treturn ValueEncoderError{Name: \"FloatEncodeValue\", Kinds: []reflect.Kind{reflect.Float32, reflect.Float64}, Received: val}\n}\n\n// objectIDEncodeValue is the ValueEncoderFunc for ObjectID.\nfunc objectIDEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tOID {\n\t\treturn ValueEncoderError{Name: \"ObjectIDEncodeValue\", Types: []reflect.Type{tOID}, Received: val}\n\t}\n\treturn vw.WriteObjectID(val.Interface().(ObjectID))\n}\n\n// decimal128EncodeValue is the ValueEncoderFunc for Decimal128.\nfunc decimal128EncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tDecimal {\n\t\treturn ValueEncoderError{Name: \"Decimal128EncodeValue\", Types: []reflect.Type{tDecimal}, Received: val}\n\t}\n\treturn vw.WriteDecimal128(val.Interface().(Decimal128))\n}\n\n// jsonNumberEncodeValue is the ValueEncoderFunc for json.Number.\nfunc jsonNumberEncodeValue(ec EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tJSONNumber {\n\t\treturn ValueEncoderError{Name: \"JSONNumberEncodeValue\", Types: []reflect.Type{tJSONNumber}, Received: val}\n\t}\n\tjsnum := val.Interface().(json.Number)\n\n\t// Attempt int first, then float64\n\tif i64, err := jsnum.Int64(); err == nil {\n\t\treturn intEncodeValue(ec, vw, reflect.ValueOf(i64))\n\t}\n\n\tf64, err := jsnum.Float64()\n\tif err != nil {\n\t\treturn err\n\t}\n\n\treturn floatEncodeValue(ec, vw, reflect.ValueOf(f64))\n}\n\n// urlEncodeValue is the ValueEncoderFunc for url.URL.\nfunc urlEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tURL {\n\t\treturn ValueEncoderError{Name: \"URLEncodeValue\", Types: []reflect.Type{tURL}, Received: val}\n\t}\n\tu := val.Interface().(url.URL)\n\treturn vw.WriteString(u.String())\n}\n\n// arrayEncodeValue is the ValueEncoderFunc for array types.\nfunc arrayEncodeValue(ec EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Kind() != reflect.Array {\n\t\treturn ValueEncoderError{Name: \"ArrayEncodeValue\", Kinds: []reflect.Kind{reflect.Array}, Received: val}\n\t}\n\n\t// If we have a []E we want to treat it as a document instead of as an array.\n\tif val.Type().Elem() == tE {\n\t\tdw, err := vw.WriteDocument()\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\n\t\tfor idx := 0; idx < val.Len(); idx++ {\n\t\t\te := val.Index(idx).Interface().(E)\n\t\t\terr = encodeElement(ec, dw, e)\n\t\t\tif err != nil {\n\t\t\t\treturn err\n\t\t\t}\n\t\t}\n\n\t\treturn dw.WriteDocumentEnd()\n\t}\n\n\t// If we have a []byte we want to treat it as a binary instead of as an array.\n\tif val.Type().Elem() == tByte {\n\t\tvar byteSlice []byte\n\t\tfor idx := 0; idx < val.Len(); idx++ {\n\t\t\tbyteSlice = append(byteSlice, val.Index(idx).Interface().(byte))\n\t\t}\n\t\treturn vw.WriteBinary(byteSlice)\n\t}\n\n\taw, err := vw.WriteArray()\n\tif err != nil {\n\t\treturn err\n\t}\n\n\telemType := val.Type().Elem()\n\tencoder, err := ec.LookupEncoder(elemType)\n\tif err != nil && elemType.Kind() != reflect.Interface {\n\t\treturn err\n\t}\n\n\tfor idx := 0; idx < val.Len(); idx++ {\n\t\tcurrEncoder, currVal, lookupErr := lookupElementEncoder(ec, encoder, val.Index(idx))\n\t\tif lookupErr != nil && !errors.Is(lookupErr, errInvalidValue) {\n\t\t\treturn lookupErr\n\t\t}\n\n\t\tvw, err := aw.WriteArrayElement()\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\n\t\tif errors.Is(lookupErr, errInvalidValue) {\n\t\t\terr = vw.WriteNull()\n\t\t\tif err != nil {\n\t\t\t\treturn err\n\t\t\t}\n\t\t\tcontinue\n\t\t}\n\n\t\terr = currEncoder.EncodeValue(ec, vw, currVal)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t}\n\treturn aw.WriteArrayEnd()\n}\n\nfunc lookupElementEncoder(ec EncodeContext, origEncoder ValueEncoder, currVal reflect.Value) (ValueEncoder, reflect.Value, error) {\n\tif origEncoder != nil || (currVal.Kind() != reflect.Interface) {\n\t\treturn origEncoder, currVal, nil\n\t}\n\tcurrVal = currVal.Elem()\n\tif !currVal.IsValid() {\n\t\treturn nil, currVal, errInvalidValue\n\t}\n\tcurrEncoder, err := ec.LookupEncoder(currVal.Type())\n\n\treturn currEncoder, currVal, err\n}\n\n// valueMarshalerEncodeValue is the ValueEncoderFunc for ValueMarshaler implementations.\nfunc valueMarshalerEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\t// Either val or a pointer to val must implement ValueMarshaler\n\tswitch {\n\tcase !val.IsValid():\n\t\treturn ValueEncoderError{Name: \"ValueMarshalerEncodeValue\", Types: []reflect.Type{tValueMarshaler}, Received: val}\n\tcase val.Type().Implements(tValueMarshaler):\n\t\t// If ValueMarshaler is implemented on a concrete type, make sure that val isn't a nil pointer\n\t\tif isImplementationNil(val, tValueMarshaler) {\n\t\t\treturn vw.WriteNull()\n\t\t}\n\tcase reflect.PtrTo(val.Type()).Implements(tValueMarshaler) && val.CanAddr():\n\t\tval = val.Addr()\n\tdefault:\n\t\treturn ValueEncoderError{Name: \"ValueMarshalerEncodeValue\", Types: []reflect.Type{tValueMarshaler}, Received: val}\n\t}\n\n\tm, ok := val.Interface().(ValueMarshaler)\n\tif !ok {\n\t\treturn vw.WriteNull()\n\t}\n\tt, data, err := m.MarshalBSONValue()\n\tif err != nil {\n\t\treturn err\n\t}\n\treturn copyValueFromBytes(vw, Type(t), data)\n}\n\n// marshalerEncodeValue is the ValueEncoderFunc for Marshaler implementations.\nfunc marshalerEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\t// Either val or a pointer to val must implement Marshaler\n\tswitch {\n\tcase !val.IsValid():\n\t\treturn ValueEncoderError{Name: \"MarshalerEncodeValue\", Types: []reflect.Type{tMarshaler}, Received: val}\n\tcase val.Type().Implements(tMarshaler):\n\t\t// If Marshaler is implemented on a concrete type, make sure that val isn't a nil pointer\n\t\tif isImplementationNil(val, tMarshaler) {\n\t\t\treturn vw.WriteNull()\n\t\t}\n\tcase reflect.PtrTo(val.Type()).Implements(tMarshaler) && val.CanAddr():\n\t\tval = val.Addr()\n\tdefault:\n\t\treturn ValueEncoderError{Name: \"MarshalerEncodeValue\", Types: []reflect.Type{tMarshaler}, Received: val}\n\t}\n\n\tm, ok := val.Interface().(Marshaler)\n\tif !ok {\n\t\treturn vw.WriteNull()\n\t}\n\tdata, err := m.MarshalBSON()\n\tif err != nil {\n\t\treturn err\n\t}\n\treturn copyValueFromBytes(vw, TypeEmbeddedDocument, data)\n}\n\n// javaScriptEncodeValue is the ValueEncoderFunc for the JavaScript type.\nfunc javaScriptEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tJavaScript {\n\t\treturn ValueEncoderError{Name: \"JavaScriptEncodeValue\", Types: []reflect.Type{tJavaScript}, Received: val}\n\t}\n\n\treturn vw.WriteJavascript(val.String())\n}\n\n// symbolEncodeValue is the ValueEncoderFunc for the Symbol type.\nfunc symbolEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tSymbol {\n\t\treturn ValueEncoderError{Name: \"SymbolEncodeValue\", Types: []reflect.Type{tSymbol}, Received: val}\n\t}\n\n\treturn vw.WriteSymbol(val.String())\n}\n\n// binaryEncodeValue is the ValueEncoderFunc for Binary.\nfunc binaryEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tBinary {\n\t\treturn ValueEncoderError{Name: \"BinaryEncodeValue\", Types: []reflect.Type{tBinary}, Received: val}\n\t}\n\tb := val.Interface().(Binary)\n\n\treturn vw.WriteBinaryWithSubtype(b.Data, b.Subtype)\n}\n\n// vectorEncodeValue is the ValueEncoderFunc for Vector.\nfunc vectorEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tt := val.Type()\n\tif !val.IsValid() || t != tVector {\n\t\treturn ValueEncoderError{\n\t\t\tName: \"VectorEncodeValue\",\n\t\t\tTypes: []reflect.Type{tVector},\n\t\t\tReceived: val,\n\t\t}\n\t}\n\tv := val.Interface().(Vector)\n\tb := v.Binary()\n\treturn vw.WriteBinaryWithSubtype(b.Data, b.Subtype)\n}\n\n// undefinedEncodeValue is the ValueEncoderFunc for Undefined.\nfunc undefinedEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tUndefined {\n\t\treturn ValueEncoderError{Name: \"UndefinedEncodeValue\", Types: []reflect.Type{tUndefined}, Received: val}\n\t}\n\n\treturn vw.WriteUndefined()\n}\n\n// dateTimeEncodeValue is the ValueEncoderFunc for DateTime.\nfunc dateTimeEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tDateTime {\n\t\treturn ValueEncoderError{Name: \"DateTimeEncodeValue\", Types: []reflect.Type{tDateTime}, Received: val}\n\t}\n\n\treturn vw.WriteDateTime(val.Int())\n}\n\n// nullEncodeValue is the ValueEncoderFunc for Null.\nfunc nullEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tNull {\n\t\treturn ValueEncoderError{Name: \"NullEncodeValue\", Types: []reflect.Type{tNull}, Received: val}\n\t}\n\n\treturn vw.WriteNull()\n}\n\n// regexEncodeValue is the ValueEncoderFunc for Regex.\nfunc regexEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tRegex {\n\t\treturn ValueEncoderError{Name: \"RegexEncodeValue\", Types: []reflect.Type{tRegex}, Received: val}\n\t}\n\n\tregex := val.Interface().(Regex)\n\n\treturn vw.WriteRegex(regex.Pattern, regex.Options)\n}\n\n// dbPointerEncodeValue is the ValueEncoderFunc for DBPointer.\nfunc dbPointerEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tDBPointer {\n\t\treturn ValueEncoderError{Name: \"DBPointerEncodeValue\", Types: []reflect.Type{tDBPointer}, Received: val}\n\t}\n\n\tdbp := val.Interface().(DBPointer)\n\n\treturn vw.WriteDBPointer(dbp.DB, dbp.Pointer)\n}\n\n// timestampEncodeValue is the ValueEncoderFunc for Timestamp.\nfunc timestampEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tTimestamp {\n\t\treturn ValueEncoderError{Name: \"TimestampEncodeValue\", Types: []reflect.Type{tTimestamp}, Received: val}\n\t}\n\n\tts := val.Interface().(Timestamp)\n\n\treturn vw.WriteTimestamp(ts.T, ts.I)\n}\n\n// minKeyEncodeValue is the ValueEncoderFunc for MinKey.\nfunc minKeyEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tMinKey {\n\t\treturn ValueEncoderError{Name: \"MinKeyEncodeValue\", Types: []reflect.Type{tMinKey}, Received: val}\n\t}\n\n\treturn vw.WriteMinKey()\n}\n\n// maxKeyEncodeValue is the ValueEncoderFunc for MaxKey.\nfunc maxKeyEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tMaxKey {\n\t\treturn ValueEncoderError{Name: \"MaxKeyEncodeValue\", Types: []reflect.Type{tMaxKey}, Received: val}\n\t}\n\n\treturn vw.WriteMaxKey()\n}\n\n// coreDocumentEncodeValue is the ValueEncoderFunc for bsoncore.Document.\nfunc coreDocumentEncodeValue(_ EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tCoreDocument {\n\t\treturn ValueEncoderError{Name: \"CoreDocumentEncodeValue\", Types: []reflect.Type{tCoreDocument}, Received: val}\n\t}\n\n\tcdoc := val.Interface().(bsoncore.Document)\n\n\treturn copyDocumentFromBytes(vw, cdoc)\n}\n\n// codeWithScopeEncodeValue is the ValueEncoderFunc for CodeWithScope.\nfunc codeWithScopeEncodeValue(ec EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tCodeWithScope {\n\t\treturn ValueEncoderError{Name: \"CodeWithScopeEncodeValue\", Types: []reflect.Type{tCodeWithScope}, Received: val}\n\t}\n\n\tcws := val.Interface().(CodeWithScope)\n\n\tdw, err := vw.WriteCodeWithScope(string(cws.Code))\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tsw := sliceWriterPool.Get().(*sliceWriter)\n\tdefer sliceWriterPool.Put(sw)\n\t*sw = (*sw)[:0]\n\n\tscopeVW := bvwPool.Get().(*valueWriter)\n\tscopeVW.reset(scopeVW.buf[:0])\n\tscopeVW.w = sw\n\tdefer bvwPool.Put(scopeVW)\n\n\tencoder, err := ec.LookupEncoder(reflect.TypeOf(cws.Scope))\n\tif err != nil {\n\t\treturn err\n\t}\n\n\terr = encoder.EncodeValue(ec, scopeVW, reflect.ValueOf(cws.Scope))\n\tif err != nil {\n\t\treturn err\n\t}\n\n\terr = copyBytesToDocumentWriter(dw, *sw)\n\tif err != nil {\n\t\treturn err\n\t}\n\treturn dw.WriteDocumentEnd()\n}\n\n// isImplementationNil returns if val is a nil pointer and inter is implemented on a concrete type\nfunc isImplementationNil(val reflect.Value, inter reflect.Type) bool {\n\tvt := val.Type()\n\tfor vt.Kind() == reflect.Ptr {\n\t\tvt = vt.Elem()\n\t}\n\treturn vt.Implements(inter) && val.Kind() == reflect.Ptr && val.IsNil()\n}\n" }, { "path": "bson/default_value_encoders_test.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"encoding/json\"\n\t\"errors\"\n\t\"fmt\"\n\t\"math\"\n\t\"net/url\"\n\t\"reflect\"\n\t\"strings\"\n\t\"testing\"\n\t\"time\"\n\n\t\"github.com/google/go-cmp/cmp\"\n\t\"go.mongodb.org/mongo-driver/v2/internal/assert\"\n\t\"go.mongodb.org/mongo-driver/v2/x/bsonx/bsoncore\"\n)\n\ntype myInterface interface {\n\tFoo() int\n}\n\ntype myStruct struct {\n\tVal int\n}\n\nfunc (ms myStruct) Foo() int {\n\treturn ms.Val\n}\n\nfunc TestDefaultValueEncoders(t *testing.T) {\n\twrong := func(string, string) string { return \"wrong\" }\n\n\ttype mybool bool\n\ttype myint8 int8\n\ttype myint16 int16\n\ttype myint32 int32\n\ttype myint64 int64\n\ttype myint int\n\ttype myuint8 uint8\n\ttype myuint16 uint16\n\ttype myuint32 uint32\n\ttype myuint64 uint64\n\ttype myuint uint\n\ttype myfloat32 float32\n\ttype myfloat64 float64\n\n\tnow := time.Now().Truncate(time.Millisecond)\n\tpjsnum := new(json.Number)\n\t*pjsnum = json.Number(\"3.14159\")\n\td128 := NewDecimal128(12345, 67890)\n\tvar nilValueMarshaler *testValueMarshaler\n\tvar nilMarshaler *testMarshaler\n\n\tvmStruct := struct{ V testValueMarshalPtr }{testValueMarshalPtr{t: TypeString, buf: []byte{0x04, 0x00, 0x00, 0x00, 'f', 'o', 'o', 0x00}}}\n\tmStruct := struct{ V testMarshalPtr }{testMarshalPtr{buf: bsoncore.BuildDocument(nil, bsoncore.AppendDoubleElement(nil, \"pi\", 3.14159))}}\n\n\ttype subtest struct {\n\t\tname string\n\t\tval any\n\t\tectx *EncodeContext\n\t\tllvrw *valueReaderWriter\n\t\tinvoke invoked\n\t\terr error\n\t}\n\n\ttestCases := []struct {\n\t\tname string\n\t\tve ValueEncoder\n\t\tsubtests []subtest\n\t}{\n\t\t{\n\t\t\t\"BooleanEncodeValue\",\n\t\t\tValueEncoderFunc(booleanEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"BooleanEncodeValue\", Kinds: []reflect.Kind{reflect.Bool}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\"fast path\", bool(true), nil, nil, writeBoolean, nil},\n\t\t\t\t{\"reflection path\", mybool(true), nil, nil, writeBoolean, nil},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"IntEncodeValue\",\n\t\t\tValueEncoderFunc(intEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{\n\t\t\t\t\t\tName: \"IntEncodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64, reflect.Int},\n\t\t\t\t\t\tReceived: reflect.ValueOf(wrong),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\"int8/fast path\", int8(127), nil, nil, writeInt32, nil},\n\t\t\t\t{\"int16/fast path\", int16(32767), nil, nil, writeInt32, nil},\n\t\t\t\t{\"int32/fast path\", int32(2147483647), nil, nil, writeInt32, nil},\n\t\t\t\t{\"int64/fast path\", int64(1234567890987), nil, nil, writeInt64, nil},\n\t\t\t\t{\"int64/fast path - minsize\", int64(math.MaxInt32), &EncodeContext{minSize: true}, nil, writeInt32, nil},\n\t\t\t\t{\"int64/fast path - minsize too large\", int64(math.MaxInt32 + 1), &EncodeContext{minSize: true}, nil, writeInt64, nil},\n\t\t\t\t{\"int64/fast path - minsize too small\", int64(math.MinInt32 - 1), &EncodeContext{minSize: true}, nil, writeInt64, nil},\n\t\t\t\t{\"int/fast path - positive int32\", int(math.MaxInt32 - 1), nil, nil, writeInt32, nil},\n\t\t\t\t{\"int/fast path - negative int32\", int(math.MinInt32 + 1), nil, nil, writeInt32, nil},\n\t\t\t\t{\"int/fast path - MaxInt32\", int(math.MaxInt32), nil, nil, writeInt32, nil},\n\t\t\t\t{\"int/fast path - MinInt32\", int(math.MinInt32), nil, nil, writeInt32, nil},\n\t\t\t\t{\"int8/reflection path\", myint8(127), nil, nil, writeInt32, nil},\n\t\t\t\t{\"int16/reflection path\", myint16(32767), nil, nil, writeInt32, nil},\n\t\t\t\t{\"int32/reflection path\", myint32(2147483647), nil, nil, writeInt32, nil},\n\t\t\t\t{\"int64/reflection path\", myint64(1234567890987), nil, nil, writeInt64, nil},\n\t\t\t\t{\"int64/reflection path - minsize\", myint64(math.MaxInt32), &EncodeContext{minSize: true}, nil, writeInt32, nil},\n\t\t\t\t{\"int64/reflection path - minsize too large\", myint64(math.MaxInt32 + 1), &EncodeContext{minSize: true}, nil, writeInt64, nil},\n\t\t\t\t{\"int64/reflection path - minsize too small\", myint64(math.MinInt32 - 1), &EncodeContext{minSize: true}, nil, writeInt64, nil},\n\t\t\t\t{\"int/reflection path - positive int32\", myint(math.MaxInt32 - 1), nil, nil, writeInt32, nil},\n\t\t\t\t{\"int/reflection path - negative int32\", myint(math.MinInt32 + 1), nil, nil, writeInt32, nil},\n\t\t\t\t{\"int/reflection path - MaxInt32\", myint(math.MaxInt32), nil, nil, writeInt32, nil},\n\t\t\t\t{\"int/reflection path - MinInt32\", myint(math.MinInt32), nil, nil, writeInt32, nil},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"UintEncodeValue\",\n\t\t\t&uintCodec{},\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{\n\t\t\t\t\t\tName: \"UintEncodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Uint},\n\t\t\t\t\t\tReceived: reflect.ValueOf(wrong),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\"uint8/fast path\", uint8(127), nil, nil, writeInt32, nil},\n\t\t\t\t{\"uint16/fast path\", uint16(32767), nil, nil, writeInt32, nil},\n\t\t\t\t{\"uint32/fast path\", uint32(2147483647), nil, nil, writeInt64, nil},\n\t\t\t\t{\"uint64/fast path\", uint64(1234567890987), nil, nil, writeInt64, nil},\n\t\t\t\t{\"uint/fast path\", uint(1234567), nil, nil, writeInt64, nil},\n\t\t\t\t{\"uint32/fast path - minsize\", uint32(2147483647), &EncodeContext{minSize: true}, nil, writeInt32, nil},\n\t\t\t\t{\"uint64/fast path - minsize\", uint64(2147483647), &EncodeContext{minSize: true}, nil, writeInt32, nil},\n\t\t\t\t{\"uint/fast path - minsize\", uint(2147483647), &EncodeContext{minSize: true}, nil, writeInt32, nil},\n\t\t\t\t{\"uint32/fast path - minsize too large\", uint32(2147483648), &EncodeContext{minSize: true}, nil, writeInt64, nil},\n\t\t\t\t{\"uint64/fast path - minsize too large\", uint64(2147483648), &EncodeContext{minSize: true}, nil, writeInt64, nil},\n\t\t\t\t{\"uint/fast path - minsize too large\", uint(2147483648), &EncodeContext{minSize: true}, nil, writeInt64, nil},\n\t\t\t\t{\"uint64/fast path - overflow\", uint64(1 << 63), nil, nil, nothing, fmt.Errorf(\"%d overflows int64\", uint64(1<<63))},\n\t\t\t\t{\"uint8/reflection path\", myuint8(127), nil, nil, writeInt32, nil},\n\t\t\t\t{\"uint16/reflection path\", myuint16(32767), nil, nil, writeInt32, nil},\n\t\t\t\t{\"uint32/reflection path\", myuint32(2147483647), nil, nil, writeInt64, nil},\n\t\t\t\t{\"uint64/reflection path\", myuint64(1234567890987), nil, nil, writeInt64, nil},\n\t\t\t\t{\"uint32/reflection path - minsize\", myuint32(2147483647), &EncodeContext{minSize: true}, nil, writeInt32, nil},\n\t\t\t\t{\"uint64/reflection path - minsize\", myuint64(2147483647), &EncodeContext{minSize: true}, nil, writeInt32, nil},\n\t\t\t\t{\"uint/reflection path - minsize\", myuint(2147483647), &EncodeContext{minSize: true}, nil, writeInt32, nil},\n\t\t\t\t{\"uint32/reflection path - minsize too large\", myuint(1 << 31), &EncodeContext{minSize: true}, nil, writeInt64, nil},\n\t\t\t\t{\"uint64/reflection path - minsize too large\", myuint64(1 << 31), &EncodeContext{minSize: true}, nil, writeInt64, nil},\n\t\t\t\t{\"uint/reflection path - minsize too large\", myuint(2147483648), &EncodeContext{minSize: true}, nil, writeInt64, nil},\n\t\t\t\t{\"uint64/reflection path - overflow\", myuint64(1 << 63), nil, nil, nothing, fmt.Errorf(\"%d overflows int64\", uint64(1<<63))},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"FloatEncodeValue\",\n\t\t\tValueEncoderFunc(floatEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{\n\t\t\t\t\t\tName: \"FloatEncodeValue\",\n\t\t\t\t\t\tKinds: []reflect.Kind{reflect.Float32, reflect.Float64},\n\t\t\t\t\t\tReceived: reflect.ValueOf(wrong),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\"float32/fast path\", float32(3.14159), nil, nil, writeDouble, nil},\n\t\t\t\t{\"float64/fast path\", float64(3.14159), nil, nil, writeDouble, nil},\n\t\t\t\t{\"float32/reflection path\", myfloat32(3.14159), nil, nil, writeDouble, nil},\n\t\t\t\t{\"float64/reflection path\", myfloat64(3.14159), nil, nil, writeDouble, nil},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"TimeEncodeValue\",\n\t\t\t&timeCodec{},\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"TimeEncodeValue\", Types: []reflect.Type{tTime}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\"time.Time\", now, nil, nil, writeDateTime, nil},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"MapEncodeValue\",\n\t\t\t&mapCodec{},\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong kind\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"MapEncodeValue\", Kinds: []reflect.Kind{reflect.Map}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"WriteDocument Error\",\n\t\t\t\t\tmap[string]any{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"wd error\"), ErrAfter: writeDocument},\n\t\t\t\t\twriteDocument,\n\t\t\t\t\terrors.New(\"wd error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Lookup Error\",\n\t\t\t\t\tmap[string]int{\"foo\": 1},\n\t\t\t\t\t&EncodeContext{Registry: newTestRegistry()},\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\twriteDocument,\n\t\t\t\t\tfmt.Errorf(\"no encoder found for int\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"WriteDocumentElement Error\",\n\t\t\t\t\tmap[string]any{\"foo\": \"bar\"},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"wde error\"), ErrAfter: writeDocumentElement},\n\t\t\t\t\twriteDocumentElement,\n\t\t\t\t\terrors.New(\"wde error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"EncodeValue Error\",\n\t\t\t\t\tmap[string]any{\"foo\": \"bar\"},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"ev error\"), ErrAfter: writeString},\n\t\t\t\t\twriteString,\n\t\t\t\t\terrors.New(\"ev error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"empty map/success\",\n\t\t\t\t\tmap[string]any{},\n\t\t\t\t\t&EncodeContext{Registry: newTestRegistry()},\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\twriteDocumentEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"with interface/success\",\n\t\t\t\t\tmap[string]myInterface{\"foo\": myStruct{1}},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\tnil,\n\t\t\t\t\twriteDocumentEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"with interface/nil/success\",\n\t\t\t\t\tmap[string]myInterface{\"foo\": nil},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\tnil,\n\t\t\t\t\twriteDocumentEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"non-string key success\",\n\t\t\t\t\tmap[int]any{\n\t\t\t\t\t\t1: \"foobar\",\n\t\t\t\t\t},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\twriteDocumentEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"ArrayEncodeValue\",\n\t\t\tValueEncoderFunc(arrayEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong kind\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"ArrayEncodeValue\", Kinds: []reflect.Kind{reflect.Array}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"WriteArray Error\",\n\t\t\t\t\t[1]string{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"wa error\"), ErrAfter: writeArray},\n\t\t\t\t\twriteArray,\n\t\t\t\t\terrors.New(\"wa error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Lookup Error\",\n\t\t\t\t\t[1]int{1},\n\t\t\t\t\t&EncodeContext{Registry: newTestRegistry()},\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\twriteArray,\n\t\t\t\t\tfmt.Errorf(\"no encoder found for int\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"WriteArrayElement Error\",\n\t\t\t\t\t[1]string{\"foo\"},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"wae error\"), ErrAfter: writeArrayElement},\n\t\t\t\t\twriteArrayElement,\n\t\t\t\t\terrors.New(\"wae error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"EncodeValue Error\",\n\t\t\t\t\t[1]string{\"foo\"},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"ev error\"), ErrAfter: writeString},\n\t\t\t\t\twriteString,\n\t\t\t\t\terrors.New(\"ev error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"[1]E/success\",\n\t\t\t\t\t[1]E{{\"hello\", \"world\"}},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\tnil,\n\t\t\t\t\twriteDocumentEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"[1]E/success\",\n\t\t\t\t\t[1]E{{\"hello\", nil}},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\tnil,\n\t\t\t\t\twriteDocumentEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"[1]interface/success\",\n\t\t\t\t\t[1]myInterface{myStruct{1}},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\tnil,\n\t\t\t\t\twriteArrayEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"[1]interface/nil/success\",\n\t\t\t\t\t[1]myInterface{nil},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\tnil,\n\t\t\t\t\twriteArrayEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"SliceEncodeValue\",\n\t\t\t&sliceCodec{},\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong kind\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"SliceEncodeValue\", Kinds: []reflect.Kind{reflect.Slice}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"WriteArray Error\",\n\t\t\t\t\t[]string{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"wa error\"), ErrAfter: writeArray},\n\t\t\t\t\twriteArray,\n\t\t\t\t\terrors.New(\"wa error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Lookup Error\",\n\t\t\t\t\t[]int{1},\n\t\t\t\t\t&EncodeContext{Registry: newTestRegistry()},\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\twriteArray,\n\t\t\t\t\tfmt.Errorf(\"no encoder found for int\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"WriteArrayElement Error\",\n\t\t\t\t\t[]string{\"foo\"},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"wae error\"), ErrAfter: writeArrayElement},\n\t\t\t\t\twriteArrayElement,\n\t\t\t\t\terrors.New(\"wae error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"EncodeValue Error\",\n\t\t\t\t\t[]string{\"foo\"},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"ev error\"), ErrAfter: writeString},\n\t\t\t\t\twriteString,\n\t\t\t\t\terrors.New(\"ev error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"D/success\",\n\t\t\t\t\tD{{\"hello\", \"world\"}},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\tnil,\n\t\t\t\t\twriteDocumentEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"D/success\",\n\t\t\t\t\tD{{\"hello\", nil}},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\tnil,\n\t\t\t\t\twriteDocumentEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"empty slice/success\",\n\t\t\t\t\t[]any{},\n\t\t\t\t\t&EncodeContext{Registry: newTestRegistry()},\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\twriteArrayEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"interface/success\",\n\t\t\t\t\t[]myInterface{myStruct{1}},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\tnil,\n\t\t\t\t\twriteArrayEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"interface/success\",\n\t\t\t\t\t[]myInterface{nil},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\tnil,\n\t\t\t\t\twriteArrayEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"ObjectIDEncodeValue\",\n\t\t\tValueEncoderFunc(objectIDEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"ObjectIDEncodeValue\", Types: []reflect.Type{tOID}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"ObjectID/success\",\n\t\t\t\t\tObjectID{0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0A, 0x0B, 0x0C},\n\t\t\t\t\tnil, nil, writeObjectID, nil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"Decimal128EncodeValue\",\n\t\t\tValueEncoderFunc(decimal128EncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"Decimal128EncodeValue\", Types: []reflect.Type{tDecimal}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\"Decimal128/success\", d128, nil, nil, writeDecimal128, nil},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"JSONNumberEncodeValue\",\n\t\t\tValueEncoderFunc(jsonNumberEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"JSONNumberEncodeValue\", Types: []reflect.Type{tJSONNumber}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"json.Number/invalid\",\n\t\t\t\t\tjson.Number(\"hello world\"),\n\t\t\t\t\tnil, nil, nothing, errors.New(`strconv.ParseFloat: parsing \"hello world\": invalid syntax`),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"json.Number/int64/success\",\n\t\t\t\t\tjson.Number(\"1234567890\"),\n\t\t\t\t\tnil, nil, writeInt64, nil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"json.Number/float64/success\",\n\t\t\t\t\tjson.Number(\"3.14159\"),\n\t\t\t\t\tnil, nil, writeDouble, nil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"URLEncodeValue\",\n\t\t\tValueEncoderFunc(urlEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"URLEncodeValue\", Types: []reflect.Type{tURL}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\"url.URL\", url.URL{Scheme: \"http\", Host: \"example.com\"}, nil, nil, writeString, nil},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"ByteSliceEncodeValue\",\n\t\t\t&byteSliceCodec{},\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"ByteSliceEncodeValue\", Types: []reflect.Type{tByteSlice}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\"[]byte\", []byte{0x01, 0x02, 0x03}, nil, nil, writeBinary, nil},\n\t\t\t\t{\"[]byte/nil\", []byte(nil), nil, nil, writeNull, nil},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"EmptyInterfaceEncodeValue\",\n\t\t\t&emptyInterfaceCodec{},\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"EmptyInterfaceEncodeValue\", Types: []reflect.Type{tEmpty}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"ValueMarshalerEncodeValue\",\n\t\t\tValueEncoderFunc(valueMarshalerEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{\n\t\t\t\t\t\tName: \"ValueMarshalerEncodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tValueMarshaler},\n\t\t\t\t\t\tReceived: reflect.ValueOf(wrong),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"MarshalBSONValue error\",\n\t\t\t\t\ttestValueMarshaler{err: errors.New(\"mbsonv error\")},\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\terrors.New(\"mbsonv error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Copy error\",\n\t\t\t\t\ttestValueMarshaler{},\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tfmt.Errorf(\"cannot copy unknown BSON type %s\", Type(0)),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success struct implementation\",\n\t\t\t\t\ttestValueMarshaler{t: TypeString, buf: []byte{0x04, 0x00, 0x00, 0x00, 'f', 'o', 'o', 0x00}},\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\twriteString,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success ptr to struct implementation\",\n\t\t\t\t\t&testValueMarshaler{t: TypeString, buf: []byte{0x04, 0x00, 0x00, 0x00, 'f', 'o', 'o', 0x00}},\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\twriteString,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success nil ptr to struct implementation\",\n\t\t\t\t\tnilValueMarshaler,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\twriteNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success ptr to ptr implementation\",\n\t\t\t\t\t&testValueMarshalPtr{t: TypeString, buf: []byte{0x04, 0x00, 0x00, 0x00, 'f', 'o', 'o', 0x00}},\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\twriteString,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"unaddressable ptr implementation\",\n\t\t\t\t\ttestValueMarshalPtr{t: TypeString, buf: []byte{0x04, 0x00, 0x00, 0x00, 'f', 'o', 'o', 0x00}},\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{\n\t\t\t\t\t\tName: \"ValueMarshalerEncodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tValueMarshaler},\n\t\t\t\t\t\tReceived: reflect.ValueOf(testValueMarshalPtr{}),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"MarshalerEncodeValue\",\n\t\t\tValueEncoderFunc(marshalerEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"MarshalerEncodeValue\", Types: []reflect.Type{tMarshaler}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"MarshalBSON error\",\n\t\t\t\t\ttestMarshaler{err: errors.New(\"mbson error\")},\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\terrors.New(\"mbson error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success struct implementation\",\n\t\t\t\t\ttestMarshaler{buf: bsoncore.BuildDocument(nil, bsoncore.AppendDoubleElement(nil, \"pi\", 3.14159))},\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\twriteDocumentEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success ptr to struct implementation\",\n\t\t\t\t\t&testMarshaler{buf: bsoncore.BuildDocument(nil, bsoncore.AppendDoubleElement(nil, \"pi\", 3.14159))},\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\twriteDocumentEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success nil ptr to struct implementation\",\n\t\t\t\t\tnilMarshaler,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\twriteNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"success ptr to ptr implementation\",\n\t\t\t\t\t&testMarshalPtr{buf: bsoncore.BuildDocument(nil, bsoncore.AppendDoubleElement(nil, \"pi\", 3.14159))},\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\twriteDocumentEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"unaddressable ptr implementation\",\n\t\t\t\t\ttestMarshalPtr{buf: bsoncore.BuildDocument(nil, bsoncore.AppendDoubleElement(nil, \"pi\", 3.14159))},\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"MarshalerEncodeValue\", Types: []reflect.Type{tMarshaler}, Received: reflect.ValueOf(testMarshalPtr{})},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"PointerCodec.EncodeValue\",\n\t\t\t&pointerCodec{},\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"nil\",\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\twriteNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"not pointer\",\n\t\t\t\t\tint32(123456),\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"PointerCodec.EncodeValue\", Kinds: []reflect.Kind{reflect.Ptr}, Received: reflect.ValueOf(int32(123456))},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"typed nil\",\n\t\t\t\t\t(*int32)(nil),\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\twriteNull,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"no encoder\",\n\t\t\t\t\t&wrong,\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\terrNoEncoder{Type: reflect.TypeOf(wrong)},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"pointer implementation addressable interface\",\n\t\t\t&pointerCodec{},\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"ValueMarshaler\",\n\t\t\t\t\t&vmStruct,\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\tnil,\n\t\t\t\t\twriteDocumentEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"Marshaler\",\n\t\t\t\t\t&mStruct,\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\tnil,\n\t\t\t\t\twriteDocumentEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"JavaScriptEncodeValue\",\n\t\t\tValueEncoderFunc(javaScriptEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"JavaScriptEncodeValue\", Types: []reflect.Type{tJavaScript}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\"JavaScript\", JavaScript(\"foobar\"), nil, nil, writeJavascript, nil},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"SymbolEncodeValue\",\n\t\t\tValueEncoderFunc(symbolEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"SymbolEncodeValue\", Types: []reflect.Type{tSymbol}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\"Symbol\", Symbol(\"foobar\"), nil, nil, writeSymbol, nil},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"BinaryEncodeValue\",\n\t\t\tValueEncoderFunc(binaryEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"BinaryEncodeValue\", Types: []reflect.Type{tBinary}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\"Binary/success\", Binary{Data: []byte{0x01, 0x02}, Subtype: 0xFF}, nil, nil, writeBinaryWithSubtype, nil},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"UndefinedEncodeValue\",\n\t\t\tValueEncoderFunc(undefinedEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"UndefinedEncodeValue\", Types: []reflect.Type{tUndefined}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\"Undefined/success\", Undefined{}, nil, nil, writeUndefined, nil},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"DateTimeEncodeValue\",\n\t\t\tValueEncoderFunc(dateTimeEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"DateTimeEncodeValue\", Types: []reflect.Type{tDateTime}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\"DateTime/success\", DateTime(1234567890), nil, nil, writeDateTime, nil},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"NullEncodeValue\",\n\t\t\tValueEncoderFunc(nullEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"NullEncodeValue\", Types: []reflect.Type{tNull}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\"Null/success\", Null{}, nil, nil, writeNull, nil},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"RegexEncodeValue\",\n\t\t\tValueEncoderFunc(regexEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"RegexEncodeValue\", Types: []reflect.Type{tRegex}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\"Regex/success\", Regex{Pattern: \"foo\", Options: \"bar\"}, nil, nil, writeRegex, nil},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"DBPointerEncodeValue\",\n\t\t\tValueEncoderFunc(dbPointerEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"DBPointerEncodeValue\", Types: []reflect.Type{tDBPointer}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"DBPointer/success\",\n\t\t\t\t\tDBPointer{\n\t\t\t\t\t\tDB: \"foobar\",\n\t\t\t\t\t\tPointer: ObjectID{0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0A, 0x0B, 0x0C},\n\t\t\t\t\t},\n\t\t\t\t\tnil, nil, writeDBPointer, nil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"TimestampEncodeValue\",\n\t\t\tValueEncoderFunc(timestampEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"TimestampEncodeValue\", Types: []reflect.Type{tTimestamp}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\"Timestamp/success\", Timestamp{T: 12345, I: 67890}, nil, nil, writeTimestamp, nil},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"MinKeyEncodeValue\",\n\t\t\tValueEncoderFunc(minKeyEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"MinKeyEncodeValue\", Types: []reflect.Type{tMinKey}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\"MinKey/success\", MinKey{}, nil, nil, writeMinKey, nil},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"MaxKeyEncodeValue\",\n\t\t\tValueEncoderFunc(maxKeyEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{Name: \"MaxKeyEncodeValue\", Types: []reflect.Type{tMaxKey}, Received: reflect.ValueOf(wrong)},\n\t\t\t\t},\n\t\t\t\t{\"MaxKey/success\", MaxKey{}, nil, nil, writeMaxKey, nil},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"CoreDocumentEncodeValue\",\n\t\t\tValueEncoderFunc(coreDocumentEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{\n\t\t\t\t\t\tName: \"CoreDocumentEncodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tCoreDocument},\n\t\t\t\t\t\tReceived: reflect.ValueOf(wrong),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"WriteDocument Error\",\n\t\t\t\t\tbsoncore.Document{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"wd error\"), ErrAfter: writeDocument},\n\t\t\t\t\twriteDocument,\n\t\t\t\t\terrors.New(\"wd error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"bsoncore.Document.Elements Error\",\n\t\t\t\t\tbsoncore.Document{0xFF, 0x00, 0x00, 0x00, 0x00},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\twriteDocument,\n\t\t\t\t\terrors.New(\"length read exceeds number of bytes available. length=5 bytes=255\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"WriteDocumentElement Error\",\n\t\t\t\t\tbsoncore.Document(buildDocument(bsoncore.AppendNullElement(nil, \"foo\"))),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"wde error\"), ErrAfter: writeDocumentElement},\n\t\t\t\t\twriteDocumentElement,\n\t\t\t\t\terrors.New(\"wde error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"encodeValue error\",\n\t\t\t\t\tbsoncore.Document(buildDocument(bsoncore.AppendNullElement(nil, \"foo\"))),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"ev error\"), ErrAfter: writeNull},\n\t\t\t\t\twriteNull,\n\t\t\t\t\terrors.New(\"ev error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"iterator error\",\n\t\t\t\t\tbsoncore.Document{0x0C, 0x00, 0x00, 0x00, 0x01, 'f', 'o', 'o', 0x00, 0x01, 0x02, 0x03},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{},\n\t\t\t\t\twriteDocumentElement,\n\t\t\t\t\terrors.New(\"not enough bytes available to read type. bytes=3 type=double\"),\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"StructEncodeValue\",\n\t\t\tnewStructCodec(&mapCodec{}),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"interface value\",\n\t\t\t\t\tstruct{ Foo myInterface }{Foo: myStruct{1}},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\tnil,\n\t\t\t\t\twriteDocumentEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"nil interface value\",\n\t\t\t\t\tstruct{ Foo myInterface }{Foo: nil},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\tnil,\n\t\t\t\t\twriteDocumentEnd,\n\t\t\t\t\tnil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"CodeWithScopeEncodeValue\",\n\t\t\tValueEncoderFunc(codeWithScopeEncodeValue),\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{\n\t\t\t\t\t\tName: \"CodeWithScopeEncodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tCodeWithScope},\n\t\t\t\t\t\tReceived: reflect.ValueOf(wrong),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"WriteCodeWithScope error\",\n\t\t\t\t\tCodeWithScope{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"wcws error\"), ErrAfter: writeCodeWithScope},\n\t\t\t\t\twriteCodeWithScope,\n\t\t\t\t\terrors.New(\"wcws error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"CodeWithScope/success\",\n\t\t\t\t\tCodeWithScope{\n\t\t\t\t\t\tCode: \"var hello = 'world';\",\n\t\t\t\t\t\tScope: D{},\n\t\t\t\t\t},\n\t\t\t\t\t&EncodeContext{Registry: buildDefaultRegistry()},\n\t\t\t\t\tnil, writeDocumentEnd, nil,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"CoreArrayEncodeValue\",\n\t\t\t&arrayCodec{},\n\t\t\t[]subtest{\n\t\t\t\t{\n\t\t\t\t\t\"wrong type\",\n\t\t\t\t\twrong,\n\t\t\t\t\tnil,\n\t\t\t\t\tnil,\n\t\t\t\t\tnothing,\n\t\t\t\t\tValueEncoderError{\n\t\t\t\t\t\tName: \"CoreArrayEncodeValue\",\n\t\t\t\t\t\tTypes: []reflect.Type{tCoreArray},\n\t\t\t\t\t\tReceived: reflect.ValueOf(wrong),\n\t\t\t\t\t},\n\t\t\t\t},\n\n\t\t\t\t{\n\t\t\t\t\t\"WriteArray Error\",\n\t\t\t\t\tbsoncore.Array{},\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"wa error\"), ErrAfter: writeArray},\n\t\t\t\t\twriteArray,\n\t\t\t\t\terrors.New(\"wa error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"WriteArrayElement Error\",\n\t\t\t\t\tbsoncore.Array(buildDocumentArray(func([]byte) []byte {\n\t\t\t\t\t\treturn bsoncore.AppendNullElement(nil, \"foo\")\n\t\t\t\t\t})),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"wae error\"), ErrAfter: writeArrayElement},\n\t\t\t\t\twriteArrayElement,\n\t\t\t\t\terrors.New(\"wae error\"),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"encodeValue error\",\n\t\t\t\t\tbsoncore.Array(buildDocumentArray(func([]byte) []byte {\n\t\t\t\t\t\treturn bsoncore.AppendNullElement(nil, \"foo\")\n\t\t\t\t\t})),\n\t\t\t\t\tnil,\n\t\t\t\t\t&valueReaderWriter{Err: errors.New(\"ev error\"), ErrAfter: writeNull},\n\t\t\t\t\twriteNull,\n\t\t\t\t\terrors.New(\"ev error\"),\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t}\n\n\tfor _, tc := range testCases {\n\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\tfor _, subtest := range tc.subtests {\n\t\t\t\tt.Run(subtest.name, func(t *testing.T) {\n\t\t\t\t\tvar ec EncodeContext\n\t\t\t\t\tif subtest.ectx != nil {\n\t\t\t\t\t\tec = *subtest.ectx\n\t\t\t\t\t}\n\t\t\t\t\tllvrw := new(valueReaderWriter)\n\t\t\t\t\tif subtest.llvrw != nil {\n\t\t\t\t\t\tllvrw = subtest.llvrw\n\t\t\t\t\t}\n\t\t\t\t\tllvrw.T = t\n\t\t\t\t\terr := tc.ve.EncodeValue(ec, llvrw, reflect.ValueOf(subtest.val))\n\t\t\t\t\tif !assert.CompareErrors(err, subtest.err) {\n\t\t\t\t\t\tt.Errorf(\"Errors do not match. got %v; want %v\", err, subtest.err)\n\t\t\t\t\t}\n\t\t\t\t\tinvoked := llvrw.invoked\n\t\t\t\t\tif !cmp.Equal(invoked, subtest.invoke) {\n\t\t\t\t\t\tt.Errorf(\"Incorrect method invoked. got %v; want %v\", invoked, subtest.invoke)\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t}\n\t\t})\n\t}\n\n\tt.Run(\"success path\", func(t *testing.T) {\n\t\toid := NewObjectID()\n\t\toids := []ObjectID{NewObjectID(), NewObjectID(), NewObjectID()}\n\t\tstr := new(string)\n\t\t*str = \"bar\"\n\t\tnow := time.Now().Truncate(time.Millisecond)\n\t\tmurl, err := url.Parse(\"https://mongodb.com/random-url?hello=world\")\n\t\tif err != nil {\n\t\t\tt.Errorf(\"Error parsing URL: %v\", err)\n\t\t\tt.FailNow()\n\t\t}\n\t\tdecimal128, err := ParseDecimal128(\"1.5e10\")\n\t\tif err != nil {\n\t\t\tt.Errorf(\"Error parsing decimal128: %v\", err)\n\t\t\tt.FailNow()\n\t\t}\n\n\t\ttestCases := []struct {\n\t\t\tname string\n\t\t\tvalue any\n\t\t\tb []byte\n\t\t\terr error\n\t\t}{\n\t\t\t{\n\t\t\t\t\"map[string]int\",\n\t\t\t\tmap[string]int32{\"foo\": 1},\n\t\t\t\t[]byte{\n\t\t\t\t\t0x0E, 0x00, 0x00, 0x00,\n\t\t\t\t\t0x10, 'f', 'o', 'o', 0x00,\n\t\t\t\t\t0x01, 0x00, 0x00, 0x00,\n\t\t\t\t\t0x00,\n\t\t\t\t},\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"map[string]ObjectID\",\n\t\t\t\tmap[string]ObjectID{\"foo\": oid},\n\t\t\t\tbuildDocument(bsoncore.AppendObjectIDElement(nil, \"foo\", oid)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"map[string][]int32\",\n\t\t\t\tmap[string][]int32{\"Z\": {1, 2, 3}},\n\t\t\t\tbuildDocumentArray(func(doc []byte) []byte {\n\t\t\t\t\tdoc = bsoncore.AppendInt32Element(doc, \"0\", 1)\n\t\t\t\t\tdoc = bsoncore.AppendInt32Element(doc, \"1\", 2)\n\t\t\t\t\treturn bsoncore.AppendInt32Element(doc, \"2\", 3)\n\t\t\t\t}),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"map[string][]ObjectID\",\n\t\t\t\tmap[string][]ObjectID{\"Z\": oids},\n\t\t\t\tbuildDocumentArray(func(doc []byte) []byte {\n\t\t\t\t\tdoc = bsoncore.AppendObjectIDElement(doc, \"0\", oids[0])\n\t\t\t\t\tdoc = bsoncore.AppendObjectIDElement(doc, \"1\", oids[1])\n\t\t\t\t\treturn bsoncore.AppendObjectIDElement(doc, \"2\", oids[2])\n\t\t\t\t}),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"map[string][]json.Number(int64)\",\n\t\t\t\tmap[string][]json.Number{\"Z\": {json.Number(\"5\"), json.Number(\"10\")}},\n\t\t\t\tbuildDocumentArray(func(doc []byte) []byte {\n\t\t\t\t\tdoc = bsoncore.AppendInt64Element(doc, \"0\", 5)\n\t\t\t\t\treturn bsoncore.AppendInt64Element(doc, \"1\", 10)\n\t\t\t\t}),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"map[string][]json.Number(float64)\",\n\t\t\t\tmap[string][]json.Number{\"Z\": {json.Number(\"5\"), json.Number(\"10.1\")}},\n\t\t\t\tbuildDocumentArray(func(doc []byte) []byte {\n\t\t\t\t\tdoc = bsoncore.AppendInt64Element(doc, \"0\", 5)\n\t\t\t\t\treturn bsoncore.AppendDoubleElement(doc, \"1\", 10.1)\n\t\t\t\t}),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"map[string][]*url.URL\",\n\t\t\t\tmap[string][]*url.URL{\"Z\": {murl}},\n\t\t\t\tbuildDocumentArray(func(doc []byte) []byte {\n\t\t\t\t\treturn bsoncore.AppendStringElement(doc, \"0\", murl.String())\n\t\t\t\t}),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"map[string][]Decimal128\",\n\t\t\t\tmap[string][]Decimal128{\"Z\": {decimal128}},\n\t\t\t\tbuildDocumentArray(func(doc []byte) []byte {\n\t\t\t\t\treturn bsoncore.AppendDecimal128Element(doc, \"0\", decimal128.h, decimal128.l)\n\t\t\t\t}),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"-\",\n\t\t\t\tstruct {\n\t\t\t\t\tA string `bson:\"-\"`\n\t\t\t\t}{\n\t\t\t\t\tA: \"\",\n\t\t\t\t},\n\t\t\t\t[]byte{0x05, 0x00, 0x00, 0x00, 0x00},\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"omitempty\",\n\t\t\t\tstruct {\n\t\t\t\t\tA string `bson:\",omitempty\"`\n\t\t\t\t}{\n\t\t\t\t\tA: \"\",\n\t\t\t\t},\n\t\t\t\t[]byte{0x05, 0x00, 0x00, 0x00, 0x00},\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"omitempty, empty time\",\n\t\t\t\tstruct {\n\t\t\t\t\tA time.Time `bson:\",omitempty\"`\n\t\t\t\t}{\n\t\t\t\t\tA: time.Time{},\n\t\t\t\t},\n\t\t\t\t[]byte{0x05, 0x00, 0x00, 0x00, 0x00},\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"no private fields\",\n\t\t\t\tnoPrivateFields{a: \"should be empty\"},\n\t\t\t\t[]byte{0x05, 0x00, 0x00, 0x00, 0x00},\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"minsize\",\n\t\t\t\tstruct {\n\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t}{\n\t\t\t\t\tA: 12345,\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendInt32Element(nil, \"a\", 12345)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"inline\",\n\t\t\t\tstruct {\n\t\t\t\t\tFoo struct {\n\t\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t}{\n\t\t\t\t\tFoo: struct {\n\t\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t\t}{\n\t\t\t\t\t\tA: 12345,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendInt32Element(nil, \"a\", 12345)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"inline struct pointer\",\n\t\t\t\tstruct {\n\t\t\t\t\tFoo *struct {\n\t\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t\tBar *struct {\n\t\t\t\t\t\tB int64\n\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t}{\n\t\t\t\t\tFoo: &struct {\n\t\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t\t}{\n\t\t\t\t\t\tA: 12345,\n\t\t\t\t\t},\n\t\t\t\t\tBar: nil,\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendInt32Element(nil, \"a\", 12345)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"nested inline struct pointer\",\n\t\t\t\tstruct {\n\t\t\t\t\tFoo *struct {\n\t\t\t\t\t\tBar *struct {\n\t\t\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t}{\n\t\t\t\t\tFoo: &struct {\n\t\t\t\t\t\tBar *struct {\n\t\t\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t\t}{\n\t\t\t\t\t\tBar: &struct {\n\t\t\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t\t\t}{\n\t\t\t\t\t\t\tA: 12345,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendInt32Element(nil, \"a\", 12345)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"inline nil struct pointer\",\n\t\t\t\tstruct {\n\t\t\t\t\tFoo *struct {\n\t\t\t\t\t\tA int64 `bson:\",minsize\"`\n\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t}{\n\t\t\t\t\tFoo: nil,\n\t\t\t\t},\n\t\t\t\tbuildDocument([]byte{}),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"inline overwrite\",\n\t\t\t\tstruct {\n\t\t\t\t\tFoo struct {\n\t\t\t\t\t\tA int32\n\t\t\t\t\t\tB string\n\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t\tA int64\n\t\t\t\t}{\n\t\t\t\t\tFoo: struct {\n\t\t\t\t\t\tA int32\n\t\t\t\t\t\tB string\n\t\t\t\t\t}{\n\t\t\t\t\t\tA: 0,\n\t\t\t\t\t\tB: \"foo\",\n\t\t\t\t\t},\n\t\t\t\t\tA: 54321,\n\t\t\t\t},\n\t\t\t\tbuildDocument(func(doc []byte) []byte {\n\t\t\t\t\tdoc = bsoncore.AppendStringElement(doc, \"b\", \"foo\")\n\t\t\t\t\tdoc = bsoncore.AppendInt64Element(doc, \"a\", 54321)\n\t\t\t\t\treturn doc\n\t\t\t\t}(nil)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"inline overwrite respects ordering\",\n\t\t\t\tstruct {\n\t\t\t\t\tA int64\n\t\t\t\t\tFoo struct {\n\t\t\t\t\t\tA int32\n\t\t\t\t\t\tB string\n\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t}{\n\t\t\t\t\tA: 54321,\n\t\t\t\t\tFoo: struct {\n\t\t\t\t\t\tA int32\n\t\t\t\t\t\tB string\n\t\t\t\t\t}{\n\t\t\t\t\t\tA: 0,\n\t\t\t\t\t\tB: \"foo\",\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\tbuildDocument(func(doc []byte) []byte {\n\t\t\t\t\tdoc = bsoncore.AppendInt64Element(doc, \"a\", 54321)\n\t\t\t\t\tdoc = bsoncore.AppendStringElement(doc, \"b\", \"foo\")\n\t\t\t\t\treturn doc\n\t\t\t\t}(nil)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"inline overwrite with nested structs\",\n\t\t\t\tstruct {\n\t\t\t\t\tFoo struct {\n\t\t\t\t\t\tA int32\n\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t\tBar struct {\n\t\t\t\t\t\tA int32\n\t\t\t\t\t} `bson:\",inline\"`\n\t\t\t\t\tA int64\n\t\t\t\t}{\n\t\t\t\t\tFoo: struct {\n\t\t\t\t\t\tA int32\n\t\t\t\t\t}{},\n\t\t\t\t\tBar: struct {\n\t\t\t\t\t\tA int32\n\t\t\t\t\t}{},\n\t\t\t\t\tA: 54321,\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendInt64Element(nil, \"a\", 54321)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"inline map\",\n\t\t\t\tstruct {\n\t\t\t\t\tFoo map[string]string `bson:\",inline\"`\n\t\t\t\t}{\n\t\t\t\t\tFoo: map[string]string{\"foo\": \"bar\"},\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendStringElement(nil, \"foo\", \"bar\")),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"alternate name bson:name\",\n\t\t\t\tstruct {\n\t\t\t\t\tA string `bson:\"foo\"`\n\t\t\t\t}{\n\t\t\t\t\tA: \"bar\",\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendStringElement(nil, \"foo\", \"bar\")),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"alternate name\",\n\t\t\t\tstruct {\n\t\t\t\t\tA string `bson:\"foo\"`\n\t\t\t\t}{\n\t\t\t\t\tA: \"bar\",\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendStringElement(nil, \"foo\", \"bar\")),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"inline, omitempty\",\n\t\t\t\tstruct {\n\t\t\t\t\tA string\n\t\t\t\t\tFoo zeroTest `bson:\"omitempty,inline\"`\n\t\t\t\t}{\n\t\t\t\t\tA: \"bar\",\n\t\t\t\t\tFoo: zeroTest{true},\n\t\t\t\t},\n\t\t\t\tbuildDocument(bsoncore.AppendStringElement(nil, \"a\", \"bar\")),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"struct{}\",\n\t\t\t\tstruct {\n\t\t\t\t\tA bool\n\t\t\t\t\tB int32\n\t\t\t\t\tC int64\n\t\t\t\t\tD uint16\n\t\t\t\t\tE uint64\n\t\t\t\t\tF float64\n\t\t\t\t\tG string\n\t\t\t\t\tH map[string]string\n\t\t\t\t\tI []byte\n\t\t\t\t\tK [2]string\n\t\t\t\t\tL struct {\n\t\t\t\t\t\tM string\n\t\t\t\t\t}\n\t\t\t\t\tQ ObjectID\n\t\t\t\t\tT []struct{}\n\t\t\t\t\tY json.Number\n\t\t\t\t\tZ time.Time\n\t\t\t\t\tAA json.Number\n\t\t\t\t\tAB *url.URL\n\t\t\t\t\tAC Decimal128\n\t\t\t\t\tAD *time.Time\n\t\t\t\t\tAE testValueMarshaler\n\t\t\t\t\tAF map[string]any\n\t\t\t\t\tAG CodeWithScope\n\t\t\t\t}{\n\t\t\t\t\tA: true,\n\t\t\t\t\tB: 123,\n\t\t\t\t\tC: 456,\n\t\t\t\t\tD: 789,\n\t\t\t\t\tE: 101112,\n\t\t\t\t\tF: 3.14159,\n\t\t\t\t\tG: \"Hello, world\",\n\t\t\t\t\tH: map[string]string{\"foo\": \"bar\"},\n\t\t\t\t\tI: []byte{0x01, 0x02, 0x03},\n\t\t\t\t\tK: [2]string{\"baz\", \"qux\"},\n\t\t\t\t\tL: struct {\n\t\t\t\t\t\tM string\n\t\t\t\t\t}{\n\t\t\t\t\t\tM: \"foobar\",\n\t\t\t\t\t},\n\t\t\t\t\tQ: oid,\n\t\t\t\t\tT: nil,\n\t\t\t\t\tY: json.Number(\"5\"),\n\t\t\t\t\tZ: now,\n\t\t\t\t\tAA: json.Number(\"10.1\"),\n\t\t\t\t\tAB: murl,\n\t\t\t\t\tAC: decimal128,\n\t\t\t\t\tAD: &now,\n\t\t\t\t\tAE: testValueMarshaler{t: TypeString, buf: bsoncore.AppendString(nil, \"hello, world\")},\n\t\t\t\t\tAF: nil,\n\t\t\t\t\tAG: CodeWithScope{Code: \"var hello = 'world';\", Scope: D{{\"pi\", 3.14159}}},\n\t\t\t\t},\n\t\t\t\tbuildDocument(func(doc []byte) []byte {\n\t\t\t\t\tdoc = bsoncore.AppendBooleanElement(doc, \"a\", true)\n\t\t\t\t\tdoc = bsoncore.AppendInt32Element(doc, \"b\", 123)\n\t\t\t\t\tdoc = bsoncore.AppendInt64Element(doc, \"c\", 456)\n\t\t\t\t\tdoc = bsoncore.AppendInt32Element(doc, \"d\", 789)\n\t\t\t\t\tdoc = bsoncore.AppendInt64Element(doc, \"e\", 101112)\n\t\t\t\t\tdoc = bsoncore.AppendDoubleElement(doc, \"f\", 3.14159)\n\t\t\t\t\tdoc = bsoncore.AppendStringElement(doc, \"g\", \"Hello, world\")\n\t\t\t\t\tdoc = bsoncore.AppendDocumentElement(doc, \"h\", buildDocument(bsoncore.AppendStringElement(nil, \"foo\", \"bar\")))\n\t\t\t\t\tdoc = bsoncore.AppendBinaryElement(doc, \"i\", 0x00, []byte{0x01, 0x02, 0x03})\n\t\t\t\t\tdoc = bsoncore.AppendArrayElement(doc, \"k\",\n\t\t\t\t\t\tbuildArray(bsoncore.AppendStringElement(bsoncore.AppendStringElement(nil, \"0\", \"baz\"), \"1\", \"qux\")),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = bsoncore.AppendDocumentElement(doc, \"l\", buildDocument(bsoncore.AppendStringElement(nil, \"m\", \"foobar\")))\n\t\t\t\t\tdoc = bsoncore.AppendObjectIDElement(doc, \"q\", oid)\n\t\t\t\t\tdoc = bsoncore.AppendNullElement(doc, \"t\")\n\t\t\t\t\tdoc = bsoncore.AppendInt64Element(doc, \"y\", 5)\n\t\t\t\t\tdoc = bsoncore.AppendDateTimeElement(doc, \"z\", now.UnixNano()/int64(time.Millisecond))\n\t\t\t\t\tdoc = bsoncore.AppendDoubleElement(doc, \"aa\", 10.1)\n\t\t\t\t\tdoc = bsoncore.AppendStringElement(doc, \"ab\", murl.String())\n\t\t\t\t\tdoc = bsoncore.AppendDecimal128Element(doc, \"ac\", decimal128.h, decimal128.l)\n\t\t\t\t\tdoc = bsoncore.AppendDateTimeElement(doc, \"ad\", now.UnixNano()/int64(time.Millisecond))\n\t\t\t\t\tdoc = bsoncore.AppendStringElement(doc, \"ae\", \"hello, world\")\n\t\t\t\t\tdoc = bsoncore.AppendNullElement(doc, \"af\")\n\t\t\t\t\tdoc = bsoncore.AppendCodeWithScopeElement(doc, \"ag\",\n\t\t\t\t\t\t\"var hello = 'world';\", buildDocument(bsoncore.AppendDoubleElement(nil, \"pi\", 3.14159)),\n\t\t\t\t\t)\n\t\t\t\t\treturn doc\n\t\t\t\t}(nil)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"struct{[]any}\",\n\t\t\t\tstruct {\n\t\t\t\t\tA []bool\n\t\t\t\t\tB []int32\n\t\t\t\t\tC []int64\n\t\t\t\t\tD []uint16\n\t\t\t\t\tE []uint64\n\t\t\t\t\tF []float64\n\t\t\t\t\tG []string\n\t\t\t\t\tH []map[string]string\n\t\t\t\t\tI [][]byte\n\t\t\t\t\tK [1][2]string\n\t\t\t\t\tL []struct {\n\t\t\t\t\t\tM string\n\t\t\t\t\t}\n\t\t\t\t\tN [][]string\n\t\t\t\t\tR []ObjectID\n\t\t\t\t\tT []struct{}\n\t\t\t\t\tW []map[string]struct{}\n\t\t\t\t\tX []map[string]struct{}\n\t\t\t\t\tY []map[string]struct{}\n\t\t\t\t\tZ []time.Time\n\t\t\t\t\tAA []json.Number\n\t\t\t\t\tAB []*url.URL\n\t\t\t\t\tAC []Decimal128\n\t\t\t\t\tAD []*time.Time\n\t\t\t\t\tAE []testValueMarshaler\n\t\t\t\t}{\n\t\t\t\t\tA: []bool{true},\n\t\t\t\t\tB: []int32{123},\n\t\t\t\t\tC: []int64{456},\n\t\t\t\t\tD: []uint16{789},\n\t\t\t\t\tE: []uint64{101112},\n\t\t\t\t\tF: []float64{3.14159},\n\t\t\t\t\tG: []string{\"Hello, world\"},\n\t\t\t\t\tH: []map[string]string{{\"foo\": \"bar\"}},\n\t\t\t\t\tI: [][]byte{{0x01, 0x02, 0x03}},\n\t\t\t\t\tK: [1][2]string{{\"baz\", \"qux\"}},\n\t\t\t\t\tL: []struct {\n\t\t\t\t\t\tM string\n\t\t\t\t\t}{\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tM: \"foobar\",\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t\tN: [][]string{{\"foo\", \"bar\"}},\n\t\t\t\t\tR: oids,\n\t\t\t\t\tT: nil,\n\t\t\t\t\tW: nil,\n\t\t\t\t\tX: []map[string]struct{}{}, // Should be empty BSON Array\n\t\t\t\t\tY: []map[string]struct{}{{}}, // Should be BSON array with one element, an empty BSON SubDocument\n\t\t\t\t\tZ: []time.Time{now, now},\n\t\t\t\t\tAA: []json.Number{json.Number(\"5\"), json.Number(\"10.1\")},\n\t\t\t\t\tAB: []*url.URL{murl},\n\t\t\t\t\tAC: []Decimal128{decimal128},\n\t\t\t\t\tAD: []*time.Time{&now, &now},\n\t\t\t\t\tAE: []testValueMarshaler{\n\t\t\t\t\t\t{t: TypeString, buf: bsoncore.AppendString(nil, \"hello\")},\n\t\t\t\t\t\t{t: TypeString, buf: bsoncore.AppendString(nil, \"world\")},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\tbuildDocument(func(doc []byte) []byte {\n\t\t\t\t\tdoc = appendArrayElement(doc, \"a\", bsoncore.AppendBooleanElement(nil, \"0\", true))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"b\", bsoncore.AppendInt32Element(nil, \"0\", 123))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"c\", bsoncore.AppendInt64Element(nil, \"0\", 456))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"d\", bsoncore.AppendInt32Element(nil, \"0\", 789))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"e\", bsoncore.AppendInt64Element(nil, \"0\", 101112))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"f\", bsoncore.AppendDoubleElement(nil, \"0\", 3.14159))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"g\", bsoncore.AppendStringElement(nil, \"0\", \"Hello, world\"))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"h\", bsoncore.BuildDocumentElement(nil, \"0\", bsoncore.AppendStringElement(nil, \"foo\", \"bar\")))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"i\", bsoncore.AppendBinaryElement(nil, \"0\", 0x00, []byte{0x01, 0x02, 0x03}))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"k\",\n\t\t\t\t\t\tappendArrayElement(nil, \"0\",\n\t\t\t\t\t\t\tbsoncore.AppendStringElement(bsoncore.AppendStringElement(nil, \"0\", \"baz\"), \"1\", \"qux\")),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = appendArrayElement(doc, \"l\", bsoncore.BuildDocumentElement(nil, \"0\", bsoncore.AppendStringElement(nil, \"m\", \"foobar\")))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"n\",\n\t\t\t\t\t\tappendArrayElement(nil, \"0\",\n\t\t\t\t\t\t\tbsoncore.AppendStringElement(bsoncore.AppendStringElement(nil, \"0\", \"foo\"), \"1\", \"bar\")),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = appendArrayElement(doc, \"r\",\n\t\t\t\t\t\tbsoncore.AppendObjectIDElement(\n\t\t\t\t\t\t\tbsoncore.AppendObjectIDElement(\n\t\t\t\t\t\t\t\tbsoncore.AppendObjectIDElement(nil,\n\t\t\t\t\t\t\t\t\t\"0\", oids[0]),\n\t\t\t\t\t\t\t\t\"1\", oids[1]),\n\t\t\t\t\t\t\t\"2\", oids[2]),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = bsoncore.AppendNullElement(doc, \"t\")\n\t\t\t\t\tdoc = bsoncore.AppendNullElement(doc, \"w\")\n\t\t\t\t\tdoc = appendArrayElement(doc, \"x\", nil)\n\t\t\t\t\tdoc = appendArrayElement(doc, \"y\", bsoncore.BuildDocumentElement(nil, \"0\", nil))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"z\",\n\t\t\t\t\t\tbsoncore.AppendDateTimeElement(\n\t\t\t\t\t\t\tbsoncore.AppendDateTimeElement(\n\t\t\t\t\t\t\t\tnil, \"0\", now.UnixNano()/int64(time.Millisecond)),\n\t\t\t\t\t\t\t\"1\", now.UnixNano()/int64(time.Millisecond)),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = appendArrayElement(doc, \"aa\", bsoncore.AppendDoubleElement(bsoncore.AppendInt64Element(nil, \"0\", 5), \"1\", 10.10))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"ab\", bsoncore.AppendStringElement(nil, \"0\", murl.String()))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"ac\", bsoncore.AppendDecimal128Element(nil, \"0\", decimal128.h, decimal128.l))\n\t\t\t\t\tdoc = appendArrayElement(doc, \"ad\",\n\t\t\t\t\t\tbsoncore.AppendDateTimeElement(\n\t\t\t\t\t\t\tbsoncore.AppendDateTimeElement(nil, \"0\", now.UnixNano()/int64(time.Millisecond)),\n\t\t\t\t\t\t\t\"1\", now.UnixNano()/int64(time.Millisecond)),\n\t\t\t\t\t)\n\t\t\t\t\tdoc = appendArrayElement(doc, \"ae\",\n\t\t\t\t\t\tbsoncore.AppendStringElement(bsoncore.AppendStringElement(nil, \"0\", \"hello\"), \"1\", \"world\"),\n\t\t\t\t\t)\n\t\t\t\t\treturn doc\n\t\t\t\t}(nil)),\n\t\t\t\tnil,\n\t\t\t},\n\t\t}\n\n\t\tfor _, tc := range testCases {\n\t\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\t\tb := make(sliceWriter, 0, 512)\n\t\t\t\tvw := NewDocumentWriter(&b)\n\t\t\t\treg := buildDefaultRegistry()\n\t\t\t\tenc, err := reg.LookupEncoder(reflect.TypeOf(tc.value))\n\t\t\t\tnoerr(t, err)\n\t\t\t\terr = enc.EncodeValue(EncodeContext{Registry: reg}, vw, reflect.ValueOf(tc.value))\n\t\t\t\tif !errors.Is(err, tc.err) {\n\t\t\t\t\tt.Errorf(\"Did not receive expected error. got %v; want %v\", err, tc.err)\n\t\t\t\t}\n\t\t\t\tif diff := cmp.Diff([]byte(b), tc.b); diff != \"\" {\n\t\t\t\t\tt.Errorf(\"Bytes written differ: (-got +want)\\n%s\", diff)\n\t\t\t\t\tt.Errorf(\"Bytes\\ngot: %v\\nwant:%v\\n\", b, tc.b)\n\t\t\t\t\tt.Errorf(\"Readers\\ngot: %v\\nwant:%v\\n\", bsoncore.Document(b), bsoncore.Document(tc.b))\n\t\t\t\t}\n\t\t\t})\n\t\t}\n\t})\n\n\tt.Run(\"error path\", func(t *testing.T) {\n\t\ttestCases := []struct {\n\t\t\tname string\n\t\t\tvalue any\n\t\t\terr error\n\t\t}{\n\t\t\t{\n\t\t\t\t\"duplicate name struct\",\n\t\t\t\tstruct {\n\t\t\t\t\tA int64\n\t\t\t\t\tB int64 `bson:\"a\"`\n\t\t\t\t}{\n\t\t\t\t\tA: 0,\n\t\t\t\t\tB: 54321,\n\t\t\t\t},\n\t\t\t\tfmt.Errorf(\"duplicated key a\"),\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"inline map\",\n\t\t\t\tstruct {\n\t\t\t\t\tFoo map[string]string `bson:\",inline\"`\n\t\t\t\t\tBaz string\n\t\t\t\t}{\n\t\t\t\t\tFoo: map[string]string{\"baz\": \"bar\"},\n\t\t\t\t\tBaz: \"hi\",\n\t\t\t\t},\n\t\t\t\tfmt.Errorf(\"Key baz of inlined map conflicts with a struct field name\"),\n\t\t\t},\n\t\t}\n\n\t\tfor _, tc := range testCases {\n\t\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\t\tb := make(sliceWriter, 0, 512)\n\t\t\t\tvw := NewDocumentWriter(&b)\n\t\t\t\treg := buildDefaultRegistry()\n\t\t\t\tenc, err := reg.LookupEncoder(reflect.TypeOf(tc.value))\n\t\t\t\tnoerr(t, err)\n\t\t\t\terr = enc.EncodeValue(EncodeContext{Registry: reg}, vw, reflect.ValueOf(tc.value))\n\t\t\t\tif err == nil || !strings.Contains(err.Error(), tc.err.Error()) {\n\t\t\t\t\tt.Errorf(\"Did not receive expected error. got %v; want %v\", err, tc.err)\n\t\t\t\t}\n\t\t\t})\n\t\t}\n\t})\n\n\tt.Run(\"EmptyInterfaceEncodeValue/nil\", func(t *testing.T) {\n\t\tval := reflect.New(tEmpty).Elem()\n\t\tllvrw := new(valueReaderWriter)\n\t\terr := (&emptyInterfaceCodec{}).EncodeValue(EncodeContext{Registry: newTestRegistry()}, llvrw, val)\n\t\tnoerr(t, err)\n\t\tif llvrw.invoked != writeNull {\n\t\t\tt.Errorf(\"Incorrect method called. got %v; want %v\", llvrw.invoked, writeNull)\n\t\t}\n\t})\n\n\tt.Run(\"EmptyInterfaceEncodeValue/LookupEncoder error\", func(t *testing.T) {\n\t\tval := reflect.New(tEmpty).Elem()\n\t\tval.Set(reflect.ValueOf(int64(1234567890)))\n\t\tllvrw := new(valueReaderWriter)\n\t\tgot := (&emptyInterfaceCodec{}).EncodeValue(EncodeContext{Registry: newTestRegistry()}, llvrw, val)\n\t\twant := errNoEncoder{Type: tInt64}\n\t\tif !assert.CompareErrors(got, want) {\n\t\t\tt.Errorf(\"Did not receive expected error. got %v; want %v\", got, want)\n\t\t}\n\t})\n}\n\ntype testValueMarshalPtr struct {\n\tt Type\n\tbuf []byte\n\terr error\n}\n\nfunc (tvm *testValueMarshalPtr) MarshalBSONValue() (byte, []byte, error) {\n\treturn byte(tvm.t), tvm.buf, tvm.err\n}\n\ntype testMarshalPtr struct {\n\tbuf []byte\n\terr error\n}\n\nfunc (tvm *testMarshalPtr) MarshalBSON() ([]byte, error) {\n\treturn tvm.buf, tvm.err\n}\n" }, { "path": "bson/doc.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\n// Package bson is a library for reading, writing, and manipulating BSON. BSON is a binary serialization\n// format used to store documents and make remote procedure calls in MongoDB. For more information about\n// the Go BSON library, including usage examples, check out the [Work with BSON] page in the Go Driver\n// docs site. For more information about BSON, see https://bsonspec.org.\n//\n// # Native Go Types\n//\n// The [D] and [M] types defined in this package can be used to build representations of BSON using native Go types. D is a\n// slice and M is a map. For more information about the use cases for these types, see the documentation on the type\n// definitions.\n//\n// Note that a D should not be constructed with duplicate key names, as that can cause undefined server behavior.\n//\n// Example:\n//\n//\tbson.D{{\"foo\", \"bar\"}, {\"hello\", \"world\"}, {\"pi\", 3.14159}}\n//\tbson.M{\"foo\": \"bar\", \"hello\": \"world\", \"pi\": 3.14159}\n//\n// When decoding BSON to a D or M, the following type mappings apply when unmarshaling:\n//\n// 1. BSON int32 unmarshals to an int32.\n// 2. BSON int64 unmarshals to an int64.\n// 3. BSON double unmarshals to a float64.\n// 4. BSON string unmarshals to a string.\n// 5. BSON boolean unmarshals to a bool.\n// 6. BSON embedded document unmarshals to the parent type (i.e. D for a D, M for an M).\n// 7. BSON array unmarshals to a bson.A.\n// 8. BSON ObjectId unmarshals to a bson.ObjectID.\n// 9. BSON datetime unmarshals to a bson.DateTime.\n// 10. BSON binary unmarshals to a bson.Binary.\n// 11. BSON regular expression unmarshals to a bson.Regex.\n// 12. BSON JavaScript unmarshals to a bson.JavaScript.\n// 13. BSON code with scope unmarshals to a bson.CodeWithScope.\n// 14. BSON timestamp unmarshals to an bson.Timestamp.\n// 15. BSON 128-bit decimal unmarshals to an bson.Decimal128.\n// 16. BSON min key unmarshals to an bson.MinKey.\n// 17. BSON max key unmarshals to an bson.MaxKey.\n// 18. BSON undefined unmarshals to a bson.Undefined.\n// 19. BSON null unmarshals to nil.\n// 20. BSON DBPointer unmarshals to a bson.DBPointer.\n// 21. BSON symbol unmarshals to a bson.Symbol.\n//\n// The above mappings also apply when marshaling a D or M to BSON. Some other useful marshaling mappings are:\n//\n// 1. time.Time marshals to a BSON datetime.\n// 2. int8, int16, and int32 marshal to a BSON int32.\n// 3. int marshals to a BSON int32 if the value is between math.MinInt32 and math.MaxInt32, inclusive, and a BSON int64\n// otherwise.\n// 4. int64 marshals to BSON int64 (unless [Encoder.IntMinSize] is set).\n// 5. uint8 and uint16 marshal to a BSON int32.\n// 6. uint, uint32, and uint64 marshal to a BSON int64 (unless [Encoder.IntMinSize] is set).\n// 7. BSON null and undefined values will unmarshal into the zero value of a field (e.g. unmarshaling a BSON null or\n// undefined value into a string will yield the empty string.).\n//\n// # Structs\n//\n// Structs can be marshaled/unmarshaled to/from BSON or Extended JSON. When transforming structs to/from BSON or Extended\n// JSON, the following rules apply:\n//\n// 1. Only exported fields in structs will be marshaled or unmarshaled.\n//\n// 2. When marshaling a struct, each field will be lowercased to generate the key for the corresponding BSON element.\n// For example, a struct field named \"Foo\" will generate key \"foo\". This can be overridden via a struct tag (e.g.\n// `bson:\"fooField\"` to generate key \"fooField\" instead).\n//\n// 3. An embedded struct field is marshaled as a subdocument. The key will be the lowercased name of the field's type.\n//\n// 4. A pointer field is marshaled as the underlying type if the pointer is non-nil. If the pointer is nil, it is\n// marshaled as a BSON null value.\n//\n// 5. When unmarshaling, a field of type any will follow the D/M type mappings listed above. BSON documents\n// unmarshaled into an any field will be unmarshaled as a D.\n//\n// The encoding of each struct field can be customized by the \"bson\" struct tag. The \"bson\" tag gives the name of the\n// field, followed by a comma-separated list of options. The name may be omitted in order to specify options without\n// overriding the default field name. The following options can be used to configure behavior:\n//\n// 1. omitempty: If the \"omitempty\" struct tag is specified on a field, the field will not be marshaled if it is set to\n// an \"empty\" value. Numbers, booleans, and strings are considered empty if their value is equal to the zero value for\n// the type (i.e. 0 for numbers, false for booleans, and \"\" for strings). Slices, maps, and arrays are considered\n// empty if they are of length zero. Interfaces and pointers are considered empty if their value is nil. By default,\n// structs are only considered empty if the struct type implements [Zeroer] and the \"IsZero\"\n// method returns true. Struct types that do not implement [Zeroer] are never considered empty and will be\n// marshaled as embedded documents. NOTE: It is recommended that this tag be used for all slice and map fields.\n//\n// 2. minsize: If the minsize struct tag is specified on a field of type int64, uint, uint32, or uint64 and the value of\n// the field can fit in a signed int32, the field will be serialized as a BSON int32 rather than a BSON int64. For\n// other types, this tag is ignored.\n//\n// 3. truncate: If the truncate struct tag is specified on a field with a non-float numeric type, BSON doubles\n// unmarshaled into that field will be truncated at the decimal point. For example, if 3.14 is unmarshaled into a\n// field of type int, it will be unmarshaled as 3. If this tag is not specified, the decoder will throw an error if\n// the value cannot be decoded without losing precision. For float64 or non-numeric types, this tag is ignored.\n//\n// 4. inline: If the inline struct tag is specified for a struct or map field, the field will be \"flattened\" when\n// marshaling and \"un-flattened\" when unmarshaling. This means that all of the fields in that struct/map will be\n// pulled up one level and will become top-level fields rather than being fields in a nested document. For example,\n// if a map field named \"Map\" with value map[string]any{\"foo\": \"bar\"} is inlined, the resulting document will\n// be {\"foo\": \"bar\"} instead of {\"map\": {\"foo\": \"bar\"}}. There can only be one inlined map field in a struct. If\n// there are duplicated fields in the resulting document when an inlined struct is marshaled, the inlined field will\n// be overwritten. If there are duplicated fields in the resulting document when an inlined map is marshaled, an\n// error will be returned. This tag can be used with fields that are pointers to structs. If an inlined pointer field\n// is nil, it will not be marshaled. For fields that are not maps or structs, this tag is ignored.\n//\n// # Raw BSON\n//\n// The Raw family of types is used to validate and retrieve elements from a slice of bytes. This\n// type is most useful when you want do lookups on BSON bytes without unmarshaling it into another\n// type.\n//\n// Example:\n//\n//\tvar raw bson.Raw = ... // bytes from somewhere\n//\terr := raw.Validate()\n//\tif err != nil { return err }\n//\tval := raw.Lookup(\"foo\")\n//\ti32, ok := val.Int32OK()\n//\t// do something with i32...\n//\n// # Custom Registry\n//\n// The Go BSON library uses a [Registry] to define encoding and decoding behavior for different data types.\n// The default encoding and decoding behavior can be customized or extended by using a modified Registry.\n// The custom registry system is composed of two parts:\n//\n// 1) [ValueEncoder] and [ValueDecoder] that handle encoding and decoding Go values to and from BSON\n// representations.\n//\n// 2) A [Registry] that holds these ValueEncoders and ValueDecoders and provides methods for\n// retrieving them.\n//\n// To use a custom Registry, use [Encoder.SetRegistry] or [Decoder.SetRegistry].\n//\n// [Work with BSON]: https://www.mongodb.com/docs/drivers/go/current/fundamentals/bson/\npackage bson\n" }, { "path": "bson/empty_interface_codec.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"reflect\"\n)\n\n// emptyInterfaceCodec is the Codec used for any values.\ntype emptyInterfaceCodec struct {\n\t// decodeBinaryAsSlice causes DecodeValue to unmarshal BSON binary field values that are the\n\t// \"Generic\" or \"Old\" BSON binary subtype as a Go byte slice instead of a Binary.\n\tdecodeBinaryAsSlice bool\n}\n\n// Assert that emptyInterfaceCodec satisfies the typeDecoder interface, which allows it\n// to be used by collection type decoders (e.g. map, slice, etc) to set individual values in a\n// collection.\nvar _ typeDecoder = &emptyInterfaceCodec{}\n\n// EncodeValue is the ValueEncoderFunc for any.\nfunc (eic *emptyInterfaceCodec) EncodeValue(ec EncodeContext, vw ValueWriter, val reflect.Value) error {\n\tif !val.IsValid() || val.Type() != tEmpty {\n\t\treturn ValueEncoderError{Name: \"EmptyInterfaceEncodeValue\", Types: []reflect.Type{tEmpty}, Received: val}\n\t}\n\n\tif val.IsNil() {\n\t\treturn vw.WriteNull()\n\t}\n\tencoder, err := ec.LookupEncoder(val.Elem().Type())\n\tif err != nil {\n\t\treturn err\n\t}\n\n\treturn encoder.EncodeValue(ec, vw, val.Elem())\n}\n\nfunc (eic *emptyInterfaceCodec) getEmptyInterfaceDecodeType(dc DecodeContext, valueType Type) (reflect.Type, error) {\n\tisDocument := valueType == Type(0) || valueType == TypeEmbeddedDocument\n\tif isDocument {\n\t\tif dc.defaultDocumentType != nil {\n\t\t\t// If the bsontype is an embedded document and the DocumentType is set on the DecodeContext, then return\n\t\t\t// that type.\n\t\t\treturn dc.defaultDocumentType, nil\n\t\t}\n\t}\n\n\trtype, err := dc.LookupTypeMapEntry(valueType)\n\tif err == nil {\n\t\treturn rtype, nil\n\t}\n\n\tif isDocument {\n\t\t// For documents, fallback to looking up a type map entry for Type(0) or TypeEmbeddedDocument,\n\t\t// depending on the original valueType.\n\t\tvar lookupType Type\n\t\tswitch valueType {\n\t\tcase Type(0):\n\t\t\tlookupType = TypeEmbeddedDocument\n\t\tcase TypeEmbeddedDocument:\n\t\t\tlookupType = Type(0)\n\t\t}\n\n\t\trtype, err = dc.LookupTypeMapEntry(lookupType)\n\t\tif err == nil {\n\t\t\treturn rtype, nil\n\t\t}\n\t\t// fallback to bson.D\n\t\treturn tD, nil\n\t}\n\n\treturn nil, err\n}\n\nfunc (eic *emptyInterfaceCodec) decodeType(dc DecodeContext, vr ValueReader, t reflect.Type) (reflect.Value, error) {\n\tif t != tEmpty {\n\t\treturn emptyValue, ValueDecoderError{Name: \"EmptyInterfaceDecodeValue\", Types: []reflect.Type{tEmpty}, Received: reflect.Zero(t)}\n\t}\n\n\trtype, err := eic.getEmptyInterfaceDecodeType(dc, vr.Type())\n\tif err != nil {\n\t\tswitch vr.Type() {\n\t\tcase TypeNull:\n\t\t\treturn reflect.Zero(t), vr.ReadNull()\n\t\tdefault:\n\t\t\treturn emptyValue, err\n\t\t}\n\t}\n\n\tdecoder, err := dc.LookupDecoder(rtype)\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\telem, err := decodeTypeOrValueWithInfo(decoder, dc, vr, rtype)\n\tif err != nil {\n\t\treturn emptyValue, err\n\t}\n\n\tif (eic.decodeBinaryAsSlice || dc.binaryAsSlice) && rtype == tBinary {\n\t\tbinElem := elem.Interface().(Binary)\n\t\tif binElem.Subtype == TypeBinaryGeneric || binElem.Subtype == TypeBinaryBinaryOld {\n\t\t\telem = reflect.ValueOf(binElem.Data)\n\t\t}\n\t}\n\n\treturn elem, nil\n}\n\n// DecodeValue is the ValueDecoderFunc for any.\nfunc (eic *emptyInterfaceCodec) DecodeValue(dc DecodeContext, vr ValueReader, val reflect.Value) error {\n\tif !val.CanSet() || val.Type() != tEmpty {\n\t\treturn ValueDecoderError{Name: \"EmptyInterfaceDecodeValue\", Types: []reflect.Type{tEmpty}, Received: val}\n\t}\n\n\telem, err := eic.decodeType(dc, vr, val.Type())\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tval.Set(elem)\n\treturn nil\n}\n" }, { "path": "bson/encoder.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"reflect\"\n\t\"sync\"\n)\n\n// This pool is used to keep the allocations of Encoders down. This is only used for the Marshal*\n// methods and is not consumable from outside of this package. The Encoders retrieved from this pool\n// must have both Reset and SetRegistry called on them.\nvar encPool = sync.Pool{\n\tNew: func() any {\n\t\treturn new(Encoder)\n\t},\n}\n\n// An Encoder writes a serialization format to an output stream. It writes to a ValueWriter\n// as the destination of BSON data.\ntype Encoder struct {\n\tec EncodeContext\n\tvw ValueWriter\n}\n\n// NewEncoder returns a new encoder that writes to vw.\nfunc NewEncoder(vw ValueWriter) *Encoder {\n\treturn &Encoder{\n\t\tec: EncodeContext{Registry: defaultRegistry},\n\t\tvw: vw,\n\t}\n}\n\n// Encode writes the BSON encoding of val to the stream.\n//\n// See [Marshal] for details about BSON marshaling behavior.\nfunc (e *Encoder) Encode(val any) error {\n\tif marshaler, ok := val.(Marshaler); ok {\n\t\t// TODO(skriptble): Should we have a MarshalAppender interface so that we can have []byte reuse?\n\t\tbuf, err := marshaler.MarshalBSON()\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\treturn copyDocumentFromBytes(e.vw, buf)\n\t}\n\n\tencoder, err := e.ec.LookupEncoder(reflect.TypeOf(val))\n\tif err != nil {\n\t\treturn err\n\t}\n\n\treturn encoder.EncodeValue(e.ec, e.vw, reflect.ValueOf(val))\n}\n\n// Reset will reset the state of the Encoder, using the same *EncodeContext used in\n// the original construction but using vw.\nfunc (e *Encoder) Reset(vw ValueWriter) {\n\te.vw = vw\n}\n\n// SetRegistry replaces the current registry of the Encoder with r.\nfunc (e *Encoder) SetRegistry(r *Registry) {\n\te.ec.Registry = r\n}\n\n// ErrorOnInlineDuplicates causes the Encoder to return an error if there is a duplicate field in\n// the marshaled BSON when the \"inline\" struct tag option is set.\nfunc (e *Encoder) ErrorOnInlineDuplicates() {\n\te.ec.errorOnInlineDuplicates = true\n}\n\n// IntMinSize causes the Encoder to marshal Go integer values (int, int8, int16, int32, int64, uint,\n// uint8, uint16, uint32, or uint64) as the minimum BSON int size (either 32 or 64 bits) that can\n// represent the integer value.\nfunc (e *Encoder) IntMinSize() {\n\te.ec.minSize = true\n}\n\n// StringifyMapKeysWithFmt causes the Encoder to convert Go map keys to BSON document field name\n// strings using fmt.Sprint instead of the default string conversion logic.\nfunc (e *Encoder) StringifyMapKeysWithFmt() {\n\te.ec.stringifyMapKeysWithFmt = true\n}\n\n// NilMapAsEmpty causes the Encoder to marshal nil Go maps as empty BSON documents instead of BSON\n// null.\nfunc (e *Encoder) NilMapAsEmpty() {\n\te.ec.nilMapAsEmpty = true\n}\n\n// NilSliceAsEmpty causes the Encoder to marshal nil Go slices as empty BSON arrays instead of BSON\n// null.\nfunc (e *Encoder) NilSliceAsEmpty() {\n\te.ec.nilSliceAsEmpty = true\n}\n\n// NilByteSliceAsEmpty causes the Encoder to marshal nil Go byte slices as empty BSON binary values\n// instead of BSON null.\nfunc (e *Encoder) NilByteSliceAsEmpty() {\n\te.ec.nilByteSliceAsEmpty = true\n}\n\n// TODO(GODRIVER-2820): Update the description to remove the note about only examining exported\n// TODO struct fields once the logic is updated to also inspect private struct fields.\n\n// OmitZeroStruct causes the Encoder to consider the zero value for a struct (e.g. MyStruct{})\n// as empty and omit it from the marshaled BSON when the \"omitempty\" struct tag option is set\n// or the OmitEmpty() method is called.\n//\n// Note that the Encoder only examines exported struct fields when determining if a struct is the\n// zero value. It considers pointers to a zero struct value (e.g. &MyStruct{}) not empty.\nfunc (e *Encoder) OmitZeroStruct() {\n\te.ec.omitZeroStruct = true\n}\n\n// OmitEmpty causes the Encoder to omit empty values from the marshaled BSON as the \"omitempty\"\n// struct tag option is set.\nfunc (e *Encoder) OmitEmpty() {\n\te.ec.omitEmpty = true\n}\n\n// UseJSONStructTags causes the Encoder to fall back to using the \"json\" struct tag if a \"bson\"\n// struct tag is not specified.\nfunc (e *Encoder) UseJSONStructTags() {\n\te.ec.useJSONStructTags = true\n}\n" }, { "path": "bson/encoder_example_test.go", "content": "// Copyright (C) MongoDB, Inc. 2023-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson_test\n\nimport (\n\t\"bytes\"\n\t\"errors\"\n\t\"fmt\"\n\t\"io\"\n\n\t\"go.mongodb.org/mongo-driver/v2/bson\"\n)\n\nfunc ExampleEncoder() {\n\t// Create an Encoder that writes BSON values to a bytes.Buffer.\n\tbuf := new(bytes.Buffer)\n\tvw := bson.NewDocumentWriter(buf)\n\tencoder := bson.NewEncoder(vw)\n\n\ttype Product struct {\n\t\tName string `bson:\"name\"`\n\t\tSKU string `bson:\"sku\"`\n\t\tPrice int64 `bson:\"price_cents\"`\n\t}\n\n\t// Use the Encoder to marshal a BSON document that contains the name, SKU,\n\t// and price (in cents) of a product.\n\tproduct := Product{\n\t\tName: \"Cereal Rounds\",\n\t\tSKU: \"AB12345\",\n\t\tPrice: 399,\n\t}\n\terr := encoder.Encode(product)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\t// Print the BSON document as Extended JSON by converting it to bson.Raw.\n\tfmt.Println(bson.Raw(buf.Bytes()).String())\n\t// Output: {\"name\": \"Cereal Rounds\",\"sku\": \"AB12345\",\"price_cents\": {\"$numberLong\":\"399\"}}\n}\n\ntype CityState struct {\n\tCity string\n\tState string\n}\n\nfunc (k CityState) String() string {\n\treturn fmt.Sprintf(\"%s, %s\", k.City, k.State)\n}\n\nfunc ExampleEncoder_StringifyMapKeysWithFmt() {\n\t// Create an Encoder that writes BSON values to a bytes.Buffer.\n\tbuf := new(bytes.Buffer)\n\tvw := bson.NewDocumentWriter(buf)\n\tencoder := bson.NewEncoder(vw)\n\n\t// Configure the Encoder to convert Go map keys to BSON document field names\n\t// using fmt.Sprintf instead of the default string conversion logic.\n\tencoder.StringifyMapKeysWithFmt()\n\n\t// Use the Encoder to marshal a BSON document that contains is a map of\n\t// city and state to a list of zip codes in that city.\n\tzipCodes := map[CityState][]int{\n\t\t{City: \"New York\", State: \"NY\"}: {10001, 10301, 10451},\n\t}\n\terr := encoder.Encode(zipCodes)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\t// Print the BSON document as Extended JSON by converting it to bson.Raw.\n\tfmt.Println(bson.Raw(buf.Bytes()).String())\n\t// Output: {\"New York, NY\": [{\"$numberInt\":\"10001\"},{\"$numberInt\":\"10301\"},{\"$numberInt\":\"10451\"}]}\n}\n\nfunc ExampleEncoder_UseJSONStructTags() {\n\t// Create an Encoder that writes BSON values to a bytes.Buffer.\n\tbuf := new(bytes.Buffer)\n\tvw := bson.NewDocumentWriter(buf)\n\tencoder := bson.NewEncoder(vw)\n\n\ttype Product struct {\n\t\tName string `json:\"name\"`\n\t\tSKU string `json:\"sku\"`\n\t\tPrice int64 `json:\"price_cents\"`\n\t}\n\n\t// Configure the Encoder to use \"json\" struct tags when decoding if \"bson\"\n\t// struct tags are not present.\n\tencoder.UseJSONStructTags()\n\n\t// Use the Encoder to marshal a BSON document that contains the name, SKU,\n\t// and price (in cents) of a product.\n\tproduct := Product{\n\t\tName: \"Cereal Rounds\",\n\t\tSKU: \"AB12345\",\n\t\tPrice: 399,\n\t}\n\terr := encoder.Encode(product)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\t// Print the BSON document as Extended JSON by converting it to bson.Raw.\n\tfmt.Println(bson.Raw(buf.Bytes()).String())\n\t// Output: {\"name\": \"Cereal Rounds\",\"sku\": \"AB12345\",\"price_cents\": {\"$numberLong\":\"399\"}}\n}\n\nfunc ExampleEncoder_multipleBSONDocuments() {\n\t// Create an Encoder that writes BSON values to a bytes.Buffer.\n\tbuf := new(bytes.Buffer)\n\tvw := bson.NewDocumentWriter(buf)\n\tencoder := bson.NewEncoder(vw)\n\n\ttype Coordinate struct {\n\t\tX int\n\t\tY int\n\t}\n\n\t// Use the encoder to marshal 5 Coordinate values as a sequence of BSON\n\t// documents.\n\tfor i := 0; i < 5; i++ {\n\t\terr := encoder.Encode(Coordinate{\n\t\t\tX: i,\n\t\t\tY: i + 1,\n\t\t})\n\t\tif err != nil {\n\t\t\tpanic(err)\n\t\t}\n\t}\n\n\t// Read each marshaled BSON document from the buffer and print them as\n\t// Extended JSON by converting them to bson.Raw.\n\tfor {\n\t\tdoc, err := bson.ReadDocument(buf)\n\t\tif errors.Is(err, io.EOF) {\n\t\t\treturn\n\t\t}\n\t\tif err != nil {\n\t\t\tpanic(err)\n\t\t}\n\t\tfmt.Println(doc.String())\n\t}\n\t// Output:\n\t// {\"x\": {\"$numberInt\":\"0\"},\"y\": {\"$numberInt\":\"1\"}}\n\t// {\"x\": {\"$numberInt\":\"1\"},\"y\": {\"$numberInt\":\"2\"}}\n\t// {\"x\": {\"$numberInt\":\"2\"},\"y\": {\"$numberInt\":\"3\"}}\n\t// {\"x\": {\"$numberInt\":\"3\"},\"y\": {\"$numberInt\":\"4\"}}\n\t// {\"x\": {\"$numberInt\":\"4\"},\"y\": {\"$numberInt\":\"5\"}}\n}\n\nfunc ExampleEncoder_extendedJSON() {\n\t// Create an Encoder that writes canonical Extended JSON values to a\n\t// bytes.Buffer.\n\tbuf := new(bytes.Buffer)\n\tvw := bson.NewExtJSONValueWriter(buf, true, false)\n\tencoder := bson.NewEncoder(vw)\n\n\ttype Product struct {\n\t\tName string `bson:\"name\"`\n\t\tSKU string `bson:\"sku\"`\n\t\tPrice int64 `bson:\"price_cents\"`\n\t}\n\n\t// Use the Encoder to marshal a BSON document that contains the name, SKU,\n\t// and price (in cents) of a product.\n\tproduct := Product{\n\t\tName: \"Cereal Rounds\",\n\t\tSKU: \"AB12345\",\n\t\tPrice: 399,\n\t}\n\terr := encoder.Encode(product)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tfmt.Println(buf.String())\n\t// Output: {\"name\":\"Cereal Rounds\",\"sku\":\"AB12345\",\"price_cents\":{\"$numberLong\":\"399\"}}\n}\n\nfunc ExampleEncoder_multipleExtendedJSONDocuments() {\n\t// Create an Encoder that writes canonical Extended JSON values to a\n\t// bytes.Buffer.\n\tbuf := new(bytes.Buffer)\n\tvw := bson.NewExtJSONValueWriter(buf, true, false)\n\tencoder := bson.NewEncoder(vw)\n\n\ttype Coordinate struct {\n\t\tX int\n\t\tY int\n\t}\n\n\t// Use the encoder to marshal 5 Coordinate values as a sequence of Extended\n\t// JSON documents.\n\tfor i := 0; i < 5; i++ {\n\t\terr := encoder.Encode(Coordinate{\n\t\t\tX: i,\n\t\t\tY: i + 1,\n\t\t})\n\t\tif err != nil {\n\t\t\tpanic(err)\n\t\t}\n\t}\n\n\tfmt.Println(buf.String())\n\t// Output:\n\t// {\"x\":{\"$numberInt\":\"0\"},\"y\":{\"$numberInt\":\"1\"}}\n\t// {\"x\":{\"$numberInt\":\"1\"},\"y\":{\"$numberInt\":\"2\"}}\n\t// {\"x\":{\"$numberInt\":\"2\"},\"y\":{\"$numberInt\":\"3\"}}\n\t// {\"x\":{\"$numberInt\":\"3\"},\"y\":{\"$numberInt\":\"4\"}}\n\t// {\"x\":{\"$numberInt\":\"4\"},\"y\":{\"$numberInt\":\"5\"}}\n}\n\nfunc ExampleEncoder_IntMinSize() {\n\t// Create an encoder that will marshal integers as the minimum BSON int size\n\t// (either 32 or 64 bits) that can represent the integer value.\n\ttype foo struct {\n\t\tBar uint32\n\t}\n\n\tbuf := new(bytes.Buffer)\n\tvw := bson.NewDocumentWriter(buf)\n\n\tenc := bson.NewEncoder(vw)\n\tenc.IntMinSize()\n\n\terr := enc.Encode(foo{2})\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tfmt.Println(bson.Raw(buf.Bytes()).String())\n\t// Output:\n\t// {\"bar\": {\"$numberInt\":\"2\"}}\n}\n" }, { "path": "bson/encoder_test.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"bytes\"\n\t\"errors\"\n\t\"reflect\"\n\t\"testing\"\n\t\"time\"\n\n\t\"go.mongodb.org/mongo-driver/v2/internal/assert\"\n\t\"go.mongodb.org/mongo-driver/v2/internal/require\"\n\t\"go.mongodb.org/mongo-driver/v2/x/bsonx/bsoncore\"\n)\n\nfunc TestBasicEncode(t *testing.T) {\n\tfor _, tc := range marshalingTestCases {\n\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\tgot := make(sliceWriter, 0, 1024)\n\t\t\tvw := NewDocumentWriter(&got)\n\t\t\treg := defaultRegistry\n\t\t\tencoder, err := reg.LookupEncoder(reflect.TypeOf(tc.val))\n\t\t\tnoerr(t, err)\n\t\t\terr = encoder.EncodeValue(EncodeContext{Registry: reg}, vw, reflect.ValueOf(tc.val))\n\t\t\tnoerr(t, err)\n\n\t\t\tif !bytes.Equal(got, tc.want) {\n\t\t\t\tt.Errorf(\"Bytes are not equal. got %v; want %v\", got, tc.want)\n\t\t\t\tt.Errorf(\"Bytes:\\n%v\\n%v\", got, tc.want)\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc TestEncoderEncode(t *testing.T) {\n\tfor _, tc := range marshalingTestCases {\n\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\tgot := make(sliceWriter, 0, 1024)\n\t\t\tvw := NewDocumentWriter(&got)\n\t\t\tenc := NewEncoder(vw)\n\t\t\terr := enc.Encode(tc.val)\n\t\t\tnoerr(t, err)\n\n\t\t\tif !bytes.Equal(got, tc.want) {\n\t\t\t\tt.Errorf(\"Bytes are not equal. got %v; want %v\", got, tc.want)\n\t\t\t\tt.Errorf(\"Bytes:\\n%v\\n%v\", got, tc.want)\n\t\t\t}\n\t\t})\n\t}\n\n\tt.Run(\"Marshaler\", func(t *testing.T) {\n\t\ttestCases := []struct {\n\t\t\tname string\n\t\t\tbuf []byte\n\t\t\terr error\n\t\t\twanterr error\n\t\t\tvw ValueWriter\n\t\t}{\n\t\t\t{\n\t\t\t\t\"error\",\n\t\t\t\tnil,\n\t\t\t\terrors.New(\"Marshaler error\"),\n\t\t\t\terrors.New(\"Marshaler error\"),\n\t\t\t\t&valueReaderWriter{},\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"copy error\",\n\t\t\t\t[]byte{0x05, 0x00, 0x00, 0x00, 0x00},\n\t\t\t\tnil,\n\t\t\t\terrors.New(\"copy error\"),\n\t\t\t\t&valueReaderWriter{Err: errors.New(\"copy error\"), ErrAfter: writeDocument},\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"success\",\n\t\t\t\t[]byte{0x07, 0x00, 0x00, 0x00, 0x0A, 0x00, 0x00},\n\t\t\t\tnil,\n\t\t\t\tnil,\n\t\t\t\tnil,\n\t\t\t},\n\t\t}\n\n\t\tfor _, tc := range testCases {\n\t\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\t\tmarshaler := testMarshaler{buf: tc.buf, err: tc.err}\n\n\t\t\t\tvar vw ValueWriter\n\t\t\t\tb := make(sliceWriter, 0, 100)\n\t\t\t\tcompareVW := false\n\t\t\t\tif tc.vw != nil {\n\t\t\t\t\tvw = tc.vw\n\t\t\t\t} else {\n\t\t\t\t\tcompareVW = true\n\t\t\t\t\tvw = NewDocumentWriter(&b)\n\t\t\t\t}\n\t\t\t\tenc := NewEncoder(vw)\n\t\t\t\tgot := enc.Encode(marshaler)\n\t\t\t\twant := tc.wanterr\n\t\t\t\tif !assert.CompareErrors(got, want) {\n\t\t\t\t\tt.Errorf(\"Did not receive expected error. got %v; want %v\", got, want)\n\t\t\t\t}\n\t\t\t\tif compareVW {\n\t\t\t\t\tbuf := b\n\t\t\t\t\tif !bytes.Equal(buf, tc.buf) {\n\t\t\t\t\t\tt.Errorf(\"Copied bytes do not match. got %v; want %v\", buf, tc.buf)\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t})\n\t\t}\n\t})\n}\n\ntype testMarshaler struct {\n\tbuf []byte\n\terr error\n}\n\nfunc (tm testMarshaler) MarshalBSON() ([]byte, error) { return tm.buf, tm.err }\n\nfunc docToBytes(d any) []byte {\n\tb, err := Marshal(d)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treturn b\n}\n\ntype stringerTest struct{}\n\nfunc (stringerTest) String() string {\n\treturn \"test key\"\n}\n\nfunc TestEncoderConfiguration(t *testing.T) {\n\ttype inlineDuplicateInner struct {\n\t\tDuplicate string\n\t}\n\n\ttype inlineDuplicateOuter struct {\n\t\tInline inlineDuplicateInner `bson:\",inline\"`\n\t\tDuplicate string\n\t}\n\n\ttype zeroStruct struct {\n\t\tMyString string\n\t}\n\n\ttestCases := []struct {\n\t\tdescription string\n\t\tconfigure func(*Encoder)\n\t\tinput any\n\t\twant []byte\n\t\twantErr error\n\t}{\n\t\t// Test that ErrorOnInlineDuplicates causes the Encoder to return an error if there are any\n\t\t// duplicate fields in the marshaled document caused by using the \"inline\" struct tag.\n\t\t{\n\t\t\tdescription: \"ErrorOnInlineDuplicates\",\n\t\t\tconfigure: func(enc *Encoder) {\n\t\t\t\tenc.ErrorOnInlineDuplicates()\n\t\t\t},\n\t\t\tinput: inlineDuplicateOuter{\n\t\t\t\tInline: inlineDuplicateInner{Duplicate: \"inner\"},\n\t\t\t\tDuplicate: \"outer\",\n\t\t\t},\n\t\t\twantErr: errors.New(\"struct bson.inlineDuplicateOuter has duplicated key duplicate\"),\n\t\t},\n\t\t// Test that IntMinSize encodes Go int and int64 values as BSON int32 if the value is small\n\t\t// enough.\n\t\t{\n\t\t\tdescription: \"IntMinSize\",\n\t\t\tconfigure: func(enc *Encoder) {\n\t\t\t\tenc.IntMinSize()\n\t\t\t},\n\t\t\tinput: D{\n\t\t\t\t{Key: \"myInt\", Value: int(1)},\n\t\t\t\t{Key: \"myInt64\", Value: int64(1)},\n\t\t\t\t{Key: \"myUint\", Value: uint(1)},\n\t\t\t\t{Key: \"myUint32\", Value: uint32(1)},\n\t\t\t\t{Key: \"myUint64\", Value: uint64(1)},\n\t\t\t},\n\t\t\twant: bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendInt32(\"myInt\", 1).\n\t\t\t\tAppendInt32(\"myInt64\", 1).\n\t\t\t\tAppendInt32(\"myUint\", 1).\n\t\t\t\tAppendInt32(\"myUint32\", 1).\n\t\t\t\tAppendInt32(\"myUint64\", 1).\n\t\t\t\tBuild(),\n\t\t},\n\t\t// Test that StringifyMapKeysWithFmt uses fmt.Sprint to convert map keys to BSON field names.\n\t\t{\n\t\t\tdescription: \"StringifyMapKeysWithFmt\",\n\t\t\tconfigure: func(enc *Encoder) {\n\t\t\t\tenc.StringifyMapKeysWithFmt()\n\t\t\t},\n\t\t\tinput: map[stringerTest]string{\n\t\t\t\t{}: \"test value\",\n\t\t\t},\n\t\t\twant: bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendString(\"test key\", \"test value\").\n\t\t\t\tBuild(),\n\t\t},\n\t\t// Test that NilMapAsEmpty encodes nil Go maps as empty BSON documents.\n\t\t{\n\t\t\tdescription: \"NilMapAsEmpty\",\n\t\t\tconfigure: func(enc *Encoder) {\n\t\t\t\tenc.NilMapAsEmpty()\n\t\t\t},\n\t\t\tinput: D{{Key: \"myMap\", Value: map[string]string(nil)}},\n\t\t\twant: bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendDocument(\"myMap\", bsoncore.NewDocumentBuilder().Build()).\n\t\t\t\tBuild(),\n\t\t},\n\t\t// Test that NilSliceAsEmpty encodes nil Go slices as empty BSON arrays.\n\t\t{\n\t\t\tdescription: \"NilSliceAsEmpty\",\n\t\t\tconfigure: func(enc *Encoder) {\n\t\t\t\tenc.NilSliceAsEmpty()\n\t\t\t},\n\t\t\tinput: D{{Key: \"mySlice\", Value: []string(nil)}},\n\t\t\twant: bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendArray(\"mySlice\", bsoncore.NewArrayBuilder().Build()).\n\t\t\t\tBuild(),\n\t\t},\n\t\t// Test that NilByteSliceAsEmpty encodes nil Go byte slices as empty BSON binary elements.\n\t\t{\n\t\t\tdescription: \"NilByteSliceAsEmpty\",\n\t\t\tconfigure: func(enc *Encoder) {\n\t\t\t\tenc.NilByteSliceAsEmpty()\n\t\t\t},\n\t\t\tinput: D{{Key: \"myBytes\", Value: []byte(nil)}},\n\t\t\twant: bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendBinary(\"myBytes\", TypeBinaryGeneric, []byte{}).\n\t\t\t\tBuild(),\n\t\t},\n\t\t// Test that OmitZeroStruct omits empty structs from the marshaled document if the\n\t\t// \"omitempty\" struct tag is used.\n\t\t{\n\t\t\tdescription: \"OmitZeroStruct\",\n\t\t\tconfigure: func(enc *Encoder) {\n\t\t\t\tenc.OmitZeroStruct()\n\t\t\t},\n\t\t\tinput: struct {\n\t\t\t\tZero zeroStruct `bson:\",omitempty\"`\n\t\t\t}{},\n\t\t\twant: bsoncore.NewDocumentBuilder().Build(),\n\t\t},\n\t\t// Test that OmitZeroStruct omits empty structs from the marshaled document if\n\t\t// OmitEmpty is also set.\n\t\t{\n\t\t\tdescription: \"OmitEmpty with non-zeroer struct\",\n\t\t\tconfigure: func(enc *Encoder) {\n\t\t\t\tenc.OmitZeroStruct()\n\t\t\t\tenc.OmitEmpty()\n\t\t\t},\n\t\t\tinput: struct {\n\t\t\t\tZero zeroStruct\n\t\t\t}{},\n\t\t\twant: bsoncore.NewDocumentBuilder().Build(),\n\t\t},\n\t\t// Test that OmitEmpty omits empty values from the marshaled document.\n\t\t{\n\t\t\tdescription: \"OmitEmpty\",\n\t\t\tconfigure: func(enc *Encoder) {\n\t\t\t\tenc.OmitEmpty()\n\t\t\t},\n\t\t\tinput: struct {\n\t\t\t\tZero zeroTest\n\t\t\t\tI64 int64\n\t\t\t\tF64 float64\n\t\t\t\tString string\n\t\t\t\tBoolean bool\n\t\t\t\tSlice []int\n\t\t\t\tArray [0]int\n\t\t\t\tMap map[string]int\n\t\t\t\tBytes []byte\n\t\t\t\tTime time.Time\n\t\t\t\tPointer *int\n\t\t\t}{\n\t\t\t\tZero: zeroTest{true},\n\t\t\t},\n\t\t\twant: bsoncore.NewDocumentBuilder().Build(),\n\t\t},\n\t\t// Test that UseJSONStructTags causes the Encoder to fall back to \"json\" struct tags if\n\t\t// \"bson\" struct tags are not available.\n\t\t{\n\t\t\tdescription: \"UseJSONStructTags\",\n\t\t\tconfigure: func(enc *Encoder) {\n\t\t\t\tenc.UseJSONStructTags()\n\t\t\t},\n\t\t\tinput: struct {\n\t\t\t\tStructFieldName string `json:\"jsonFieldName\"`\n\t\t\t}{\n\t\t\t\tStructFieldName: \"test value\",\n\t\t\t},\n\t\t\twant: bsoncore.NewDocumentBuilder().\n\t\t\t\tAppendString(\"jsonFieldName\", \"test value\").\n\t\t\t\tBuild(),\n\t\t},\n\t}\n\n\tfor _, tc := range testCases {\n\t\ttc := tc // Capture range variable.\n\n\t\tt.Run(tc.description, func(t *testing.T) {\n\t\t\tt.Parallel()\n\n\t\t\tgot := new(bytes.Buffer)\n\t\t\tvw := NewDocumentWriter(got)\n\t\t\tenc := NewEncoder(vw)\n\n\t\t\ttc.configure(enc)\n\n\t\t\terr := enc.Encode(tc.input)\n\t\t\tif tc.wantErr != nil {\n\t\t\t\tassert.Equal(t, tc.wantErr, err, \"expected and actual errors do not match\")\n\t\t\t\treturn\n\t\t\t}\n\t\t\trequire.NoError(t, err, \"Encode error\")\n\n\t\t\tassert.Equal(t, tc.want, got.Bytes(), \"expected and actual encoded BSON do not match\")\n\n\t\t\t// After we compare the raw bytes, also decode the expected and actual BSON as a bson.D\n\t\t\t// and compare them. The goal is to make assertion failures easier to debug because\n\t\t\t// binary diffs are very difficult to understand.\n\t\t\tvar wantDoc D\n\t\t\terr = Unmarshal(tc.want, &wantDoc)\n\t\t\trequire.NoError(t, err, \"Unmarshal error\")\n\t\t\tvar gotDoc D\n\t\t\terr = Unmarshal(got.Bytes(), &gotDoc)\n\t\t\trequire.NoError(t, err, \"Unmarshal error\")\n\n\t\t\tassert.Equal(t, wantDoc, gotDoc, \"expected and actual decoded documents do not match\")\n\t\t})\n\t}\n}\n" }, { "path": "bson/example_test.go", "content": "// Copyright (C) MongoDB, Inc. 2023-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson_test\n\nimport (\n\t\"fmt\"\n\t\"time\"\n\n\t\"go.mongodb.org/mongo-driver/v2/bson\"\n)\n\n// This example uses Raw to skip parsing a nested document in a BSON message.\nfunc ExampleRaw_unmarshal() {\n\tb, err := bson.Marshal(bson.M{\n\t\t\"Word\": \"beach\",\n\t\t\"Synonyms\": bson.A{\"coast\", \"shore\", \"waterfront\"},\n\t})\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tvar res struct {\n\t\tWord string\n\t\tSynonyms bson.Raw // Don't parse the whole list, we just want to count the elements.\n\t}\n\n\terr = bson.Unmarshal(b, &res)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\telems, err := res.Synonyms.Elements()\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Printf(\"%s, synonyms count: %d\\n\", res.Word, len(elems))\n\n\t// Output: beach, synonyms count: 3\n}\n\n// This example uses Raw to add a precomputed BSON document during marshal.\nfunc ExampleRaw_marshal() {\n\tprecomputed, err := bson.Marshal(bson.M{\"Precomputed\": true})\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tmsg := struct {\n\t\tMessage string\n\t\tMetadata bson.Raw\n\t}{\n\t\tMessage: \"Hello World!\",\n\t\tMetadata: precomputed,\n\t}\n\n\tb, err := bson.Marshal(msg)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\t// Print the Extended JSON by converting BSON to bson.Raw.\n\tfmt.Println(bson.Raw(b).String())\n\n\t// Output: {\"message\": \"Hello World!\",\"metadata\": {\"Precomputed\": true}}\n}\n\n// This example uses RawValue to delay parsing a value in a BSON message.\nfunc ExampleRawValue_unmarshal() {\n\tb1, err := bson.Marshal(bson.M{\n\t\t\"Format\": \"UNIX\",\n\t\t\"Timestamp\": 1675282389,\n\t})\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tb2, err := bson.Marshal(bson.M{\n\t\t\"Format\": \"RFC3339\",\n\t\t\"Timestamp\": time.Unix(1675282389, 0).Format(time.RFC3339),\n\t})\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tfor _, b := range [][]byte{b1, b2} {\n\t\tvar res struct {\n\t\t\tFormat string\n\t\t\tTimestamp bson.RawValue // Delay parsing until we know the timestamp format.\n\t\t}\n\n\t\terr = bson.Unmarshal(b, &res)\n\t\tif err != nil {\n\t\t\tpanic(err)\n\t\t}\n\n\t\tvar t time.Time\n\t\tswitch res.Format {\n\t\tcase \"UNIX\":\n\t\t\tt = time.Unix(res.Timestamp.AsInt64(), 0)\n\t\tcase \"RFC3339\":\n\t\t\tt, err = time.Parse(time.RFC3339, res.Timestamp.StringValue())\n\t\t\tif err != nil {\n\t\t\t\tpanic(err)\n\t\t\t}\n\t\t}\n\t\tfmt.Println(res.Format, t.Unix())\n\t}\n\n\t// Output:\n\t// UNIX 1675282389\n\t// RFC3339 1675282389\n}\n\n// This example uses RawValue to add a precomputed BSON string value during marshal.\nfunc ExampleRawValue_marshal() {\n\tt, val, err := bson.MarshalValue(\"Precomputed message!\")\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tprecomputed := bson.RawValue{\n\t\tType: t,\n\t\tValue: val,\n\t}\n\n\tmsg := struct {\n\t\tMessage bson.RawValue\n\t\tTime time.Time\n\t}{\n\t\tMessage: precomputed,\n\t\tTime: time.Unix(1675282389, 0),\n\t}\n\n\tb, err := bson.Marshal(msg)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\t// Print the Extended JSON by converting BSON to bson.Raw.\n\tfmt.Println(bson.Raw(b).String())\n\n\t// Output: {\"message\": \"Precomputed message!\",\"time\": {\"$date\":{\"$numberLong\":\"1675282389000\"}}}\n}\n" }, { "path": "bson/extjson_parser.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"encoding/base64\"\n\t\"encoding/hex\"\n\t\"errors\"\n\t\"fmt\"\n\t\"io\"\n\t\"strings\"\n)\n\nconst maxNestingDepth = 200\n\n// ErrInvalidJSON indicates the JSON input is invalid\nvar ErrInvalidJSON = errors.New(\"invalid JSON input\")\n\ntype jsonParseState byte\n\nconst (\n\tjpsStartState jsonParseState = iota\n\tjpsSawBeginObject\n\tjpsSawEndObject\n\tjpsSawBeginArray\n\tjpsSawEndArray\n\tjpsSawColon\n\tjpsSawComma\n\tjpsSawKey\n\tjpsSawValue\n\tjpsDoneState\n\tjpsInvalidState\n)\n\ntype jsonParseMode byte\n\nconst (\n\tjpmInvalidMode jsonParseMode = iota\n\tjpmObjectMode\n\tjpmArrayMode\n)\n\ntype extJSONValue struct {\n\tt Type\n\tv any\n}\n\ntype extJSONObject struct {\n\tkeys []string\n\tvalues []*extJSONValue\n}\n\ntype extJSONParser struct {\n\tjs *jsonScanner\n\ts jsonParseState\n\tm []jsonParseMode\n\tk string\n\tv *extJSONValue\n\n\terr error\n\tcanonicalOnly bool\n\tdepth int\n\tmaxDepth int\n\n\temptyObject bool\n\trelaxedUUID bool\n}\n\n// newExtJSONParser returns a new extended JSON parser, ready to to begin\n// parsing from the first character of the argued json input. It will not\n// perform any read-ahead and will therefore not report any errors about\n// malformed JSON at this point.\nfunc newExtJSONParser(r io.Reader, canonicalOnly bool) *extJSONParser {\n\treturn &extJSONParser{\n\t\tjs: &jsonScanner{r: r},\n\t\ts: jpsStartState,\n\t\tm: []jsonParseMode{},\n\t\tcanonicalOnly: canonicalOnly,\n\t\tmaxDepth: maxNestingDepth,\n\t}\n}\n\n// peekType examines the next value and returns its BSON Type\nfunc (ejp *extJSONParser) peekType() (Type, error) {\n\tvar t Type\n\tvar err error\n\tinitialState := ejp.s\n\n\tejp.advanceState()\n\tswitch ejp.s {\n\tcase jpsSawValue:\n\t\tt = ejp.v.t\n\tcase jpsSawBeginArray:\n\t\tt = TypeArray\n\tcase jpsInvalidState:\n\t\terr = ejp.err\n\tcase jpsSawComma:\n\t\t// in array mode, seeing a comma means we need to progress again to actually observe a type\n\t\tif ejp.peekMode() == jpmArrayMode {\n\t\t\treturn ejp.peekType()\n\t\t}\n\tcase jpsSawEndArray:\n\t\t// this would only be a valid state if we were in array mode, so return end-of-array error\n\t\terr = ErrEOA\n\tcase jpsSawBeginObject:\n\t\t// peek key to determine type\n\t\tejp.advanceState()\n\t\tswitch ejp.s {\n\t\tcase jpsSawEndObject: // empty embedded document\n\t\t\tt = TypeEmbeddedDocument\n\t\t\tejp.emptyObject = true\n\t\tcase jpsInvalidState:\n\t\t\terr = ejp.err\n\t\tcase jpsSawKey:\n\t\t\tif initialState == jpsStartState {\n\t\t\t\treturn TypeEmbeddedDocument, nil\n\t\t\t}\n\t\t\tt = wrapperKeyBSONType(ejp.k)\n\n\t\t\t// if $uuid is encountered, parse as binary subtype 4\n\t\t\tif ejp.k == \"$uuid\" {\n\t\t\t\tejp.relaxedUUID = true\n\t\t\t\tt = TypeBinary\n\t\t\t}\n\n\t\t\tswitch t {\n\t\t\tcase TypeJavaScript:\n\t\t\t\t// just saw $code, need to check for $scope at same level\n\t\t\t\t_, err = ejp.readValue(TypeJavaScript)\n\t\t\t\tif err != nil {\n\t\t\t\t\tbreak\n\t\t\t\t}\n\n\t\t\t\tswitch ejp.s {\n\t\t\t\tcase jpsSawEndObject: // type is TypeJavaScript\n\t\t\t\tcase jpsSawComma:\n\t\t\t\t\tejp.advanceState()\n\n\t\t\t\t\tif ejp.s == jpsSawKey && ejp.k == \"$scope\" {\n\t\t\t\t\t\tt = TypeCodeWithScope\n\t\t\t\t\t} else {\n\t\t\t\t\t\terr = fmt.Errorf(\"invalid extended JSON: unexpected key %s in CodeWithScope object\", ejp.k)\n\t\t\t\t\t}\n\t\t\t\tcase jpsInvalidState:\n\t\t\t\t\terr = ejp.err\n\t\t\t\tdefault:\n\t\t\t\t\terr = ErrInvalidJSON\n\t\t\t\t}\n\t\t\tcase TypeCodeWithScope:\n\t\t\t\terr = errors.New(\"invalid extended JSON: code with $scope must contain $code before $scope\")\n\t\t\t}\n\t\t}\n\t}\n\n\treturn t, err\n}\n\n// readKey parses the next key and its type and returns them\nfunc (ejp *extJSONParser) readKey() (string, Type, error) {\n\tif ejp.emptyObject {\n\t\tejp.emptyObject = false\n\t\treturn \"\", 0, ErrEOD\n\t}\n\n\t// advance to key (or return with error)\n\tswitch ejp.s {\n\tcase jpsStartState:\n\t\tejp.advanceState()\n\t\tif ejp.s == jpsSawBeginObject {\n\t\t\tejp.advanceState()\n\t\t}\n\tcase jpsSawBeginObject:\n\t\tejp.advanceState()\n\tcase jpsSawValue, jpsSawEndObject, jpsSawEndArray:\n\t\tejp.advanceState()\n\t\tswitch ejp.s {\n\t\tcase jpsSawBeginObject, jpsSawComma:\n\t\t\tejp.advanceState()\n\t\tcase jpsSawEndObject:\n\t\t\treturn \"\", 0, ErrEOD\n\t\tcase jpsDoneState:\n\t\t\treturn \"\", 0, io.EOF\n\t\tcase jpsInvalidState:\n\t\t\treturn \"\", 0, ejp.err\n\t\tdefault:\n\t\t\treturn \"\", 0, ErrInvalidJSON\n\t\t}\n\tcase jpsSawKey: // do nothing (key was peeked before)\n\tdefault:\n\t\treturn \"\", 0, invalidRequestError(\"key\")\n\t}\n\n\t// read key\n\tvar key string\n\n\tswitch ejp.s {\n\tcase jpsSawKey:\n\t\tkey = ejp.k\n\tcase jpsSawEndObject:\n\t\treturn \"\", 0, ErrEOD\n\tcase jpsInvalidState:\n\t\treturn \"\", 0, ejp.err\n\tdefault:\n\t\treturn \"\", 0, invalidRequestError(\"key\")\n\t}\n\n\t// check for colon\n\tejp.advanceState()\n\tif err := ensureColon(ejp.s, key); err != nil {\n\t\treturn \"\", 0, err\n\t}\n\n\t// peek at the value to determine type\n\tt, err := ejp.peekType()\n\tif err != nil {\n\t\treturn \"\", 0, err\n\t}\n\n\treturn key, t, nil\n}\n\n// readValue returns the value corresponding to the Type returned by peekType\nfunc (ejp *extJSONParser) readValue(t Type) (*extJSONValue, error) {\n\tif ejp.s == jpsInvalidState {\n\t\treturn nil, ejp.err\n\t}\n\n\tvar v *extJSONValue\n\n\tswitch t {\n\tcase TypeNull, TypeBoolean, TypeString:\n\t\tif ejp.s != jpsSawValue {\n\t\t\treturn nil, invalidRequestError(t.String())\n\t\t}\n\t\tv = ejp.v\n\tcase TypeInt32, TypeInt64, TypeDouble:\n\t\t// relaxed version allows these to be literal number values\n\t\tif ejp.s == jpsSawValue {\n\t\t\tv = ejp.v\n\t\t\tbreak\n\t\t}\n\t\tfallthrough\n\tcase TypeDecimal128, TypeSymbol, TypeObjectID, TypeMinKey, TypeMaxKey, TypeUndefined:\n\t\tswitch ejp.s {\n\t\tcase jpsSawKey:\n\t\t\t// read colon\n\t\t\tejp.advanceState()\n\t\t\tif err := ensureColon(ejp.s, ejp.k); err != nil {\n\t\t\t\treturn nil, err\n\t\t\t}\n\n\t\t\t// read value\n\t\t\tejp.advanceState()\n\t\t\tif ejp.s != jpsSawValue || !ejp.ensureExtValueType(t) {\n\t\t\t\treturn nil, invalidJSONErrorForType(\"value\", t)\n\t\t\t}\n\n\t\t\tv = ejp.v\n\n\t\t\t// read end object\n\t\t\tejp.advanceState()\n\t\t\tif ejp.s != jpsSawEndObject {\n\t\t\t\treturn nil, invalidJSONErrorForType(\"} after value\", t)\n\t\t\t}\n\t\tdefault:\n\t\t\treturn nil, invalidRequestError(t.String())\n\t\t}\n\tcase TypeBinary, TypeRegex, TypeTimestamp, TypeDBPointer:\n\t\tif ejp.s != jpsSawKey {\n\t\t\treturn nil, invalidRequestError(t.String())\n\t\t}\n\t\t// read colon\n\t\tejp.advanceState()\n\t\tif err := ensureColon(ejp.s, ejp.k); err != nil {\n\t\t\treturn nil, err\n\t\t}\n\n\t\tejp.advanceState()\n\t\tif t == TypeBinary && ejp.s == jpsSawValue {\n\t\t\t// convert relaxed $uuid format\n\t\t\tif ejp.relaxedUUID {\n\t\t\t\tdefer func() { ejp.relaxedUUID = false }()\n\t\t\t\tuuid, err := ejp.v.parseSymbol()\n\t\t\t\tif err != nil {\n\t\t\t\t\treturn nil, err\n\t\t\t\t}\n\n\t\t\t\t// RFC 4122 defines the length of a UUID as 36 and the hyphens in a UUID as appearing\n\t\t\t\t// in the 8th, 13th, 18th, and 23rd characters.\n\t\t\t\t//\n\t\t\t\t// See https://tools.ietf.org/html/rfc4122#section-3\n\t\t\t\tvalid := len(uuid) == 36 &&\n\t\t\t\t\tstring(uuid[8]) == \"-\" &&\n\t\t\t\t\tstring(uuid[13]) == \"-\" &&\n\t\t\t\t\tstring(uuid[18]) == \"-\" &&\n\t\t\t\t\tstring(uuid[23]) == \"-\"\n\t\t\t\tif !valid {\n\t\t\t\t\treturn nil, fmt.Errorf(\"$uuid value does not follow RFC 4122 format regarding length and hyphens\")\n\t\t\t\t}\n\n\t\t\t\t// remove hyphens\n\t\t\t\tuuidNoHyphens := strings.ReplaceAll(uuid, \"-\", \"\")\n\t\t\t\tif len(uuidNoHyphens) != 32 {\n\t\t\t\t\treturn nil, fmt.Errorf(\"$uuid value does not follow RFC 4122 format regarding length and hyphens\")\n\t\t\t\t}\n\n\t\t\t\t// convert hex to bytes\n\t\t\t\tbytes, err := hex.DecodeString(uuidNoHyphens)\n\t\t\t\tif err != nil {\n\t\t\t\t\treturn nil, fmt.Errorf(\"$uuid value does not follow RFC 4122 format regarding hex bytes: %w\", err)\n\t\t\t\t}\n\n\t\t\t\tejp.advanceState()\n\t\t\t\tif ejp.s != jpsSawEndObject {\n\t\t\t\t\treturn nil, invalidJSONErrorForType(\"$uuid and value and then }\", TypeBinary)\n\t\t\t\t}\n\n\t\t\t\tbase64 := &extJSONValue{\n\t\t\t\t\tt: TypeString,\n\t\t\t\t\tv: base64.StdEncoding.EncodeToString(bytes),\n\t\t\t\t}\n\t\t\t\tsubType := &extJSONValue{\n\t\t\t\t\tt: TypeString,\n\t\t\t\t\tv: \"04\",\n\t\t\t\t}\n\n\t\t\t\tv = &extJSONValue{\n\t\t\t\t\tt: TypeEmbeddedDocument,\n\t\t\t\t\tv: &extJSONObject{\n\t\t\t\t\t\tkeys: []string{\"base64\", \"subType\"},\n\t\t\t\t\t\tvalues: []*extJSONValue{base64, subType},\n\t\t\t\t\t},\n\t\t\t\t}\n\n\t\t\t\tbreak\n\t\t\t}\n\n\t\t\t// convert legacy $binary format\n\t\t\tbase64 := ejp.v\n\n\t\t\tejp.advanceState()\n\t\t\tif ejp.s != jpsSawComma {\n\t\t\t\treturn nil, invalidJSONErrorForType(\",\", TypeBinary)\n\t\t\t}\n\n\t\t\tejp.advanceState()\n\t\t\tkey, t, err := ejp.readKey()\n\t\t\tif err != nil {\n\t\t\t\treturn nil, err\n\t\t\t}\n\t\t\tif key != \"$type\" {\n\t\t\t\treturn nil, invalidJSONErrorForType(\"$type\", TypeBinary)\n\t\t\t}\n\n\t\t\tsubType, err := ejp.readValue(t)\n\t\t\tif err != nil {\n\t\t\t\treturn nil, err\n\t\t\t}\n\n\t\t\tejp.advanceState()\n\t\t\tif ejp.s != jpsSawEndObject {\n\t\t\t\treturn nil, invalidJSONErrorForType(\"2 key-value pairs and then }\", TypeBinary)\n\t\t\t}\n\n\t\t\tv = &extJSONValue{\n\t\t\t\tt: TypeEmbeddedDocument,\n\t\t\t\tv: &extJSONObject{\n\t\t\t\t\tkeys: []string{\"base64\", \"subType\"},\n\t\t\t\t\tvalues: []*extJSONValue{base64, subType},\n\t\t\t\t},\n\t\t\t}\n\t\t\tbreak\n\t\t}\n\n\t\t// read KV pairs\n\t\tif ejp.s != jpsSawBeginObject {\n\t\t\treturn nil, invalidJSONErrorForType(\"{\", t)\n\t\t}\n\n\t\tkeys, vals, err := ejp.readObject(2, true)\n\t\tif err != nil {\n\t\t\treturn nil, err\n\t\t}\n\n\t\tejp.advanceState()\n\t\tif ejp.s != jpsSawEndObject {\n\t\t\treturn nil, invalidJSONErrorForType(\"2 key-value pairs and then }\", t)\n\t\t}\n\n\t\tv = &extJSONValue{t: TypeEmbeddedDocument, v: &extJSONObject{keys: keys, values: vals}}\n\n\tcase TypeDateTime:\n\t\tswitch ejp.s {\n\t\tcase jpsSawValue:\n\t\t\tv = ejp.v\n\t\tcase jpsSawKey:\n\t\t\t// read colon\n\t\t\tejp.advanceState()\n\t\t\tif err := ensureColon(ejp.s, ejp.k); err != nil {\n\t\t\t\treturn nil, err\n\t\t\t}\n\n\t\t\tejp.advanceState()\n\t\t\tswitch ejp.s {\n\t\t\tcase jpsSawBeginObject:\n\t\t\t\tkeys, vals, err := ejp.readObject(1, true)\n\t\t\t\tif err != nil {\n\t\t\t\t\treturn nil, err\n\t\t\t\t}\n\t\t\t\tv = &extJSONValue{t: TypeEmbeddedDocument, v: &extJSONObject{keys: keys, values: vals}}\n\t\t\tcase jpsSawValue:\n\t\t\t\tif ejp.canonicalOnly {\n\t\t\t\t\treturn nil, invalidJSONError(\"{\")\n\t\t\t\t}\n\t\t\t\tv = ejp.v\n\t\t\tdefault:\n\t\t\t\tif ejp.canonicalOnly {\n\t\t\t\t\treturn nil, invalidJSONErrorForType(\"object\", t)\n\t\t\t\t}\n\t\t\t\treturn nil, invalidJSONErrorForType(\"ISO-8601 Internet Date/Time Format as described in RFC-3339\", t)\n\t\t\t}\n\n\t\t\tejp.advanceState()\n\t\t\tif ejp.s != jpsSawEndObject {\n\t\t\t\treturn nil, invalidJSONErrorForType(\"value and then }\", t)\n\t\t\t}\n\t\tdefault:\n\t\t\treturn nil, invalidRequestError(t.String())\n\t\t}\n\tcase TypeJavaScript:\n\t\tswitch ejp.s {\n\t\tcase jpsSawKey:\n\t\t\t// read colon\n\t\t\tejp.advanceState()\n\t\t\tif err := ensureColon(ejp.s, ejp.k); err != nil {\n\t\t\t\treturn nil, err\n\t\t\t}\n\n\t\t\t// read value\n\t\t\tejp.advanceState()\n\t\t\tif ejp.s != jpsSawValue {\n\t\t\t\treturn nil, invalidJSONErrorForType(\"value\", t)\n\t\t\t}\n\t\t\tv = ejp.v\n\n\t\t\t// read end object or comma and just return\n\t\t\tejp.advanceState()\n\t\tcase jpsSawEndObject:\n\t\t\tv = ejp.v\n\t\tdefault:\n\t\t\treturn nil, invalidRequestError(t.String())\n\t\t}\n\tcase TypeCodeWithScope:\n\t\tif ejp.s == jpsSawKey && ejp.k == \"$scope\" {\n\t\t\tv = ejp.v // this is the $code string from earlier\n\n\t\t\t// read colon\n\t\t\tejp.advanceState()\n\t\t\tif err := ensureColon(ejp.s, ejp.k); err != nil {\n\t\t\t\treturn nil, err\n\t\t\t}\n\n\t\t\t// read {\n\t\t\tejp.advanceState()\n\t\t\tif ejp.s != jpsSawBeginObject {\n\t\t\t\treturn nil, invalidJSONError(\"$scope to be embedded document\")\n\t\t\t}\n\t\t} else {\n\t\t\treturn nil, invalidRequestError(t.String())\n\t\t}\n\tcase TypeEmbeddedDocument, TypeArray:\n\t\treturn nil, invalidRequestError(t.String())\n\t}\n\n\treturn v, nil\n}\n\n// readObject is a utility method for reading full objects of known (or expected) size\n// it is useful for extended JSON types such as binary, datetime, regex, and timestamp\nfunc (ejp *extJSONParser) readObject(numKeys int, started bool) ([]string, []*extJSONValue, error) {\n\tkeys := make([]string, numKeys)\n\tvals := make([]*extJSONValue, numKeys)\n\n\tif !started {\n\t\tejp.advanceState()\n\t\tif ejp.s != jpsSawBeginObject {\n\t\t\treturn nil, nil, invalidJSONError(\"{\")\n\t\t}\n\t}\n\n\tfor i := 0; i < numKeys; i++ {\n\t\tkey, t, err := ejp.readKey()\n\t\tif err != nil {\n\t\t\treturn nil, nil, err\n\t\t}\n\n\t\tswitch ejp.s {\n\t\tcase jpsSawKey:\n\t\t\tv, err := ejp.readValue(t)\n\t\t\tif err != nil {\n\t\t\t\treturn nil, nil, err\n\t\t\t}\n\n\t\t\tkeys[i] = key\n\t\t\tvals[i] = v\n\t\tcase jpsSawValue:\n\t\t\tkeys[i] = key\n\t\t\tvals[i] = ejp.v\n\t\tdefault:\n\t\t\treturn nil, nil, invalidJSONError(\"value\")\n\t\t}\n\t}\n\n\tejp.advanceState()\n\tif ejp.s != jpsSawEndObject {\n\t\treturn nil, nil, invalidJSONError(\"}\")\n\t}\n\n\treturn keys, vals, nil\n}\n\n// advanceState reads the next JSON token from the scanner and transitions\n// from the current state based on that token's type\nfunc (ejp *extJSONParser) advanceState() {\n\tif ejp.s == jpsDoneState || ejp.s == jpsInvalidState {\n\t\treturn\n\t}\n\n\tjt, err := ejp.js.nextToken()\n\tif err != nil {\n\t\tejp.err = err\n\t\tejp.s = jpsInvalidState\n\t\treturn\n\t}\n\n\tvalid := ejp.validateToken(jt.t)\n\tif !valid {\n\t\tejp.err = unexpectedTokenError(jt)\n\t\tejp.s = jpsInvalidState\n\t\treturn\n\t}\n\n\tswitch jt.t {\n\tcase jttBeginObject:\n\t\tejp.s = jpsSawBeginObject\n\t\tejp.pushMode(jpmObjectMode)\n\t\tejp.depth++\n\n\t\tif ejp.depth > ejp.maxDepth {\n\t\t\tejp.err = nestingDepthError(jt.p, ejp.depth)\n\t\t\tejp.s = jpsInvalidState\n\t\t}\n\tcase jttEndObject:\n\t\tejp.s = jpsSawEndObject\n\t\tejp.depth--\n\n\t\tif ejp.popMode() != jpmObjectMode {\n\t\t\tejp.err = unexpectedTokenError(jt)\n\t\t\tejp.s = jpsInvalidState\n\t\t}\n\tcase jttBeginArray:\n\t\tejp.s = jpsSawBeginArray\n\t\tejp.pushMode(jpmArrayMode)\n\tcase jttEndArray:\n\t\tejp.s = jpsSawEndArray\n\n\t\tif ejp.popMode() != jpmArrayMode {\n\t\t\tejp.err = unexpectedTokenError(jt)\n\t\t\tejp.s = jpsInvalidState\n\t\t}\n\tcase jttColon:\n\t\tejp.s = jpsSawColon\n\tcase jttComma:\n\t\tejp.s = jpsSawComma\n\tcase jttEOF:\n\t\tejp.s = jpsDoneState\n\t\tif len(ejp.m) != 0 {\n\t\t\tejp.err = unexpectedTokenError(jt)\n\t\t\tejp.s = jpsInvalidState\n\t\t}\n\tcase jttString:\n\t\tswitch ejp.s {\n\t\tcase jpsSawComma:\n\t\t\tif ejp.peekMode() == jpmArrayMode {\n\t\t\t\tejp.s = jpsSawValue\n\t\t\t\tejp.v = extendJSONToken(jt)\n\t\t\t\treturn\n\t\t\t}\n\t\t\tfallthrough\n\t\tcase jpsSawBeginObject:\n\t\t\tejp.s = jpsSawKey\n\t\t\tejp.k = jt.v.(string)\n\t\t\treturn\n\t\t}\n\t\tfallthrough\n\tdefault:\n\t\tejp.s = jpsSawValue\n\t\tejp.v = extendJSONToken(jt)\n\t}\n}\n\nvar jpsValidTransitionTokens = map[jsonParseState]map[jsonTokenType]bool{\n\tjpsStartState: {\n\t\tjttBeginObject: true,\n\t\tjttBeginArray: true,\n\t\tjttInt32: true,\n\t\tjttInt64: true,\n\t\tjttDouble: true,\n\t\tjttString: true,\n\t\tjttBool: true,\n\t\tjttNull: true,\n\t\tjttEOF: true,\n\t},\n\tjpsSawBeginObject: {\n\t\tjttEndObject: true,\n\t\tjttString: true,\n\t},\n\tjpsSawEndObject: {\n\t\tjttEndObject: true,\n\t\tjttEndArray: true,\n\t\tjttComma: true,\n\t\tjttEOF: true,\n\t},\n\tjpsSawBeginArray: {\n\t\tjttBeginObject: true,\n\t\tjttBeginArray: true,\n\t\tjttEndArray: true,\n\t\tjttInt32: true,\n\t\tjttInt64: true,\n\t\tjttDouble: true,\n\t\tjttString: true,\n\t\tjttBool: true,\n\t\tjttNull: true,\n\t},\n\tjpsSawEndArray: {\n\t\tjttEndObject: true,\n\t\tjttEndArray: true,\n\t\tjttComma: true,\n\t\tjttEOF: true,\n\t},\n\tjpsSawColon: {\n\t\tjttBeginObject: true,\n\t\tjttBeginArray: true,\n\t\tjttInt32: true,\n\t\tjttInt64: true,\n\t\tjttDouble: true,\n\t\tjttString: true,\n\t\tjttBool: true,\n\t\tjttNull: true,\n\t},\n\tjpsSawComma: {\n\t\tjttBeginObject: true,\n\t\tjttBeginArray: true,\n\t\tjttInt32: true,\n\t\tjttInt64: true,\n\t\tjttDouble: true,\n\t\tjttString: true,\n\t\tjttBool: true,\n\t\tjttNull: true,\n\t},\n\tjpsSawKey: {\n\t\tjttColon: true,\n\t},\n\tjpsSawValue: {\n\t\tjttEndObject: true,\n\t\tjttEndArray: true,\n\t\tjttComma: true,\n\t\tjttEOF: true,\n\t},\n\tjpsDoneState: {},\n\tjpsInvalidState: {},\n}\n\nfunc (ejp *extJSONParser) validateToken(jtt jsonTokenType) bool {\n\tswitch ejp.s {\n\tcase jpsSawEndObject:\n\t\t// if we are at depth zero and the next token is a '{',\n\t\t// we can consider it valid only if we are not in array mode.\n\t\tif jtt == jttBeginObject && ejp.depth == 0 {\n\t\t\treturn ejp.peekMode() != jpmArrayMode\n\t\t}\n\tcase jpsSawComma:\n\t\tswitch ejp.peekMode() {\n\t\t// the only valid next token after a comma inside a document is a string (a key)\n\t\tcase jpmObjectMode:\n\t\t\treturn jtt == jttString\n\t\tcase jpmInvalidMode:\n\t\t\treturn false\n\t\t}\n\t}\n\n\t_, ok := jpsValidTransitionTokens[ejp.s][jtt]\n\treturn ok\n}\n\n// ensureExtValueType returns true if the current value has the expected\n// value type for single-key extended JSON types. For example,\n// {\"$numberInt\": v} v must be TypeString\nfunc (ejp *extJSONParser) ensureExtValueType(t Type) bool {\n\tswitch t {\n\tcase TypeMinKey, TypeMaxKey:\n\t\treturn ejp.v.t == TypeInt32\n\tcase TypeUndefined:\n\t\treturn ejp.v.t == TypeBoolean\n\tcase TypeInt32, TypeInt64, TypeDouble, TypeDecimal128, TypeSymbol, TypeObjectID:\n\t\treturn ejp.v.t == TypeString\n\tdefault:\n\t\treturn false\n\t}\n}\n\nfunc (ejp *extJSONParser) pushMode(m jsonParseMode) {\n\tejp.m = append(ejp.m, m)\n}\n\nfunc (ejp *extJSONParser) popMode() jsonParseMode {\n\tl := len(ejp.m)\n\tif l == 0 {\n\t\treturn jpmInvalidMode\n\t}\n\n\tm := ejp.m[l-1]\n\tejp.m = ejp.m[:l-1]\n\n\treturn m\n}\n\nfunc (ejp *extJSONParser) peekMode() jsonParseMode {\n\tl := len(ejp.m)\n\tif l == 0 {\n\t\treturn jpmInvalidMode\n\t}\n\n\treturn ejp.m[l-1]\n}\n\nfunc extendJSONToken(jt *jsonToken) *extJSONValue {\n\tvar t Type\n\n\tswitch jt.t {\n\tcase jttInt32:\n\t\tt = TypeInt32\n\tcase jttInt64:\n\t\tt = TypeInt64\n\tcase jttDouble:\n\t\tt = TypeDouble\n\tcase jttString:\n\t\tt = TypeString\n\tcase jttBool:\n\t\tt = TypeBoolean\n\tcase jttNull:\n\t\tt = TypeNull\n\tdefault:\n\t\treturn nil\n\t}\n\n\treturn &extJSONValue{t: t, v: jt.v}\n}\n\nfunc ensureColon(s jsonParseState, key string) error {\n\tif s != jpsSawColon {\n\t\treturn fmt.Errorf(\"invalid JSON input: missing colon after key \\\"%s\\\"\", key)\n\t}\n\n\treturn nil\n}\n\nfunc invalidRequestError(s string) error {\n\treturn fmt.Errorf(\"invalid request to read %s\", s)\n}\n\nfunc invalidJSONError(expected string) error {\n\treturn fmt.Errorf(\"invalid JSON input; expected %s\", expected)\n}\n\nfunc invalidJSONErrorForType(expected string, t Type) error {\n\treturn fmt.Errorf(\"invalid JSON input; expected %s for %s\", expected, t)\n}\n\nfunc unexpectedTokenError(jt *jsonToken) error {\n\tswitch jt.t {\n\tcase jttInt32, jttInt64, jttDouble:\n\t\treturn fmt.Errorf(\"invalid JSON input; unexpected number (%v) at position %d\", jt.v, jt.p)\n\tcase jttString:\n\t\treturn fmt.Errorf(\"invalid JSON input; unexpected string (\\\"%v\\\") at position %d\", jt.v, jt.p)\n\tcase jttBool:\n\t\treturn fmt.Errorf(\"invalid JSON input; unexpected boolean literal (%v) at position %d\", jt.v, jt.p)\n\tcase jttNull:\n\t\treturn fmt.Errorf(\"invalid JSON input; unexpected null literal at position %d\", jt.p)\n\tcase jttEOF:\n\t\treturn fmt.Errorf(\"invalid JSON input; unexpected end of input at position %d\", jt.p)\n\tdefault:\n\t\treturn fmt.Errorf(\"invalid JSON input; unexpected %c at position %d\", jt.v.(byte), jt.p)\n\t}\n}\n\nfunc nestingDepthError(p, depth int) error {\n\treturn fmt.Errorf(\"invalid JSON input; nesting too deep (%d levels) at position %d\", depth, p)\n}\n" }, { "path": "bson/extjson_parser_test.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"errors\"\n\t\"io\"\n\t\"strings\"\n\t\"testing\"\n\n\t\"github.com/google/go-cmp/cmp\"\n)\n\nvar (\n\tkeyDiff = specificDiff(\"key\")\n\ttypDiff = specificDiff(\"type\")\n\tvalDiff = specificDiff(\"value\")\n\n\texpectErrEOF = expectSpecificError(io.EOF)\n\texpectErrEOD = expectSpecificError(ErrEOD)\n\texpectErrEOA = expectSpecificError(ErrEOA)\n)\n\ntype expectedErrorFunc func(t *testing.T, err error, desc string)\n\ntype peekTypeTestCase struct {\n\tdesc string\n\tinput string\n\ttyps []Type\n\terrFs []expectedErrorFunc\n}\n\ntype readKeyValueTestCase struct {\n\tdesc string\n\tinput string\n\tkeys []string\n\ttyps []Type\n\tvals []*extJSONValue\n\n\tkeyEFs []expectedErrorFunc\n\tvalEFs []expectedErrorFunc\n}\n\nfunc expectNoError(t *testing.T, err error, desc string) {\n\tif err != nil {\n\t\tt.Helper()\n\t\tt.Errorf(\"%s: Unepexted error: %v\", desc, err)\n\t\tt.FailNow()\n\t}\n}\n\nfunc expectError(t *testing.T, err error, desc string) {\n\tif err == nil {\n\t\tt.Helper()\n\t\tt.Errorf(\"%s: Expected error\", desc)\n\t\tt.FailNow()\n\t}\n}\n\nfunc expectSpecificError(expected error) expectedErrorFunc {\n\treturn func(t *testing.T, err error, desc string) {\n\t\tif !errors.Is(err, expected) {\n\t\t\tt.Helper()\n\t\t\tt.Errorf(\"%s: Expected %v but got: %v\", desc, expected, err)\n\t\t\tt.FailNow()\n\t\t}\n\t}\n}\n\nfunc specificDiff(name string) func(t *testing.T, expected, actual any, desc string) {\n\treturn func(t *testing.T, expected, actual any, desc string) {\n\t\tif diff := cmp.Diff(expected, actual); diff != \"\" {\n\t\t\tt.Helper()\n\t\t\tt.Errorf(\"%s: Incorrect JSON %s (-want, +got): %s\\n\", desc, name, diff)\n\t\t\tt.FailNow()\n\t\t}\n\t}\n}\n\nfunc expectErrorNOOP(_ *testing.T, _ error, _ string) {\n}\n\nfunc readKeyDiff(t *testing.T, eKey, aKey string, eTyp, aTyp Type, err error, errF expectedErrorFunc, desc string) {\n\tkeyDiff(t, eKey, aKey, desc)\n\ttypDiff(t, eTyp, aTyp, desc)\n\terrF(t, err, desc)\n}\n\nfunc readValueDiff(t *testing.T, eVal, aVal *extJSONValue, err error, errF expectedErrorFunc, desc string) {\n\tif aVal != nil {\n\t\ttypDiff(t, eVal.t, aVal.t, desc)\n\t\tvalDiff(t, eVal.v, aVal.v, desc)\n\t} else {\n\t\tvalDiff(t, eVal, aVal, desc)\n\t}\n\n\terrF(t, err, desc)\n}\n\nfunc TestExtJSONParserPeekType(t *testing.T) {\n\tmakeValidPeekTypeTestCase := func(input string, typ Type, desc string) peekTypeTestCase {\n\t\treturn peekTypeTestCase{\n\t\t\tdesc: desc, input: input,\n\t\t\ttyps: []Type{typ},\n\t\t\terrFs: []expectedErrorFunc{expectNoError},\n\t\t}\n\t}\n\tmakeInvalidTestCase := func(desc, input string, lastEF expectedErrorFunc) peekTypeTestCase {\n\t\treturn peekTypeTestCase{\n\t\t\tdesc: desc, input: input,\n\t\t\ttyps: []Type{Type(0)},\n\t\t\terrFs: []expectedErrorFunc{lastEF},\n\t\t}\n\t}\n\n\tmakeInvalidPeekTypeTestCase := func(desc, input string, lastEF expectedErrorFunc) peekTypeTestCase {\n\t\treturn peekTypeTestCase{\n\t\t\tdesc: desc, input: input,\n\t\t\ttyps: []Type{TypeArray, TypeString, Type(0)},\n\t\t\terrFs: []expectedErrorFunc{expectNoError, expectNoError, lastEF},\n\t\t}\n\t}\n\n\tcases := []peekTypeTestCase{\n\t\tmakeValidPeekTypeTestCase(`null`, TypeNull, \"Null\"),\n\t\tmakeValidPeekTypeTestCase(`\"string\"`, TypeString, \"String\"),\n\t\tmakeValidPeekTypeTestCase(`true`, TypeBoolean, \"Boolean--true\"),\n\t\tmakeValidPeekTypeTestCase(`false`, TypeBoolean, \"Boolean--false\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$minKey\": 1}`, TypeMinKey, \"MinKey\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$maxKey\": 1}`, TypeMaxKey, \"MaxKey\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$numberInt\": \"42\"}`, TypeInt32, \"Int32\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$numberLong\": \"42\"}`, TypeInt64, \"Int64\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$symbol\": \"symbol\"}`, TypeSymbol, \"Symbol\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$numberDouble\": \"42.42\"}`, TypeDouble, \"Double\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$undefined\": true}`, TypeUndefined, \"Undefined\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$numberDouble\": \"NaN\"}`, TypeDouble, \"Double--NaN\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$numberDecimal\": \"1234\"}`, TypeDecimal128, \"Decimal\"),\n\t\tmakeValidPeekTypeTestCase(`{\"foo\": \"bar\"}`, TypeEmbeddedDocument, \"Toplevel document\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$date\": {\"$numberLong\": \"0\"}}`, TypeDateTime, \"Datetime\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$code\": \"function() {}\"}`, TypeJavaScript, \"Code no scope\"),\n\t\tmakeValidPeekTypeTestCase(`[{\"$numberInt\": \"1\"},{\"$numberInt\": \"2\"}]`, TypeArray, \"Array\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$timestamp\": {\"t\": 42, \"i\": 1}}`, TypeTimestamp, \"Timestamp\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$oid\": \"57e193d7a9cc81b4027498b5\"}`, TypeObjectID, \"Object ID\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$binary\": {\"base64\": \"AQIDBAU=\", \"subType\": \"80\"}}`, TypeBinary, \"Binary\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$code\": \"function() {}\", \"$scope\": {}}`, TypeCodeWithScope, \"Code With Scope\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$binary\": {\"base64\": \"o0w498Or7cijeBSpkquNtg==\", \"subType\": \"03\"}}`, TypeBinary, \"Binary\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$binary\": \"o0w498Or7cijeBSpkquNtg==\", \"$type\": \"03\"}`, TypeBinary, \"Binary\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$regularExpression\": {\"pattern\": \"foo*\", \"options\": \"ix\"}}`, TypeRegex, \"Regular expression\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$dbPointer\": {\"$ref\": \"db.collection\", \"$id\": {\"$oid\": \"57e193d7a9cc81b4027498b1\"}}}`, TypeDBPointer, \"DBPointer\"),\n\t\tmakeValidPeekTypeTestCase(`{\"$ref\": \"collection\", \"$id\": {\"$oid\": \"57fd71e96e32ab4225b723fb\"}, \"$db\": \"database\"}`, TypeEmbeddedDocument, \"DBRef\"),\n\t\tmakeInvalidPeekTypeTestCase(\"invalid array--missing ]\", `[\"a\"`, expectError),\n\t\tmakeInvalidPeekTypeTestCase(\"invalid array--colon in array\", `[\"a\":`, expectError),\n\t\tmakeInvalidPeekTypeTestCase(\"invalid array--extra comma\", `[\"a\",,`, expectError),\n\t\tmakeInvalidPeekTypeTestCase(\"invalid array--trailing comma\", `[\"a\",]`, expectError),\n\t\tmakeInvalidPeekTypeTestCase(\"peekType after end of array\", `[\"a\"]`, expectErrEOA),\n\t\t{\n\t\t\tdesc: \"invalid array--leading comma\",\n\t\t\tinput: `[,`,\n\t\t\ttyps: []Type{TypeArray, Type(0)},\n\t\t\terrFs: []expectedErrorFunc{expectNoError, expectError},\n\t\t},\n\t\tmakeInvalidTestCase(\"lone $scope\", `{\"$scope\": {}}`, expectError),\n\t\tmakeInvalidTestCase(\"empty code with unknown extra key\", `{\"$code\":\"\", \"0\":\"\"}`, expectError),\n\t\tmakeInvalidTestCase(\"non-empty code with unknown extra key\", `{\"$code\":\"foobar\", \"0\":\"\"}`, expectError),\n\t}\n\n\tfor _, tc := range cases {\n\t\tt.Run(tc.desc, func(t *testing.T) {\n\t\t\tejp := newExtJSONParser(strings.NewReader(tc.input), true)\n\t\t\t// Manually set the parser's starting state to jpsSawColon so peekType will read ahead to find the extjson\n\t\t\t// type of the value. If not set, the parser will be in jpsStartState and advance to jpsSawKey, which will\n\t\t\t// cause it to return without peeking the extjson type.\n\t\t\tejp.s = jpsSawColon\n\n\t\t\tfor i, eTyp := range tc.typs {\n\t\t\t\terrF := tc.errFs[i]\n\n\t\t\t\ttyp, err := ejp.peekType()\n\t\t\t\terrF(t, err, tc.desc)\n\t\t\t\tif err != nil {\n\t\t\t\t\t// Don't inspect the type if there was an error\n\t\t\t\t\treturn\n\t\t\t\t}\n\n\t\t\t\ttypDiff(t, eTyp, typ, tc.desc)\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc TestExtJSONParserReadKeyReadValue(t *testing.T) {\n\t// several test cases will use the same keys, types, and values, and only differ on input structure\n\n\tkeys := []string{\"_id\", \"Symbol\", \"String\", \"Int32\", \"Int64\", \"Int\", \"MinKey\"}\n\ttypes := []Type{TypeObjectID, TypeSymbol, TypeString, TypeInt32, TypeInt64, TypeInt32, TypeMinKey}\n\tvalues := []*extJSONValue{\n\t\t{t: TypeString, v: \"57e193d7a9cc81b4027498b5\"},\n\t\t{t: TypeString, v: \"symbol\"},\n\t\t{t: TypeString, v: \"string\"},\n\t\t{t: TypeString, v: \"42\"},\n\t\t{t: TypeString, v: \"42\"},\n\t\t{t: TypeInt32, v: int32(42)},\n\t\t{t: TypeInt32, v: int32(1)},\n\t}\n\n\terrFuncs := make([]expectedErrorFunc, 7)\n\tfor i := 0; i < 7; i++ {\n\t\terrFuncs[i] = expectNoError\n\t}\n\n\tfirstKeyError := func(desc, input string) readKeyValueTestCase {\n\t\treturn readKeyValueTestCase{\n\t\t\tdesc: desc,\n\t\t\tinput: input,\n\t\t\tkeys: []string{\"\"},\n\t\t\ttyps: []Type{Type(0)},\n\t\t\tvals: []*extJSONValue{nil},\n\t\t\tkeyEFs: []expectedErrorFunc{expectError},\n\t\t\tvalEFs: []expectedErrorFunc{expectErrorNOOP},\n\t\t}\n\t}\n\n\tsecondKeyError := func(desc, input, firstKey string, firstType Type, firstValue *extJSONValue) readKeyValueTestCase {\n\t\treturn readKeyValueTestCase{\n\t\t\tdesc: desc,\n\t\t\tinput: input,\n\t\t\tkeys: []string{firstKey, \"\"},\n\t\t\ttyps: []Type{firstType, Type(0)},\n\t\t\tvals: []*extJSONValue{firstValue, nil},\n\t\t\tkeyEFs: []expectedErrorFunc{expectNoError, expectError},\n\t\t\tvalEFs: []expectedErrorFunc{expectNoError, expectErrorNOOP},\n\t\t}\n\t}\n\n\tcases := []readKeyValueTestCase{\n\t\t{\n\t\t\tdesc: \"normal spacing\",\n\t\t\tinput: `{\n\t\t\t\t\t\"_id\": { \"$oid\": \"57e193d7a9cc81b4027498b5\" },\n\t\t\t\t\t\"Symbol\": { \"$symbol\": \"symbol\" },\n\t\t\t\t\t\"String\": \"string\",\n\t\t\t\t\t\"Int32\": { \"$numberInt\": \"42\" },\n\t\t\t\t\t\"Int64\": { \"$numberLong\": \"42\" },\n\t\t\t\t\t\"Int\": 42,\n\t\t\t\t\t\"MinKey\": { \"$minKey\": 1 }\n\t\t\t\t}`,\n\t\t\tkeys: keys, typs: types, vals: values,\n\t\t\tkeyEFs: errFuncs, valEFs: errFuncs,\n\t\t},\n\t\t{\n\t\t\tdesc: \"new line before comma\",\n\t\t\tinput: `{ \"_id\": { \"$oid\": \"57e193d7a9cc81b4027498b5\" }\n\t\t\t\t , \"Symbol\": { \"$symbol\": \"symbol\" }\n\t\t\t\t , \"String\": \"string\"\n\t\t\t\t , \"Int32\": { \"$numberInt\": \"42\" }\n\t\t\t\t , \"Int64\": { \"$numberLong\": \"42\" }\n\t\t\t\t , \"Int\": 42\n\t\t\t\t , \"MinKey\": { \"$minKey\": 1 }\n\t\t\t\t }`,\n\t\t\tkeys: keys, typs: types, vals: values,\n\t\t\tkeyEFs: errFuncs, valEFs: errFuncs,\n\t\t},\n\t\t{\n\t\t\tdesc: \"tabs around colons\",\n\t\t\tinput: `{\n\t\t\t\t\t\"_id\": { \"$oid\" : \"57e193d7a9cc81b4027498b5\" },\n\t\t\t\t\t\"Symbol\": { \"$symbol\" : \"symbol\" },\n\t\t\t\t\t\"String\": \"string\",\n\t\t\t\t\t\"Int32\": { \"$numberInt\" : \"42\" },\n\t\t\t\t\t\"Int64\": { \"$numberLong\": \"42\" },\n\t\t\t\t\t\"Int\": 42,\n\t\t\t\t\t\"MinKey\": { \"$minKey\": 1 }\n\t\t\t\t}`,\n\t\t\tkeys: keys, typs: types, vals: values,\n\t\t\tkeyEFs: errFuncs, valEFs: errFuncs,\n\t\t},\n\t\t{\n\t\t\tdesc: \"no whitespace\",\n\t\t\tinput: `{\"_id\":{\"$oid\":\"57e193d7a9cc81b4027498b5\"},\"Symbol\":{\"$symbol\":\"symbol\"},\"String\":\"string\",\"Int32\":{\"$numberInt\":\"42\"},\"Int64\":{\"$numberLong\":\"42\"},\"Int\":42,\"MinKey\":{\"$minKey\":1}}`,\n\t\t\tkeys: keys, typs: types, vals: values,\n\t\t\tkeyEFs: errFuncs, valEFs: errFuncs,\n\t\t},\n\t\t{\n\t\t\tdesc: \"mixed whitespace\",\n\t\t\tinput: `\t{\n\t\t\t\t\t\"_id\"\t\t: { \"$oid\": \"57e193d7a9cc81b4027498b5\" },\n\t\t\t \"Symbol\"\t: { \"$symbol\": \"symbol\" }\t,\n\t\t\t\t \"String\"\t: \"string\",\n\t\t\t\t\t\"Int32\"\t\t: { \"$numberInt\": \"42\" } ,\n\t\t\t\t\t\"Int64\"\t\t: {\"$numberLong\" : \"42\"},\n\t\t\t\t\t\"Int\"\t\t: 42,\n\t\t\t \t\"MinKey\"\t: { \"$minKey\": 1 } \t}\t`,\n\t\t\tkeys: keys, typs: types, vals: values,\n\t\t\tkeyEFs: errFuncs, valEFs: errFuncs,\n\t\t},\n\t\t{\n\t\t\tdesc: \"nested object\",\n\t\t\tinput: `{\"k1\": 1, \"k2\": { \"k3\": { \"k4\": 4 } }, \"k5\": 5}`,\n\t\t\tkeys: []string{\"k1\", \"k2\", \"k3\", \"k4\", \"\", \"\", \"k5\", \"\"},\n\t\t\ttyps: []Type{TypeInt32, TypeEmbeddedDocument, TypeEmbeddedDocument, TypeInt32, Type(0), Type(0), TypeInt32, Type(0)},\n\t\t\tvals: []*extJSONValue{\n\t\t\t\t{t: TypeInt32, v: int32(1)}, nil, nil, {t: TypeInt32, v: int32(4)}, nil, nil, {t: TypeInt32, v: int32(5)}, nil,\n\t\t\t},\n\t\t\tkeyEFs: []expectedErrorFunc{\n\t\t\t\texpectNoError, expectNoError, expectNoError, expectNoError, expectErrEOD,\n\t\t\t\texpectErrEOD, expectNoError, expectErrEOD,\n\t\t\t},\n\t\t\tvalEFs: []expectedErrorFunc{\n\t\t\t\texpectNoError, expectError, expectError, expectNoError, expectErrorNOOP,\n\t\t\t\texpectErrorNOOP, expectNoError, expectErrorNOOP,\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tdesc: \"invalid input: invalid values for extended type\",\n\t\t\tinput: `{\"a\": {\"$numberInt\": \"1\", \"x\"`,\n\t\t\tkeys: []string{\"a\"},\n\t\t\ttyps: []Type{TypeInt32},\n\t\t\tvals: []*extJSONValue{nil},\n\t\t\tkeyEFs: []expectedErrorFunc{expectNoError},\n\t\t\tvalEFs: []expectedErrorFunc{expectError},\n\t\t},\n\t\tfirstKeyError(\"invalid input: missing key--EOF\", \"{\"),\n\t\tfirstKeyError(\"invalid input: missing key--colon first\", \"{:\"),\n\t\tfirstKeyError(\"invalid input: missing value\", `{\"a\":`),\n\t\tfirstKeyError(\"invalid input: missing colon\", `{\"a\" 1`),\n\t\tfirstKeyError(\"invalid input: extra colon\", `{\"a\"::`),\n\t\tsecondKeyError(\"invalid input: missing }\", `{\"a\": 1`, \"a\", TypeInt32, &extJSONValue{t: TypeInt32, v: int32(1)}),\n\t\tsecondKeyError(\"invalid input: missing comma\", `{\"a\": 1 \"b\"`, \"a\", TypeInt32, &extJSONValue{t: TypeInt32, v: int32(1)}),\n\t\tsecondKeyError(\"invalid input: extra comma\", `{\"a\": 1,, \"b\"`, \"a\", TypeInt32, &extJSONValue{t: TypeInt32, v: int32(1)}),\n\t\tsecondKeyError(\"invalid input: trailing comma in object\", `{\"a\": 1,}`, \"a\", TypeInt32, &extJSONValue{t: TypeInt32, v: int32(1)}),\n\t\t{\n\t\t\tdesc: \"invalid input: lone scope after a complete value\",\n\t\t\tinput: `{\"a\": \"\", \"b\": {\"$scope: \"\"}}`,\n\t\t\tkeys: []string{\"a\"},\n\t\t\ttyps: []Type{TypeString},\n\t\t\tvals: []*extJSONValue{{TypeString, \"\"}},\n\t\t\tkeyEFs: []expectedErrorFunc{expectNoError, expectNoError},\n\t\t\tvalEFs: []expectedErrorFunc{expectNoError, expectError},\n\t\t},\n\t\t{\n\t\t\tdesc: \"invalid input: lone scope nested\",\n\t\t\tinput: `{\"a\":{\"b\":{\"$scope\":{`,\n\t\t\tkeys: []string{},\n\t\t\ttyps: []Type{},\n\t\t\tvals: []*extJSONValue{nil},\n\t\t\tkeyEFs: []expectedErrorFunc{expectNoError},\n\t\t\tvalEFs: []expectedErrorFunc{expectError},\n\t\t},\n\t}\n\n\tfor _, tc := range cases {\n\t\tt.Run(tc.desc, func(t *testing.T) {\n\t\t\tejp := newExtJSONParser(strings.NewReader(tc.input), true)\n\n\t\t\tfor i, eKey := range tc.keys {\n\t\t\t\teTyp := tc.typs[i]\n\t\t\t\teVal := tc.vals[i]\n\n\t\t\t\tkeyErrF := tc.keyEFs[i]\n\t\t\t\tvalErrF := tc.valEFs[i]\n\n\t\t\t\tk, typ, err := ejp.readKey()\n\t\t\t\treadKeyDiff(t, eKey, k, eTyp, typ, err, keyErrF, tc.desc)\n\n\t\t\t\tv, err := ejp.readValue(typ)\n\t\t\t\treadValueDiff(t, eVal, v, err, valErrF, tc.desc)\n\t\t\t}\n\t\t})\n\t}\n}\n\ntype ejpExpectationTest func(t *testing.T, p *extJSONParser, expectedKey string, expectedType Type, expectedValue any)\n\ntype ejpTestCase struct {\n\tf ejpExpectationTest\n\tp *extJSONParser\n\tk string\n\tt Type\n\tv any\n}\n\n// expectSingleValue is used for simple JSON types (strings, numbers, literals) and for extended JSON types that\n// have single key-value pairs (i.e. { \"$minKey\": 1 }, { \"$numberLong\": \"42.42\" })\nfunc expectSingleValue(t *testing.T, p *extJSONParser, expectedKey string, expectedType Type, expectedValue any) {\n\teVal := expectedValue.(*extJSONValue)\n\n\tk, typ, err := p.readKey()\n\treadKeyDiff(t, expectedKey, k, expectedType, typ, err, expectNoError, expectedKey)\n\n\tv, err := p.readValue(typ)\n\treadValueDiff(t, eVal, v, err, expectNoError, expectedKey)\n}\n\n// expectMultipleValues is used for values that are subdocuments of known size and with known keys (such as extended\n// JSON types { \"$timestamp\": {\"t\": 1, \"i\": 1} } and { \"$regularExpression\": {\"pattern\": \"\", options: \"\"} })\nfunc expectMultipleValues(t *testing.T, p *extJSONParser, expectedKey string, expectedType Type, expectedValue any) {\n\tk, typ, err := p.readKey()\n\treadKeyDiff(t, expectedKey, k, expectedType, typ, err, expectNoError, expectedKey)\n\n\tv, err := p.readValue(typ)\n\texpectNoError(t, err, \"\")\n\ttypDiff(t, TypeEmbeddedDocument, v.t, expectedKey)\n\n\tactObj := v.v.(*extJSONObject)\n\texpObj := expectedValue.(*extJSONObject)\n\n\tfor i, actKey := range actObj.keys {\n\t\texpKey := expObj.keys[i]\n\t\tactVal := actObj.values[i]\n\t\texpVal := expObj.values[i]\n\n\t\tkeyDiff(t, expKey, actKey, expectedKey)\n\t\ttypDiff(t, expVal.t, actVal.t, expectedKey)\n\t\tvalDiff(t, expVal.v, actVal.v, expectedKey)\n\t}\n}\n\ntype ejpKeyTypValTriple struct {\n\tkey string\n\ttyp Type\n\tval *extJSONValue\n}\n\ntype ejpSubDocumentTestValue struct {\n\tcode string // code is only used for TypeCodeWithScope (and is ignored for TypeEmbeddedDocument\n\tktvs []ejpKeyTypValTriple // list of (key, type, value) triples; this is \"scope\" for TypeCodeWithScope\n}\n\n// expectSubDocument is used for embedded documents and code with scope types; it reads all the keys and values\n// in the embedded document (or scope for codeWithScope) and compares them to the expectedValue's list of (key, type,\n// value) triples\nfunc expectSubDocument(t *testing.T, p *extJSONParser, expectedKey string, expectedType Type, expectedValue any) {\n\tsubdoc := expectedValue.(ejpSubDocumentTestValue)\n\n\tk, typ, err := p.readKey()\n\treadKeyDiff(t, expectedKey, k, expectedType, typ, err, expectNoError, expectedKey)\n\n\tif expectedType == TypeCodeWithScope {\n\t\tv, err := p.readValue(typ)\n\t\treadValueDiff(t, &extJSONValue{t: TypeString, v: subdoc.code}, v, err, expectNoError, expectedKey)\n\t}\n\n\tfor _, ktv := range subdoc.ktvs {\n\t\teKey := ktv.key\n\t\teTyp := ktv.typ\n\t\teVal := ktv.val\n\n\t\tk, typ, err = p.readKey()\n\t\treadKeyDiff(t, eKey, k, eTyp, typ, err, expectNoError, expectedKey)\n\n\t\tv, err := p.readValue(typ)\n\t\treadValueDiff(t, eVal, v, err, expectNoError, expectedKey)\n\t}\n\n\tif expectedType == TypeCodeWithScope {\n\t\t// expect scope doc to close\n\t\tk, typ, err = p.readKey()\n\t\treadKeyDiff(t, \"\", k, Type(0), typ, err, expectErrEOD, expectedKey)\n\t}\n\n\t// expect subdoc to close\n\tk, typ, err = p.readKey()\n\treadKeyDiff(t, \"\", k, Type(0), typ, err, expectErrEOD, expectedKey)\n}\n\n// expectArray takes the expectedKey, ignores the expectedType, and uses the expectedValue\n// as a slice of (type Type, value *extJSONValue) pairs\nfunc expectArray(t *testing.T, p *extJSONParser, expectedKey string, _ Type, expectedValue any) {\n\tktvs := expectedValue.([]ejpKeyTypValTriple)\n\n\tk, typ, err := p.readKey()\n\treadKeyDiff(t, expectedKey, k, TypeArray, typ, err, expectNoError, expectedKey)\n\n\tfor _, ktv := range ktvs {\n\t\teTyp := ktv.typ\n\t\teVal := ktv.val\n\n\t\ttyp, err = p.peekType()\n\t\ttypDiff(t, eTyp, typ, expectedKey)\n\t\texpectNoError(t, err, expectedKey)\n\n\t\tv, err := p.readValue(typ)\n\t\treadValueDiff(t, eVal, v, err, expectNoError, expectedKey)\n\t}\n\n\t// expect array to end\n\ttyp, err = p.peekType()\n\ttypDiff(t, Type(0), typ, expectedKey)\n\texpectErrEOA(t, err, expectedKey)\n}\n\nfunc TestExtJSONParserAllTypes(t *testing.T) {\n\tin := ` { \"_id\"\t\t\t\t\t: { \"$oid\": \"57e193d7a9cc81b4027498b5\"}\n\t\t\t, \"Symbol\"\t\t\t\t: { \"$symbol\": \"symbol\"}\n\t\t\t, \"String\"\t\t\t\t: \"string\"\n\t\t\t, \"Int32\"\t\t\t\t: { \"$numberInt\": \"42\"}\n\t\t\t, \"Int64\"\t\t\t\t: { \"$numberLong\": \"42\"}\n\t\t\t, \"Double\"\t\t\t\t: { \"$numberDouble\": \"42.42\"}\n\t\t\t, \"SpecialFloat\"\t\t: { \"$numberDouble\": \"NaN\" }\n\t\t\t, \"Decimal\"\t\t\t\t: { \"$numberDecimal\": \"1234\" }\n\t\t\t, \"Binary\"\t\t\t \t: { \"$binary\": { \"base64\": \"o0w498Or7cijeBSpkquNtg==\", \"subType\": \"03\" } }\n\t\t\t, \"BinaryLegacy\" : { \"$binary\": \"o0w498Or7cijeBSpkquNtg==\", \"$type\": \"03\" }\n\t\t\t, \"BinaryUserDefined\"\t: { \"$binary\": { \"base64\": \"AQIDBAU=\", \"subType\": \"80\" } }\n\t\t\t, \"Code\"\t\t\t\t: { \"$code\": \"function() {}\" }\n\t\t\t, \"CodeWithEmptyScope\"\t: { \"$code\": \"function() {}\", \"$scope\": {} }\n\t\t\t, \"CodeWithScope\"\t\t: { \"$code\": \"function() {}\", \"$scope\": { \"x\": 1 } }\n\t\t\t, \"EmptySubdocument\" : {}\n\t\t\t, \"Subdocument\"\t\t\t: { \"foo\": \"bar\", \"baz\": { \"$numberInt\": \"42\" } }\n\t\t\t, \"Array\"\t\t\t\t: [{\"$numberInt\": \"1\"}, {\"$numberLong\": \"2\"}, {\"$numberDouble\": \"3\"}, 4, \"string\", 5.0]\n\t\t\t, \"Timestamp\"\t\t\t: { \"$timestamp\": { \"t\": 42, \"i\": 1 } }\n\t\t\t, \"RegularExpression\"\t: { \"$regularExpression\": { \"pattern\": \"foo*\", \"options\": \"ix\" } }\n\t\t\t, \"DatetimeEpoch\"\t\t: { \"$date\": { \"$numberLong\": \"0\" } }\n\t\t\t, \"DatetimePositive\"\t: { \"$date\": { \"$numberLong\": \"9223372036854775807\" } }\n\t\t\t, \"DatetimeNegative\"\t: { \"$date\": { \"$numberLong\": \"-9223372036854775808\" } }\n\t\t\t, \"True\"\t\t\t\t: true\n\t\t\t, \"False\"\t\t\t\t: false\n\t\t\t, \"DBPointer\"\t\t\t: { \"$dbPointer\": { \"$ref\": \"db.collection\", \"$id\": { \"$oid\": \"57e193d7a9cc81b4027498b1\" } } }\n\t\t\t, \"DBRef\"\t\t\t\t: { \"$ref\": \"collection\", \"$id\": { \"$oid\": \"57fd71e96e32ab4225b723fb\" }, \"$db\": \"database\" }\n\t\t\t, \"DBRefNoDB\"\t\t\t: { \"$ref\": \"collection\", \"$id\": { \"$oid\": \"57fd71e96e32ab4225b723fb\" } }\n\t\t\t, \"MinKey\"\t\t\t\t: { \"$minKey\": 1 }\n\t\t\t, \"MaxKey\"\t\t\t\t: { \"$maxKey\": 1 }\n\t\t\t, \"Null\"\t\t\t\t: null\n\t\t\t, \"Undefined\"\t\t\t: { \"$undefined\": true }\n\t\t\t}`\n\n\tejp := newExtJSONParser(strings.NewReader(in), true)\n\n\tcases := []ejpTestCase{\n\t\t{\n\t\t\tf: expectSingleValue, p: ejp,\n\t\t\tk: \"_id\", t: TypeObjectID, v: &extJSONValue{t: TypeString, v: \"57e193d7a9cc81b4027498b5\"},\n\t\t},\n\t\t{\n\t\t\tf: expectSingleValue, p: ejp,\n\t\t\tk: \"Symbol\", t: TypeSymbol, v: &extJSONValue{t: TypeString, v: \"symbol\"},\n\t\t},\n\t\t{\n\t\t\tf: expectSingleValue, p: ejp,\n\t\t\tk: \"String\", t: TypeString, v: &extJSONValue{t: TypeString, v: \"string\"},\n\t\t},\n\t\t{\n\t\t\tf: expectSingleValue, p: ejp,\n\t\t\tk: \"Int32\", t: TypeInt32, v: &extJSONValue{t: TypeString, v: \"42\"},\n\t\t},\n\t\t{\n\t\t\tf: expectSingleValue, p: ejp,\n\t\t\tk: \"Int64\", t: TypeInt64, v: &extJSONValue{t: TypeString, v: \"42\"},\n\t\t},\n\t\t{\n\t\t\tf: expectSingleValue, p: ejp,\n\t\t\tk: \"Double\", t: TypeDouble, v: &extJSONValue{t: TypeString, v: \"42.42\"},\n\t\t},\n\t\t{\n\t\t\tf: expectSingleValue, p: ejp,\n\t\t\tk: \"SpecialFloat\", t: TypeDouble, v: &extJSONValue{t: TypeString, v: \"NaN\"},\n\t\t},\n\t\t{\n\t\t\tf: expectSingleValue, p: ejp,\n\t\t\tk: \"Decimal\", t: TypeDecimal128, v: &extJSONValue{t: TypeString, v: \"1234\"},\n\t\t},\n\t\t{\n\t\t\tf: expectMultipleValues, p: ejp,\n\t\t\tk: \"Binary\", t: TypeBinary,\n\t\t\tv: &extJSONObject{\n\t\t\t\tkeys: []string{\"base64\", \"subType\"},\n\t\t\t\tvalues: []*extJSONValue{\n\t\t\t\t\t{t: TypeString, v: \"o0w498Or7cijeBSpkquNtg==\"},\n\t\t\t\t\t{t: TypeString, v: \"03\"},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tf: expectMultipleValues, p: ejp,\n\t\t\tk: \"BinaryLegacy\", t: TypeBinary,\n\t\t\tv: &extJSONObject{\n\t\t\t\tkeys: []string{\"base64\", \"subType\"},\n\t\t\t\tvalues: []*extJSONValue{\n\t\t\t\t\t{t: TypeString, v: \"o0w498Or7cijeBSpkquNtg==\"},\n\t\t\t\t\t{t: TypeString, v: \"03\"},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tf: expectMultipleValues, p: ejp,\n\t\t\tk: \"BinaryUserDefined\", t: TypeBinary,\n\t\t\tv: &extJSONObject{\n\t\t\t\tkeys: []string{\"base64\", \"subType\"},\n\t\t\t\tvalues: []*extJSONValue{\n\t\t\t\t\t{t: TypeString, v: \"AQIDBAU=\"},\n\t\t\t\t\t{t: TypeString, v: \"80\"},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tf: expectSingleValue, p: ejp,\n\t\t\tk: \"Code\", t: TypeJavaScript, v: &extJSONValue{t: TypeString, v: \"function() {}\"},\n\t\t},\n\t\t{\n\t\t\tf: expectSubDocument, p: ejp,\n\t\t\tk: \"CodeWithEmptyScope\", t: TypeCodeWithScope,\n\t\t\tv: ejpSubDocumentTestValue{\n\t\t\t\tcode: \"function() {}\",\n\t\t\t\tktvs: []ejpKeyTypValTriple{},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tf: expectSubDocument, p: ejp,\n\t\t\tk: \"CodeWithScope\", t: TypeCodeWithScope,\n\t\t\tv: ejpSubDocumentTestValue{\n\t\t\t\tcode: \"function() {}\",\n\t\t\t\tktvs: []ejpKeyTypValTriple{\n\t\t\t\t\t{\"x\", TypeInt32, &extJSONValue{t: TypeInt32, v: int32(1)}},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tf: expectSubDocument, p: ejp,\n\t\t\tk: \"EmptySubdocument\", t: TypeEmbeddedDocument,\n\t\t\tv: ejpSubDocumentTestValue{\n\t\t\t\tktvs: []ejpKeyTypValTriple{},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tf: expectSubDocument, p: ejp,\n\t\t\tk: \"Subdocument\", t: TypeEmbeddedDocument,\n\t\t\tv: ejpSubDocumentTestValue{\n\t\t\t\tktvs: []ejpKeyTypValTriple{\n\t\t\t\t\t{\"foo\", TypeString, &extJSONValue{t: TypeString, v: \"bar\"}},\n\t\t\t\t\t{\"baz\", TypeInt32, &extJSONValue{t: TypeString, v: \"42\"}},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tf: expectArray, p: ejp,\n\t\t\tk: \"Array\", t: TypeArray,\n\t\t\tv: []ejpKeyTypValTriple{\n\t\t\t\t{typ: TypeInt32, val: &extJSONValue{t: TypeString, v: \"1\"}},\n\t\t\t\t{typ: TypeInt64, val: &extJSONValue{t: TypeString, v: \"2\"}},\n\t\t\t\t{typ: TypeDouble, val: &extJSONValue{t: TypeString, v: \"3\"}},\n\t\t\t\t{typ: TypeInt32, val: &extJSONValue{t: TypeInt32, v: int32(4)}},\n\t\t\t\t{typ: TypeString, val: &extJSONValue{t: TypeString, v: \"string\"}},\n\t\t\t\t{typ: TypeDouble, val: &extJSONValue{t: TypeDouble, v: 5.0}},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tf: expectMultipleValues, p: ejp,\n\t\t\tk: \"Timestamp\", t: TypeTimestamp,\n\t\t\tv: &extJSONObject{\n\t\t\t\tkeys: []string{\"t\", \"i\"},\n\t\t\t\tvalues: []*extJSONValue{\n\t\t\t\t\t{t: TypeInt32, v: int32(42)},\n\t\t\t\t\t{t: TypeInt32, v: int32(1)},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tf: expectMultipleValues, p: ejp,\n\t\t\tk: \"RegularExpression\", t: TypeRegex,\n\t\t\tv: &extJSONObject{\n\t\t\t\tkeys: []string{\"pattern\", \"options\"},\n\t\t\t\tvalues: []*extJSONValue{\n\t\t\t\t\t{t: TypeString, v: \"foo*\"},\n\t\t\t\t\t{t: TypeString, v: \"ix\"},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tf: expectMultipleValues, p: ejp,\n\t\t\tk: \"DatetimeEpoch\", t: TypeDateTime,\n\t\t\tv: &extJSONObject{\n\t\t\t\tkeys: []string{\"$numberLong\"},\n\t\t\t\tvalues: []*extJSONValue{\n\t\t\t\t\t{t: TypeString, v: \"0\"},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tf: expectMultipleValues, p: ejp,\n\t\t\tk: \"DatetimePositive\", t: TypeDateTime,\n\t\t\tv: &extJSONObject{\n\t\t\t\tkeys: []string{\"$numberLong\"},\n\t\t\t\tvalues: []*extJSONValue{\n\t\t\t\t\t{t: TypeString, v: \"9223372036854775807\"},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tf: expectMultipleValues, p: ejp,\n\t\t\tk: \"DatetimeNegative\", t: TypeDateTime,\n\t\t\tv: &extJSONObject{\n\t\t\t\tkeys: []string{\"$numberLong\"},\n\t\t\t\tvalues: []*extJSONValue{\n\t\t\t\t\t{t: TypeString, v: \"-9223372036854775808\"},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tf: expectSingleValue, p: ejp,\n\t\t\tk: \"True\", t: TypeBoolean, v: &extJSONValue{t: TypeBoolean, v: true},\n\t\t},\n\t\t{\n\t\t\tf: expectSingleValue, p: ejp,\n\t\t\tk: \"False\", t: TypeBoolean, v: &extJSONValue{t: TypeBoolean, v: false},\n\t\t},\n\t\t{\n\t\t\tf: expectMultipleValues, p: ejp,\n\t\t\tk: \"DBPointer\", t: TypeDBPointer,\n\t\t\tv: &extJSONObject{\n\t\t\t\tkeys: []string{\"$ref\", \"$id\"},\n\t\t\t\tvalues: []*extJSONValue{\n\t\t\t\t\t{t: TypeString, v: \"db.collection\"},\n\t\t\t\t\t{t: TypeString, v: \"57e193d7a9cc81b4027498b1\"},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tf: expectSubDocument, p: ejp,\n\t\t\tk: \"DBRef\", t: TypeEmbeddedDocument,\n\t\t\tv: ejpSubDocumentTestValue{\n\t\t\t\tktvs: []ejpKeyTypValTriple{\n\t\t\t\t\t{\"$ref\", TypeString, &extJSONValue{t: TypeString, v: \"collection\"}},\n\t\t\t\t\t{\"$id\", TypeObjectID, &extJSONValue{t: TypeString, v: \"57fd71e96e32ab4225b723fb\"}},\n\t\t\t\t\t{\"$db\", TypeString, &extJSONValue{t: TypeString, v: \"database\"}},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tf: expectSubDocument, p: ejp,\n\t\t\tk: \"DBRefNoDB\", t: TypeEmbeddedDocument,\n\t\t\tv: ejpSubDocumentTestValue{\n\t\t\t\tktvs: []ejpKeyTypValTriple{\n\t\t\t\t\t{\"$ref\", TypeString, &extJSONValue{t: TypeString, v: \"collection\"}},\n\t\t\t\t\t{\"$id\", TypeObjectID, &extJSONValue{t: TypeString, v: \"57fd71e96e32ab4225b723fb\"}},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tf: expectSingleValue, p: ejp,\n\t\t\tk: \"MinKey\", t: TypeMinKey, v: &extJSONValue{t: TypeInt32, v: int32(1)},\n\t\t},\n\t\t{\n\t\t\tf: expectSingleValue, p: ejp,\n\t\t\tk: \"MaxKey\", t: TypeMaxKey, v: &extJSONValue{t: TypeInt32, v: int32(1)},\n\t\t},\n\t\t{\n\t\t\tf: expectSingleValue, p: ejp,\n\t\t\tk: \"Null\", t: TypeNull, v: &extJSONValue{t: TypeNull, v: nil},\n\t\t},\n\t\t{\n\t\t\tf: expectSingleValue, p: ejp,\n\t\t\tk: \"Undefined\", t: TypeUndefined, v: &extJSONValue{t: TypeBoolean, v: true},\n\t\t},\n\t}\n\n\t// run the test cases\n\tfor _, tc := range cases {\n\t\ttc.f(t, tc.p, tc.k, tc.t, tc.v)\n\t}\n\n\t// expect end of whole document: read final }\n\tk, typ, err := ejp.readKey()\n\treadKeyDiff(t, \"\", k, Type(0), typ, err, expectErrEOD, \"\")\n\n\t// expect end of whole document: read EOF\n\tk, typ, err = ejp.readKey()\n\treadKeyDiff(t, \"\", k, Type(0), typ, err, expectErrEOF, \"\")\n\tif diff := cmp.Diff(jpsDoneState, ejp.s); diff != \"\" {\n\t\tt.Errorf(\"expected parser to be in done state but instead is in %v\\n\", ejp.s)\n\t\tt.FailNow()\n\t}\n}\n\nfunc TestExtJSONValue(t *testing.T) {\n\tt.Run(\"Large Date\", func(t *testing.T) {\n\t\tval := &extJSONValue{\n\t\t\tt: TypeString,\n\t\t\tv: \"3001-01-01T00:00:00Z\",\n\t\t}\n\n\t\tintVal, err := val.parseDateTime()\n\t\tif err != nil {\n\t\t\tt.Fatalf(\"error parsing date time: %v\", err)\n\t\t}\n\n\t\tif intVal <= 0 {\n\t\t\tt.Fatalf(\"expected value above 0, got %v\", intVal)\n\t\t}\n\t})\n\tt.Run(\"fallback time format\", func(t *testing.T) {\n\t\tval := &extJSONValue{\n\t\t\tt: TypeString,\n\t\t\tv: \"2019-06-04T14:54:31.416+0000\",\n\t\t}\n\n\t\t_, err := val.parseDateTime()\n\t\tif err != nil {\n\t\t\tt.Fatalf(\"error parsing date time: %v\", err)\n\t\t}\n\t})\n}\n" }, { "path": "bson/extjson_prose_test.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"fmt\"\n\t\"testing\"\n\n\t\"go.mongodb.org/mongo-driver/v2/internal/assert\"\n)\n\nfunc TestExtJSON(t *testing.T) {\n\ttimestampNegativeInt32Err := fmt.Errorf(\"$timestamp i number should be uint32: -1\")\n\ttimestampNegativeInt64Err := fmt.Errorf(\"$timestamp i number should be uint32: -2147483649\")\n\ttimestampLargeValueErr := fmt.Errorf(\"$timestamp i number should be uint32: 4294967296\")\n\n\ttestCases := []struct {\n\t\tname string\n\t\tinput string\n\t\tcanonical bool\n\t\terr error\n\t}{\n\t\t{\"timestamp - negative int32 value\", `{\"\":{\"$timestamp\":{\"t\":0,\"i\":-1}}}`, false, timestampNegativeInt32Err},\n\t\t{\"timestamp - negative int64 value\", `{\"\":{\"$timestamp\":{\"t\":0,\"i\":-2147483649}}}`, false, timestampNegativeInt64Err},\n\t\t{\"timestamp - value overflows uint32\", `{\"\":{\"$timestamp\":{\"t\":0,\"i\":4294967296}}}`, false, timestampLargeValueErr},\n\t\t{\"top level key is not treated as special\", `{\"$code\": \"foo\"}`, false, nil},\n\t\t{\"escaped single quote errors\", `{\"f\\'oo\": \"bar\"}`, false, ErrInvalidJSON},\n\t}\n\tfor _, tc := range testCases {\n\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\tvar res Raw\n\t\t\terr := UnmarshalExtJSON([]byte(tc.input), tc.canonical, &res)\n\t\t\tif tc.err == nil {\n\t\t\t\tassert.Nil(t, err, \"UnmarshalExtJSON error: %v\", err)\n\t\t\t\treturn\n\t\t\t}\n\n\t\t\tassert.NotNil(t, err, \"expected error %v, got nil\", tc.err)\n\t\t\tassert.Equal(t, tc.err.Error(), err.Error(), \"expected error %v, got %v\", tc.err, err)\n\t\t})\n\t}\n}\n" }, { "path": "bson/extjson_reader.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"errors\"\n\t\"fmt\"\n\t\"io\"\n)\n\ntype ejvrState struct {\n\tmode mode\n\tvType Type\n\tdepth int\n}\n\n// extJSONValueReader is for reading extended JSON.\ntype extJSONValueReader struct {\n\tp *extJSONParser\n\n\tstack []ejvrState\n\tframe int\n}\n\n// NewExtJSONValueReader returns a ValueReader that reads Extended JSON values\n// from r. If canonicalOnly is true, reading values from the ValueReader returns\n// an error if the Extended JSON was not marshaled in canonical mode.\nfunc NewExtJSONValueReader(r io.Reader, canonicalOnly bool) (ValueReader, error) {\n\treturn newExtJSONValueReader(r, canonicalOnly)\n}\n\nfunc newExtJSONValueReader(r io.Reader, canonicalOnly bool) (*extJSONValueReader, error) {\n\tejvr := new(extJSONValueReader)\n\treturn ejvr.reset(r, canonicalOnly)\n}\n\nfunc (ejvr *extJSONValueReader) reset(r io.Reader, canonicalOnly bool) (*extJSONValueReader, error) {\n\tp := newExtJSONParser(r, canonicalOnly)\n\ttyp, err := p.peekType()\n\tif err != nil {\n\t\treturn nil, ErrInvalidJSON\n\t}\n\n\tvar m mode\n\tswitch typ {\n\tcase TypeEmbeddedDocument:\n\t\tm = mTopLevel\n\tcase TypeArray:\n\t\tm = mArray\n\tdefault:\n\t\tm = mValue\n\t}\n\n\tstack := make([]ejvrState, 1, 5)\n\tstack[0] = ejvrState{\n\t\tmode: m,\n\t\tvType: typ,\n\t}\n\treturn &extJSONValueReader{\n\t\tp: p,\n\t\tstack: stack,\n\t}, nil\n}\n\nfunc (ejvr *extJSONValueReader) advanceFrame() {\n\tif ejvr.frame+1 >= len(ejvr.stack) { // We need to grow the stack\n\t\tlength := len(ejvr.stack)\n\t\tif length+1 >= cap(ejvr.stack) {\n\t\t\t// double it\n\t\t\tbuf := make([]ejvrState, 2*cap(ejvr.stack)+1)\n\t\t\tcopy(buf, ejvr.stack)\n\t\t\tejvr.stack = buf\n\t\t}\n\t\tejvr.stack = ejvr.stack[:length+1]\n\t}\n\tejvr.frame++\n\n\t// Clean the stack\n\tejvr.stack[ejvr.frame].mode = 0\n\tejvr.stack[ejvr.frame].vType = 0\n\tejvr.stack[ejvr.frame].depth = 0\n}\n\nfunc (ejvr *extJSONValueReader) pushDocument() {\n\tejvr.advanceFrame()\n\n\tejvr.stack[ejvr.frame].mode = mDocument\n\tejvr.stack[ejvr.frame].depth = ejvr.p.depth\n}\n\nfunc (ejvr *extJSONValueReader) pushCodeWithScope() {\n\tejvr.advanceFrame()\n\n\tejvr.stack[ejvr.frame].mode = mCodeWithScope\n}\n\nfunc (ejvr *extJSONValueReader) pushArray() {\n\tejvr.advanceFrame()\n\n\tejvr.stack[ejvr.frame].mode = mArray\n}\n\nfunc (ejvr *extJSONValueReader) push(m mode, t Type) {\n\tejvr.advanceFrame()\n\n\tejvr.stack[ejvr.frame].mode = m\n\tejvr.stack[ejvr.frame].vType = t\n}\n\nfunc (ejvr *extJSONValueReader) pop() {\n\tswitch ejvr.stack[ejvr.frame].mode {\n\tcase mElement, mValue:\n\t\tejvr.frame--\n\tcase mDocument, mArray, mCodeWithScope:\n\t\tejvr.frame -= 2 // we pop twice to jump over the vrElement: vrDocument -> vrElement -> vrDocument/TopLevel/etc...\n\t}\n}\n\nfunc (ejvr *extJSONValueReader) skipObject() {\n\t// read entire object until depth returns to 0 (last ending } or ] seen)\n\tdepth := 1\n\tfor depth > 0 {\n\t\tejvr.p.advanceState()\n\n\t\t// If object is empty, raise depth and continue. When emptyObject is true, the\n\t\t// parser has already read both the opening and closing brackets of an empty\n\t\t// object (\"{}\"), so the next valid token will be part of the parent document,\n\t\t// not part of the nested document.\n\t\t//\n\t\t// If there is a comma, there are remaining fields, emptyObject must be set back\n\t\t// to false, and comma must be skipped with advanceState().\n\t\tif ejvr.p.emptyObject {\n\t\t\tif ejvr.p.s == jpsSawComma {\n\t\t\t\tejvr.p.emptyObject = false\n\t\t\t\tejvr.p.advanceState()\n\t\t\t}\n\t\t\tdepth--\n\t\t\tcontinue\n\t\t}\n\n\t\tswitch ejvr.p.s {\n\t\tcase jpsSawBeginObject, jpsSawBeginArray:\n\t\t\tdepth++\n\t\tcase jpsSawEndObject, jpsSawEndArray:\n\t\t\tdepth--\n\t\t}\n\t}\n}\n\nfunc (ejvr *extJSONValueReader) invalidTransitionErr(destination mode, name string, modes []mode) error {\n\tte := TransitionError{\n\t\tname: name,\n\t\tcurrent: ejvr.stack[ejvr.frame].mode,\n\t\tdestination: destination,\n\t\tmodes: modes,\n\t\taction: \"read\",\n\t}\n\tif ejvr.frame != 0 {\n\t\tte.parent = ejvr.stack[ejvr.frame-1].mode\n\t}\n\treturn te\n}\n\nfunc (ejvr *extJSONValueReader) typeError(t Type) error {\n\treturn fmt.Errorf(\"positioned on %s, but attempted to read %s\", ejvr.stack[ejvr.frame].vType, t)\n}\n\nfunc (ejvr *extJSONValueReader) ensureElementValue(t Type, destination mode, callerName string, addModes ...mode) error {\n\tswitch ejvr.stack[ejvr.frame].mode {\n\tcase mElement, mValue:\n\t\tif ejvr.stack[ejvr.frame].vType != t {\n\t\t\treturn ejvr.typeError(t)\n\t\t}\n\tdefault:\n\t\tmodes := []mode{mElement, mValue}\n\t\tif addModes != nil {\n\t\t\tmodes = append(modes, addModes...)\n\t\t}\n\t\treturn ejvr.invalidTransitionErr(destination, callerName, modes)\n\t}\n\n\treturn nil\n}\n\nfunc (ejvr *extJSONValueReader) Type() Type {\n\treturn ejvr.stack[ejvr.frame].vType\n}\n\nfunc (ejvr *extJSONValueReader) Skip() error {\n\tswitch ejvr.stack[ejvr.frame].mode {\n\tcase mElement, mValue:\n\tdefault:\n\t\treturn ejvr.invalidTransitionErr(0, \"Skip\", []mode{mElement, mValue})\n\t}\n\n\tdefer ejvr.pop()\n\n\tt := ejvr.stack[ejvr.frame].vType\n\tswitch t {\n\tcase TypeArray, TypeEmbeddedDocument, TypeCodeWithScope:\n\t\t// read entire array, doc or CodeWithScope\n\t\tejvr.skipObject()\n\tdefault:\n\t\t_, err := ejvr.p.readValue(t)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t}\n\n\treturn nil\n}\n\nfunc (ejvr *extJSONValueReader) ReadArray() (ArrayReader, error) {\n\tswitch ejvr.stack[ejvr.frame].mode {\n\tcase mTopLevel: // allow reading array from top level\n\tcase mArray:\n\t\treturn ejvr, nil\n\tdefault:\n\t\tif err := ejvr.ensureElementValue(TypeArray, mArray, \"ReadArray\", mTopLevel, mArray); err != nil {\n\t\t\treturn nil, err\n\t\t}\n\t}\n\n\tejvr.pushArray()\n\n\treturn ejvr, nil\n}\n\nfunc (ejvr *extJSONValueReader) ReadBinary() (b []byte, btype byte, err error) {\n\tif err := ejvr.ensureElementValue(TypeBinary, 0, \"ReadBinary\"); err != nil {\n\t\treturn nil, 0, err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeBinary)\n\tif err != nil {\n\t\treturn nil, 0, err\n\t}\n\n\tb, btype, err = v.parseBinary()\n\n\tejvr.pop()\n\treturn b, btype, err\n}\n\nfunc (ejvr *extJSONValueReader) ReadBoolean() (bool, error) {\n\tif err := ejvr.ensureElementValue(TypeBoolean, 0, \"ReadBoolean\"); err != nil {\n\t\treturn false, err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeBoolean)\n\tif err != nil {\n\t\treturn false, err\n\t}\n\n\tif v.t != TypeBoolean {\n\t\treturn false, fmt.Errorf(\"expected type bool, but got type %s\", v.t)\n\t}\n\n\tejvr.pop()\n\treturn v.v.(bool), nil\n}\n\nfunc (ejvr *extJSONValueReader) ReadDocument() (DocumentReader, error) {\n\tswitch ejvr.stack[ejvr.frame].mode {\n\tcase mTopLevel:\n\t\treturn ejvr, nil\n\tcase mElement, mValue:\n\t\tif ejvr.stack[ejvr.frame].vType != TypeEmbeddedDocument {\n\t\t\treturn nil, ejvr.typeError(TypeEmbeddedDocument)\n\t\t}\n\n\t\tejvr.pushDocument()\n\t\treturn ejvr, nil\n\tdefault:\n\t\treturn nil, ejvr.invalidTransitionErr(mDocument, \"ReadDocument\", []mode{mTopLevel, mElement, mValue})\n\t}\n}\n\nfunc (ejvr *extJSONValueReader) ReadCodeWithScope() (code string, dr DocumentReader, err error) {\n\tif err = ejvr.ensureElementValue(TypeCodeWithScope, 0, \"ReadCodeWithScope\"); err != nil {\n\t\treturn \"\", nil, err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeCodeWithScope)\n\tif err != nil {\n\t\treturn \"\", nil, err\n\t}\n\n\tcode, err = v.parseJavascript()\n\n\tejvr.pushCodeWithScope()\n\treturn code, ejvr, err\n}\n\nfunc (ejvr *extJSONValueReader) ReadDBPointer() (ns string, oid ObjectID, err error) {\n\tif err = ejvr.ensureElementValue(TypeDBPointer, 0, \"ReadDBPointer\"); err != nil {\n\t\treturn \"\", NilObjectID, err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeDBPointer)\n\tif err != nil {\n\t\treturn \"\", NilObjectID, err\n\t}\n\n\tns, oid, err = v.parseDBPointer()\n\n\tejvr.pop()\n\treturn ns, oid, err\n}\n\nfunc (ejvr *extJSONValueReader) ReadDateTime() (int64, error) {\n\tif err := ejvr.ensureElementValue(TypeDateTime, 0, \"ReadDateTime\"); err != nil {\n\t\treturn 0, err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeDateTime)\n\tif err != nil {\n\t\treturn 0, err\n\t}\n\n\td, err := v.parseDateTime()\n\n\tejvr.pop()\n\treturn d, err\n}\n\nfunc (ejvr *extJSONValueReader) ReadDecimal128() (Decimal128, error) {\n\tif err := ejvr.ensureElementValue(TypeDecimal128, 0, \"ReadDecimal128\"); err != nil {\n\t\treturn Decimal128{}, err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeDecimal128)\n\tif err != nil {\n\t\treturn Decimal128{}, err\n\t}\n\n\td, err := v.parseDecimal128()\n\n\tejvr.pop()\n\treturn d, err\n}\n\nfunc (ejvr *extJSONValueReader) ReadDouble() (float64, error) {\n\tif err := ejvr.ensureElementValue(TypeDouble, 0, \"ReadDouble\"); err != nil {\n\t\treturn 0, err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeDouble)\n\tif err != nil {\n\t\treturn 0, err\n\t}\n\n\td, err := v.parseDouble()\n\n\tejvr.pop()\n\treturn d, err\n}\n\nfunc (ejvr *extJSONValueReader) ReadInt32() (int32, error) {\n\tif err := ejvr.ensureElementValue(TypeInt32, 0, \"ReadInt32\"); err != nil {\n\t\treturn 0, err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeInt32)\n\tif err != nil {\n\t\treturn 0, err\n\t}\n\n\ti, err := v.parseInt32()\n\n\tejvr.pop()\n\treturn i, err\n}\n\nfunc (ejvr *extJSONValueReader) ReadInt64() (int64, error) {\n\tif err := ejvr.ensureElementValue(TypeInt64, 0, \"ReadInt64\"); err != nil {\n\t\treturn 0, err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeInt64)\n\tif err != nil {\n\t\treturn 0, err\n\t}\n\n\ti, err := v.parseInt64()\n\n\tejvr.pop()\n\treturn i, err\n}\n\nfunc (ejvr *extJSONValueReader) ReadJavascript() (code string, err error) {\n\tif err = ejvr.ensureElementValue(TypeJavaScript, 0, \"ReadJavascript\"); err != nil {\n\t\treturn \"\", err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeJavaScript)\n\tif err != nil {\n\t\treturn \"\", err\n\t}\n\n\tcode, err = v.parseJavascript()\n\n\tejvr.pop()\n\treturn code, err\n}\n\nfunc (ejvr *extJSONValueReader) ReadMaxKey() error {\n\tif err := ejvr.ensureElementValue(TypeMaxKey, 0, \"ReadMaxKey\"); err != nil {\n\t\treturn err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeMaxKey)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\terr = v.parseMinMaxKey(\"max\")\n\n\tejvr.pop()\n\treturn err\n}\n\nfunc (ejvr *extJSONValueReader) ReadMinKey() error {\n\tif err := ejvr.ensureElementValue(TypeMinKey, 0, \"ReadMinKey\"); err != nil {\n\t\treturn err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeMinKey)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\terr = v.parseMinMaxKey(\"min\")\n\n\tejvr.pop()\n\treturn err\n}\n\nfunc (ejvr *extJSONValueReader) ReadNull() error {\n\tif err := ejvr.ensureElementValue(TypeNull, 0, \"ReadNull\"); err != nil {\n\t\treturn err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeNull)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\tif v.t != TypeNull {\n\t\treturn fmt.Errorf(\"expected type null but got type %s\", v.t)\n\t}\n\n\tejvr.pop()\n\treturn nil\n}\n\nfunc (ejvr *extJSONValueReader) ReadObjectID() (ObjectID, error) {\n\tif err := ejvr.ensureElementValue(TypeObjectID, 0, \"ReadObjectID\"); err != nil {\n\t\treturn ObjectID{}, err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeObjectID)\n\tif err != nil {\n\t\treturn ObjectID{}, err\n\t}\n\n\toid, err := v.parseObjectID()\n\n\tejvr.pop()\n\treturn oid, err\n}\n\nfunc (ejvr *extJSONValueReader) ReadRegex() (pattern string, options string, err error) {\n\tif err = ejvr.ensureElementValue(TypeRegex, 0, \"ReadRegex\"); err != nil {\n\t\treturn \"\", \"\", err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeRegex)\n\tif err != nil {\n\t\treturn \"\", \"\", err\n\t}\n\n\tpattern, options, err = v.parseRegex()\n\n\tejvr.pop()\n\treturn pattern, options, err\n}\n\nfunc (ejvr *extJSONValueReader) ReadString() (string, error) {\n\tif err := ejvr.ensureElementValue(TypeString, 0, \"ReadString\"); err != nil {\n\t\treturn \"\", err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeString)\n\tif err != nil {\n\t\treturn \"\", err\n\t}\n\n\tif v.t != TypeString {\n\t\treturn \"\", fmt.Errorf(\"expected type string but got type %s\", v.t)\n\t}\n\n\tejvr.pop()\n\treturn v.v.(string), nil\n}\n\nfunc (ejvr *extJSONValueReader) ReadSymbol() (symbol string, err error) {\n\tif err = ejvr.ensureElementValue(TypeSymbol, 0, \"ReadSymbol\"); err != nil {\n\t\treturn \"\", err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeSymbol)\n\tif err != nil {\n\t\treturn \"\", err\n\t}\n\n\tsymbol, err = v.parseSymbol()\n\n\tejvr.pop()\n\treturn symbol, err\n}\n\nfunc (ejvr *extJSONValueReader) ReadTimestamp() (t uint32, i uint32, err error) {\n\tif err = ejvr.ensureElementValue(TypeTimestamp, 0, \"ReadTimestamp\"); err != nil {\n\t\treturn 0, 0, err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeTimestamp)\n\tif err != nil {\n\t\treturn 0, 0, err\n\t}\n\n\tt, i, err = v.parseTimestamp()\n\n\tejvr.pop()\n\treturn t, i, err\n}\n\nfunc (ejvr *extJSONValueReader) ReadUndefined() error {\n\tif err := ejvr.ensureElementValue(TypeUndefined, 0, \"ReadUndefined\"); err != nil {\n\t\treturn err\n\t}\n\n\tv, err := ejvr.p.readValue(TypeUndefined)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\terr = v.parseUndefined()\n\n\tejvr.pop()\n\treturn err\n}\n\nfunc (ejvr *extJSONValueReader) ReadElement() (string, ValueReader, error) {\n\tswitch ejvr.stack[ejvr.frame].mode {\n\tcase mTopLevel, mDocument, mCodeWithScope:\n\tdefault:\n\t\treturn \"\", nil, ejvr.invalidTransitionErr(mElement, \"ReadElement\", []mode{mTopLevel, mDocument, mCodeWithScope})\n\t}\n\n\tname, t, err := ejvr.p.readKey()\n\tif err != nil {\n\t\tif errors.Is(err, ErrEOD) {\n\t\t\tif ejvr.stack[ejvr.frame].mode == mCodeWithScope {\n\t\t\t\t_, err := ejvr.p.peekType()\n\t\t\t\tif err != nil {\n\t\t\t\t\treturn \"\", nil, err\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tejvr.pop()\n\t\t}\n\n\t\treturn \"\", nil, err\n\t}\n\n\tejvr.push(mElement, t)\n\treturn name, ejvr, nil\n}\n\nfunc (ejvr *extJSONValueReader) ReadValue() (ValueReader, error) {\n\tswitch ejvr.stack[ejvr.frame].mode {\n\tcase mArray:\n\tdefault:\n\t\treturn nil, ejvr.invalidTransitionErr(mValue, \"ReadValue\", []mode{mArray})\n\t}\n\n\tt, err := ejvr.p.peekType()\n\tif err != nil {\n\t\tif errors.Is(err, ErrEOA) {\n\t\t\tejvr.pop()\n\t\t}\n\n\t\treturn nil, err\n\t}\n\n\tejvr.push(mValue, t)\n\treturn ejvr, nil\n}\n" }, { "path": "bson/extjson_reader_test.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\npackage bson\n\nimport (\n\t\"errors\"\n\t\"fmt\"\n\t\"io\"\n\t\"strings\"\n\t\"testing\"\n\n\t\"github.com/google/go-cmp/cmp\"\n\t\"go.mongodb.org/mongo-driver/v2/internal/assert\"\n)\n\nfunc TestExtJSONReader(t *testing.T) {\n\tt.Run(\"ReadDocument\", func(t *testing.T) {\n\t\tt.Run(\"EmbeddedDocument\", func(t *testing.T) {\n\t\t\tejvr := &extJSONValueReader{\n\t\t\t\tstack: []ejvrState{\n\t\t\t\t\t{mode: mTopLevel},\n\t\t\t\t\t{mode: mElement, vType: TypeBoolean},\n\t\t\t\t},\n\t\t\t\tframe: 1,\n\t\t\t}\n\n\t\t\tejvr.stack[1].mode = mArray\n\t\t\twanterr := ejvr.invalidTransitionErr(mDocument, \"ReadDocument\", []mode{mTopLevel, mElement, mValue})\n\t\t\t_, err := ejvr.ReadDocument()\n\t\t\tif err == nil || err.Error() != wanterr.Error() {\n\t\t\t\tt.Errorf(\"Incorrect returned error. got %v; want %v\", err, wanterr)\n\t\t\t}\n\t\t})\n\t})\n\n\tt.Run(\"invalid transition\", func(t *testing.T) {\n\t\tt.Run(\"Skip\", func(t *testing.T) {\n\t\t\tejvr := &extJSONValueReader{stack: []ejvrState{{mode: mTopLevel}}}\n\t\t\twanterr := (&extJSONValueReader{stack: []ejvrState{{mode: mTopLevel}}}).invalidTransitionErr(0, \"Skip\", []mode{mElement, mValue})\n\t\t\tgoterr := ejvr.Skip()\n\t\t\tif !cmp.Equal(goterr, wanterr, cmp.Comparer(assert.CompareErrors)) {\n\t\t\t\tt.Errorf(\"Expected correct invalid transition error. got %v; want %v\", goterr, wanterr)\n\t\t\t}\n\t\t})\n\t})\n}\n\nfunc TestReadMultipleTopLevelDocuments(t *testing.T) {\n\ttestCases := []struct {\n\t\tname string\n\t\tinput string\n\t\texpected [][]byte\n\t}{\n\t\t{\n\t\t\t\"single top-level document\",\n\t\t\t\"{\\\"foo\\\":1}\",\n\t\t\t[][]byte{\n\t\t\t\t{0x0E, 0x00, 0x00, 0x00, 0x10, 'f', 'o', 'o', 0x00, 0x01, 0x00, 0x00, 0x00, 0x00},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"single top-level document with leading and trailing whitespace\",\n\t\t\t\"\\n\\n {\\\"foo\\\":1} \\n\",\n\t\t\t[][]byte{\n\t\t\t\t{0x0E, 0x00, 0x00, 0x00, 0x10, 'f', 'o', 'o', 0x00, 0x01, 0x00, 0x00, 0x00, 0x00},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"two top-level documents\",\n\t\t\t\"{\\\"foo\\\":1}{\\\"foo\\\":2}\",\n\t\t\t[][]byte{\n\t\t\t\t{0x0E, 0x00, 0x00, 0x00, 0x10, 'f', 'o', 'o', 0x00, 0x01, 0x00, 0x00, 0x00, 0x00},\n\t\t\t\t{0x0E, 0x00, 0x00, 0x00, 0x10, 'f', 'o', 'o', 0x00, 0x02, 0x00, 0x00, 0x00, 0x00},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"two top-level documents with leading and trailing whitespace and whitespace separation \",\n\t\t\t\"\\n\\n {\\\"foo\\\":1}\\n{\\\"foo\\\":2}\\n \",\n\t\t\t[][]byte{\n\t\t\t\t{0x0E, 0x00, 0x00, 0x00, 0x10, 'f', 'o', 'o', 0x00, 0x01, 0x00, 0x00, 0x00, 0x00},\n\t\t\t\t{0x0E, 0x00, 0x00, 0x00, 0x10, 'f', 'o', 'o', 0x00, 0x02, 0x00, 0x00, 0x00, 0x00},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"top-level array with single document\",\n\t\t\t\"[{\\\"foo\\\":1}]\",\n\t\t\t[][]byte{\n\t\t\t\t{0x0E, 0x00, 0x00, 0x00, 0x10, 'f', 'o', 'o', 0x00, 0x01, 0x00, 0x00, 0x00, 0x00},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\t\"top-level array with 2 documents\",\n\t\t\t\"[{\\\"foo\\\":1},{\\\"foo\\\":2}]\",\n\t\t\t[][]byte{\n\t\t\t\t{0x0E, 0x00, 0x00, 0x00, 0x10, 'f', 'o', 'o', 0x00, 0x01, 0x00, 0x00, 0x00, 0x00},\n\t\t\t\t{0x0E, 0x00, 0x00, 0x00, 0x10, 'f', 'o', 'o', 0x00, 0x02, 0x00, 0x00, 0x00, 0x00},\n\t\t\t},\n\t\t},\n\t}\n\n\tfor _, tc := range testCases {\n\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\tr := strings.NewReader(tc.input)\n\t\t\tvr, err := NewExtJSONValueReader(r, false)\n\t\t\tif err != nil {\n\t\t\t\tt.Fatalf(\"expected no error, but got %v\", err)\n\t\t\t}\n\n\t\t\tactual, err := readAllDocuments(vr)\n\t\t\tif err != nil {\n\t\t\t\tt.Fatalf(\"expected no error, but got %v\", err)\n\t\t\t}\n\n\t\t\tif diff := cmp.Diff(tc.expected, actual); diff != \"\" {\n\t\t\t\tt.Fatalf(\"expected does not match actual: %v\", diff)\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc readAllDocuments(vr ValueReader) ([][]byte, error) {\n\tvar actual [][]byte\n\n\tswitch vr.Type() {\n\tcase TypeEmbeddedDocument:\n\t\tfor {\n\t\t\tresult, err := copyDocumentToBytes(vr)\n\t\t\tif err != nil {\n\t\t\t\tif errors.Is(err, io.EOF) {\n\t\t\t\t\tbreak\n\t\t\t\t}\n\t\t\t\treturn nil, err\n\t\t\t}\n\n\t\t\tactual = append(actual, result)\n\t\t}\n\tcase TypeArray:\n\t\tar, err := vr.ReadArray()\n\t\tif err != nil {\n\t\t\treturn nil, err\n\t\t}\n\t\tfor {\n\t\t\tevr, err := ar.ReadValue()\n\t\t\tif err != nil {\n\t\t\t\tif errors.Is(err, ErrEOA) {\n\t\t\t\t\tbreak\n\t\t\t\t}\n\t\t\t\treturn nil, err\n\t\t\t}\n\n\t\t\tresult, err := copyDocumentToBytes(evr)\n\t\t\tif err != nil {\n\t\t\t\treturn nil, err\n\t\t\t}\n\n\t\t\tactual = append(actual, result)\n\t\t}\n\tdefault:\n\t\treturn nil, fmt.Errorf(\"expected an array or a document, but got %s\", vr.Type())\n\t}\n\n\treturn actual, nil\n}\n" }, { "path": "bson/extjson_tables.go", "content": "// Copyright (C) MongoDB, Inc. 2017-present.\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\"); you may\n// not use this file except in compliance with the License. You may obtain\n// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n//\n// Based on github.com/golang/go by The Go Authors\n// See THIRD-PARTY-NOTICES for original license terms.\n\npackage bson\n\nimport \"unicode/utf8\"\n\n// safeSet holds the value true if the ASCII character with the given array\n// position can be represented inside a JSON string without any further\n// escaping.\n//\n// All values are true except for the ASCII control characters (0-31), the\n// double quote (\"), and the backslash character (\"\\\").\nvar safeSet = [utf8.RuneSelf]bool{\n\t' ': true,\n\t'!': true,\n\t'\"': false,\n\t'#': true,\n\t'$': true,\n\t'%': true,\n\t'&': true,\n\t'\\'': true,\n\t'(': true,\n\t')': true,\n\t'*': true,\n\t'+': true,\n\t',': true,\n\t'-': true,\n\t'.': true,\n\t'/': true,\n\t'0': true,\n\t'1': true,\n\t'2': true,\n\t'3': true,\n\t'4': true,\n\t'5': true,\n\t'6': true,\n\t'7': true,\n\t'8': true,\n\t'9': true,\n\t':': true,\n\t';': true,\n\t'<': true,\n\t'=': true,\n\t'>': true,\n\t'?': true,\n\t'@': true,\n\t'A': true,\n\t'B': true,\n\t'C': true,\n\t'D': true,\n\t'E': true,\n\t'F': true,\n\t'G': true,\n\t'H': true,\n\t'I': true,\n\t'J': true,\n\t'K': true,\n\t'L': true,\n\t'M': true,\n\t'N': true,\n\t'O': true,\n\t'P': true,\n\t'Q': true,\n\t'R': true,\n\t'S': true,\n\t'T': true,\n\t'U': true,\n\t'V': true,\n\t'W': true,\n\t'X': true,\n\t'Y': true,\n\t'Z': true,\n\t'[': true,\n\t'\\\\': false,\n\t']': true,\n\t'^': true,\n\t'_': true,\n\t'`': true,\n\t'a': true,\n\t'b': true,\n\t'c': true,\n\t'd': true,\n\t'e': true,\n\t'f': true,\n\t'g': true,\n\t'h': true,\n\t'i': true,\n\t'j': true,\n\t'k': true,\n\t'l': true,\n\t'm': true,\n\t'n': true,\n\t'o': true,\n\t'p': true,\n\t'q': true,\n\t'r': true,\n\t's': true,\n\t't': true,\n\t'u': true,\n\t'v': true,\n\t'w': true,\n\t'x': true,\n\t'y': true,\n\t'z': true,\n\t'{': true,\n\t'|': true,\n\t'}': true,\n\t'~': true,\n\t'\\u007f': true,\n}\n\n// htmlSafeSet holds the value true if the ASCII character with the given\n// array position can be safely represented inside a JSON string, embedded\n// inside of HTML