semvec/pypi-packages huggingface dataset:
stormpath-migrate 1.1.5
Migrate a Stormpath tenant from one place to another.
License: UNLICENSE
Keywords: stormpath authentication migration development

stormpath-migrate
=================

.. image:: https://img.shields.io/pypi/v/stormpath-migrate.svg
    :alt: stormpath-migrate Release
    :target: https://pypi.python.org/pypi/stormpath-migrate

.. image:: https://img.shields.io/pypi/dm/stormpath-migrate.svg
    :alt: stormpath-migrate Downloads
    :target: https://pypi.python.org/pypi/stormpath-migrate

.. image:: https://api.codacy.com/project/badge/grade/e9a2986f7dcc49bb961d60601ba0b599
    :alt: stormpath-migrate Code Quality
    :target: https://www.codacy.com/app/r/stormpath-migrate

.. image:: https://img.shields.io/travis/stormpath/stormpath-migrate.svg
    :alt: stormpath-migrate Build
    :target: https://travis-ci.org/stormpath/stormpath-migrate

*Migrate a Stormpath tenant from one place to another.*


Installation
------------

To install this library, use pip:

.. code-block:: console

    $ pip install stormpath-migrate


Usage
-----

To use this tool, you need a few things:

- A newline delimited JSON file that contains JSON objects that look like: ``{"href": "account_href", "password": "password_hash"}``.
- A pair of Stormpath API keys for the SOURCE tenant you want to migrate.
- The Stormpath Base URL for the SOURCE tenant you want to migrate.
- A pair of Stormpath API keys for the DESTINATION tenant you want to migrate.
- The Stormpath Base URL for the DESTINATION tenant you want to migrate.

Once you have these things, we can begin.

Let's say that I have two Stormpath Tenants, with the following API keys and
Base URLs, respectively:

- SOURCE: xxx:yyy https://api.stormpath.com/v1
- DESTINATION: blah:blah https://test.stormpath.io/v1

Let's also say I have the properly exported my existing user passwords by
talking with the Stormpath engineering team, and have a file named
``passwords.txt`` which contains my JSON delimited data.

I could then run the following command to properly migrate all of my data from
the SOURCE tenant to the DESTINATION tenant:

.. code-block:: console

    $ stormpath-migrate 'xxx:yyy' 'blah:blah' passwords.txt \
        --src-url https://api.stormpath.com/v1 \
        --dst-url https://test.stormpath.io/v1

This will initialize the migration process, and will output to the terminal with
progress reports. Depending on how many resource you have in your Stormpath
tenant, this may take a very long time.

This program should be run on a computer with a strong and consistent internet
connection for the best results.

This program can be run multiple times in a row to perform incremental backups.
Objects will NOT be deleted from the DESTINATION tenant. They will only be
copied over from the SOURCE tenant.