Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
81 changes: 44 additions & 37 deletions dash/development/_jl_components_generation.py
Original file line numberDiff line numberDiff line change
Expand Up@@ -13,6 +13,9 @@
from ._all_keywords import julia_keywords
from ._py_components_generation import reorder_props

# uuid of DashBase Julia package.
jl_dash_base_uuid = "03207cf0-e2b3-4b91-9ca8-690cf0fb507e"

# uuid of Dash Julia package. Used as base for component package uuid
jl_dash_uuid = "1b08a953-4be3-4667-9a23-3db579824955"

Expand All@@ -23,59 +26,48 @@
export {funcname}

"""
{funcname}(;kwargs...)
{funcname}(children::Any;kwargs...)
{funcname}(children_maker::Function;kwargs...)
{funcname}(;kwargs...){children_signatures}

{docstring}
"""
function {funcname}(; kwargs...)
available_props = Set(Symbol[{component_props}])
wild_props = Set(Symbol[{wildcard_symbols}])
wild_regs = r"^(?<prop>{wildcard_names})"

result = Component("{element_name}", "{module_name}", Dict{{Symbol, Any}}(), available_props, Set(Symbol[{wildcard_symbols}]))

for (prop, value) = pairs(kwargs)
m = match(wild_regs, string(prop))
if (length(wild_props) == 0 || isnothing(m)) && !(prop in available_props)
throw(ArgumentError("Invalid property $(string(prop)) for component " * "{funcname}"))
end

push!(result.props, prop => Front.to_dash(value))
end

return result
available_props = Symbol[{component_props}]
wild_props = Symbol[{wildcard_symbols}]
return Component("{funcname}", "{element_name}", "{module_name}", available_props, wild_props; kwargs...)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FWIW on the Python side we could have used only kwargs like this but we chose to insert all the prop names explicitly in the signature (except wildcards of course) because it helps with autocompletion in IDEs. I have no idea if similar functionality exists in Julia, and anyway even if we do want to do this we can add it later.

end
{children_definitions}
''' # noqa:E501

function {funcname}(children::Any; kwargs...)
result = {funcname}(;kwargs...)
push!(result.props, :children => Front.to_dash(children))
return result
end
jl_children_signatures = '''
{funcname}(children::Any;kwargs...)
{funcname}(children_maker::Function;kwargs...)
'''

jl_children_definitions = '''
{funcname}(children::Any; kwargs...) = {funcname}(;kwargs..., children = children)
{funcname}(children_maker::Function; kwargs...) = {funcname}(children_maker(); kwargs...)
''' # noqa:E501
'''

jl_package_file_string = '''
module {package_name}
using Dash
using {base_package}

const resources_path = realpath(joinpath( @__DIR__, "..", "deps"))
const version = "{version}"

{component_includes}

function __init__()
Dash.register_package(
Dash.ResourcePkg(
DashBase.register_package(
DashBase.ResourcePkg(

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not new here, but is it important that this be two nested calls? Could it be refactored to just:

DashBase.register_package(
"{project_shortname}",
resources_path,
version = version,
[
{resources_dist}
]
)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@waralex points out we can do this later - not a major issue anyway.

"{project_shortname}",
resources_path,
version = version,
[
{resources_dist}
]
)

)
end
end
Expand All@@ -87,23 +79,24 @@
{authors}version = "{version}"

[deps]
Dash = "{dash_uuid}"
{base_package} = "{dash_uuid}"

[compact]
julia = "1.1"
Dash = ">=0.1"
julia = "1.2"
{base_package} = ">=0.1"
'''

jl_component_include_string = 'include("{name}.jl")'

jl_resource_tuple_string = '''Dash.Resource(
jl_resource_tuple_string = '''DashBase.Resource(
relative_package_path = {relative_package_path},
external_url = {external_url},
dynamic = {dynamic},
async = {async_string},
type = :{type}
)'''

core_packages = ['dash_html_components', 'dash_core_components', 'dash_table']

def jl_package_name(namestring):
s = namestring.split("_")
Expand DownExpand Up@@ -370,6 +363,14 @@ def nothing_or_string(v):
else 'nothing'
) for resource in resources]

def is_core_package(project_shortname):
return project_shortname in core_packages

def base_package_name(project_shortname):
return "DashBase" if is_core_package(project_shortname) else "Dash"

def base_package_uid(project_shortname):
return jl_dash_base_uuid if is_core_package(project_shortname) else jl_base_uuid

def generate_package_file(project_shortname, components, pkg_data, prefix):
package_name = jl_package_name(project_shortname)
Expand All@@ -391,15 +392,15 @@ def generate_package_file(project_shortname, components, pkg_data, prefix):
),
resources_dist=resources_dist,
version=project_ver,
project_shortname=project_shortname
project_shortname=project_shortname,
base_package=base_package_name(project_shortname)

)
file_path = os.path.join("src", package_name + ".jl")
with open(file_path, "w") as f:
f.write(package_string)
print("Generated {}".format(file_path))


def generate_toml_file(project_shortname, pkg_data):
package_author = pkg_data.get("author", "")
project_ver = pkg_data.get("version")
Expand All@@ -414,14 +415,14 @@ def generate_toml_file(project_shortname, pkg_data):
package_uuid=package_uuid,
version=project_ver,
authors=authors_string,
dash_uuid=jl_dash_uuid
base_package=base_package_name(project_shortname),
dash_uuid=base_package_uid(project_shortname),
)
file_path = "Project.toml"
with open(file_path, "w") as f:
f.write(toml_string)
print("Generated {}".format(file_path))


def generate_class_string(name, props, description, project_shortname, prefix):
# Ensure props are ordered with children first
filtered_props = reorder_props(filter_props(props))
Expand All@@ -430,7 +431,7 @@ def generate_class_string(name, props, description, project_shortname, prefix):

docstring = create_docstring_jl(
component_name=name, props=filtered_props, description=description
).replace("\r\n", "\n")
).replace("\r\n", "\n").replace('$', '\$')

wclist = get_wildcards_jl(props)
default_paramtext = ""
Expand All@@ -453,6 +454,10 @@ def generate_class_string(name, props, description, project_shortname, prefix):
for p in prop_keys
)

has_children = "children" in prop_keys
funcname = format_fn_name(prefix, name)
children_signatures = jl_children_signatures.format(funcname=funcname) if has_children else ""
children_definitions = jl_children_definitions.format(funcname=funcname) if has_children else ""
return jl_component_string.format(
funcname=format_fn_name(prefix, name),
docstring=docstring,
Expand All@@ -461,6 +466,8 @@ def generate_class_string(name, props, description, project_shortname, prefix):
wildcard_names=stringify_wildcards(wclist, no_symbol=True),
element_name=name,
module_name=project_shortname,
children_signatures = children_signatures,
children_definitions = children_definitions
)


Expand Down
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
81 changes: 44 additions & 37 deletions dash/development/_jl_components_generation.py
Original file line numberDiff line numberDiff line change
Expand Up@@ -13,6 +13,9 @@
from ._all_keywords import julia_keywords
from ._py_components_generation import reorder_props

# uuid of DashBase Julia package.
jl_dash_base_uuid = "03207cf0-e2b3-4b91-9ca8-690cf0fb507e"

# uuid of Dash Julia package. Used as base for component package uuid
jl_dash_uuid = "1b08a953-4be3-4667-9a23-3db579824955"

Expand All@@ -23,59 +26,48 @@
export {funcname}

"""
{funcname}(;kwargs...)
{funcname}(children::Any;kwargs...)
{funcname}(children_maker::Function;kwargs...)
{funcname}(;kwargs...){children_signatures}

{docstring}
"""
function {funcname}(; kwargs...)
available_props = Set(Symbol[{component_props}])
wild_props = Set(Symbol[{wildcard_symbols}])
wild_regs = r"^(?<prop>{wildcard_names})"

result = Component("{element_name}", "{module_name}", Dict{{Symbol, Any}}(), available_props, Set(Symbol[{wildcard_symbols}]))

for (prop, value) = pairs(kwargs)
m = match(wild_regs, string(prop))
if (length(wild_props) == 0 || isnothing(m)) && !(prop in available_props)
throw(ArgumentError("Invalid property $(string(prop)) for component " * "{funcname}"))
end

push!(result.props, prop => Front.to_dash(value))
end

return result
available_props = Symbol[{component_props}]
wild_props = Symbol[{wildcard_symbols}]
return Component("{funcname}", "{element_name}", "{module_name}", available_props, wild_props; kwargs...)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FWIW on the Python side we could have used only kwargs like this but we chose to insert all the prop names explicitly in the signature (except wildcards of course) because it helps with autocompletion in IDEs. I have no idea if similar functionality exists in Julia, and anyway even if we do want to do this we can add it later.

end
{children_definitions}
''' # noqa:E501

