Feat: Python project outline

[lalver1]

Closes #4

This PR prepares the outline for a Python project

• Set up pyproject.toml with project metadata, dependencies, and build system
• Set up init.py (and ready for dynamic package versioning)
• Install devcontainer requirements from pyproject.toml
• devcontainer is updated to use TOML VSCode extension

[lalver1]

@thekaveman if you try to build the dev container it'll fail and you'll prob see this error: LookupError: setuptools-scm was unable to detect version for /home/caltrans/src.

I was at least expecting to see /home/caltrans/src/pems somewhere and I was pretty sure that we had all that is needed for setuptools_scm but I'm clearly missing something.

I tried to isolate the problem and the container builds fine if I remove "setuptools_scm>=8" from the dev dependencies

pems/pyproject.toml

Line 20 in 8290130

"setuptools_scm>=8"

and "setuptools-scm>=8" from the build system

pems/pyproject.toml

Line 29 in 8290130

requires = ["setuptools>=75", "setuptools-scm>=8"]

Then from inside the container I can

pip install setuptools_scm
python -m setuptools_scm

and I can see that at least the commit shows up in the version string, but the container is failing to build 🤔

[thekaveman]

@lalver1 I think this is probably because the .git directory is not available during Docker build time, right?

For now let's just hardcode a version like version = "0.0.1" instead of dynamic = ["version"].

We can come back to the dynamic version in #10

[lalver1]

Yep, I think that's the reason, the .git directory is not available during Docker build time.

So I hardcoded version = "0.0.1" instead of dynamic = ["version"] but I still got the same error. However, when I removed "setuptools-scm>=8" from the build system's requirements, the container built.

If it's ok, I removed all references tosetuptools-scm in 79cd7b3, that way all the changes related to dynamic versioning will be in #10 when we come back to it.

[thekaveman]

Nice 👍 🐍