appian-locust


Nameappian-locust JSON
Version 2.16.1 PyPI version JSON
download
home_pagehttps://gitlab.com/appian-oss/appian-locust
SummaryTools and functions to make testing Appian with Locust easier
upload_time2024-03-15 18:38:53
maintainer
docs_urlNone
authorAppian Performance & Reliability Engineering Squad
requires_python
licenseApache 2.0
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            .. what_is_appian_locust-inclusion-begin-do-not-remove

#######################################
What is Appian Locust?
#######################################

Appian Locust is a wrapper library around `Locust <https://locust.io>`__ for load testing Appian.
This library is intended to be used as an alternative to tools such as Jmeter and Load Runner.

Appian Locust capabilities

- Logging in and logging out
- Form interactions (filling/submitting)
- Finding and interacting with basic components on a SAIL interface
- Navigating to records/reports/sites

.. what_is_appian_locust-inclusion-end-do-not-remove


For full documentation, visit the `docs page <https://appian-locust.readthedocs.io/en/latest/>`__.

.. disclaimer-inclusion-begin-do-not-remove

**Disclaimer:**
This library is continuously evolving.
Currently the main focus is supporting essential use-cases.
We are happy to accept contributions to further extend functionality, address bug fixes and improve usability.
Please see the `Contributing <contributing.html>`__ section and feel free to reach out.

.. disclaimer-inclusion-end-do-not-remove

.. quick_start-inclusion-begin-do-not-remove

************************
Quick Installation Guide
************************

This is a quick guide to getting up and running with the appian-locust library. You will need Python 3.10 installed on your machine before proceeding.

Setup
------------

1. Install appian-locust using `pip`, for more comprehensive projects we recommend using `pipenv`.

.. code-block:: bash

      pip install appian-locust


If using ``pipenv``, simply start from the following ``Pipfile``:

.. code-block:: toml

    [packages]
    appian-locust = {version = "*"}

    [requires]
    python_version = "3.10"

    [pipenv]
    allow_prereleases = true

2. Download the sample test `example_locustfile.py <https://gitlab.com/appian-oss/appian-locust/-/blob/main/examples/example_locustfile.py>`_ from the Appian Locust repo and run it.

.. code-block:: bash

    locust -f example_locustfile.py

If everything is set up correctly, you should see a link to the `Locust web interface <https://docs.locust.io/en/stable/quickstart.html#locust-s-web-interface>`_, which you can use to start test runs and view results.

* For more information about how to build the workflow for your locust test, see the `How to Write a Locust Test <how_to_write_locust_tests.html>`__ section.
* For more information on running locust tests, see the `How to Run Locust <how_to_run_locust.html>`__ section.

Build from source
----------------------
Clone the repository:

.. code-block:: bash

    git clone -o prod git@gitlab.com:appian-oss/appian-locust.git


Install the library globally:

.. code-block:: bash

    pip install -e appian-locust


If you’re using a virtualenv or a dependency management tool (e.g. ``pipenv``), you can do the same type of install, but you will want to be in the context of the virtualenv (i.e. source the virtualenv), and you’ll need to pass the path to the repository you cloned.

Note: It’s highly recommended that you use a virtual environment when installing python artifacts. You can follow the instructions `here <https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/>`__ to install virtualenv and pip.

If you have issues installing, make sure you have the proper prerequisites installed for Locust and its dependencies.
If you're having trouble on Windows, check `here <https://github.com/locustio/locust/issues/1208#issuecomment-569693439>`__

Troubleshooting
----------------
* **Do not have permissions to clone appian-locust**

  * Ensure you have added you ssh key to your profile. See `here <https://docs.gitlab.com/ee/user/ssh.html#add-an-ssh-key-to-your-gitlab-account>`__ for how to do this.
* **"locust is not available"**

  * Verify that you ran ``pip install -e appian-locust``
