Republic.jl

Dependencies united under one public API.

Republic.jl re-publicizes names from upstream modules, making them part of your module's public API without exporting them into the caller's namespace. Like Reexport.jl, but for Julia's public keyword (introduced in Julia 1.11).

Usage

module MyPackage
    using Republic

    # All of Foo's public and exported names become public in MyPackage.
    # Unlike plain `using Foo`, this also brings in public (non-exported) names
    @republic using Foo

    # Qualified to avoid clutter
    @republic using Foo: bar, baz

    # The alias `F` becomes public in `MyPackage`
    @republic using Foo: Foo as F

    # Only `Bar` gets imported and marked public
    @republic import Bar

    # `baz` can be extended within MyPackage, and is marked public
    @republic import Bar: baz

    # Blocks
    @republic begin
        using Foo
        using Bar
    end
end

Names re-publicized in MyPackage become accessible via qualified access (MyPackage.bar) without being brought into scope by using MyPackage. This is useful for packages that want to conveniently expose a broad API surface from different packages without polluting the caller's namespace.

The main use case for re-publicizing is lightweight "Core" or "Base" packages — like StaticArraysCore, EnzymeCore, and ManifoldsBase — whose types and functions you want to surface as part of your package's API. This also works for heavier packages whose interfaces you may be implementing, but make sure to @republic a qualified import to avoid clutter!

Re-exporting

By default, @republic makes everything public. To also re-export names that were exported upstream, use reexport=true:

@republic reexport=true using Foo

With reexport=true, exported names are re-exported (like Reexport.jl), and public-only names are marked public. Republic never promotes a public-only name to exported — that is a deliberate choice left to the user (see below).

Overriding visibility

Julia does not allow a name to be marked with both public and export. This only matters if a name is public upstream but you want to export it in your module. To export a public-only name, declare the export before @republic:

module MyPackage
    using Republic
    export bar            # bar will be exported, not just public
    @republic using Foo   # skips `public` for bar since it's already exported
end

Alternatively, use qualified imports to keep @republic and export separate:

module MyPackage
    using Republic
    using Foo: bar
    export bar
    @republic using Foo: baz, qux  # only these become public
end

Acknowledgments

Republic.jl is derived from Reexport.jl by Simon Kornblith (MIT License).