Dev environment setup

[anishdixit-uw]

1. Added 2 new files: dev_setup.sh which contains python commands to install required packages and develop ooipy and verify_setup.py which confirms OOIPY installation and returns path
2. Added instructions on the step by step process to run these files and setup the environment in docs/source/install_instructions.rst

[John-Ragland]

Alright, when following the instructions, when running dev_setup.sh I get this error:

Preparing transaction: done
Verifying transaction: done
Executing transaction: done
Retrieving notices: ...working... done
added /Users/jhrag/Code/ooipy_development/ooipy
completed operation for: /Users/jhrag/Code/ooipy_development/ooipy
usage: setup.py [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...]
   or: setup.py --help [cmd1 cmd2 ...]
   or: setup.py --help-commands
   or: setup.py cmd --help

error: no commands supplied
Traceback (most recent call last):
  File "/Users/jhrag/Code/ooipy_development/ooipy/verify_setup.py", line 1, in <module>
    import ooipy
  File "/Users/jhrag/Code/ooipy_development/ooipy/ooipy/__init__.py", line 1, in <module>
    from _ooipy_version import version as __version__  # noqa
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ModuleNotFoundError: No module named '_ooipy_version'

Also, another small thing. This installs python 3.11, which we don't officially support with unit tests. There probably isn't any error, but it might be nice to add the 3.11 unit tests and the support for python 3.11 I guess

[anishdixit-uw]

@John-Ragland

that seems strange because in the .sh file, I have put in a command to run the setup.py file.

I think the error is occuring because I am first running conda develop ooipy and then running setup.py.

Let me change the order in which those commands are being run and then we can check if it works

[John-Ragland]

@John-Ragland

that seems strange because in the .sh file, I have put in a command to run the setup.py file.

I think the error is occuring because I am first running conda develop ooipy and then running setup.py.

Let me change the order in which those commands are being run and then we can check if it works

Alright yeah, changing the order fixed it in my environment

[anishdixit-uw]

Okay, I have committed the change with the swapped order here too

[John-Ragland]

This looks great, I think we're ready to merge.

[John-Ragland]

We could probably run verify_setup.py within the bash script.

And it might even be possible to check if the python path is the local directory within the python script, and then just print something like
'Development environment installation successful'

[John-Ragland]

@anishdixit-uw, would you be able to add these changes?

[anishdixit-uw]

@John-Ragland verify_setup.py already runs from within the bash script.

And it does print out the path of OOIPY installation, so is that what you are saying here or something different?

[John-Ragland]

Also, could we change name lines for creating the environment to have the environment name be ooipy_dev?

conda create --name ooipy_dev

[anishdixit-uw]

@John-Ragland for now I assumed that the environment is already created, then the user clones the repo and then runs the bash script.

If we want to give in environment creation instructions ourselves, the documentation will have to be changed, so the new order would be:

1. Clone repo
2. Run bash script (env gets automatically created)

If this logic makes sense, I can make the changes, should be easily doable

[John-Ragland]

Tagging the relevant issue #136