pyparsing 3.2.2__tar.gz → 3.2.4__tar.gz

{pyparsing-3.2.2 → pyparsing-3.2.4}/CHANGES

@@ -35,7 +35,7 @@ Required Python versions by pyparsing version
 +--------------------------------------------------+-------------------+
 | pyparsing version                                | Required Python   |
 +==================================================+===================+
-| 3.2.0 - 3.2.2                                    | 3.9 or later      |
+| 3.2.0 - later                                    | 3.9 or later      |
 | 3.0.8 - 3.1.4                                    | 3.6.8 or later    |
 | 3.0.0 - 3.0.7 (these versions are discouraged)   | 3.6 or later      |
 | 2.4.7                                            | 2.7 or later      |
@@ -43,6 +43,41 @@ Required Python versions by pyparsing version
 +--------------------------------------------------+-------------------+
 
 
+Version 3.2.4 - September, 2025
+-------------------------------
+- Barring any catastrophic bugs in this release, this will be the last release in
+  the 3.2.x line. The next release, 3.3.0, will begin emitting `DeprecationWarnings`
+  when the pre-PEP8 methods are used (see header notes above for more information,
+  including available automation for converting any existing code using
+  pyparsing with the old names).
+
+- Fixed bug when using a copy of a `Word` expression (either by using the explicit
+  `copy()` method, or attaching a results name), and setting a new expression name,
+  a raised `ParseException` still used the original expression name. Also affected
+  `Regex` expressions with `as_match` or `as_group_list` = True. Reported by
+  Waqas Ilyas, in Issue #612 - good catch!
+
+- Fixed type annotation for `replace_with`, to accept `Any` type. Fixes Issue #602,
+  reported by esquonk.
+
+- Added locking around potential race condition in `ParserElement.reset_cache`, as
+  well as other cache-related methods. Fixes Issue #604, reported by CarlosDescalziIM.
+
+- Substantial update to docstrings and doc generation in preparation for 3.3.0,
+  great effort by FeRD, thanks!
+
+- Notable addition by FeRD to convert docstring examples to work with doctest! This
+  was long overdue, thanks so much!
+
+
+Version 3.2.3 - March, 2025
+---------------------------
+- Fixed bug released in 3.2.2 in which `nested_expr` could overwrite parse actions
+  for defined content, and could truncate list of items within a nested list.
+  Fixes Issue #600, reported by hoxbro and luisglft, with helpful diag logs and
+  repro code.
+
+
 Version 3.2.2 - March, 2025
 ---------------------------
 - Released `cvt_pyparsing_pep8_names.py` conversion utility to upgrade pyparsing-based
@@ -248,7 +283,7 @@ Version 3.1.3 - August, 2024
   Example:
 
         # add tag indicating mood
-        end_punc = "." | ("!" + Tag("enthusiastic")))
+        end_punc = "." | ("!" + Tag("enthusiastic"))
         greeting = "Hello" + Word(alphas) + end_punc
 
         result = greeting.parse_string("Hello World.")

{pyparsing-3.2.2 → pyparsing-3.2.4}/CONTRIBUTING.md

@@ -1,4 +1,4 @@
-# CONTRIBUTING
+# Contributing to Pyparsing
 
 Thank you for your interest in working on pyparsing! Pyparsing has become a popular module for creating simple
 text parsing and data scraping applications. It has been incorporated in several widely-used packages, and is
@@ -38,41 +38,49 @@ If you have a question on using pyparsing, there are a number of resources avail
 
 If you have an example you wish to submit, please follow these guidelines.
 
-- **License - Submitted example code must be available for distribution with the rest of pyparsing under the MIT 
+- **License - Submitted example code must be available for distribution with the rest of pyparsing under the MIT
   open source license.**
 
 - Please follow PEP8 name and coding guidelines, and use the black formatter
-  to auto-format code. 
+  to auto-format code.
 
 - Examples should import pyparsing and the common namespace classes as:
 
