enh: add telemetry to nipype

[satra]

Summary

Adds the ability to check for the most recent released version.

List of changes proposed in this PR (pull-request)

• add etelemetry as a dependency

Acknowledgment

• (Mandatory) I acknowledge that this contribution will be available under the Apache 2 license.

[effigies]

Seems fine. I looked at https://github.com/mgxd/etelemetry-client, and looks like it works:

$ curl https://rig.mit.edu/et/projects/nipy/nipype
{"version":"1.2.2"}

[codecov]

Codecov Report

Merging #3027 into master will decrease coverage by 1.05%.
The diff coverage is 80%.

@@            Coverage Diff             @@
##           master    #3027      +/-   ##
==========================================
- Coverage   67.51%   66.46%   -1.06%     
==========================================
  Files         344      343       -1     
  Lines       44058    44050       -8     
  Branches     5552     5549       -3     
==========================================
- Hits        29746    29277     -469     
- Misses      13566    13985     +419     
- Partials      746      788      +42

Flag	Coverage Δ
#smoketests	48.94% <80%> (-1.35%)	⬇️
#unittests	64% <ø> (-0.97%)	⬇️

Impacted Files	Coverage Δ
nipype/utils/config.py	61.82% <ø> (-4.31%)	⬇️
nipype/info.py	94.36% <ø> (ø)	⬆️
nipype/__init__.py	59.57% <80%> (+0.11%)	⬆️
nipype/interfaces/nilearn.py	40% <0%> (-56.67%)	⬇️
nipype/testing/fixtures.py	77.33% <0%> (-21.34%)	⬇️
nipype/interfaces/freesurfer/base.py	61.01% <0%> (-19.5%)	⬇️
nipype/workflows/fmri/fsl/preprocess.py	72.67% <0%> (-13.39%)	⬇️
nipype/utils/filemanip.py	70.67% <0%> (-9.71%)	⬇️
nipype/workflows/smri/freesurfer/autorecon2.py	65.9% <0%> (-9.2%)	⬇️
nipype/workflows/smri/freesurfer/ba_maps.py	91.66% <0%> (-8.34%)	⬇️
... and 29 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update c69d4ad...7e7568e. Read the comment docs.

[mgxd]

LGTM

[oesteban]

Maybe a new entry in the documentation for this new option?

[satra]

currently this is only at: https://miykael.github.io/nipype_tutorial/notebooks/basic_execution_configuration.html

i'll send a PR there as well.

[satra]

@mgxd - any thoughts on the py27 error?

[mgxd]

It looks like it's not finding the versioneer.py with the package

My guess is adding a MANIFEST.in including these files should do the trick (wdyt @effigies)

EDIT: yep, I think that's it, pushing an updated et release now

[effigies]

Is this all set?

[mgxd]

@effigies let's wait to merge this until I cut a new release of etelemetry

[effigies]

@mgxd I'll leave it to you to merge when you're ready.

[effigies]

@mgxd @satra It looks like etelemetry lets us send arbitrary kwargs. Should we add version information, so we can get a sense of which versions are still in use? e.g.,

latest = etelemetry.get_project("nipy/nipype", version=__version__)

[mgxd]

that was intended to allow altering any requests specific arguments (such as timeout), but we could leverage params to do this.

[satra]

or the .et file in a project repo.

the plan was to store the contents of the file (a json/ld dictionary) and send that back alongside version.

[effigies]

Happy to do it any way that works for you. IMO it would be nice to do this now, even if etelemetry doesn't support it yet, so that 1.2.3 can start reporting as soon as etelemetry gets upgraded.