function {funcname}(children::Any; kwargs...)
result = {funcname}(;kwargs...)
push!(result.props, :children => Front.to_dash(children))
return result
end
jl_children_signatures = '''
{funcname}(children::Any;kwargs...)
{funcname}(children_maker::Function;kwargs...)
'''

jl_children_definitions = '''
{funcname}(children::Any; kwargs...) = {funcname}(;kwargs..., children = children)
{funcname}(children_maker::Function; kwargs...) = {funcname}(children_maker(); kwargs...)
''' # noqa:E501
'''

jl_package_file_string = '''
module {package_name}
using Dash
using {base_package}

const resources_path = realpath(joinpath( @__DIR__, "..", "deps"))
const version = "{version}"

{component_includes}

function __init__()
Dash.register_package(
Dash.ResourcePkg(
DashBase.register_package(
DashBase.ResourcePkg(

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not new here, but is it important that this be two nested calls? Could it be refactored to just:

DashBase.register_package(
"{project_shortname}",
resources_path,
version = version,
[
{resources_dist}
]
)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@waralex points out we can do this later - not a major issue anyway.

"{project_shortname}",
resources_path,
version = version,
[
{resources_dist}
]
)

)
end
end
Expand All@@ -87,23 +79,24 @@
{authors}version = "{version}"

[deps]
Dash = "{dash_uuid}"
{base_package} = "{dash_uuid}"

[compact]
julia = "1.1"
Dash = ">=0.1"
julia = "1.2"
{base_package} = ">=0.1"
'''

jl_component_include_string = 'include("{name}.jl")'

jl_resource_tuple_string = '''Dash.Resource(
jl_resource_tuple_string = '''DashBase.Resource(
relative_package_path = {relative_package_path},
external_url = {external_url},
dynamic = {dynamic},
async = {async_string},
type = :{type}
)'''

core_packages = ['dash_html_components', 'dash_core_components', 'dash_table']

def jl_package_name(namestring):
s = namestring.split("_")
Expand DownExpand Up@@ -370,6 +363,14 @@ def nothing_or_string(v):
else 'nothing'
) for resource in resources]

def is_core_package(project_shortname):
return project_shortname in core_packages

def base_package_name(project_shortname):
return "DashBase" if is_core_package(project_shortname) else "Dash"

def base_package_uid(project_shortname):
return jl_dash_base_uuid if is_core_package(project_shortname) else jl_base_uuid

def generate_package_file(project_shortname, components, pkg_data, prefix):
package_name = jl_package_name(project_shortname)
Expand All@@ -391,15 +392,15 @@ def generate_package_file(project_shortname, components, pkg_data, prefix):
),
resources_dist=resources_dist,
version=project_ver,
project_shortname=project_shortname
project_shortname=project_shortname,
base_package=base_package_name(project_shortname)

)
file_path = os.path.join("src", package_name + ".jl")
with open(file_path, "w") as f:
f.write(package_string)
print("Generated {}".format(file_path))


def generate_toml_file(project_shortname, pkg_data):
package_author = pkg_data.get("author", "")
project_ver = pkg_data.get("version")
Expand All@@ -414,14 +415,14 @@ def generate_toml_file(project_shortname, pkg_data):
package_uuid=package_uuid,
version=project_ver,
authors=authors_string,
dash_uuid=jl_dash_uuid
base_package=base_package_name(project_shortname),
dash_uuid=base_package_uid(project_shortname),
)
file_path = "Project.toml"
with open(file_path, "w") as f:
f.write(toml_string)
print("Generated {}".format(file_path))


def generate_class_string(name, props, description, project_shortname, prefix):
# Ensure props are ordered with children first
filtered_props = reorder_props(filter_props(props))
Expand All@@ -430,7 +431,7 @@ def generate_class_string(name, props, description, project_shortname, prefix):

docstring = create_docstring_jl(
component_name=name, props=filtered_props, description=description
).replace("\r\n", "\n")
).replace("\r\n", "\n").replace('$', '\$')

wclist = get_wildcards_jl(props)
default_paramtext = ""
Expand All@@ -453,6 +454,10 @@ def generate_class_string(name, props, description, project_shortname, prefix):
for p in prop_keys
)

has_children = "children" in prop_keys
funcname = format_fn_name(prefix, name)
children_signatures = jl_children_signatures.format(funcname=funcname) if has_children else ""
children_definitions = jl_children_definitions.format(funcname=funcname) if has_children else ""
return jl_component_string.format(
funcname=format_fn_name(prefix, name),
docstring=docstring,
Expand All@@ -461,6 +466,8 @@ def generate_class_string(name, props, description, project_shortname, prefix):
wildcard_names=stringify_wildcards(wclist, no_symbol=True),
element_name=name,
module_name=project_shortname,
children_signatures = children_signatures,
children_definitions = children_definitions
)


