protocol-media-registry 0.0.1

data/lib/protocol/media/registry/version.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+# @namespace
+module Protocol
+	# Models media types used by internet protocols and data formats.
+	module Media
+		# @namespace
+		module Registry
+			VERSION = "0.0.1"
+		end
+	end
+end

data/lib/protocol/media/registry.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+require "protocol/media/type"
+
+require_relative "registry/version"
+require_relative "registry/index"
+require_relative "registry/record"
+
+module Protocol
+	module Media
+		# Provides indexed access to registered media type data.
+		module Registry
+			# Look up a media type by name.
+			#
+			# @parameter name [String] The complete media type name.
+			# @returns [Record | Nil]
+			def self.[](name)
+				if record = Index.lookup(name)
+					Record.new(Type.parse(record[0]), encoding: record[1], extensions: record[2])
+				end
+			end
+			
+			# Look up a media type by filename extension.
+			#
+			# @parameter extension [String] A filename extension, with or without a leading dot.
+			# @returns [Record | Nil]
+			def self.for_extension(extension)
+				extension = extension.delete_prefix(".").downcase
+				
+				if name = Index.lookup_extension(extension)
+					self[name]
+				end
+			end
+			
+			# Look up a media type for a path.
+			#
+			# @parameter path [String] A path containing a filename extension.
+			# @returns [Record | Nil]
+			def self.for_path(path)
+				extension = File.extname(path)
+				for_extension(extension) unless extension.empty?
+			end
+		end
+	end
+end

data/license.md

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright, 2016-2026, by Samuel Williams.  
+
+Permission 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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE 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.

data/readme.md

@@ -0,0 +1,14 @@
+# Protocol::Media::Registry
+
+Provides generated, indexed media type registry data for `protocol-media`. It uses a native static index when available and transparently falls back to a generated Ruby index.
+
+``` ruby
+require "protocol/media/registry"
+
+record = Protocol::Media::Registry["application/json"]
+record.type # => #<Protocol::Media::Type ...>
+record.extensions # => ["json", ...]
+
+Protocol::Media::Registry.for_extension("json").type
+Protocol::Media::Registry.for_path("document.json").type
+```

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification
+name: protocol-media-registry
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Samuel Williams
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: protocol-media
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+executables: []
+extensions:
+- ext/extconf.rb
+extra_rdoc_files: []
+files:
+- ext/depend
+- ext/extconf.rb
+- ext/protocol/media/registry/extensions.gperf
+- ext/protocol/media/registry/extensions.h
+- ext/protocol/media/registry/native.c
+- ext/protocol/media/registry/records.gperf
+- ext/protocol/media/registry/records.h
+- lib/protocol/media/registry.rb
+- lib/protocol/media/registry/fallback.rb
+- lib/protocol/media/registry/index.rb
+- lib/protocol/media/registry/record.rb
+- lib/protocol/media/registry/records.rb
+- lib/protocol/media/registry/version.rb
+- license.md
+- readme.md
+homepage: https://github.com/socketry/protocol-media-registry
+licenses:
+- MIT
+metadata:
+  documentation_uri: https://socketry.github.io/protocol-media-registry/
+  source_code_uri: https://github.com/socketry/protocol-media-registry.git
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: Provides indexed media type registry data.
+test_files: []