Skip to content

Commit 1f33044

Browse files
authored
Readme updates (#30)
* Minor change * Update pyproject toml * Fix templates * Update readme * Remove unused file * Fix badge * Correctly comment out lines * Update action * Update project name * Update instructions * Minor updates * MInor update
1 parent f4fca4a commit 1f33044

9 files changed

Lines changed: 174 additions & 85 deletions

File tree

.github/ISSUE_TEMPLATE/bug_report.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ body:
6767
6868
validations:
6969
required: true
70-
- type: input
70+
- type: checkboxes
7171
id: charge-code
7272
attributes:
7373
label: Charge code

.github/ISSUE_TEMPLATE/feature_request.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ body:
5454
description: >
5555
Please provide any relevant GitHub issues, code examples, references, screenshots, or other material
5656
that help describe and support the feature request.
57-
- type: input
57+
- type: checkboxes
5858
id: charge-code
5959
attributes:
6060
label: Charge code

.github/workflows/ci-python.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ jobs:
2727

2828
locked-tests:
2929
# needs: lint
30-
name: Pixi-Locked Unit Tests
30+
name: Pixi-Locked Tests
3131
runs-on: ubuntu-latest
3232
strategy:
3333
fail-fast: false
@@ -54,7 +54,7 @@ jobs:
5454
5555
tests:
5656
# needs: lint
57-
name: Python Unit Tests (Pixi)
57+
name: Python Tests (Pixi)
5858
runs-on: ${{ matrix.os }}
5959
strategy:
6060
fail-fast: false

.github/workflows/publish_to_pypi.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
name: Upload to PyPi
22

33
on:
4-
# release:
5-
# types: [published]
4+
release:
5+
types: [published]
66
workflow_dispatch:
77

88
jobs:

README.md

Lines changed: 0 additions & 32 deletions
This file was deleted.

README.rst

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
******
2+
reVeal
3+
******
4+
5+
|License| |Ruff| |Pixi| |SWR|
6+
7+
.. |PythonV| image:: https://badge.fury.io/py/reVeal.svg
8+
:target: https://pypi.org/project/reVeal/
9+
10+
.. |PyPi| image:: https://img.shields.io/pypi/pyversions/reVeal.svg
11+
:target: https://pypi.org/project/reVeal/
12+
13+
.. |Ruff| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
14+
:target: https://github.com/astral-sh/ruff
15+
16+
.. |License| image:: https://img.shields.io/badge/License-BSD_3--Clause-orange.svg
17+
:target: https://opensource.org/licenses/BSD-3-Clause
18+
19+
.. |Pixi| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json
20+
:target: https://pixi.sh
21+
22+
.. |SWR| image:: https://img.shields.io/badge/SWR--25--147_-blue?label=NLR
23+
:alt: Static Badge
24+
25+
.. |Zenodo| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.17633670.svg
26+
:target: https://doi.org/10.5281/zenodo.17633670
27+
28+
.. inclusion-intro
29+
30+
31+
``reVeal`` (the reV Extension for Analyzing Large Loads) is an open-source geospatial
32+
software package for modeling the site-suitability and spatial patterns of deployment
33+
of large sources of electricity demand under future scenarios. ``reVeal`` is part of
34+
the `reV ecosystem of tools <https://nrel.github.io/reV/#rev-ecosystem>`_.
35+
36+
37+
Installing reVeal
38+
=================
39+
The quickest way to install reVeal for users is from PyPI:
40+
41+
.. code-block:: bash
42+
43+
pip install NLR-reVeal
44+
45+
If you would like to install and run reVeal from source, we recommend using `pixi <https://pixi.sh/latest/>`_:
46+
47+
.. code-block:: bash
48+
49+
git clone git@github.com:NREL/reVeal.git; cd reVeal
50+
pixi run reVeal
51+
52+
For detailed instructions, see the `installation documentation <https://nrel.github.io/reVeal/misc/installation.html>`_.
53+
54+
55+
Quickstart
56+
==========
57+
.. To run a quick reVeal demo, use:
58+
59+
.. .. code-block:: shell
60+
61+
.. pixi run demo
62+
63+
.. This will generate sample map outputs using example reV geothermal supply curve outputs.
64+
65+
For more information on running ``reVeal``, see
66+
`Usage <https://github.com/NREL/reVeal/blob/main/USAGE.md>`_.
67+
68+
69+
Development
70+
===========
71+
Please see the `Development Guidelines <https://nrel.github.io/reVeal/dev/index.html>`_
72+
if you wish to contribute code to this repository.

pixi.lock

Lines changed: 40 additions & 40 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

pyproject.toml

Lines changed: 56 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ requires = [
66
build-backend = 'setuptools.build_meta'
77

88
[project]
9-
name = "reVeal"
9+
name = "NLR-reVeal"
1010
dynamic = ["version"]
1111
description = "The reV Extension for Analyzing Large Loads."
1212
readme = "README.rst"
@@ -130,7 +130,7 @@ rasterio = ">=1.4.4,<2"
130130
tqdm = ">=4.67.1,<5"
131131

132132
[tool.pixi.pypi-dependencies]
133-
reVeal = { path = ".", editable = true }
133+
NLR-reVeal = { path = ".", editable = true }
134134

135135
[tool.pixi.feature.dev.dependencies]
136136
ipython = ">=8.29.0,<9"
@@ -165,3 +165,57 @@ sphinxcontrib-mermaid = ">=1.0.0,<2"
165165
python-build = ">=1.3.0,<2"
166166
pkginfo = ">=1.12.1.2,<2"
167167
uv = ">=0.9.10,<0.10"
168+
169+
170+
[tool.coverage.report]
171+
# Regexes for lines to exclude from consideration
172+
exclude_also = [
173+
# Have to re-enable the standard pragma
174+
"pragma: no cover",
175+
176+
# Don't complain about missing debug-only code:
177+
"if self\\.debug",
178+
179+
# Don't complain about repr methods
180+
"def __repr__",
181+
"def _repr_markdown_",
182+
183+
# Don't complain about data I/O code
184+
"def load*",
185+
"def _load*",
186+
187+
# Don't complain if tests don't hit defensive assertion code:
188+
"raise AssertionError",
189+
"raise NotImplementedError",
190+
191+
# Don't complain if non-runnable code isn't run:
192+
"if __name__ == .__main__.:",
193+
194+
# Don't complain about abstract methods, they aren't run:
195+
"@(abc\\.)?abstractmethod",
196+
197+
# Don't complain about logging debugging functions
198+
"def print_logging_info*",
199+
"def __cls_name",
200+
]
201+
202+
omit = [
203+
# omit test files
204+
"tests/*",
205+
# omit init files
206+
"__init__.py",
207+
# omit version file
208+
"_version.py",
209+
# omit log file copied over from other repo
210+
"reVeal/log.py",
211+
# omit pixi files
212+
".pixi/*",
213+
]
214+
215+
216+
[tool.pytest.ini_options]
217+
addopts = "--disable-warnings"
218+
testpaths = [
219+
"tests"
220+
]
221+
markers = "skip_ci: marks test as one that should not be run on GitHub Workflows"

pytest.ini

Lines changed: 0 additions & 5 deletions
This file was deleted.

0 commit comments

Comments
 (0)