|
1 | 1 | # spatialdata_xenium_explorer |
2 | 2 | Converting any SpatialData object into files that can be open by the Xenium Explorer |
3 | 3 |
|
4 | | -> This project has been generated by cookiecutter from [this template](https://github.com/MICS-Lab/poetry_cookiecutter). |
| 4 | +## Installation |
5 | 5 |
|
6 | | -# Template usage instructions |
| 6 | +This repository is currently in development. You can still test it out, but you may exeprience issues. |
7 | 7 |
|
8 | | -All the instructions can be found in this [documentation](https://mics-lab.github.io/poetry_cookiecutter/). |
| 8 | +`pip install git+https://github.com/quentinblampey/spatialdata_xenium_explorer.git` |
9 | 9 |
|
10 | | -Some of the main command lines are reminded below. |
11 | | -## Activate the poetry environment |
| 10 | +## Usage |
12 | 11 |
|
13 | | -To activate your new poetry environment, you can choose one of the following: |
14 | | -- Choose the installed poetry interpreter on Visual Studio Code (it activates your env automatically at each new terminal window). If you didn't provide VS Code the path to poetry virtualenvs, add `"python.venvPath": <path>` in your VS Code user settings file, where `path` is the output of the following command line: `poetry config virtualenvs.path` |
15 | | -- At the root of the project, run `poetry shell`. |
16 | | -- Use `poetry run` before each command line, e.g. `poetry run python your_script.py` |
| 12 | +```python |
| 13 | +import spatialdata_xenium_explorer |
17 | 14 |
|
18 | | -> All the command lines in this documentation assume that you have activated your environment using one of these methods. E.g., instead of telling you to run `poetry run mkdocs serve`, we simply say `mkdocs serve` (note that you need to add `poetry run` in front of the command only if you have chosen the third option). |
19 | | -## Run the documentation locally |
20 | | - |
21 | | -`mkdocs serve` |
22 | | - |
23 | | -## Run tests |
24 | | - |
25 | | -`pytest` |
26 | | - |
27 | | -## Run formatting |
28 | | - |
29 | | -`black .` |
30 | | - |
31 | | -It is also encouraged to run formatting on save. If you use Visual Studio Code, you can choose black as the provider (under `Python › Formatting: Provider`) and enable formatting on save (`Editor: Format On Save`). |
32 | | - |
33 | | -## Deploy the doc |
34 | | -To deploy the documentation on Github Pages, you must first push your changes on the `master` branch. |
35 | | -Then, go to the GitHub settings, and choose `gh-pages` as the branch, and `/docs` as the folder. It will create a link so that you can access the doc online. |
36 | | - |
37 | | -NB: the default CI is set up to deploy pages when pushing to `master`, but you can update the `.github/workflows/ci.yml` file. |
38 | | - |
39 | | -## Package installation |
40 | | -You can install your package on other environments. Simply activate your environment, then move to the project's root and run `pip install -e .` to install it with the editable mode. Now, you can import your package when running on this new environment, and it will always consider your code changes thanks to the editable mode (no need to reinstall the package). |
| 15 | +spatialdata_xenium_explorer.write("/path/to/directory", sdata, image_key) |
| 16 | +``` |
0 commit comments