Read inline files stored inside another file.
Project description
Inline Files
This Python package allows us to read and interact with inline files.
An inline file is a file stored within another file. This parent file can be any kind of file, but a .py file is preferred due to how an inline file is defined.
Definition
We use the following syntax to define an inline file:
r"""ILF
__ID1__
Hello World!
__ID2:json__
{
"hello": "world"
}
"""
In other words, an inline file must be defined inside a multiline comment, or docstring, and must be preceded by __[ID]__
, where [ID]
is the inline file's name. In the example above, there are two inline files, "ID1" and "ID2", with "ID2" having an optional extension.
If an inline file is defined with an extension, the file will be read according to that extension. For example, a JSON file will be processed using the json
module. Files without an extension are treated as text files. Currently, the module supports json
, yaml
and xml
extensions. Below is another example of an inline file with an extension.
r"""ILF
__file1:yaml__
filename: file1
extension: yaml
Module
The module contains a constructor responsible for reading a file and extracting its inline files. By default, this file will be the file that calls the constructor, but another file can be specified.
The module's main method, get_file()
, will return an inline file's contents, which can be a string or a structure, if the file has one of the supported extensions.
There is also a get_extension()
method, used to retrieve an inline file's extension.
Usage example
from inline_files import InlineFiles
ilf = InlineFiles()
i = ilf.get_file("ID1")
print(i)
r"""ILF
__ID1__
Hello World!
__ID2__
def ping():
return "pong"
"""
Usage example with extensions
from inline_files import InlineFiles
ilf = InlineFiles()
j = ilf.get_json("J")
print(j["filename"])
r"""ILF
__J:json__
{
"filename": "J",
"extension": "json"
}
"""
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for inline_files-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | be54adf5f13e09834a4068af17b559c5c84bed9bd1034d9fcc03718983a5fae8 |
|
MD5 | 6c6bc9822e6cca6f9d919e275e465fd5 |
|
BLAKE2b-256 | 9bc48090116aab05b981643b0a67095c5b3b5a46e268876ba41b7b2035a6da56 |