[DOC-SIG] URI Schemes

[Mike Fletcher]

So, anyone got a decent URI scheme for Python elements?  Preferably
something that will handle:

fully-qualified (universally valid) URI's... something like
/mcf/pars/andgrp#AndGrp.consume
/mcf/pars/andgrp
/mcf/pars/orgrp#OrGrp
Basically, should be able to say:
from mcf.pars.andgrp import AndGrp
and then get the correct attribute off AndGrp?
Requires that the processing script know the sys.path under which the files
will be processed, that is, the script needs to know what the root of the
hierarchy is for the sets of 

relative URI's (context sensitive)... something like
#OrGrp.posopt_consume # in same module
./orgrp#OrGrp.consume # method in module in same package
../utils#dummy # module in sibling package
consume # method of class OrGrp
OrGrp.consume # class method of module orgrp
orgrp # module of package pars

...yada

catching broken links (optional)

These obviously aren't the perfect URI schemes, anyone have any better
ones?  We would want them to be easily typed, and hopefully easily
recognised both by the code reader and the system.

Well, off to sleep, enjoy all,
Mike
________________________________
 M i k e   C .  F l e t c h e r

       mcfletch@golden.net
http://www.golden.net/~mcfletch/
________________________________
 Design, Consultation, Training


_______________
DOC-SIG  - SIG for the Python Documentation Project

send messages to: doc-sig@python.org
administrivia to: doc-sig-request@python.org
_______________