publish to anaconda

* initial version

* read version from setup.py

* build from local source

* added conda build and publish steps

* fix spacing

* added conda install command

Author: jlwalke2

.conda/meta.yaml

@@ -0,0 +1,45 @@
+{% set data = load_setup_py_data(setup_file='../setup.py', from_recipe_dir=True) %}
+{% set name = "sasctl" %}
+{% set version = data.get('version') %}
+
+package:
+  name: {{ name|lower }}
+  version: {{ data.version }}
+
+source:
+  path: ..
+
+build:
+  entry_points:
+    - sasctl = sasctl.utils.cli:main
+  noarch: python
+  script: {{ PYTHON }} -m pip install . -vv
+  number: 0
+
+requirements:
+  host:
+    - python >=3.6
+    - pip
+  run:
+    - python >=3.6
+    - pandas
+    - requests
+    - pyyaml
+    - packaging
+
+test:
+  imports:
+    - sasctl
+  commands:
+    - pip check
+    - sasctl --help
+  requires:
+    - pip
+
+about:
+  home: https://github.com/sassoftware/python-sasctl/
+  summary: "Python package and CLI for user-friendly integration with SAS Viya"
+  license: Apache-2.0
+  license_file: LICENSE
+  doc_url: https://sassoftware.github.io/python-sasctl/
+  dev_url: https://github.com/sassoftware/python-sasctl/

.github/workflows/build-test-deploy.yml

@@ -118,11 +118,12 @@ jobs:
           name: html-docs
           path: ./docs/_build/html
 
-  build:
-    name: "Build Package"
+  # Build a package for distribution through PyPI.org (pip install sasctl)
+  build_pypi:
+    name: "Build PyPI Package"
     runs-on: ubuntu-latest
     needs: test
-    if: startsWith(github.ref, 'refs/tags/') # run only on tagged commits
+    if: startsWith(github.ref, 'refs/tags/')  # run only on tagged commits
 
     steps:
       - name: Checkout repository
@@ -158,38 +159,74 @@ jobs:
 
       - name: Archive distribution artifacts
         # Archive distribution files for use by auto (or manual) PyPI upload
-        uses: actions/upload-artifact@v2
+        uses: actions/upload-artifact@v3
         with:
           name: pypi-dist
           path: ./dist
 
       - name: Archive changelog artifacts
-        uses: actions/upload-artifact@v2
+        uses: actions/upload-artifact@v3
         with:
           name: release_notes
           path: release_notes.md
 
+  # Build a package for distribution through Anaconda.org (conda install sasctl)
+  build_conda:
+    name: "Build Conda Package"
+    runs-on: ubuntu-latest
+    needs: test
+    if: startsWith(github.ref, 'refs/tags/') # run only on tagged commits
+
+    steps:
+      # Setup Miniconda
+      - uses: conda-incubator/setup-miniconda@v2
+        with:
+          auto-update-conda: true
+
+      - name: Install conda-build
+        shell: bash -l {0}
+        run: |
+          conda install conda-build
+
+      - name: Checkout repository
+        uses: actions/checkout@v3
 
+      # Build package and store results in .build folder
+      - name: Build package
+        shell: bash -l {0}
+        run: |
+          conda build --output-folder .build .conda
+
+      # Archive distribution files.  Will upload in a downstream job.
+      - name: Archive distribution artifacts
+        uses: actions/upload-artifact@v3
+        with:
+          name: conda-dist
+          path: .build
+
+
+  # Publishes the new package to PyPI, uploads the latest documentation to GitHub Pages
+  # and creates a new release with change notes on GitHub.
   publish:
     name: "Publish"
     runs-on: ubuntu-latest
-    needs: [gh-pages, build]
-    steps:
+    needs: [gh-pages, build_pypi, build_conda]
 
+    steps:
       - name: Download documentation
-        uses: actions/download-artifact@v2
+        uses: actions/download-artifact@v3
         with:
           name: html-docs
           path: ./html-docs
 
       - name: Download release
-        uses: actions/download-artifact@v2
+        uses: actions/download-artifact@v3
         with:
           name: pypi-dist
           path: ./dist
 
       - name: Download release notes
-        uses: actions/download-artifact@v2
+        uses: actions/download-artifact@v3
         with:
           name: release_notes
 
@@ -199,6 +236,7 @@ jobs:
       - name: Display structure of downloaded files
         run: ls -R
 
+      # Create a draft release on GitHub
       - name: Create Release
         id: create_release
         uses: softprops/action-gh-release@v1
@@ -208,6 +246,7 @@ jobs:
           body: ""
           files: documentation.zip
 
+      # Publish the documentation to GitHub Pages
       - name: Deploy documentation
         uses: peaceiris/actions-gh-pages@v3
         with:
@@ -221,10 +260,45 @@ jobs:
           password: ${{ secrets.PYPI_API_TOKEN }}
           verbose: true
 
+      # Publish the release on GitHub (remove draft status)
       - name: Publish release
         uses: StuYarrow/publish-release@v1
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           id: ${{ steps.create_release.outputs.id }}
 
+
+  # Uploads the package to Anaconda.
+  # NOTE: could be merged with `publish` job above.  Left as a separate, final job since it
+  #       involves multiple steps to setup the environment and if this job fails, the package
+  #       has already been made available through pip, and the release info published.
+  upload_conda:
+    name: "Upload Conda Package"
+    runs-on: ubuntu-latest
+    needs: [publish]
+
+    steps:
+      # Setup Miniconda
+      - uses: conda-incubator/setup-miniconda@v2
+        with:
+          auto-update-conda: true
+
+      # Setup Anaconda client (required for upload)
+      - name: Install anaconda client
+        shell: bash -l {0}
+        run: |
+          conda install anaconda-client
+
+      # Download release files
+      - name: Download release
+        uses: actions/download-artifact@v3
+        with:
+          name: conda-dist
+          path: ./dist
+
+      # Upload release to Anaconda.org
+      - name: Upload release
+        shell: bash -l {0}
+        run: |
+          anaconda -t ${{ secrets.ANACONDA_TOKEN }} upload -u sas-institute ./dist/noarch/sasctl-*.tar.bz2

README.md

@@ -86,6 +86,10 @@ install the latest source code:
 
 ```pip install git+https://github.com/sassoftware/python-sasctl```
 
+Alternatively, if you're using Anaconda you can install with:
+```
+conda install -c sas-institute sasctl
+```
 
 ## Getting Started