builtin.h 5.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142
  1. /*
  2. * This file is part of the MicroPython project, http://micropython.org/
  3. *
  4. * The MIT License (MIT)
  5. *
  6. * Copyright (c) 2013, 2014 Damien P. George
  7. *
  8. * Permission is hereby granted, free of charge, to any person obtaining a copy
  9. * of this software and associated documentation files (the "Software"), to deal
  10. * in the Software without restriction, including without limitation the rights
  11. * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  12. * copies of the Software, and to permit persons to whom the Software is
  13. * furnished to do so, subject to the following conditions:
  14. *
  15. * The above copyright notice and this permission notice shall be included in
  16. * all copies or substantial portions of the Software.
  17. *
  18. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  19. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  20. * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  21. * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  22. * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  23. * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  24. * THE SOFTWARE.
  25. */
  26. #ifndef MICROPY_INCLUDED_PY_BUILTIN_H
  27. #define MICROPY_INCLUDED_PY_BUILTIN_H
  28. #include "py/obj.h"
  29. typedef enum {
  30. MP_IMPORT_STAT_NO_EXIST,
  31. MP_IMPORT_STAT_DIR,
  32. MP_IMPORT_STAT_FILE,
  33. } mp_import_stat_t;
  34. #if MICROPY_VFS
  35. // Delegate to the VFS for import stat and builtin open.
  36. #define mp_builtin_open_obj mp_vfs_open_obj
  37. mp_import_stat_t mp_vfs_import_stat(const char *path);
  38. mp_obj_t mp_vfs_open(size_t n_args, const mp_obj_t *args, mp_map_t *kwargs);
  39. MP_DECLARE_CONST_FUN_OBJ_KW(mp_vfs_open_obj);
  40. static inline mp_import_stat_t mp_import_stat(const char *path) {
  41. return mp_vfs_import_stat(path);
  42. }
  43. static inline mp_obj_t mp_builtin_open(size_t n_args, const mp_obj_t *args, mp_map_t *kwargs) {
  44. return mp_vfs_open(n_args, args, kwargs);
  45. }
  46. #else
  47. // A port can provide implementations of these functions.
  48. mp_import_stat_t mp_import_stat(const char *path);
  49. mp_obj_t mp_builtin_open(size_t n_args, const mp_obj_t *args, mp_map_t *kwargs);
  50. // A port can provide this object.
  51. MP_DECLARE_CONST_FUN_OBJ_KW(mp_builtin_open_obj);
  52. #endif
  53. // A port can provide its own import handler by defining mp_builtin___import__.
  54. #ifndef mp_builtin___import__
  55. #define mp_builtin___import__ mp_builtin___import___default
  56. #endif
  57. mp_obj_t mp_builtin___import__(size_t n_args, const mp_obj_t *args);
  58. mp_obj_t mp_builtin___import___default(size_t n_args, const mp_obj_t *args);
  59. mp_obj_t mp_micropython_mem_info(size_t n_args, const mp_obj_t *args);
  60. MP_DECLARE_CONST_FUN_OBJ_VAR(mp_builtin___build_class___obj);
  61. MP_DECLARE_CONST_FUN_OBJ_VAR_BETWEEN(mp_builtin___import___obj);
  62. MP_DECLARE_CONST_FUN_OBJ_1(mp_builtin___repl_print___obj);
  63. MP_DECLARE_CONST_FUN_OBJ_1(mp_builtin_abs_obj);
  64. MP_DECLARE_CONST_FUN_OBJ_1(mp_builtin_all_obj);
  65. MP_DECLARE_CONST_FUN_OBJ_1(mp_builtin_any_obj);
  66. MP_DECLARE_CONST_FUN_OBJ_1(mp_builtin_bin_obj);
  67. MP_DECLARE_CONST_FUN_OBJ_1(mp_builtin_callable_obj);
  68. MP_DECLARE_CONST_FUN_OBJ_VAR_BETWEEN(mp_builtin_compile_obj);
  69. MP_DECLARE_CONST_FUN_OBJ_1(mp_builtin_chr_obj);
  70. MP_DECLARE_CONST_FUN_OBJ_2(mp_builtin_delattr_obj);
  71. MP_DECLARE_CONST_FUN_OBJ_VAR_BETWEEN(mp_builtin_dir_obj);
  72. MP_DECLARE_CONST_FUN_OBJ_2(mp_builtin_divmod_obj);
  73. MP_DECLARE_CONST_FUN_OBJ_VAR_BETWEEN(mp_builtin_eval_obj);
  74. MP_DECLARE_CONST_FUN_OBJ_VAR_BETWEEN(mp_builtin_exec_obj);
  75. MP_DECLARE_CONST_FUN_OBJ_VAR_BETWEEN(mp_builtin_execfile_obj);
  76. MP_DECLARE_CONST_FUN_OBJ_VAR_BETWEEN(mp_builtin_getattr_obj);
  77. MP_DECLARE_CONST_FUN_OBJ_3(mp_builtin_setattr_obj);
  78. MP_DECLARE_CONST_FUN_OBJ_0(mp_builtin_globals_obj);
  79. MP_DECLARE_CONST_FUN_OBJ_2(mp_builtin_hasattr_obj);
  80. MP_DECLARE_CONST_FUN_OBJ_1(mp_builtin_hash_obj);
  81. MP_DECLARE_CONST_FUN_OBJ_VAR_BETWEEN(mp_builtin_help_obj);
  82. MP_DECLARE_CONST_FUN_OBJ_1(mp_builtin_hex_obj);
  83. MP_DECLARE_CONST_FUN_OBJ_1(mp_builtin_id_obj);
  84. MP_DECLARE_CONST_FUN_OBJ_2(mp_builtin_isinstance_obj);
  85. MP_DECLARE_CONST_FUN_OBJ_2(mp_builtin_issubclass_obj);
  86. MP_DECLARE_CONST_FUN_OBJ_1(mp_builtin_iter_obj);
  87. MP_DECLARE_CONST_FUN_OBJ_1(mp_builtin_len_obj);
  88. MP_DECLARE_CONST_FUN_OBJ_0(mp_builtin_locals_obj);
  89. MP_DECLARE_CONST_FUN_OBJ_KW(mp_builtin_max_obj);
  90. MP_DECLARE_CONST_FUN_OBJ_KW(mp_builtin_min_obj);
  91. #if MICROPY_PY_BUILTINS_NEXT2
  92. MP_DECLARE_CONST_FUN_OBJ_VAR_BETWEEN(mp_builtin_next_obj);
  93. #else
  94. MP_DECLARE_CONST_FUN_OBJ_1(mp_builtin_next_obj);
  95. #endif
  96. MP_DECLARE_CONST_FUN_OBJ_1(mp_builtin_oct_obj);
  97. MP_DECLARE_CONST_FUN_OBJ_1(mp_builtin_ord_obj);
  98. MP_DECLARE_CONST_FUN_OBJ_VAR_BETWEEN(mp_builtin_pow_obj);
  99. MP_DECLARE_CONST_FUN_OBJ_KW(mp_builtin_print_obj);
  100. MP_DECLARE_CONST_FUN_OBJ_1(mp_builtin_repr_obj);
  101. MP_DECLARE_CONST_FUN_OBJ_VAR_BETWEEN(mp_builtin_round_obj);
  102. MP_DECLARE_CONST_FUN_OBJ_KW(mp_builtin_sorted_obj);
  103. MP_DECLARE_CONST_FUN_OBJ_VAR_BETWEEN(mp_builtin_sum_obj);
  104. MP_DECLARE_CONST_FUN_OBJ_VAR_BETWEEN(mp_builtin_input_obj);
  105. MP_DECLARE_CONST_FUN_OBJ_2(mp_namedtuple_obj);
  106. MP_DECLARE_CONST_FUN_OBJ_2(mp_op_contains_obj);
  107. MP_DECLARE_CONST_FUN_OBJ_2(mp_op_getitem_obj);
  108. MP_DECLARE_CONST_FUN_OBJ_3(mp_op_setitem_obj);
  109. MP_DECLARE_CONST_FUN_OBJ_2(mp_op_delitem_obj);
  110. // Modules needed by the runtime.
  111. extern const mp_obj_dict_t mp_module_builtins_globals;
  112. extern const mp_obj_module_t mp_module___main__;
  113. extern const mp_obj_module_t mp_module_builtins;
  114. extern const mp_obj_module_t mp_module_sys;
  115. // Modules needed by the parser when MICROPY_COMP_MODULE_CONST is enabled.
  116. extern const mp_obj_module_t mp_module_errno;
  117. extern const mp_obj_module_t mp_module_uctypes;
  118. extern const mp_obj_module_t mp_module_machine;
  119. extern const char MICROPY_PY_BUILTINS_HELP_TEXT[];
  120. #endif // MICROPY_INCLUDED_PY_BUILTIN_H