ENH,BLD: console_script entrypoint

[westurner]

• main.py: with console_script entrypoints, you can generate a bin/scriptname.py script given a (testable) named main() callable:

  def main(argv=None):
      argv = argv if argv is not None else []
      RETURN_OK = 0
      return RETURN_OK
  
  def test_main(args):
      retcode = main(["-h"])
      assert retcode
      retcode = main(["--help"])
      assert retcode
      retcode = main(["--test"])
      # subprocess.call(["pytest", "--cov=", "--cov-report=term-missing", path='.'])

• https://github.com/lexiq-legal/pydantic_schemaorg/blob/main/pyproject.toml

  • https://python-poetry.org/docs/pyproject/#scripts
    • https://packaging.python.org/en/latest/specifications/entry-points/
    • https://setuptools.pypa.io/en/latest/userguide/entry_point.html#console-scripts
    • https://setuptools.pypa.io/en/latest/userguide/entry_point.html#entry-points-for-plugins "setup.py" tab

• Add tests #7

  • This is w/ optparse, which doesn't support argparse things like auto bash-completion and sphinx docs, but does just return (opts, args): https://github.com/westurner/dotvim/blob/9a2876d459be52710d0ce9c5bcedfe26fc3c9d42/snippets-ulti/python.snippets#L117-L120