Change recomended installation method to `pipx`
See original GitHub issueI’ve installed lektor
multiple times to test and contribute to Barranquilla’s python community page pybaq.co and my personal page. I’ve also attempted to teach others how to install it (mostly beginners) with various barriers in the process.
On some versions of ubuntu there are issues with availability of wheels for some packages. On windows there are issues when using python from the Windows Store. Many of these issues arise from trying to build everything from scratch.
I propose the use of pipx
to create an easier install. It is recommended by PyPA specifically for stand alone command line tools. It is OS independent. It is part of PyPA’s codebase. It has clear documentation.
After basic installation, lektor
install script would be as simple as pipx install lektor
or adding sudo pipx install lektor
for ubuntu based distributions to perform a global install.
Are there argument in favor or against? I’d take the task to update the docs on the webpage if agreed upon. (And of course, #911 has to be included for any install to work correctly without the need for alternate procedures).
Issue Analytics
- State:
- Created 2 years ago
- Reactions:2
- Comments:14 (8 by maintainers)
Top GitHub Comments
Oh, yessss, the second file in the gist is precisely that. Sorry I didn’t explicitly clarify that. I’ll proceed to do the pull request.
@dairiki Those were really good points.
About the desktop app I removed basically all references in the gist because the single referenced issue is now closed with a build apps for all platforms issue with little progress at the moment. A lot has been stated at #760 but nothing concrete.
About requirements: I removed most of it. I guess package managers tend to warn with pretty straightforward messages if anything additional is needed. I tried to go for clear informal language above rather than covering all that’s possible.
About the pip install: I guess when Lektor started virtual environments were somewhat a mess to learn with many competing ways to go about them and a huge chance to get confused and mess everything up. I make it clear, Back then. Now… this has changed. Even newcomers to python would usually install everything through pip and later realize they need to clean their installed packages; just then they’d move everything into venvs. I removed the scaremongering language. The bold part is the important one.
Again: The Gist