Re: [Mailman-Developers] Mailman 3.0 fresh install - problems from python interpreter
Jessy,
I'm sure that any additions to the documentation will be welcomed.
Good end-user documentation always seems to be something that gets shorted by the developers intimately related to the implementation aspect of the code. And, even when they make the effort, I'm not sure that they are the most qualified to write that kind of documentation. Someone less involved in the implementation often has a better perspective of the end-user needs regarding documentation.
As for your project, we have assumed that the website serving the UI is not the same host as that which hosts the MM core itself. As a result, attempting to use the command line utilities as your access method would not be the best implementation choice. There is a REST interface exposed, and your access should go through that.
Since you are working in the Django world, we would hope that you would utilize the postorius app, and leverage off of it for your customization. By doing so, it will be much easier for you to remain integrated with any changes that come down the line.
IMHO, at the moment, the postorius templates can be improved by doing some refactoring to keep their functionality in a {% block %} structure that can be integrated into another site without having to re-implement entire pages. I would like to have you review the present template structure and suggest which portions you would utilize as presented and those which ones you would prefer to change.
Thanks for your interest,
Richard
On Jun 7, 2012, at 11:31 AM, Jessy Kate Schingler wrote:
thanks mark and barry. i've been traveling so apologies for the delayed reply...
using
bin/mailman shell
command does indeed work flawlessly, thank you!should the docs be updated perhaps? something either under "getting started with GNU Maiman" or even a specific page on "interacting with mailman through the python interpreter"? i am happy to add something or contribute to that; i think it would certainly facilitate others working with the software if that bit was a bit more clear.
in general, what is that the recommended way to script one's own interactions with mailman as part of a larger python program? would it be through mailman.client "official bindings"? i see there are a number of imports in bin/mailman and subsequently in src/mailman/commands/cli_withlist.py (which i gather is an alias for "shell"). should those be a sufficient set of imports and initializations?
in this particular case, i am building a Django app so it seems i can rely on postorious and mailman.client, but that wouldn't necessarily be the case in general, and my curiosity is piqued about how the scaffolding process and imports work so i can do things The Right Way.
thanks! jessy
On Tue, Jun 5, 2012 at 7:09 PM, Barry Warsaw barry@list.org wrote:
Hi Jessy,
You're doing everything right, but there's one conceptual step that you're missing, and which isn't evident from the docs.
As Mark says,
mailman shell
is the best way to get a Python interactive interpreter shell to play with the internal Mailman API. Why is this better than just running the virtualenv'spython
interpreter directly? It's because there are a bunch of subsystems that have to be initialized before things will work correctly. E.g., the Zope component architecture (ZCA), the logging subsystem, the configuration subsystem, queues, rules, pipelines, etc. The exception you're getting is because the ZCA hasn't been initialized yet.
mailman shell
ensures that everything is initialized, then it gives you an interpreter prompt.Hope that helps. -Barry
Mailman-Developers mailing list Mailman-Developers@python.org http://mail.python.org/mailman/listinfo/mailman-developers Mailman FAQ: http://wiki.list.org/x/AgA3 Searchable Archives: http://www.mail-archive.com/mailman-developers%40python.org/ Unsubscribe: http://mail.python.org/mailman/options/mailman-developers/jessy%40jessykate....
Security Policy: http://wiki.list.org/x/QIA9
-- Jessy http://jessykate.com
Mailman-Developers mailing list Mailman-Developers@python.org http://mail.python.org/mailman/listinfo/mailman-developers Mailman FAQ: http://wiki.list.org/x/AgA3 Searchable Archives: http://www.mail-archive.com/mailman-developers%40python.org/ Unsubscribe: http://mail.python.org/mailman/options/mailman-developers/richard%40nfsnet.o...
Security Policy: http://wiki.list.org/x/QIA9
participants (2)
-
Jessy Kate Schingler
-
Richard Wackerbarth