Expand Down
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
81 changes: 44 additions & 37 deletions dash/development/_jl_components_generation.py
Original file line numberDiff line numberDiff line change
Expand Up@@ -13,6 +13,9 @@
from ._all_keywords import julia_keywords
from ._py_components_generation import reorder_props

# uuid of DashBase Julia package.
jl_dash_base_uuid = "03207cf0-e2b3-4b91-9ca8-690cf0fb507e"

# uuid of Dash Julia package. Used as base for component package uuid
jl_dash_uuid = "1b08a953-4be3-4667-9a23-3db579824955"

Expand All@@ -23,59 +26,48 @@
export {funcname}

"""
{funcname}(;kwargs...)
{funcname}(children::Any;kwargs...)
{funcname}(children_maker::Function;kwargs...)
{funcname}(;kwargs...){children_signatures}

{docstring}
"""
function {funcname}(; kwargs...)
available_props = Set(Symbol[{component_props}])
wild_props = Set(Symbol[{wildcard_symbols}])
wild_regs = r"^(?<prop>{wildcard_names})"

result = Component("{element_name}", "{module_name}", Dict{{Symbol, Any}}(), available_props, Set(Symbol[{wildcard_symbols}]))

for (prop, value) = pairs(kwargs)
m = match(wild_regs, string(prop))
if (length(wild_props) == 0 || isnothing(m)) && !(prop in available_props)
throw(ArgumentError("Invalid property $(string(prop)) for component " * "{funcname}"))
end

push!(result.props, prop => Front.to_dash(value))
end

return result
available_props = Symbol[{component_props}]
wild_props = Symbol[{wildcard_symbols}]
return Component("{funcname}", "{element_name}", "{module_name}", available_props, wild_props; kwargs...)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FWIW on the Python side we could have used only kwargs like this but we chose to insert all the prop names explicitly in the signature (except wildcards of course) because it helps with autocompletion in IDEs. I have no idea if similar functionality exists in Julia, and anyway even if we do want to do this we can add it later.

end
{children_definitions}
''' # noqa:E501

function {funcname}(children::Any; kwargs...)
result = {funcname}(;kwargs...)
push!(result.props, :children => Front.to_dash(children))
return result
end
jl_children_signatures = '''
{funcname}(children::Any;kwargs...)
{funcname}(children_maker::Function;kwargs...)
'''

jl_children_definitions = '''
{funcname}(children::Any; kwargs...) = {funcname}(;kwargs..., children = children)
{funcname}(children_maker::Function; kwargs...) = {funcname}(children_maker(); kwargs...)
''' # noqa:E501
'''

jl_package_file_string = '''
module {package_name}
using Dash
using {base_package}

const resources_path = realpath(joinpath( @__DIR__, "..", "deps"))
const version = "{version}"

{component_includes}

function __init__()
Dash.register_package(
Dash.ResourcePkg(
DashBase.register_package(
DashBase.ResourcePkg(

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not new here, but is it important that this be two nested calls? Could it be refactored to just:

DashBase.register_package(
"{project_shortname}",
resources_path,
version = version,
[
{resources_dist}
]
)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@waralex points out we can do this later - not a major issue anyway.

"{project_shortname}",
resources_path,
version = version,
[
{resources_dist}
]
)

)
end
end
Expand All@@ -87,23 +79,24 @@
{authors}version = "{version}"

[deps]
Dash = "{dash_uuid}"
{base_package} = "{dash_uuid}"

[compact]
julia = "1.1"
Dash = ">=0.1"
julia = "1.2"
{base_package} = ">=0.1"
'''

jl_component_include_string = 'include("{name}.jl")'

jl_resource_tuple_string = '''Dash.Resource(
jl_resource_tuple_string = '''DashBase.Resource(
relative_package_path = {relative_package_path},
external_url = {external_url},
dynamic = {dynamic},
async = {async_string},
type = :{type}
)'''

core_packages = ['dash_html_components', 'dash_core_components', 'dash_table']

def jl_package_name(namestring):
s = namestring.split("_")
Expand DownExpand Up@@ -370,6 +363,14 @@ def nothing_or_string(v):
else 'nothing'
) for resource in resources]

def is_core_package(project_shortname):
return project_shortname in core_packages

def base_package_name(project_shortname):
return "DashBase" if is_core_package(project_shortname) else "Dash"

def base_package_uid(project_shortname):
return jl_dash_base_uuid if is_core_package(project_shortname) else jl_base_uuid

def generate_package_file(project_shortname, components, pkg_data, prefix):
package_name = jl_package_name(project_shortname)
Expand All@@ -391,15 +392,15 @@ def generate_package_file(project_shortname, components, pkg_data, prefix):
),
resources_dist=resources_dist,
version=project_ver,
project_shortname=project_shortname
project_shortname=project_shortname,
base_package=base_package_name(project_shortname)

)
file_path = os.path.join("src", package_name + ".jl")
with open(file_path, "w") as f:
f.write(package_string)
print("Generated {}".format(file_path))


def generate_toml_file(project_shortname, pkg_data):
package_author = pkg_data.get("author", "")
project_ver = pkg_data.get("version")
Expand All@@ -414,14 +415,14 @@ def generate_toml_file(project_shortname, pkg_data):
package_uuid=package_uuid,
version=project_ver,
authors=authors_string,
dash_uuid=jl_dash_uuid
base_package=base_package_name(project_shortname),
dash_uuid=base_package_uid(project_shortname),
)
file_path = "Project.toml"
with open(file_path, "w") as f:
f.write(toml_string)
print("Generated {}".format(file_path))


def generate_class_string(name, props, description, project_shortname, prefix):
# Ensure props are ordered with children first
filtered_props = reorder_props(filter_props(props))
Expand All@@ -430,7 +431,7 @@ def generate_class_string(name, props, description, project_shortname, prefix):

docstring = create_docstring_jl(
component_name=name, props=filtered_props, description=description
).replace("\r\n", "\n")
).replace("\r\n", "\n").replace('$', '\$')

wclist = get_wildcards_jl(props)
default_paramtext = ""
Expand All@@ -453,6 +454,10 @@ def generate_class_string(name, props, description, project_shortname, prefix):
for p in prop_keys
)

has_children = "children" in prop_keys
funcname = format_fn_name(prefix, name)
children_signatures = jl_children_signatures.format(funcname=funcname) if has_children else ""
children_definitions = jl_children_definitions.format(funcname=funcname) if has_children else ""
return jl_component_string.format(
funcname=format_fn_name(prefix, name),
docstring=docstring,
Expand All@@ -461,6 +466,8 @@ def generate_class_string(name, props, description, project_shortname, prefix):
wildcard_names=stringify_wildcards(wclist, no_symbol=True),
element_name=name,
module_name=project_shortname,
children_signatures = children_signatures,
children_definitions = children_definitions
)


Expand Down
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
81 changes: 44 additions & 37 deletions dash/development/_jl_components_generation.py
Original file line numberDiff line numberDiff line change
Expand Up@@ -13,6 +13,9 @@
from ._all_keywords import julia_keywords
from ._py_components_generation import reorder_props

# uuid of DashBase Julia package.
jl_dash_base_uuid = "03207cf0-e2b3-4b91-9ca8-690cf0fb507e"

# uuid of Dash Julia package. Used as base for component package uuid
jl_dash_uuid = "1b08a953-4be3-4667-9a23-3db579824955"

Expand All@@ -23,59 +26,48 @@
export {funcname}

"""
{funcname}(;kwargs...)
{funcname}(children::Any;kwargs...)
{funcname}(children_maker::Function;kwargs...)
{funcname}(;kwargs...){children_signatures}

{docstring}
"""
function {funcname}(; kwargs...)
available_props = Set(Symbol[{component_props}])
wild_props = Set(Symbol[{wildcard_symbols}])
wild_regs = r"^(?<prop>{wildcard_names})"

result = Component("{element_name}", "{module_name}", Dict{{Symbol, Any}}(), available_props, Set(Symbol[{wildcard_symbols}]))

for (prop, value) = pairs(kwargs)
m = match(wild_regs, string(prop))
if (length(wild_props) == 0 || isnothing(m)) && !(prop in available_props)
throw(ArgumentError("Invalid property $(string(prop)) for component " * "{funcname}"))
end

push!(result.props, prop => Front.to_dash(value))
end

return result
available_props = Symbol[{component_props}]
wild_props = Symbol[{wildcard_symbols}]
return Component("{funcname}", "{element_name}", "{module_name}", available_props, wild_props; kwargs...)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FWIW on the Python side we could have used only kwargs like this but we chose to insert all the prop names explicitly in the signature (except wildcards of course) because it helps with autocompletion in IDEs. I have no idea if similar functionality exists in Julia, and anyway even if we do want to do this we can add it later.

end
{children_definitions}
''' # noqa:E501

