Better browsing

[tamasgal]

This will break a few things since f["what/ever"] will now always return the object which sits at that "position" but the navigation is much easier.

Before this PR, UnROOT choked on branches which could not be interpreted so that the user's only option to explore the structure was to use .fBranches etc. and dig into ROOT internals.

Now, if a TTree or TBranchElement is returned by getindex(), the branches are listed:

julia> using UnROOT
[ Info: Precompiling UnROOT [3cd96dde-e98d-4713-81e9-a4a1b0235ce9]

julia> f = ROOTFile("mcv7.2.gsg_muon-CC_1-100GeV.km3sim.jterbr00011156.jorcarec.aanet.2591.root")
ROOTFile with 4 entries and 32 streamers.
mcv7.2.gsg_muon-CC_1-100GeV.km3sim.jterbr00011156.jorcarec.aanet.2591.root
├─ E (TTree)
│  └─ "Evt"
├─ KM3NET_SUMMARYSLICE (TTree)
│  └─ "KM3NET_SUMMARYSLICE"
├─ Head (Head)
└─ META (TDirectory)
   ├─ JMeta (TNamed)
   ├─ JMeta (TNamed)
   ├─ JMeta (TNamed)
   ├─ JMeta (TNamed)
   ├─ JMeta (TNamed)
   ├─ JMeta (TNamed)
   ├─ JMeta (TNamed)
   ├─ JMeta (TNamed)
   ├─ JConvertEvt (TNamed)
   ├─ JMuonEnergy (TNamed)
   ├─ JMuonStart (TNamed)
   ├─ JMuonStart (TNamed)
   ├─ JMuonGandalf (TNamed)
   ├─ JMuonSimplex (TNamed)
   ├─ JMuonPrefit (TNamed)
   └─ JTriggerEfficiency (TNamed)


julia> f["E"]
E (TTree)
└─ "Evt"


julia> f["E/Evt"]
Evt
├─ AAObject
│  ├─ TObject
│  │  ├─ fUniqueID
│  │  └─ fBits
│  ├─ usr
│  ├─ usr_names
│  └─ any
├─ id
├─ det_id
├─ mc_id
├─ run_id
├─ mc_run_id
├─ frame_index
├─ trigger_mask
├─ trigger_counter
├─ overlays
├─ t
│  ├─ t.fSec
│  └─ t.fNanoSec
├─ hits
│  ├─ hits.fUniqueID

[tamasgal]

I had to adjust quite a few tests since

b = rootfile["some/path"]

now needs an explicit call to

b = LazyBranch(rootfile, "some/path")

(btw. TAB-completion would be awesome 😆 )

[codecov]

Codecov Report

Base: 90.33% // Head: 90.00% // Decreases project coverage by -0.34% ⚠️

Coverage data is based on head (e2be84c) compared to base (7bf7918).
Patch coverage: 50.00% of modified lines in pull request are covered.

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #199      +/-   ##
==========================================
- Coverage   90.33%   90.00%   -0.34%     
==========================================
  Files          18       18              
  Lines        2091     2100       +9     
==========================================
+ Hits         1889     1890       +1     
- Misses        202      210       +8     

Impacted Files	Coverage Δ
src/displays.jl	83.50% <0.00%> (-5.51%)	⬇️
src/streamers.jl	89.33% <50.00%> (-0.54%)	⬇️
src/iteration.jl	87.21% <100.00%> (+0.05%)	⬆️
src/root.jl	94.20% <100.00%> (-0.07%)	⬇️
src/types.jl	98.86% <100.00%> (+0.01%)	⬆️

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report at Codecov.
📢 Do you have feedback about the report comment? Let us know in this issue.

[Moelf]

@tamasgal yeah I think it's fine.

So:

1. set version to 0.9 since it's technically breaking
2. add CHANGELOG or NEWS somewhere?

thanks for this!

[tamasgal]

Alright @Moelf from my side it's done. Can you have a look? I put a notice in the README, I think we can leave it there for a while, at least until v1.0 😉

[tamasgal]

Thanks! I'll go ahead with the release then