employ a src layout for code base

.flake8

@@ -12,7 +12,7 @@ ignore =
 	F,
 	W503
 per-file-ignores =
-	xclim/core/locales.py:RST399
+	src/xclim/core/locales.py:RST399
 rst-directives =
 	bibliography,
 	autolink-skip

.github/labeler.yml

@@ -40,10 +40,10 @@
 'indicators':
   - changed-files:
     - any-glob-to-any-file:
-      - 'xclim/indicators/**/*'
-      - 'xclim/indices/**/_*.py'
-      - 'xclim/data/**/*.json'
-      - 'xclim/data/**/*.yml'
+      - 'src/xclim/indicators/**/*'
+      - 'src/xclim/indices/**/_*.py'
+      - 'src/xclim/data/**/*.json'
+      - 'src/xclim/data/**/*.yml'
 
 'information':
   - changed-files:
@@ -53,5 +53,5 @@
 'sdba':
   - changed-files:
     - any-glob-to-any-file:
-      - 'xclim/sdba/**/*'
+      - 'src/xclim/sdba/**/*'
       - 'tests/test_sdba/*.py'

.github/workflows/bump-version.yml

@@ -21,8 +21,8 @@ on:
       - environment.yml
       - pylintrc
       - pyproject.toml
+      - src/xclim/__init__.py
       - tox.ini
-      - xclim/__init__.py
 
 permissions:
   contents: read
@@ -68,7 +68,7 @@ jobs:
           trust_level: 5
       - name: Current Version
         run: |
-          CURRENT_VERSION="$(grep -E '__version__'  xclim/__init__.py | cut -d ' ' -f3)"
+          CURRENT_VERSION="$(grep -E '__version__'  src/xclim/__init__.py | cut -d ' ' -f3)"
           echo "current_version=${CURRENT_VERSION}"
           echo "CURRENT_VERSION=${CURRENT_VERSION}" >> $GITHUB_ENV
       - name: Install CI libraries
@@ -83,7 +83,7 @@ jobs:
             echo "Version is stable, bumping 'patch' version"
             bump-my-version bump patch
           fi
-          NEW_VERSION="$(grep -E '__version__'  xclim/__init__.py | cut -d ' ' -f3)"
+          NEW_VERSION="$(grep -E '__version__'  src/xclim/__init__.py | cut -d ' ' -f3)"
           echo "new_version=${NEW_VERSION}"
           echo "NEW_VERSION=${NEW_VERSION}" >> $GITHUB_ENV
       - name: Push Changes

.github/workflows/codeql.yml

@@ -10,7 +10,7 @@ on:
       - Makefile
       - pyproject.toml
       - tox.ini
-      - xclim/__init__.py
+      - src/xclim/__init__.py
       - docs/*/*.ipynb
       - docs/*/*.py
       - docs/*/*.rst

.github/workflows/main.yml

@@ -8,7 +8,7 @@ on:
       - CHANGELOG.rst
       - README.rst
       - pyproject.toml
-      - xclim/__init__.py
+      - src/xclim/__init__.py
   pull_request:
     types:
       - opened

.github/workflows/publish-mastodon.yml

@@ -79,7 +79,7 @@ jobs:
           echo "${{ steps.render_template.outputs.result }}${{ env.contributors }}"
 
       - name: Send toot to Mastodon
-        if: ${{ github.event.inputs.dry-run != 'true' }} || ${{ github.event_name == 'release' }}
+        if: ${{ github.event.inputs.dry-run != 'true' || github.event_name == 'release' }}
         uses: cbrgm/mastodon-github-action@b26d62619432b20c2129edd86f07f7ede9797fc9 # v2.1.9
         with:
           url: ${{ secrets.MASTODON_URL }}

.github/workflows/upstream.yml

@@ -7,7 +7,7 @@ on:
       - CHANGELOG.rst
       - README.rst
       - pyproject.toml
-      - xclim/__init__.py
+      - src/xclim/__init__.py
   schedule:
     - cron: "0 0 * * *" # Daily “At 00:00” UTC
   workflow_dispatch: # allows you to trigger the workflow run manually

.gitignore

@@ -24,7 +24,6 @@ parts/
 sdist/
 var/
 wheels/
-src/
 *.egg-info/
 .installed.cfg
 *.egg

.pre-commit-config.yaml

@@ -7,7 +7,7 @@ repos:
     hooks:
       - id: pyupgrade
         args: ['--py39-plus']
-        exclude: 'xclim/core/indicator.py'
+        exclude: 'src/xclim/core/indicator.py'
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v5.0.0
     hooks:
@@ -91,7 +91,7 @@ repos:
     hooks:
       - id: blackdoc
         additional_dependencies: [ 'black==24.10.0' ]
-        exclude: '(xclim/indices/__init__.py|docs/installation.rst)'
+        exclude: '(src/xclim/indices/__init__.py|docs/installation.rst)'
       - id: blackdoc-autoupdate-black
   - repo: https://github.com/codespell-project/codespell
     rev: v2.3.0

.readthedocs.yml

@@ -13,9 +13,9 @@ build:
     python: "mambaforge-22.9"
   jobs:
     pre_build:
-      - sphinx-apidoc -o docs/apidoc/ --private --module-first xclim xclim/testing/tests xclim/indicators xclim/indices
+      - sphinx-apidoc -o docs/apidoc/ --private --module-first xclim src/xclim/testing/tests src/xclim/indicators src/xclim/indices
       - rm docs/apidoc/xclim.rst
-      - env SPHINX_APIDOC_OPTIONS="members,undoc-members,show-inheritance,noindex" sphinx-apidoc -o docs/apidoc/ --private --module-first xclim xclim/testing/tests
+      - env SPHINX_APIDOC_OPTIONS="members,undoc-members,show-inheritance,noindex" sphinx-apidoc -o docs/apidoc/ --private --module-first xclim src/xclim/testing/tests
       - sphinx-build -b linkcheck docs/ _build/linkcheck || true
 
 conda:

.yamllint.yaml

@@ -1,8 +1,39 @@
 ---
 
 rules:
+
+  brackets:
+    forbid: false
+    min-spaces-inside: 0
+    max-spaces-inside: 1
+
+  commas:
+    min-spaces-after: 1
+
   document-start: disable
+
+  float-values:
+    require-numeral-before-decimal: true
+
+  hyphens:
+    max-spaces-after: 1
+
+  indentation:
+    indent-sequences: whatever
+    spaces: consistent
+
+  key-duplicates:
+    forbid-duplicated-merge-keys: true
+
   line-length:
+    allow-non-breakable-words: true
+    allow-non-breakable-inline-mappings: true
     max: 120
     level: warning
+
+  new-lines:
+    type: unix
+
+  trailing-spaces: {}
+
   truthy: disable

CHANGELOG.rst

@@ -2,6 +2,14 @@
 Changelog
 =========
 
+v0.54.0 (unreleased)
+--------------------
+Contributors to this version: Trevor James Smith (:user:`Zeitsperre`).
+
+Internal changes
+^^^^^^^^^^^^^^^^
+* `xclim` now uses a `src` layout for the codebase. Structure-dependent functions, documentation, and build commands have been adapted to reflect these changes.
+
 v0.53.1 (2024-10-21)
 --------------------
 Contributors to this version: Trevor James Smith (:user:`Zeitsperre`).