Skip to content
This repository was archived by the owner on Aug 27, 2025. It is now read-only.

Commit 2a8f2bc

Browse files
minimal readme
1 parent 114da2c commit 2a8f2bc

1 file changed

Lines changed: 8 additions & 32 deletions

File tree

README.md

Lines changed: 8 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,16 @@
11
# spatialdata_xenium_explorer
22
Converting any SpatialData object into files that can be open by the Xenium Explorer
33

4-
> This project has been generated by cookiecutter from [this template](https://github.com/MICS-Lab/poetry_cookiecutter).
4+
## Installation
55

6-
# Template usage instructions
6+
This repository is currently in development. You can still test it out, but you may exeprience issues.
77

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`
99

10-
Some of the main command lines are reminded below.
11-
## Activate the poetry environment
10+
## Usage
1211

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
1714

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

Comments
 (0)