{"id":37955430,"url":"https://github.com/alexejk/go-xmlrpc","last_synced_at":"2026-01-16T18:00:18.362Z","repository":{"id":38339597,"uuid":"231465660","full_name":"alexejk/go-xmlrpc","owner":"alexejk","description":"An XML-RPC Client for Go","archived":false,"fork":false,"pushed_at":"2025-12-11T18:30:13.000Z","size":174,"stargazers_count":22,"open_issues_count":0,"forks_count":9,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-12T23:09:40.103Z","etag":null,"topics":["xml-rpc","xml-rpc-client"],"latest_commit_sha":null,"homepage":"https://alexejk.io/article/handling-xmlrpc-in-go/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexejk.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-01-02T21:55:17.000Z","updated_at":"2025-12-11T18:29:30.000Z","dependencies_parsed_at":"2024-04-09T10:29:32.210Z","dependency_job_id":"1152fa67-b593-454d-ab3f-78ab0225eca3","html_url":"https://github.com/alexejk/go-xmlrpc","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":"alexejk/go-template","purl":"pkg:github/alexejk/go-xmlrpc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexejk%2Fgo-xmlrpc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexejk%2Fgo-xmlrpc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexejk%2Fgo-xmlrpc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexejk%2Fgo-xmlrpc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexejk","download_url":"https://codeload.github.com/alexejk/go-xmlrpc/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexejk%2Fgo-xmlrpc/sbom","scorecard":{"id":181261,"data":{"date":"2025-08-11","repo":{"name":"github.com/alexejk/go-xmlrpc","commit":"3b4b8e961ff0a84974092f460f55131448d6866a"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.7,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/11 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":6,"reason":"8 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 6","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/build.yml:1","Warn: no topLevel permission defined: .github/workflows/release.yml:1","Warn: no topLevel permission defined: .github/workflows/stale-issues.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/alexejk/go-xmlrpc/build.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/alexejk/go-xmlrpc/build.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/alexejk/go-xmlrpc/build.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/alexejk/go-xmlrpc/release.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/alexejk/go-xmlrpc/release.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/stale-issues.yml:10: update your workflow using https://app.stepsecurity.io/secureworkflow/alexejk/go-xmlrpc/stale-issues.yml/master?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:1: pin your Docker image by updating golang:1.24-alpine to golang:1.24-alpine@sha256:c8c5f95d64aa79b6547f3b626eb84b16a7ce18a139e3e9ca19a8c078b85ba80d","Warn: downloadThenRun not pinned by hash: hack/linter.sh:20","Info:   0 out of   3 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   3 third-party GitHubAction dependencies pinned","Info:   0 out of   1 containerImage dependencies pinned","Info:   0 out of   1 downloadThenRun dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":4,"reason":"SAST tool is not run on all commits -- score normalized to 4","details":["Warn: 10 commits out of 23 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-16T18:54:48.628Z","repository_id":38339597,"created_at":"2025-08-16T18:54:48.629Z","updated_at":"2025-08-16T18:54:48.629Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28480513,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["xml-rpc","xml-rpc-client"],"created_at":"2026-01-16T18:00:13.366Z","updated_at":"2026-01-16T18:00:18.059Z","avatar_url":"https://github.com/alexejk.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# XML-RPC Client for Go\n\nThis is an implementation of client-side part of XML-RPC protocol in Go.\n\n![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/alexejk/go-xmlrpc/build.yml?branch=master)\n[![codecov](https://codecov.io/gh/alexejk/go-xmlrpc/branch/master/graph/badge.svg)](https://codecov.io/gh/alexejk/go-xmlrpc)\n[![Go Report Card](https://goreportcard.com/badge/alexejk.io/go-xmlrpc)](https://goreportcard.com/report/alexejk.io/go-xmlrpc)\n\n[![GoDoc](https://godoc.org/alexejk.io/go-xmlrpc?status.svg)](https://godoc.org/alexejk.io/go-xmlrpc)\n![GitHub](https://img.shields.io/github/license/alexejk/go-xmlrpc)\n![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/alexejk/go-xmlrpc)\n\n\n## Usage\n\nAdd dependency to your project:\n\n```shell\ngo get -u alexejk.io/go-xmlrpc\n```\n\nUse it by creating an `*xmlrpc.Client` and firing RPC method calls with `Call()`.\n\n```go\npackage main\n\nimport(\n    \"fmt\"\n\n    \"alexejk.io/go-xmlrpc\"\n)\n\nfunc main() {\n    client, _ := xmlrpc.NewClient(\"https://bugzilla.mozilla.org/xmlrpc.cgi\")\n    defer client.Close()\n\t\n    result := \u0026struct {\n        BugzillaVersion struct {\n            Version string\n        }\n    }{}\n\n    _ = client.Call(\"Bugzilla.version\", nil, result)\n    fmt.Printf(\"Version: %s\\n\", result.BugzillaVersion.Version)\n}\n```\n\nCustomization is supported by passing a list of `Option` to the `NewClient` function. \nFor instance:\n\n - To customize any aspect of `http.Client` used to perform requests, use `HttpClient` option, otherwise `http.DefaultClient` will be used\n - To pass custom headers, make use of `Headers` option.\n - To not fail parsing when unmapped fields exist in RPC responses, use `SkipUnknownFields(true)` option (default is `false`)\n\n### Argument encoding\n\nArguments to the remote RPC method are passed on as a `*struct`. This struct is encoded into XML-RPC types based on following rules:\n\n* Order of fields in struct type matters - fields are taken in the order they are defined on the **type**.\n* Numbers are to be specified as `int` (encoded as `\u003cint\u003e`) or `float64` (encoded as `\u003cdouble\u003e`)\n* Both pointer and value references are accepted (pointers are followed to actual values)\n* `map[string]any` types are accepted and encoded into `\u003cstruct\u003e`\n\n**Shortcut:**  \nIf a single `\u003cstruct\u003e` argument is expected for the RPC method call, it is sometimes more convenient to pass a `map[string]any` as an argument without wrapping into `struct{}`. This `map[string]any` will be encoded into a single `\u003cstruct\u003e` argument with `\u003cmember\u003e` elements for each key-value pair.\nNo other key types are supported and neither is it possible to apply this approach with multiple arguments (or other types).\n\n**Order preservation:**  \nAs per XML-RPC specification, the order of `\u003cmember\u003e` elements in `\u003cstruct\u003e` is not defined. When using maps, order of members in a struct is undeterministic, thus it is not guaranteed that the order of `\u003cmember\u003e` elements will match the order of keys in the map (due to Go not preserving the order of keys).\nTo preserve the order, use a struct type with fields defined in the desired order (order is inherited from the struct type itself, not the instance).\n\n### Response decoding\n\nResponse is decoded following similar rules to argument encoding.\n\n* Order of fields is important.\n* Outer struct should contain exported field for each response parameter (it is possible to ignore unknown structs with `SkipUnknownFields` option).\n* Structs may contain pointers - they will be initialized if required.\n* Structs may be parsed as `map[string]any`, in case struct member names are not known at compile time. Map keys are enforced to `string` type.\n\n#### Character Encoding Support\n\nThe library automatically detects and handles character encodings in XML-RPC responses beyond UTF-8, including ISO-8859-1, Windows-1252, and other charsets commonly found in legacy XML-RPC services.\n\nCharacter encoding is automatically detected from the XML declaration (e.g., `\u003c?xml version=\"1.0\" encoding=\"ISO-8859-1\"?\u003e`), and the response is transparently converted to UTF-8 for Go string handling. This enables seamless interoperability with XML-RPC servers that don't use UTF-8 encoding.\n\n**Note:** This feature relies on the `golang.org/x/net/html/charset` package.\n\n#### Handling of Empty Values\n\nIf XML-RPC response contains no value for well-known data-types, it will be decoded into the default \"empty\" values as per table below:\n\n| XML-RPC Value           | Default Value |\n|-------------------------|--------------|\n| `\u003cstring/\u003e`             | `\"\"` |\n| `\u003cint/\u003e`, `\u003ci4/\u003e`       | `0` |\n| `\u003cboolean/\u003e`            | `false` |\n| `\u003cdouble/\u003e`             | `0.0` |\n| `\u003cdateTime.iso8601/\u003e`   | `time.Time{}` |\n| `\u003cbase64/\u003e`             | `nil` |\n| `\u003carray\u003e\u003cdata/\u003e\u003carray\u003e` | `nil` |\n\nAs per XML-RPC specification, `\u003cstruct\u003e` may not have an empty list of `\u003cmember\u003e` elements, thus no default \"empty\" value is defined for it.\nSimilarly, `\u003carray/\u003e` is considered invalid.\n\n### Field renaming\n\nXML-RPC specification does not necessarily specify any rules for struct's member names. Some services allow struct member names to include characters not compatible with standard Go field naming.\nTo support these use-cases, it is possible to remap the field by use of struct tag `xmlrpc`. \n\nFor example, if a response value is a struct that looks like this:\n\n```xml\n\u003cstruct\u003e\n    \u003cmember\u003e\n        \u003cname\u003estringValue\u003c/name\u003e\n        \u003cvalue\u003e\u003cstring\u003ebar\u003c/string\u003e\u003c/value\u003e\n    \u003c/member\u003e\n    \u003cmember\u003e\n        \u003cname\u003e2_numeric.Value\u003c/name\u003e\n        \u003cvalue\u003e\u003ci4\u003e2\u003c/i4\u003e\u003c/value\u003e\n    \u003c/member\u003e\n\u003c/struct\u003e\n```\n\nit would be impossible to map the second value to a Go struct with a field `2_numeric.Value` as it's not valid in Go.\nInstead, we can map it to any valid field as follows:\n\n```go\nv := \u0026struct {\n    StringValue string\n    SecondNumericValue string `xmlrpc:\"2_numeric.Value\"`\n}{}\n```\n\nSimilarly, request encoding honors `xmlrpc` tags.\n\n## Building\n\nTo build this project, simply run `make all`. \nIf you prefer building in Docker instead - `make build-in-docker` is your friend.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexejk%2Fgo-xmlrpc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexejk%2Fgo-xmlrpc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexejk%2Fgo-xmlrpc/lists"}