-
Notifications
You must be signed in to change notification settings - Fork 4
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
cleaner environment #30
Conversation
@@ -19,7 +19,7 @@ build: | |||
- sphinx-apidoc -o docs/apidoc --private --module-first xhydro | |||
|
|||
conda: | |||
environment: environment-docs.yml | |||
environment: environment-dev.yml |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Like I mentioned in person, there are a few ways of going about building the docs:
- We can install everything from the dev environment and evaluate notebooks (heavy on resources/memory, slower to build)
- We can mock the dependencies and install the library without any intention of running notebooks (faster, no gurantee that notebooks are running properly on RtD).
- We can do something fancier (like I developed in xclim).
Any of these approaches is fine. If we find that option 1 ends up being too slow, I can make something more custom resembling option 3 later...
"xclim>=0.43.0", | ||
"zarr>=2.11.1", | ||
] | ||
requirements = [] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@RondeauG and I spoke about this earlier. As we start adding content to xhydro, we should progressvely add requirements here. That way it doesn`t take so long to install/test in the early stages.
@@ -69,9 +40,7 @@ | |||
name="xhydro", | |||
packages=find_packages(include=["xhydro", "xhydro.*"]), | |||
test_suite="tests", | |||
tests_require=test_requirements, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This field is deprecated and the pytest
and setuptools
maintainers suggest against using it. Good call.
More info: https://docs.pytest.org/en/latest/explanation/goodpractices.html#do-not-run-via-setuptools
Pull Request Checklist:
number
) and pull request (:pull:number
) has been added.What kind of change does this PR introduce?
environment.yml
file now only contains the bare minimum dependencies.-docs
and moved everything into aenvironment-dev
.requirements_(dev/docs).txt
, since they were not used.Does this PR introduce a breaking change?
Other information: