openpyxl-enhanced 3.2.0b3__tar.gz

openpyxl_enhanced-3.2.0b3/AUTHORS.rst

@@ -0,0 +1,98 @@
+This project was started by Eric Gazoni. In 2013 Charlie Clark became
+co-maintainer of the project.
+
+It was initially *heavily* inspired by the PHPExcel library:
+http://www.phpexcel.net/
+
+Thanks to all those who participate in the project (in alphabetical order):
+
+* aceMueller
+* Adam Lofts
+* Adam Morris
+* Alessandro Cucci
+* Alex Gronholm
+* Alexander Ley
+* Alexandre Fayolle
+* Amin Mirzaee
+* Anders Chrigstrom
+* Anthony Hayward
+* Bernt R. Brenna
+* Brent Hoover
+* Brice Gelineau
+* ccoacley
+* Chi Ho Kwok
+* Cory Kramer
+* Day Barr
+* Detlef Lannert
+* Dieter Vandenbussche
+* Dmitriy Chernyshov
+* Dominik Geldmacher
+* Don Freeman
+* Eirikur Fannar Torfason
+* Elias Rabel
+* Eric Chlebek
+* Eric Gazoni
+* Eric Hurkman
+* Etienne Desautels
+* Felipe Ochoa
+* Felix Siebeneicker
+* Fumito Hamamura
+* Gabi Nagy
+* Gar Thompson
+* Gerald Van Huffelen
+* Greg Lehmann
+* Heikki Junes
+* Israel Barth Rubio
+* Jacob Middag
+* James Smagala
+* JarekPS
+* Jean Pierre Huart
+* Jeff Holman
+* John Woltman IV
+* Jonathan Peirce
+* Joseph Tate
+* Josh Haywood
+* Jun Omae
+* Kay Webber
+* Khchine Hamza
+* Klaus Bremer
+* Koert van der Veer
+* Laurent Laporte
+* Laurent Vasseur
+* Liam Sanders
+* Maarten De Paepe
+* Magnus Schieder
+* Mark Gemmill
+* Marko Loparic
+* Masato Yoshida
+* Max Bolingbroke
+* Nicholas Laver
+* Nis Martensen
+* Paul Joyce
+* Paul Van Der Linden
+* Philip Roche
+* Primoz Godec
+* ramn_se
+* René Neumann
+* Rick Rankin
+* Samuel Loretan
+* Sergey Pikhovkin
+* Shekhar Gyanwali
+* Shibukawa Yoshiki
+* Stefan Behnel
+* Stephane Bard
+* Stephen Rauch
+* Sven Burk
+* Ted Pollari
+* Thomas Nygards
+* Victor Korobkovsky
+* Waldemar Osuch
+* Wojciech Rola
+* Wolfgane Scherer
+* Yaroslav Halchenko
+* Yash Jhunjhunwala
+* Yingjie Lan
+* Leetao
+
+Project logo designed by Eric Gazoni, font by claudeserieux
+(http://www.dafont.com/profile.php?user=337503)

openpyxl_enhanced-3.2.0b3/LICENCE.rst

@@ -0,0 +1,23 @@
+This software is under the MIT Licence
+======================================
+
+Copyright (c) 2010 openpyxl
+
+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.

openpyxl_enhanced-3.2.0b3/MANIFEST.in

@@ -0,0 +1,8 @@
+prune openpyxl/sample
+prune openpyxl/benchmarks
+prune openpyxl/develop
+prune scratchpad
+prune doc
+
+include *.rst
+include README.md README.ru.md README.pypi.md PUBLISHING.md

openpyxl_enhanced-3.2.0b3/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: openpyxl-enhanced
+Version: 3.2.0b3
+Summary: An openpyxl fork for Excel xlsx/xlsm files with formula-aware row/column edits and merged-cell formatting fixes
+Home-page: https://github.com/EugeneRymarev/openpyxl-enhanced
+Author: See AUTHORS
+Maintainer: EugeneRymarev
+License: MIT
+Project-URL: Documentation, https://github.com/EugeneRymarev/openpyxl-enhanced#readme
+Project-URL: Source, https://github.com/EugeneRymarev/openpyxl-enhanced
+Project-URL: Tracker, https://github.com/EugeneRymarev/openpyxl-enhanced/issues
+Project-URL: Upstream, https://foss.heptapod.net/openpyxl/openpyxl
+Keywords: openpyxl,excel,xlsx,xlsm,spreadsheet,formulas,merged cells
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Office/Business :: Financial :: Spreadsheet
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENCE.rst
+Requires-Dist: et_xmlfile
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: maintainer
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# openpyxl-enhanced
+
+**openpyxl-enhanced** is an independent fork of
+[openpyxl](https://foss.heptapod.net/openpyxl/openpyxl), a Python library for
+reading and writing Excel `.xlsx`, `.xlsm`, `.xltx` and `.xltm` files.
+It is based on the upstream 3.2 development line. This release is **3.2.0b3**
+(beta), for Python **3.8 or newer**.
+
+The distribution is named **openpyxl-enhanced**; the Python import remains **openpyxl**.
+This fork is maintained separately from the original openpyxl project.
+
+Previously published as `openpyxl2`. The distribution and GitHub repository
+are now named `openpyxl-enhanced`; existing `openpyxl` imports stay the same.
+
+## Installation
+
+Use a fresh virtual environment:
+
+```sh
+python -m venv .venv
+# Windows: .venv\Scripts\activate
+# Linux/macOS: source .venv/bin/activate
+python -m pip install openpyxl-enhanced==3.2.0b3
+```
+
+Do not install `openpyxl` and `openpyxl-enhanced` together: they provide the same
+`openpyxl` module and can overwrite each other's files. `pip install openpyxl`
+installs the original project. Dependencies that explicitly require the
+`openpyxl` distribution are **not** satisfied by `openpyxl-enhanced`; check your
+application's dependencies before switching.
+
+If upgrading from the previous `openpyxl2` distribution, remove it before
+installing this package, or create a fresh environment. Both distributions
+provide the same `openpyxl` module:
+
+```sh
+python -m pip uninstall openpyxl2
+python -m pip install openpyxl-enhanced==3.2.0b3
+```
+
+## What this fork changes
+
+- Inserting and deleting rows or columns updates supported formula references,
+  merged ranges, defined names, print areas and row/column dimensions.
+- Partially deleted merged ranges retain the surviving anchor's value and style.
+- Styles assigned after merging propagate through the merged range, with borders
+  applied to its perimeter. Stored merged-cell styles survive save/load cycles.
+- Additional fixes cover named styles, XML backends and workbook resource handling.
+
+```python
+from openpyxl import Workbook, load_workbook
+
+workbook = Workbook()
+sheet = workbook.active
+sheet.append(["Item", "Units"])
+sheet.append(["Pens", 10])
+sheet.append(["Folders", 20])
+sheet["B4"] = "=SUM(B2:B3)"
+sheet.insert_rows(2)
+assert sheet["B5"].value == "=SUM(B3:B4)"
+workbook.save("sales.xlsx")
+
+restored = load_workbook("sales.xlsx")
+assert restored.active["B5"].value == "=SUM(B3:B4)"
+restored.close()
+```
+
+## Scope and compatibility
+
+Structural edits support direct A1 formula references, including absolute and
+mixed references. They do not update every Excel feature: tables, charts, pivot
+tables, validation, conditional formatting and external workbook references
+require separate handling. Unsupported formula constructs can raise
+`FormulaTranslationError` before an edit is applied. The library rewrites
+formulas but does not calculate their results.
+
+The fork removes the `openpyxl.open` alias; use `openpyxl.load_workbook`.
+Named-style equality compares names. See the
+[full feature list and limitations](https://github.com/EugeneRymarev/openpyxl-enhanced#readme)
+and the [Russian README](https://github.com/EugeneRymarev/openpyxl-enhanced/blob/master/README.ru.md)
+for details and examples.
+
+`et_xmlfile` is a required dependency and is installed automatically. Optional
+packages include `lxml` for XML processing, `Pillow` for images and `defusedxml`
+for XML protection when handling untrusted files.
+
+## Project and license
+
+- [Source and examples](https://github.com/EugeneRymarev/openpyxl-enhanced)
+- [Report a fork issue](https://github.com/EugeneRymarev/openpyxl-enhanced/issues)
+- [Upstream API documentation](https://openpyxl.pages.heptapod.net/openpyxl/)
+- [Original authors and contributors](https://github.com/EugeneRymarev/openpyxl-enhanced/blob/master/AUTHORS.rst)
+
+Distributed under the MIT license. The original openpyxl copyright notice and
+license are preserved in `LICENCE.rst` in the distribution.

openpyxl_enhanced-3.2.0b3/PUBLISHING.md

@@ -0,0 +1,143 @@
+# Публикация openpyxl-enhanced в PyPI
+
+Подготовлены следующие данные:
+
+| Поле | Значение |
+| --- | --- |
+| Имя дистрибутива в PyPI | `openpyxl-enhanced` |
+| Версия | `3.2.0b3` — бета с обновлёнными поисковыми метаданными |
+| Импорт в Python | `import openpyxl` |
+| Python | `>=3.8` |
+| Лицензия | MIT, исходный текст в `LICENCE.rst` |
+| Авторы | `See AUTHORS`, оригинальный список в `AUTHORS.rst` |
+| Сопровождающий форка | `EugeneRymarev` — имя владельца GitHub-репозитория |
+| Репозиторий | https://github.com/EugeneRymarev/openpyxl-enhanced |
+| Трекер | https://github.com/EugeneRymarev/openpyxl-enhanced/issues |
+| Описание для страницы PyPI | `README.pypi.md` |
+| Обязательная зависимость | `et_xmlfile` |
+| Форматы | универсальный wheel `py3-none-any` и sdist `.tar.gz` |
+
+Публичный email сопровождающего не указан. Адреса авторов upstream не
+используются как контакты поддержки форка. Владельцем проекта на PyPI станет
+аккаунт, который выполнит первую разрешённую загрузку; поле `maintainer` не
+выдаёт права доступа.
+
+Проект опубликован в PyPI: https://pypi.org/project/openpyxl-enhanced/.
+Дистрибутив переименован из `openpyxl2` в `openpyxl-enhanced`; версия
+осталась `3.2.0b3`. Импорт `openpyxl` и поведение библиотеки сохранены.
+
+## 1. Собрать и проверить
+
+Команды ниже рассчитаны на PowerShell из корня репозитория. Для сборки удобно
+использовать Python 3.12 или новее, независимо от минимальной версии библиотеки.
+
+```powershell
+py -3.12 -m venv .tox/pypi-build
+$publishPython = '.\.tox\pypi-build\Scripts\python.exe'
+& $publishPython -m pip install --upgrade pip build twine
+& $publishPython -m build --outdir dist/pypi/openpyxl-enhanced/3.2.0b3
+& $publishPython -m twine check --strict dist/pypi/openpyxl-enhanced/3.2.0b3/openpyxl_enhanced-3.2.0b3*
+```
+
+Результат:
+
+- `dist/pypi/openpyxl-enhanced/3.2.0b3/openpyxl_enhanced-3.2.0b3-py3-none-any.whl`
+- `dist/pypi/openpyxl-enhanced/3.2.0b3/openpyxl_enhanced-3.2.0b3.tar.gz`
+
+Проверка установленного wheel отдельно от исходников и необязательных зависимостей:
+
+```powershell
+py -3.12 -m venv .tox/enhanced-smoke
+$smokePython = '.\.tox\enhanced-smoke\Scripts\python.exe'
+& $smokePython -m pip install dist/pypi/openpyxl-enhanced/3.2.0b3/openpyxl_enhanced-3.2.0b3-py3-none-any.whl
+& $smokePython -m pip check
+& $smokePython -I .github/scripts/check_wheel.py
+```
+
+Если эти окружения уже использовались для других пакетов, создайте новые с
+другими именами. Не устанавливайте оригинальный `openpyxl` в окружение форка:
+файлы модулей пересекаются. Требования сторонних библиотек вида `openpyxl>=...`
+не удовлетворяются пакетом `openpyxl-enhanced`, и pip может дополнительно поставить
+оригинал. Учитывайте это при выборе зависимостей приложения.
+
+Локальный `.pypirc` содержит настройки и токены PyPI/TestPyPI и исключён
+из Git. Команды загрузки ниже читают его через `--config-file .pypirc`.
+Не включайте этот файл в архивы или коммиты.
+
+## 2. Проверить загрузку через TestPyPI
+
+Зарегистрируйте отдельный аккаунт на https://test.pypi.org/account/register/,
+подтвердите email, настройте двухфакторную аутентификацию и создайте API token.
+Для первой загрузки нового проекта нужен токен с областью `Entire account`.
+TestPyPI и PyPI имеют отдельные аккаунты и токены.
+
+```powershell
+& $publishPython -m twine upload --config-file .pypirc --repository testpypi --username __token__ dist/pypi/openpyxl-enhanced/3.2.0b3/openpyxl_enhanced-3.2.0b3*
+```
+
+При запросе пароля вставьте токен целиком, включая префикс `pypi-`.
+Не записывайте токен в исходники или команду. Откройте страницу
+https://test.pypi.org/project/openpyxl-enhanced/3.2.0b3/ и проверьте описание и ссылки.
+
+Проверка установки с TestPyPI в новом окружении:
+
+```powershell
+py -3.12 -m venv .tox/testpypi-smoke
+$testPython = '.\.tox\testpypi-smoke\Scripts\python.exe'
+& $testPython -m pip install --index-url https://pypi.org/simple et_xmlfile
+& $testPython -m pip install --index-url https://test.pypi.org/simple/ --no-deps openpyxl-enhanced==3.2.0b3
+& $testPython -m pip check
+& $testPython -I .github/scripts/check_wheel.py
+```
+
+Зависимость ставится отдельно из основного PyPI: в TestPyPI её может не быть.
+
+## 3. Опубликовать в основном PyPI
+
+Создайте аккаунт на https://pypi.org/account/register/, подтвердите email,
+настройте 2FA и создайте API token с областью `Entire account` для первой
+публикации. Используйте токен основного PyPI, а не TestPyPI.
+
+Загрузите те же два проверенных файла:
+
+```powershell
+& $publishPython -m twine upload --config-file .pypirc --repository pypi --username __token__ dist/pypi/openpyxl-enhanced/3.2.0b3/openpyxl_enhanced-3.2.0b3*
+```
+
+Эта команда публикует пакет для всех пользователей. После первой публикации
+создайте токен только для проекта `openpyxl-enhanced` и отзовите использованный токен
+с областью всего аккаунта, если он больше не нужен.
+
+Для установки опубликованной беты:
+
+```powershell
+python -m pip install openpyxl-enhanced==3.2.0b3
+```
+
+Явная версия выбирает бету предсказуемо. Для получения подходящих предварительных
+версий можно использовать `python -m pip install --pre openpyxl-enhanced`.
+
+## Следующие релизы
+
+Версия берётся из `openpyxl/_constants.py`. Для следующей беты используйте,
+например, `3.2.0b4`; версию `3.2.0` выбирайте, когда готовы объявить стабильный
+релиз. Обновите примеры версий в README и этой инструкции вместе с константой.
+PyPI не позволяет заменить уже загруженные файлы; удаление релиза не разрешает
+повторное использование тех же имён файлов. Перед новой загрузкой собирайте
+в отдельный каталог и выбирайте файлы нужной версии явно.
+
+Существующий `.github/workflows/pytest.yml` проверяет Python 3.8–3.14, собирает
+wheel и sdist, запускает `twine check --strict` и smoke-тест wheel. На событие
+GitHub Release он прикрепляет файлы к релизу, но не отправляет их в PyPI.
+Изменения workflow начнут действовать после отправки коммита на GitHub.
+
+## Официальные инструкции
+
+- [Сборка и публикация пакетов](https://packaging.python.org/en/latest/tutorials/packaging-projects/)
+- [Работа с TestPyPI](https://packaging.python.org/en/latest/guides/using-testpypi/)
+- [API tokens PyPI](https://pypi.org/help/#apitoken)
+- [Почему имя может быть недоступно](https://pypi.org/help/#project-name)
+
+Для будущей автоматизации можно настроить
+[Trusted Publishing](https://docs.pypi.org/trusted-publishers/adding-a-publisher/)
+через GitHub Actions. Текущая подготовка использует ручную загрузку через Twine.