{ "info": { "author": "Roni Eliezer", "author_email": "roniezr@gmail.com", "bugtrack_url": null, "classifiers": [], "description": "===========================\n**Ochrus Project Overview**\n===========================\n\nThe **Ochrus Project** is intended to be a complete solution to easily develop functional (black/gray box) automation tests.\n\nThe **Ochrus Project** include the following components:\n\n1. **ochrus**: Classes and modules to support functional automation tests\n2. **ochrus-srv**: Detailed result DB server.\n3. **pytest-ochrus**: Pytest plugin, see note below...\n\n **NOTE**:\n Ochrus Project choose **Pytest** (https://www.pytest.org) open source project as its testing framework.\n\n Pytest is an easy to use and powerful testing framework that support the most common Python unit framework\n such and \"unittest\" and \"Nose\".\n\n**Ochrus library:**\n-------------------\nProvide classes and modules to support functional automation tests\nShould be used with the power of **Pytest** framework.\ndocumentation should be available soon at the wiki and later at: http://www.ochrus.com\n\n *To install:*\n\n .. code-block:: bash\n\n $ pip install ochrus\n\n\n**pytest-ochrus:**\n------------------\nA Pytest plugin, it needs to be installed with Pytest \nIt uses to send test results to the 'ochrus-srv' (see below) via REST protocol\n(code: https://github.com/ochrus/pytest-ochrus)\n\n *To install:*\n\n .. code-block:: bash\n\n $ pip install pytest\n $ pip install pytest-ochrus\n\n\n**Ochrus Server:**\n------------------\nOchrus Server is a full-stack free application that include a data-base to hold the test results, and HTML interface to display the results.\nUser can see colorized online results, results history and comparison.\nThe server support RESTful API and currently only pytest-ochrus is available to communicate with it, but actually it can serve any xUnit framework written in any language.\n\n *To install*:\n\n *The server is available as Docker image and can be run directly from docker hub as followed:*\n\n .. code-block:: bash\n\n $ docker run -d -p 80:8000 -v db:/ochrus/db --name ochrus_srv ochrus/ochrus_srv:demo\n\n\n\n**Requirements**\n----------------\n- Python 2.7\n- pytest\n- Docker (on host server only)\n\n**Installation**\n----------------\n**Client:**\n~~~~~~~~~~~\n .. code-block:: bash\n\n $ pip install pytest\n $ pip install pytest_ochrus\n $ pip install ochrus\n\n\n**Server:**\n~~~~~~~~~~~\nFollowed the instructions at: https://docs.docker.com/engine/installation/ to install Docker on your host server.\n\ne.g.: for CentOS:\n\n .. code-block:: bash\n\n $ yum install -y yum-utils device-mapper-persistent-data lvm2\n $ yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo\n $ yum install docker-ce\n $ systemctl start docker #run the service\n $ systemctl enable docker #make it start on boot\n\n\nTo install 'ochrus_srv' run the following command:\n\n .. code-block:: bash\n\n $ docker run -d -p 80:8000 -v db:/ochrus/db --name ochrus_srv ochrus/ochrus_srv:demo\n\n\n The above Docker command will do the following:\n\n 1. Download the **'ochrus_srv:demo'** image from the Docker public Hub.\n 2. Run it at the background and give it the name **'ochrus_srv'**.\n 3. Expose its 8000 port to port 80 on the running host.\n 4. Create a persistent data-base at default Docker volume location at: \n **'/var/lib/docker/volumes/db/'**\n\n**NOTE**:\n\n1. The above docker command should be run only once, after that run:\n\n .. code-block:: bash\n\n docker stop ochrus_srv to stop the server\n docker start ochrus_srv to run the server\n\n\n2. Make sure port **80** is free at the host server.\n\n**Execute:**\n------------\n\n**At the Client**:\n\n1. To run your tests: just run pytest according to pytest execution instructions.\n2. You can give a name to the running session as followed:\n\n .. code-block:: bash\n\n $ pytest --session_name=\"mySessionName\"\n\n The name will be displayed at the HTML report at the **ochres server**\n\n **NOTE**:\n You can give any name that will describe the running session\n\n Recommended: ***product_name-version_number.build_number***\n\n\n**Using Eclipse IDE**\n---------------------\nNote: Following instructions are taken with: *Eclipse Oxygen.1a Release (4.7.1a)*\n\n1. Install Eclipse IDE\n2. Run Eclipse and install '***pydev***' plugin. \n\n Go to: ***Help | Eclipse Markeplace...***, write '***pydev***' at the Search box and click the '**Go**' button. \n\n Wait until it find the Pydev plugin and click the '**Install**' button\n3. Create a new Pydev project (***File | New | Other...*** | PyDev | PyDev Project)\n4. Go to: ***Windows | Preferences | PyDev | PyUnit | Test Runner*** | choose: **Py.test runner**, click Apply\n5. Create a pytest script and run it by right-click and choose Run As | Python unit-test\n6. To run all tests in a special directory, just right-click the directory and choose Run As | Python unit-test\n\n\n\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "https://github.com/ochrus/ochrus-0.0.61.tar.gz", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/ochrus/ochrus", "keywords": "functional,testing,automation,infrastructure", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "ochrus", "package_url": "https://pypi.org/project/ochrus/", "platform": "", "project_url": "https://pypi.org/project/ochrus/", "project_urls": { "Download": "https://github.com/ochrus/ochrus-0.0.61.tar.gz", "Homepage": "https://github.com/ochrus/ochrus" }, "release_url": "https://pypi.org/project/ochrus/0.0.61/", "requires_dist": [ "paramiko", "requests" ], "requires_python": "", "summary": "Ochrus functional test automation infrastructure", "version": "0.0.61" }, "last_serial": 4919456, "releases": { "0.0.5": [ { "comment_text": "", "digests": { "md5": "24026885b93e981cc664fcf37a19a813", "sha256": "85a4c55a0ee999ce92e3538a1a723757c230bc592545db8228f406049ab061af" }, "downloads": -1, "filename": "ochrus-0.0.5.tar.gz", "has_sig": false, "md5_digest": "24026885b93e981cc664fcf37a19a813", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13340, "upload_time": "2018-02-21T18:49:11", "url": "https://files.pythonhosted.org/packages/cf/a2/93e985abf3415fdd3ada7b7613649cfe2d0b6bad010de4e2132ab18eb54d/ochrus-0.0.5.tar.gz" } ], "0.0.6": [ { "comment_text": "", "digests": { "md5": "6c016ba6684174a91b1a5636c6a83df6", "sha256": "dcdc8e531f910154d984c77089775372d984fb5053c5fca2e3698393cce56394" }, "downloads": -1, "filename": "ochrus-0.0.6.tar.gz", "has_sig": false, "md5_digest": "6c016ba6684174a91b1a5636c6a83df6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13425, "upload_time": "2018-02-21T19:21:36", "url": "https://files.pythonhosted.org/packages/38/39/687160abb9373ac75c268e771ff76d56a12ca3437c4f773b52755cebd1f9/ochrus-0.0.6.tar.gz" } ], "0.0.61": [ { "comment_text": "", "digests": { "md5": "5ac4fee4b451da5f521e48313db1c2a0", "sha256": "e8b168cf8cce2c5da7e27fc9ea4a23a89e5ec1ab00a0e8b797c473bb94a92a44" }, "downloads": -1, "filename": "ochrus-0.0.61-py2-none-any.whl", "has_sig": false, "md5_digest": "5ac4fee4b451da5f521e48313db1c2a0", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 17611, "upload_time": "2019-03-09T19:42:49", "url": "https://files.pythonhosted.org/packages/e1/70/eb6609e3c9e46fb5fc0605d51bf0586b9930e049ee563f2937132908b0db/ochrus-0.0.61-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b4281693e00184abe5d2d85c968fd549", "sha256": "2fdaa963664430f84571c37294fcbb6be52398b9f25b064a9101f04371182e21" }, "downloads": -1, "filename": "ochrus-0.0.61.tar.gz", "has_sig": false, "md5_digest": "b4281693e00184abe5d2d85c968fd549", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13235, "upload_time": "2019-03-09T19:42:50", "url": "https://files.pythonhosted.org/packages/7d/9d/7dff073dd6589ad489400b27d56980163565b37e34cae8be37af64ee34e5/ochrus-0.0.61.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "5ac4fee4b451da5f521e48313db1c2a0", "sha256": "e8b168cf8cce2c5da7e27fc9ea4a23a89e5ec1ab00a0e8b797c473bb94a92a44" }, "downloads": -1, "filename": "ochrus-0.0.61-py2-none-any.whl", "has_sig": false, "md5_digest": "5ac4fee4b451da5f521e48313db1c2a0", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 17611, "upload_time": "2019-03-09T19:42:49", "url": "https://files.pythonhosted.org/packages/e1/70/eb6609e3c9e46fb5fc0605d51bf0586b9930e049ee563f2937132908b0db/ochrus-0.0.61-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b4281693e00184abe5d2d85c968fd549", "sha256": "2fdaa963664430f84571c37294fcbb6be52398b9f25b064a9101f04371182e21" }, "downloads": -1, "filename": "ochrus-0.0.61.tar.gz", "has_sig": false, "md5_digest": "b4281693e00184abe5d2d85c968fd549", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13235, "upload_time": "2019-03-09T19:42:50", "url": "https://files.pythonhosted.org/packages/7d/9d/7dff073dd6589ad489400b27d56980163565b37e34cae8be37af64ee34e5/ochrus-0.0.61.tar.gz" } ] }