{"id":23692,"library":"executable-application","title":"executable-application","description":"A minimal example of an executable Python application packaged with setuptools. Current version 0.3.0, released infrequently. Intended for demonstration and learning purposes, not for production use.","status":"active","version":"0.3.0","language":"python","source_language":"en","source_url":"https://github.com/pypa/sampleproject","tags":["example","application","demo"],"install":[{"cmd":"pip install executable-application","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"The package exposes a main function; importing the module directly doesn't call it.","wrong":"import executable_application","symbol":"main","correct":"from executable_application import main"},{"note":"Hyphen in PyPI name becomes underscore in Python import.","wrong":"import executable-application","symbol":"executable_application","correct":"import executable_application"}],"quickstart":{"code":"from executable_application import main\nif __name__ == '__main__':\n    main()","lang":"python","description":"Run the application's main function directly."},"warnings":[{"fix":"Use 'executable_application' in import statements.","message":"The package name on PyPI contains a hyphen (executable-application), but the Python import uses an underscore (executable_application). This is a common source of confusion.","severity":"gotcha","affected_versions":"all"},{"fix":"Call from Python code: from executable_application import main; main().","message":"As of version 0.3.0, there is no official CLI entry point; the package only provides a main() function.","severity":"deprecated","affected_versions":"0.3.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use 'import executable_application' (underscore) instead of 'executable-application'.","cause":"Attempting to import the package using the hyphenated PyPI name instead of the underscore module name.","error":"ModuleNotFoundError: No module named 'executable-application'"},{"fix":"Upgrade to version 0.3.0 or later: pip install --upgrade executable-application.","cause":"Older versions of the package (pre-0.3.0) may not have the main function exposed at the top level.","error":"ImportError: cannot import name 'main' from 'executable_application'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}