open-MaStR icon indicating copy to clipboard operation
open-MaStR copied to clipboard

Deprecate features from open-mastr

Open FlorianK13 opened this issue 1 year ago • 6 comments

Discussion

Users that are affected by this deprecation can leave their comments in this issue.


Should we think about adding a deprecation warning to the soap API features .download and .mirror? We could print the message that those features will not be maintained in the future. If people still use them, they should tell us in an Issue.

Explanation

Both functions are used to download large amount of data via the SOAP API. Since BNetzA has a bulk download for quite some time now, I don't think that we need to maintain this feature anymore.

@chrwm What do you think?

Todos

  • [ ] State very prominently in documentation that these features are deprecated, maybe even in the sidebar
  • [x] Delete tests for the deprecated features

FlorianK13 avatar Feb 19 '24 17:02 FlorianK13

Currently mastr mirror tests are causing problems, so we should also delete those tests and rather focus our (limited) time on fixing and maintaining other parts of the code.

FlorianK13 avatar Mar 08 '24 10:03 FlorianK13

This is merged on develop and will be released soon.

FlorianK13 avatar Apr 23 '24 14:04 FlorianK13

Leave open for user feedback

nesnoj avatar Aug 27 '24 08:08 nesnoj

The data that can be downloaded with the BULK download from the open zip file is different from the data a user can download over the API download. For example a "Netzbetreiber" can get the geo coordinates of all units connected to his grid. I don't see a solution for this problem or do I miss something?

hochwasser avatar Oct 31 '25 10:10 hochwasser

Hi @hochwasser, we will not deprecate the SOAP API wrapper. There are three classes in open-mastr: MaStRAPI, MaStRDownload, and MaStRMirror. We plan to deprecate Download and Mirror - but keep the API Wrapper from MaStRAPI. With the MaStRAPI class it will still be possible to call all methods that are described on the website of BNetzA.

Are you using the Download and Mirror classes? If yes, can you describe how you are using them?

FlorianK13 avatar Oct 31 '25 10:10 FlorianK13

Hello @FloarinK13, I evaluate if we could use the open-MaStR to keep an up to date version of the MaStR local. The idea was to make a intial download an then keep the data current with the mirror method.

hochwasser avatar Oct 31 '25 11:10 hochwasser