# Copyright (c) 2015, Frappe Technologies Pvt. Ltd. and Contributors # License: MIT. See LICENSE import json import frappe from frappe.geo.country_info import get_country_info from frappe.translate import get_messages_for_boot, send_translations, set_default_language from frappe.utils import cint, strip from frappe.utils.password import update_password from . import install_fixtures def get_setup_stages(args): # App setup stage functions should not include frappe.db.commit # That is done by frappe after successful completion of all stages stages = [ { "status": "Updating global settings", "fail_msg": "Failed to update global settings", "tasks": [ {"fn": update_global_settings, "args": args, "fail_msg": "Failed to update global settings"} ], } ] stages += get_stages_hooks(args) + get_setup_complete_hooks(args) stages.append( { # post executing hooks "status": "Wrapping up", "fail_msg": "Failed to complete setup", "tasks": [ {"fn": run_post_setup_complete, "args": args, "fail_msg": "Failed to complete setup"} ], } ) return stages @frappe.whitelist() def setup_complete(args): """Calls hooks for `setup_wizard_complete`, sets home page as `desktop` and clears cache. If wizard breaks, calls `setup_wizard_exception` hook""" # Setup complete: do not throw an exception, let the user continue to desk if cint(frappe.db.get_single_value("System Settings", "setup_complete")): return {"status": "ok"} args = parse_args(args) stages = get_setup_stages(args) is_background_task = frappe.conf.get("trigger_site_setup_in_background") if is_background_task: process_setup_stages.enqueue(stages=stages, user_input=args, is_background_task=True) return {"status": "registered"} else: return process_setup_stages(stages, args) @frappe.task() def process_setup_stages(stages, user_input, is_background_task=False): from frappe.utils.telemetry import capture capture("initated_server_side", "setup") try: frappe.flags.in_setup_wizard = True current_task = None for idx, stage in enumerate(stages): frappe.publish_realtime( "setup_task", {"progress": [idx, len(stages)], "stage_status": stage.get("status")}, user=frappe.session.user, ) for task in stage.get("tasks"): current_task = task task.get("fn")(task.get("args")) except Exception: handle_setup_exception(user_input) if not is_background_task: return {"status": "fail", "fail": current_task.get("fail_msg")} frappe.publish_realtime( "setup_task", {"status": "fail", "fail_msg": current_task.get("fail_msg")}, user=frappe.session.user, ) else: run_setup_success(user_input) capture("completed_server_side", "setup") if not is_background_task: return {"status": "ok"} frappe.publish_realtime("setup_task", {"status": "ok"}, user=frappe.session.user) finally: frappe.flags.in_setup_wizard = False def update_global_settings(args): if args.language and args.language != "English": set_default_language(get_language_code(args.lang)) frappe.db.commit() frappe.clear_cache() update_system_settings(args) update_user_name(args) def run_post_setup_complete(args): disable_future_access() frappe.db.commit() frappe.clear_cache() def run_setup_success(args): for hook in frappe.get_hooks("setup_wizard_success"): frappe.get_attr(hook)(args) install_fixtures.install() def get_stages_hooks(args): stages = [] for method in frappe.get_hooks("setup_wizard_stages"): stages += frappe.get_attr(method)(args) return stages def get_setup_complete_hooks(args): stages = [] for method in frappe.get_hooks("setup_wizard_complete"): stages.append( { "status": "Executing method", "fail_msg": "Failed to execute method", "tasks": [ {"fn": frappe.get_attr(method), "args": args, "fail_msg": "Failed to execute method"} ], } ) return stages def handle_setup_exception(args): frappe.db.rollback() if args: traceback = frappe.get_traceback() print(traceback) for hook in frappe.get_hooks("setup_wizard_exception"): frappe.get_attr(hook)(traceback, args) def update_system_settings(args): number_format = get_country_info(args.get("country")).get("number_format", "#,###.##") # replace these as float number formats, as they have 0 precision # and are currency number formats and not for floats if number_format == "#.###": number_format = "#.###,##" elif number_format == "#,###": number_format = "#,###.##" system_settings = frappe.get_doc("System Settings", "System Settings") system_settings.update( { "country": args.get("country"), "language": get_language_code(args.get("language")) or "en", "time_zone": args.get("timezone"), "float_precision": 3, "rounding_method": "Banker's Rounding", "date_format": frappe.db.get_value("Country", args.get("country"), "date_format"), "time_format": frappe.db.get_value("Country", args.get("country"), "time_format"), "number_format": number_format, "enable_scheduler": 1 if not frappe.flags.in_test else 0, "backup_limit": 3, # Default for downloadable backups "enable_telemetry": cint(args.get("enable_telemetry")), } ) system_settings.save() def update_user_name(args): first_name, last_name = args.get("full_name", ""), "" if " " in first_name: first_name, last_name = first_name.split(" ", 1) if args.get("email"): if frappe.db.exists("User", args.get("email")): # running again return args["name"] = args.get("email") _mute_emails, frappe.flags.mute_emails = frappe.flags.mute_emails, True doc = frappe.get_doc( { "doctype": "User", "email": args.get("email"), "first_name": first_name, "last_name": last_name, } ) doc.flags.no_welcome_mail = True doc.insert() frappe.flags.mute_emails = _mute_emails update_password(args.get("email"), args.get("password")) elif first_name: args.update({"name": frappe.session.user, "first_name": first_name, "last_name": last_name}) frappe.db.sql( """update `tabUser` SET first_name=%(first_name)s, last_name=%(last_name)s WHERE name=%(name)s""", args, ) if args.get("attach_user"): attach_user = args.get("attach_user").split(",") if len(attach_user) == 3: filename, filetype, content = attach_user _file = frappe.get_doc( { "doctype": "File", "file_name": filename, "attached_to_doctype": "User", "attached_to_name": args.get("name"), "content": content, "decode": True, } ) _file.save() fileurl = _file.file_url frappe.db.set_value("User", args.get("name"), "user_image", fileurl) if args.get("name"): add_all_roles_to(args.get("name")) def parse_args(args): if not args: args = frappe.local.form_dict if isinstance(args, str): args = json.loads(args) args = frappe._dict(args) # strip the whitespace for key, value in args.items(): if isinstance(value, str): args[key] = strip(value) return args def add_all_roles_to(name): user = frappe.get_doc("User", name) for role in frappe.db.sql("""select name from tabRole"""): if role[0] not in [ "Administrator", "Guest", "All", "Customer", "Supplier", "Partner", "Employee", ]: d = user.append("roles") d.role = role[0] user.save() def disable_future_access(): frappe.db.set_default("desktop:home_page", "workspace") frappe.db.set_single_value("System Settings", "setup_complete", 1) # Enable onboarding after install frappe.db.set_single_value("System Settings", "enable_onboarding", 1) if not frappe.flags.in_test: # remove all roles and add 'Administrator' to prevent future access page = frappe.get_doc("Page", "setup-wizard") page.roles = [] page.append("roles", {"role": "Administrator"}) page.flags.do_not_update_json = True page.flags.ignore_permissions = True page.save() @frappe.whitelist() def load_messages(language): """Load translation messages for given language from all `setup_wizard_requires` javascript files""" frappe.clear_cache() set_default_language(get_language_code(language)) frappe.db.commit() send_translations(get_messages_for_boot()) return frappe.local.lang @frappe.whitelist() def load_languages(): language_codes = frappe.db.sql( "select language_code, language_name from tabLanguage order by name", as_dict=True ) codes_to_names = {} for d in language_codes: codes_to_names[d.language_code] = d.language_name return { "default_language": frappe.db.get_value("Language", frappe.local.lang, "language_name") or frappe.local.lang, "languages": sorted(frappe.db.sql_list("select language_name from tabLanguage order by name")), "codes_to_names": codes_to_names, } @frappe.whitelist() def load_country(): from frappe.sessions import get_geo_ip_country return get_geo_ip_country(frappe.local.request_ip) if frappe.local.request_ip else None @frappe.whitelist() def load_user_details(): return { "full_name": frappe.cache.hget("full_name", "signup"), "email": frappe.cache.hget("email", "signup"), } def prettify_args(args): # remove attachments for key, val in args.items(): if isinstance(val, str) and "data:image" in val: filename = val.split("data:image", 1)[0].strip(", ") size = round((len(val) * 3 / 4) / 1048576.0, 2) args[key] = f"Image Attached: '{filename}' of size {size} MB" pretty_args = [] for key in sorted(args): pretty_args.append(f"{key} = {args[key]}") return pretty_args def email_setup_wizard_exception(traceback, args): if not frappe.conf.setup_wizard_exception_email: return pretty_args = prettify_args(args) message = """ #### Traceback
{traceback}
---
#### Setup Wizard Arguments
{args}
---
#### Request Headers
{headers}
---
#### Basic Information
- **Site:** {site}
- **User:** {user}""".format(
site=frappe.local.site,
traceback=traceback,
args="\n".join(pretty_args),
user=frappe.session.user,
headers=frappe.request.headers,
)
frappe.sendmail(
recipients=frappe.conf.setup_wizard_exception_email,
sender=frappe.session.user,
subject=f"Setup failed: {frappe.local.site}",
message=message,
delayed=False,
)
def log_setup_wizard_exception(traceback, args):
with open("../logs/setup-wizard.log", "w+") as setup_log:
setup_log.write(traceback)
setup_log.write(json.dumps(args))
def get_language_code(lang):
return frappe.db.get_value("Language", {"language_name": lang})
def enable_twofactor_all_roles():
all_role = frappe.get_doc("Role", {"role_name": "All"})
all_role.two_factor_auth = True
all_role.save(ignore_permissions=True)
def make_records(records, debug=False):
from frappe import _dict
from frappe.modules import scrub
if debug:
print("make_records: in DEBUG mode")
# LOG every success and failure
for record in records:
doctype = record.get("doctype")
condition = record.get("__condition")
if condition and not condition():
continue
doc = frappe.new_doc(doctype)
doc.update(record)
# ignore mandatory for root
parent_link_field = "parent_" + scrub(doc.doctype)
if doc.meta.get_field(parent_link_field) and not doc.get(parent_link_field):
doc.flags.ignore_mandatory = True
savepoint = "setup_fixtures_creation"
try:
frappe.db.savepoint(savepoint)
doc.insert(ignore_permissions=True, ignore_if_duplicate=True)
except Exception as e:
frappe.clear_last_message()
frappe.db.rollback(save_point=savepoint)
exception = record.get("__exception")
if exception:
config = _dict(exception)
if isinstance(e, config.exception):
config.handler()
else:
show_document_insert_error()
else:
show_document_insert_error()
def show_document_insert_error():
print("Document Insert Error")
print(frappe.get_traceback())
frappe.log_error("Exception during Setup")