"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "docs/source/user-guide/getting-started.rst" between
conda-4.6.2.tar.gz and conda-4.6.3.tar.gz

About: Conda is a cross-platform, language-agnostic, system-level binary package manager and ecosystem.

getting-started.rst  (conda-4.6.2):getting-started.rst  (conda-4.6.3)
========================== ==========================
Getting started with conda Getting started with conda
========================== ==========================
.. _navigator-starting: .. _navigator-starting:
Conda is a powerful package manager and environment manager that Conda is a powerful package manager and environment manager that
you use with command line commands at the Anaconda Prompt for Windows, you use with command line commands at the Anaconda Prompt for Windows,
or in a Terminal window for macOS or Linux. or in a terminal window for macOS or Linux.
This 20-minute guide to getting started with conda lets you try out This 20-minute guide to getting started with conda lets you try out
the major features of conda. You should understand how conda works the major features of conda. You should understand how conda works
when you finish this guide. when you finish this guide.
SEE ALSO: `Getting started with Anaconda Navigator SEE ALSO: `Getting started with Anaconda Navigator
<https://docs.anaconda.com/anaconda/navigator/getting-started>`_, a <https://docs.anaconda.com/anaconda/navigator/getting-started>`_, a
graphical user interface that lets you use conda in a web-like interface graphical user interface that lets you use conda in a web-like interface
without having to enter manual commands. Compare the Getting started without having to enter manual commands. Compare the Getting started
guides for each to see which program you prefer. guides for each to see which program you prefer.
skipping to change at line 49 skipping to change at line 49
TOTAL TIME: 20 MINUTES TOTAL TIME: 20 MINUTES
.. _starting-conda: .. _starting-conda:
Starting conda Starting conda
============== ==============
**Windows** **Windows**
* From the Start menu, search for and open "Anaconda Prompt". * From the Start menu, search for and open "Anaconda Prompt."
.. figure:: /img/anaconda-prompt.png .. figure:: /img/anaconda-prompt.png
:width: 50% :width: 50%
.. ..
| |
On Windows, all commands below are typed into the Anaconda Prompt window. On Windows, all commands below are typed into the Anaconda Prompt window.
**MacOS** **MacOS**
* Open Launchpad, then click the Terminal icon. * Open Launchpad, then click the terminal icon.
On macOS, all commands below are typed into the Terminal window. On macOS, all commands below are typed into the terminal window.
**Linux** **Linux**
* Open a Terminal window. * Open a terminal window.
On Linux, all commands below are typed into the Terminal window. On Linux, all commands below are typed into the terminal window.
.. _managing-conda: .. _managing-conda:
Managing conda Managing conda
=============== ===============
Verify that conda is installed and running on your system by typing: Verify that conda is installed and running on your system by typing:
.. code:: .. code::
conda --version conda --version
Conda displays the number of the version that you have installed. You do not Conda displays the number of the version that you have installed. You do not
need to navigate to the Anaconda directory. need to navigate to the Anaconda directory.
EXAMPLE: ``conda 4.4.9`` EXAMPLE: ``conda 4.4.9``
NOTE: If you get an error message, make sure you closed and re-opened the NOTE: If you get an error message, make sure you closed and re-opened the
Terminal window after installing, or do it now. Then verify that you are logged terminal window after installing, or do it now. Then verify that you are logged
into the same user account that you used to install Anaconda or Miniconda. into the same user account that you used to install Anaconda or Miniconda.
Update conda to the current version. Type the following: Update conda to the current version. Type the following:
.. code:: .. code::
conda update conda conda update conda
Conda compares versions and then displays what is available to install. Conda compares versions and then displays what is available to install.
skipping to change at line 123 skipping to change at line 123
Conda allows you to to create separate environments containing files, packages Conda allows you to to create separate environments containing files, packages
and their dependencies that will not interact with other environments. and their dependencies that will not interact with other environments.
When you begin using conda, you already have a default environment named When you begin using conda, you already have a default environment named
``base``. You don't want to put programs into your base environment, though. ``base``. You don't want to put programs into your base environment, though.
Create separate environments to keep your programs isolated from each other. Create separate environments to keep your programs isolated from each other.
#. Create a new environment and install a package in it. #. Create a new environment and install a package in it.
We will name the environment ``snowflakes`` and install the package We will name the environment ``snowflakes`` and install the package
BioPython. At the Anaconda Prompt or in your Terminal window, type BioPython. At the Anaconda Prompt or in your terminal window, type
the following: the following:
.. code:: .. code::
conda create --name snowflakes biopython conda create --name snowflakes biopython
Conda checks to see what additional packages ("dependencies") Conda checks to see what additional packages ("dependencies")
Biopython will need, and asks if you want to proceed: Biopython will need, and asks if you want to proceed:
.. code:: .. code::
Proceed ([y]/n)? y Proceed ([y]/n)? y
Type "y" and press Enter to proceed. Type "y" and press Enter to proceed.
#. To use, or "activate" the new environment, type the following: #. To use, or "activate" the new environment, type the following:
* Windows: ``activate snowflakes`` * Windows: ``conda activate snowflakes``
* Linux and macOS: ``source activate snowflakes`` * Linux and macOS: ``conda activate snowflakes``
NOTE: ``conda activate`` only works on conda 4.6 and later versions.
For conda versions prior to 4.6, type:
* Windows: ``activate snowflakes``
* Linux and macOS: ``source activate snowflakes``
Now that you are in your ``snowflakes`` environment, any conda Now that you are in your ``snowflakes`` environment, any conda
commands you type will go to that environment until commands you type will go to that environment until
you deactivate it. you deactivate it.
#. To see a list of all your environments, type: #. To see a list of all your environments, type:
.. code:: .. code::
conda info --envs conda info --envs
skipping to change at line 166 skipping to change at line 173
.. code:: .. code::
conda environments: conda environments:
base /home/username/Anaconda3 base /home/username/Anaconda3
snowflakes * /home/username/Anaconda3/envs/snowflakes snowflakes * /home/username/Anaconda3/envs/snowflakes
TIP: The active environment is the one with an asterisk (*). TIP: The active environment is the one with an asterisk (*).
#. Change your current environment back to the default (base): #. Change your current environment back to the default (base):
``conda activate``
* Windows: ``deactivate`` NOTE: For versions prior to conda 4.6, use:
* Linux, macOS: ``source deactivate``
TIP: When the environment is deactivated, its name is no * Windows: ``activate``
longer shown in your prompt, and the asterisk (*) returns to base. * Linux, macOS: ``source activate``
To verify, you can repeat the ``conda info --envs`` command.
TIP: When the environment is deactivated, its name is no
longer shown in your prompt, and the asterisk (*) returns to base.
To verify, you can repeat the ``conda info --envs`` command.
.. _managing-python: .. _managing-python:
Managing Python Managing Python
=============== ===============
When you create a new environment, conda installs the same Python version you When you create a new environment, conda installs the same Python version you
used when you downloaded and installed Anaconda. If you want to use a different used when you downloaded and installed Anaconda. If you want to use a different
version of Python, for example Python 3.5, simply create a new environment and version of Python, for example Python 3.5, simply create a new environment and
specify the version of Python that you want. specify the version of Python that you want.
skipping to change at line 229 skipping to change at line 239
(snakes) $ (snakes) $
#. Verify which version of Python is in your current #. Verify which version of Python is in your current
environment: environment:
.. code:: .. code::
python --version python --version
#. Deactivate the snakes environment and return to base environment: #. Deactivate the snakes environment and return to base environment:
``conda activate``
NOTE: For versions prior to conda 4.6, use:
* Windows: ``deactivate`` * Windows: ``activate``
* Linux, macOS: ``source deactivate`` * Linux, macOS: ``source activate``
.. _managing-pkgs: .. _managing-pkgs:
Managing packages Managing packages
================= =================
In this section, you check which packages you have installed, In this section, you check which packages you have installed,
check which are available and look for a specific package and check which are available and look for a specific package and
install it. install it.
skipping to change at line 272 skipping to change at line 285
#. Check to see if the newly installed program is in this environment: #. Check to see if the newly installed program is in this environment:
.. code:: .. code::
conda list conda list
More information More information
================ ================
* :doc:`Conda cheat sheet <cheatsheet>`. * :doc:`Conda cheat sheet <cheatsheet>`
* Full documentation--- https://conda.io/docs/ . * Full documentation--- https://conda.io/docs/
* Free community support--- https://groups.google.com/a/anaconda.com/forum/#!for * Free community support--- https://groups.google.com/a/anaconda.com/forum/#!for
um/anaconda . um/anaconda
* Paid support options--- https://www.anaconda.com/support/ . * Paid support options--- https://www.anaconda.com/support/
 End of changes. 15 change blocks. 
17 lines changed or deleted 30 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)