Migrating from legacy

[uogbuji]

From the README "History" section:

Amara was originally an open source project I created, renaming and expanding on Anobind 2003, looking to simplify and rethink XML and related technology processing in Python. It went through a few evolutions and progress had slowed down since the late 2010s.

Fast forward a decade or so to a previous revival ticket:

The Amara saga continues! I don't exactly remember why I decided to dead end the Amara PyPI project when it hit 2.0, but I moved to a series of Amara 3 generation projects (amara3.iri, amara3.xml & amara3-names). Those were far more lone wolf efforts, but at Oori Data we're seeing a lot of need for the sorts of capability that's inchoate in Amara 3.

This is the ticket to track the migration to a new, consolidated Amara 4.0, and the subsequent release.

[uogbuji]

With some help from Claude Code (which needed a ton of help from me, itself; vibe coding shmibe coding 😂) I think the bulk of the migration looks good

❯ pip install git+https://github.com/OoriData/Amara.git
Collecting git+https://github.com/OoriData/Amara.git
  Cloning https://github.com/OoriData/Amara.git to /private/var/folders/8n/3_z3g5nj40j_nbpfbdgzdnhm0000gn/T/pip-req-build-du4y_nl7
  Running command git clone --filter=blob:none --quiet https://github.com/OoriData/Amara.git /private/var/folders/8n/3_z3g5nj40j_nbpfbdgzdnhm0000gn/T/pip-req-build-du4y_nl7
  Resolved https://github.com/OoriData/Amara.git to commit 6cc6b9f8af18c829da2a09b837908ff42e14af9e
  Installing build dependencies ... done
  Getting requirements to build wheel ... done
  Preparing metadata (pyproject.toml) ... done
Collecting nameparser (from Amara==0.0.0)
  Using cached nameparser-1.1.3-py2.py3-none-any.whl.metadata (6.1 kB)
Collecting ply (from Amara==0.0.0)
  Using cached ply-3.11-py2.py3-none-any.whl.metadata (844 bytes)
Collecting html5lib-modern (from Amara==0.0.0)
  Using cached html5lib_modern-1.2-py2.py3-none-any.whl.metadata (7.8 kB)
Using cached html5lib_modern-1.2-py2.py3-none-any.whl (116 kB)
Using cached nameparser-1.1.3-py2.py3-none-any.whl (24 kB)
Using cached ply-3.11-py2.py3-none-any.whl (49 kB)
Building wheels for collected packages: Amara
  Building wheel for Amara (pyproject.toml) ... done
  Created wheel for Amara: filename=amara-0.0.0-cp312-cp312-macosx_10_13_universal2.whl size=6256 sha256=904d448f6dd78f73687eafa5fda9e576fc3be0471dd7f8c05d8f4447f1478348
  Stored in directory: /private/var/folders/8n/3_z3g5nj40j_nbpfbdgzdnhm0000gn/T/pip-ephem-wheel-cache-zktv1oqb/wheels/fb/55/7a/68bceb86dc61442922ce1a8ac6d81639cdf7835b8577054f85
Successfully built Amara
Installing collected packages: ply, nameparser, html5lib-modern, Amara
Successfully installed Amara-0.0.0 html5lib-modern-1.2 nameparser-1.1.3 ply-3.11

❯ python -c "import amara.cmodules.cxmlstring; print('C extension imported successfully'); print('Testing isxml function:'); print('XML string:', amara.cmodules.cxmlstring.isxml(b'<?xml version=\"1.0\"?><root>test</root>')); print('Non-XML string:', amara.cmodules.cxmlstring.isxml(b'This is not XML')); print('XML with whitespace:', amara.cmodules.cxmlstring.isxml(b'  <?xml version=\"1.0\"?><root>test</root>'))"
C extension imported successfully
Testing isxml function:
XML string: True
Non-XML string: False
XML with whitespace: False

So you can use it in requirements.txt as git+https://github.com/OoriData/Amara.git, or in a hatchling pyproject.toml as:

dependencies = [
    'Amara @ git+https://github.com/OoriData/Amara.git@main',
    "markdown >= 3.5"  # Example of a standard package
]