Comments (20)
@hpk42 yeah I know I kinda dropped the ball on this...been busy.
It's Pycon Canada this weekend in Toronto so I'll try to jam something out at the very least during the sprints Mon-Tues.
from pluggy.
actually, let me just do a quick and dirty initial setup with only api docs
from pluggy.
1/2) both setuptools entrypoints and custom loading are upported
3) all added plugins are constructed instances or modules,
the typical method to do global initialization is to create a historic configuration hook that
gets called on each added plugin (like pytest_configure)
from pluggy.
1/2) both setuptools entrypoints and custom loading are upported
This explanation is no better than "as used by py.test". =)
- what is "global" initialization and what is "normal" initialiation in this case?
from pluggy.
there is no "normal"
you'd just have a hook thats called on all plugins that get registered in all variants it was called with
there is a reason why i strongly referred to pytest internal usages,
we are rather short on time atm
n
from pluggy.
@techtonik one of the milestones for a pluggy 1.0
release is complete docs, which as @RonnyPfannschmidt said probably won't be available in the short term.
We should use this issue to remember ourselves of the need for better documentation on pluggy.
from pluggy.
I see.
you'd just have a hook thats called on all plugins that get registered in all variants it was called with
Before a hook is called on a plugin, you need to find and import that plugin. Is that "hook" is just a function that should be implemented by a module as a part of plugin interface?
from pluggy.
Yes, the pytest_configure hook in pytest is one such example
from pluggy.
Ok. hooks == plugin api == plugin callbacks. Thanks for the explanations.
from pluggy.
Hello, I'm in the process of implementing plugins using pluggy in our own application. Is there a more elaborate description of how to use pluggy? When can pluggy 1.0 be expected? When can pytest 3 be expected?
from pluggy.
When can pluggy 1.0 be expected?
Not sure, @hpk42 could comment on that.
When can pytest 3 be expected?
I would say sometime after our sprint, which will end on June 25th.
from pluggy.
@nicoddemus @RonnyPfannschmidt @hpk42 I'd be willing to take a stab at this.
I've now used pluggy
in another small project and also have pretty decent experience with pytest
at this point. I also have combed the pluggy
source code multiple times and am pretty sure I have a decent grasp of the internals. I've been trying to use pluggy
as a means to learn pytest
from the bottom up for some time now but I need some deadlines to move it along.
I'd be willing to submit a PR for sphinx docs within the next few weeks. My only request is that eventually this project is moved to the pytest-dev
org and maintained more prominently there.
from pluggy.
I did send @hpk42 a mail about that
He will react after returning from his current travel
from pluggy.
My personal opinion is that I certainly would love to have some docs for the project! I would also like to move it to pytest-dev
, but let's see what @hpk42 has to say about that.
from pluggy.
@RonnyPfannschmidt @nicoddemus well it looks like we got our wish!
Are you guys cool with sphinx + the alabaster theme to start?
from pluggy.
Hey @tgoodlet! 😁
I think Sphinx is fine, but if you don't mind I would rather publish to readthedocs with the default readthedocs theme. What do you think?
from pluggy.
@nicoddemus sure works for me. I'll get something cobbled together in the next week or so and link you guys.
from pluggy.
Nice, sounds good! Thanks a lot for your interest, it is really appreciated by the team! 👍
Btw, already created the project on readthedocs. 😁
from pluggy.
I'd be very happy with a sphinx project even by just having nice API online documentation. @tgoodlet if you go for this we could eventually go for pluggy-1.0 i think 👍
from pluggy.
@RonnyPfannschmidt so are you going to push up just a sphinx autodoc draft?
I'm a fan of you getting the rtd build up and running since I don't have access currently ;)
from pluggy.
Related Issues (20)
- Drop Python 3.7
- Export our typing HOT 2
- multi hook registration does not unregister HOT 6
- Can plugins be executed concurrently? HOT 3
- RFE: is it possible to start making github releases?🤔 HOT 3
- pytest won't run root conftest.py's pytest_configure in special circumstances HOT 2
- Rename misleading function name `PluggyManager.load_setuptools_entrypoints` HOT 3
- Issue with ordering of hooks HOT 2
- Question about default values in hook implementation HOT 1
- discussion: pluggy speedup by using 'codegen' HOT 7
- Is it possible to override an existing hook with a HookCaller class?
- pluggy loads disabled pytest plugins HOT 5
- Warn when old-style hookwrapper raises during teardown
- Add python-lsp-server to downstream tests
- Troubles to understand the new updates on Pluggy HOT 11
- Bug: Pluggy 1.4 searches all home dirs for __init__.py HOT 2
- Possible to tell which hook answered a call? HOT 1
- load_setuptools_entrypoints messing up with rpath HOT 2
- How to get in touch regarding a security concern HOT 6
- [FR] Rename `load_setuptools_entrypoints` to `load_package_metadata_entrypoints()`
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 pluggy.