{"id":13880124,"url":"https://github.com/mongodb/bson-ruby","last_synced_at":"2025-11-11T20:55:55.150Z","repository":{"id":7985601,"uuid":"9390430","full_name":"mongodb/bson-ruby","owner":"mongodb","description":"Ruby Implementation of the BSON Specification (2.0.0+)","archived":false,"fork":false,"pushed_at":"2025-05-08T14:33:24.000Z","size":2335,"stargazers_count":79,"open_issues_count":3,"forks_count":107,"subscribers_count":39,"default_branch":"master","last_synced_at":"2025-05-11T11:38:17.385Z","etag":null,"topics":["mongodb","ruby"],"latest_commit_sha":null,"homepage":"http://bsonspec.org","language":"Ruby","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mongodb.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2013-04-12T09:01:30.000Z","updated_at":"2025-05-10T21:10:28.000Z","dependencies_parsed_at":"2024-06-13T17:53:48.366Z","dependency_job_id":"626d2556-8e39-43c5-8638-45a2a527a2db","html_url":"https://github.com/mongodb/bson-ruby","commit_stats":{"total_commits":1237,"total_committers":76,"mean_commits":"16.276315789473685","dds":0.5238480194017785,"last_synced_commit":"fac91a95573f66b81cd781a5c0fd92fbb1eae0ba"},"previous_names":[],"tags_count":75,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongodb%2Fbson-ruby","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongodb%2Fbson-ruby/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongodb%2Fbson-ruby/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongodb%2Fbson-ruby/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mongodb","download_url":"https://codeload.github.com/mongodb/bson-ruby/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253736102,"owners_count":21955782,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["mongodb","ruby"],"created_at":"2024-08-06T08:02:48.143Z","updated_at":"2025-11-11T20:55:55.119Z","avatar_url":"https://github.com/mongodb.png","language":"Ruby","readme":"BSON\n[![Gem Version][rubygems-img]][rubygems-url]\n[![Build Status][ghactions-img]][ghactions-url]\n====\n\nAn implementation of the BSON specification in Ruby.\n\nInstallation\n------------\n\nBSON can be installed via RubyGems:\n\n```\n\u003e gem install bson\n```\n\nOr by adding it to your project's Gemfile:\n\n```ruby\ngem 'bson'\n```\n\n### Release Integrity\n\nEach release of the BSON library for Ruby after version 5.0.0 has been automatically built and signed using the team's GPG key.\n\nTo verify the bson gem file:\n\n1. [Download the GPG key](https://pgp.mongodb.com/ruby-driver.asc).\n2. Import the key into your GPG keyring with `gpg --import ruby-driver.asc`.\n3. Download the gem file (if you don't already have it). You can download it from RubyGems with `gem fetch bson`, or you can download it from the [releases page](https://github.com/mongodb/bson-ruby/releases) on GitHub.\n4. Download the corresponding detached signature file from the [same release](https://github.com/mongodb/bson-ruby/releases). Look at the bottom of the release that corresponds to the gem file, under the 'Assets' list, for a `.sig` file with the same version number as the gem you wish to install.\n5. Verify the gem with `gpg --verify bson-X.Y.Z.gem.sig bson-X.Y.Z.gem` (replacing `X.Y.Z` with the actual version number).\n\nYou are looking for text like \"Good signature from \"MongoDB Ruby Driver Release Signing Key \u003cpackaging@mongodb.com\u003e\" in the output. If you see that, the signature was found to correspond to the given gem file.\n\n(Note that other output, like \"This key is not certified with a trusted signature!\", is related to *web of trust* and depends on how strongly you, personally, trust the `ruby-driver.asc` key that you downloaded from us. To learn more, see https://www.gnupg.org/gph/en/manual/x334.html)\n\n### Why not use RubyGems' gem-signing functionality?\n\nRubyGems' own gem signing is problematic, most significantly because there is no established chain of trust related to the keys used to sign gems. RubyGems' own documentation admits that \"this method of signing gems is not widely used\" (see https://guides.rubygems.org/security/). Discussions about this in the RubyGems community have been off-and-on for more than a decade, and while a solution will eventually arrive, we have settled on using GPG instead for the following reasons:\n\n1. Many of the other driver teams at MongoDB are using GPG to sign their product releases. Consistency with the other teams means that we can reuse existing tooling for our own product releases.\n2. GPG is widely available and has existing tools and procedures for dealing with web of trust (though they are admittedly quite arcane and intimidating to the uninitiated, unfortunately).\n\nUltimately, most users do not bother to verify gems, and will not be impacted by our choice of GPG over RubyGems' native method.\n\nCompatibility\n-------------\n\nBSON is tested against MRI (2.7+) and JRuby (9.3+).\n\nDocumentation\n-------------\n\nCurrent documentation can be found\n[here](https://www.mongodb.com/docs/ruby-driver/current/bson-tutorials/).\n\nAPI Documentation\n-----------------\n\nThe [API Documentation](https://www.mongodb.com/docs/ruby-driver/master/api/) is\nlocated at mongodb.com/docs.\n\nBSON Specification\n------------------\n\nThe [BSON specification](http://bsonspec.org) is at bsonspec.org.\n\n## Bugs \u0026 Feature Requests\n\nTo report a bug in the `bson` gem or request a feature:\n\n1. Visit [our issue tracker](https://jira.mongodb.org/) and login\n   (or create an account if you do not have one already).\n2. Navigate to the [RUBY project](https://jira.mongodb.org/browse/RUBY).\n3. Click 'Create Issue' and fill out all of the applicable form fields, making\nsure to select `BSON` in the _Component/s_ field.\n\nWhen creating an issue, please keep in mind that all information in JIRA\nfor the RUBY project, as well as the core server (the SERVER project),\nis publicly visible.\n\n**PLEASE DO:**\n\n- Provide as much information as possible about the issue.\n- Provide detailed steps for reproducing the issue.\n- Provide any applicable code snippets, stack traces and log data.\n- Specify version numbers of the `bson` gem and/or Ruby driver and MongoDB \nserver.\n\n**PLEASE DO NOT:**\n\n- Provide any sensitive data or server logs.\n- Report potential security issues publicly (see 'Security Issues' below).\n\n## Security Issues\n\nIf you have identified a potential security-related issue in the `bson` gem\n(or any other MongoDB product), please report it by following the\n[instructions here](https://www.mongodb.com/docs/manual/tutorial/create-a-vulnerability-report).\n\n## Product Feature Requests\n\nTo request a feature which is not specific to the `bson` gem, or which\naffects more than the `bson` gem and/or Ruby driver alone (for example, a \nfeature which requires MongoDB server support), please submit your idea through \nthe [MongoDB Feedback Forum](https://feedback.mongodb.com/forums/924286-drivers).\n\n## Maintenance and Bug Fix Policy\n\nNew library functionality is generally added in a backwards-compatible manner\nand results in new minor releases. Bug fixes are generally made on\nmaster first and are backported to the current minor library release. Exceptions\nmay be made on a case-by-case basis, for example security fixes may be\nbackported to older stable branches. Only the most recent minor release\nis officially supported. Customers should use the most recent release in\ntheir applications.\n\nVersioning\n----------\n\nAs of 2.0.0, this project adheres to the\n[Semantic Versioning Specification](http://semver.org/).\n\nLicense\n-------\n\nCopyright (C) 2009-2020 MongoDB Inc.\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\nhttp://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\n[rubygems-img]: https://badge.fury.io/rb/bson.svg\n[rubygems-url]: http://badge.fury.io/rb/bson\n[ghactions-img]: https://github.com/mongodb/bson-ruby/actions/workflows/bson-ruby.yml/badge.svg?query=branch%3Amaster\n[ghactions-url]: https://github.com/mongodb/bson-ruby/actions/workflows/bson-ruby.yml?query=branch%3Amaster\n","funding_links":[],"categories":["Ruby","Gems"],"sub_categories":["Serialization"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmongodb%2Fbson-ruby","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmongodb%2Fbson-ruby","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmongodb%2Fbson-ruby/lists"}