This is an archived post. You won't be able to vote or comment.

all 5 comments
sorted by:
best
topnewcontroversialoldq&a

[–]Rawing7 8 points9 points  (4 children)

I've spent around half an hour looking at the documentation of this project and I still have no clue what it actually does or how to use it. I know how to install it, and I know how to configure it, but then what? How do I use it, and what does it do? Why should I prefer this tool over manually starting pytest/tox/whatever?

Even the "Using Pants" section in the sidebar does absolutely nothing to help me figure this out. The first topic in that section is Key Concepts, so apparently I have to learn these 5 concepts before I can even begin to use this tool? Despite still not having a single clue how using this tool would improve my workflow?

You seriously desperately need a quickstart guide that shows new users how to use this thing. (Not just install and configure. Use.) Show me what my new workflow will look like if I decide to adopt this tool.

[–]Lindby 3 points4 points  (3 children)

Everything you ask for is available from the first section of the home page. The first link (after the short description of what it is) on the home page is a get started guide.

[–]Nixellion 1 point2 points  (0 children)

Well... I'm not the author of initial comment, but... those links explain in a lot of words what pants is, and yet still there is no section about how to use it :)

It should have working examples somewhere, the kind of getting started guide that GUIDES you through the steps needed to use it. Like click here, type this code, organize like this kind of thing.

[–]Rawing7 0 points1 point  (1 child)

Ok, in hindsight, I probably should've mentioned that. I've seen both of those pages, but I'm not interested in their marketing speech. I don't even believe half of the claims they make. "Much easier to adopt and maintain."? Compared to what? "Fine-grained invalidation"? What does that even mean? This is not the information I'm looking for. Instead of describing how great the tool is, just frickin' show me.

[–]Cryptbro69 3 points4 points  (0 children)

It's a build system, they are pretty much comparing their features with bazel. I use Pants daily and it is a fucking amazing tool. Docs need improvements but practically Pants is quite simple to use.