lily/lily-parser-scheme.cc

   1 /*
   2   This file is part of LilyPond, the GNU music typesetter.
   3
   4   Copyright (C) 2005--2011 Han-Wen Nienhuys <hanwen@xs4all.nl>
   5
   6   LilyPond is free software: you can redistribute it and/or modify
   7   it under the terms of the GNU General Public License as published by
   8   the Free Software Foundation, either version 3 of the License, or
   9   (at your option) any later version.
  10
  11   LilyPond is distributed in the hope that it will be useful,
  12   but WITHOUT ANY WARRANTY; without even the implied warranty of
  13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14   GNU General Public License for more details.
  15
  16   You should have received a copy of the GNU General Public License
  17   along with LilyPond.  If not, see <http://www.gnu.org/licenses/>.
  18 */
  19
  20 #include <unistd.h>
  21
  22 #include "lily-parser.hh"
  23
  24 #include "file-name-map.hh"
  25 #include "file-name.hh"
  26 #include "file-path.hh"
  27 #include "international.hh"
  28 #include "lily-lexer.hh"
  29 #include "ly-module.hh"
  30 #include "main.hh"
  31 #include "program-option.hh"
  32 #include "sources.hh"
  33 #include "warn.hh"
  34
  35 LY_DEFINE (ly_parse_file, "ly:parse-file",
  36            1, 0, 0, (SCM name),
  37            "Parse a single @code{.ly} file."
  38            "  Upon failure, throw @code{ly-file-failed} key.")
  39 {
  40   LY_ASSERT_TYPE (scm_is_string, name, 1);
  41   string file = ly_scm2string (name);
  42   char const *extensions[] = {"ly", "", 0};
  43
  44   string file_name = global_path.find (file, extensions);
  45
  46   /* By default, use base name of input file for output file name,
  47      write output to cwd; do not use root and directory parts of input
  48      file name.  */
  49   File_name out_file_name (file_name);
  50
  51   out_file_name.ext_ = "";
  52   out_file_name.root_ = "";
  53   if (ly_get_option (ly_symbol2scm ("gui")) != SCM_BOOL_T
  54       && ly_get_option (ly_symbol2scm ("strip-output-dir")) == SCM_BOOL_T)
  55     {
  56       out_file_name.dir_ = "";
  57     }
  58
  59   /* When running from gui, generate output in .ly source directory.  */
  60   string output_name = output_name_global;
  61   if (!output_name.empty ())
  62     {
  63       /* Interpret --output=DIR to mean --output=DIR/BASE.  */
  64       string dir;
  65       if (is_dir (output_name))
  66         {
  67           dir = output_name;
  68           output_name = "";
  69         }
  70       else
  71         {
  72           File_name out (output_name);
  73           dir = out.dir_part ();
  74           out_file_name = out.file_part ();
  75         }
  76
  77       if (dir != "" && dir != "." && dir != get_working_directory ())
  78         {
  79           global_path.prepend (get_working_directory ());
  80           message (_f ("Changing working directory to: `%s'", dir));
  81           // If we can't change to the output dir (not existing, wrong
  82           // permissions), exit lilypond
  83           if (chdir (dir.c_str ()) != 0)
  84             error (_f ("unable to change directory to: `%s'", dir));
  85         }
  86       else
  87         out_file_name = File_name (output_name);
  88     }
  89
  90   string init;
  91   if (!init_name_global.empty ())
  92     init = init_name_global;
  93   else
  94     init = "init.ly";
  95
  96   string out_file = out_file_name.to_string ();
  97   if (init.length () && global_path.find (init).empty ())
  98     {
  99       warning (_f ("cannot find init file: `%s'", init));
 100       warning (_f ("(search path: `%s')",
 101                    global_path.to_string ().c_str ()));
 102       exit (2);
 103     }
 104
 105   bool error = false;
 106   if ((file_name != "-") && file_name.empty ())
 107     {
 108       warning (_f ("cannot find file: `%s'", file));
 109       error = true;
 110     }
 111   else
 112     {
 113       Sources sources;
 114       sources.set_path (&global_path);
 115
 116       string mapped_fn = map_file_name (file_name);
 117       basic_progress (_f ("Processing `%s'", mapped_fn.c_str ()));
 118
 119       Lily_parser *parser = new Lily_parser (&sources);
 120
 121       parser->parse_file (init, file_name, out_file);
 122
 123       error = parser->error_level_;
 124
 125       parser->clear ();
 126       parser->unprotect ();
 127     }
 128
 129   /*
 130     outside the if-else to ensure cleanup fo Sources object,
 131   */
 132   if (error)
 133     /* TODO: pass renamed input file too.  */
 134     scm_throw (ly_symbol2scm ("ly-file-failed"),
 135                scm_list_1 (ly_string2scm (file_name)));
 136
 137   return SCM_UNSPECIFIED;
 138 }
 139
 140 LY_DEFINE (ly_parser_lexer, "ly:parser-lexer",
 141            1, 0, 0, (SCM parser_smob),
 142            "Return the lexer for @var{parser-smob}.")
 143 {
 144   Lily_parser *parser = unsmob_lily_parser (parser_smob);
 145   return parser->lexer_->self_scm ();
 146 }
 147
 148 LY_DEFINE (ly_parser_clone, "ly:parser-clone",
 149            1, 1, 0, (SCM parser_smob, SCM closures),
 150            "Return a clone of @var{parser-smob}.  An association list"
 151 " of port positions to closures can be specified in @var{closures}"
 152 " in order to have @code{$} and @code{#} interpreted in their original"
 153 " lexical environment.")
 154 {
 155   LY_ASSERT_SMOB (Lily_parser, parser_smob, 1);
 156   Lily_parser *parser = unsmob_lily_parser (parser_smob);
 157   if (SCM_UNBNDP (closures))
 158     closures = SCM_EOL;
 159   else
 160     LY_ASSERT_TYPE (ly_is_list, closures, 2);
 161   Lily_parser *clone = new Lily_parser (*parser, closures);
 162
 163   return clone->unprotect ();
 164 }
 165
 166 LY_DEFINE (ly_parser_define_x, "ly:parser-define!",
 167            3, 0, 0, (SCM parser_smob, SCM symbol, SCM val),
 168            "Bind @var{symbol} to @var{val} in @var{parser-smob}'s module.")
 169 {
 170
 171   LY_ASSERT_SMOB (Lily_parser, parser_smob, 1);
 172   Lily_parser *parser = unsmob_lily_parser (parser_smob);
 173
 174   LY_ASSERT_TYPE (ly_is_symbol, symbol, 2);
 175
 176   parser->lexer_->set_identifier (scm_symbol_to_string (symbol), val);
 177   return SCM_UNSPECIFIED;
 178 }
 179
 180 LY_DEFINE (ly_parser_lookup, "ly:parser-lookup",
 181            2, 0, 0, (SCM parser_smob, SCM symbol),
 182            "Look up @var{symbol} in @var{parser-smob}'s module."
 183            "  Return @code{'()} if not defined.")
 184 {
 185   LY_ASSERT_SMOB (Lily_parser, parser_smob, 1);
 186
 187   Lily_parser *parser = unsmob_lily_parser (parser_smob);
 188
 189   LY_ASSERT_TYPE (ly_is_symbol, symbol, 2);
 190
 191   SCM val = parser->lexer_->lookup_identifier (ly_symbol2string (symbol));
 192   if (val != SCM_UNDEFINED)
 193     return val;
 194   else
 195     return SCM_EOL;
 196 }
 197
 198 LY_DEFINE (ly_parser_parse_string, "ly:parser-parse-string",
 199            2, 0, 0, (SCM parser_smob, SCM ly_code),
 200            "Parse the string @var{ly-code} with @var{parser-smob}."
 201            "  Upon failure, throw @code{ly-file-failed} key.")
 202 {
 203   LY_ASSERT_SMOB (Lily_parser, parser_smob, 1);
 204   Lily_parser *parser = unsmob_lily_parser (parser_smob);
 205   LY_ASSERT_TYPE (scm_is_string, ly_code, 2);
 206
 207   if (!parser->lexer_->is_clean ())
 208     parser->parser_error (_ ("ly:parser-parse-string is only valid with a new parser."
 209                              "  Use ly:parser-include-string instead."));
 210   else
 211     parser->parse_string (ly_scm2string (ly_code));
 212
 213   return SCM_UNSPECIFIED;
 214 }
 215
 216 LY_DEFINE (ly_parse_string_expression, "ly:parse-string-expression",
 217            2, 2, 0, (SCM parser_smob, SCM ly_code, SCM filename,
 218                      SCM line),
 219            "Parse the string @var{ly-code} with @var{parser-smob}."
 220 " Return the contained music expression."
 221 " @var{filename} and @var{line} are optional source indicators.")
 222 {
 223   LY_ASSERT_SMOB (Lily_parser, parser_smob, 1);
 224   Lily_parser *parser = unsmob_lily_parser (parser_smob);
 225   LY_ASSERT_TYPE (scm_is_string, ly_code, 2);
 226   string fn;
 227   if (SCM_UNBNDP (filename))
 228     fn = "<string>";
 229   else {
 230     LY_ASSERT_TYPE (scm_is_string, filename, 3);
 231     fn = ly_scm2string (filename);
 232   }
 233   int ln;
 234   if (SCM_UNBNDP (line))
 235     ln = 0;
 236   else {
 237     LY_ASSERT_TYPE (scm_is_integer, line, 4);
 238     ln = scm_to_int (line);
 239   }
 240
 241   if (!parser->lexer_->is_clean ())
 242     {
 243       parser->parser_error (_ ("ly:parse-string-expression is only valid with a new parser."
 244                                "  Use ly:parser-include-string instead."));
 245       return SCM_UNSPECIFIED;
 246     }
 247
 248   return parser->parse_string_expression (ly_scm2string (ly_code),
 249                                           fn, ln);
 250 }
 251
 252 LY_DEFINE (ly_parser_include_string, "ly:parser-include-string",
 253            2, 0, 0, (SCM parser_smob, SCM ly_code),
 254            "Include the string @var{ly-code} into the input stream"
 255            " for @var{parser-smob}.  Can only be used in immediate"
 256            " Scheme expressions (@code{$} instead of @code{#}).")
 257 {
 258   LY_ASSERT_SMOB (Lily_parser, parser_smob, 1);
 259   Lily_parser *parser = unsmob_lily_parser (parser_smob);
 260   LY_ASSERT_TYPE (scm_is_string, ly_code, 2);
 261
 262   parser->include_string (ly_scm2string (ly_code));
 263
 264   return SCM_UNSPECIFIED;
 265 }
 266
 267 LY_DEFINE (ly_parser_set_note_names, "ly:parser-set-note-names",
 268            2, 0, 0, (SCM parser, SCM names),
 269            "Replace current note names in @var{parser}."
 270            "  @var{names} is an alist of symbols.  This only has effect"
 271            " if the current mode is notes.")
 272 {
 273   LY_ASSERT_SMOB (Lily_parser, parser, 1);
 274   Lily_parser *p = unsmob_lily_parser (parser);
 275
 276   if (p->lexer_->is_note_state ())
 277     {
 278       p->lexer_->pop_state ();
 279       p->lexer_->push_note_state (alist_to_hashq (names));
 280     }
 281
 282   return SCM_UNSPECIFIED;
 283 }
 284
 285 LY_DEFINE (ly_parser_set_repetition_symbol, "ly:parser-set-repetition-symbol",
 286            2, 0, 0, (SCM parser, SCM sym),
 287            "Replace the current repetition symbol in @var{parser}."
 288            "  @var{sym} is the new repetition symbol.")
 289 {
 290   LY_ASSERT_SMOB (Lily_parser, parser, 1);
 291   Lily_parser *p = unsmob_lily_parser (parser);
 292
 293   p->lexer_->chord_repetition_.repetition_symbol_ = sym;
 294
 295   return SCM_UNSPECIFIED;
 296 }
 297
 298 LY_DEFINE (ly_parser_set_repetition_function, "ly:parser-set-repetition-function",
 299            2, 0, 0, (SCM parser, SCM fun),
 300            "Replace the current repetition function in @var{parser}."
 301            "  @var{fun} is the new repetition function.")
 302 {
 303   LY_ASSERT_SMOB (Lily_parser, parser, 1);
 304   Lily_parser *p = unsmob_lily_parser (parser);
 305
 306   p->lexer_->chord_repetition_.repetition_function_ = fun;
 307
 308   return SCM_UNSPECIFIED;
 309 }
 310
 311 LY_DEFINE (ly_parser_output_name, "ly:parser-output-name",
 312            1, 0, 0, (SCM parser),
 313            "Return the base name of the output file.")
 314 {
 315   LY_ASSERT_SMOB (Lily_parser, parser, 1);
 316   Lily_parser *p = unsmob_lily_parser (parser);
 317
 318   return ly_string2scm (p->output_basename_);
 319 }
 320
 321 LY_DEFINE (ly_parser_error, "ly:parser-error",
 322            2, 1, 0, (SCM parser, SCM msg, SCM input),
 323            "Display an error message and make the parser fail.")
 324 {
 325   LY_ASSERT_SMOB (Lily_parser, parser, 1);
 326   Lily_parser *p = unsmob_lily_parser (parser);
 327
 328   LY_ASSERT_TYPE (scm_is_string, msg, 2);
 329   string s = ly_scm2string (msg);
 330
 331   Input *i = unsmob_input (input);
 332   if (i)
 333     p->parser_error (*i, s);
 334   else
 335     p->parser_error (s);
 336
 337   return parser;
 338 }
 339
 340 LY_DEFINE (ly_parser_clear_error, "ly:parser-clear-error",
 341            1, 0, 0, (SCM parser),
 342            "Clear the error flag for the parser.")
 343 {
 344   LY_ASSERT_SMOB (Lily_parser, parser, 1);
 345   Lily_parser *p = unsmob_lily_parser (parser);
 346
 347   p->error_level_ = 0;
 348   p->lexer_->error_level_ = 0;
 349
 350   return SCM_UNSPECIFIED;
 351 }
 352
 353 LY_DEFINE (ly_parser_has_error_p, "ly:parser-has-error?",
 354            1, 0, 0, (SCM parser),
 355            "Does @var{parser} have an error flag?")
 356 {
 357   LY_ASSERT_SMOB (Lily_parser, parser, 1);
 358   Lily_parser *p = unsmob_lily_parser (parser);
 359
 360   return scm_from_bool (p->error_level_ || p->lexer_->error_level_);
 361 }