function {funcname}(children::Any; kwargs...)
result = {funcname}(;kwargs...)
push!(result.props, :children => Front.to_dash(children))
return result
end
jl_children_signatures = '''
{funcname}(children::Any;kwargs...)
{funcname}(children_maker::Function;kwargs...)
'''

jl_children_definitions = '''
{funcname}(children::Any; kwargs...) = {funcname}(;kwargs..., children = children)
{funcname}(children_maker::Function; kwargs...) = {funcname}(children_maker(); kwargs...)
''' # noqa:E501
'''

jl_package_file_string = '''
module {package_name}
using Dash
using {base_package}

const resources_path = realpath(joinpath( @__DIR__, "..", "deps"))
const version = "{version}"

{component_includes}

function __init__()
Dash.register_package(
Dash.ResourcePkg(
DashBase.register_package(
DashBase.ResourcePkg(

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not new here, but is it important that this be two nested calls? Could it be refactored to just:

DashBase.register_package(
"{project_shortname}",
resources_path,
version = version,
[
{resources_dist}
]
)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@waralex points out we can do this later - not a major issue anyway.

"{project_shortname}",
resources_path,
version = version,
[
{resources_dist}
]
)

)
end
end
Expand All@@ -87,23 +79,24 @@
{authors}version = "{version}"

[deps]
Dash = "{dash_uuid}"
{base_package} = "{dash_uuid}"

[compact]
julia = "1.1"
Dash = ">=0.1"
julia = "1.2"
{base_package} = ">=0.1"
'''

jl_component_include_string = 'include("{name}.jl")'

jl_resource_tuple_string = '''Dash.Resource(
jl_resource_tuple_string = '''DashBase.Resource(
relative_package_path = {relative_package_path},
external_url = {external_url},
dynamic = {dynamic},
async = {async_string},
type = :{type}
)'''

core_packages = ['dash_html_components', 'dash_core_components', 'dash_table']

def jl_package_name(namestring):
s = namestring.split("_")
Expand DownExpand Up@@ -370,6 +363,14 @@ def nothing_or_string(v):
else 'nothing'
) for resource in resources]

def is_core_package(project_shortname):
return project_shortname in core_packages

def base_package_name(project_shortname):
return "DashBase" if is_core_package(project_shortname) else "Dash"

def base_package_uid(project_shortname):
return jl_dash_base_uuid if is_core_package(project_shortname) else jl_base_uuid

def generate_package_file(project_shortname, components, pkg_data, prefix):
package_name = jl_package_name(project_shortname)
Expand All@@ -391,15 +392,15 @@ def generate_package_file(project_shortname, components, pkg_data, prefix):
),
resources_dist=resources_dist,
version=project_ver,
project_shortname=project_shortname
project_shortname=project_shortname,
base_package=base_package_name(project_shortname)

)
file_path = os.path.join("src", package_name + ".jl")
with open(file_path, "w") as f:
f.write(package_string)
print("Generated {}".format(file_path))


def generate_toml_file(project_shortname, pkg_data):
package_author = pkg_data.get("author", "")
project_ver = pkg_data.get("version")
Expand All@@ -414,14 +415,14 @@ def generate_toml_file(project_shortname, pkg_data):
package_uuid=package_uuid,
version=project_ver,
authors=authors_string,
dash_uuid=jl_dash_uuid
base_package=base_package_name(project_shortname),
dash_uuid=base_package_uid(project_shortname),
)
file_path = "Project.toml"
with open(file_path, "w") as f:
f.write(toml_string)
print("Generated {}".format(file_path))


def generate_class_string(name, props, description, project_shortname, prefix):
# Ensure props are ordered with children first
filtered_props = reorder_props(filter_props(props))
Expand All@@ -430,7 +431,7 @@ def generate_class_string(name, props, description, project_shortname, prefix):

docstring = create_docstring_jl(
component_name=name, props=filtered_props, description=description
).replace("\r\n", "\n")
).replace("\r\n", "\n").replace('$', '\$')

wclist = get_wildcards_jl(props)
default_paramtext = ""
Expand All@@ -453,6 +454,10 @@ def generate_class_string(name, props, description, project_shortname, prefix):
for p in prop_keys
)

has_children = "children" in prop_keys
funcname = format_fn_name(prefix, name)
children_signatures = jl_children_signatures.format(funcname=funcname) if has_children else ""
children_definitions = jl_children_definitions.format(funcname=funcname) if has_children else ""
return jl_component_string.format(
funcname=format_fn_name(prefix, name),
docstring=docstring,
Expand All@@ -461,6 +466,8 @@ def generate_class_string(name, props, description, project_shortname, prefix):
wildcard_names=stringify_wildcards(wclist, no_symbol=True),
element_name=name,
module_name=project_shortname,
children_signatures = children_signatures,
children_definitions = children_definitions
)