* **"Failed to establish a new connection: [Errno 8] nodename nor servname provided, or not known"**

  * check that ``host_address`` is specified correctly in your locust test file.

* **"Login unsuccessful, no multipart cookie found...make sure credentials are correct"**

  * check that `auth` specifies a valid username and password combination for the site you're testing on in your locust test file.

* **"General request and response debugging"**

  * Add ``self.client.record_mode = True`` to your ``HttpUser`` subclass.  Files will be placed in ``/record_responses`` where the runner is executed.

.. quick_start-inclusion-end-do-not-remove

            

Raw data

            {
    "_id": null,
    "home_page": "https://gitlab.com/appian-oss/appian-locust",
    "name": "appian-locust",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "",
    "author": "Appian Performance & Reliability Engineering Squad",
    "author_email": "",
    "download_url": "https://files.pythonhosted.org/packages/ef/43/d03d1727b794bffcf4c92bfaf99ed4207d534b927a34f831e2c7ebfd3c83/appian-locust-2.16.1.tar.gz",
    "platform": null,
    "description": ".. what_is_appian_locust-inclusion-begin-do-not-remove\n\n#######################################\nWhat is Appian Locust?\n#######################################\n\nAppian Locust is a wrapper library around `Locust <https://locust.io>`__ for load testing Appian.\nThis library is intended to be used as an alternative to tools such as Jmeter and Load Runner.\n\nAppian Locust capabilities\n\n- Logging in and logging out\n- Form interactions (filling/submitting)\n- Finding and interacting with basic components on a SAIL interface\n- Navigating to records/reports/sites\n\n.. what_is_appian_locust-inclusion-end-do-not-remove\n\n\nFor full documentation, visit the `docs page <https://appian-locust.readthedocs.io/en/latest/>`__.\n\n.. disclaimer-inclusion-begin-do-not-remove\n\n**Disclaimer:**\nThis library is continuously evolving.\nCurrently the main focus is supporting essential use-cases.\nWe are happy to accept contributions to further extend functionality, address bug fixes and improve usability.\nPlease see the `Contributing <contributing.html>`__ section and feel free to reach out.\n\n.. disclaimer-inclusion-end-do-not-remove\n\n.. quick_start-inclusion-begin-do-not-remove\n\n************************\nQuick Installation Guide\n************************\n\nThis is a quick guide to getting up and running with the appian-locust library. You will need Python 3.10 installed on your machine before proceeding.\n\nSetup\n------------\n\n1. Install appian-locust using `pip`, for more comprehensive projects we recommend using `pipenv`.\n\n.. code-block:: bash\n\n      pip install appian-locust\n\n\nIf using ``pipenv``, simply start from the following ``Pipfile``:\n\n.. code-block:: toml\n\n    [packages]\n    appian-locust = {version = \"*\"}\n\n    [requires]\n    python_version = \"3.10\"\n\n    [pipenv]\n    allow_prereleases = true\n\n2. Download the sample test `example_locustfile.py <https://gitlab.com/appian-oss/appian-locust/-/blob/main/examples/example_locustfile.py>`_ from the Appian Locust repo and run it.\n\n.. code-block:: bash\n\n    locust -f example_locustfile.py\n\nIf everything is set up correctly, you should see a link to the `Locust web interface <https://docs.locust.io/en/stable/quickstart.html#locust-s-web-interface>`_, which you can use to start test runs and view results.\n\n* For more information about how to build the workflow for your locust test, see the `How to Write a Locust Test <how_to_write_locust_tests.html>`__ section.\n* For more information on running locust tests, see the `How to Run Locust <how_to_run_locust.html>`__ section.\n\nBuild from source\n----------------------\nClone the repository:\n\n.. code-block:: bash\n\n    git clone -o prod git@gitlab.com:appian-oss/appian-locust.git\n\n\nInstall the library globally:\n\n.. code-block:: bash\n\n    pip install -e appian-locust\n\n\nIf you\u2019re using a virtualenv or a dependency management tool (e.g. ``pipenv``), you can do the same type of install, but you will want to be in the context of the virtualenv (i.e. source the virtualenv), and you\u2019ll need to pass the path to the repository you cloned.\n\nNote: It\u2019s highly recommended that you use a virtual environment when installing python artifacts. You can follow the instructions `here <https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/>`__ to install virtualenv and pip.\n\nIf you have issues installing, make sure you have the proper prerequisites installed for Locust and its dependencies.\nIf you're having trouble on Windows, check `here <https://github.com/locustio/locust/issues/1208#issuecomment-569693439>`__\n\nTroubleshooting\n----------------\n* **Do not have permissions to clone appian-locust**\n\n  * Ensure you have added you ssh key to your profile. See `here <https://docs.gitlab.com/ee/user/ssh.html#add-an-ssh-key-to-your-gitlab-account>`__ for how to do this.\n* **\"locust is not available\"**\n\n  * Verify that you ran ``pip install -e appian-locust``\n* **\"Failed to establish a new connection: [Errno 8] nodename nor servname provided, or not known\"**\n\n  * check that ``host_address`` is specified correctly in your locust test file.\n\n* **\"Login unsuccessful, no multipart cookie found...make sure credentials are correct\"**\n\n  * check that `auth` specifies a valid username and password combination for the site you're testing on in your locust test file.\n\n* **\"General request and response debugging\"**\n\n  * Add ``self.client.record_mode = True`` to your ``HttpUser`` subclass.  Files will be placed in ``/record_responses`` where the runner is executed.\n\n.. quick_start-inclusion-end-do-not-remove\n",
    "bugtrack_url": null,
    "license": "Apache 2.0",
    "summary": "Tools and functions to make testing Appian with Locust easier",
    "version": "2.16.1",
    "project_urls": {
        "Homepage": "https://gitlab.com/appian-oss/appian-locust"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d0fc2b3f56cb5f24b36065bc112cf18d5c44bdb082a5b7e7811861d04cd7f90c",
                "md5": "56dcabfe48e72a891639c158b92e1835",
                "sha256": "4277cd1d1e712db127ad82c3c698e523d7766c4a9047a412452d5a583740a42c"
            },
            "downloads": -1,
            "filename": "appian_locust-2.16.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "56dcabfe48e72a891639c158b92e1835",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 107146,
            "upload_time": "2024-03-15T18:38:50",
            "upload_time_iso_8601": "2024-03-15T18:38:50.000567Z",
            "url": "https://files.pythonhosted.org/packages/d0/fc/2b3f56cb5f24b36065bc112cf18d5c44bdb082a5b7e7811861d04cd7f90c/appian_locust-2.16.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ef43d03d1727b794bffcf4c92bfaf99ed4207d534b927a34f831e2c7ebfd3c83",
                "md5": "56e74662b2bad6c8e7b381377714096e",
                "sha256": "76378891105efd9e1f06a0cbba954648c37ed59d0bf856964a768437993539d1"
            },
            "downloads": -1,
            "filename": "appian-locust-2.16.1.tar.gz",
            "has_sig": false,
            "md5_digest": "56e74662b2bad6c8e7b381377714096e",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 85381,
            "upload_time": "2024-03-15T18:38:53",
            "upload_time_iso_8601": "2024-03-15T18:38:53.660873Z",
            "url": "https://files.pythonhosted.org/packages/ef/43/d03d1727b794bffcf4c92bfaf99ed4207d534b927a34f831e2c7ebfd3c83/appian-locust-2.16.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-03-15 18:38:53",
    "github": false,
    "gitlab": true,
    "bitbucket": false,
    "codeberg": false,
    "gitlab_user": "appian-oss",
    "gitlab_project": "appian-locust",
    "lcname": "appian-locust"
}
        
Elapsed time: 0.23608s