# Copyright (c) 2012 Web Notes Technologies Pvt Ltd (http://erpnext.com) # # MIT License (MIT) # # Permission is hereby granted, free of charge, to any person obtaining a # copy of this software and associated documentation files (the "Software"), # to deal in the Software without restriction, including without limitation # the rights to use, copy, modify, merge, publish, distribute, sublicense, # and/or sell copies of the Software, and to permit persons to whom the # Software is furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, # INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A # PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT # HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF # CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE # OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # from __future__ import unicode_literals """ globals attached to webnotes module + some utility functions that should probably be moved """ code_fields_dict = { 'Page':[('script', 'js'), ('content', 'html'), ('style', 'css'), ('static_content', 'html'), ('server_code', 'py')], 'DocType':[('server_code_core', 'py'), ('client_script_core', 'js')], 'Search Criteria':[('report_script', 'js'), ('server_script', 'py'), ('custom_query', 'sql')], 'Patch':[('patch_code', 'py')], 'Stylesheet':['stylesheet', 'css'], 'Page Template':['template', 'html'], 'Control Panel':[('startup_code', 'js'), ('startup_css', 'css')] } class DictObj(dict): """dict like object that exposes keys as attributes""" def __getattr__(self, key): return self.get(key) def __setattr__(self, key, value): self[key] = value def __getstate__(self): return self def __setstate__(self, d): self.update(d) form_dict = DictObj() conn = None _memc = None form = None session = None user = None incoming_cookies = {} add_cookies = {} # append these to outgoing request cookies = {} response = DictObj({'message':'', 'exc':''}) debug_log = [] message_log = [] # memcache def cache(): global _memc if not _memc: from webnotes.memc import MClient _memc = MClient(['localhost:11211']) return _memc class ValidationError(Exception): pass class AuthenticationError(Exception): pass class PermissionError(Exception): pass class OutgoingEmailError(ValidationError): pass class UnknownDomainError(Exception): def __init__(self, value): self.value = value def __str__(self): return repr(self.value) class SessionStopped(Exception): def __init__(self, value): self.value = value def __str__(self): return repr(self.value) def getTraceback(): import utils return utils.getTraceback() def errprint(msg): """ Append to the :data:`debug log` """ from utils import cstr debug_log.append(cstr(msg or '')) def msgprint(msg, small=0, raise_exception=0, as_table=False): """ Append to the :data:`message_log` """ from utils import cstr if as_table and type(msg) in (list, tuple): msg = '' + ''.join([''+''.join(['' % c for c in r])+'' for r in msg]) + '
%s
' message_log.append((small and '__small:' or '')+cstr(msg or '')) if raise_exception: import inspect if inspect.isclass(raise_exception) and issubclass(raise_exception, Exception): raise raise_exception, msg else: raise ValidationError, msg def create_folder(path): """ Wrapper function for os.makedirs (does not throw exception if directory exists) """ import os try: os.makedirs(path) except OSError, e: if e.args[0]!=17: raise e def create_symlink(source_path, link_path): """ Wrapper function for os.symlink (does not throw exception if directory exists) """ import os try: os.symlink(source_path, link_path) except OSError, e: if e.args[0]!=17: raise e def remove_file(path): """ Wrapper function for os.remove (does not throw exception if file/symlink does not exists) """ import os try: os.remove(path) except OSError, e: if e.args[0]!=2: raise e def connect(db_name=None, password=None): """ Connect to this db (or db), if called from command prompt """ import webnotes.db global conn conn = webnotes.db.Database(user=db_name, password=password) global session session = {'user':'Administrator'} import webnotes.profile global user user = webnotes.profile.Profile('Administrator') def get_env_vars(env_var): import os return os.environ.get(env_var,'None') remote_ip = get_env_vars('REMOTE_ADDR') #Required for login from python shell logger = None def get_db_password(db_name): """get db password from conf""" import conf if hasattr(conf, 'get_db_password'): return conf.get_db_password(db_name) elif hasattr(conf, 'db_password'): return conf.db_password else: return db_name whitelisted = [] guest_methods = [] def whitelist(allow_guest=False, allow_roles=[]): """ decorator for whitelisting a function Note: if the function is allowed to be accessed by a guest user, it must explicitly be marked as allow_guest=True for specific roles, set allow_roles = ['Administrator'] etc. """ def innerfn(fn): global whitelisted, guest_methods whitelisted.append(fn) if allow_guest: guest_methods.append(fn) if allow_roles: roles = get_roles() allowed = False for role in allow_roles: if role in roles: allowed = True break if not allowed: raise PermissionError, "Method not allowed" return fn return innerfn def clear_cache(user=None): """clear boot cache""" from webnotes.sessions import clear clear(user) def get_roles(user=None, with_standard=True): """get roles of current user""" if not user: user = session['user'] if user=='Guest': return ['Guest'] roles = [r[0] for r in conn.sql("""select role from tabUserRole where parent=%s and role!='All'""", user)] + ['All'] # filter standard if required if not with_standard: roles = filter(lambda x: x not in ['All', 'Guest', 'Administrator'], roles) return roles def has_permission(doctype, ptype): """check if user has permission""" return conn.sql("""select name from tabDocPerm p where p.parent = %s and ifnull(p.`%s`,0) = 1 and ifnull(p.permlevel,0) = 0 and p.role in (select `role` from tabUserRole where `parent`=%s) """ % ("%s", ptype, "%s"), (doctype, session.user)) def generate_hash(): """Generates random hash for session id""" import hashlib, time return hashlib.sha224(str(time.time())).hexdigest() def doc(doctype=None, name=None, fielddata=None): from webnotes.model.doc import Document return Document(doctype, name, fielddata) def doclist(lst=None): from webnotes.model.doclist import DocList return DocList(lst) def model_wrapper(doctype, name=None): from webnotes.model.wrapper import ModelWrapper return ModelWrapper(doctype, name) def delete_doc(doctype=None, name=None, doclist = None, force=0): import webnotes.model webnotes.model.delete_doc(doctype, name, doclist, force) def reload_doc(module, dt=None, dn=None): import webnotes.modules return webnotes.modules.reload_doc(module, dt, dn)