book revision

[mdipierro]

I am revising the book.

Please list what features are not mentioned in the book or deserve
more space they correctly get.
You suggestions will be appreciated.

Massimo

[mr.freeze]

Definitely these:
http://web2pyslices.com/main/slices/take_slice/16

[mr.freeze]

crud.search
RPXAccount
populate
plugins and PluginManager
any new validators
LOAD

[Adi]

- compute, virtualfields, represent and all such things that are are
db.table.field level
- a chapter on reusable logic (where to place it - module, model,
controller, site-packages in which scenario)
- templates, blocks, {{include}} in views
- custom forms, including sign up forms (lots of questions asked on
this subject)

That's all I can think of right now.

[mdipierro]

{{blocks}} were put in the web2py as an experiment and we took them
out because of a problem. We need to put them back in.

Massimo

[Johann Spies]

Enough information for total javascript beginners to understand and
use jqgrid and friends please.

Johann

--
"Finally, brethren, whatsoever things are true,  whatsoever things are
honest, whatsoever things are  just, whatsoever things are pure,
whatsoever things are lovely, whatsoever things are of good report; if
there be any virtue, and if there be any praise, think on these
things."    Philippians 4:8

[weheh]

+1 all above suggestions. I would also suggest some more doc on the
ajax interface to radio buttons, check boxes, and select lists.

[weheh]

Doc index needs expansion. When I was a little more of a newbie, I
know I looked in the index for keywords that I was sure should be
there, only to find them missing. At the moment, I don't recall what
they were, sorry. At the least, every web2py function and attribute
should be listed in the index. If I can dredge up some of the missing
items, I'll let you know.

[mdipierro]

Working on this as we speak.

[Garrafa Pet 2 Litros]

I think it's good to review the section 3.9 that discusses the wiki
and add documentation of new features found in the plugin wiki.

[Jonathan Lundell]

More on the DAL objects would be nice, especially on the details of their methods. Which operations they support, how they're combined, etc. There's something there already, but it could use fleshing out.

[mdipierro]

I have identified the following items that are missing from the book.
Listed here in some random order.

compute fields
virtual fields
crud.search
RPXAccount
new validators
populate
plugins
LOAD and generic.load
Field attributes (compute, virtualfield, uploadseparate)
format, represent
recursive queries
MARKMIN syntax
Informix support
named id fields
keyedtables
DAL('gae')
XHTML
first() last()
find(), sort(), exclude()
as_dict(), as_list()
request.meta
request.wsgi
IS_IN_DB(....,and=....)
python web2py.py -S app -M -R script.py -A arg1 arg2 arg3
New syntax T("%(a)s") % dict(a="hello")
web2py.py -nogui
SQLFORM.factory(...,table_name='no_table')
new setup-web2py-ubuntu.sh
new setup-web2py-fedora.sh
autocomplete widget
pam authentication
auth.settings.login_captcha and auth.settings.register_captcha
crud.settings.create_captcha and crud.settings.update_captcha
gluon/contrib/login_methods/linkedin_account.py (to be tested)
cherrypy to rocket
SQLFORM(...,formstyle='divs')
SQLTABLE(...,headers='fieldname:capitalize')
Field().with_alias
has_membership(group=...,role=...)
db.define_table(username=True)
gluon.tools.prettydate, gluon.tools.geocode
gluon.contrib.AuthorizeNet
gluon.contrib.sms_utils
can specify hostname in routes_out (same syntax as routes in)
db.table.bulk_insert([...records...]) now works on GAE
OPTGROUP helper
fake_migrate to restore borken db metadata
x509 emails
attachment and html in Mail on GAE
TAG(html) parese html into helpers (experimental, still some problems
with unicode)
DIV.elements(find=re.compile(....))
DIV.flatten()
DIV.elements('....') supports jQuery syntax in '....'

[Bruno Rocha]

I would like more detailed information about testing, unittest,
docTest. explaining how it works in detail, and showing a good example
of a test using the 'test' in appadmin

2010/7/24 mdipierro <mdip...@cs.depaul.edu>:

--

http://rochacbruno.com.br

[Jonathan Lundell]

http://code.google.com/p/web2py-book/wiki/BookGeneralIssues

[mdipierro]

Thanks. this is very helpful

On Jul 24, 7:57 pm, Jonathan Lundell <jlund...@pobox.com> wrote:
> http://code.google.com/p/web2py-book/wiki/BookGeneralIssues

[Scott]

Cube2py explanation along with examples for all of the widgets and how
to implement. Since we're headed in that direction... :)

[Jeff S]

For new users like me, downloadable packed applications would be great
with each examples in the book. A few times, the examples were not
showing correctly online and the cut&paste on IE browser is not
providing the line feed and carriage return showing online.

