@@ -23,8 +23,10 @@ type TableAdapter interface {
2323
2424var DoltTableAdapterRegistry = newDoltTableAdapterRegistry ()
2525
26- // doltTableAdapterRegistry is a TableAdapter registry for Dolt tables, keyed by the table's original name. It is
27- // populated during package initialization by integrators and intended to be read-only thereafter.
26+ // doltTableAdapterRegistry is a Dolt table name to TableAdapter map. Integrators populate this registry during package
27+ // initialization, and it's intended to be read-only thereafter. The registry links with existing Dolt system tables to
28+ // allow them to be resolved and evaluated to integrator's version and internal aliases (integrators' Dolt table name
29+ // keys).
2830type doltTableAdapterRegistry struct {
2931 Adapters map [string ]TableAdapter
3032 internalAliases map [string ]string
@@ -38,13 +40,12 @@ func newDoltTableAdapterRegistry() *doltTableAdapterRegistry {
3840 }
3941}
4042
41- // AddAdapter adds a TableAdapter to the Dolt table adapter registry with optional |internalAliases| (integrators'
42- // alternative Dolt table name keys).
43- func (as * doltTableAdapterRegistry ) AddAdapter (doltTable string , adapter TableAdapter , internalAliases ... string ) {
43+ // AddAdapter maps |doltTableName| to an |adapter| in the Dolt table adapter registry, with optional |internalAliases|.
44+ func (as * doltTableAdapterRegistry ) AddAdapter (doltTableName string , adapter TableAdapter , internalAliases ... string ) {
4445 for _ , alias := range internalAliases {
45- as .internalAliases [alias ] = doltTable
46+ as .internalAliases [alias ] = doltTableName
4647 }
47- as .Adapters [doltTable ] = adapter
48+ as .Adapters [doltTableName ] = adapter
4849}
4950
5051// GetAdapter gets a Dolt TableAdapter mapped to |name|, which can be the dolt table name or internal alias.
@@ -58,8 +59,8 @@ func (as *doltTableAdapterRegistry) GetAdapter(name string) (TableAdapter, bool)
5859 return adapter , ok
5960}
6061
61- // NormalizeName normalizes |name| if it's an internal alias to the correct Dolt table name, if no match is found the
62- // |name| is returned as is.
62+ // NormalizeName normalizes |name| if it's an internal alias of the underlying Dolt table name. If no match is found,
63+ // |name| is returned as- is.
6364func (as * doltTableAdapterRegistry ) NormalizeName (name string ) string {
6465 doltTableName , ok := as .internalAliases [name ]
6566 if ! ok {
0 commit comments