{ "info": { "author": "Lewis Franklin", "author_email": "lewis.franklin@gmail.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "sphinx-gherkindoc\n=================\n\n``sphinx-gherkindoc`` brings Gherkin goodness\ninto the Sphinx/reStructuredText (rST) world.\n\nWhy should I use it?\n--------------------\n\n**Share your requirements with your larger team.**\nGherkin makes it easy for anyone to read requirements.\nSphinx makes Gherkin pretty enough to be readable.\n``sphinx-gherkindoc`` handles converting flat-text feature files\ninto easy to read documents you won't cringe to share with your larger team.\n\n**Easily see what steps you have and where you are using them.**\n``sphinx-gherkindoc`` can create a glossary of your steps.\nThis helps makes it easy to:\n\n * find steps to reuse\n * notice similar steps that might be duplicates or unintended variations\n * see patterns that you might exploit to reduce the number of steps you have\n * find out where and which feature files would be affected\n if a step's wording or implementation changes\n\n\nHow does it do that?\n--------------------\n\n``sphinx-gherkindoc`` recursively scans a given directory\nto find all the feature and markup files,\nand converts them into files\nthat can be included in Sphinx-based documentation.\nThis script was inspired by ``sphinx-apidoc``\nwhich does a similar thing for source code.\n\n.. Note::\n\n This tool only creates the rST inputs for a sphinx document run,\n you still need to fit these files\n in to your larger documentation building process yourself.\n\nFor specific details on the command line options,\nplease consult the ``--help`` output.\nMost command line options mirror their counterpart in ``sphinx-apidoc``.\n\nFor the most basic usage, an input (````)\nand output (````) path must be provided.\nThe files put in to the ````\ncan be incorporated into any larger documentation,\ncreated by any means.\n\nAdditionally, a list of ``fnmatch``-compatible patterns can be added\nto the command line,\nto indicate directories to be excluded from processing.\n\nOne notable addition is the step glossary(``-G``, ``--step-glossary``).\nThe step glossary command line option causes ``sphinx-gherkindoc``\nto create the named file in the ```` directory.\nThe step glossary content is formatted into two lists:\n\n * A list of all the steps found, in alphabetical order.\n Each item in this list is a link to its details in the second list.\n * A list of the steps showing the file names and line numbers\n where they are used.\n This list is in order by the most number of uses first.\n\n\nHow are my files converted?\n---------------------------\n\nWhen scanning the ```` directory tree,\n``sphinx-gherkindoc`` will do the following:\n\n * Feature files found\n are processed into rST files in the ```` directory.\n * Directories will be converted to Sphinx Table of Contents (TOC) files that\n link to any feature files in the same directory,\n and to any TOC files from direct subdirectories.\n * Any rST files found in a directory have their contents copied\n to the front of the TOC file for that directory.\n If more than one rST file is found in a directory,\n they are processed in sort order.\n * If no rST files are found in a directory,\n then a header for the TOC is created based\n on the contents of a ``display_name.txt`` file, if present,\n or the name of the directory.\n * Any MarkDown (md) files are referenced\n from the TOC file for the directory they are in.\n * Directories with no feature, rST, or md files are pruned,\n recursively upwards.\n\n\nThe meat'n'potatoes will be your feature files.\nPut rST files next to your feature files\nto present context and additional helpful material.\nIf any rST files are in the same directory,\nthey should also contain any appropriate headers\nand other such formatting.\n``sphinx-gherkindoc`` will only create (minimal) headers when\nthere are no rST files present at all.\n\n\nExamples\n--------\n\nDisclaimer: This `is not` a tutorial on how to use or configure Sphinx.\nIt `is` some common ways you can use ``sphinx-gherkindoc``\nas part of your documentation generation.\nReminder if you skipped all that stuff above:\n``--help`` will show you the default values\nwhen command line options aren't used.\n\nConventions - Sphinx-based document production usually uses two directories:\n\n * ``_docs`` - the working directory where we put all the rST files\n from the various tools as we are building documents.\n This directory shoud not be checked in to version control\n and should only contain files created by a documentation run.\n * ``docs`` - the output directory for a documentation run.\n For example, this is where ``index.html`` is found\n when building HTML docs, etc.\n This directory should not be checked in to version control\n as it contains only derived and processed files.\n\n\n1. Convert feature files to rST;\n process all feature and document files\n in/under ``feature/root/directory-here`` into the ``_docs`` directory\n using all the defaults::\n\n sphinx-gherkindoc feature/root/directory-here _docs\n\n2. Same as above,\n but also create a step glossary file ``my_step_glossary`` in ``_docs``::\n\n sphinx-gherkindoc -G my_step_glossary feature/root/directory-here _docs\n\n3. Experiment!\nOnce you have the 2nd step working\nand integrated in to your document building process,\nyou may find you want to tweak the results some.\nIt's a lot easier to do that `after` you have the basic process working.\nExperiment with the other optional parameters\nto get the effect(s) you want.\n\nSpecial Instructions for Tag Links\n----------------------------------\n\nAny tag can be converted into an anonymous link\nvia a plugin or command-line argument.\nThe converter needs to be a single function\nthat accepts a single string parameter, the tag,\nand returns a URL if the tag should include a link\nor an empty string if not.\n\nIn order to register the plugin for a ``poetry``-based project::\n\n [tools.poetry.plugins.\"parsers\"]\n url = \"my_custom_library.parse:optional_url_from_tag\"\n\nIn order to register the plugin for a ``setup.py``-based project::\n\n setup(\n ...\n entry_points={\n 'parsers': ['url = my_custom_library.parse:optional_url_from_tag']\n }\n )\n\nIn order to use the parser via command line,\nthe ``--url_from-tag`` flag should be used.\nThe provided string should be be formatted ``:``\n", "description_content_type": "text/x-rst", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://jolly-good-toolbelt.github.io/sphinx_gherkindoc/", "keywords": "", "license": "MIT", "maintainer": "Lewis Franklin", "maintainer_email": "lewis.franklin@gmail.com", "name": "sphinx-gherkindoc", "package_url": "https://pypi.org/project/sphinx-gherkindoc/", "platform": "", "project_url": "https://pypi.org/project/sphinx-gherkindoc/", "project_urls": { "Documentation": "https://jolly-good-toolbelt.github.io/sphinx_gherkindoc/", "Homepage": "https://jolly-good-toolbelt.github.io/sphinx_gherkindoc/", "Repository": "https://github.com/jolly-good-toolbelt/sphinx_gherkindoc" }, "release_url": "https://pypi.org/project/sphinx-gherkindoc/3.2.7/", "requires_dist": [ "Sphinx (>=1.3)", "sphinx_rtd_theme (>=0.3.1)", "behave (>=1.2.6)", "recommonmark (>=0.4.0)" ], "requires_python": ">=3.6,<4.0", "summary": "A tool to convert Gherkin into Sphinx documentation", "version": "3.2.7" }, "last_serial": 5805043, "releases": { "3.2.0": [ { "comment_text": "", "digests": { "md5": "99943fde2e1d5d6530f5890f6522e8df", "sha256": "37e66f1bcee6ccdc6e8005b4aeb78fc80ed283f9c9f22be4d7f30eb591f02cc3" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "99943fde2e1d5d6530f5890f6522e8df", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 13694, "upload_time": "2019-07-11T12:09:06", "url": "https://files.pythonhosted.org/packages/2a/1b/04a52cbe7190dfce12bc59bc1afa9d120e2396a0d8e2b29527c14266a42a/sphinx_gherkindoc-3.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "487abd4adb73b647af35f0c0651f238e", "sha256": "0b50cfe38c5485f21520e39938a8174b4fec4fa2aa98e867996827918c88032b" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.0.tar.gz", "has_sig": false, "md5_digest": "487abd4adb73b647af35f0c0651f238e", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 11254, "upload_time": "2019-07-11T12:09:09", "url": "https://files.pythonhosted.org/packages/ba/17/cb9ccc1437a07bc4e6ac815ecff92910ed11903a304ca75d8621ccab53b2/sphinx_gherkindoc-3.2.0.tar.gz" } ], "3.2.1": [ { "comment_text": "", "digests": { "md5": "f06c13b3dc1e2db75c8cf4cc7f8786b1", "sha256": "b281a42f8bd11245d52af2b0fa161fe5f88269619a56827017b96a329da89b39" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.1-py3-none-any.whl", "has_sig": false, "md5_digest": "f06c13b3dc1e2db75c8cf4cc7f8786b1", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 16292, "upload_time": "2019-07-11T13:55:17", "url": "https://files.pythonhosted.org/packages/2d/22/b082bc860057e7f4f2d8f571a1fc5cf557de3a2d1fe733865db90d29c8e1/sphinx_gherkindoc-3.2.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "09ea70252f247d340e471a680efa249c", "sha256": "a39c7046b5477fc5d203ed73054d2e06608f62df6efdd76e7672b9790c252fce" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.1.tar.gz", "has_sig": false, "md5_digest": "09ea70252f247d340e471a680efa249c", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 16599, "upload_time": "2019-07-11T13:55:19", "url": "https://files.pythonhosted.org/packages/4f/1a/088ae84263cdfba18771e5784e5eb4b58098770477a9face08fe3d74bbf5/sphinx_gherkindoc-3.2.1.tar.gz" } ], "3.2.2": [ { "comment_text": "", "digests": { "md5": "263a5155fe1dca7d77e2086e6d0aa263", "sha256": "a55b5a6430c0f286e7c64069ca5e52dd0b2c0f1acbddf794507b6c8eb01c1a0e" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.2-py3-none-any.whl", "has_sig": false, "md5_digest": "263a5155fe1dca7d77e2086e6d0aa263", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 16266, "upload_time": "2019-07-18T20:57:29", "url": "https://files.pythonhosted.org/packages/42/6a/4366e4eeeae77235f850044dd06b8bd9fd9dc64a034d40349a2b9e0a82c2/sphinx_gherkindoc-3.2.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b0cb7f9994d58050c89c0b898becea02", "sha256": "d8c5518a07d3218de686ed8f351f0919a22b7169985f69e4d22b819b5770540a" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.2.tar.gz", "has_sig": false, "md5_digest": "b0cb7f9994d58050c89c0b898becea02", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 16448, "upload_time": "2019-07-18T20:57:31", "url": "https://files.pythonhosted.org/packages/32/8e/bde0f9131b15306cbc4e5f90e689e2430de44b5c222e38c16fd1e3162ad8/sphinx_gherkindoc-3.2.2.tar.gz" } ], "3.2.3": [ { "comment_text": "", "digests": { "md5": "ddb7afa64e84b35c380abc675e8d5277", "sha256": "0ee05c13e3a6c56c6b5e1f534a09bc4d9f060b48fdc9200afadb20674d3cbfd7" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.3-py3-none-any.whl", "has_sig": false, "md5_digest": "ddb7afa64e84b35c380abc675e8d5277", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 16265, "upload_time": "2019-07-20T00:00:19", "url": "https://files.pythonhosted.org/packages/8a/96/ac0a478951fd5a46d7fdf2da65dc36e1e11215ce07d6fffea7dc3a87d0ff/sphinx_gherkindoc-3.2.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3526f93096f915b50965197a268a1c7d", "sha256": "3cb93369c3eee356d5eeb00723f35414caea146fb9b992da6091268d232cca2c" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.3.tar.gz", "has_sig": false, "md5_digest": "3526f93096f915b50965197a268a1c7d", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 16458, "upload_time": "2019-07-20T00:00:34", "url": "https://files.pythonhosted.org/packages/e1/a9/d0e2eef7e70dca9be3c59c3945dc0e02354f9be260a86f864b8b365f30cc/sphinx_gherkindoc-3.2.3.tar.gz" } ], "3.2.4": [ { "comment_text": "", "digests": { "md5": "b4107f3b4eda89635fdeffa5f64f69bf", "sha256": "bcf8e5223c215a9a1e3dfe2af0e0a7822a0dc88fb84ba7f8f4b38e614f0e15e3" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.4-py3-none-any.whl", "has_sig": false, "md5_digest": "b4107f3b4eda89635fdeffa5f64f69bf", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 16537, "upload_time": "2019-07-24T19:21:14", "url": "https://files.pythonhosted.org/packages/da/d8/8718a8d3c919f011cadbc2f43b451883bb1c25b5f74430d3dece3125235b/sphinx_gherkindoc-3.2.4-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "5e6013947841134caca9291276cc3ceb", "sha256": "193d0d07cbd0cccf754c0dbcd6fee2f55712262d9abaf772db589afe0a0c4319" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.4.tar.gz", "has_sig": false, "md5_digest": "5e6013947841134caca9291276cc3ceb", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 16778, "upload_time": "2019-07-24T19:21:15", "url": "https://files.pythonhosted.org/packages/ff/87/1b191b08bcac7b92120136d6b93723b19a6446a6f21553bf9338c52601ab/sphinx_gherkindoc-3.2.4.tar.gz" } ], "3.2.5": [ { "comment_text": "", "digests": { "md5": "f631c81b583eb532df1ddf486f1057d9", "sha256": "b6a2f29cd5ddad49d776d07e59098141f89f201eb54e4e39ebf16f6e704a3d4b" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.5-py3-none-any.whl", "has_sig": false, "md5_digest": "f631c81b583eb532df1ddf486f1057d9", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 16917, "upload_time": "2019-07-25T19:10:36", "url": "https://files.pythonhosted.org/packages/ec/6e/5f4ca017b8c4b70e2e9e305ac196ceca4eabfbeb07cf7d7210ee9ef3cd62/sphinx_gherkindoc-3.2.5-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "88989a552d83c91e53f1671caa70d8e9", "sha256": "4e2804317dfd3acda873e2056f23c34e7d6fa0a9c24edf05cbc70ea6899c1e75" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.5.tar.gz", "has_sig": false, "md5_digest": "88989a552d83c91e53f1671caa70d8e9", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 17093, "upload_time": "2019-07-25T19:10:38", "url": "https://files.pythonhosted.org/packages/40/14/a04527d5aa889d9cdd697df7b8fa804f1c7a8cf8d809db5250879b26d5cc/sphinx_gherkindoc-3.2.5.tar.gz" } ], "3.2.6": [ { "comment_text": "", "digests": { "md5": "9a208b3ac773b4dada80b3b222f6fa59", "sha256": "92110583302c327fbe4eeed967077e19e43c4ab6fdfc354e1b6e66039f44b876" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.6-py3-none-any.whl", "has_sig": false, "md5_digest": "9a208b3ac773b4dada80b3b222f6fa59", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 16923, "upload_time": "2019-08-27T11:08:12", "url": "https://files.pythonhosted.org/packages/53/3e/098b4f61e294b948bd2881ea914cde00f1a92eb24eb7fbdc7a771e959bca/sphinx_gherkindoc-3.2.6-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "211863174b78bd4bcdd4ccf8cc344b22", "sha256": "33fefe62fa026fe4a61b1f532f63639bab737cac560c3757a028c343c2fd501d" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.6.tar.gz", "has_sig": false, "md5_digest": "211863174b78bd4bcdd4ccf8cc344b22", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 17096, "upload_time": "2019-08-27T11:08:14", "url": "https://files.pythonhosted.org/packages/10/a0/9c9c0e9a83111b19c211e460bc71e88b05df12c530455f2a5e033fc16cef/sphinx_gherkindoc-3.2.6.tar.gz" } ], "3.2.7": [ { "comment_text": "", "digests": { "md5": "c864d473eb0e05c8b0af34025ed0f791", "sha256": "c38a22d52b66c5150acba98679df778914b39a12db890e62ff4ab0cc2f600521" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.7-py3-none-any.whl", "has_sig": false, "md5_digest": "c864d473eb0e05c8b0af34025ed0f791", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 16925, "upload_time": "2019-09-09T18:57:59", "url": "https://files.pythonhosted.org/packages/63/fd/697fad5b27daf7ea9d1c7a83bb2653e0be18d6bde7408ad3da81e678d114/sphinx_gherkindoc-3.2.7-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "dd18c9fe95e4b6431ec0510088e4349f", "sha256": "0ff5621b4df002868109c3d48060d9cf110bb00894488325dd9953ee127db770" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.7.tar.gz", "has_sig": false, "md5_digest": "dd18c9fe95e4b6431ec0510088e4349f", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 17108, "upload_time": "2019-09-09T18:58:00", "url": "https://files.pythonhosted.org/packages/e8/44/71ac871cce495ad7a393298e8a47a900c15f8fdb7a470bc7b277bda99f6b/sphinx_gherkindoc-3.2.7.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "c864d473eb0e05c8b0af34025ed0f791", "sha256": "c38a22d52b66c5150acba98679df778914b39a12db890e62ff4ab0cc2f600521" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.7-py3-none-any.whl", "has_sig": false, "md5_digest": "c864d473eb0e05c8b0af34025ed0f791", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 16925, "upload_time": "2019-09-09T18:57:59", "url": "https://files.pythonhosted.org/packages/63/fd/697fad5b27daf7ea9d1c7a83bb2653e0be18d6bde7408ad3da81e678d114/sphinx_gherkindoc-3.2.7-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "dd18c9fe95e4b6431ec0510088e4349f", "sha256": "0ff5621b4df002868109c3d48060d9cf110bb00894488325dd9953ee127db770" }, "downloads": -1, "filename": "sphinx_gherkindoc-3.2.7.tar.gz", "has_sig": false, "md5_digest": "dd18c9fe95e4b6431ec0510088e4349f", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 17108, "upload_time": "2019-09-09T18:58:00", "url": "https://files.pythonhosted.org/packages/e8/44/71ac871cce495ad7a393298e8a47a900c15f8fdb7a470bc7b277bda99f6b/sphinx_gherkindoc-3.2.7.tar.gz" } ] }