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.
- Python 3.11: Ensure Python 3.11 is installed on your system.
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.
- Create a virtual environment to use the package:
conda env create -f environment.yml
This command creates an environment named oceanstream
. To activate it:
conda activate oceanstream
- Create a virtual environment to contribute to the package:
conda env create -f environment-dev.yml
Again, activate the environment with:
conda activate oceanstream
- Create a Virtual Environment:
python -m venv .venv
This command creates a virtual environment in the .venv
directory using Python 3.9.
-
Example using
pyenv
:- Install Python 3.9 with
pyenv
:pyenv install 3.9
- Navigate to your project directory:
cd /path/to/your/project_directory
- Create the virtual environment using the Python 3.9 executable managed by
pyenv
:~/.pyenv/versions/3.11/bin/python -m venv .venv
- Install Python 3.9 with
- Activate the Virtual Environment:
- On Linux and MacOS:
source .venv/bin/activate
- On Windows:
.venv\Scripts\activate.bat # In cmd.exe .venv\Scripts\Activate.ps1 # In PowerShell
- Install the Dependencies:
- 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.