<commit_before>========
Tutorial
========

This tutorial is for macOS. Linux and Windows are not yet officially supported but should work for the most part.

Part 1: Installing CumulusCI
============================

Install Requirements
--------------------

Due to an issue regarding TLS support in the Python included in macOS it is necessary to install Python with OpenSSL support using Homebrew. For more info on the TLS issue see here: http://pyfound.blogspot.com/2017/01/time-to-upgrade-your-python-tls-v12.html

#. Install Homebrew: https://docs.brew.sh/Installation.html
#. Use Homebrew to install OpenSSL::

    $ brew install openssl

#. Use Homebrew to install Python 2 (make note of the installed path that is printed after successful installation)::

    $ brew install python

Create Virtual Environment
--------------------------

#. Install virtualenv::

    $ pip2 install virtualenv

#. Create a virtual environment using the Python executable path that was printed after installing Python 2 with Homebrew::

    $ # Creates a new directory at ~/venvs/cumulusci/ - You can change this path to something else if you like but we recommend the final part of the path to be "cumulusci" so that it shows in the shell session when the virtual environment is activated.
    $ virtualenv --python=/usr/local/opt/python/libexec/bin/python ~/venvs/cumulusci/

#. Activate the newly created virtual environment::
<commit_msg>add link to virtualenv docs<commit_after>========
Tutorial
========

This tutorial is for macOS. Linux and Windows are not yet officially supported but should work for the most part.

Part 1: Installing CumulusCI
============================

Install Requirements
--------------------

Due to an issue regarding TLS support in the Python included in macOS it is necessary to install Python with OpenSSL support using Homebrew. For more info on the TLS issue see here: http://pyfound.blogspot.com/2017/01/time-to-upgrade-your-python-tls-v12.html

#. Install Homebrew: https://docs.brew.sh/Installation.html
#. Use Homebrew to install OpenSSL::

    $ brew install openssl

#. Use Homebrew to install Python 2 (make note of the installed path that is printed after successful installation)::

    $ brew install python

Create Virtual Environment
--------------------------

#. Install `virtualenv <https://virtualenv.pypa.io/en/stable/>`_::

    $ pip2 install virtualenv

#. Create a virtual environment using the Python executable path that was printed after installing Python 2 with Homebrew::

    $ # Creates a new directory at ~/venvs/cumulusci/ - You can change this path to something else if you like but we recommend the final part of the path to be "cumulusci" so that it shows in the shell session when the virtual environment is activated.
    $ virtualenv --python=/usr/local/opt/python/libexec/bin/python ~/venvs/cumulusci/

#. Activate the newly created virtual environment::

{'fraction_non_alphanumeric': 0.12247690728703386, 'fraction_numerical': 0.008210742387957578, 'mean_word_length': 3.547433903576983, 'pattern_counts': {'":': 0, '<': 4, '<?xml version=': 0, '>': 4, 'https://': 3, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6227577', 'n_tokens_mistral': 778, 'n_tokens_neox': 712, 'n_words': 349}