Move OrderMap module to root of otel-api crate

opentelemetry-api/CHANGELOG.md

@@ -5,6 +5,7 @@
 ### Fixed
 
 - Fix `SpanRef::set_attributes` mutability requirement. [#1038](https://github.com/open-telemetry/opentelemetry-rust/pull/1038)
+- Move OrderMap module to root of otel-api crate. [#1061](https://github.com/open-telemetry/opentelemetry-rust/pull/1061)
 
 ## v0.19.0
 ### Added

opentelemetry-api/src/lib.rs

@@ -51,6 +51,10 @@ pub use context::{Context, ContextGuard};
 
 mod common;
 
+mod order_map;
+
+pub use order_map::OrderMap;
+
 #[cfg(any(feature = "testing", test))]
 #[doc(hidden)]
 pub mod testing;

opentelemetry-api/src/trace/mod.rs

@@ -169,7 +169,6 @@ use thiserror::Error;
 
 mod context;
 pub mod noop;
-mod order_map;
 mod span;
 mod span_context;
 mod tracer;
@@ -179,13 +178,16 @@ pub use self::{
     context::{
         get_active_span, mark_span_as_active, FutureExt, SpanRef, TraceContextExt, WithContext,
     },
-    order_map::OrderMap,
     span::{Span, SpanKind, Status},
     span_context::{SpanContext, SpanId, TraceFlags, TraceId, TraceState},
     tracer::{SamplingDecision, SamplingResult, SpanBuilder, Tracer},
     tracer_provider::TracerProvider,
 };
 use crate::{ExportError, KeyValue};
+use std::collections::hash_map::RandomState;
+
+/// re-export OrderMap to mitigate breaking change
+pub type OrderMap<K, V, S = RandomState> = crate::order_map::OrderMap<K, V, S>;
 
 /// Describe the result of operations in tracing API.
 pub type TraceResult<T> = Result<T, TraceError>;

opentelemetry-api/src/trace/tracer.rs

@@ -1,7 +1,6 @@
-use crate::trace::OrderMap;
 use crate::{
     trace::{Event, Link, Span, SpanId, SpanKind, Status, TraceContextExt, TraceId, TraceState},
-    Context, Key, KeyValue, Value,
+    Context, Key, KeyValue, OrderMap, Value,
 };
 use std::borrow::Cow;
 use std::iter::FromIterator;

opentelemetry-sdk/src/trace/sampler.rs

@@ -1,9 +1,8 @@
-use opentelemetry_api::trace::OrderMap;
 use opentelemetry_api::{
     trace::{
         Link, SamplingDecision, SamplingResult, SpanKind, TraceContextExt, TraceId, TraceState,
     },
-    Context, Key, Value,
+    Context, Key, OrderMap, Value,
 };
 use std::convert::TryInto;
 

opentelemetry-sdk/src/trace/sampler/jaeger_remote/sampler.rs

@@ -3,8 +3,8 @@ use crate::trace::sampler::jaeger_remote::sampling_strategy::Inner;
 use crate::trace::{Sampler, ShouldSample, TraceRuntime};
 use futures_util::{stream, StreamExt as _};
 use http::Uri;
-use opentelemetry_api::trace::{Link, OrderMap, SamplingResult, SpanKind, TraceError, TraceId};
-use opentelemetry_api::{global, Context, Key, Value};
+use opentelemetry_api::trace::{Link, SamplingResult, SpanKind, TraceError, TraceId};
+use opentelemetry_api::{global, Context, Key, OrderMap, Value};
 use opentelemetry_http::HttpClient;
 use std::str::FromStr;
 use std::sync::Arc;

opentelemetry-sdk/src/trace/tracer.rs

@@ -17,10 +17,10 @@ use crate::{
     InstrumentationLibrary,
 };
 use opentelemetry_api::trace::{
-    Link, OrderMap, SamplingDecision, SamplingResult, SpanBuilder, SpanContext, SpanId, SpanKind,
+    Link, SamplingDecision, SamplingResult, SpanBuilder, SpanContext, SpanId, SpanKind,
     TraceContextExt, TraceFlags, TraceId, TraceState,
 };
-use opentelemetry_api::{Context, Key, KeyValue, Value};
+use opentelemetry_api::{Context, Key, KeyValue, OrderMap, Value};
 use std::fmt;
 use std::sync::Weak;
 
@@ -276,10 +276,10 @@ mod tests {
     };
     use opentelemetry_api::{
         trace::{
-            Link, OrderMap, SamplingDecision, SamplingResult, Span, SpanContext, SpanId, SpanKind,
+            Link, SamplingDecision, SamplingResult, Span, SpanContext, SpanId, SpanKind,
             TraceContextExt, TraceFlags, TraceId, TraceState, Tracer, TracerProvider,
         },
-        Context, Key, Value,
+        Context, Key, OrderMap, Value,
     };
 
     #[derive(Clone, Debug)]