Comments (5)
gaborbernat
commented on June 26, 2024
1
Agreed, please put in a PR with that.
from platformdirs.
gaborbernat
commented on June 26, 2024
Duplicate of #4
from platformdirs.
bede
commented on June 26, 2024
Hi @gaborbernat, evidently this path is well trodden, but did you read the final sentence?
Perhaps this could be made clearer to avoid confusion? I'm happy to PR the readme if welcomed.
I simply asked if clarification of the readme is welcome as a PR. That way fewer people will be surprised by the library not working as they expected. The extent of activity related to #4 shows that a lot of people are confused by this.
Also, the Readme says:
On Linux (and other Unices), according to the XDG Basedir Spec, it should be:
This is somewhat misleading since MacOS is a Unix-based OS, but is not covered by the behaviours this sentence references. This sentence led me to believe the intended behaviour is a bug.
Would you in principle be happy to merge clarification of MacOS/Windows behaviour in the Readme?
from platformdirs.
gaborbernat
commented on June 26, 2024
Would you in principle be happy to merge clarification of MacOS/Windows behaviour in the Readme?
Definitely 😊 while macOS claims to be POSIX-compliant, in practice at no point their docs encourage or document the use of the XDG_DATA_HOME env var and such would surprise some user if we'd add support.
from platformdirs.
bede
commented on June 26, 2024
Thank you, I understand the rationale for lack of support having read #4.
Perhaps the best place to introduce a clarification is in the section
platformdirs to the rescue? Perhaps just a sentence early on, in order to
signpost users.
…On Wed, 6 Mar 2024 at 00:01, Bernát Gábor ***@***.***> wrote:
Would you in principle be happy to merge clarification of MacOS/Windows
behaviour in the Readme?
Definitely 😊 while macOS claims to be POSIX-compliant, in practice at no
point their docs encourage or document the use of the XDG_DATA_HOME env var
and such would surprise some user if we'd add support.
—
Reply to this email directly, view it on GitHub
<#269 (comment)>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/AAHWAABIH5KDKTLDGP5ER5DYWZMGTAVCNFSM6AAAAABEH26OQKVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMYTSNZZHAZTQMJYGM>
.
You are receiving this because you authored the thread.Message ID:
***@***.***>
from platformdirs.
Related Issues (20)
- getuid is not Linux specific HOT 1
- Testing could fail with pytest-randomly HOT 1
- Windows support link broken HOT 2
- `user_runtime_dir` for root on Unix
- user_runtime_dir for *BSD HOT 3
- Feature: add user_downloads_dir HOT 1
- Feature: user_desktop_dir HOT 2
- Cannot import name '__version__' from 'platformdirs.version' HOT 6
- Unix user_log_dir doesn't create log dir HOT 1
- Optionally redirect `user_*_dir()` calls to `site_*_dir()` for root on Unix HOT 2
- Add `site_state_dir()` counterpart for `user_state_dir()` HOT 1
- Add `site_log_dir()` counterpart for `user_log_dir()`
- pre-commit updates of pyproject.toml:[build-system]:requires HOT 3
- Support Homebrew prefixes
- HOME and StartMenu? HOT 1
- Missing changelog for 4.0 HOT 3
- Feature Request: Be able to create directories HOT 1
- multipath cannot work for path HOT 5
- Adding to stdlib/pathlib? HOT 13
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from platformdirs.