Expand Down
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
81 changes: 44 additions & 37 deletions dash/development/_jl_components_generation.py
Original file line numberDiff line numberDiff line change
Expand Up@@ -13,6 +13,9 @@
from ._all_keywords import julia_keywords
from ._py_components_generation import reorder_props

# uuid of DashBase Julia package.
jl_dash_base_uuid = "03207cf0-e2b3-4b91-9ca8-690cf0fb507e"

# uuid of Dash Julia package. Used as base for component package uuid
jl_dash_uuid = "1b08a953-4be3-4667-9a23-3db579824955"

Expand All@@ -23,59 +26,48 @@
export {funcname}

"""
{funcname}(;kwargs...)
{funcname}(children::Any;kwargs...)
{funcname}(children_maker::Function;kwargs...)
{funcname}(;kwargs...){children_signatures}

{docstring}
"""
function {funcname}(; kwargs...)
available_props = Set(Symbol[{component_props}])
wild_props = Set(Symbol[{wildcard_symbols}])
wild_regs = r"^(?<prop>{wildcard_names})"

result = Component("{element_name}", "{module_name}", Dict{{Symbol, Any}}(), available_props, Set(Symbol[{wildcard_symbols}]))

for (prop, value) = pairs(kwargs)
m = match(wild_regs, string(prop))
if (length(wild_props) == 0 || isnothing(m)) && !(prop in available_props)
throw(ArgumentError("Invalid property $(string(prop)) for component " * "{funcname}"))
end

push!(result.props, prop => Front.to_dash(value))
end

return result
available_props = Symbol[{component_props}]
wild_props = Symbol[{wildcard_symbols}]
return Component("{funcname}", "{element_name}", "{module_name}", available_props, wild_props; kwargs...)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FWIW on the Python side we could have used only kwargs like this but we chose to insert all the prop names explicitly in the signature (except wildcards of course) because it helps with autocompletion in IDEs. I have no idea if similar functionality exists in Julia, and anyway even if we do want to do this we can add it later.

end
{children_definitions}
''' # noqa:E501

function {funcname}(children::Any; kwargs...)
result = {funcname}(;kwargs...)
push!(result.props, :children => Front.to_dash(children))
return result
end
jl_children_signatures = '''
{funcname}(children::Any;kwargs...)
{funcname}(children_maker::Function;kwargs...)
'''

jl_children_definitions = '''
{funcname}(children::Any; kwargs...) = {funcname}(;kwargs..., children = children)
{funcname}(children_maker::Function; kwargs...) = {funcname}(children_maker(); kwargs...)
''' # noqa:E501
'''

jl_package_file_string = '''
module {package_name}
using Dash
using {base_package}

const resources_path = realpath(joinpath( @__DIR__, "..", "deps"))
const version = "{version}"

{component_includes}

function __init__()
Dash.register_package(
Dash.ResourcePkg(
DashBase.register_package(
DashBase.ResourcePkg(

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not new here, but is it important that this be two nested calls? Could it be refactored to just:

DashBase.register_package(
"{project_shortname}",
resources_path,
version = version,
[
{resources_dist}
]
)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@waralex points out we can do this later - not a major issue anyway.

"{project_shortname}",
resources_path,
version = version,
[
{resources_dist}
]
)

)
end
end
Expand All@@ -87,23 +79,24 @@
{authors}version = "{version}"

[deps]
Dash = "{dash_uuid}"
{base_package} = "{dash_uuid}"

[compact]
julia = "1.1"
Dash = ">=0.1"
julia = "1.2"
{base_package} = ">=0.1"
'''

jl_component_include_string = 'include("{name}.jl")'

jl_resource_tuple_string = '''Dash.Resource(
jl_resource_tuple_string = '''DashBase.Resource(
relative_package_path = {relative_package_path},
external_url = {external_url},
dynamic = {dynamic},
async = {async_string},
type = :{type}
)'''

core_packages = ['dash_html_components', 'dash_core_components', 'dash_table']

def jl_package_name(namestring):
s = namestring.split("_")
Expand DownExpand Up@@ -370,6 +363,14 @@ def nothing_or_string(v):
else 'nothing'
) for resource in resources]

def is_core_package(project_shortname):
return project_shortname in core_packages

def base_package_name(project_shortname):
return "DashBase" if is_core_package(project_shortname) else "Dash"

def base_package_uid(project_shortname):
return jl_dash_base_uuid if is_core_package(project_shortname) else jl_base_uuid

def generate_package_file(project_shortname, components, pkg_data, prefix):
package_name = jl_package_name(project_shortname)
Expand All@@ -391,15 +392,15 @@ def generate_package_file(project_shortname, components, pkg_data, prefix):
),
resources_dist=resources_dist,
version=project_ver,
project_shortname=project_shortname
project_shortname=project_shortname,
base_package=base_package_name(project_shortname)

)
file_path = os.path.join("src", package_name + ".jl")
with open(file_path, "w") as f:
f.write(package_string)
print("Generated {}".format(file_path))


def generate_toml_file(project_shortname, pkg_data):
package_author = pkg_data.get("author", "")
project_ver = pkg_data.get("version")
Expand All@@ -414,14 +415,14 @@ def generate_toml_file(project_shortname, pkg_data):
package_uuid=package_uuid,
version=project_ver,
authors=authors_string,
dash_uuid=jl_dash_uuid
base_package=base_package_name(project_shortname),
dash_uuid=base_package_uid(project_shortname),
)
file_path = "Project.toml"
with open(file_path, "w") as f:
f.write(toml_string)
print("Generated {}".format(file_path))


def generate_class_string(name, props, description, project_shortname, prefix):
# Ensure props are ordered with children first
filtered_props = reorder_props(filter_props(props))
Expand All@@ -430,7 +431,7 @@ def generate_class_string(name, props, description, project_shortname, prefix):

docstring = create_docstring_jl(
component_name=name, props=filtered_props, description=description
).replace("\r\n", "\n")
).replace("\r\n", "\n").replace('$', '\$')

wclist = get_wildcards_jl(props)
default_paramtext = ""
Expand All@@ -453,6 +454,10 @@ def generate_class_string(name, props, description, project_shortname, prefix):
for p in prop_keys
)

has_children = "children" in prop_keys
funcname = format_fn_name(prefix, name)
children_signatures = jl_children_signatures.format(funcname=funcname) if has_children else ""
children_definitions = jl_children_definitions.format(funcname=funcname) if has_children else ""
return jl_component_string.format(
funcname=format_fn_name(prefix, name),
docstring=docstring,
Expand All@@ -461,6 +466,8 @@ def generate_class_string(name, props, description, project_shortname, prefix):
wildcard_names=stringify_wildcards(wclist, no_symbol=True),
element_name=name,
module_name=project_shortname,
children_signatures = children_signatures,
children_definitions = children_definitions
)


Expand Down
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
81 changes: 44 additions & 37 deletions dash/development/_jl_components_generation.py
Original file line numberDiff line numberDiff line change
Expand Up@@ -13,6 +13,9 @@
from ._all_keywords import julia_keywords
from ._py_components_generation import reorder_props

# uuid of DashBase Julia package.
jl_dash_base_uuid = "03207cf0-e2b3-4b91-9ca8-690cf0fb507e"

# uuid of Dash Julia package. Used as base for component package uuid
jl_dash_uuid = "1b08a953-4be3-4667-9a23-3db579824955"

Expand All@@ -23,59 +26,48 @@
export {funcname}

"""
{funcname}(;kwargs...)
{funcname}(children::Any;kwargs...)
{funcname}(children_maker::Function;kwargs...)
{funcname}(;kwargs...){children_signatures}

{docstring}
"""
function {funcname}(; kwargs...)
available_props = Set(Symbol[{component_props}])
wild_props = Set(Symbol[{wildcard_symbols}])
wild_regs = r"^(?<prop>{wildcard_names})"

result = Component("{element_name}", "{module_name}", Dict{{Symbol, Any}}(), available_props, Set(Symbol[{wildcard_symbols}]))

for (prop, value) = pairs(kwargs)
m = match(wild_regs, string(prop))
if (length(wild_props) == 0 || isnothing(m)) && !(prop in available_props)
throw(ArgumentError("Invalid property $(string(prop)) for component " * "{funcname}"))
end

push!(result.props, prop => Front.to_dash(value))
end

return result
available_props = Symbol[{component_props}]
wild_props = Symbol[{wildcard_symbols}]
return Component("{funcname}", "{element_name}", "{module_name}", available_props, wild_props; kwargs...)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FWIW on the Python side we could have used only kwargs like this but we chose to insert all the prop names explicitly in the signature (except wildcards of course) because it helps with autocompletion in IDEs. I have no idea if similar functionality exists in Julia, and anyway even if we do want to do this we can add it later.

end
{children_definitions}
''' # noqa:E501