-      import pyparsing as pp
-      # if necessary
-      ppc = pp.pyparsing_common
-      ppu = pp.pyparsing_unicode
+  ```python
+  import pyparsing as pp
+  # if necessary
+  ppc = pp.pyparsing_common
+  ppu = pp.pyparsing_unicode
+  ```
 
-- Submitted examples *must* be Python 3.6.8 or later compatible. (It is acceptable if examples use Python
-  features added after 3.6)
+- Submitted examples _must_ be Python 3.6.8 or later compatible.
+  (It is acceptable if examples use Python features added after 3.6)
 
 - Where possible use operators to create composite parse expressions:
 
-      expr = expr_a + expr_b | expr_c
+  ```python
+  expr = expr_a + expr_b | expr_c
+  ```
 
   instead of:
 
-      expr = pp.MatchFirst([pp.And([expr_a, expr_b]), expr_c])
+  ```python
+  expr = pp.MatchFirst([pp.And([expr_a, expr_b]), expr_c])
+  ```
 
   Exception: if using a generator to create an expression:
 
-      import keyword
-      python_keywords = keyword.kwlist
-      any_keyword = pp.MatchFirst(pp.Keyword(kw)
-                                  for kw in python_keywords))
+  ```python
+  import keyword
+  python_keywords = keyword.kwlist
+  any_keyword = pp.MatchFirst(pp.Keyword(kw)
+                              for kw in python_keywords))
+  ```
 
