=========
How to...
=========

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

Use packages
============

Finding a package
-----------------

In your browser, you can search Anaconda Cloud for packages by package
name. From the top navigation bar of any page, enter the package name in
the search box. You can filter your searches to specify only conda or
PyPI packages, and you can sort results by number of favorites or number
of downloads by clicking the search results column heading.

Downloading and installing a package from Cloud
-----------------------------------------------

To install a conda package, in your Terminal window or Anaconda Prompt run::

    conda install -c username packagename

Conda expands ``username`` to a URL such as
https://anaconda.org/username or https://conda.anaconda.org/username
based on the settings in the ``.condarc`` file.

NOTE: Replace ``username`` with your username, and ``packagename``
with the actual name of the package.

Downloading and installing a PyPI package from Cloud
----------------------------------------------------

To install a PyPI package, in your Terminal window or Anaconda Prompt run::

    pip install --index-url pypi.anaconda.org/USERNAME/simple packagename

NOTE: Replace ``USERNAME`` with your username, and
``packagename`` with the actual name of the package.

Use the Anaconda Client CLI
===========================


Installing Client
-----------------

For installation and setup instructions, see
:ref:`Install Anaconda Client <cloud-install-client>`.


Finding my Client login credentials
-----------------------------------

Your credentials for Client are those you used to create an
account on Cloud.

To get help:

#. Go to https://anaconda.org.

#. Select the **Sign In** tab.

#. Click either ``I forgot my password`` or ``I forgot my username``.

Logging into Client
-------------------

After you have downloaded and configured Client, open a
Terminal window or an Anaconda Prompt and run::

    anaconda login

Displaying a list of Client commands
------------------------------------

From a Terminal window or an Anaconda Prompt, run::

    anaconda --help

Finding out more about a Client command
---------------------------------------

From a Terminal window or an Anaconda Prompt, run::

    anaconda COMMANDNAME -h

NOTE: Replace ``COMMANDNAME`` with the name of the command
about which you want more information.

Listing all available Client configuration files
------------------------------------------------

From a Terminal window or an Anaconda Prompt, run::

    anaconda config --files

Listing all of your Client configuration variables
--------------------------------------------------

From a Terminal window or an Anaconda Prompt, run::

    anaconda config --show

Finding out more about Client
-----------------------------

You can learn more about Client using the help command,
documentation or community support email group.

Build packages
==============

Building and uploading a package
--------------------------------

For a quick example, see
:ref:`cloud-getting-started-build-upload` in :doc:`getting-started`.

Testing a built package
-----------------------

In your Terminal window or Anaconda Prompt run::

    conda create --use-local -n test PACKAGENAME

Specify the ``--use-local`` option.

NOTE: Replace PACKAGENAME with the actual name of the package.

Uploading a package to Cloud
----------------------------

In a Terminal window or Anaconda Prompt, run::

    anaconda upload PACKAGENAME

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

Finding help for uploading packages
-----------------------------------

You can obtain a complete list of upload options, including:

* Package channel.

* Label.

* Availability to other users.

* Metadata.

To list the options, in a Terminal window or Anaconda Prompt run::

    anaconda upload -h