function {funcname}(children::Any; kwargs...)
result = {funcname}(;kwargs...)
push!(result.props, :children => Front.to_dash(children))
return result
end
jl_children_signatures = '''
{funcname}(children::Any;kwargs...)
{funcname}(children_maker::Function;kwargs...)
'''

jl_children_definitions = '''
{funcname}(children::Any; kwargs...) = {funcname}(;kwargs..., children = children)
{funcname}(children_maker::Function; kwargs...) = {funcname}(children_maker(); kwargs...)
''' # noqa:E501
'''

jl_package_file_string = '''
module {package_name}
using Dash
using {base_package}

const resources_path = realpath(joinpath( @__DIR__, "..", "deps"))
const version = "{version}"

{component_includes}

function __init__()
Dash.register_package(
Dash.ResourcePkg(
DashBase.register_package(
DashBase.ResourcePkg(

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not new here, but is it important that this be two nested calls? Could it be refactored to just:

DashBase.register_package(
"{project_shortname}",
resources_path,
version = version,
[
{resources_dist}
]
)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@waralex points out we can do this later - not a major issue anyway.

"{project_shortname}",
resources_path,
version = version,
[
{resources_dist}
]
)

)
end
end
Expand All@@ -87,23 +79,24 @@
{authors}version = "{version}"

[deps]
Dash = "{dash_uuid}"
{base_package} = "{dash_uuid}"

[compact]
julia = "1.1"
Dash = ">=0.1"
julia = "1.2"
{base_package} = ">=0.1"
'''

jl_component_include_string = 'include("{name}.jl")'

jl_resource_tuple_string = '''Dash.Resource(
jl_resource_tuple_string = '''DashBase.Resource(
relative_package_path = {relative_package_path},
external_url = {external_url},
dynamic = {dynamic},
async = {async_string},
type = :{type}
)'''

core_packages = ['dash_html_components', 'dash_core_components', 'dash_table']

def jl_package_name(namestring):
s = namestring.split("_")
Expand DownExpand Up@@ -370,6 +363,14 @@ def nothing_or_string(v):
else 'nothing'
) for resource in resources]

def is_core_package(project_shortname):
return project_shortname in core_packages

def base_package_name(project_shortname):
return "DashBase" if is_core_package(project_shortname) else "Dash"

def base_package_uid(project_shortname):
return jl_dash_base_uuid if is_core_package(project_shortname) else jl_base_uuid

def generate_package_file(project_shortname, components, pkg_data, prefix):
package_name = jl_package_name(project_shortname)
Expand All@@ -391,15 +392,15 @@ def generate_package_file(project_shortname, components, pkg_data, prefix):
),
resources_dist=resources_dist,
version=project_ver,
project_shortname=project_shortname
project_shortname=project_shortname,
base_package=base_package_name(project_shortname)

)
file_path = os.path.join("src", package_name + ".jl")
with open(file_path, "w") as f:
f.write(package_string)
print("Generated {}".format(file_path))


def generate_toml_file(project_shortname, pkg_data):
package_author = pkg_data.get("author", "")
project_ver = pkg_data.get("version")
Expand All@@ -414,14 +415,14 @@ def generate_toml_file(project_shortname, pkg_data):
package_uuid=package_uuid,
version=project_ver,
authors=authors_string,
dash_uuid=jl_dash_uuid
base_package=base_package_name(project_shortname),
dash_uuid=base_package_uid(project_shortname),
)
file_path = "Project.toml"
with open(file_path, "w") as f:
f.write(toml_string)
print("Generated {}".format(file_path))


def generate_class_string(name, props, description, project_shortname, prefix):
# Ensure props are ordered with children first
filtered_props = reorder_props(filter_props(props))
Expand All@@ -430,7 +431,7 @@ def generate_class_string(name, props, description, project_shortname, prefix):

docstring = create_docstring_jl(
component_name=name, props=filtered_props, description=description
).replace("\r\n", "\n")
).replace("\r\n", "\n").replace('$', '\$')

wclist = get_wildcards_jl(props)
default_paramtext = ""
Expand All@@ -453,6 +454,10 @@ def generate_class_string(name, props, description, project_shortname, prefix):
for p in prop_keys
)

has_children = "children" in prop_keys
funcname = format_fn_name(prefix, name)
children_signatures = jl_children_signatures.format(funcname=funcname) if has_children else ""
children_definitions = jl_children_definitions.format(funcname=funcname) if has_children else ""
return jl_component_string.format(
funcname=format_fn_name(prefix, name),
docstring=docstring,
Expand All@@ -461,6 +466,8 @@ def generate_class_string(name, props, description, project_shortname, prefix):
wildcard_names=stringify_wildcards(wclist, no_symbol=True),
element_name=name,
module_name=project_shortname,
children_signatures = children_signatures,
children_definitions = children_definitions
)


