setup.py

#!/usr/bin/env python3
# see https://github.com/karlicoss/pymplate for up-to-date reference

from setuptools import setup, find_namespace_packages # type: ignore

INSTALL_REQUIRES = [
    'pytz'                   , # even though it's not needed by the core, it's so common anyway...
    'typing-extensions'      , # one of the most common pypi packages, ok to depend for core
    'appdirs'                , # very common, and makes it portable
    'more-itertools'         , # it's just too useful and very common anyway
    'decorator'              , # less pain in writing correct decorators. very mature and stable, so worth keeping in core
    'click>=8.1'             , # for the CLI, printing colors, decorator-based - may allow extensions to CLI
    'kompress>=0.2.20240918' , # for transparent access to compressed files via pathlib.Path
]


def main() -> None:
    pkg = 'my'
    subpackages = find_namespace_packages('.', include=('my.*',))
    setup(
        name='HPI', # NOTE: 'my' is taken for PyPi already, and makes discovering the project impossible. so we're using HPI
        use_scm_version={
            # todo eh? not sure if I should just rely on proper tag naming and use use_scm_version=True
            # 'version_scheme': 'python-simplified-semver',
            'local_scheme': 'dirty-tag',
        },
        setup_requires=['setuptools_scm'],

        zip_safe=False,

        # eh. find_packages doesn't find anything
        # find_namespace_packages can't find single file packages (like my/common.py)
        packages=[pkg, *subpackages],
        package_data={
            pkg: [
                # for mypy
                'py.typed',
            ],
        },


        url='https://github.com/karlicoss/HPI',
        author='Dmitrii Gerasimov',
        author_email='karlicoss@gmail.com',
        description='A Python interface to my life',

        python_requires='>=3.9',
        install_requires=INSTALL_REQUIRES,
        extras_require={
            'testing': [
                'pytest',
                'ruff',
                'mypy',
                'lxml', # for mypy coverage

                # used in some tests.. although shouldn't rely on it
                'pandas',

                'orjson',  # for my.core.serialize and denylist
                'simplejson',  # for my.core.serialize

                ##
                # ideally we'd use --instal-types in mypy
                # , but looks like it doesn't respect uv venv if it's running in it :(
                'types-pytz'      ,  # for my.core
                'types-decorator' ,  # for my.core.compat
                'pandas-stubs'    ,  # for my.core.pandas
                'types-dateparser',  # for my.core.query_range
                'types-simplejson',  # for my.core.serialize
                ##
            ],
            'optional': [
                # todo document these?
                'orjson',  # for my.core.serialize
                'pyfzf_iter',  # for my.core.denylist
                'cachew>=0.15.20231019 ',
                'mypy', # used for config checks
                'colorlog',  # for colored logs
                'enlighten',  # for CLI progress bars
            ],
        },
        entry_points={'console_scripts': ['hpi=my.core.__main__:main']},
    )


if __name__ == '__main__':
    import argparse
    p = argparse.ArgumentParser()
    p.add_argument('--dependencies-only', action='store_true')
    args, _ = p.parse_known_args()
    if args.dependencies_only:
        cmd = ['pip3', 'install', '--user', *INSTALL_REQUIRES]
        scmd = ' '.join(cmd)
        import os
        xx = input(f'Run {scmd} [y/n] ')
        if xx.strip() == 'y':
            os.execvp(
                'pip3',
                cmd
            )
    else:
        main()

# TODO assert??? diff -bur my/ ~/.local/lib/python3.8/site-packages/my/