https://github.com/ibmstreams/pypi.streamsx.inet
This is a step in allowing natural use of Streams for a Python developer. A project that will be registered with PyPi to allow 'pip install' of Python packages that support Python developers interacting with IBM Streams.
https://github.com/ibmstreams/pypi.streamsx.inet
pypi python python-packages
Last synced: 6 months ago
JSON representation
This is a step in allowing natural use of Streams for a Python developer. A project that will be registered with PyPi to allow 'pip install' of Python packages that support Python developers interacting with IBM Streams.
- Host: GitHub
- URL: https://github.com/ibmstreams/pypi.streamsx.inet
- Owner: IBMStreams
- License: apache-2.0
- Created: 2019-02-04T08:48:04.000Z (almost 7 years ago)
- Default Branch: develop
- Last Pushed: 2020-09-28T13:52:42.000Z (about 5 years ago)
- Last Synced: 2025-03-17T09:22:41.977Z (9 months ago)
- Topics: pypi, python, python-packages
- Language: Python
- Homepage: http://ibmstreams.github.io/pypi.streamsx.inet
- Size: 104 KB
- Stars: 0
- Watchers: 8
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Python streamsx.inet package
This exposes SPL operators in the `com.ibm.streamsx.inet` toolkit as Python methods.
Package is organized using standard packaging to upload to PyPi.
The package is uploaded to PyPi in the standard way:
```
cd package
python setup.py sdist bdist_wheel upload -r pypi
```
Note: This is done using the `ibmstreams` account at pypi.org and requires `.pypirc` file containing the credentials in your home directory.
Package details: https://pypi.python.org/pypi/streamsx.inet
Documentation is using Sphinx and can be built locally using:
```
cd package/docs
make html
```
or
ant doc
and viewed using
```
firefox package/docs/build/html/index.html
```
The documentation is also setup at `readthedocs.io`.
Documentation links:
* http://streamsxinet.readthedocs.io/
## Version update
To change the version information of the Python package, edit following files:
- ./package/docs/source/conf.py
- ./package/streamsx/inet/\_\_init\_\_.py
When the development status changes, edit the *classifiers* in
- ./package/setup.py
When the documented sample must be changed, change it here:
- ./package/streamsx/inet/\_\_init\_\_.py
- ./package/DESC.txt
## Test
### Streaming Analytics service in IBM Cloud
Package can be tested with TopologyTester using a local toolkit and launch the job in [Streaming Analytics](https://www.ibm.com/cloud/streaming-analytics) service.
Ensure that inet toolkit location is part of STREAMS_SPLPATH:
export STREAMS_SPLPATH=$STREAMS_INSTALL/toolkits/com.ibm.streamsx.inet
Run the test with:
ant test-sas
or
```
cd package
python3 -u -m unittest streamsx.inet.tests.test_inet.TestHTTPStreamingAnalytics
```
#### Remote build
For using the toolkit from the build service (**force_remote_build**) run the test with:
Run the test with:
ant test-sas-remote
or
```
cd package
python3 -u -m unittest streamsx.inet.tests.test_inet.TestHTTPStreamingAnalyticsRemote
```
### Local Streams instance
Package can be tested with TopologyTester using a local and running Streams domain.
Make shure that the streams environment is set, the domain and instance is running and the environment variables:
STREAMS_USERNAME
STREAMS_PASSWORD
are setup.
Ensure that inet toolkit location is part of STREAMS_SPLPATH:
export STREAMS_SPLPATH=$STREAMS_INSTALL/toolkits/com.ibm.streamsx.inet
Run the standalone test with:
ant test
or
```
cd package
python3 -u -m unittest streamsx.inet.tests.test_inet.TestHTTP
```
Run the distributed test with:
```
cd package
python3 -u -m unittest streamsx.inet.tests.test_inet.TestHTTPDistributed
```