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
22-Oct-2010
[137]
There are certain advantages to writing user scripts for the front 
end code:

- The user context will be task-local, so a lot of the multitasking 
problems will go away.

- The user context is shared by all scripts running in the same task. 
It acts like a shared isolated context.

- User scripts have fewer settings in their headers. For that matter, 
they can have no header at all. Every command you enter into the 
command line is a separate script, for instance.
Andreas
22-Oct-2010
[138]
None of those sound like an advantage to me. For the "settings in 
their headers" I'll once again have to punt until I look into the 
module system more closely.
BrianH
22-Oct-2010
[139]
Header settings that affect modules only:
- type: module
- name: blah
- version: 1.0.0
- exports: [...]
- options: [isolate]
- options: [private]
- options: [extension]

More than one option is combined in one block. The rest of the header 
stuff affects scripts too.
Andreas
22-Oct-2010
[140x2]
What's the minimal module header?
REBOL [type: module name: foo] ?
BrianH
22-Oct-2010
[142]
REBOL [type: module]. Or if you are loading it with IMPORT or the 
Needs header, REBOL [].
Andreas
22-Oct-2010
[143]
Well, then that's how it should be :)
BrianH
22-Oct-2010
[144]
Regular modules need a name though. Named modules don't get reloaded 
if you import them more than once, they get reused. There are all 
sorts of tricks you can do with that.
Andreas
22-Oct-2010
[145]
system/contexts/user still refers to the task-local user context?
BrianH
22-Oct-2010
[146x7]
Yup. Or in scripts, you can call it self.
That task-local thing is still a plan though. The code is designed 
with that assumption, but it's not yet true.
Technically, you can import modules with no header at all, though 
not DO them. Extension modules require a header though.
Of course, headers let you do all sorts of tricks that you can't 
do without them. In addition to the above stuff, header settings 
let you:

- Embed scripts in text or binary files, even if it's just documentation 
before the script header.
- Aggregate multiple scripts/modules in one file.
- Save and verify a script/module checksum.
- Compress scripts/modules.
Just double-checked. No, you need at least REBOL [] for all modules, 
extension or not.
Andreas, the (dis)advantage to private modules is that they need 
to be explicitly imported into your module for you to get their exports 
(selective import). For regular modules, you import into the runtime 
library once and it is just there to share. Regular modules can take 
advantage of this to support upgrading themselves in place, for instance, 
or more easily managing word overrides on a global basis; private 
modules can't be upgraded. Each approach has advantages and disadvantages 
in different situations. This is why we support both export models.
The differences between the two are less if you are importing to 
user scripts. Since scripts share a context, subsequent scripts can 
benefit from the effects of modules imported by previous scripts, 
whether they were private or not.
Andreas
22-Oct-2010
[153]
For me that's purely an advantage. Explicitly importing the modules/functions 
you need is how it should be.
BrianH
22-Oct-2010
[154]
There are real downsides to explicit import. Choose what works for 
your situation.
Andreas
22-Oct-2010
[155]
I'm also pretty sure that upgrading "private" modules is possible.
BrianH
22-Oct-2010
[156]
For instance, with explicit import you can't upgrade a running process. 
That can be a disadvantage for some apps.
Andreas
22-Oct-2010
[157x2]
But that doesn't worry me at all, at the moment. If R3 ever reaches 
the stability and maturity that such long-running become realistic, 
then I'll start to worry about in-place upgrades.
such long-running processes*
BrianH
22-Oct-2010
[159x2]
Part of exporting is copying the values to another context, where 
it is used. You don't normally get any references to the original 
module words. And part of importing is copying those words again 
to your own context (for isolated modules and for scripts), or binding 
to the runtime library. So in practice, the only known contexts that 
you can update the values in are your own, the runtime library, and 
the current task's user context. To upgrade other contexts they would 
need to register with you, and you would have to do them one at a 
time.
REBOL processes tend to run for years, if they don't have bugs and 
don't use a buggy REBOL. Do you remember the first mailing list outage?
Andreas
22-Oct-2010
[161x2]
Luckily, we can change allmost all of that.
But this copying you mention should actually make the updates I have 
in mind easier.
BrianH
22-Oct-2010
[163]
If you meant my last long message by "we can change allmost all of 
that" then no, not in the base system. You can work around it in 
your own code though.
Andreas
22-Oct-2010
[164]
As far as I understood the boot levels allow us to get rid of most 
of the default module system alltogether.
BrianH
22-Oct-2010
[165]
Yup. That is one of the workarounds I mentioned.
Andreas
22-Oct-2010
[166x2]
Too good a feature to call it a workaround.
What about the mailing list outage?
BrianH
22-Oct-2010
[168]
You say that having not worked with the module system, but yes, if 
you say so :)
Andreas
22-Oct-2010
[169x2]
I say that having followed the discussion around it and read the 
documentation and posts about it.
And I really appreciate the work you put into it.
BrianH
22-Oct-2010
[171x2]
The first REBOL mailing list outage happened because the server rebooted. 
The REBOL process that was running the mailing list had been started 
manually, and just kept running. They forgot to add the startup code 
for the mailing list to the init code for the server. But noone knew 
this because the process just kept running for more than 3 years. 
It took a UPS failure to stop the list.
That is the kind of runtime that REBOL is designed to support :)
Andreas
22-Oct-2010
[173x2]
Ah yes, the legendary REBOL mailing list script.
Times long gone :)
BrianH
22-Oct-2010
[175x2]
OK, most of the discussion of the new module system so far has been 
in a private world. And the final working system hasn't been released 
yet. And the documentation is outdated. So pardon me if I say that 
you should reserve judgement. But still, being to remove the module 
system with a boot level is a pretty cool feature :)
One which I haven't tested yet :(
Andreas
22-Oct-2010
[177x2]
Because it doesn't work.
At least I couldn't figure out how to call R3 so that it respects 
the boot-level flag.
BrianH
22-Oct-2010
[179x4]
I don't know, I haven't tested it yet.
My first priority was to get the module system working, and fix the 
slight design flaws that the previous system had (mostly the API 
of IMPORT). Boot levels are next.
You'd be shocked at how many significant subtleties are tested for 
in the test code. And that code isn't even complete yet.
It made sense though: It's easier to deliberately not load something 
when you know what you're not loading.
Andreas
22-Oct-2010
[183]
I'd probably not :)
BrianH
22-Oct-2010
[184x2]
Be shocked, I guess. Actually, I was just shocked: The mod-test.r 
file only has 696 lines in it at the moment. I guess this is a testament 
to how compact we can make REBOL scripts with the new system :)
Later! :)
Carl
23-Oct-2010
[186]
Andreas: boot level info is found here:
>> usage

Example:
r3 -b sys


But, this is magic guru stuff because the boot is stopped early, 
which means that most of the nice funcs you depend on are not yet 
alive.