Table of Contents
CDC.IO Setup for Developers
The CDC.IO Project is a host-based, command-line utility which enables manipulation of dtcyber NOS (1 and 2) PLATO masterfiles and containers.
License
Copyright © 2019-2024 Steven Zoppi
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Release 2.3.1
The first release of the utility on July 4, 2023 (US Independence Day) is significant in that it represents some independence from the tyranny of PLATO files having to be managed through the operating system vehicles of “virtual tape”.
Source Availability
Access to the sources is currently constrained to members of the Cybis Development group at Retro1.Org. Documentation is available but until a rigorous testing all functionality can be done, the sources will remain constrained.
Documentation
The SPHINX
documentation system is used to maintain the package documentation.
The output of SPHINX
is periodically updated at https://static.retro1.org/cdc.io.
Installation
Install GIT
It is assumed that you have GIT installed. There are numerous references available on the web.
Install Python
With the PYTHON interpreter installed from Python.Org
Choose a suitable location (workspace) and clone the cdc.io repository. In my example, I'll use the directory rooted at E:\Engineering\SZ10101
.
In the following examples - I'm using Cmder as my console application. It understands both windows and linux shell commands (generally).
Clone the Repository
Open a command prompt and issue the following commands:
Verify Python
Now, make sure you have properly configured python
.
The virtualenv
(virtual environment) command will be installed… but if you see Requirement already satisfied
messages, that's fine too. You're good-to-go!
Create the Virtual Environment
Now set up the necessary environment for the “sandboxed” python
interpreter.
The first step is to create a virtual environment, then activate it.
Install CDC.IO
Once the virtual environment has been installed and activated, we can now install cdc.io into the environment using the following commands. First, cd cdc.io
to ensure that you're in the proper place from which the installation can take place.
At this point - all of the dependencies have been resolved and there remains one additional housekeeping step. One of the more annoying features of windows is that the CMD
terminal runs with the Windows codepage (Default is Windows 437). Python (and specifically CDC.IO
expects stdin
, stdout
and stderr
to handle UTF-8
encoding for redirection and display.
Running cdc.io –help
reveals this housekeeping step (highlighted in GREEN):
Now issue the set PYTHONIOENCODING=UTF-8
command and now, you should be able to use all of the functionality cdc.io
has to offer!