========
Glossary
========

.. contents::
   :local:
   :depth: 1

.. _cloud-glossary-anaconda:

Anaconda
========

An easy-to-install, free collection of open source packages, including
Python and the conda package manager, with free community support. 
Over 150 packages are installed with Anaconda. After installing 
Anaconda, you can install or update over 250 additional open source 
packages contained in the Anaconda repository using the 
``conda install PACKAGENAME`` command.

NOTE: Replace ``PACKAGENAME`` with the name of the desired package.

.. _cloud-glossary-cloud:

Anaconda Cloud
==============

`Anaconda Cloud <http://www.anaconda.org>`_  is a package management service
by `Anaconda <http://anaconda.com>`_. Cloud makes it easy to find, access,
store and share public and private notebooks, environments, and conda and
PyPI packages. Cloud also makes it easy to stay current with updates
made to the packages and environments you are using.

Cloud hosts hundreds of useful Python packages, notebooks and 
environments for a wide variety of applications. You do not need a 
Cloud account, or to be logged in, to search for public 
packages, download and install them.

For more information, see the 
:ref:`introduction to Anaconda Cloud <cloud-introduction>`.

Anaconda Client CLI
===================

The Anaconda Client command line interface (CLI) allows you to log 
into Cloud directly from your terminal window and manage your
account. It is not necessary for downloading or installing packages 
from Cloud.

Binstar
=======

Binstar was an early project name for Cloud. You may still see
the term Binstar in certain command and directory names.

.. _cloud-glossary-conda:

conda
=====

The conda package manager and environment manager program that installs
and updates packages and their dependencies, and lets you easily switch
between environments on your local computer.

conda build
===========

The command line interface that lets you build packages for your local
operating system.

conda package
=============

A compressed file containing system-level libraries, Python modules, executable 
programs or other components. The file uses the tarball format.


.. _cloud-glossary-label:

label
=====

Part of the URLs on Cloud where conda looks for packages. Labels 
are searched only if you specify a label.

The default label is ``main``, so packages that are uploaded without
specifying a label are automatically labeled ``main``. The version 
labeled ``main`` is also downloaded by default, unless a 
user specifies a different label.

So, if a file is labeled ``main``, then the label name may be omitted 
from the URL. For example, the following repositories are equivalent::

    https://anaconda.org/sean/label/main
    https://anaconda.org/sean

Commands such as ``conda install`` can be used with a channel or used
with a channel and a label::

    conda install --channel sean selenium
    conda install --channel sean/label/dev selenium
    conda install --channel sean/label/stable selenium

Miniconda
=========

A minimal installer for :ref:`cloud-glossary-conda`. Like 
:ref:`cloud-glossary-anaconda`, Miniconda 
is a software package that includes the conda package manager 
and Python and its dependencies. However, Miniconda does not include any other 
packages. Once conda is installed by installing either Anaconda 
or Miniconda, you can install other software packages directly 
from the command line using ``conda install``.

.. _cloud-glossary-namespace:

namespace
=========

Each user and organization has their own location called a 
"namespace" where they may host packages. You can view the public
packages in a user or organization's namespace by navigating to their
user page.

EXAMPLE: The ``travis`` user namespace located at 
``https://anaconda.org/travis`` contains packages that were
uploaded and shared by the user whose account is named ``travis``.

noarch package
==============

A conda package that contains nothing specific to any system 
architecture, so it may be installed on any system. When conda 
searches for packages on any system in a channel, conda always 
checks both the system-specific subdirectory, for example, 
``linux-64`` and the ``noarch`` directory.

on-site repository
==================

Cloud is powered by Anaconda Repository by Anaconda, Inc. 
You can run your own private repository behind firewalls or in 
air-gapped environments. For more information, 
contact `sales@anaconda.com <mailto:sales@anaconda.com>`_.

organization account
====================

An organization account is a type of account on Cloud that
allows multiple individual users to administer packages and control
package access to different user groups. It also includes a large amount
of storage space.

.. _cloud-glossary-package:

package
=======

All files uploaded to Cloud are stored in packages. Each Cloud 
package is visible at its own unique URL based on the name of 
the user who owns the package and the name of the package.

For example, if a user ``travis`` uploads a test package named 
``testpkg``, it is visible at::

    https://anaconda.org/travis/testpkg 

Cloud packages may contain multiple files, and these files may 
be data files such as comma separated value (CSV), tab separated 
value (TSV), or text (TXT), or package files such as conda packages, 
PyPI packages or R packages.

NOTE: All packages are public if uploaded by users of free accounts.
Packages may be designated as private by upgrading to a paid account.

package manager
===============

A package manager is a tool that facilitates the process of installing, 
upgrading, configuring and removing packages, including the packages on Cloud. 
Cloud supports two package managers, :ref:`conda <cloud-conda-packages>` and
:ref:`PyPI <cloud-pypi-packages>`.

For more information, see 
:ref:`using package managers <cloud-packages-managers>`.

repository
==========

A storage location from which software packages may be retrieved and
installed on a computer.

source package
==============

"Source" packages are source code only, not yet built for any specific
platform, and might be compatible with all, some or only one of the
platforms.

.. _cloud-glossary-token:

token
=====

A token--or authentication token--is the mechanism by which anonymous
users can download private packages without using a Cloud account. 
It is an alpha-numeric code that is inserted into a URL that allows 
access by anyone who has the URL. You can use Client to generate 
new tokens to give other users specifically scoped access to
packages and collections.
