Mark skeleton for deprecation.

conda_build/api.py

@@ -300,6 +300,7 @@ def test(
     return test_result
 
 
+@deprecated("3.25.0", "4.0.0", addendum="Use `grayskull` instead.")
 def list_skeletons():
     """List available skeletons for generating conda recipes from external sources.
 
@@ -315,6 +316,7 @@ def list_skeletons():
     return files
 
 
+@deprecated("3.25.0", "4.0.0", addendum="Use `grayskull` instead.")
 def skeletonize(
     packages, repo, output_dir=".", version=None, recursive=False, config=None, **kwargs
 ):

conda_build/cli/main_skeleton.py

@@ -6,9 +6,11 @@
 import pkgutil
 import sys
 
-import conda_build.api as api
-from conda_build.conda_interface import ArgumentParser
-from conda_build.config import Config
+from .. import api
+from ..conda_interface import ArgumentParser
+from ..config import Config
+from ..deprecations import deprecated
+
 
 thisdir = os.path.dirname(os.path.abspath(__file__))
 logging.basicConfig(level=logging.INFO)
@@ -19,6 +21,7 @@ def parse_args(args):
         description="""
 Generates a boilerplate/skeleton recipe, which you can then edit to create a
 full recipe. Some simple skeleton recipes may not even need edits.
+Pending deprecation, please use the standalone project 'grayskull'."
         """,
         epilog="""
 Run --help on the subcommands like 'conda skeleton pypi --help' to see the
@@ -46,6 +49,13 @@ def execute(args):
     parser, args = parse_args(args)
     config = Config(**args.__dict__)
 
+    deprecated.topic(
+        "3.25.0",
+        "4.0.0",
+        topic="`conda-build skeleton` and `conda skeleton`",
+        addendum="Use the `grayskull` project instead.",
+    )
+
     if not args.repo:
         parser.print_help()
         sys.exit()

conda_build/skeletons/cpan.py

@@ -21,8 +21,8 @@
 
 import requests
 
-from conda_build import environ
-from conda_build.conda_interface import (
+from . import environ
+from ..conda_interface import (
     CondaError,
     CondaHTTPError,
     MatchSpec,
@@ -31,10 +31,11 @@
     download,
     get_index,
 )
-from conda_build.config import get_or_merge_config
-from conda_build.utils import check_call_env, on_win
-from conda_build.variants import get_default_variant
-from conda_build.version import _parse as parse_version
+from ..config import get_or_merge_config
+from ..deprecations import deprecated
+from ..utils import check_call_env, on_win
+from ..variants import get_default_variant
+from ..version import _parse as parse_version
 
 CPAN_META = """\
 {{% set name = "{packagename}" %}}
@@ -390,7 +391,7 @@ def get_core_modules_for_this_perl_version(version, cache_dir):
     )
 
 
-# meta_cpan_url="http://api.metacpan.org",
+@deprecated("3.25.0", "4.0.0", addendum="Use grayskull instead.")
 def skeletonize(
     packages,
     output_dir=".",

conda_build/skeletons/cran.py

@@ -40,12 +40,13 @@
 
 from conda.common.io import dashlist
 
-from conda_build import metadata, source
-from conda_build.conda_interface import TemporaryDirectory, cc_conda_build
-from conda_build.config import get_or_merge_config
-from conda_build.license_family import allowed_license_families, guess_license_family
-from conda_build.utils import ensure_list, rm_rf
-from conda_build.variants import DEFAULT_VARIANTS, get_package_variants
+from . import metadata, source
+from ..conda_interface import TemporaryDirectory, cc_conda_build
+from ..config import get_or_merge_config
+from ..deprecations import deprecated
+from ..license_family import allowed_license_families, guess_license_family
+from ..utils import ensure_list, rm_rf
+from ..variants import DEFAULT_VARIANTS, get_package_variants
 
 SOURCE_META = """\
   {archive_keys}
@@ -853,6 +854,7 @@ def remove_comments(template):
     return "\n".join(lines_no_comments)
 
 
+@deprecated("3.25.0", "4.0.0", addendum="Use `grayskull` instead.")
 def skeletonize(
     in_packages,
     output_dir=".",

conda_build/skeletons/luarocks.py

@@ -15,6 +15,9 @@
 from glob import glob
 from sys import platform as _platform
 
+from ..deprecations import deprecated
+
+
 INDENT = "\n    - "
 
 rockspec_parser = """
@@ -224,6 +227,7 @@ def ensure_base_deps(deps):
     return deps
 
 
+@deprecated("3.25.0", "4.0.0", addendum="Use `grayskull` instead.")
 def skeletonize(packages, output_dir=".", version=None, recursive=False):
     # Check that we have Lua installed (any version)
 

conda_build/skeletons/pypi.py

@@ -23,7 +23,7 @@
 import yaml
 from requests.packages.urllib3.util.url import parse_url
 
-from conda_build.conda_interface import (
+from ..conda_interface import (
     StringIO,
     configparser,
     default_python,
@@ -34,20 +34,21 @@
     normalized_version,
     spec_from_line,
 )
-from conda_build.config import Config
-from conda_build.environ import create_env
-from conda_build.license_family import allowed_license_families, guess_license_family
-from conda_build.metadata import MetaData
-from conda_build.render import FIELDS as EXPECTED_SECTION_ORDER
-from conda_build.source import apply_patch
-from conda_build.utils import (
+from ..config import Config
+from ..deprecations import deprecated
+from ..environ import create_env
+from ..license_family import allowed_license_families, guess_license_family
+from ..metadata import MetaData
+from ..render import FIELDS as EXPECTED_SECTION_ORDER
+from ..source import apply_patch
+from ..utils import (
     check_call_env,
     decompressible_exts,
     ensure_list,
     rm_rf,
     tar_xf,
 )
-from conda_build.version import _parse as parse_version
+from ..version import _parse as parse_version
 
 pypi_example = """
 Examples:
@@ -253,6 +254,7 @@ def _formating_value(attribute_name, attribute_value):
     return " " + str(attribute_value) + "\n"
 
 
+@deprecated("3.25.0", "4.0.0", addendum="Use `grayskull` instead.")
 def skeletonize(
     packages,
     output_dir=".",

conda_build/skeletons/rpm.py

@@ -3,9 +3,6 @@
 import argparse
 from copy import copy
 
-from conda_build.license_family import guess_license_family
-from conda_build.source import download_to_cache
-
 try:
     import cPickle as pickle
 except:
@@ -19,6 +16,9 @@
 from textwrap import wrap
 from xml.etree import ElementTree as ET
 
+from ..deprecations import deprecated
+from ..license_family import guess_license_family
+from ..source import download_to_cache
 from .cran import yaml_quote_string
 
 try:
@@ -719,6 +719,7 @@ def write_conda_recipe(
         )
 
 
+@deprecated("3.25.0", "4.0.0", addendum="Use `grayskull` instead.")
 def skeletonize(
     packages,
     output_dir=".",

news/4640-use-grayskull

@@ -0,0 +1,23 @@
+### Enhancements
+
+* <news item>
+
+### Bug fixes
+
+* <news item>
+
+### Deprecations
+
+* `conda-build skeleton` is pending deprecation. `conda-build` still provides the
+  `conda-build skeleton` a.k.a. `conda skeleton` CLI for now, but will remove
+  it eventually.
+* Prefer the [standalone grayskull package](https://conda.github.io/grayskull/),
+  instead of `conda-build skeleton` or `conda skeleton`.
+
+### Docs
+
+* <news item>
+
+### Other
+
+* <news item>