sunwhere 1.4.0__tar.gz

sunwhere-1.4.0/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.3
+Name: sunwhere
+Version: 1.4.0
+Summary: Fast and accurate solar position calculations for solar resource assessment
+Keywords: solar,sun position,solar geometry,solar resource
+Author: Jose A Ruiz-Arias
+Author-email: Jose A Ruiz-Arias <jararias@uma.es>
+License: CC BY-NC-SA 4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Natural Language :: English
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: License :: Other/Proprietary License
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: numexpr>=2.14.1
+Requires-Dist: numpy>=2.4.4
+Requires-Dist: pandas>=3.0.2
+Requires-Dist: xarray>=2026.4.0
+Requires-Dist: matplotlib>=3.10.9 ; extra == 'cli'
+Requires-Dist: python-dateutil>=2.9.0.post0 ; extra == 'cli'
+Requires-Dist: tabulate>=0.10.0 ; extra == 'cli'
+Requires-Dist: tqdm>=4.67.3 ; extra == 'cli'
+Requires-Dist: typer>=0.25.0 ; extra == 'cli'
+Requires-Python: >=3.11
+Project-URL: Homepage, https://github.com/jararias/sunwhere
+Project-URL: Documentation, https://jararias.github.io/sunwhere
+Project-URL: Repository, https://github.com/jararias/sunwhere
+Project-URL: Issues, https://github.com/jararias/sunwhere/issues
+Provides-Extra: cli
+Description-Content-Type: text/markdown
+
+![python versions](https://img.shields.io/badge/python-3.11%2C3.12%2C3.13-blue.svg) ![tests-badge](docs/images/tests-badge.svg) ![coverage-badge](docs/images/coverage-badge.svg)
+
+# sunwhere. Solar position calculation for solar resource assessment
+
+## Installation
+
+```sh
+pip install sunwhere
+```
+
+## Documentation
+
+Visit the [documentation](https://jararias.github.io/sunwhere/) for detailed guides and API reference.
+
+## License
+
+CC BY-NC-SA 4.0

sunwhere-1.4.0/README.md

@@ -0,0 +1,17 @@
+![python versions](https://img.shields.io/badge/python-3.11%2C3.12%2C3.13-blue.svg) ![tests-badge](docs/images/tests-badge.svg) ![coverage-badge](docs/images/coverage-badge.svg)
+
+# sunwhere. Solar position calculation for solar resource assessment
+
+## Installation
+
+```sh
+pip install sunwhere
+```
+
+## Documentation
+
+Visit the [documentation](https://jararias.github.io/sunwhere/) for detailed guides and API reference.
+
+## License
+
+CC BY-NC-SA 4.0

sunwhere-1.4.0/pyproject.toml

@@ -0,0 +1,89 @@
+[build-system]
+requires = ["uv_build"]
+build-backend = "uv_build"
+
+[project]
+name = "sunwhere"
+version = "1.4.0"
+description = "Fast and accurate solar position calculations for solar resource assessment"
+readme = "README.md"
+requires-python = ">=3.11"
+authors = [{name = "Jose A Ruiz-Arias", email = "jararias@uma.es"}]
+license = {text = "CC BY-NC-SA 4.0"}
+keywords = ["solar", "sun position", "solar geometry", "solar resource"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Natural Language :: English",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering",
+    "Topic :: Scientific/Engineering :: Physics",
+    "License :: Other/Proprietary License",
+]
+
+dependencies = [
+    "loguru>=0.7.3",
+    "numexpr>=2.14.1",
+    "numpy>=2.4.4",
+    "pandas>=3.0.2",
+    "xarray>=2026.4.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/jararias/sunwhere"
+Documentation = "https://jararias.github.io/sunwhere"
+Repository = "https://github.com/jararias/sunwhere"
+Issues = "https://github.com/jararias/sunwhere/issues"
+
+[dependency-groups]
+# estas son las dependencias que se supone que solo los desarrolladores van a
+# querer (posiblemente) instalar. Al menos el grupo dev se instala por defecto
+# por uv cuando trabajamos en modo "editable"
+# con uv hay que añadirlos como: uv add --dev <package1> <package 2> ...
+dev = [
+    "cartopy>=0.25.0",
+    "coverage>=7.13.5",
+    "genbadge[tests]>=1.1.3",
+    "ipython>=9.13.0",
+    "mkdocstrings-python>=2.0.3",
+    "pvlib>=0.15.1",
+    "pytest>=9.0.3",
+    "pytest-allclose>=1.0.0",
+    "ruff>=0.15.12",
+    "seaborn>=0.13.2",
+    "solposx>=1.0.1",
+    "soltrack",
+    "tabulate>=0.10.0",
+    "tqdm>=4.67.3",
+    "urllib3>=2.7.0",
+    "zensical>=0.0.42",
+]
+
+[project.optional-dependencies]
+# estas son dependencias que un usuario final de la libreria puede querer instalar.
+# son las que se instalan como pip install libreria[opcion]
+# con uv hay que añadirlas como: uv add --optional cli <package1> <package2> ...
+cli = [
+    "matplotlib>=3.10.9",
+    "python-dateutil>=2.9.0.post0",
+    "tabulate>=0.10.0",
+    "tqdm>=4.67.3",
+    "typer>=0.25.0",
+]
+
+[tool.uv]
+# Esto asegura que uv sepa cómo resolver la dependencia de Git
+managed = true
+
+[tool.uv.sources]
+soltrack = { git = "https://github.com/jararias/soltrack" }
+
+[project.scripts]
+sunwhere = "sunwhere._cli.main:app"
+
+[tool.coverage.run]
+omit = ["sunwhere/utils/*"]

sunwhere-1.4.0/src/sunwhere/__init__.py

@@ -0,0 +1,16 @@
+
+import importlib.metadata
+
+from .usecases import sites, regular_grid, transect
+
+from ._core import __ALGORITHMS__
+from .utils.datetime import universal_time_coordinated
+
+try:
+    __version__ = importlib.metadata.version("sunwhere")
+except importlib.metadata.PackageNotFoundError:
+    __version__ = "0.0.0"
+
+SPA_ALGORITHMS = tuple(__ALGORITHMS__.keys())
+
+__all__ = ["sites", "regular_grid", "transect", "universal_time_coordinated", "__version__", "SPA_ALGORITHMS"]