Skip to content

Commit 38b2643

Browse files
[pre-commit.ci] auto fixes from pre-commit.com hooks
for more information, see https://pre-commit.ci
1 parent a433171 commit 38b2643

File tree

4 files changed

+68
-69
lines changed

4 files changed

+68
-69
lines changed

CHANGELOG.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,4 +12,4 @@ and this project adheres to [Semantic Versioning][].
1212

1313
### Added
1414

15-
- Basic tool, preprocessing and plotting functions
15+
- Basic tool, preprocessing and plotting functions

README.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ This package was initialized using the [cookicutter-scverse](https://github.com/
1515

1616
Please refer to the [documentation][link-docs]. In particular, the
1717

18-
- [API documentation][link-api].
18+
- [API documentation][link-api].
1919

2020
## Installation
2121

@@ -67,8 +67,7 @@ If you found a bug, please use the [issue tracker][issue-tracker].
6767
[changelog]: https://simple-scvi.readthedocs.io/latest/changelog.html
6868
[link-docs]: https://simple-scvi.readthedocs.io
6969
[link-api]: https://simple-scvi.readthedocs.io/latest/api.html
70-
71-
[//]: # (numfocus-fiscal-sponsor-attribution)
70+
[//]: # "numfocus-fiscal-sponsor-attribution"
7271

7372
simple-scvi is part of the scverse® project ([website](https://scverse.org), [governance](https://scverse.org/about/roles)) and is fiscally sponsored by [NumFOCUS](https://numfocus.org/).
7473
If you like scverse® and want to support our mission, please consider making a tax-deductible [donation](https://numfocus.org/donate-to-scverse) to help the project pay for developer time, professional services, travel, workshops, and a variety of other needs.

docs/contributing.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -138,10 +138,10 @@ in the cookiecutter-scverse template.
138138

139139
Please write documentation for new or changed features and use-cases. This project uses [sphinx][] with the following features:
140140

141-
- the [myst][] extension allows to write documentation in markdown/Markedly Structured Text
142-
- [Numpy-style docstrings][numpydoc] (through the [napoloen][numpydoc-napoleon] extension).
143-
- Jupyter notebooks as tutorials through [myst-nb][] (See [Tutorials with myst-nb](#tutorials-with-myst-nb-and-jupyter-notebooks))
144-
- [Sphinx autodoc typehints][], to automatically reference annotated input and output types
141+
- the [myst][] extension allows to write documentation in markdown/Markedly Structured Text
142+
- [Numpy-style docstrings][numpydoc] (through the [napoloen][numpydoc-napoleon] extension).
143+
- Jupyter notebooks as tutorials through [myst-nb][] (See [Tutorials with myst-nb](#tutorials-with-myst-nb-and-jupyter-notebooks))
144+
- [Sphinx autodoc typehints][], to automatically reference annotated input and output types
145145

146146
See the [scanpy developer docs](https://scanpy.readthedocs.io/en/latest/dev/documentation.html) for more information
147147
on how to write documentation.
@@ -158,10 +158,10 @@ repository.
158158

159159
#### Hints
160160

161-
- If you refer to objects from other packages, please add an entry to `intersphinx_mapping` in `docs/conf.py`. Only
162-
if you do so can sphinx automatically create a link to the external documentation.
163-
- If building the documentation fails because of a missing link that is outside your control, you can add an entry to
164-
the `nitpick_ignore` list in `docs/conf.py`
161+
- If you refer to objects from other packages, please add an entry to `intersphinx_mapping` in `docs/conf.py`. Only
162+
if you do so can sphinx automatically create a link to the external documentation.
163+
- If building the documentation fails because of a missing link that is outside your control, you can add an entry to
164+
the `nitpick_ignore` list in `docs/conf.py`
165165

166166
#### Building the docs locally
167167

docs/template_usage.md

Lines changed: 57 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -115,13 +115,13 @@ We recommend using [readthedocs.org][] (RTD) to build and host the documentation
115115
To enable readthedocs, head over to [their website][readthedocs.org] and sign in with your GitHub account.
116116
On the RTD dashboard choose "Import a Project" and follow the instructions to add your repository.
117117

118-
- Make sure to choose the correct name of the default branch. On GitHub, the name of the default branch should be `main` (it has
119-
recently changed from `master` to `main`).
120-
- We recommend to enable documentation builds for pull requests (PRs). This ensures that a PR doesn't introduce changes
121-
that break the documentation. To do so, got to `Admin -> Advanced Settings`, check the
122-
`Build pull requests for this projects` option, and click `Save`. For more information, please refer to
123-
the [official RTD documentation](https://docs.readthedocs.io/en/stable/pull-requests.html).
124-
- If you find the RTD builds are failing, you can disable the `fail_on_warning` option in `.readthedocs.yaml`.
118+
- Make sure to choose the correct name of the default branch. On GitHub, the name of the default branch should be `main` (it has
119+
recently changed from `master` to `main`).
120+
- We recommend to enable documentation builds for pull requests (PRs). This ensures that a PR doesn't introduce changes
121+
that break the documentation. To do so, got to `Admin -> Advanced Settings`, check the
122+
`Build pull requests for this projects` option, and click `Save`. For more information, please refer to
123+
the [official RTD documentation](https://docs.readthedocs.io/en/stable/pull-requests.html).
124+
- If you find the RTD builds are failing, you can disable the `fail_on_warning` option in `.readthedocs.yaml`.
125125
126126
If your project is private, there are ways to enable docs rendering on [readthedocs.org][] but it is more cumbersome and requires a different subscription for read the docs. See a guide [here](https://docs.readthedocs.io/en/stable/guides/importing-private-repositories.html).
127127
@@ -144,52 +144,52 @@ Once authorized, pre-commit.ci should automatically be activated.
144144
145145
The following pre-commit checks are for code style and format:
146146
147-
- [black](https://black.readthedocs.io/en/stable/): standard code
148-
formatter in Python.
149-
- [isort](https://pycqa.github.io/isort/): sort module imports into
150-
sections and types.
151-
- [prettier](https://prettier.io/docs/en/index.html): standard code
152-
formatter for non-Python files (e.g. YAML).
153-
- [blacken-docs](https://github.com/asottile/blacken-docs): black on
154-
python code in docs.
147+
- [black](https://black.readthedocs.io/en/stable/): standard code
148+
formatter in Python.
149+
- [isort](https://pycqa.github.io/isort/): sort module imports into
150+
sections and types.
151+
- [prettier](https://prettier.io/docs/en/index.html): standard code
152+
formatter for non-Python files (e.g. YAML).
153+
- [blacken-docs](https://github.com/asottile/blacken-docs): black on
154+
python code in docs.
155155
156156
The following pre-commit checks are for errors and inconsistencies:
157157
158-
- [flake8](https://flake8.pycqa.org/en/latest/): standard check for errors in Python files.
159-
- [flake8-tidy-imports](https://github.com/adamchainz/flake8-tidy-imports):
160-
tidy module imports.
161-
- [flake8-docstrings](https://github.com/PyCQA/flake8-docstrings):
162-
pydocstyle extension of flake8.
163-
- [flake8-rst-docstrings](https://github.com/peterjc/e8-rst-docstrings):
164-
extension of `flake8-docstrings` for `rst` docs.
165-
- [flake8-comprehensions](https://github.com/adamchainz/e8-comprehensions):
166-
write better list/set/dict comprehensions.
167-
- [flake8-bugbear](https://github.com/PyCQA/flake8-bugbear):
168-
find possible bugs and design issues in program.
169-
- [flake8-blind-except](https://github.com/elijahandrews/flake8-blind-except):
170-
checks for blind, catch-all `except` statements.
171-
- [yesqa](https://github.com/asottile/yesqa):
172-
remove unneccesary `# noqa` comments, follows additional dependencies listed above.
173-
- [autoflake](https://github.com/PyCQA/autoflake):
174-
remove unused imports and variables.
175-
- [pre-commit-hooks](https://github.com/pre-commit/pre-commit-hooks): generic pre-commit hooks.
176-
- **detect-private-key**: checks for the existence of private keys.
177-
- **check-ast**: check whether files parse as valid python.
178-
- **end-of-file-fixer**:check files end in a newline and only a newline.
179-
- **mixed-line-ending**: checks mixed line ending.
180-
- **trailing-whitespace**: trims trailing whitespace.
181-
- **check-case-conflict**: check files that would conflict with case-insensitive file systems.
182-
- [pyupgrade](https://github.com/asottile/pyupgrade):
183-
upgrade syntax for newer versions of the language.
184-
- **forbid-to-commit**: Make sure that `*.rej` files cannot be commited. These files are created by the
185-
[automated template sync](#automated-template-sync) if there's a merge conflict and need to be addressed manually.
158+
- [flake8](https://flake8.pycqa.org/en/latest/): standard check for errors in Python files.
159+
- [flake8-tidy-imports](https://github.com/adamchainz/flake8-tidy-imports):
160+
tidy module imports.
161+
- [flake8-docstrings](https://github.com/PyCQA/flake8-docstrings):
162+
pydocstyle extension of flake8.
163+
- [flake8-rst-docstrings](https://github.com/peterjc/e8-rst-docstrings):
164+
extension of `flake8-docstrings` for `rst` docs.
165+
- [flake8-comprehensions](https://github.com/adamchainz/e8-comprehensions):
166+
write better list/set/dict comprehensions.
167+
- [flake8-bugbear](https://github.com/PyCQA/flake8-bugbear):
168+
find possible bugs and design issues in program.
169+
- [flake8-blind-except](https://github.com/elijahandrews/flake8-blind-except):
170+
checks for blind, catch-all `except` statements.
171+
- [yesqa](https://github.com/asottile/yesqa):
172+
remove unneccesary `# noqa` comments, follows additional dependencies listed above.
173+
- [autoflake](https://github.com/PyCQA/autoflake):
174+
remove unused imports and variables.
175+
- [pre-commit-hooks](https://github.com/pre-commit/pre-commit-hooks): generic pre-commit hooks.
176+
- **detect-private-key**: checks for the existence of private keys.
177+
- **check-ast**: check whether files parse as valid python.
178+
- **end-of-file-fixer**:check files end in a newline and only a newline.
179+
- **mixed-line-ending**: checks mixed line ending.
180+
- **trailing-whitespace**: trims trailing whitespace.
181+
- **check-case-conflict**: check files that would conflict with case-insensitive file systems.
182+
- [pyupgrade](https://github.com/asottile/pyupgrade):
183+
upgrade syntax for newer versions of the language.
184+
- **forbid-to-commit**: Make sure that `*.rej` files cannot be commited. These files are created by the
185+
[automated template sync](#automated-template-sync) if there's a merge conflict and need to be addressed manually.
186186

187187
### How to disable or add pre-commit checks
188188

189-
- To ignore lint warnigs from **flake8**, see [Ignore certain lint warnings](#how-to-ignore-certain-lint-warnings).
190-
- You can add or remove pre-commit checks by simply deleting relevant lines in the `.pre-commit-config.yaml` file.
191-
Some pre-commit checks have additional options that can be specified either in the `pyproject.toml` or tool-specific
192-
config files, such as `.prettierrc.yml` for **prettier** and `.flake8` for **flake8**.
189+
- To ignore lint warnigs from **flake8**, see [Ignore certain lint warnings](#how-to-ignore-certain-lint-warnings).
190+
- You can add or remove pre-commit checks by simply deleting relevant lines in the `.pre-commit-config.yaml` file.
191+
Some pre-commit checks have additional options that can be specified either in the `pyproject.toml` or tool-specific
192+
config files, such as `.prettierrc.yml` for **prettier** and `.flake8` for **flake8**.
193193

194194
### How to ignore certain lint warnings
195195

@@ -220,10 +220,10 @@ W504
220220
Scverse ecosystem packages should operate on [AnnData][] and/or [MuData][] data structures and typically use an API
221221
as originally [introduced by scanpy][scanpy-api] with the following submodules:
222222
223-
- `pp` for preprocessing
224-
- `tl` for tools (that, compared to `pp` generate interpretable output, often associated with a corresponding plotting
225-
function)
226-
- `pl` for plotting functions
223+
- `pp` for preprocessing
224+
- `tl` for tools (that, compared to `pp` generate interpretable output, often associated with a corresponding plotting
225+
function)
226+
- `pl` for plotting functions
227227
228228
You may add additional submodules as appropriate. While we encourage to follow a scanpy-like API for ecosystem packages,
229229
there may also be good reasons to choose a different approach, e.g. using an object-oriented API.
@@ -280,12 +280,12 @@ The pull request can only be merged after all `*.rej` files have been removed.
280280
:::{tip}
281281
The following hints may be useful to work with the template sync:
282282

283-
- GitHub automatically disables scheduled actions if there has been not activity to the repository for 60 days.
284-
You can re-enable or manually trigger the sync by navigating to `Actions` -> `Sync Template` in your GitHub repository.
285-
- If you want to ignore certain files from the template update, you can add them to the `[tool.cruft]` section in the
286-
`pyproject.toml` file in the root of your repository. More details are described in the
287-
[cruft documentation][cruft-update-project].
288-
- To disable the sync entirely, simply remove the file `.github/workflows/sync.yaml`.
283+
- GitHub automatically disables scheduled actions if there has been not activity to the repository for 60 days.
284+
You can re-enable or manually trigger the sync by navigating to `Actions` -> `Sync Template` in your GitHub repository.
285+
- If you want to ignore certain files from the template update, you can add them to the `[tool.cruft]` section in the
286+
`pyproject.toml` file in the root of your repository. More details are described in the
287+
[cruft documentation][cruft-update-project].
288+
- To disable the sync entirely, simply remove the file `.github/workflows/sync.yaml`.
289289

290290
:::
291291

0 commit comments

Comments
 (0)