Clyjin

System configuration toolbox

Modules

Clyjin has set of builtin modules to work with, to call a module use:

python3 -m clyjin {module_name} {module_args}

modules.API

Module deploying web server to display OpenAPI (A.K.A Swagger) specification UI for set of paths to api entrypoints defined in given file.

Usage:

python3 -m clyjin api -f {path/to/file/with/api/paths.txt}

Structure of paths.txt might be something like:

/home/user/project1/api/main.yml
/home/user/project2/api/main.yml
/home/user/project3/api/main.yml

All paths defined in paths.txt are fetched, and if they hold correct OpenAPI yaml spec, UI representation is built.

It is mandatory for now for API entrypoint to hold info.title info inside according entrypoint spec. This is required to build route to this file.

For example, main.yml:

openapi: '3.0.2'
info:
    title: MyProject
    version: package
...

will produce OpenAPI specification on route /myproject (or any cased route, e.g. /MyPrOjEcT since lower casing is performed before api names matching).

⚠️ WARNING
Accessing raw yaml files for main entrypoint and related dependencies is allowed across all filesystem of web-server's host (of course, where user launched the web-server has an access). Although, the validation for having exactly this api specified in paths.txt is done, this is not the best practice to have, because validation is checking and "pinging" requested target file.

Use on your own risk in public-faced servers.

Important notes

Unfortunately, folder structure inside directory with entrypoint specified is not allowed. This won't pass validation for referenced yaml files. I plan to fix this in future releases
And yes, only yaml formats supported for now

modules.Boot

[IN DEVELOPMENT] Flexible system configurations from apps installation to own settings applying.

Metadata

Release files for clyjin 0.2.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for clyjin 0.2.5
File	Size	Uploaded
clyjin-0.2.5.tar.gz	13.0 kB	Aug 17, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for clyjin 0.2.5
File	Interpreter	ABI	Platform	Reset
clyjin-0.2.5-py3-none-any.whl 18.8 kB Aug 17, 2023	Python 3	none	any	Details

Total release size: 31.9 kB

Release files / clyjin-0.2.5.tar.gz

Download URL	clyjin-0.2.5.tar.gz
Size	13.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`14190135bde1bf07d324776e1c6f1a477f2214a08e394a1c2c2b0ed55c5bf217`
BLAKE2b-256 checksum How to use checksums	`851476feb8424d11f6a11a619b7c6e0c2b8933040345c0e798e682fb5f0b2f1d`
Upload date	Aug 17, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.5.1 CPython/3.11.3 Linux/6.4.8-zen1-1-zen`

Release files / clyjin-0.2.5-py3-none-any.whl

Download URL	clyjin-0.2.5-py3-none-any.whl
Size	18.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`1a15c5a2187c9bc071e3423c6844b951c6b7d4270d547c1ce0f0884cb1ada9c7`
BLAKE2b-256 checksum How to use checksums	`a71ecb2c8e44f4a6c983775293235c3f1cdd4037be674ace5a296899810721ce`
Upload date	Aug 17, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.5.1 CPython/3.11.3 Linux/6.4.8-zen1-1-zen`