Paquetes y módulos¶

Nivel de visibilidad de un módulo¶

Un paquete en Ceylon puede ser compartido o no compartido. Un módulo no compartido (Por defecto) es visible únicamente a el módulo que contiene el paquete. Podemos crear un paquete compartido proveiendo un descriptor del paquete.

"The typesafe query API."
shared package org.hibernate.query;

Un paquete shared define parte de la API public de el módulo. Así otros módulos pueden acceder a las declaraciones compartidas en un paquete shared.

En tiempo de ejecucuón el paquete es representado por un atributo Package top level llamado package.

Descriptor de módulo¶

Un módulo deberá especificar explícitamente los módulos de los que depende. Esto es logrado a través de un descriptor de módulo.

"The best-ever ORM solution"
license "http://www.gnu.org/licenses/lgpl.html"
module org.hibernate '3.0.0.beta' {
    shared import ceylon.language '1.0.1';
    import java.sql '4.0';
}

En tiempo de ejecución un módulo es representado por un atributo Module top level llamado module.

Archivos módulo y repositorio de módulos¶

Un paquete de archivos compilan a archivos .class, los descriptores de paquetes y módulos en un estilo Java a un archivo jar con la extensión .car. El compilador de Ceylon usualmente no produce archivos .class individuales en un directorio. En vez de ello, produce archivos módulo.

Archivos módulo se encuentran en un repositorio de módulos. Un repositorio de módulos es una estructura de directorio bien definida con un bien definido lugar para cada módulo. Un repositorio de módulos puede ser local(en un sistema de archivos) o remoto (en internet). Dada una lista de repositorios de módulos, el compilador de Ceylon puede localizar las dependencias mencionada en el descriptor del módulo cuando se compila. Y cuando termina la compilación del módulo, el coloca al archivo del módulo resultante en un lugar correcto en el repositorio local. La arquitectura también incluye soporte para directorios fuente, archivos de código, directorios de documentación del módulo.

Desarrollando módulos en la IDE de Ceylon¶

Para empezar con los módulos en la ide de Ceylon, ve a Help > Cheat Sheets..., abre el objeto Ceylon y corre el cheat sheet Introduction to Ceylon Modules, que te guiara paso a paso a través del proceso de crear un módulo, definiendo sus dependencias y exportando su repositorio de módulos.

README
source/
    net/
        example/
            foo/
                Foo.ceylon
                FooService.ceylon
                module.ceylon
documentation/
    manual.html

$ ceylon compile net.example.foo

README
source/
    net/
        example/
            foo/
                Foo.ceylon
                FooService.ceylon
                module.ceylon
modules/
    net/
        example/
            foo/
                1.0/
                    net.example.foo-1.0.car
                    net.example.foo-1.0.car.sha1
                    net.example.foo-1.0.src
                    net.example.foo-1.0.src.sha1
documentation/
    manual.html

$ ceylon doc net.example.foo

$ ceylon compile net.example.foo

$ ceylon compile net.example.foo

$ ceylon compile --rep          \
        http://repo.example.com \
        net.example.foo

$ ceylon compile                               \
        --rep http://repo.example.com          \
        --out http://ceylon.example.net/repo   \
        net.example.foo

Ejemplo: Corriendo un repositorio local o remoto¶

Vamos a continuar el ejemplo que teníamos donde net.example.foo versión 1.0 fue publicado to http://ceylon.example.net/repo. Ahora, supongamos que quieres correr el módulo(posiblemente desde otra computadora).

Si la dependencias (com.example.bar/3.1.4) pueden ser encontrada en los repositorios por defecto el comando para ceylon run es:

$ ceylon run                              \
    --rep http://ceylon.example.net/repo  \
    net.example.foo/1.0

Puedes pasar opciones también (que son disponibles al programa a través del objeto top level process):

$ ceylon run                              \
    --rep http://ceylon.example.net/repo  \
    net.example.foo/1.0                   \
    my options

Si una de las dependencias no esta disponible desde los repositorios, deberás de especificar un repositorio que las contenga usando otro rep:

$ ceylon run                             \
    --rep http://ceylon.example.net/repo \
    --rep http://repo.example.com        \
    net.example.foo/1.0                  \
    my options

El caso mas simple, es donde el módulo y sus dependencias están todos en uno (o mas) de los repositorios por defecto (tales como Herd o ~/.ceylon.repo).

$ ceylon run net.example.foo/1.0

Ecosistema del repositorio de módulos¶

Una de las ventajas mas agradables de esta arquitectura es que es posible corren un módulo “directamente desde internet”, solo tecleando, por ejemplo:

$ ceylon run --rep http://jboss.org/ceylon/modules org.jboss.ceylon.demo/1.0

Y todas las dependencias requeridas son automáticamente descargada como se necesiten.

Ceylon Herd es una es una comunidad de repositorios de módulos donde cualquiera puede contribuir reusando módulos. Por supuesto, el formato de repositorio de módulos es un standard abierto, así cualquier organización puede mantener su repositorio de módulos publico.

Aun hay mas¶

En la siguiente estación veremos el soporte de Ceylon para funciones de orden superior.