Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DimensionalData extension #3383

Closed
wants to merge 10 commits into from
Closed

Conversation

longemen3000
Copy link
Contributor

@longemen3000 longemen3000 commented May 24, 2023

adds DimensionaData as an extension, closes rafaqz/DimensionalData.jl#487

Project.toml Outdated Show resolved Hide resolved
Project.toml Outdated
test = ["DimensionalData", "Test"]

[weakdeps]
DimensionalData = "0703355e-b756-11e9-17c0-8b28908087d0"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So what happens with this in Julia 1.6? It just gets ignored?

Copy link
Contributor Author

@longemen3000 longemen3000 May 24, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes. extensions is a 1.9 feature after all

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the options for Backwards compatibility is by Requires or as a regular dependency

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think I'm okay if this is a Julia 1.9+ feature only. We don't need backwards compatibility for new features.

One issue is that the docs are currently build using Julia 1.6. So we'd need to update that, and then add some big compat warnings.

Project.toml Show resolved Hide resolved
@odow
Copy link
Member

odow commented May 24, 2023

I guess a heads up: it's not certain that we'll merge an extension like this just yet. It's a pretty big change for JuMP, not because of this PR, but because it opens the door for others like it. But we have a monthly call on Thursday that I'll discuss this in.

See also: #1350

ext/JuMPDimensionalDataExt.jl Outdated Show resolved Hide resolved
@odow odow added the Status: Needs developer call This should be discussed on a monthly developer call label May 24, 2023
@codecov
Copy link

codecov bot commented May 24, 2023

Codecov Report

Patch coverage: 100.00% and project coverage change: +0.01 🎉

Comparison is base (4126ebb) 98.06% compared to head (f7d1ee1) 98.08%.

Additional details and impacted files
@@            Coverage Diff             @@
##           master    #3383      +/-   ##
==========================================
+ Coverage   98.06%   98.08%   +0.01%     
==========================================
  Files          34       36       +2     
  Lines        4921     4957      +36     
==========================================
+ Hits         4826     4862      +36     
  Misses         95       95              
Impacted Files Coverage Δ
ext/JuMPDimensionalDataExt.jl 100.00% <100.00%> (ø)
ext/test_DimensionalData.jl 100.00% <100.00%> (ø)

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

ext/JuMPDimensionalDataExt.jl Outdated Show resolved Hide resolved
Copy link
Member

@odow odow left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall, this is pretty slick.

Before merging, we need a bunch more tests, nicer error messages, and some documentation.

But I'm in favor of adding this to JuMP. The main issue I see is a discoverability one. We'll likely need some careful documentation about how and when different extensions are loaded and what features they enable.

@odow
Copy link
Member

odow commented May 24, 2023

Seems like this is working:

Julia 1.6
image

Julia 1.9
image

@odow
Copy link
Member

odow commented May 25, 2023

Some notes from the JuMP call

  • What if extension makes a breaking release
  • Add documentation
  • Necessary criteria for acceptance
    • Bar for acceptance is high. Qualitative decision by JuMP developers
    • "Significant" package in the ecosystem
    • A useful extension for JuMP models
    • Mature: 1.0 release, or battle tested for a long time
    • Self-contained

@longemen3000
Copy link
Contributor Author

longemen3000 commented May 25, 2023

What if extension makes a breaking release

You can add compat annotations for extensions (but aqua seems to have problems with those, In general, Aqua needs to be updated to support 1.9 extensions and weakdeps).

@odow
Copy link
Member

odow commented May 25, 2023

The compat issue was this:

  • What if DimensionalData releases a breaking v0.25 that we don't want to (or can't) support?
  • Are we stuck on v0.24 for ever?
  • Can users install JuMP and v0.25 together and have the extension not load?
  • Is it a breaking change if JuMP removes an extension?

@rafaqz
Copy link

rafaqz commented May 27, 2023

This is an interesting point about extensions in general for the ecosystem... we are making our dependency trees larger and that does have costs besides compile time.

FWIW DimensionalData.jl is unlikely to do anything you cant support or change the basics of the dimarray interface much in the next few years.

@odow odow removed the Status: Needs developer call This should be discussed on a monthly developer call label Jun 2, 2023
@odow
Copy link
Member

odow commented Jun 7, 2023

Based on my testing, it seems that the compat dependency issue is a hard requirement:

(dd) pkg> st
Status `/private/tmp/dd/Project.toml`
  [0703355e] DimensionalData v0.24.12
  [4076af6c] JuMP v1.11.1 `~/.julia/dev/JuMP`

(dd) pkg> add DimensionalData@0.23
   Resolving package versions...
ERROR: Unsatisfiable requirements detected for package DimensionalData [0703355e]:
 DimensionalData [0703355e] log:
 ├─possible versions are: 0.1.0-0.24.12 or uninstalled
 ├─restricted to versions 0.24 by JuMP [4076af6c], leaving only versions: 0.24.0-0.24.12 or uninstalled
 │ └─JuMP [4076af6c] log:
 │   ├─possible versions are: 1.11.1 or uninstalled
 │   └─JuMP [4076af6c] is fixed to version 1.11.1
 └─restricted to versions 0.23 by an explicit requirement — no versions left

Thus, I think we need to treat extensions as if we were adopting the dependency into JuMP proper. The lazy loading is almost an implementation detail, rather than an magic thing that gets loaded if the versions align.

This makes me a lot more hesitant to add extensions for packages which are not version 1, or which have large dependency trees.

In this case, DimensionalData is borderline, because it's pre-1.0, but it is fairly stable at v0.24.12, and it has a fairly reasonable set of dependencies: https://juliahub.com/ui/Packages/DimensionalData/Unppe/0.24.12?page=1

@odow
Copy link
Member

odow commented Jun 7, 2023

Closing in favor of #3413

@odow odow closed this Jun 7, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

3 participants