Cloudsmith cli example (#22)

* Add command, test and example for using the cli to publish packages to cloudsmith

Author: robgodfrey

.circleci/simplepkg-py/README.txt

@@ -0,0 +1 @@
+Hello

.circleci/simplepkg-py/setup.py

@@ -0,0 +1,11 @@
+from setuptools import setup
+
+setup(
+    name='simplepkg',
+    version='0.0.1',
+    license='MIT',
+    long_description="README.txt",
+    packages=['simplepkg'],
+    include_package_data=True,
+    description="Simple Package",
+)

.circleci/simplepkg-py/simplepkg/__init__.py

@@ -0,0 +1,4 @@
+
+class Hello(object):
+    def say_hello(self):
+        return "Hello, World!"

.circleci/simplepkg-py/simplepkg/hello.py

@@ -73,6 +73,19 @@ jobs:
             fi
             echo "All tests passed."
 
+  test-upload_python_package:
+    docker:
+      - image: cimg/python:3.9
+    steps:
+      - checkout
+      - run:
+          name: Prepare distribution
+          command: python setup.py sdist
+          working_directory: .circleci/simplepkg-py
+      - cloudsmith-circleci/upload_python_package:
+          repository: "circleci-orb-testing"
+          service_account: "circleci-orb-testing"
+          package_path: .circleci/simplepkg-py/dist/simplepkg-0.0.1.tar.gz
 
 workflows:
   test-deploy:
@@ -85,6 +98,9 @@ workflows:
       - test-set_env_vars_for_pip:
           context: circleci-orb-publishing
           filters: *filters
+      - test-upload_python_package:
+          context: circleci-orb-publishing
+          filters: *filters
       # The orb must be re-packed for publishing, and saved to the workspace.
       - orb-tools/pack:
           filters: *release-filters
@@ -97,6 +113,7 @@ workflows:
             - orb-tools/pack
             - test-authenticate_with_oidc
             - test-set_env_vars_for_pip
+            - test-upload_python_package
           # Use a context to hold your publishing token.
           context: circleci-orb-publishing
           filters: *release-filters

.circleci/test-deploy.yml

@@ -2,3 +2,6 @@
 orb.yml
 .DS_Store
 .idea
+
+.circleci/simplepkg-py/dist
+.circleci/simplepkg-py/simplepkg.egg-info

.gitignore

@@ -9,16 +9,13 @@ parameters:
     type: string
 steps:
   - run:
-      name: Configure Cloudsmith organisation
+      name: Cloudsmith - Configure organisation and service account
       command: |
         if [ -z "$CLOUDSMITH_ORGANISATION" ]
         then
           echo "export CLOUDSMITH_ORGANISATION=\"financial-times\"" >> "$BASH_ENV"
         fi
-  - run:
-      name: Configure Cloudsmith service account
-      command: |
         echo "export CLOUDSMITH_SERVICE_ACCOUNT=\"<<parameters.service_account>>\"" >> "$BASH_ENV"
   - run:
-      name: Authenticate with OIDC
+      name: Cloudsmith - Authenticate with OIDC
       command: <<include(scripts/authenticate_with_oidc.sh)>>

src/commands/authenticate_with_oidc.yml

@@ -11,13 +11,13 @@ steps:
   - authenticate_with_oidc:
       service_account: <<parameters.service_account>>
   - run:
-      name: Configure Cloudsmith domains
+      name: Cloudsmith - Configure domains
       command: <<include(scripts/configure_cloudsmith_domains.sh)>>
   - run:
-      name: Configure Cloudsmith repository
+      name: Cloudsmith - Configure repository
       command: |
         echo "export CLOUDSMITH_REPOSITORY=\"<<parameters.repository>>\"" >> $BASH_ENV
         echo "CLOUDSMITH_REPOSITORY=<<parameters.repository>>"
   - run:
-      name: Set environment variables for pip
+      name: Cloudsmith - Set CLOUDSMITH_PIP_INDEX_URL environment variable
       command: <<include(scripts/set_env_vars_for_pip.sh)>>

src/commands/set_env_vars_for_pip.yml

@@ -0,0 +1,39 @@
+description:
+  Upload a python package to a Cloudsmith repository using the Cloudsmith CLI
+parameters:
+  repository:
+    description: The identity/slug of the Cloudsmith repository
+    type: string
+  service_account:
+    description: The identity/slug of the Cloudsmith service account to use when authenticating
+    type: string
+  package_path:
+    description: The location of the package files to upload
+    type: string
+steps:
+  - run:
+      name: Cloudsmith - Install CLI
+      command: |
+        python -m ensurepip --upgrade
+
+        echo ""
+        echo "Installing cloudsmith-cli using pip ..."
+
+        python -m pip install cloudsmith-cli==1.1.1 --upgrade --user --extra-index-url=https://dl.cloudsmith.io/public/cloudsmith/cli/python/index/
+
+        echo ""
+        echo "Cloudsmith CLI installed OK."
+
+        cloudsmith --version
+  - authenticate_with_oidc:
+      service_account: <<parameters.service_account>>
+  - run:
+      name: Cloudsmith - Upload package
+      command: |
+        echo ""
+        echo "Uploading package <<parameters.package_path>> to Cloudsmith repository $CLOUDSMITH_ORGANISATION/<<parameters.repository>> ..."
+
+        cloudsmith push python --verbose --api-key "$CLOUDSMITH_OIDC_TOKEN" "$CLOUDSMITH_ORGANISATION/<<parameters.repository>>" "<<parameters.package_path>>"
+
+        echo ""
+        echo "Package upload and synchronisation completed OK."

src/commands/upload_python_package.yml

@@ -0,0 +1,21 @@
+description: >
+  Upload a python package to Cloudsmith.
+usage:
+  version: 2.1
+  orbs:
+    ft-cloudsmith: ft-circleci-orbs/[email protected]
+  jobs:
+    build:
+      docker:
+        - image: cimg/python:3.9
+      steps:
+        - checkout
+        - run: python setup.py bdist_wheel --universal
+        - ft-cloudsmith/upload_python_package:
+            repository: "your-repository-id"
+            service_account: "your-service-account"
+            package_path: dist/your-package-0.0.1.tar.gz
+  workflows:
+    main:
+      jobs:
+        - build