algorand-python-testing 0.6.0b3__tar.gz → 1.0.0b8__tar.gz

{algorand_python_testing-0.6.0b3 → algorand_python_testing-1.0.0b8}/CHANGELOG.md

@@ -1,4 +1,50 @@
 # CHANGELOG
+## v1.0.0-beta.8 (2025-10-06)
+
+### Documentation
+
+* fix typos and broken links ([`f221910`](https://github.com/algorandfoundation/algorand-python-testing/commit/f221910b54a2cdc76aa99b8883d75d4ddae78ee3))
+
+## v1.0.0-beta.7 (2025-09-26)
+
+### Bug fixes
+
+* bump puyapy dependencies ([`8b2064d`](https://github.com/algorandfoundation/algorand-python-testing/commit/8b2064dc8bd94b0dadf6f283e8d639543241eadc))
+
+  Update to latest release candidates, so dependencies projects using both puyapy, language server and algorand python testing can resolve to a consistent version
+
+## v1.0.0-beta.6 (2025-09-18)
+
+### Features
+
+* update langspec to 4.3.0 ([`c05bdc0`](https://github.com/algorandfoundation/algorand-python-testing/commit/c05bdc053f4b6aa52206cbeeaddb40609688b052))
+
+## v1.0.0-beta.5 (2025-09-16)
+
+## v1.0.0-beta.4 (2025-09-12)
+
+### Features
+
+* make BoxRef methods directly accessible on Box class ([`38e12f6`](https://github.com/algorandfoundation/algorand-python-testing/commit/38e12f6d595c204eb6f7dcd74c393c46f166e3d4))
+
+## v1.0.0-beta.3 (2025-09-08)
+
+### Features
+
+* add .as_uint64 and .as_biguint methods to replace native property ([`0f9c6c0`](https://github.com/algorandfoundation/algorand-python-testing/commit/0f9c6c06b6e1b986c4e512cbbe0098aea32615b7))
+
+## v1.0.0-beta.2 (2025-09-03)
+
+### Features
+
+* add stub implementations of array types ([`b7b831d`](https://github.com/algorandfoundation/algorand-python-testing/commit/b7b831da7570367494e823485910bc7191376e48))
+
+## v1.0.0-beta.1 (2025-07-16)
+
+### Features
+
+* support storing tuples in state ([`911cd3c`](https://github.com/algorandfoundation/algorand-python-testing/commit/911cd3cb54f69f8fdded5c677f32c1969e8827bf))
+
 ## v0.6.0-beta.3 (2025-05-16)
 
 ### Bug fixes
@@ -29,6 +75,10 @@
 
 ## v0.5.0 (2025-02-20)
 
+### Features
+
+* accept abi method reference as a parameter to arc4_signature method ([`a1cb365`](https://github.com/algorandfoundation/algorand-python-testing/commit/a1cb365f2be1eb1965d9b86a5193498772131412))
+
 ## v0.5.0-beta.1 (2025-02-19)
 
 ### Features
@@ -69,13 +119,9 @@
 
 ### Bug fixes
 
-* ability to pass kw_only flag to dataclass when defining struct subclass (#23) ([`24bcf9d`](https://github.com/algorandfoundation/algorand-python-testing/commit/24bcf9d8af34eb2675ddf85ce9d71802f82f2d6a))
-
-  * fix: ability to pass kw_only flag to dataclass when defining struct subclass
-
-  * chore: add dependabot yaml
+* ability to pass kw_only flag to dataclass when defining struct subclass ([`24bcf9d`](https://github.com/algorandfoundation/algorand-python-testing/commit/24bcf9d8af34eb2675ddf85ce9d71802f82f2d6a))
 
-  * chore: adding ability to pass args to struct init subclass
+* ability to pass kw_only flag to dataclass when defining struct subclass ([`24bcf9d`](https://github.com/algorandfoundation/algorand-python-testing/commit/24bcf9d8af34eb2675ddf85ce9d71802f82f2d6a))
 
 ## v0.4.0 (2024-08-27)
 
@@ -115,13 +161,25 @@
 
 ## v0.3.0-beta.10 (2024-08-22)
 
+### Documentation
+
+* refining docs ([`b714783`](https://github.com/algorandfoundation/algorand-python-testing/commit/b714783b4cf15d31f91dc1c776d304bd2eb9a154))
+
+* note on future refinement ([`b714783`](https://github.com/algorandfoundation/algorand-python-testing/commit/b714783b4cf15d31f91dc1c776d304bd2eb9a154))
+
+* further refining the api section ([`b714783`](https://github.com/algorandfoundation/algorand-python-testing/commit/b714783b4cf15d31f91dc1c776d304bd2eb9a154))
+
 ## v0.3.0-beta.9 (2024-08-22)
 
+### Bug fixes
+
+* Make Global.latest_timestamp constant for a transaction ([`51c2817`](https://github.com/algorandfoundation/algorand-python-testing/commit/51c2817c262d686996e2aa4d639d259409dc8d43))
+
 ## v0.3.0-beta.8 (2024-08-22)
 
 ### Features
 
-* include ARC4 results in log, and handle > 15 ARC4 arguments (#18) ([`fd83ee8`](https://github.com/algorandfoundation/algorand-python-testing/commit/fd83ee8525a393d4a1a66f20acdb661906d84b51))
+* include ARC4 results in log, and handle > 15 ARC4 arguments ([`fd83ee8`](https://github.com/algorandfoundation/algorand-python-testing/commit/fd83ee8525a393d4a1a66f20acdb661906d84b51))
 
 ## v0.3.0-beta.7 (2024-08-21)
 
@@ -129,49 +187,35 @@
 
 ### Documentation
 
-* documentation for initial stable release of `algorand-python-testing` (#8) ([`9d97d0d`](https://github.com/algorandfoundation/algorand-python-testing/commit/9d97d0de5ff9897e642ec3f11a186f2fb95375bb))
-
-  * docs: wip
+* documentation for initial stable release of `algorand-python-testing` ([`9d97d0d`](https://github.com/algorandfoundation/algorand-python-testing/commit/9d97d0de5ff9897e642ec3f11a186f2fb95375bb))
 
-  * chore: refresh pyproject
+  docs: wip
 
-  * docs: refining docs (wip)
+* refining docs (wip) ([`9d97d0d`](https://github.com/algorandfoundation/algorand-python-testing/commit/9d97d0de5ff9897e642ec3f11a186f2fb95375bb))
 
-  * chore: integrating doctests
+* revamping docs with latest features ([`9d97d0d`](https://github.com/algorandfoundation/algorand-python-testing/commit/9d97d0de5ff9897e642ec3f11a186f2fb95375bb))
 
-  * docs: revamping docs with latest features
+* minor consistency with main readme; patching doctests ([`9d97d0d`](https://github.com/algorandfoundation/algorand-python-testing/commit/9d97d0de5ff9897e642ec3f11a186f2fb95375bb))
 
-  * docs: minor consistency with main readme; patching doctests
+* removing the box from examples ([`9d97d0d`](https://github.com/algorandfoundation/algorand-python-testing/commit/9d97d0de5ff9897e642ec3f11a186f2fb95375bb))
 
-  * docs: removing the box from examples
+* refine op codes section ([`9d97d0d`](https://github.com/algorandfoundation/algorand-python-testing/commit/9d97d0de5ff9897e642ec3f11a186f2fb95375bb))
 
-  * docs: refine op codes section
-
-  * chore: merge conflicts
-
-  * chore: apply suggestions from code review
-
-  Co-authored-by: Daniel McGregor <daniel.mcgregor@makerx.com.au>
-
-  * docs: addressing docs pr comments
+* addressing docs pr comments ([`9d97d0d`](https://github.com/algorandfoundation/algorand-python-testing/commit/9d97d0de5ff9897e642ec3f11a186f2fb95375bb))
 
 ## v0.3.0-beta.5 (2024-08-21)
 
-### Bug fixes
-
-* ensure mutable types (ARC4 tuple, array and structs) have their changes propagated back to container-like types (global/local state, boxes, ARC4 mutable types) (#14) ([`1f1f2ea`](https://github.com/algorandfoundation/algorand-python-testing/commit/1f1f2ea43a2f4f906cbcd5709b8e86b5c1f2bc63))
-
-  * fix: add default __eq__ implementation for ARC4 types
+### Features
 
-  * fix: ensure mutable types (ARC4 tuple, array and structs) have their changes propagated back to container-like types (global/local state, boxes, ARC4 mutable types)
+* add __str__ and __repr__ implementations for ARC4 types ([`1f1f2ea`](https://github.com/algorandfoundation/algorand-python-testing/commit/1f1f2ea43a2f4f906cbcd5709b8e86b5c1f2bc63))
 
-  * feat: add __str__ and __repr__ implementations for ARC4 types
+### Bug fixes
 
-  * refactor: make ARC4 type_info private
+* ensure mutable types (ARC4 tuple, array and structs) have their changes propagated back to container-like types (global/local state, boxes, ARC4 mutable types) ([`1f1f2ea`](https://github.com/algorandfoundation/algorand-python-testing/commit/1f1f2ea43a2f4f906cbcd5709b8e86b5c1f2bc63))
 
-  * refactor: make ARC4 struct inherit _ABIEncoded
+* add default __eq__ implementation for ARC4 types ([`1f1f2ea`](https://github.com/algorandfoundation/algorand-python-testing/commit/1f1f2ea43a2f4f906cbcd5709b8e86b5c1f2bc63))
 
-  * refactor: removing get_app_for_contract; expanding get_app; parsing on_complete
+* ensure mutable types (ARC4 tuple, array and structs) have their changes propagated back to container-like types (global/local state, boxes, ARC4 mutable types) ([`1f1f2ea`](https://github.com/algorandfoundation/algorand-python-testing/commit/1f1f2ea43a2f4f906cbcd5709b8e86b5c1f2bc63))
 
 ## v0.3.0-beta.4 (2024-08-21)
 
@@ -197,231 +241,47 @@
 
 ## v0.3.0-beta.2 (2024-08-16)
 
-## v0.3.0-beta.1 (2024-08-14)
-
 ### Features
 
-* deferred app calls, modular test context, refined access to value generators, numerous fixes/improvements (#4) ([`85dd58a`](https://github.com/algorandfoundation/algorand-python-testing/commit/85dd58a60f56a0737de84dcb549c01ca5a7a2851))
-
-  * feat: work in progress on asset, application related state ops
-
-  * test: adding extra tests
-
-  * feat: extra tests and implementation wrappers around AppLocal
-
-  * chore: wip
-
-  * chore: update src/algopy_testing/op.py
-
-  Co-authored-by: Daniel McGregor <daniel.mcgregor@makerx.com.au>
-
-  * feat: adding acctparamsget; extra tests; pr comments
-
-  * refactor: adding final bits around AcctParamsGet; unit tests and fixes
-
-  * refactor: adding lookup by index to acct/app/asset get ops; tweaking ci
-
-  * refactor: addressing pr comments
-
-  * chore: fixing failing test
-
-  * refactor: simplifying test_context validation
-
-  * use specific enum types in box example with latest puya version
-
-  * include box types in algopy_testing
-
-  * fix inconsistent usage of field names on application fields use state total overrides when determining state totals reduce usage of `import algopy` in implementations
-
-  * expose fields property on application to aid debugging
-
-  * added section to CONTRIBUTING.md describing relationship between `algopy` and `algopy_testing`
-
-  * remove lazy algopy imports from utils remove some unnecessary ignores add TODO
-
-  * simplify abimethod and add TODO's
-
-  * add TODO for state totals
-
-  * add some tests (including currently failing ones) for app transactions
-
-  * feat: add arc4factory
+* implement gaid op ([`71801f0`](https://github.com/algorandfoundation/algorand-python-testing/commit/71801f01e49b683d81fa46d2ddb1c8aaf38b89f2))
 
-  * refactor: ensuring underlying _key is properly reflected on local/global states
-
-  * refactor: change guards for setting keys to explicitly check for None
-
-  * refactor: use implementation types in internal mappings
-
-  * refactor: remove usages of `import algopy` from op.py, remove explicit imports from typing module add TODO's
-
-  * test: use non-abstract contract base
-
-  * allow empty box prefix
-
-  * refactor
-
-  * use immutable param defaults
-
-  * fix: handle populating foreign arrays correctly for abi method calls
-
-  * refactor: remove lazy import algopy
-
-  * remove irrelevant comment
-
-  * initialize accounts correctly
-
-  * build: adding post install command into examples venv in hatch settings
-
-  * refactor: refine arc4 factory; add corresponding tests
-
-  * chore: adding the missing clear methods
-
-  * chore: merging everything from docs branch except docs changes
-
-  * chore: merge conflicts
-
-  * refactor: simplify txn implementations provide default values for unspecified txn fields
-
-  * docs: adding pep257 formatter; using reST docstrings style for context.py
-
-  * test: adding tests for scratch slots
-
-  * refactor: renaming set_txn_fields -> scoped_txn_fields
-
-  * chore: adding `amount` field and open question under TODO;
-
-  also adding adding get_box_map  that reuses get_box but appends the bytes box_map prefix
-
-  * chore: bumping ruff
-
-  * refactor: adding context manager for lsig args setup (similar to algopy.Txn)
-
-  also running latest ruff - some rules are updated
-
-  * refactor: move helper classes into their own file
-
-  * refactor: simplify itxn loader
-
-  * refactor: isolate get_test_context to reduce circular imports
-
-  * chore: using multiprocessing in refresh test artifacts script
-
-  * refactor: adding tests for ITxn, ITxnCreate and GITxn, fixing related bugs
-
-  * refactor: default_creator -> default_sender; setting creator as default_sender
-
-  * chore: parsing name to op name in ITxn
-
-  * chore: updating default extension for mypy to use ms-python
-
-  * test: remove incorrect test and replace with TODO
-
-  * chore: add TODO about subroutine support
-
-  * add stricter type checks for primitives
-
-  * track when contracts are in a "creating" state or not
-
-  * todos
-
-  * refactor: moving GITxn class to itxn.py
-
-  * refactor: generate arc4 signatures from types added more robust system for tracking arc4 types removed unneeded functions on StaticArray
-
-  * only support native tuples when handling generic aliases in arc4 tuples
-
-  * refactor: 1/2 adding paged access to clear state program in txn fields
-
-  * refactor: consolidating txn and itxn related context attributes/methods
-
-  * minor refactors
-
-  * support arc4 structs
-
-  * refactor: simplify logic sig implementation, and remove mapping
-
-  * refactor: fix itxn op behaviour with program pages, and other array like fields
-
-  * refactor: simplify account properties
-
-  * refactor: move crypto ops into their own module
-
-  * refactor: move pure ops into their own module
-
-  * refactor: move other misc ops
-
-  * refactor: consolidating value generators; ledger and txn contexts;
-
-  * refactor: add active group/txn properties change local/global state storage to store values against the app, not the contract instance add UInt64Backed type to simplify serialization to/from int/bytes
-
-  * refactor: remove nested private modules, replace usages of get_test_context with lazy_context
-
-  * refactor: move inner transactions onto transaction group
-
-  * refactor: remove scoped_lsig_args
-
-  * refactor: remove maybe_active_app_id
-
-  * refactor: include bool in test for uint64
-
-  * refactor: ensure arc4 values always have fully parametrized types
-
-  * refactor: use _paramatize_type
-
-  * refactor: addressing TODOs
-
-  refactor: removing txn from method names inside txn context manager prop
-
-  chore: restoring initial pre-commit
-
-  refactor: expanding scoped_execution
-
-  chore: remove redundant fields
-
-  chore: addressing minor todos and removing the ones already addressed
-
-  * refactor: adding unit tests for global/local state with implicit keys
+### Bug fixes
 
-  * refactor: improving handling of initial value for implicit global/local state keys
+* added mock implementations for new algopy functions, add util for raising consistent mockable method errors ([`71801f0`](https://github.com/algorandfoundation/algorand-python-testing/commit/71801f01e49b683d81fa46d2ddb1c8aaf38b89f2))
 
-  * test: extra test cases for accessing implicit/explicit keyed local/global state
+## v0.3.0-beta.1 (2024-08-14)
 
-  * refactor: wip adding txn_group_for method
+### Features
 
-  * chore: fix linting errors
+* deferred app calls, modular test context, refined access to value generators, numerous fixes/improvements ([`85dd58a`](https://github.com/algorandfoundation/algorand-python-testing/commit/85dd58a60f56a0737de84dcb549c01ca5a7a2851))
 
-  * feat: continue with txn_group_for and add a test
+* work in progress on asset, application related state ops ([`85dd58a`](https://github.com/algorandfoundation/algorand-python-testing/commit/85dd58a60f56a0737de84dcb549c01ca5a7a2851))
 
-  * chore: remove scoped_txn_fields methods
+* extra tests and implementation wrappers around AppLocal ([`85dd58a`](https://github.com/algorandfoundation/algorand-python-testing/commit/85dd58a60f56a0737de84dcb549c01ca5a7a2851))
 
-  * add some additional TODO's for scoped_execution
+  chore: wip
 
-  * remove TODO
+* adding acctparamsget; extra tests; pr comments ([`85dd58a`](https://github.com/algorandfoundation/algorand-python-testing/commit/85dd58a60f56a0737de84dcb549c01ca5a7a2851))
 
-  * expand gaid TODO
+* add arc4factory ([`85dd58a`](https://github.com/algorandfoundation/algorand-python-testing/commit/85dd58a60f56a0737de84dcb549c01ca5a7a2851))
 
-  * tweak op.exit implementation and add TODO
+* continue with txn_group_for and add a test ([`85dd58a`](https://github.com/algorandfoundation/algorand-python-testing/commit/85dd58a60f56a0737de84dcb549c01ca5a7a2851))
 
-  * remove arc4 property from AlgopyTestContext
+### Bug fixes
 
-  * add more TODOs
+* handle populating foreign arrays correctly for abi method calls ([`85dd58a`](https://github.com/algorandfoundation/algorand-python-testing/commit/85dd58a60f56a0737de84dcb549c01ca5a7a2851))
 
-  * refactor: addressing TODOs; adding marketplace contract example (devrel bootcamps)
+### Documentation
 
-  * test: fixing failing tests
+* adding pep257 formatter; using reST docstrings style for context.py ([`85dd58a`](https://github.com/algorandfoundation/algorand-python-testing/commit/85dd58a60f56a0737de84dcb549c01ca5a7a2851))
 
 ## v0.2.2-beta.5 (2024-07-30)
 
 ### Documentation
 
-* patch urls in README.md (#9) ([`eddf612`](https://github.com/algorandfoundation/algorand-python-testing/commit/eddf612b177a2acddf15d58be3f375e99fb6564b))
-
-  * chore: patch urls in README.md
+* patch urls in README.md ([`eddf612`](https://github.com/algorandfoundation/algorand-python-testing/commit/eddf612b177a2acddf15d58be3f375e99fb6564b))
 
-  * ci: relaxing rules around paths-ignore
-
-  * docs: patching old namespace name in readme
+* patching old namespace name in readme ([`eddf612`](https://github.com/algorandfoundation/algorand-python-testing/commit/eddf612b177a2acddf15d58be3f375e99fb6564b))
 
 ## v0.2.2-beta.4 (2024-07-25)
 
@@ -432,3 +292,7 @@
 ## v0.2.2-beta.1 (2024-07-24)
 
 ## v0.2.1 (2024-07-10)
+
+### Bug fixes
+
+* patching helper scripts; adding pre-commit; bumping compiler version ([`8d43492`](https://github.com/algorandfoundation/algorand-python-testing/commit/8d43492adfeb53fd2824f0ea812a9c30bf6bb339))

{algorand_python_testing-0.6.0b3 → algorand_python_testing-1.0.0b8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: algorand-python-testing
-Version: 0.6.0b3
+Version: 1.0.0b8
 Summary: Algorand Python testing library
 Project-URL: Documentation, https://github.com/algorandfoundation/puya/tree/main/algopy_testing#README.md
 Project-URL: Issues, https://github.com/algorandfoundation/puya/issues
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Testing
 Requires-Python: >=3.12
-Requires-Dist: algorand-python>=2.0
+Requires-Dist: algorand-python>=3
 Requires-Dist: coincurve>=19.0.1
 Requires-Dist: ecdsa>=0.17.0
 Requires-Dist: pycryptodomex<4,>=3.6.0

algorand_python_testing-1.0.0b8/docs/algopy.md

@@ -0,0 +1,9 @@
+# Algorand Python
+
+Algorand Python is a partial implementation of the Python programming language that runs on the AVM. It includes a statically typed framework for developing Algorand smart contracts and logic signatures, with Pythonic interfaces to underlying AVM functionality that work with standard Python tooling.
+
+Algorand Python is compiled for execution on the AVM by PuyaPy, an optimising compiler that ensures the resulting AVM bytecode has execution semantics that match the given Python code. PuyaPy produces output that is directly compatible with [AlgoKit typed clients](https://github.com/algorandfoundation/algokit-cli/blob/main/docs/features/generate.md#1-typed-clients) to make deployment and calling easy.
+
+## Quick start
+
+To get started, refer to the [official documentation](https://algorandfoundation.github.io/puya).

{algorand_python_testing-0.6.0b3 → algorand_python_testing-1.0.0b8}/docs/api.md

@@ -1,13 +1,13 @@
 # API Reference
 
-An overview of the `algorand-python-testing`'s `algopy_testing` module - covering the main classes and functions.
+An overview of the `algopy_testing` module in `algorand-python-testing` library - covering the main classes and functions.
 
 ```{hint}
-Spotted a typo in documentation? This project is open source, please submit an issue or a PR on [GitHub](https://github.com/algorand/algorand-python-testing).
+Spotted a typo in the documentation? This project is open source; please submit an issue or a PR on [GitHub](https://github.com/algorandfoundation/algorand-python-testing).
 ```
 
 ```{warning}
-Note, assume `_algopy_testing` to refer to `algopy_testing` namespace in the auto-generated class documentation above. To be patched in near future.
+Note: Auto-generated class documentation may reference `_algopy_testing`; these should be interpreted as the `algopy_testing` namespace. The naming discrepancy will be fixed in a future update.
 ```
 
 ## Contexts

{algorand_python_testing-0.6.0b3 → algorand_python_testing-1.0.0b8}/docs/coverage.md

@@ -1,9 +1,9 @@
 # Coverage
 
-See which `algorand-python` stubs are implemented by the `algorand-python-testing` library. See the [Concepts](testing-guide/concepts.md#types-of-algopy-stub-implementations) section for more details on the implementation categories. Refer to the [`algorand-python` stubs API](api.md) for the full list of the stubs for which the `algorand-python-testing` library provides implementations referenced in the table below.
+See which `algorand-python` stubs are implemented by the `algorand-python-testing` library. See the [Concepts](testing-guide/concepts.md#types-of-algopy-stub-implementations) section for more details on the implementation categories. Refer to the [`algorand-python` stubs API](api.md) for the full list of stubs for which the `algorand-python-testing` library provides implementations referenced in the table below.
 
 | Name                                        | Implementation type |
-|---------------------------------------------|---------------------|
+| ------------------------------------------- | ------------------- |
 | algopy.Account                              | Emulated            |
 | algopy.Application                          | Emulated            |
 | algopy.Asset                                | Emulated            |
@@ -158,3 +158,4 @@ See which `algorand-python` stubs are implemented by the `algorand-python-testin
 | algopy.op.EllipticCurve                     | Mockable            |
 | algopy.op.VrfVerify                         | Mockable            |
 | algopy.op.vrf_verify                        | Mockable            |
+| algopy.op.falcon_verify                     | Mockable            |

{algorand_python_testing-0.6.0b3 → algorand_python_testing-1.0.0b8}/docs/examples.md

@@ -5,9 +5,9 @@ Below is a showcase of various examples of unit testing real and sample Algorand
 | Contract Name       | Test File                                                                                                                                 | Key Features Demonstrated                                                                                                                                                                                        | Test versions of Algopy Abstractions used                                                           |
 | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
 | Auction             | [test_contract.py](https://github.com/algorandfoundation/algorand-python-testing/blob/main/examples/auction/test_contract.py)             | - Use of algopy_testing_context<br>- Mocking of global state and transaction fields<br>- Testing of ARC4 contract methods<br>- Emulation of asset creation and transfers<br>- Verification of inner transactions | - **ARC4Contract**<br>- **Global**<br>- **Txn**<br>- **Asset**<br>- **Account**<br>- **LocalState** |
-| Proof of Attendance | [test_contract.py](https://github.com/algorandfoundation/algorand-python-testing/blob/main/examples/proof_of_attendance/test_contract.py) | - Creation and management of dummy assets<br>- Testing of box storage operations<br>- Verification of inner transactions for asset transfers<br>- Use of any\_\* methods for generating test data                | - **ARC4Contract**<br>- **Box**<br>- **BoxMap**<br>- **Asset**<br>- **Account**<br>- **op**         |
+| Proof of Attendance | [test_contract.py](https://github.com/algorandfoundation/algorand-python-testing/blob/main/examples/proof_of_attendance/test_contract.py) | - Creation and management of dummy assets<br>- Testing of box storage operations<br>- Verification of inner transactions for asset transfers<br>- Use of `any.*` methods for generating test data                | - **ARC4Contract**<br>- **Box**<br>- **BoxMap**<br>- **Asset**<br>- **Account**<br>- **op**         |
 | Simple Voting       | [test_contract.py](https://github.com/algorandfoundation/algorand-python-testing/blob/main/examples/simple_voting/test_contract.py)       | - Testing of global and local state operations<br>- Verification of transaction group operations<br>- Mocking of payment transactions                                                                            | - **Contract**<br>- **GlobalState**<br>- **LocalState**<br>- **Txn**<br>- **op.GTxn**               |
-| ZK Whitelist        | [test_contract.py](https://github.com/algorandfoundation/algorand-python-testing/blob/main/examples/zk_whitelist/test_contract.py)        | - Testing of zero-knowledge proof verification<br>- Mocking of external application calls<br>- Use of ARC4 types and methods                                                                                     | - **ARC4Contract**<br>- **arc4 types**<br>- **LocalState**<br>- **Global**<br>- **Txn**             |
+| ZK Whitelist        | [test_contract.py](https://github.com/algorandfoundation/algorand-python-testing/blob/main/examples/zk_whitelist/test_contract.py)        | - Testing of zero-knowledge proof verification<br>- Mocking of external application calls<br>- Use of ARC4 types and methods                                                                                     | - **ARC4Contract**<br>- **ARC4 types**<br>- **LocalState**<br>- **Global**<br>- **Txn**             |
 | HTLC LogicSig       | [test_signature.py](https://github.com/algorandfoundation/algorand-python-testing/blob/main/examples/htlc_logicsig/test_signature.py)     | - Testing of LogicSig contracts<br>- Verification of time-based conditions<br>- Mocking of transaction parameters                                                                                                | - **logicsig**<br>- **Account**<br>- **Txn**<br>- **Global**<br>- **op**                            |
-| Marketplace         | [test_contract.py](https://github.com/algorandfoundation/algorand-python-testing/blob/main/examples/marketplace/test_contract.py)         | - Testing of complex marketplace operations<br>- Use of BoxMap for listings<br>- Testing of asset transfers and payments                                                                                         | - **ARC4Contract**<br>- **BoxMap**<br>- **Asset**<br>- **arc4 types**<br>- **Global**<br>- **Txn**  |
+| Marketplace         | [test_contract.py](https://github.com/algorandfoundation/algorand-python-testing/blob/main/examples/marketplace/test_contract.py)         | - Testing of complex marketplace operations<br>- Use of BoxMap for listings<br>- Testing of asset transfers and payments                                                                                         | - **ARC4Contract**<br>- **BoxMap**<br>- **Asset**<br>- **ARC4 types**<br>- **Global**<br>- **Txn**  |
 | Scratch Storage     | [test_contract.py](https://github.com/algorandfoundation/algorand-python-testing/blob/main/examples/scratch_storage/test_contract.py)     | - Testing of scratch space usage<br>- Verification of scratch slot values                                                                                                                                        | - **ARC4Contract**<br>- **Contract**<br>- **op**                                                    |

{algorand_python_testing-0.6.0b3 → algorand_python_testing-1.0.0b8}/docs/faq.md

@@ -14,7 +14,7 @@ Operational Codes, or opcodes, are AVM instructions that are executed directly b
 
 ## What are Value Generators?
 
-Value Generators are helper methods that generate randomized values for testing when the specific value of the tested type is not important. In the context of Algorand Python testing, these are represented by property on the context manager, accessed via `any.*` (or `any.arc4.*`, `any.txn.*`. in the case of ARC 4 types). To understand how to use Value Generators effectively, check out our [Value Generators section](testing-guide/concepts.md#value-generators) in the documentation.
+Value Generators are helper methods that produce randomized values for testing when the exact value of a type isn't important. In Algorand Python testing these generators are exposed as properties on the test context manager and accessed via `any.*` (for example, `any.arc4.*` and `any.txn.*` for ARC4 types). To learn more, see the [Value Generators section](testing-guide/concepts.md#value-generators).
 
 ## What are the limitations of the Algorand Python Testing framework?
 
@@ -26,7 +26,7 @@ The Algorand Python Testing framework emulates the Algorand Virtual Machine (AVM
 4. Certain cryptographic operations are mocked or simplified
 5. No state proof generation or verification
 
-For scenarios where these limitations are crucial, it's recommended to pair this framework with integration testing. If you have a solid reason to justify introducing new emulated behaviour, please open an issue or contribute to the project on [Github](https://github.com/algorandfoundation/algorand-python-testing).
+For scenarios where these limitations are crucial, it's recommended to pair this framework with integration testing. If you have a solid reason to justify introducing new emulated behaviour, please open an issue or contribute to the project on [GitHub](https://github.com/algorandfoundation/algorand-python-testing).
 
 ## How does balance tracking work in the testing framework?
 
@@ -46,16 +46,16 @@ Some cryptographic operations are mocked or simplified in the framework. For a d
 
 ## Can I use this framework for security-critical validations?
 
-While this framework is useful for unit testing and local development, it should not be the only tool used for security-critical validations or performance benchmarking. It's designed to approximate AVM behavior for common scenarios. Always complement your testing with additional integration testing options available in `algokit`, where you can test against real localnet or testnet environments.
+While this framework is useful for unit testing and local development, it should not be the only tool used for security-critical validations or performance benchmarking. It's designed to approximate AVM behaviour for common scenarios. Always complement your testing with additional integration testing options available in `algokit`, where you can test against real localnet or testnet environments.
 
 ## Is there an example of how to use this framework alongside integration tests?
 
 Yes, the `algokit-python-template`, accessible via `algokit init`, provides a working example of how to structure `algorand-python-testing` along with regular integration tests against localnet.
 
 ```{hint}
-An `algokit-python-template` accessible via `algokit init -t python`, provides a comprehensive and customizable working example of how to structure `algorand-python-testing` along with regular integration tests against localnet.
+The `algokit-python-template`, accessible via `algokit init -t python`, provides a comprehensive and customizable working example of how to structure `algorand-python-testing` along with regular integration tests against localnet.
 ```
 
 ## Is it compatible with `pytest`?
 
-Yes, it is compatible with `pytest` and _any_ other python testing framework as its agnostic of the testing framework as long as its python. If you spot incompatibility with a certain tool, please open an issue or contribute to the project on [Github](https://github.com/algorandfoundation/algorand-python-testing).
+Yes, it is compatible with `pytest` and _any_ other Python testing framework as it is agnostic of the testing framework as long as it's Python. If you spot incompatibility with a certain tool, please open an issue or contribute to the project on [GitHub](https://github.com/algorandfoundation/algorand-python-testing).

{algorand_python_testing-0.6.0b3 → algorand_python_testing-1.0.0b8}/docs/index.md

@@ -5,7 +5,7 @@
 [![github-stars](https://img.shields.io/github/stars/algorandfoundation/algorand-python-testing?color=74dfdc&logo=star&style=flat)](https://github.com/algorandfoundation/algorand-python-testing)
 [![visitor-badge](https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fgithub.com%2Falgorandfoundation%2Falgorand-python-testing&countColor=%2374dfdc&style=flat)](https://developer.algorand.org/algokit/)
 
-`algorand-python-testing` is a companion package to [Algorand Python](https://github.com/algorandfoundation/puya) that enables efficient unit testing of Algorand Python smart contracts in an offline environment. This package emulates key AVM behaviors without requiring a network connection, offering fast and reliable testing capabilities with a familiar Pythonic interface.
+`algorand-python-testing` is a companion package to [Algorand Python](https://github.com/algorandfoundation/puya) that enables efficient unit testing of Algorand Python smart contracts in an offline environment. This package emulates key AVM behaviours without requiring a network connection, offering fast and reliable testing capabilities with a familiar Pythonic interface.
 
 The `algorand-python-testing` package provides:
 
@@ -160,7 +160,7 @@ This example demonstrates key aspects of testing with `algorand-python-testing`
     - Checking global and local state changes after method execution.
     - Verifying return values from ABI methods using ARC4-specific types.
 
-> **NOTE**: Thorough testing is crucial in smart contract development due to their immutable nature post-deployment. Comprehensive unit and integration tests ensure contract validity and reliability. Optimizing for efficiency can significantly improve user experience by reducing transaction fees and simplifying interactions. Investing in robust testing and optimization practices is crucial and offers many benefits in the long run.
+> **NOTE**: Thorough testing is crucial in smart contract development due to their immutable nature post-deployment. Comprehensive unit and integration tests ensure contract validity and reliability. Optimising for efficiency can significantly improve user experience by reducing transaction fees and simplifying interactions. Investing in robust testing and optimisation practices is crucial and offers many benefits in the long run.
 
 ### Next steps
 

{algorand_python_testing-0.6.0b3 → algorand_python_testing-1.0.0b8}/docs/testing-guide/arc4-types.md

@@ -1,9 +1,9 @@
 # ARC4 Types
 
-These types are available under the `algopy.arc4` namespace. Refer to the [ARC4 specification](https://arc.algorand.foundation/ARCs/arc-0004) for more details on the spec.
+These types are available under the `algopy.arc4` namespace. Refer to the [ARC4 specification](https://dev.algorand.co/arc-standards/arc-0004/) for more details on the spec.
 
 ```{hint}
-Test context manager provides _value generators_ for ARC4 types. To access their _value generators_, use `{context_instance}.any.arc4` property. See more examples below.
+The test context manager provides _value generators_ for ARC4 types. To access the _value generators_, use `{context_instance}.any.arc4` property. See more examples below.
 ```
 
 ```{note}
@@ -63,7 +63,7 @@ address_value = arc4.Address("AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
 # Generate a random address
 random_address = context.any.arc4.address()
 
-# Access native underlaying type
+# Access native underlying type
 native = random_address.native
 ```
 
@@ -76,7 +76,7 @@ from algopy import arc4
 bytes_value = arc4.DynamicBytes(b"Hello, Algorand!")
 
 # Generate random dynamic bytes
-random_dynamic_bytes = context.any.arc4.dynamic_bytes(n=123) # n is the number of bits in the arc4 dynamic bytes
+random_dynamic_bytes = context.any.arc4.dynamic_bytes(n=123) # n is the number of bits in the ARC4 dynamic bytes
 ```
 
 ## String
@@ -88,7 +88,7 @@ from algopy import arc4
 string_value = arc4.String("Hello, Algorand!")
 
 # Generate random string
-random_string = context.any.arc4.string(n=12) # n is the number of bits in the arc4 string
+random_string = context.any.arc4.string(n=12) # n is the number of bits in the ARC4 string
 ```
 
 ```{testcleanup}

{algorand_python_testing-0.6.0b3 → algorand_python_testing-1.0.0b8}/docs/testing-guide/avm-types.md

@@ -3,7 +3,7 @@
 These types are available directly under the `algopy` namespace. They represent the basic AVM primitive types and can be instantiated directly or via _value generators_:
 
 ```{note}
-For 'primitive `algopy` types such as `Account`, `Application`, `Asset`, `UInt64`, `BigUint`, `Bytes`, `Sting` with and without respective _value generator_, instantiation can be performed directly. If you have a suggestion for a new _value generator_ implementation, please open an issue in the [`algorand-python-testing`](https://github.com/algorandfoundation/algorand-python-testing) repository or contribute by following the [contribution guide](https://github.com/algorandfoundation/algorand-python-testing/blob/main/CONTRIBUTING.md).
+For primitive `algopy` types such as `Account`, `Application`, `Asset`, `UInt64`, `BigUint`, `Bytes`, and `String`, instantiation can be performed directly, with or without a corresponding _value generator_. If you have a suggestion for a new _value generator_ implementation, please open an issue in the [`algorand-python-testing`](https://github.com/algorandfoundation/algorand-python-testing) repository or contribute by following the [contribution guide](https://github.com/algorandfoundation/algorand-python-testing/blob/main/CONTRIBUTING.md).
 ```
 
 ```{testsetup}