Metadata-Version: 2.1
Name: cbmshell
Version: 1.11
Summary: Interactive shell to manipulate Commodore files
Home-page: https://eden.mose.org.uk/gitweb/?p=python-cbmshell.git
Author: Simon Rowe
Author-email: srowe@mose.org.uk
License: UNKNOWN
Description: # cbmshell
        
        This Python module provides an interactive shell to read and write files to disk image files (.d64, .d71, .d80, .d81, .d82) and tape image files (.t64, .tap) used by various Commodore microcomputer emulators and tools.
        
        It permits moving files between images and the local file system as well as other actions such as directory listing and file deletion.
        
        It provides many common benefits of a traditional UNIX shell including filename completion, command history and output redirection.
        
        
        ## Quickstart Guide
        
        The shell is started by running the `cbm-shell` command, this presents the prompt
        
        ```
        (cbm)
        ```
        
        The list of available commands is shown by the `help` command
        
        ```
        (cbm) help
        
        Documented commands (use 'help -v' for verbose/'help <topic>' for details):
        ===========================================================================
        alias   detach     from_petscii  lock          run_script  to_petscii
        attach  directory  help          macro         set         token_set
        cat     edit       history       mkdir         shell       unlist
        copy    file       images        quit          shortcuts   unlock
        delete  format     list          run_pyscript  text        untext
        ```
        
        Detailed information for a command is shown using `help <command>`.
        
        Images need to be attached to a drive number in order to be used.
        
        ```
        (cbm) attach mydisk.d64
        Attached mydisk.d64 to 0
        ```
        
        Up to ten images can be attached at any one time.
        
        Files in an image can be addressed by prefixing the drive number followed by a colon. For example, to list a BASIC program in the image
        
        ```
        (cbm) list 0:PRINT
        5 INPUT"UPPER OR LOWER";C$:SA=0:IFC$="L"THENSA=7
        10 INPUT"FILENAME";F$
        11 OPEN4,4,SA
        15 OPEN2,8,2,F$+",S,R"
        20 GET#2,A$:IFST<>0THENPRINT#4:CLOSE4:CLOSE2:END
        21 IFA$="π"THENA$=","
        30 PRINT#4,A$;:GOTO20
        ```
        
        Full documentation on [Read the Docs](https://cbmshell.readthedocs.io/en/latest/).
        
        
        ## TODO
        
        * more commands
        * better error handling
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
