python-poetry / website Goto Github PK
View Code? Open in Web Editor NEWSource for the official Poetry website
Home Page: https://python-poetry.org
Source for the official Poetry website
Home Page: https://python-poetry.org
The local development instructions don't work for me.
When I run make site
, eventually I get the following error:
[Errno 2] No such file or directory: 'content/docs/1.2'
A similar issue #36 was reported and closed without a documented solution.
Full terminal output:
$ make site
npm install
npm WARN deprecated [email protected]: Modern JS already guarantees Array#sort() is a stable sort, so this library is deprecated. See the compatibility table on MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort#browser_compatibility
npm WARN deprecated @babel/[email protected]: π¨ This package has been deprecated in favor of separate inclusion of a polyfill and regenerator-runtime (when needed). See the @babel/polyfill docs (https://babeljs.io/docs/en/babel-polyfill) for more information.
npm WARN deprecated [email protected]: core-js@<3.23.3 is no longer maintained and not recommended for usage due to the number of issues. Because of the V8 engine whims, feature detection in old core-js versions could cause a slowdown up to 100x even if nothing is polyfilled. Some versions have web compatibility issues. Please, upgrade your dependencies to the actual version of core-js.
added 876 packages, and audited 877 packages in 10s
99 packages are looking for funding
run `npm fund` for details
17 vulnerabilities (1 low, 6 moderate, 10 high)
To address issues that do not require attention, run:
npm audit fix
To address all issues possible (including breaking changes), run:
npm audit fix --force
Some issues need review, and may require choosing
a different dependency.
Run `npm audit` for details.
poetry install
The currently activated Python version 3.8.10 is not supported by the project (^3.10).
Trying to find and use a compatible version.
Using python3 (3.10.10)
Creating virtualenv website-S2P53JhW-py3.10 in /home/isme/.cache/pypoetry/virtualenvs
Installing dependencies from lock file
Package operations: 23 installs, 1 update, 0 removals
β’ Installing idna (3.3)
β’ Installing sniffio (1.3.0)
β’ Installing anyio (3.6.1)
β’ Installing certifi (2022.6.15)
β’ Installing distlib (0.3.6)
β’ Installing filelock (3.8.0)
β’ Installing h11 (0.12.0)
β’ Installing platformdirs (2.5.2)
β’ Updating setuptools (65.7.0 -> 65.3.0)
β’ Installing cfgv (3.3.1)
β’ Installing crashtest (0.3.1)
β’ Installing httpcore (0.15.0)
β’ Installing identify (2.5.3)
β’ Installing nodeenv (1.7.0)
β’ Installing pylev (1.4.0)
β’ Installing pyyaml (6.0)
β’ Installing rfc3986 (1.5.0)
β’ Installing toml (0.10.2)
β’ Installing virtualenv (20.16.4)
β’ Installing cleo (1.0.0a5)
β’ Installing httpx (0.23.0)
β’ Installing pre-commit (2.20.0)
β’ Installing tomli (2.0.1)
β’ Installing tomli-w (1.0.0)
poetry run ./bin/website configure
The currently activated Python version 3.8.10 is not supported by the project (^3.10).
Trying to find and use a compatible version.
Using python3 (3.10.10)
poetry run ./bin/website docs pull
The currently activated Python version 3.8.10 is not supported by the project (^3.10).
Trying to find and use a compatible version.
Using python3 (3.10.10)
Pulling documentation for version 1.3 as 1.3
Cloning into '.'...
fatal: cannot change to 'https://github.com/python-poetry/poetry.git': No such file or directory
error: failed to initialize sparse-checkout
fatal: not a git repository (or any of the parent directories): .git
fatal: not a git repository (or any of the parent directories): .git
Pulling documentation for version 1.2 as 1.2
Cloning into '.'...
fatal: cannot change to 'https://github.com/python-poetry/poetry.git': No such file or directory
error: failed to initialize sparse-checkout
fatal: not a git repository (or any of the parent directories): .git
fatal: not a git repository (or any of the parent directories): .git
[Errno 2] No such file or directory: 'content/docs/1.2'
make: *** [Makefile:26: content/docs] Error 1
$ python --version
Python 3.10.10
$ node --version
v18.14.0
$ poetry run bin/website docs pull
The currently activated Python version 3.8.10 is not supported by the project (^3.10).
Trying to find and use a compatible version.
Using python3 (3.10.10)
Pulling documentation for version 1.3 as 1.3
Cloning into '.'...
fatal: cannot change to 'https://github.com/python-poetry/poetry.git': No such file or directory
error: failed to initialize sparse-checkout
fatal: not a git repository (or any of the parent directories): .git
fatal: not a git repository (or any of the parent directories): .git
Pulling documentation for version 1.2 as 1.2
Cloning into '.'...
fatal: cannot change to 'https://github.com/python-poetry/poetry.git': No such file or directory
error: failed to initialize sparse-checkout
fatal: not a git repository (or any of the parent directories): .git
fatal: not a git repository (or any of the parent directories): .git
[Errno 2] No such file or directory: 'content/docs/1.2'
Environment:
https://python-poetry.org/ doesn't seem to be working today, I'm getting timeouts on multiple devices.
Just thought I'd create an issue so someone's aware of the situation.
I followed the instructions as given on the readme:
make site
make: poetry: Command not found
Makefile:19: recipe for target 'content/docs' failed
I am on a Zorin OS (debian based) machine.
Following is the output of running make site
:
β°ββ― make site ββ―
npm install
npm WARN deprecated [email protected]: core-js@<3.4 is no longer maintained and not recommended for usage due to the number of issues. Because of the V8 engine whims, feature detection in old core-js versions could cause a slowdown up to 100x even if nothing is polyfilled. Please, upgrade your dependencies to the actual version of core-js.
npm WARN deprecated @babel/[email protected]: π¨ This package has been deprecated in favor of separate inclusion of a polyfill and regenerator-runtime (when needed). See the @babel/polyfill docs (https://babeljs.io/docs/en/babel-polyfill) for more information.
added 859 packages, and audited 860 packages in 47s
86 packages are looking for funding
run `npm fund` for details
22 vulnerabilities (13 moderate, 9 high)
To address issues that do not require attention, run:
npm audit fix
Some issues need review, and may require choosing
a different dependency.
Run `npm audit` for details.
npm notice
npm notice New minor version of npm available! 8.3.1 -> 8.15.0
npm notice Changelog: https://github.com/npm/cli/releases/tag/v8.15.0
npm notice Run npm install -g [email protected] to update!
npm notice
poetry install
make: poetry: Command not found
Makefile:19: recipe for target 'content/docs' failed
make: *** [content/docs] Error 127
I wanted to migrate my pipenv project to poetry. I managed to do this for local setup, however I had troubles configuring my dockerfile, as your website has absolutely no documentation about working with CI and containers (other than installation guide).
I have found this amazing stackoverflow answer: https://stackoverflow.com/a/54763270/17101184 and I'm wondering why this info isn't available in the official documentation. Your documentation describes each configuration flag in detail, but gives no guide for common usage cases, like working in docker (recommending flags like POETRY_VIRTUALENVS_CREATE=false).
I want to get started with poetry, but I am unsure which is the current version.
The website offers docs for master, 1.1 and 1.2 in one part, without saying something about the state of each.
In another part it says 1.1 is "stable" and "master" is development, but not what 1.2 is.
Digging a bit deeper 1.2 seems to be on the way to be released, or is it already?
Can someone explain/help me? Thanks in advance!
It seems that something is wrong with the algolia account. Requests to the provider return 403
:
{
"message": "This operation cannot be processed, the application is blocked. Contact us to unblock it.",
"status": 403
}
This of course results in the search not working as no search results are available
This isn't that great for reading the docs:
Additionally all the additional examples don't have Windows versions:
When looking at the History page at https://python-poetry.org/history/, it shows the latest release to be 1.3.0, but when looking at the releases on github, it shows the latest release to be 1.3.2.
Currently, the official website provides a version selection button for 3 versions of the documentation: master, 1.5 and 1.4.
Some Linux distribution uses older versions in their packages. For instance the latest Debian stable, released this June, uses version 1.3.2.
Please keep older versions of the documentation accessible on the official website.
EDIT: I misread the docs! There are two alternative installation methods, not three.
To install poetry with pipx, there are two alternative installation methods, depending on how much control you need over versioning. You only want to use one of these alternatives. However, these two alternatives look like two steps, which you're supposed to do one after the other.
It's a similar story for the 'With the official installer' tab.
Perhaps, instead of:
β1
β2
β3
We could organise it as:
β1
β2
βOption A
βOption B
Hello I try to build the website locally, but cannot pull the docs:
website [π v3.10.3(website-DvCDHzbR-py3.10)]
β―β―β― poetry run ./bin/website docs pull
Pulling documentation for version 1.1 as 1.1
Cloning into '.'...
fatal: cannot change to 'https://github.com/python-poetry/poetry.git': No such file or directory
error: failed to initialize sparse-checkout
fatal: not a git repository (or any of the parent directories): .git
fatal: not a git repository (or any of the parent directories): .git
Pulling documentation for version master
Cloning into '.'...
fatal: cannot change to 'https://github.com/python-poetry/poetry.git': No such file or directory
error: failed to initialize sparse-checkout
fatal: not a git repository (or any of the parent directories): .git
fatal: not a git repository (or any of the parent directories): .git
I try this at Windows 10 and WSL Ubuntu 20.04
Any advice on building website locally, Thank you β€οΈ
This is about https://python-poetry.org/docs where you can find "Discussions" in the footer of each page.
The link behind "Discussions" (https://github.com/python-poetry/discussions) is dead.
Should be https://github.com/python-poetry/poetry/discussions I think.
Many static site generators support a copy-to-clipboard button for code blocks. For example, see a Material for Mkdocs example:
GitHub also supports this, for example hover over the code blocks here:
This is especially useful for new users who want to quickly copy out commands such as the installation command that doesn't all fit on the screen at once.
It doesn't seem like this is something that Hugo supports out of the box unfortunately, but there are several guides on it:
A declarative, efficient, and flexible JavaScript library for building user interfaces.
π Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. πππ
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google β€οΈ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.