Skip to content

Commit

Permalink
chore(release): prepare first release
Browse files Browse the repository at this point in the history
  • Loading branch information
MartinBelthle committed Nov 26, 2024
1 parent 46ad93c commit 4e96593
Show file tree
Hide file tree
Showing 4 changed files with 42 additions and 41 deletions.
37 changes: 0 additions & 37 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,40 +7,3 @@ Antares Craft python library is currently under construction. When completed it
antares studies.

This project only supports antares studies with a version v8.8 or higher.

## developers
### install dev requirements

Install dev requirements with `pip install -r requirements-dev.txt`

### linting and formatting

To reformat your code, use this command line: `ruff check src/ tests/ --fix && ruff format src/ tests/`

### typechecking

To typecheck your code, use this command line: `mypy`

### integration testing

To launch integration tests you'll need an AntaresWebDesktop instance on your local env (at least the v.2.17.3,
**currently running in 2.17.5**).
To install it, download it from the last [Antares Web release](https://github.com/AntaresSimulatorTeam/AntaREST/releases)
(inside the assets list).
Then, unzip it at the root of this repository and rename the folder `AntaresWebDesktop`.
*NB*: The expected folder structure is the following: `antares_craft/AntaresWebDesktop/config.yaml`

### tox
To use [tox](https://tox.wiki/) to run unit tests in multiple python versions at the same time as linting and formatting
with ruff and typing with mypy:
1) As the dev requirements include [uv](https://docs.astral.sh/uv/) and `tox-uv` there is no need to install python
versions, `uv` will do this for you.
2) Use `tox -p` to run the environments in parallel to save time, this will create virtual environment with the
necessary python versions the first time you run tox.

### mkdocs
Smallest beginning of `mkdocs` included more as proof of concept than anything, theme and logo copied from [Antares
Simulator](https://github.com/AntaresSimulatorTeam/Antares_Simulator).
1) To preview the docs on your local machine run `mkdocs serve`.
2) To build the static site for publishing for example on [Read the Docs](https://readthedocs.io) use `mkdocs build`.
3) To flesh out the documentation see [mkdoc guides](https://www.mkdocs.org/user-guide/).
4 changes: 4 additions & 0 deletions docs/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
v0.1.0 (2024-11-26)
-------------------

* First release of the project.
35 changes: 35 additions & 0 deletions docs/developer.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
### install dev requirements

Install dev requirements with `pip install -r requirements-dev.txt`

### linting and formatting

To reformat your code, use this command line: `ruff check src/ tests/ --fix && ruff format src/ tests/`

### typechecking

To typecheck your code, use this command line: `mypy`

### integration testing

To launch integration tests you'll need an AntaresWebDesktop instance on your local env (at least the v.2.17.3,
**currently running in 2.17.5**).
To install it, download it from the last [Antares Web release](https://github.com/AntaresSimulatorTeam/AntaREST/releases)
(inside the assets list).
Then, unzip it at the root of this repository and rename the folder `AntaresWebDesktop`.
*NB*: The expected folder structure is the following: `antares_craft/AntaresWebDesktop/config.yaml`

### tox
To use [tox](https://tox.wiki/) to run unit tests in multiple python versions at the same time as linting and formatting
with ruff and typing with mypy:
1) As the dev requirements include [uv](https://docs.astral.sh/uv/) and `tox-uv` there is no need to install python
versions, `uv` will do this for you.
2) Use `tox -p` to run the environments in parallel to save time, this will create virtual environment with the
necessary python versions the first time you run tox.

### mkdocs
Smallest beginning of `mkdocs` included more as proof of concept than anything, theme and logo copied from [Antares
Simulator](https://github.com/AntaresSimulatorTeam/Antares_Simulator).
1) To preview the docs on your local machine run `mkdocs serve`.
2) To build the static site for publishing for example on [Read the Docs](https://readthedocs.io) use `mkdocs build`.
3) To flesh out the documentation see [mkdoc guides](https://www.mkdocs.org/user-guide/).
7 changes: 3 additions & 4 deletions pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,14 @@ build-backend = "setuptools.build_meta"

[project]
name = "antares_craft"
version = "0.0.1"
description = """Antares Craft python library is currently under construction. When completed it will allow to \
create, update and read antares studies."""
version = "0.1.0"
description = """Antares Craft python library under construction. It will allow to create, update and read antares studies."""
readme = "README.md"
license = {file = "LICENSE"}
authors = [
{name="Sylvain Leclerc"},
{name="Tatiana Vargas"},
{name="Martin Behlthle"},
{name="Martin Belthle"},
{name="Sigurd Borge"}
]
requires-python = ">=3.9"
Expand Down

0 comments on commit 4e96593

Please sign in to comment.