Skip to main content

A python module to access the CATIA Measurable 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 huge and I’m currently just attacking the items I think will be most useful. The framework is in place for others to contribute so if you know CATIA and python please contribute. Bonus points for adding tests too.

Why was it made?

pycatia was primarily created to access the CATIA API Measurable object and it’s methods without the need of visual basic / CATScripts. There is further functionaliy available which can be seen by looking at the examples provided and reading the API at pycatia.readthedocs.io.

Some of the methods can be accessed simply using the pywin32 module but further access to methods such as GetCOG do not seem to be accessible using pure python. There are several questions on stack overflow and the pywin32 mailing list regarding this. But, they fail to provide any working examples with the VB Measurable object in python.

pycatia accesses these methods by running VBA scripts using the Dispatch(‘CATIA.Application’).SystemService.Evaluate() function where required and passing a small public function to it. Otherwise, pycatia uses the VB method directly but exposes it within the same python class.

Requirements

  • python >= 3.6

  • CATIA V5

  • see requirements.txt

Installation

with pip

pip install pycatia

For more detailed instructions please refer to the installation instructions available at pycatia.readthedocs.io.

Usage

See the examples provided.

Examples

Asking Questions

Please don’t raise an issue here until you have read the documentation, understood and met the requirements (YOU NEED CATIA INSTALLED) and have run the examples.

If you are upgrading from an earlier versions and your scripts break please check the changelog to give you clues on what to do to resolve those issues.

Once you have done that please give as much information as you can so I may try and reproduce the issue. Please provide the following information:

  • Windows OS version

  • CATIA version

  • Python version

  • pycatia version

  • Your code!

  • Full stack trace of error you encounter (properly formatted text please, not picture).

Thanks! :-)

Contributing

If you would like to help contribute to pycatia you should start by looking at the contents of the file v5automation-autogenerated.7z contained within this repository.

This archive was created by scraping through the contents of the V5Automation.chm help file to re-construct all the classes and methods for python. It’s largely complete but won’t work out the box without some tweaking. But these files should be the basis for any pull requests. They will save you sometime and effort and ensure some consistency for the project.

If you have written a script using pycatia you would like to share you can:

Running The Tests

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 in the folder tests/cat_files.

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.text -vx

Checks Prior To Release

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.3.7.tar.gz (582.5 kB view details)

Uploaded Source

Built Distribution

pycatia-0.3.7-py3-none-any.whl (983.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pycatia-0.3.7.tar.gz
  • Upload date:
  • Size: 582.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/47.1.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.2

File hashes

Hashes for pycatia-0.3.7.tar.gz
Algorithm Hash digest
SHA256 26ed84e6448c6a4dd6fd2789d4781aa6d98fb90d272ada1393da4aa38e00da5c
MD5 1d66bd70114d60217de3d73af2f19339
BLAKE2b-256 6e5204ac8952f41ae205b23cadb2dab94801e49891614973743a55ed4cabc19b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pycatia-0.3.7-py3-none-any.whl
  • Upload date:
  • Size: 983.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/47.1.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.2

File hashes

Hashes for pycatia-0.3.7-py3-none-any.whl
Algorithm Hash digest
SHA256 da997a088f956331c5bbd06fd73e98c4d4e41bb0eb29842018412b8bf2c294f3
MD5 91d817f98488ff9001e1b1e04408a883
BLAKE2b-256 3c16f928f9edf6da90082e93bae5c692a07f36d23280698f46e28e18e39488dd

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