Fixes #141 - Use a hybrid of Github Actions and TravisCI for testing.

.github/workflows/ci.yml

@@ -0,0 +1,99 @@
+name: CI
+on:
+  pull_request:
+  push:
+    branches:
+      - master
+
+jobs:
+  beefore:
+    name: Pre-test checks
+    runs-on: ubuntu-latest
+    strategy:
+      max-parallel: 4
+      matrix:
+        task: ['pycodestyle']
+    steps:
+    - uses: actions/checkout@v1
+    - name: Set up Python 3.8
+      uses: actions/setup-python@v1
+      with:
+        python-version: 3.8
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install --upgrade setuptools
+        python -m pip install beefore
+    - name: Run Beefore checks
+      env:
+        GITHUB_ACCESS_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      run: |
+        if [ -z "${{ github.event.number }}" ]; then
+          beefore ${{ matrix.task }} .
+        else
+          beefore --username github-actions --repository ${{ github.repository }} --pull-request ${{ github.event.number }} --commit ${{ github.event.pull_request.head.sha }} ${{ matrix.task }} .
+        fi
+
+  smoke:
+    name: Smoke test (3.5)
+    needs: beefore
+    runs-on: macOS-latest
+    steps:
+    - uses: actions/checkout@v1
+    - name: Set up Python 3.5
+      uses: actions/setup-python@v1
+      with:
+        python-version: 3.5
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip setuptools
+        python -m pip install .
+    - name: Build test library
+      run: |
+        make
+    - name: Test
+      run: |
+        DYLD_LIBRARY_PATH=tests/objc python setup.py test
+
+  python-versions:
+    name: Python compatibility test
+    needs: smoke
+    runs-on: macOS-latest
+    strategy:
+      max-parallel: 4
+      matrix:
+        python-version: [3.6, 3.7, 3.8]
+    steps:
+    - uses: actions/checkout@v1
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v1
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip setuptools
+        python -m pip install .
+    - name: Build test library
+      run: |
+        make
+    - name: Test
+      run: |
+        DYLD_LIBRARY_PATH=tests/objc python setup.py test
+
+  package:
+    name: Packaging checks
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v1
+    - name: Set up Python
+      uses: actions/setup-python@v1
+      with:
+        python-version: '3.x'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install --upgrade setuptools wheel twine
+    - name: Build and check release artefacts
+      run: |
+        python setup.py sdist bdist_wheel
+        python -m twine check dist/*

.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Upload Python Package
+
+on:
+  release:
+    types: published
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v1
+    - name: Set up Python
+      uses: actions/setup-python@v1
+      with:
+        python-version: '3.x'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install --upgrade setuptools wheel twine
+    - name: Build and publish
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+      run: |
+        python setup.py sdist bdist_wheel
+        python -m twine check dist/*
+        python -m twine upload dist/*

.github/workflows/release.yml

@@ -0,0 +1,24 @@
+name: Create Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build:
+    name: Create Release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@master
+      - name: Create Release
+        id: create_release
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: ${{ github.ref }}
+          release_name: Release ${{ github.ref }}
+          draft: true
+          prerelease: false

.travis.yml

@@ -4,58 +4,42 @@ branches:
 os: osx
 matrix:
   include:
-    # Note: The ordering of the environments is optimized so that the complete matrix runs as quickly as possible,
-    # while also providing the first results as early as possible.
-    # At the moment, build times for each environment are roughly as follows:
-    # xcode7.3: 16 minutes
-    # xcode8.3: 7 minutes
-    # xcode9.2: 7 minutes
-    # xcode10.1: 6 minutes
-    # https://docs.travis-ci.com/user/reference/osx/#macos-version
-    # This data is based on the following build, which should be similar to most builds on the repo:
-    # https://travis-ci.org/pybee/rubicon-objc/builds/506412489
-    # Currently, Travis allows a maximum of two concurrent Mac builds per owner:
-    # https://blog.travis-ci.com/2017-09-22-macos-update
-    # With the following order, xcode7.3 will take up the first slot, and at the same time the three other
-    # environments use the second slot in sequence. xcode10.1 will finish first and provide some early results - most
-    # test failures happen in all environments and will be quickly reported this way.
-
     # OSX 10.11 El Capitan
     - osx_image: xcode7.3
+    # macOS 10.12 Sierra
+    - osx_image: xcode8.3
+    - osx_image: xcode9.2
     # macOS 10.13 High Sierra
     - osx_image: xcode10.1
     # macOS 10.14 Mojave
     - osx_image: xcode10.2
-    # macOS 10.12 Sierra
-    - osx_image: xcode9.2
-    - osx_image: xcode8.3
 language: generic
 cache:
   directories:
     ~/.pyenv
-env:
-  global:
-    - PY35="3.5.6"
-    - PY36="3.6.8"
-    - PY37="3.7.2"
 install:
-  # The different Travis environments have different pyenv versions, and not all have the Python versions we need,
-  # so we upgrade pyenv to get a consistent setup in all environments.
-  - brew update
-  - brew outdated pyenv || brew upgrade pyenv
-  # The existing pyenv shims from the build cache may no longer be valid, for example if pyenv was upgraded
-  # (in which case the paths used in the shims point to an older, no longer installed pyenv version).
-  # By rehashing the shims we can be sure that they are always valid again.
-  - pyenv rehash
   # pyenv's shims directory is not in the PATH by default.
   - export PATH="$(pyenv root)/shims:${PATH}"
-  # These are the Python versions that we want to test on.
-  - pyenv install --skip-existing ${PY35}
-  - pyenv install --skip-existing ${PY36}
-  - pyenv install --skip-existing ${PY37}
-  - pyenv global ${PY37} ${PY36} ${PY35} system
-  - pip install --upgrade tox
-  - make -f Makefile
+  # Diagnostic: Find out which versions of Python are availalbe.
+  - pyenv install -l
+  # Rubicon supports Python 3.5 and newer.
+  # The most recent version of Python 3.5 provided by the pyenv install on
+  # macOS 10.11 is 3.5.2. There are more recent versions of Python 3.5
+  # available, but using them would mean updating pyenv, which takes 10+
+  # minutes on macOS 10.11.
+  - pyenv install --skip-existing 3.5.2
+  - pyenv global 3.5.2
+  - python -m pip install --upgrade pip setuptools
+  - python -m pip install .
 script:
-  - export DYLD_LIBRARY_PATH=`pwd`/tests/objc
-  - tox -e "py{35,36,37},flake8"
+  - make
+  # This next line *should* be:
+  #   DYLD_LIBRARY_PATH=tests/objc python setup.py test
+  # but the way Travis invokes Python through pyenv triggers macOS's System
+  # Integrity Protection (SIP) (see https://apple.stackexchange.com/a/216815).
+  # As a result, DYLD_LIBRARY_PATH isn't exposed to the Python process.
+  # Calling `$(pyenv which python)` instead of `python` uses a direct version
+  # of the python executable rather than the pyenv shims (which take a
+  # circuitous route performing multiple exec calls through various /usr/local
+  # locations). This avoids triggering SIP, so DYLD_LIBRARY_PATH is exposed.
+  - DYLD_LIBRARY_PATH=tests/objc "$(pyenv which python)" setup.py test

README.rst

@@ -6,22 +6,28 @@ Rubicon-ObjC
 ============
 
 .. image:: https://img.shields.io/pypi/pyversions/rubicon-objc.svg
-    :target: https://pypi.python.org/pypi/rubicon-objc
+   :target: https://pypi.python.org/pypi/rubicon-objc
+   :alt: Python Versions
 
 .. image:: https://img.shields.io/pypi/v/rubicon-objc.svg
-    :target: https://pypi.python.org/pypi/rubicon-objc
+   :target: https://pypi.python.org/pypi/rubicon-objc
+   :alt: Project Version
 
 .. image:: https://img.shields.io/pypi/status/rubicon-objc.svg
-    :target: https://pypi.python.org/pypi/rubicon-objc
+   :target: https://pypi.python.org/pypi/rubicon-objc
+   :alt: Project status
 
 .. image:: https://img.shields.io/pypi/l/rubicon-objc.svg
-    :target: https://github.com/pybee/rubicon-objc/blob/master/LICENSE
+   :target: https://github.com/beeware/rubicon-objc/blob/master/LICENSE
+   :alt: License
 
-.. image:: https://travis-ci.org/pybee/rubicon-objc.svg?branch=master
-    :target: https://travis-ci.org/pybee/rubicon-objc
+.. image:: https://github.com/beeware/rubicon-objc/workflows/CI/badge.svg?branch=master
+   :target: https://github.com/beeware/rubicon-objc/actions
+   :alt: Build Status
 
-.. image:: https://badges.gitter.im/pybee/general.svg
-    :target: https://gitter.im/pybee/general
+.. image:: https://badges.gitter.im/beeware/general.svg
+   :target: https://gitter.im/beeware/general
+   :alt: Gitter chat room
 
 Rubicon-ObjC is a bridge between Objective-C and Python. It enables you to:
 
@@ -66,7 +72,7 @@ Rubicon is part of the `BeeWare suite`_. You can talk to the community through:
 
 * `@pybeeware on Twitter`_
 
-* The `pybee/general`_ channel on Gitter.
+* The `beeware/general`_ channel on Gitter.
 
 Code of Conduct
 ---------------
@@ -84,11 +90,11 @@ Contributing
 If you experience problems with this backend, `log them on GitHub`_. If you
 want to contribute code, please `fork the code`_ and `submit a pull request`_.
 
-.. _BeeWare suite: http://pybee.org
-.. _Read The Docs: http://rubicon-objc.readthedocs.org
+.. _BeeWare suite: https://beeware.org
+.. _Read The Docs: https://rubicon-objc.readthedocs.org
 .. _@pybeeware on Twitter: https://twitter.com/pybeeware
-.. _pybee/general: https://gitter.im/pybee/general
-.. _Code of Conduct: http://pybee.org/community/behavior/
-.. _log them on GitHub: https://github.com/pybee/rubicon-objc/issues
-.. _fork the code: https://github.com/pybee/rubicon-objc
-.. _submit a pull request: https://github.com/pybee/rubicon-objc/pulls
+.. _beeware/general: https://gitter.im/beeware/general
+.. _Code of Conduct: https://beeware.org/community/behavior/
+.. _log them on GitHub: https://github.com/beeware/rubicon-objc/issues
+.. _fork the code: https://github.com/beeware/rubicon-objc
+.. _submit a pull request: https://github.com/beeware/rubicon-objc/pulls

docs/how-to/index.rst

@@ -10,7 +10,7 @@ already knows than tutorials do, and unlike documents in the tutorial they can
 stand alone.
 
 .. toctree::
-   :maxdepth: 1
+   :maxdepth: 2
    :glob:
 
    Get started <get-started>
@@ -19,3 +19,4 @@ stand alone.
    async
    contribute-code
    contribute-docs
+   internal/index

docs/how-to/internal/index.rst

@@ -0,0 +1,12 @@
+======================
+Internal How-to guides
+======================
+
+These guides are for the maintainers of the Rubicon-ObjC project, documenting
+internal project procedures.
+
+.. toctree::
+   :maxdepth: 2
+   :glob:
+
+   release