r3wp [groups: 83 posts: 189283]
  • Home
  • Script library
  • AltME Archive
  • Mailing list
  • Articles Index
  • Site search
 

World: r3wp

[!REBOL3 Modules] Get help with R3's module system

BrianH
31-Oct-2010
[227]
There are real consequences to whether a module is named or not, 
but both styles are appropriate in different circumstances.
Andreas
31-Oct-2010
[228]
Bad typo: Ah, so you* retract your suggestion.
BrianH
31-Oct-2010
[229x2]
No, named should still be considered the default behavior. Unnamed 
is still exceptional.
If that weren't the case we wouldn't have added the IMPORT word! 
applies the name feature.
Andreas
31-Oct-2010
[231x3]
Well, then I simply observe that you don't want to give a straight 
answer to above question.
Or let's add, E: "Exactly one of A, B, or C", assume you chose E 
and be done with it.
Even the simplest discussions can be surprisingly hard when the means 
of communication are reduced to text.
BrianH
31-Oct-2010
[234x2]
I don't write blogs. If his purpose is to make the module system 
seem simpler than it is, cool. It can be that simple in practice. 
When called from user scripts there is very little difference between 
regular, unnamed or private modules. The context of user scripts 
is isolated, so all the values are copied into it afterall. It doesn't 
really become a big deal unless you are concerned about when words 
are added to the user context, or until we get concurrency going.
It matters a *lot* for modules that are imported into other modules, 
but no blog has mentioned that situation yet.
Andreas
31-Oct-2010
[236]
Hardly worth mentioning until it actually works.
BrianH
31-Oct-2010
[237]
...and is released in its working form. That first part is covered 
already.
Carl
1-Nov-2010
[238]
I've not read the entire discussion... but let's roll back a little.


Andreas, simple things should be simple. A REBOL rule. So some points 
on modules:


1. We've used objects as "a type of module" for many years. Pretty 
easy.


2. The first thing you do is give them a new datatype, calling it 
module!  But, still basically an object. Easy.


3. Next, you make it clear what is exported... with the EXPORT word 
or EXPORTS block in the spec. Still easy.


4. Next, you want the runtime system to help keep track of the module. 
To do that, the module needs at least a name to identify it. Not 
difficult.


From there, you can imagine many other features you might want: versions, 
checksums, compression, dependencies (needs). You can add quite a 
lot. But, the more you add, the more likely it's going to get complicated... 
and few users will understand it, etc. So, for R3, Brian and I agree 
to a design that provided quite a few features without too much code, 
but also kept simple things simple.
Andreas
1-Nov-2010
[239x2]
Agreed on all 4 points. But those are easy.
The devil's in the details.
Carl
1-Nov-2010
[241]
You bet it is.
Andreas
1-Nov-2010
[242x2]
For example, for 4. it would be sufficient to always derive the module 
name from the filename.
Obviously someone decided against that simple solution. And I am 
sure for good reason.
Carl
1-Nov-2010
[244]
The word "sufficient" there isn't quite true.  Explicit naming is 
more powerful... and provides a map as well from name to filename.
Andreas
1-Nov-2010
[245]
The rest of the above banter was just me getting lost in a particular 
question.
Carl
1-Nov-2010
[246x4]
Module systems are always difficult.
Brian and I have both used quite a few... but not really cared much 
for most of them.
A110 will release all the code for the module system, and you can 
browse through it.
There's always room for improvement, but I'm goint to be the complexity 
firewall... because they so often become unusable.
Andreas
1-Nov-2010
[250x3]
If anything, I would aim improvements at simplifying further.
But it's basically impossible to have a sensible discourse about 
this module system without being able to try it out.
It _is_ already far too complex for that.
Pekr
1-Nov-2010
[253x2]
I like the idea of not needing to repeat a name = name the module 
automatically upon the filename. "However, there is a real difference 
between the behavior of named and unnamed modules." - why? Because 
someone said there should be a difference? So just not explicitly 
naming the module means it gets treated the different way? Why? And 
what was the technical reason to decide so?
Of course - auto-naming unnamed module according to filename might 
be tricky - what if file contains more than one module?
Maxim
1-Nov-2010
[255x4]
modules within modules work fine from A108.  I've required this feature 
in CGR.  I am using the named version though (I'm conditioned by 
slim which also makes this the default and simplest use case).
if the module has a name and you rename the file, it should fail, 
which is probably what it does already.
in slim I also added an extension filename, in order to allow import 
by name to work with alternate extensions which is very usefull when 
you want to use the module system as a plugin mechanism for an application.
extension filename  == "filename extension /refinement"
BrianH
1-Nov-2010
[259x4]
Technical reason = because one has a name and the other doesn't. 
I'm not dumbing it down, it really is that simple.


Say you are a module, and I want to import you. It's rather straightforward, 
I just add your exported words to my collection (how I do that depends 
on what I am, but that's a story for another time). And then I can 
use those words, no problem.


But what if I don't know whether you have been imported already? 
Or what if I know you have been imported by someone else, but I want 
to use you in particular instead of someone who just looks like you? 
Or what if you have data that you want to share, or resources that 
can't be used more than once at the same time? Or what if you want 
to know if a previous version of you was imported already, so you 
can get that guy's data or resources and take over for him?


To do all of these things, you need a way for others to refer to 
you, a name. If you have a name, I can put you in a collection with 
other modules and then others can look in that collection for a module 
of that name and if they find one they can know that it's you. Simply 
having some way to find you in a crowd makes all of that stuff possible. 
It really is that simple.
Another trick that I can do if I have a name for you is to just put 
you in a box and then import you later: delayed modules. If you don't 
have a name, I can't find you in that box, you look just like all 
the other delayed modules.
It turns out that every little feature or quirk of the module system 
is there for a reason that is as simple as that. It's just that there 
are a lot of these little situations that pop up when you are writing 
a module system if you want to make it work properly. Especially 
if you want to hide a lot of that complexity from the user, to deal 
with the complexity in the module system itself so the programmer 
using it doesn't have to think about any of that. Simple on the outside 
requires some complexity on the inside.
Carl, how simple would it be to implement REFLECT module! 'title 
? See here: http://www.curecode.org/rebol3/ticket.rsp?id=572(low 
priority still).
BrianH
2-Nov-2010
[263]
As of alpha 110, all tests of the module system pass! Time to write 
more tests :)
Carl
2-Nov-2010
[264x3]
Regarding REFLECT... would store the spec in the module! object. 
There is room for it.
Glad to hear it!
Time to show examples of all of what it can do... and get developers 
using some of this good stuff.
BrianH
2-Nov-2010
[267x2]
The spec is already stored in the module object.
Or what do you mean by spec? The module header returned by SPEC-OF 
is stored in the module object. See here: http://www.curecode.org/rebol3/ticket.rsp?id=1586
Andreas
23-Dec-2010
[269x4]
Let's switch this discussion to where it belongs.
I was referring to my understanding that many module-related things 
are half-broken at the moment.
Last time this came up, you (Brian) seemed to be aware of the problems.
As it seems those issues are forgotten by now, I guess I'll have 
to dig them out again.
BrianH
23-Dec-2010
[273]
No, they were fixed in a110. We had that discussion before a110.
Andreas
23-Dec-2010
[274x2]
No, we had it post A110 and you said "whoops, last-minute errors 
slipped in".
I'm digging ...
BrianH
23-Dec-2010
[276]
That was a109. There was another las-minute error that slipped into 
a110, but it wasn't a module system error, it was a startup error.