From 170cd639a7ed591184fde23968b2d24dac630e45 Mon Sep 17 00:00:00 2001 From: Average Dude Date: Tue, 18 Feb 2020 14:49:11 +0100 Subject: Create template dirs for openapi clients and provide README templates The definitions are now also in the template dirs because they will be ignored by the generator. Generators only use overrides and don't do anything with new files. --- support/openapi/python/README.mustache | 47 ++++++++++++++++++++++++++++++++++ support/openapi/python/def.yaml | 5 ++++ 2 files changed, 52 insertions(+) create mode 100644 support/openapi/python/README.mustache create mode 100644 support/openapi/python/def.yaml (limited to 'support/openapi/python') diff --git a/support/openapi/python/README.mustache b/support/openapi/python/README.mustache new file mode 100644 index 000000000..93dcd5ab6 --- /dev/null +++ b/support/openapi/python/README.mustache @@ -0,0 +1,47 @@ +# Python API client for {{appName}} + +This Python package is automatically generated from [PeerTube's REST API](https://docs.joinpeertube.org/api-rest-reference.html), +using the [OpenAPI Generator](https://openapi-generator.tech) project: + +- API version: {{appVersion}} +- Package version: {{packageVersion}} +{{^hideGenerationTimestamp}} +- Build date: {{generatedDate}} +{{/hideGenerationTimestamp}} +- Build package: {{generatorClass}} + +{{#infoUrl}} +For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}}) +{{/infoUrl}} + +## Requirements. + +Python 2.7 and 3.4+ + +## Installation & Usage + +```sh +pip install git+https://{{gitHost}}/{{{gitUserId}}}/{{{gitRepoId}}}.git +``` +(you may need to run `pip` with root permission: `sudo pip install git+https://{{gitHost}}/{{{gitUserId}}}/{{{gitRepoId}}}.git`) + +Then import the package: +```python +import {{{packageName}}} +``` + +## Getting Started + +Please follow the [installation procedure](#installation--usage) and then run the following: + +{{> common_README }} + +## License + +Copyright (C) 2015-2020 PeerTube Contributors + +This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. + +This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. + +You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses. diff --git a/support/openapi/python/def.yaml b/support/openapi/python/def.yaml new file mode 100644 index 000000000..819a466eb --- /dev/null +++ b/support/openapi/python/def.yaml @@ -0,0 +1,5 @@ +# https://openapi-generator.tech/docs/generators/python + +packageName: peertube +projectName: peertube + -- cgit v1.2.3