-- Learn [Common Pitfalls When Writing Parsers](https://github.com/pyparsing/pyparsing/wiki/Common-Pitfalls-When-Writing-Parsers) and
+- Learn [Common Pitfalls When Writing Parsers][pitfalls] and
   how to avoid them when developing new examples.
 
-- See additional notes under [Some Coding Points](#some-coding-points).
+- See additional notes under [Some coding points](#some-coding-points).
 
 ## Submitting changes
 
@@ -88,11 +96,11 @@ intended on prior versions of Python (currently back to Python 3.6.8).
 
 ## Some design points
 
-- Minimize additions to the module namespace. Over time, pyparsing's namespace has acquired a *lot* of names.
+- Minimize additions to the module namespace. Over time, pyparsing's namespace has acquired a _lot_ of names.
   New features have been encapsulated into namespace classes to try to hold back the name flooding when importing
   pyparsing.
 
-- New operator overloads for ParserElement will need to show broad applicability, and should be related to 
+- New operator overloads for ParserElement will need to show broad applicability, and should be related to
   parser construction.
 
 - Performance tuning should focus on parse time performance. Optimizing parser definition performance is secondary.
@@ -108,28 +116,87 @@ These coding styles are encouraged whether submitting code for core pyparsing or
   name casing. I had just finished several years of Java and Smalltalk development, and camel case seemed to be the
   future trend in coding styles. As of version 3.0.0, pyparsing is moving over to PEP8 naming, while maintaining
   compatibility with existing parser code by defining synonyms using the legacy names. These names will be
-  retained until a future release (probably 4.0), to provide a migration path for current pyparsing-dependent 
+  retained until a future release (probably 4.0), to provide a migration path for current pyparsing-dependent
   applications - DO NOT MODIFY OR REMOVE THESE NAMES.
   See more information at the [PEP8 wiki page](https://github.com/pyparsing/pyparsing/wiki/PEP-8-planning).
 
 - No backslashes for line continuations.
-  Continuation lines for expressions in ()'s should start with the continuing operator:
+  Continuation lines for expressions in `()`'s should start with the continuing operator:
 
-      really_long_line = (something
-                          + some_other_long_thing
-                          + even_another_long_thing)
+  ```python
+  really_long_line = (something
+                      + some_other_long_thing
+                      + even_another_long_thing)
+  ```
 
 - Maximum line length is 120 characters. (Black will override this.)
 
 - Changes to core pyparsing must be compatible back to Py3.6 without conditionalizing. Later Py3 features may be
   used in examples by way of illustration.
 
-- str.format() statements should use named format arguments (unless this proves to be a slowdown at parse time).
+- `str.format()` statements should use named format arguments (unless this proves to be a slowdown at parse time).
 
 - List, tuple, and dict literals should include a trailing comma after the last element, which reduces changeset
   clutter when another element gets added to the end.
 
-- New features should be accompanied by updates to unitTests.py and a bullet in the CHANGES file.
+- New features should be accompanied by updates to `unitTests.py` and a bullet in the CHANGES file.
 
-- Do not modify pyparsing_archive.py. This file is kept as a reference artifact from when pyparsing was distributed
+- Do not modify `pyparsing_archive.py`. This file is kept as a reference artifact from when pyparsing was distributed
   as a single source file.
+
+## Some documentation points
+
+- The docstrings in pyparsing (which are generated into the package's
+  API documentation by Sphinx) make heavy use of doctests for their
+  example code. This allows examples to be tested and verified as
+  working, and ensures that any changes to the code which affect
+  output are accompanied by corresponding changes in the examples.
+
+- The codebase's docstring tests can be verified by running the
+  command `make doctest` from the `docs/` directory. The output
+  should ideally look something like this:
+
+  ```console
+  $ make doctest
+  [...documentation build...]
+  running tests...
+
+  Document: pyparsing
+  -------------------
+  1 item passed all tests:
+   204 tests in default
+  204 tests in 1 item.
+  204 passed.
+  Test passed.
+
+  Document: whats_new_in_3_1
+  --------------------------
+  1 item passed all tests:
+    15 tests in default
+  15 tests in 1 item.
+  15 passed.
+  Test passed.
+
+  Doctest summary
+  ===============
+    219 tests
+      0 failures in tests
+      0 failures in setup code
+      0 failures in cleanup code
+  ```
+
+  Any failed tests will be displayed in detail.
+
+- Much more information about doctests can be found in the
+  [Pyparsing documentation][pyparsing-docs], in the chapter titled
+  "Writing doctest examples". Even if you have never worked with them
+  before, it should guide you through everything you need to know in
+  order to write Pyparsing doctest examples. If you are already familiar
+  with doctests and with `sphinx.ext.doctest` in general, you may wish
+  to skip over the introductory content and go straight to the section
+  on "Doctests in Pyparsing" which covers some issues specific to the
+  project.
+
+<!-- Named hyperlink targets, used in the preceding text -->
+[pitfalls]: https://github.com/pyparsing/pyparsing/wiki/Common-Pitfalls-When-Writing-Parsers
+[pyparsing-docs]: https://pyparsing-docs.readthedocs.io/en/latest/

{pyparsing-3.2.2 → pyparsing-3.2.4}/PKG-INFO

@@ -1,14 +1,14 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: pyparsing
-Version: 3.2.2
-Summary: pyparsing module - Classes and methods to define and execute parsing grammars
+Version: 3.2.4
+Summary: pyparsing - Classes and methods to define and execute parsing grammars
 Author-email: Paul McGuire <ptmcg.gm+pyparsing@gmail.com>
 Requires-Python: >=3.9
 Description-Content-Type: text/x-rst
+License-Expression: MIT
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Information Technology
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
@@ -24,6 +24,7 @@ Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Topic :: Software Development :: Compilers
 Classifier: Topic :: Text Processing
 Classifier: Typing :: Typed
+License-File: LICENSE
 Requires-Dist: railroad-diagrams ; extra == "diagrams"
 Requires-Dist: jinja2 ; extra == "diagrams"
 Project-URL: Homepage, https://github.com/pyparsing/pyparsing/

pyparsing-3.2.4/docs/CONTRIBUTING.md

@@ -0,0 +1 @@
+../CONTRIBUTING.md

{pyparsing-3.2.2 → pyparsing-3.2.4}/docs/HowToUsePyparsing.rst

@@ -19,8 +19,6 @@ Using the pyparsing module
     expressions, processing custom application language commands, or
     extracting data from formatted reports.
 
-.. sectnum::    :depth: 4
-
 .. contents::   :depth: 4
 
 Note: While this content is still valid, there are more detailed