Although, the packed applications don't really have to be included in
the book. They could be available anywhere else.

The more I read the book and the more I read the posts in this group,
the more I know I don't know much of Python and web2py. :)

[weheh]

There are also comments embedded directly into the online book. These
should be reviewed and incorporated into the new doc as deemed fit.

[howesc]

I use google app engine a lot, and would love to have mention in the
main content of the book when features won't work on GAE. some are
now, and others are only in the GAE section at the end.

also not everything in
http://groups.google.com/group/web2py/browse_thread/thread/cd89f11de4d23b53/f67faac66a695ca2?lnk=gst&q=google+app+engine+production#f67faac66a695ca2
has made it to the code, so those tips would be nice in the book
(especially the caching of wsgihandler.py - it saves 90% of the
execution time for a simple page).

http://www.web2py.com/AlterEgo/default/show/248 would be great in the
book as well.

thanks!

cfh

[Thadeus Burgess]

Update the deployment section.

I never got the instructions in the book to work without tweaking, so
I think it needs
some fine tuning and references to web2pyslices slice 14, 29, 33, 36,
57, 64

--
Thadeus

[Ramjee Ganti]

Hi,

For people new to web2py like me a section which mentions all the third party libraries that are used in web2py. eg. pyodbc for MSSQL, Mysql conncetor for MYSQL etc. would be great help.

rAm

i Think, i Wait, i Fast -- Siddhartha
http://sodidi.ramjeeganti.com
rAm

i Think, i Wait, i Fast -- Siddhartha
http://sodidi.ramjeeganti.com

[mdipierro]

That is already there at the beginning of chapter 6.

On Jul 26, 3:05 am, Ramjee Ganti <gant...@gmail.com> wrote:
> Hi,
>
> For people new to web2py like me a section which mentions all the third
> party libraries that are used in web2py. eg. pyodbc for MSSQL, Mysql
> conncetor for MYSQL etc. would be great help.
>
> rAm

[Timmie]

Hello,
will the plugin system be documented?

What about isses mentioned in:

New features not documented in PDF book (2 ed)
http://groups.google.com/group/web2py/browse_frm/thread/208cdabdba546cd0?

best regards,
Timmie

[mdipierro]

Here is where we stand: So far I added this:

[x] compute fields
[x] virtual fields
[x] upload separate
[x] crud.search
[x] RPXAccount
[x] new validators
[x] run background tasks
[x] recursive queries
[x] MARKMIN helper
[x] Informix support
[x] named id fields
[x] keyedtables
[x] first() last()
[x] find(), sort(), exclude()
[x] as_dict(), as_list()
[x] request.wsgi
[x] IS_IN_DB(....,_and=....)
[x] python web2py.py -S app -M -R script.py -A arg1 arg2 arg3 (need
example)
[x] New syntax T("%(a)s") % dict(a="hello")
[x] web2py.py -nogui
[x] SQLFORM.factory(...,table_name='no_table')
[x] new setup-web2py-ubuntu.sh
[x] new setup-web2py-fedora.sh
[X] cherrypy to rocket
[x] SQLFORM(...,formstyle='divs')
[x] SQLTABLE(...,headers='fieldname:capitalize')
[x] has_membership(group=...,role=...)
[x] db.define_table(username=True)
[x] gluon.tools.prettydate, gluon.tools.geocode
[x] gluon.contrib.AuthorizeNet
[x] gluon.contrib.sms_utils
[x] db.table.bulk_insert([...records...]) now works on GAE
[x] OPTGROUP helper
[x] recursive queries
[x] x509 emails
[x] attachment and html in Mail on GAE
[x] populate
[x] MARKMIN syntax (added link only)
[x] fake_migrate to restore borken db metadata
[x] TAG(html) parese html into helpers (experimental, still some
problems with unicode)
[x] DIV.elements(find=re.compile(....))
[x] DIV.flatten()
[x] DIV.elements('....') supports jQuery syntax in '....'
[x] pam authentication
[x] autocomplete widget

I.e. about 20 new pages to the manual.

This remains on my TODO list:

[ ] format, represent
[ ] revise chapter 7 including
[ ] new layout
[ ] ez.css
[ ] response.meta
[ ] example of response.files
[ ] new template system from Thedeus with {{block}}
[ ] update list of contributors

[ ] Add a new chapter (13?) (this is the most difficult task!)
[ ] LOAD and generic.load
[ ] plugins and examples

[ ] Follow Jonathan suggestion
http://groups.google.com/group/web2py/browse_thread/thread/cd89f11de4d23b53/f67faac66a695ca2?lnk=gst&q=google+app+engine+production#f67faac66a695ca2
and other GAE issues

[ ] Follow Thedeus suggestion to incorporate some deployment
web2pyslices

