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

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


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

Find a package
-----------------

From Anaconda Repository, you can search for packages by
package name. From the top navigation bar of any page, in the search
box enter the package name. You can filter your searches using type of the packages,
access or labels and you can sort results by number of
favorites or number of downloads by clicking the search results
column heading.

Download and install a conda package from Repository
----------------------------------------------------

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

  conda install -c USERNAME PACKAGE

NOTE: Conda expands ``USERNAME`` to a URL such as
``https://<your-anaconda-repo>/username`` based on the settings
in the ``.condarc`` file.

NOTE: Replace ``USERNAME`` with your username and ``PACKAGE`` with the name of the desired package.


Download and install a PyPI package from Repository
---------------------------------------------------

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

  pip install --index-url pypi.anaconda.org/USERNAME/PACKAGE

NOTE: Replace ``USERNAME`` with your username and ``PACKAGE``
with the name of the desired package.

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

Install Client
-----------------

See :ref:`repo-install-client`.

Find my Client login credentials
-----------------------------------

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

To get help:

#. In a browser, navigate to your Repository.

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

#. Click either the I forgot my password link or the I forgot my
   username link.

Log into Client
-------------------

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

  anaconda login

Display a list of Client commands
------------------------------------

In a Terminal window or Anaconda Prompt, run::

  anaconda --help

Find out more about a Client command
---------------------------------------

In a Terminal window or Anaconda Prompt, run::

  anaconda COMMANDNAME -h

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

List all available Client configuration files
------------------------------------------------

In a Terminal window or Anaconda Prompt, run::

  anaconda config --files

List all of your Client configuration variables
--------------------------------------------------

In a Terminal window or Anaconda Prompt, run::

  anaconda config --show

Find out more about Client
-----------------------------

If you have a question that you cannot answer using the help command or
documentation, contact your system administrator who has access to
Anaconda Enterprise Support.

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

Build and upload a package
--------------------------------

For a quick example, see :ref:`repo-getting-started-build-upload`.

Test a built package
-----------------------

In a Terminal window or Anaconda Prompt, specify the ``--use-local`` option::

  conda create --use-local -n test PACKAGE

NOTE: Replace ``PACKAGE`` with the name of your package.

Upload a package to Repository
---------------------------------

In a Terminal window or Anaconda Prompt, run::

  anaconda upload PACKAGE

NOTE: Replace ``PACKAGE`` with the name of your package.

Find help for uploading packages
-----------------------------------

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

* Package channel.

* Label.

* Availability to other users.

* Metadata.

In a Terminal window or Anaconda Prompt, run::

  anaconda upload -h