Expand Down
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
81 changes: 44 additions & 37 deletions dash/development/_jl_components_generation.py
Original file line numberDiff line numberDiff line change
Expand Up@@ -13,6 +13,9 @@
from ._all_keywords import julia_keywords
from ._py_components_generation import reorder_props

# uuid of DashBase Julia package.
jl_dash_base_uuid = "03207cf0-e2b3-4b91-9ca8-690cf0fb507e"

# uuid of Dash Julia package. Used as base for component package uuid
jl_dash_uuid = "1b08a953-4be3-4667-9a23-3db579824955"

Expand All@@ -23,59 +26,48 @@
export {funcname}

"""
{funcname}(;kwargs...)
{funcname}(children::Any;kwargs...)
{funcname}(children_maker::Function;kwargs...)
{funcname}(;kwargs...){children_signatures}

{docstring}
"""
function {funcname}(; kwargs...)
available_props = Set(Symbol[{component_props}])
wild_props = Set(Symbol[{wildcard_symbols}])
wild_regs = r"^(?<prop>{wildcard_names})"

result = Component("{element_name}", "{module_name}", Dict{{Symbol, Any}}(), available_props, Set(Symbol[{wildcard_symbols}]))

for (prop, value) = pairs(kwargs)
m = match(wild_regs, string(prop))
if (length(wild_props) == 0 || isnothing(m)) && !(prop in available_props)
throw(ArgumentError("Invalid property $(string(prop)) for component " * "{funcname}"))
end

push!(result.props, prop => Front.to_dash(value))
end

return result
available_props = Symbol[{component_props}]
wild_props = Symbol[{wildcard_symbols}]
return Component("{funcname}", "{element_name}", "{module_name}", available_props, wild_props; kwargs...)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FWIW on the Python side we could have used only kwargs like this but we chose to insert all the prop names explicitly in the signature (except wildcards of course) because it helps with autocompletion in IDEs. I have no idea if similar functionality exists in Julia, and anyway even if we do want to do this we can add it later.

end
{children_definitions}
''' # noqa:E501

function {funcname}(children::Any; kwargs...)
result = {funcname}(;kwargs...)
push!(result.props, :children => Front.to_dash(children))
return result
end
jl_children_signatures = '''
{funcname}(children::Any;kwargs...)
{funcname}(children_maker::Function;kwargs...)
'''

jl_children_definitions = '''
{funcname}(children::Any; kwargs...) = {funcname}(;kwargs..., children = children)
{funcname}(children_maker::Function; kwargs...) = {funcname}(children_maker(); kwargs...)
''' # noqa:E501
'''

jl_package_file_string = '''
module {package_name}
using Dash
using {base_package}

const resources_path = realpath(joinpath( @__DIR__, "..", "deps"))
const version = "{version}"

{component_includes}

function __init__()
Dash.register_package(
Dash.ResourcePkg(
DashBase.register_package(
DashBase.ResourcePkg(

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not new here, but is it important that this be two nested calls? Could it be refactored to just:

DashBase.register_package(
"{project_shortname}",
resources_path,
version = version,
[
{resources_dist}
]
)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@waralex points out we can do this later - not a major issue anyway.

"{project_shortname}",
resources_path,
version = version,
[
{resources_dist}
]
)

)
end
end
Expand All@@ -87,23 +79,24 @@
{authors}version = "{version}"

[deps]
Dash = "{dash_uuid}"
{base_package} = "{dash_uuid}"

[compact]
julia = "1.1"
Dash = ">=0.1"
julia = "1.2"
{base_package} = ">=0.1"
'''

jl_component_include_string = 'include("{name}.jl")'

jl_resource_tuple_string = '''Dash.Resource(
jl_resource_tuple_string = '''DashBase.Resource(
relative_package_path = {relative_package_path},
external_url = {external_url},
dynamic = {dynamic},
async = {async_string},
type = :{type}
)'''

core_packages = ['dash_html_components', 'dash_core_components', 'dash_table']

def jl_package_name(namestring):
s = namestring.split("_")
Expand DownExpand Up@@ -370,6 +363,14 @@ def nothing_or_string(v):
else 'nothing'
) for resource in resources]

def is_core_package(project_shortname):
return project_shortname in core_packages

def base_package_name(project_shortname):
return "DashBase" if is_core_package(project_shortname) else "Dash"

def base_package_uid(project_shortname):
return jl_dash_base_uuid if is_core_package(project_shortname) else jl_base_uuid

def generate_package_file(project_shortname, components, pkg_data, prefix):
package_name = jl_package_name(project_shortname)
Expand All@@ -391,15 +392,15 @@ def generate_package_file(project_shortname, components, pkg_data, prefix):
),
resources_dist=resources_dist,
version=project_ver,
project_shortname=project_shortname
project_shortname=project_shortname,
base_package=base_package_name(project_shortname)

)
file_path = os.path.join("src", package_name + ".jl")
with open(file_path, "w") as f:
f.write(package_string)
print("Generated {}".format(file_path))


def generate_toml_file(project_shortname, pkg_data):
package_author = pkg_data.get("author", "")
project_ver = pkg_data.get("version")
Expand All@@ -414,14 +415,14 @@ def generate_toml_file(project_shortname, pkg_data):
package_uuid=package_uuid,
version=project_ver,
authors=authors_string,
dash_uuid=jl_dash_uuid
base_package=base_package_name(project_shortname),
dash_uuid=base_package_uid(project_shortname),
)
file_path = "Project.toml"
with open(file_path, "w") as f:
f.write(toml_string)
print("Generated {}".format(file_path))


def generate_class_string(name, props, description, project_shortname, prefix):
# Ensure props are ordered with children first
filtered_props = reorder_props(filter_props(props))
Expand All@@ -430,7 +431,7 @@ def generate_class_string(name, props, description, project_shortname, prefix):

docstring = create_docstring_jl(
component_name=name, props=filtered_props, description=description
).replace("\r\n", "\n")
).replace("\r\n", "\n").replace('$', '\$')

wclist = get_wildcards_jl(props)
default_paramtext = ""
Expand All@@ -453,6 +454,10 @@ def generate_class_string(name, props, description, project_shortname, prefix):
for p in prop_keys
)

has_children = "children" in prop_keys
funcname = format_fn_name(prefix, name)
children_signatures = jl_children_signatures.format(funcname=funcname) if has_children else ""
children_definitions = jl_children_definitions.format(funcname=funcname) if has_children else ""
return jl_component_string.format(
funcname=format_fn_name(prefix, name),
docstring=docstring,
Expand All@@ -461,6 +466,8 @@ def generate_class_string(name, props, description, project_shortname, prefix):
wildcard_names=stringify_wildcards(wclist, no_symbol=True),
element_name=name,
module_name=project_shortname,
children_signatures = children_signatures,
children_definitions = children_definitions
)


Expand Down
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
81 changes: 44 additions & 37 deletions dash/development/_jl_components_generation.py
Original file line numberDiff line numberDiff line change
Expand Up@@ -13,6 +13,9 @@
from ._all_keywords import julia_keywords
from ._py_components_generation import reorder_props

# uuid of DashBase Julia package.
jl_dash_base_uuid = "03207cf0-e2b3-4b91-9ca8-690cf0fb507e"

# uuid of Dash Julia package. Used as base for component package uuid
jl_dash_uuid = "1b08a953-4be3-4667-9a23-3db579824955"

Expand All@@ -23,59 +26,48 @@
export {funcname}

"""
{funcname}(;kwargs...)
{funcname}(children::Any;kwargs...)
{funcname}(children_maker::Function;kwargs...)
{funcname}(;kwargs...){children_signatures}

{docstring}
"""
function {funcname}(; kwargs...)
available_props = Set(Symbol[{component_props}])
wild_props = Set(Symbol[{wildcard_symbols}])
wild_regs = r"^(?<prop>{wildcard_names})"

result = Component("{element_name}", "{module_name}", Dict{{Symbol, Any}}(), available_props, Set(Symbol[{wildcard_symbols}]))

for (prop, value) = pairs(kwargs)
m = match(wild_regs, string(prop))
if (length(wild_props) == 0 || isnothing(m)) && !(prop in available_props)
throw(ArgumentError("Invalid property $(string(prop)) for component " * "{funcname}"))
end

push!(result.props, prop => Front.to_dash(value))
end

return result
available_props = Symbol[{component_props}]
wild_props = Symbol[{wildcard_symbols}]
return Component("{funcname}", "{element_name}", "{module_name}", available_props, wild_props; kwargs...)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FWIW on the Python side we could have used only kwargs like this but we chose to insert all the prop names explicitly in the signature (except wildcards of course) because it helps with autocompletion in IDEs. I have no idea if similar functionality exists in Julia, and anyway even if we do want to do this we can add it later.

end
{children_definitions}
''' # noqa:E501