On Jul 26, 4:25 am, Timmie <timmichel...@gmx-topmail.de> wrote:
> Hello,
> will the plugin system be documented?
>
> What about isses mentioned in:
>

> New features not documented in PDF book (2 ed)http://groups.google.com/group/web2py/browse_frm/thread/208cdabdba546...

[mdipierro]

P.S. I added this to my provate latex source (after incorporating the
corrections editors posted online). I still need to convert everything
in markmin syntax to post it online... this will take another month
but will make some chapters available for review asap.

> [ ] Follow Jonathan suggestionhttp://groups.google.com/group/web2py/browse_thread/thread/cd89f11de4...

[Nico de Groot]

Info about vitualfields, some links I use:

http://groups.google.com/group/web2py/browse_thread/thread/fa7936be97a82fec

Thadeus' blog about vitual links including lazy fields using a
'inline' function , not working anymore in latest releases
http://thadeusb.com/weblog/2009/12/31/web2py_virtualfields_as_an_orm_an_sqlalchemy_approach

remedy (promote lzy() function to class level)
http://groups.google.com/group/web2py/browse_thread/thread/d91c13e2fb0a1fde

Nico

[mdipierro]

I think the problem is fixed in trunk. can you try?

On Jul 26, 4:51 am, Nico de Groot <ndegr...@chello.nl> wrote:
> Info about vitualfields, some links I use:
>

> http://groups.google.com/group/web2py/browse_thread/thread/fa7936be97...

>
> Thadeus' blog about vitual links including lazy fields using a

> 'inline' function , not working anymore in latest releaseshttp://thadeusb.com/weblog/2009/12/31/web2py_virtualfields_as_an_orm_...
>
> remedy (promote lzy() function to class level)http://groups.google.com/group/web2py/browse_thread/thread/d91c13e2fb...

[Johann Spies]

On 25 July 2010 00:54, Garrafa Pet 2 Litros <garr...@gmail.com> wrote:
> I think it's good to review the section 3.9 that discusses the wiki
> and add documentation of new features found in the plugin wiki.

+1

Regards
Johann

--
    "Be not deceived; God is not mocked: for whatsoever a
     man soweth, that shall he also reap."
                                  Galatians 6:7

[mdipierro]

The fact is the purpose of 3.9 is not to build a wiki but teach web2py
programming. If we use plugin_wiki there users would not learn much.
Moreover plugin_wiki may change after the book is completed therefore
I want to use it as an example of plugin but not suggest its API will
be supported in the same way as web2py APIs are. I was planning to
discuss plugins (and plugin_wiki) in a new chapter13.

On Jul 26, 5:34 am, Johann Spies <johann.sp...@gmail.com> wrote:

[VP]

I think the book needs some work. I'm learning web2py. I like it.
But I feel there are some "mysteries" that have not been explained in
the book. I hope you put a team on the book. Chapter 3 needs to be
thoughtfully expanded.

I saw some usage inconsistencies in examples in Chapter 3, regarding
IS_NOT_IN_DB, for example.

[Iceberg]

On Jul 24, 5:53am, mdipierro <mdipie...@cs.depaul.edu> wrote:
> I am revising the book.
>
> Please list what features are not mentioned in the book or deserve
> more space they correctly get.
> You suggestions will be appreciated.
>
> Massimo

Not sure whether is already mentioned in this 30-post thread, anyway
please include the "parse html" feature. Currently a post is available
here. http://web2py.com/AlterEgo/default/show/266

Iceberg

[Thadeus Burgess]

IS_IN_SET zero changes and how they work and why it is that way now.

--
Thadeus

[Timmie]

Hello,
what date do you target as publishing date?

Best regards,
Timmie

[Timmie]

Hello,
have you tried Pandoc:
http://johnmacfarlane.net/pandoc/

http://johnmacfarlane.net/pandoc/try

If you consider your markup langauge stable, why not submitting it to
the developer of Pandoc?

Regards,
Timmie

[Thadeus Burgess]

And SQLFORM(onvalidate)
--
Thadeus

[mdipierro]

Can you help? I am swamped

[mdipierro]

End of August final.

[Jonathan Lundell]

On Jul 26, 2010, at 9:09 AM, VP wrote:

> I think the book needs some work. I'm learning web2py. I like it.
> But I feel there are some "mysteries" that have not been explained in
> the book. I hope you put a team on the book. Chapter 3 needs to be
> thoughtfully expanded.

The problem with magic is that it's hard to users to apply flexibly until they understand what's going on behind the curtain. I don't think it'd take a *lot* of explanation, but more than we've got now. A minor complication is that dal.py and sql.py aren't quite the same under the sheets. Is a move to dal.py in the near future?