diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index f4f46ad..e37871c 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -20,7 +20,7 @@ jobs: python-version: "3.12" - name: Install mikeplus - run: pip install .[dev] + run: pip install .[dev,doc] - name: MkDocs run: mkdocs build diff --git a/docs/index.md b/docs/index.md index cea47ab..0af7c01 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,5 +1,10 @@ ![logo](https://raw.githubusercontent.com/DHI/mikepluspy/main/images/logo/mikeplus-py.svg) # MIKE+Py: automate your workflows. + ![Python version](https://img.shields.io/pypi/pyversions/mikeplus.svg) + [![Full test](https://github.com/DHI/mikepluspy/actions/workflows/full_test.yml/badge.svg)](https://github.com/DHI/mikepluspy/actions/workflows/full_test.yml) +[![PyPI version](https://badge.fury.io/py/mikeplus.svg)](https://badge.fury.io/py/mikeplus) +![OS](https://img.shields.io/badge/OS-Windows-blue) +![Downloads](https://img.shields.io/pypi/dm/mikeplus) MIKE+Py is a python interface for MIKE+. Its main features include: * Modifying the MIKE+ database in a way that is consistent with the GUI. @@ -14,27 +19,27 @@ MIKE+Py is a python interface for MIKE+. Its main features include: ## Requirements * MIKE+ 2024 (or greater) with valid license -* Python x64 3.8 to 3.12 -* Windows operating system +* Python x64 3.9 to 3.12 +* Windows ## Installation The version of MIKE+Py you install must match the version of MIKE+ installed on your desktop. -> [!NOTE] -> MIKE+Py is not yet available on PyPI since it is in the initial development stages. - | MIKE+ Version | Install command| |:--------------|:---------------| -| MIKE+ 2024 | `pip install https://github.com/DHI/mikepluspy/archive/refs/tags/v2024.0-latest.zip` | +| MIKE+ 2025 | `pip install mikeplus` | +| MIKE+ 2024 Update 1 | `pip install mikeplus==2024.1.*` | +| MIKE+ 2024 | `pip install mikeplus==2024.0.*` | ## Examples -Please check out the jupyter notebooks here: https://github.com/DHI/mikepluspy/tree/main/notebooks +Please check out our [collection of jupyter notebooks] (https://github.com/DHI/mikepluspy/tree/main/notebooks) to get started with MIKE+Py. ## Where can I get help? -* General help, new ideas and feature requests - [GitHub Discussions](http://github.com/DHI/mikepluspy/discussions) -* Bugs - [GitHub Issues](https://github.com/DHI/mikepluspy/issues) +* Bugs - [GitHub Issues](https://github.com/DHI/mikepluspy/issues) +* Feature requests - [GitHub Issues](https://github.com/DHI/mikepluspy/issues) +* Other - [GitHub Discussions](http://github.com/DHI/mikepluspy/discussions) ## Getting started diff --git a/pyproject.toml b/pyproject.toml index f68c2c5..733e46d 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -37,7 +37,7 @@ classifiers = [ [project.optional-dependencies] dev = ["pytest", "ruff", "shapely"] test = ["pytest", "shapely"] -doc = ["sphinx", "myst-parser","sphinx-book-theme","mkdocs==1.5.3","mkdocs-material==9.4.14","mkdocstrings==0.24.0","mkdocstrings-python==1.7.5"] +doc = ["sphinx", "myst-parser","sphinx-book-theme","mkdocs","mkdocs-material","mkdocstrings","mkdocstrings-python"] [project.urls] "Homepage" = "https://github.com/DHI/mikepluspy"