Add support for conda channel being different from username.

Author: domdfcoding

repo_helper/configuration/__init__.py

@@ -52,7 +52,13 @@
 		testing,
 		travis
 		)
-from repo_helper.configuration.conda_anaconda import conda_channels, conda_description, conda_extras, enable_conda
+from repo_helper.configuration.conda_anaconda import (
+		conda_channels,
+		conda_description,
+		conda_extras,
+		enable_conda,
+		primary_conda_channel
+		)
 from repo_helper.configuration.documentation import (
 		docs_dir,
 		docs_url,
@@ -154,6 +160,7 @@
 		"author",
 		"classifiers",
 		"conda_channels",
+		"primary_conda_channel",
 		"conda_extras",
 		"conda_description",
 		"console_scripts",
@@ -346,6 +353,11 @@ def custom_parsing(
 			url = f"https://{parsed_config_vars['repo_name'].lower()}.readthedocs.io/en/latest"
 			parsed_config_vars["docs_url"] = url
 
+		parsed_config_vars["conda_channels"] = sorted({
+				*parsed_config_vars["conda_channels"],
+				parsed_config_vars["primary_conda_channel"],
+				})
+
 		return parsed_config_vars
 
 

repo_helper/configuration/conda_anaconda.py

@@ -32,7 +32,7 @@
 # this package
 from repo_helper.configuration import metadata
 
-__all__ = ["enable_conda", "conda_channels", "conda_description", "conda_extras"]
+__all__ = ["enable_conda", "conda_channels", "conda_description", "conda_extras", "primary_conda_channel"]
 
 
 class enable_conda(ConfigVar):  # noqa
@@ -127,3 +127,26 @@ class conda_description(ConfigVar):  # noqa
 	dtype = str
 	default = metadata.short_desc
 	category: str = "conda & anaconda"
+
+
+class primary_conda_channel(ConfigVar):  # noqa
+	"""
+	The Conda channel the package can be downloaded from.
+
+	This is automatically added to :conf:`conda_channels`.
+
+	Defaults to :conf:`username` if unset.
+
+	Example:
+
+	.. code-block:: yaml
+
+		username: repo-helper
+		primary_conda_channel: domdfcoding
+
+	.. versionadded:: 2020.12.17
+	"""
+
+	dtype = str
+	default = metadata.username
+	category: str = "metadata"

repo_helper/repo_helper_schema.json

@@ -263,6 +263,10 @@
       ],
       "description": "Whether custom documentation theme styling in ``_static/style.css`` and ``_templates/layout.html`` should be preserved."
     },
+    "primary_conda_channel": {
+      "type": "string",
+      "description": "The Conda channel the package can be downloaded from."
+    },
     "pure_python": {
       "type": [
         "boolean",

tests/test_cli/test_conda_recipe_/test_conda_recipe.yaml

@@ -59,7 +59,7 @@ about:
   description: "Update multiple configuration files, build scripts etc. from a single location.
 
 
-Before installing please ensure you have added the following channels: domdfcoding, conda-forge
+Before installing please ensure you have added the following channels: conda-forge, domdfcoding
 "
   doc_url: https://repo_helper_demo.readthedocs.io
   dev_url: https://github.com/domdfcoding/repo_helper_demo

tests/test_cli/test_conda_recipe_/test_conda_recipe_specifiers.yaml

@@ -37,7 +37,7 @@ about:
   description: "Update multiple configuration files, build scripts etc. from a single location.
 
 
-Before installing please ensure you have added the following channels: domdfcoding, conda-forge
+Before installing please ensure you have added the following channels: conda-forge, domdfcoding
 "
   doc_url: https://repo_helper_demo.readthedocs.io
   dev_url: https://github.com/domdfcoding/repo_helper_demo

tests/test_configuration_/test_parse_yaml.yml

@@ -17,8 +17,8 @@ classifiers:
 - 'Programming Language :: Python :: Implementation :: CPython'
 - 'Topic :: Utilities'
 conda_channels:
-- domdfcoding
 - conda-forge
+- domdfcoding
 conda_description: Update multiple configuration files, build scripts etc. from a
   single location.
 conda_extras:
@@ -80,6 +80,7 @@ platforms:
 - Linux
 pre_commit_exclude: ^$
 preserve_custom_theme: true
+primary_conda_channel: domdfcoding
 pure_python: true
 py_modules: []
 pypi_name: repo_helper_demo