OceanStream is an integrated cloud data platform used for hydroacoustic data collection and analysis in real-time. It is built on Azure IoT Edge infrastructure.
To contribute, clone the OceanStream repository's dev branch, which contains the latest development changes:
git clone -b dev https://github.com/OceanStreamIO/oceanstream.git
Navigate to the oceanstream directory:
cd oceanstream
Now, you can install dependencies, run tests, or start development! Direct all pull requests to the dev branch.
conda env create -f environment.yml
This command creates an environment named oceanstream
. To activate it:
conda activate oceanstream
conda env create -f environment-dev.yml
Again, activate the environment with:
conda activate oceanstream
python -m venv .venv
This command creates a virtual environment in the .venv
directory using Python 3.9.
Example using pyenv
:
pyenv
:
pyenv install 3.9
cd /path/to/your/project_directory
pyenv
:
~/.pyenv/versions/3.11/bin/python -m venv .venv
On Linux and MacOS:
source .venv/bin/activate
On Windows:
.venv\Scripts\activate.bat # In cmd.exe
.venv\Scripts\Activate.ps1 # In PowerShell
To use the package:
pip install -r requirements.txt
To contribute to the package:
pip install -r requirements-dev.txt
Install the pre-commit tool using pip:
pip install pre-commit
Navigate to your repository where the .pre-commit-config.yaml
file is located. Install the Git hook scripts with:
pre-commit install
Pre-commit will now run automatically every time you attempt to make a commit. If any hooks fail, the commit will be blocked, and you'll be prompted to fix the issues before committing again.
To manually run all hooks against all the files, use:
pre-commit run --all-files
To update your hooks to the latest versions, use:
pre-commit autoupdate
To bypass the hooks for a particular commit, use the -n
or --no-verify
option:
git commit -m "Your commit message" -n
To uninstall the Git hook scripts, use:
pre-commit uninstall
Ensure Python and pip are installed on your system.
Install Sphinx:
pip install sphinx
Navigate to Your Project's docs Directory:
cd /path/to/your/docs_directory
Build the Documentation:
For Linux/Mac:
make html
For Windows:
make.bat html
This command will generate the HTML documentation in the build/html
directory within your docs folder.