alpha software
This is alpha software.
The CATIA com interface is large and I’ve predominantly wrote tests for those areas I’m familiar. Any bugs that exist should be easy to fix. There are many examples of fixes within the git repository history that can be learned from to fix remaining issues.
Requirements
python >= 3.9
CATIA V5 running on Windows.
see requirements.txt
Installation
see installation.
Usage
See the introduction, examples and user_scripts for a good over view on how to use pycatia.
Links
Releases: pycatia @ pypi.org
Examples And Scripts
See the documentation @ examples and user_scripts.
A GUI based application that uses pycatia - pycatia-tools.
Asking Questions
Please read the following with regards to raising questions: https://github.com/evereux/pycatia/issues/28
Contributing
See CONTRIBUTING.md in root of github repository.
Running The Tests
Prior to running the tests please ensure CATIA V5 has the following configuration settings:
CGR cache system must be disabled.
Do not activate default shapes on open must be disabled.
- Parameter names must not have back ticks enabled.Tools > Options > General > Parameters and Measure > Knowledge > Parameter Names > Surrounded by the ` symbol.
On the first run, during the running of the tests, the test suite will create the CATIA drawing, products and part it requires to run and adds them to the folder tests/cat_files.
If you have previously run the tests successfully and see unexpected errors, it maybe that the source parts require re-creating. Try deleting the CATIA files in the folder tests/cat_files so that they are regenerated on the next test run.
CATIA V5 should already be running and have NO documents already open.
To run the tests with coverage (-v is verbosity):
py.test -v --cov-report term-missing --cov=pycatia
To run a specific test:
py.test -v tests/test_product.py::test_move
To stop tests running after first failure.
py.test -vx
Release process
A reminder for @evereux. I don’t do this often and forget …
Check version is correct.
Check changelog has been updated.
- Run the tests. pytest -v tests
Ensure cache is disabled and
Fix any issues.
- Run the examples.
Fix any issues.
- Build the docs. cd docs ./make html
Fix any issues.
Run mypy over module. mypy pycatia
- Build source. python setup.py sdist bdist_wheel
Check source contents.
Build pycatia exe python -m nuitka --standalone pycatia-exe.py. * use 64 env. * rename pycatia-exe.exe.
Merge changes with master branch and upload.
Upload to pypi. twine upload dist/*.
Update github releases.
Release files for pycatia 0.10.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pycatia-0.10.1.tar.gz | 1.4 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pycatia-0.10.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.9 MB
Release files / pycatia-0.10.1.tar.gz
| Download URL | pycatia-0.10.1.tar.gz |
|---|---|
| Size | 1.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
01c04f91a7192509f520d37969543c7a393e4639e2b825fa5968d7cdea6a6293
|
|
BLAKE2b-256 checksum How to use checksums |
592afce688b7becdb2198fe5a2c59e024d4a774b6584ae79f034c8d3e0281d49
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.10
|
Release files / pycatia-0.10.1-py3-none-any.whl
| Download URL | pycatia-0.10.1-py3-none-any.whl |
|---|---|
| Size | 2.5 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c5aba02cebad582639f83795b3efe2eb1125ae319e29d981ef4b057e4a81c1ad
|
|
BLAKE2b-256 checksum How to use checksums |
8d09e0f616b1268b8117b9c049b9fabad135576813f8f4d6ebaa672de8361e9e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.10
|