Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document setuptools entry points #50594

Closed
AstraLuma opened this issue Nov 21, 2018 · 3 comments
Closed

Document setuptools entry points #50594

AstraLuma opened this issue Nov 21, 2018 · 3 comments
Labels
Documentation Relates to Salt documentation Feature new functionality including changes to functionality and code refactors, etc. P4 Priority 4
Milestone

Comments

@AstraLuma
Copy link
Contributor

Salt supports adding directories to look for extmods in by querying setuptools entry points. However, this is not documented. This allows extensions for salt to be packaged and shipped via standard python packaging tools. However, you can only find this by looking at the source.

What I'm doing is:

    entry_points={
        'salt.loader': [
            '{0}_dirs=spirofs.loader:{0}'.format(tag)
            for tag in (
                'auth', 'beacons', 'cache', 'engines', 'executor', 'fileserver',
                'grains', 'log_handlers', 'module', 'pillar', 'render',
                'returner', 'runner', 'serializers', 'tokens', 'top', 'utils',
                'wheel',
            )
        ],
    },
@Ch3LL Ch3LL added Feature new functionality including changes to functionality and code refactors, etc. Documentation Relates to Salt documentation P4 Priority 4 labels Nov 21, 2018
@Ch3LL Ch3LL added this to the Approved milestone Nov 21, 2018
@Ch3LL
Copy link
Contributor

Ch3LL commented Nov 21, 2018

sounds like a great addition :)

@AstraLuma
Copy link
Contributor Author

I'm actually not sure where this should live in the documentation. I thought there was a list of extmods somewhere?

Maybe there just needs to be a page outlining what extmods there are and what they do, with links to further information when available.

@AstraLuma
Copy link
Contributor Author

Finally found the files.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Documentation Relates to Salt documentation Feature new functionality including changes to functionality and code refactors, etc. P4 Priority 4
Projects
None yet
Development

No branches or pull requests

2 participants