Publish to PyPI

[tueda]

As a single module (formset.py), after some refactoring #2, with some documentation and examples in README.

[tueda]

This repository uses type annotations, but PEP 561 doesn't support module-only distributions. The package layout may be changed to

─── formset
    ├── __init__.py
    ├── __main__.py
    ├── formset.py
    └── py.typed

in such a way that still formset.py can be picked up as a standalone script.

[tueda]

It turned out that supporting ancient Python versions in modern developer tools is highly nontrivial, for example:

• Wrong metadata generated for old Python versions python-poetry/poetry#3791
• deadsnake action missing apt-get update after add-apt-repository deadsnakes/issues#128 (comment)

We may drop official supports for 2.6, 3.2, 3.3 (and maybe 3.4) in the package information, though we could keep the old code for 2.6, which may work when used as a standalone script.

[magv]

As a data point: pySecDec supports Python 2.7 now, but in the next release (where formset.py will be included) we plan to only support Python 3.6+.

[tueda]

It turned out that the package name formset is not allowed by PyPI, though currently there is no formset:

Publishing formset (1.0.0rc1) to PyPI
 - Uploading formset-1.0.0rc1-py2.py3-none-any.whl 100%

  UploadError

  HTTP Error 400: The name 'formset' isn't allowed. See https://pypi.org/help/#project-name for more information.

  at /home/linuxbrew/.linuxbrew/Cellar/poetry/1.1.5/libexec/lib/python3.9/site-packages/poetry/publishing/uploader.py:216 in _upload
      212│                     self._register(session, url)
      213│                 except HTTPError as e:
      214│                     raise UploadError(e)
      215│
    → 216│             raise UploadError(e)
      217│
      218│     def _do_upload(
      219│         self, session, url, dry_run=False
      220│     ):  # type: (requests.Session, str, Optional[bool]) -> None

[magv]

It was registered by what seems to be a package name squatter. I think if you'll contact the PyPI support, they'll transfer it to you.

[tueda]

FYI: some related discussions:

• Checking if a package name is allowed or forbidden/reserved on PyPI
• Projects automatically deleted from Pypi
• PEP 541 - Should name squatting be actively discouraged?

Meanwhile, I have started to think about putting some prefix or namespace (related to How to create a namespace package/project on pypi?), maybe formtools-formset or formtools.formset, because in future I would possibly put more FORM utilities on PyPI, e.g., formprof. I guess no one would take formtools-formset or formtools-formprof.

[tueda]

The current version is registered as https://pypi.org/project/formtools-formset/1.0.0rc1.