mirror of
https://github.com/python/cpython
synced 2024-07-20 09:15:43 +00:00
8f59ee01be
* Add tokenization of :=
- Add token to Include/token.h. Add token to documentation in Doc/library/token.rst.
- Run `./python Lib/token.py` to regenerate Lib/token.py.
- Update Parser/tokenizer.c: add case to handle `:=`.
* Add initial usage of := in grammar.
* Update Python.asdl to match the grammar updates. Regenerated Include/Python-ast.h and Python/Python-ast.c
* Update AST and compiler files in Python/ast.c and Python/compile.c. Basic functionality, this isn't scoped properly
* Regenerate Lib/symbol.py using `./python Lib/symbol.py`
* Tests - Fix failing tests in test_parser.py due to changes in token numbers for internal representation
* Tests - Add simple test for := token
* Tests - Add simple tests for named expressions using expr and suite
* Tests - Update number of levels for nested expressions to prevent stack overflow
* Update symbol table to handle NamedExpr
* Update Grammar to allow assignment expressions in if statements.
Regenerate Python/graminit.c accordingly using `make regen-grammar`
* Tests - Add additional tests for named expressions in RoundtripLegalSyntaxTestCase, based on examples and information directly from PEP 572
Note: failing tests are currently commented out (4 out of 24 tests currently fail)
* Tests - Add temporary syntax test failure tests in test_parser.py
Note: There is an outstanding TODO for this -- syntax tests need to be
moved to a different file (presumably test_syntax.py), but this is
covering what needs to be tested at the moment, and it's more convenient
to run a single test for the time being
* Add support for allowing assignment expressions as function argument annotations. Uncomment tests for these cases because they all pass now!
* Tests - Move existing syntax tests out of test_parser.py and into test_named_expressions.py. Refactor syntax tests to use unittest
* Add TargetScopeError exception to extend SyntaxError
Note: This simply creates the TargetScopeError exception, it is not yet
used anywhere
* Tests - Update tests per PEP 572
Continue refactoring test suite:
The named expression test suite now checks for any invalid cases that
throw exceptions (no longer limited to SyntaxErrors), assignment tests
to ensure that variables are properly assigned, and scope tests to
ensure that variable availability and values are correct
Note:
- There are still tests that are marked to skip, as they are not yet
implemented
- There are approximately 300 lines of the PEP that have not yet been
addressed, though these may be deferred
* Documentation - Small updates to XXX/todo comments
- Remove XXX from child description in ast.c
- Add comment with number of previously supported nested expressions for
3.7.X in test_parser.py
* Fix assert in seq_for_testlist()
* Cleanup - Denote "Not implemented -- No keyword args" on failing test case. Fix PEP8 error for blank lines at beginning of test classes in test_parser.py
* Tests - Wrap all file opens in `with...as` to ensure files are closed
* WIP: handle f(a := 1)
* Tests and Cleanup - No longer skips keyword arg test. Keyword arg test now uses a simpler test case and does not rely on an external file. Remove print statements from ast.c
* Tests - Refactor last remaining test case that relied on on external file to use a simpler test case without the dependency
* Tests - Add better description of remaning skipped tests. Add test checking scope when using assignment expression in a function argument
* Tests - Add test for nested comprehension, testing value and scope. Fix variable name in skipped comprehension scope test
* Handle restriction of LHS for named expressions - can only assign to LHS of type NAME. Specifically, restrict assignment to tuples
This adds an alternative set_context specifically for named expressions,
set_namedexpr_context. Thus, context is now set differently for standard
assignment versus assignment for named expressions in order to handle
restrictions.
* Tests - Update negative test case for assigning to lambda to match new error message. Add negative test case for assigning to tuple
* Tests - Reorder test cases to group invalid syntax cases and named assignment target errors
* Tests - Update test case for named expression in function argument - check that result and variable are set correctly
* Todo - Add todo for TargetScopeError based on Guido's comment (
|
||
---|---|---|
.. | ||
bdist_wininst | ||
clinic | ||
icons | ||
layout | ||
_msi.c | ||
_testconsole.c | ||
classicAppCompat.can.xml | ||
classicAppCompat.cat | ||
classicAppCompat.sccd | ||
config.c | ||
dl_nt.c | ||
empty.c | ||
errmap.h | ||
errmap.mak | ||
frozen_dllmain.c | ||
generrmap.c | ||
getpathp.c | ||
invalid_parameter_handler.c | ||
launcher.c | ||
msvcrtmodule.c | ||
pyconfig.h | ||
pylauncher.rc | ||
pyshellext.cpp | ||
pyshellext.def | ||
pyshellext.idl | ||
pyshellext.rc | ||
pyshellext_d.def | ||
python.manifest | ||
python3.def | ||
python3dll.c | ||
python_exe.rc | ||
python_nt.rc | ||
python_uwp.cpp | ||
python_ver_rc.h | ||
pythonw_exe.rc | ||
readme.txt | ||
sqlite3.rc | ||
store_info.txt | ||
testpy.py | ||
validate_ucrtbase.py | ||
WinMain.c | ||
winreg.c | ||
winsound.c |
Welcome to the "PC" subdirectory of the Python distribution *********************************************************** This "PC" subdirectory contains complete project files to make several older PC ports of Python, as well as all the PC-specific Python source files. It should be located in the root of the Python distribution, and there should be directories "Modules", "Objects", "Python", etc. in the parent directory of this "PC" subdirectory. Be sure to read the documentation in the Python distribution. Python requires library files such as string.py to be available in one or more library directories. The search path of libraries is set up when Python starts. To see the current Python library search path, start Python and enter "import sys" and "print sys.path". All PC ports use this scheme to try to set up a module search path: 1) The script location; the current directory without script. 2) The PYTHONPATH variable, if set. 3) For Win32 platforms (NT/95), paths specified in the Registry. 4) Default directories lib, lib/win, lib/test, lib/tkinter; these are searched relative to the environment variable PYTHONHOME, if set, or relative to the executable and its ancestors, if a landmark file (Lib/string.py) is found , or the current directory (not useful). 5) The directory containing the executable. The best installation strategy is to put the Python executable (and DLL, for Win32 platforms) in some convenient directory such as C:/python, and copy all library files and subdirectories (using XCOPY) to C:/python/lib. Then you don't need to set PYTHONPATH. Otherwise, set the environment variable PYTHONPATH to your Python search path. For example, set PYTHONPATH=.;d:\python\lib;d:\python\lib\win;d:\python\lib\dos-8x3 There are several add-in modules to build Python programs which use the native Windows operating environment. The ports here just make "QuickWin" and DOS Python versions which support a character-mode (console) environment. Look in www.python.org for Tkinter, PythonWin, WPY and wxPython. To make a Python port, start the Integrated Development Environment (IDE) of your compiler, and read in the native "project file" (or makefile) provided. This will enable you to change any source files or build settings so you can make custom builds. pyconfig.h An important configuration file specific to PC's. config.c The list of C modules to include in the Python PC version. Manually edit this file to add or remove Python modules. testpy.py A Python test program. Run this to test your Python port. It should produce copious output, ending in a report on how many tests were OK, how many failed, and how many were skipped. Don't worry about skipped tests (these test unavailable optional features). Additional files and subdirectories for 32-bit Windows ====================================================== python_nt.rc Resource compiler input for python15.dll. dl_nt.c Additional sources used for 32-bit Windows features. getpathp.c Default sys.path calculations (for all PC platforms). dllbase_nt.txt A (manually maintained) list of base addresses for various DLLs, to avoid run-time relocation. Note for Windows 3.x and DOS users ================================== Neither Windows 3.x nor DOS is supported any more. The last Python version that supported these was Python 1.5.2; the support files were present in Python 2.0 but weren't updated, and it is not our intention to support these platforms for Python 2.x.