Skip to content

Commit 3ec3f49

Browse files
authored
DOC: Update instructions in README.md for developers. (#198)
- Update instructions in `README.md` for developers. - Add defusedxml as dependency in setup.py. - Update virtual environment name to tiatoolbox-dev. - Update README.md for links. Co-authored by: @shaneahmed
1 parent 9ef490f commit 3ec3f49

File tree

3 files changed

+41
-9
lines changed

3 files changed

+41
-9
lines changed

README.md

Lines changed: 39 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -62,13 +62,44 @@ tiatoolbox supports various features through command line. For more information,
6262
### Prepare for development
6363

6464
Prepare a computer as a convenient platform for further development of the Python package `tiatoolbox` and related programs as follows.
65-
1. Open a `bash` terminal window<br/>
66-
`cd <future-home-of-tiatoolbox-directory>` <br/>
67-
2. Download a complete copy of the `tiatoolbox`.<br/>`git clone https://github.com/TissueImageAnalytics/tiatoolbox.git`<br/>
68-
3. `cd tiatoolbox`
69-
4. `conda env create -f requirements.conda.yml`<br/>
70-
creates the virtual environment `tiatoolbox`. Details in the text file `requirements.conda.yml`
71-
5. To use the packages installed in the environment, run the command:<br/>`conda activate tiatoolbox`
65+
1. Install [pre-requisite software](https://tia-toolbox.readthedocs.io/en/latest/installation.html)
66+
2. Open a terminal window<br/>
67+
68+
```sh
69+
$ cd <future-home-of-tiatoolbox-directory>
70+
```
71+
72+
3. Download a complete copy of the `tiatoolbox`.
73+
74+
```sh
75+
$ git clone https://github.com/TissueImageAnalytics/tiatoolbox.git
76+
```
77+
78+
4. Change directory to `tiatoolbox`
79+
80+
```sh
81+
$ cd tiatoolbox
82+
```
83+
84+
5. Create virtual environment for TIAToolbox using
85+
86+
```sh
87+
$ conda env create -f requirements.dev.conda.yml # for linux/mac only.
88+
$ conda activate tiatoolbox-dev
89+
```
90+
or
91+
92+
```sh
93+
$ conda create -n tiatoolbox-dev python=3.8 # select version of your choice
94+
$ conda activate tiatoolbox-dev
95+
$ pip install -r requirements_dev.txt
96+
```
97+
6. To use the packages installed in the environment, run the command:
98+
99+
```sh
100+
$ conda activate tiatoolbox-dev
101+
```
102+
72103

73104
### License
74105

@@ -80,7 +111,7 @@ The full text of the licence is included in [LICENSE.md](https://raw.githubuserc
80111

81112
### Auxiliary Files
82113

83-
Auxiliary files, such as pre-trained model weights downloaded from the TIA Centre webpage (https://warwick.ac.uk/fac/cross_fac/tia/), are provided under the [Creative Commons Attribution-NonCommercial-ShareAlike Version 4 (CC BY-NC-SA 4.0) license](https://creativecommons.org/licenses/by-nc-sa/4.0/).
114+
Auxiliary files, such as pre-trained model weights downloaded from the TIA Centre webpage (https://warwick.ac.uk/tia/), are provided under the [Creative Commons Attribution-NonCommercial-ShareAlike Version 4 (CC BY-NC-SA 4.0) license](https://creativecommons.org/licenses/by-nc-sa/4.0/).
84115

85116
### Dual License
86117

requirements.dev.conda.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
name: tiatoolbox
1+
name: tiatoolbox-dev
22
channels:
33
- conda
44
- conda-forge

setup.py

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,7 @@
3030
"imagecodecs",
3131
"zarr",
3232
"requests",
33+
"defusedxml",
3334
]
3435

3536
setup_requirements = [

0 commit comments

Comments
 (0)