function {funcname}(children::Any; kwargs...)
result = {funcname}(;kwargs...)
push!(result.props, :children => Front.to_dash(children))
return result
end
jl_children_signatures = '''
{funcname}(children::Any;kwargs...)
{funcname}(children_maker::Function;kwargs...)
'''

jl_children_definitions = '''
{funcname}(children::Any; kwargs...) = {funcname}(;kwargs..., children = children)
{funcname}(children_maker::Function; kwargs...) = {funcname}(children_maker(); kwargs...)
''' # noqa:E501
'''

jl_package_file_string = '''
module {package_name}
using Dash
using {base_package}

const resources_path = realpath(joinpath( @__DIR__, "..", "deps"))
const version = "{version}"

{component_includes}

function __init__()
Dash.register_package(
Dash.ResourcePkg(
DashBase.register_package(
DashBase.ResourcePkg(

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not new here, but is it important that this be two nested calls? Could it be refactored to just:

DashBase.register_package(
"{project_shortname}",
resources_path,
version = version,
[
{resources_dist}
]
)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@waralex points out we can do this later - not a major issue anyway.

"{project_shortname}",
resources_path,
version = version,
[
{resources_dist}
]
)

)
end
end
Expand All@@ -87,23 +79,24 @@
{authors}version = "{version}"

[deps]
Dash = "{dash_uuid}"
{base_package} = "{dash_uuid}"

[compact]
julia = "1.1"
Dash = ">=0.1"
julia = "1.2"
{base_package} = ">=0.1"
'''

jl_component_include_string = 'include("{name}.jl")'

jl_resource_tuple_string = '''Dash.Resource(
jl_resource_tuple_string = '''DashBase.Resource(
relative_package_path = {relative_package_path},
external_url = {external_url},
dynamic = {dynamic},
async = {async_string},
type = :{type}
)'''

core_packages = ['dash_html_components', 'dash_core_components', 'dash_table']

def jl_package_name(namestring):
s = namestring.split("_")
Expand DownExpand Up@@ -370,6 +363,14 @@ def nothing_or_string(v):
else 'nothing'
) for resource in resources]

def is_core_package(project_shortname):
return project_shortname in core_packages

def base_package_name(project_shortname):
return "DashBase" if is_core_package(project_shortname) else "Dash"

def base_package_uid(project_shortname):
return jl_dash_base_uuid if is_core_package(project_shortname) else jl_base_uuid

def generate_package_file(project_shortname, components, pkg_data, prefix):
package_name = jl_package_name(project_shortname)
Expand All@@ -391,15 +392,15 @@ def generate_package_file(project_shortname, components, pkg_data, prefix):
),
resources_dist=resources_dist,
version=project_ver,
project_shortname=project_shortname
project_shortname=project_shortname,
base_package=base_package_name(project_shortname)

)
file_path = os.path.join("src", package_name + ".jl")
with open(file_path, "w") as f:
f.write(package_string)
print("Generated {}".format(file_path))


def generate_toml_file(project_shortname, pkg_data):
package_author = pkg_data.get("author", "")
project_ver = pkg_data.get("version")
Expand All@@ -414,14 +415,14 @@ def generate_toml_file(project_shortname, pkg_data):
package_uuid=package_uuid,
version=project_ver,
authors=authors_string,
dash_uuid=jl_dash_uuid
base_package=base_package_name(project_shortname),
dash_uuid=base_package_uid(project_shortname),
)
file_path = "Project.toml"
with open(file_path, "w") as f:
f.write(toml_string)
print("Generated {}".format(file_path))


def generate_class_string(name, props, description, project_shortname, prefix):
# Ensure props are ordered with children first
filtered_props = reorder_props(filter_props(props))
Expand All@@ -430,7 +431,7 @@ def generate_class_string(name, props, description, project_shortname, prefix):

docstring = create_docstring_jl(
component_name=name, props=filtered_props, description=description
).replace("\r\n", "\n")
).replace("\r\n", "\n").replace('$', '\$')

wclist = get_wildcards_jl(props)
default_paramtext = ""
Expand All@@ -453,6 +454,10 @@ def generate_class_string(name, props, description, project_shortname, prefix):
for p in prop_keys
)

has_children = "children" in prop_keys
funcname = format_fn_name(prefix, name)
children_signatures = jl_children_signatures.format(funcname=funcname) if has_children else ""
children_definitions = jl_children_definitions.format(funcname=funcname) if has_children else ""
return jl_component_string.format(
funcname=format_fn_name(prefix, name),
docstring=docstring,
Expand All@@ -461,6 +466,8 @@ def generate_class_string(name, props, description, project_shortname, prefix):
wildcard_names=stringify_wildcards(wclist, no_symbol=True),
element_name=name,
module_name=project_shortname,
children_signatures = children_signatures,
children_definitions = children_definitions
)


Expand Down