Skip to main content

A python module to interface with the CATIA V5 COM object.

Project description

alpha software

This is alpha software.

All the test cases and examples work but there will be many issues outside of the test framework. The CATIA com interface is large and I’ve predominantly wrote tests for those areas I’m familiar. Any bugs that exist should be for the most part be quite easy to fix using those methods that do work as a reference.

I have limited access to CATIA licences / workbenches. Also, there are many modules that I simply don’t know what they do. Thus my ability to test and support can be limited.

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.

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 into strange 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pycatia-0.8.3.tar.gz (1.4 MB view details)

Uploaded Source

Built Distribution

pycatia-0.8.3-py3-none-any.whl (2.4 MB view details)

Uploaded Python 3

File details

Details for the file pycatia-0.8.3.tar.gz.

File metadata

  • Download URL: pycatia-0.8.3.tar.gz
  • Upload date:
  • Size: 1.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.1

File hashes

Hashes for pycatia-0.8.3.tar.gz
Algorithm Hash digest
SHA256 5a9b15f032f1c19e69429315a020e80c03874e7645b3a1a91a1d6c2e6cf53837
MD5 23968f464d7810a16fce72cb06615dfb
BLAKE2b-256 934042366c81c049d694376796fb929076490f476e2c059bd0914ee1e0606b28

See more details on using hashes here.

File details

Details for the file pycatia-0.8.3-py3-none-any.whl.

File metadata

  • Download URL: pycatia-0.8.3-py3-none-any.whl
  • Upload date:
  • Size: 2.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.1

File hashes

Hashes for pycatia-0.8.3-py3-none-any.whl
Algorithm Hash digest
SHA256 c226caa2b6b0cc2dd80f3aa5b20e5fab938dea47174845b89d5af0424a5b6f39
MD5 c867b8c417fb7171c9878c8132f9d076
BLAKE2b-256 c8393c2803109eed8fa7ae0e0f1cae5e00b4bc0717e8b6074d3da15961558dbe

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page