[Mailman-Developers] Mailman 3.0 fresh install - problems from python interpreter

[Richard Wackerbarth]

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 at 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's `python` 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 at 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.com
>> 
>> Security Policy: http://wiki.list.org/x/QIA9
>> 
> 
> 
> 
> -- 
> Jessy
> http://jessykate.com
> _______________________________________________
> Mailman-Developers mailing list
> Mailman-Developers at 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.org
> 
> Security Policy: http://wiki.list.org/x/QIA9