Python Project - pyproject.toml

[ebresie]

This will support project metadata using pyproject.toml. This will involve reworking some of the existing Python Project details to read in and output pyproject.toml project files instead.

This may involve importing existing ones for the project as well as creation of new python4nb project files.

For additional details, see

• https://peps.python.org/pep-0621/
• https://packaging.python.org/en/latest/specifications/declaring-project-metadata/#declaring-project-metadata
• https://packaging.python.org/en/latest/specifications/core-metadata/

[ebresie]

May need some "toml" support as well, but believe this may already be included in more recent Netbeans so this may be unnecessary.

[ebresie]

This may overlap or replace some of the following:

• Python Project Properties - Update: General #30 - General
• Python Project Properties - Update: Licenses  #35 Licenses
• Python Project Properties - Update: Libraries  #34 Library (dependencies)

Not sure if these are fully addressed in pyproject.toml - need to confirm this.

• Python Project Properties - Update: Configuration: Virtual Environment #33 - Configuration - Virtual Environments
• Python Project Properties - Update: Configuration: Platform #32 - Platform
• Python Project Properties - Update: Source: Encodings #31 - Encoding

[ebresie]

From Example pyproject.toml

[project]
name = "spam"
version = "2020.0.0"
description = "Lovely Spam! Wonderful Spam!"
readme = "README.rst"
requires-python = ">=3.8"
license = {file = "LICENSE.txt"}
keywords = ["egg", "bacon", "sausage", "tomatoes", "Lobster Thermidor"]
authors = [
{email = "hi@pradyunsg.me"},
{name = "Tzu-Ping Chung"}
]
maintainers = [
{name = "Brett Cannon", email = "brett@python.org"}
]
classifiers = [
"Development Status :: 4 - Beta",
"Programming Language :: Python"
]

dependencies = [
"httpx",
"gidgethub[httpx]>4.0.0",
"django>2.1; os_name != 'nt'",
"django>2.0; os_name == 'nt'"
]

[project.optional-dependencies]
test = [
"pytest < 5.0.0",
"pytest-cov[all]"
]

[project.urls]
homepage = "https://example.com"
documentation = "https://readthedocs.org"
repository = "https://github.com"
changelog = "https://github.com/me/spam/blob/master/CHANGELOG.md"

[project.scripts]
spam-cli = "spam:main_cli"

[project.gui-scripts]
spam-gui = "spam:main_gui"

[project.entry-points."spam.magical"]
tomatoes = "spam:main_tomatoes"

[ebresie]

Will also want to add a "New File...pyproject.toml" with maybe the example as a template.

[ebresie]

Need a toml library to work with in Java.

See the following

• https://medium.com/swlh/configure-your-java-program-with-toml-file-9f779a6a3de6
• https://stackoverflow.com/questions/70033062/how-to-parse-toml-document-with-java

[ebresie]

Some additional references

• https://godatadriven.com/blog/minimal-pyproject-toml-example/
• https://github.com/pypa/sampleproject

[ebresie]

Will leverage jackson

• https://github.com/FasterXML/jackson-dataformats-text/tree/2.15/toml
• https://github.com/FasterXML/jackson-dataformats-text
• https://mvnrepository.com/artifact/com.fasterxml.jackson.dataformat/jackson-dataformat-toml

Although initial implementation does not have the grouping like in [project] sections as I expected which may be related to FasterXML/jackson-dataformats-text#254

[ebresie]

For Toml spec see https://toml.io/en/

[ebresie]

May switch over to Tomlj which may support the "table" sect notion which does seem to be fully supported in jackson

For more info see:

• https://github.com/tomlj/tomlj
• https://tomlj.org/