docs: fix docstring, add to readme

README.md

@@ -11,6 +11,9 @@ dm = DotMap(dict)
 dm.c.d # returns 3
 dm.c.e = 5
 dm["c"].e # returns 5
+
+DotMap.todict(dm, keys_as_strings=true) # returns Dict("a"=>1, "b"=>2, "c" => Dict("d"=>3, "e"=>5))
+DotMap.todict(dm) # returns Dict(:a=>1, :b=>2, :c => Dict(:d=>3, :e=>5))
 ```
 
 **NOTE** This is not as performative as using normal dictionaries, but is nice for accessing deeply nested dictionary structures, such as large config/yaml/json files.

src/DotMaps.jl

@@ -23,19 +23,18 @@ end
 DotMap(d::Any) = d
 
 """
-   DotMaps.todict(::DotMap)
+   DotMaps.todict(::DotMap; keys_as_strings=false)
 
-Constructs a Dict from a DotMap.
+Constructs a Dict from a DotMap. If `keys_as_strings`, the keys will be `String` instead of `Symbol`.
 """
 function todict(obj::DotMap; keys_as_strings::Bool = false)
-   new_dict = Dict()
-   dm = obj.__dict__
-   for (k, v) in dm
+   dict = Dict()
+   for (k, v) in obj
       nk = keys_as_strings ? string(k) : k
-      new_dict[nk] = todict(v, keys_as_strings = keys_as_strings)
+      dict[nk] = todict(v, keys_as_strings = keys_as_strings)
    end
 
-   return new_dict
+   return dict
 end
 
 # return at leaves