Metadata-Version: 2.1
Name: simcon
Version: 0.6.0
Summary: MSFS SimConnect wrapper for Python
Home-page: https://gitlab.com/nARNcheg/py-simcon
Author: Roman Andriadi
Author-email: simcon@narn.me
License: UNKNOWN
Description: # py-simcon
        
        This is a Python wrapper for SimConnect library which is used to talk to
        Microsoft Flight Simulator. This wrapper provides natural pythonic interface.
        It can be used in both synchronous and asynchronous (asyncio) applications.
        In both cases it is thread safe.
        
        ## Features
        
          * Listen to system events (aircraft loaded, game paused, etc)
          * Receive data updates
          * Async and sync interfaces, which can work together simultaneously
        
        ## Examples
        
        #### Conventional (synchronous)
        
        ```python
        import pprint
        
        from simcon import Sim, DataField, PERIOD
        from simcon.data import types
        
        
        with Sim("MyApp") as sim:
            data = sim.sync_request_data_once([
                DataField("ATC ID", None, types.STRING32),
                DataField("Title", None, types.STRING256),
            ])
            pprint.pprint(data)
            data_request = sim.request_data_on_sim_object(
                [
                    DataField("HSI station ident", None, types.STRING8),
                    DataField("Plane latitude", "degrees"),
                    DataField("Plane longitude", "degrees"),
                    DataField("Plane altitude", "feet"),
                    DataField("GPS ground true track", "degrees"),
                    DataField("GPS ground speed", "knots"),
                    DataField("Zulu time", "seconds"),
                ],
                PERIOD.SECOND,
            )
            count = 0
            for data in data_request:
                pprint.pprint(data)
                count += 1
                if count >= 3:
                    break
        ```
        
        Result:
        ```
        {'GPS ground speed': 97.83114326014487,
         'GPS ground true track': 307.4598039853386,
         'Plane altitude': 8501.684970335986,
         'Plane latitude': 39.3924225392898,
         'Plane longitude': -125.57142850592173,
         'Zulu time': 3287.369384765625}
        {'GPS ground speed': 97.83704928992589,
         'GPS ground true track': 307.45556123353225,
         'Plane altitude': 8501.840396854732,
         'Plane latitude': 39.39269706474836,
         'Plane longitude': -125.57189141562071,
         'Zulu time': 3288.369384765625}
        ...
        ```
        
        #### Asynchronous (asyncio):
        
        ```python
        import asyncio
        import pprint
        
        from simcon import Sim, DataField, PERIOD
        from simcon.data import types
        
        
        async def show_data():
            async with Sim("MyApp") as sim:
                data = await sim.request_data_once([
                    DataField("ATC ID", None, types.STRING32),
                    DataField("Title", None, types.STRING256),
                ])
                pprint.pprint(data)
                data_request = sim.request_data_on_sim_object(
                    [
                        DataField("HSI station ident", None, types.STRING8),
                        DataField("Plane latitude", "degrees"),
                        DataField("Plane longitude", "degrees"),
                        DataField("Plane altitude", "feet"),
                        DataField("GPS ground true track", "degrees"),
                        DataField("GPS ground speed", "knots"),
                        DataField("Zulu time", "seconds"),
                    ],
                    PERIOD.SECOND,
                )
                count = 0
                async for data in data_request:
                    pprint.pprint(data)
                    count += 1
                    if count >= 3:
                        break
        
        asyncio.run(show_data())
        ```
        
        Results will be the same as in the example above
        
        
        ## Release History
        
        ### Yet to release
          * Nothing so far
        
        ### 0.6.0
          * Fixed event/data cleanup exceptions when stopping
          * Fixed iterating over changing dicts when stopping
          * Fixed non-asyncio-friendly threading.Lock causing deadlocks (API changed!)
        
        ### 0.5.0
          * Added more parameters to data requests:
            - `when` - either always, or only when the data changes (default: always)
            - `origin` - periods to wait before first data transmission (default: 0)
            - `interval` - periods between data transmissions (default: 1, i.e. every period)
            - `limit` - limit the number of data transmissions (default: 0, i.e. never stop)
          * Fixed 32-bit fields alignment
        
        ### 0.4.0
          * Wrapped SimConnect failures into OSError instead of a generic RuntimeError
          * Sim now stops when the simulator quits.
          * Added wait_stop() to wait until Sim stops
          * Stop Sim if it failed to start as a context manager
        
        ### 0.3.0
          * Added support for strings, integer, and float32 data types
          * Added a helper to request data once
        
        ### 0.2.0
        
          * Added `start()` and `stop()` methods. All event and data listeners
            will throw Closed() exception if they are still being awaited when
            Sim stops, or if it is already stopped when wait() is called.
        
        ### 0.1.0
          * Initial release
        
Platform: UNKNOWN
Classifier: Operating System :: Microsoft :: Windows
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Games/Entertainment
Classifier: Typing :: Typed
Requires-Python: >=3.7
Description-Content-Type: text/markdown
