{
"info": {
"author": "Daniil Minukhin",
"author_email": "ddddsa@gmail.com",
"bugtrack_url": null,
"classifiers": [
"Development Status :: 5 - Production/Stable",
"Environment :: Console",
"Intended Audience :: Developers",
"License :: OSI Approved :: MIT License",
"Operating System :: OS Independent",
"Programming Language :: Python",
"Topic :: Documentation",
"Topic :: Utilities"
],
"description": "\n\n# Swagger API Docs Generator for Foliant\n\nThis preprocessor generates Markdown documentation from [Swagger](https://swagger.io/) spec files . It uses [Jinja2](http://jinja.pocoo.org/) templating engine or [widdershins](https://github.com/mermade/widdershins) for generating Markdown from swagger spec files.\n\n## Installation\n\n```bash\n$ pip install foliantcontrib.swaggerdoc\n```\n\n## Config\n\nTo enable the preprocessor, add `pgsqldoc` to `preprocessors` section in the project config:\n\n```yaml\npreprocessors:\n - swaggerdoc\n```\n\nThe preprocessor has a number of options:\n\n```yaml\npreprocessors:\n - swaggerdoc:\n json_url: http://localhost/swagger.json\n json_path: swagger.json\n additional_json_path: tags.json\n mode: 'jinja'\n template: swagger.j2\n environment: env.yaml\n\n```\n\n`json_url`\n: URL to Swagger spec file. If it is a list \u2014 preprocessor takes the first url which works.\n\n> even though the parameters are called *json*\\_url and *json*\\_path, yaml format is supported too. Parameters may be softly renamed in future.\n\n`json_path`\n: Local path to Swagger spec file (relative to project dir).\n\n> If both url and path are specified \u2014 preprocessor first tries to fetch JSON from url, and then (if that fails) looks for the file on local path.\n\n`additional_json_path`\n: Only for `jinja` mode. Local path to swagger spec file with additional info (relative to project dir). It will be merged into original spec file, *not overriding existing fields*.\n\n`mode`\n: Determines how the Swagger spec file would be converted to markdown. Should be one of: `jinja`, `widdershins`. Default: `widdershins`\n\n> `jinja` mode is deprecated. It may be removed in future\n\n`template`\n: Only for `jinja` mode. Path to jinja-template for rendering the generated documentation. Path is relative to the project directory. If no template is specified preprocessor will use default template (and put it into project dir if it was missing). Default: `swagger.j2`\n\n`environment`\n: Only for `widdershins` mode. Parameters for widdershins converter. You can either pass a string containing relative path to YAML or JSON file with all parameters (like in example above) or specify all parameters in YAML format under this key. [More info](https://github.com/mermade/widdershins) on widdershins parameters.\n\n## Usage\n\nAdd a `` tag at the position in the document where the generated documentation should be inserted:\n\n```markdown\n# Introduction\n\nThis document contains the automatically generated documentation of our API.\n\n\n```\n\nEach time the preprocessor encounters the tag `` it inserts the whole generated documentation text instead of it. The path or url to Swagger spec file are taken from foliant.yml.\n\nYou can also specify some parameters (or all of them) in the tag options:\n\n```markdown\n# Introduction\n\nIntroduction text for API documentation.\n\n\n\n\n\n\n```\n\nTag parameters have the highest priority.\n\nThis way you can have documentation from several different Swagger spec files in one foliant project (even in one md-file if you like it so).\n\n## Customizing output\n\n### Jinja\n\n> `jinja` mode is deprecated. It may be removed in future\n\nIn `jinja` mode the output markdown is generated by the [Jinja2](http://jinja.pocoo.org/) template. In this template all fields from Swagger spec file are available under the dictionary named `swagger_data`.\n\nTo customize the output create a template which suits your needs. Then supply the path to it in the `template` parameter.\n\nIf you wish to use the default template as a starting point, build the foliant project with `swaggerdoc` preprocessor turned on. After the first build the default template will appear in your foliant project dir under name `swagger.j2`.\n\n### Widdershins\n\nIn `widdershins` mode the output markdown is generated by [widdershins](https://github.com/mermade/widdershins) Node.js application. It supports customizing the output with [doT.js](https://github.com/olado/doT) templates.\n\n1. Clone the original widdershins [repository](https://github.com/mermade/widdershins) and modify the templates located in one of the subfolders in the **templates** folder.\n2. Save the modified templates somewhere near your foliant project.\n3. Specify the path to modified templates in the `user_templates` field of the `environment` configuration. For example, like this:\n\n```yaml\npreprocessors:\n - swaggerdoc:\n json_path: swagger.yml\n environment:\n user_templates: !path ./widdershins_templates/\n```\n\n\n",
"description_content_type": "text/markdown",
"docs_url": null,
"download_url": "",
"downloads": {
"last_day": -1,
"last_month": -1,
"last_week": -1
},
"home_page": "",
"keywords": "",
"license": "MIT",
"maintainer": "",
"maintainer_email": "",
"name": "foliantcontrib.swaggerdoc",
"package_url": "https://pypi.org/project/foliantcontrib.swaggerdoc/",
"platform": "any",
"project_url": "https://pypi.org/project/foliantcontrib.swaggerdoc/",
"project_urls": null,
"release_url": "https://pypi.org/project/foliantcontrib.swaggerdoc/1.2.1/",
"requires_dist": [
"foliant (>=1.0.5)",
"jinja2",
"ruamel.yaml",
"foliantcontrib.utils.combined-options (>=1.0.7)",
"foliantcontrib.utils.preprocessor-ext"
],
"requires_python": "",
"summary": "Documentation generator for Swagger API",
"version": "1.2.1"
},
"last_serial": 5916532,
"releases": {
"1.0.0": [
{
"comment_text": "",
"digests": {
"md5": "8ec10cbcd257a23cf15315367f68abc2",
"sha256": "6a175ee545990503a3085e4dd84a0c226e51949003d835d6d9a2cb37e76ea6f8"
},
"downloads": -1,
"filename": "foliantcontrib.swaggerdoc-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8ec10cbcd257a23cf15315367f68abc2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 6697,
"upload_time": "2018-09-28T14:39:59",
"url": "https://files.pythonhosted.org/packages/b0/ba/4923916aad2d6dc6e8a8018dfcb891992109270368c033e658bb4b2967d4/foliantcontrib.swaggerdoc-1.0.0-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "121c7d6a88d4aa5eececd5579a2ea457",
"sha256": "1d55797b341d7462081d4bf8a73fd30cc271b00d24c903e3595d21d2ebfb0512"
},
"downloads": -1,
"filename": "foliantcontrib.swaggerdoc-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "121c7d6a88d4aa5eececd5579a2ea457",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6042,
"upload_time": "2018-09-28T14:40:00",
"url": "https://files.pythonhosted.org/packages/3e/64/b853d12ae7077ae54b172b2246a0d64edfb68a202a70b6687b701a133c22/foliantcontrib.swaggerdoc-1.0.0.tar.gz"
}
],
"1.1.0": [
{
"comment_text": "",
"digests": {
"md5": "68e4f6771b5aaaf0a2aeba9708576e6d",
"sha256": "0de5b34893960c55e68cae299a6f4e03371d4b0e7aeb3f22139ce477937c5abb"
},
"downloads": -1,
"filename": "foliantcontrib.swaggerdoc-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "68e4f6771b5aaaf0a2aeba9708576e6d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 7253,
"upload_time": "2018-10-19T11:27:56",
"url": "https://files.pythonhosted.org/packages/ee/9d/70193a09546b57992abc95d2213f1d4c1a287063b7c8f943fab47290deec/foliantcontrib.swaggerdoc-1.1.0-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "c7dbf06f85f538b7824444e19cf97091",
"sha256": "3a9014ae6864bee826c2451ab2411388a9e88664f37eb4c9304c6df767671e32"
},
"downloads": -1,
"filename": "foliantcontrib.swaggerdoc-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "c7dbf06f85f538b7824444e19cf97091",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6700,
"upload_time": "2018-10-19T11:27:58",
"url": "https://files.pythonhosted.org/packages/20/08/e66ed9a837d7606ea38406cfdef424707eb03f7d0f063d0fbb69546abefa/foliantcontrib.swaggerdoc-1.1.0.tar.gz"
}
],
"1.1.1": [
{
"comment_text": "",
"digests": {
"md5": "603d35c79cff08890c49b2ed6180fb6c",
"sha256": "f8cdc15252bd73dd7b5a245476e57762d1817815ba802af0ee8b0f75eab6a82b"
},
"downloads": -1,
"filename": "foliantcontrib.swaggerdoc-1.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "603d35c79cff08890c49b2ed6180fb6c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 7466,
"upload_time": "2018-10-26T12:37:17",
"url": "https://files.pythonhosted.org/packages/c7/36/61b75862ba4a8dd74ce5a7e1bf9e5dac0fb4d802d17d1c93a79d48b731ef/foliantcontrib.swaggerdoc-1.1.1-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "dfde455e32c8e643e33b1105bc73a886",
"sha256": "eceb0112ca19fdbf5b6f9ff245f2ca36c9d7fea327ec86777b7b8a8e652b5cc5"
},
"downloads": -1,
"filename": "foliantcontrib.swaggerdoc-1.1.1.tar.gz",
"has_sig": false,
"md5_digest": "dfde455e32c8e643e33b1105bc73a886",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6918,
"upload_time": "2018-10-26T12:37:19",
"url": "https://files.pythonhosted.org/packages/ed/23/95e0905a5e6a2831df11a20549e7cdded06b157b8fdab2f0e35c86697b73/foliantcontrib.swaggerdoc-1.1.1.tar.gz"
}
],
"1.1.2": [
{
"comment_text": "",
"digests": {
"md5": "6838c48387e58efdb532e358a286a4b4",
"sha256": "f34a840fa9c13d57c739dca887f6bbcbb57e4aa227a59f7a1b2133668d662fdf"
},
"downloads": -1,
"filename": "foliantcontrib.swaggerdoc-1.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6838c48387e58efdb532e358a286a4b4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 7434,
"upload_time": "2018-10-31T10:02:30",
"url": "https://files.pythonhosted.org/packages/64/8a/3fc5ed23e87fb11d45cb28b29fcc8d7ed05e78813031006a2b85f2e1d512/foliantcontrib.swaggerdoc-1.1.2-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "ce3571aba22edca51a2806ddca8dc107",
"sha256": "bfe61a667e33447dade34ad9d629ae24826c09694f2f4396ca0577d26cb164b2"
},
"downloads": -1,
"filename": "foliantcontrib.swaggerdoc-1.1.2.tar.gz",
"has_sig": false,
"md5_digest": "ce3571aba22edca51a2806ddca8dc107",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6890,
"upload_time": "2018-10-31T10:02:31",
"url": "https://files.pythonhosted.org/packages/0e/0a/aec2317b81318f9bab305307e61c85c5e9a696edec63280271e41b0c0bf7/foliantcontrib.swaggerdoc-1.1.2.tar.gz"
}
],
"1.1.3": [
{
"comment_text": "",
"digests": {
"md5": "c654f3fc297e30665614cb78b8c73256",
"sha256": "962493ac52a186439f25b1cc9dfd2a452196b2b5a1792ebb3eb6ee7b60d94a2b"
},
"downloads": -1,
"filename": "foliantcontrib.swaggerdoc-1.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c654f3fc297e30665614cb78b8c73256",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9017,
"upload_time": "2019-04-15T10:41:26",
"url": "https://files.pythonhosted.org/packages/33/2c/85f14b3e997f049ad1432a0e61c3f6a0e5cc993d46dfdb8ed85cbb48e730/foliantcontrib.swaggerdoc-1.1.3-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "ef19426dd5719ee4d77e6691fdd25662",
"sha256": "16b1bd179da791163d366df9626c00f8d0fa0243afa01d4ea69687cb98b4a83c"
},
"downloads": -1,
"filename": "foliantcontrib.swaggerdoc-1.1.3.tar.gz",
"has_sig": false,
"md5_digest": "ef19426dd5719ee4d77e6691fdd25662",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7690,
"upload_time": "2019-04-15T10:41:28",
"url": "https://files.pythonhosted.org/packages/e7/88/f4d6a18b88322aab1a58d36630781633bcfe09e5dfd3f2769ae890054683/foliantcontrib.swaggerdoc-1.1.3.tar.gz"
}
],
"1.2.0": [
{
"comment_text": "",
"digests": {
"md5": "4bf841410d1ed2dec81fcfacf851b861",
"sha256": "63635bb9dcc638dff909817be3f3af32385fe965c27d35c113625fc028133eb2"
},
"downloads": -1,
"filename": "foliantcontrib.swaggerdoc-1.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4bf841410d1ed2dec81fcfacf851b861",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9060,
"upload_time": "2019-08-26T13:41:31",
"url": "https://files.pythonhosted.org/packages/92/d7/96a658fd0fbf11e1cc55e9398c8e4193dca130eaa3a8e9fd456844726d11/foliantcontrib.swaggerdoc-1.2.0-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "181630d9ec2fca87a12d7d6b6a065b7b",
"sha256": "21ae16708f9b6847e7980aaaf121d01545d0993ef2aa7f6e3d3e7fbb5233909c"
},
"downloads": -1,
"filename": "foliantcontrib.swaggerdoc-1.2.0.tar.gz",
"has_sig": false,
"md5_digest": "181630d9ec2fca87a12d7d6b6a065b7b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7747,
"upload_time": "2019-08-26T13:41:32",
"url": "https://files.pythonhosted.org/packages/f8/7e/c03abdd9cc32e04fc8b6307087a4b7f5e3a0d742e0752fcee8454df9e4ae/foliantcontrib.swaggerdoc-1.2.0.tar.gz"
}
],
"1.2.1": [
{
"comment_text": "",
"digests": {
"md5": "e3f86a3ee57e0cae7dfb8dcbdaa34fea",
"sha256": "c3167b66d04cd004e1880d7876976d2c860dada55b7481158698338167f4634a"
},
"downloads": -1,
"filename": "foliantcontrib.swaggerdoc-1.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e3f86a3ee57e0cae7dfb8dcbdaa34fea",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9062,
"upload_time": "2019-10-02T07:16:49",
"url": "https://files.pythonhosted.org/packages/b6/f5/0cdb6cc4ad05bb0ca1791ca504f6809715fd9757d195169fad902d9d3e04/foliantcontrib.swaggerdoc-1.2.1-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "54ca5260ffc3cbf9b812f158f78e977d",
"sha256": "1c9e8f9e847cd18c29993c953020140912e0d98c8eb4cb0cf3e82368663bfe8c"
},
"downloads": -1,
"filename": "foliantcontrib.swaggerdoc-1.2.1.tar.gz",
"has_sig": false,
"md5_digest": "54ca5260ffc3cbf9b812f158f78e977d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7754,
"upload_time": "2019-10-02T07:16:50",
"url": "https://files.pythonhosted.org/packages/02/b5/a0f0d5be5a77df41dbe5aec5184aa58606619e793a304464ad9c71fb98c4/foliantcontrib.swaggerdoc-1.2.1.tar.gz"
}
]
},
"urls": [
{
"comment_text": "",
"digests": {
"md5": "e3f86a3ee57e0cae7dfb8dcbdaa34fea",
"sha256": "c3167b66d04cd004e1880d7876976d2c860dada55b7481158698338167f4634a"
},
"downloads": -1,
"filename": "foliantcontrib.swaggerdoc-1.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e3f86a3ee57e0cae7dfb8dcbdaa34fea",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9062,
"upload_time": "2019-10-02T07:16:49",
"url": "https://files.pythonhosted.org/packages/b6/f5/0cdb6cc4ad05bb0ca1791ca504f6809715fd9757d195169fad902d9d3e04/foliantcontrib.swaggerdoc-1.2.1-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "54ca5260ffc3cbf9b812f158f78e977d",
"sha256": "1c9e8f9e847cd18c29993c953020140912e0d98c8eb4cb0cf3e82368663bfe8c"
},
"downloads": -1,
"filename": "foliantcontrib.swaggerdoc-1.2.1.tar.gz",
"has_sig": false,
"md5_digest": "54ca5260ffc3cbf9b812f158f78e977d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7754,
"upload_time": "2019-10-02T07:16:50",
"url": "https://files.pythonhosted.org/packages/02/b5/a0f0d5be5a77df41dbe5aec5184aa58606619e793a304464ad9c71fb98c4/foliantcontrib.swaggerdoc-1.2.1.tar.gz"
}
]
}