Document the properties that all SymbiFlow provided Python modules should include.

[mithro]

SymbiFlow has a lot of Python projects. We want all our Python projects to behave in the same way and feel the same.

Python has a lot of gotcha's around publishing good packages, tracking dependencies and making sure they work.

First step to doing this is documenting how we expect things to behave.

[mithro]

I started a Google Doc where I was trying to document how I thought Python modules should work.

[mithro]

See also things like https://github.com/SymbiFlow/fasm/pull/64/checks?check_run_id=2055039242#step:8:3258

GitHub

Cleanup requirements a little and remove setup.cfg file. by mithro · Pull Request #64 · SymbiFlow/fasm

setup_requires needs to be specified in both setup.py and pyproject.toml. The requirements.txt file should use -e . to install the module (and thus get the requirements). If a local or non-PyPi ver...

[mithro]

More random links;

• https://setuptools.readthedocs.io/en/latest/userguide/dependency_management.html
• https://setuptools.readthedocs.io/en/latest/setuptools.html
• https://packaging.python.org/specifications/core-metadata/?highlight=extra#provides-extra-multiple-use
• https://python-packaging.readthedocs.io/en/latest/everything.html

Dependencies Management in Setuptools - setuptools 57.4.0 documentation

Building and Distributing Packages with Setuptools - setuptools 57.4.0 documentation

Core metadata specifications — Python Packaging User Guide

Putting It All Together — Python Packaging Tutorial

[mithro]

https://docs.conda.io/projects/conda/en/latest/user-guide/configuration/pip-interoperability.html

Improving interoperability with pip — conda 4.10.3.post11+888309718 documentation

[mithro]

https://docs.google.com/document/d/1AaL460Uf_8_9v8EIy4pAZYTFOFXbv5O4RRU7Jv4t_Z4/edit#heading=h.eods90sxr89u

Google Docs

conda notes

Conda Notes Key Relationships General Conda Process Installing Starting Restarting Installing Packages Environment Files Windows Notes Auto Install? In what folder should I install Anaconda on Windows? Further Info Key This is a file This is a command This is python code Relationships nodej...

[mithro]

https://docs.google.com/document/d/10_MqFjTIYVVuOJlusJydsp4KOcmrrHk03__7ME5thOI/edit

Google Docs

Open Source EDA: building, packaging, installing

PARENT: http://bit.ly/unai-eda-megadoc Building, packaging and installing�Open Source EDA tooling�for mixed HDL designs Packaging + Distribution Systems 1 Overall Goals 2 Distribution: Canonical package managers (apk, apt, dnf, pacman, etc.) 2 Alpine Linux 3 Android 3 Arch Linux 3 Debian/Ubunt...