Copyright (c) Hyperion Entertainment and contributors.

AmigaOS Manual: Python Modules and Packages

From AmigaOS Documentation Wiki
Revision as of 05:38, 13 January 2019 by Janne Peräaho (talk | contribs) (Added DiskObject method description)
Jump to navigation Jump to search

Amiga Specific Modules

Amiga Python contains five Amiga specific modules:

  • amiga - provides access to the most common AmigaOS system calls
  • arexx - support for ARexx communication and ARexx hosts
  • asl - provides access to the requesters
  • catalog - provides access to the localization functions
  • icon - provides access to the icon functions

amiga

This module provides access to AmigaOS system functionality.

abort()

 abort ()

Abort the interpreter immediately. Calling the function fails in the hardest way possible on the hosting operating system. This function does not return!

access()

 access ( path, mode )

Use the real uid (User Identifier) or gid (Group Identifier) to test for access to a path. Note that most operations will use the effective uid/gid, therefore this routine can be used in a suid (Set Owner User ID) or sgid (Set Group ID) environment to test if the invoking user has the specified access to the path.

The mode argument can be F_OK to test existence, or the inclusive-OR of R_OK, W_OK, and X_OK.

chdir()

 chdir ( path )

Change the current working directory to the specified path.

chmod()

 chmod ( path, mode )

Change the access permissions of a file.

chown()

  chown ( path, uid, gid )

Change the owner and group id of path to the numeric uid and gid.

close()

  close ( fd )

Close a file descriptor (for low level I/O).

dup()

  fd2 = dup ( fd )

Return a duplicate of a file descriptor.

dup2()

  dup2 ( old_fd, new_fd )

Duplicate file descriptor.

fdopen()

  file_object = fdopen ( fd [, mode = 'r' [, bufsize ] ] )

Return an open file object connected to a file descriptor.

fstat()

  result = fstat ( fd )

Like stat(), but for an open file descriptor.

ftruncate()

  ftruncate ( fd, length )

Truncate a file to a specified length.

getcpu()

  getcpu ()

Get the CPU model string.

getcwd()

  path = getcwd ()

Return a string representing the current working directory.

getcwdu()

  path = getcwdu ()

Return a unicode string representing the current working directory.

getmachine()

  getmachine ()

Get the machine model string.

getpid()

  pid = getpid ()

Return the current process ID.

getports()

  list_of_strings = getports ()

Returns a list of public message port names.

isatty()

  bool = isatty ( fd )

Return True if the file descriptor 'fd' is an open file descriptor connected to the slave end of a terminal.

kill()

  kill ( pid, sig )

Kill a process 'pid' with a signal 'sig'.

link()

listdir()

lseek()

lstat()

mkdir()

open()

pipe()

popen()

putenv()

read()

remove()

rename()

rmdir()

stat()

stat_float_times()

strerror()

system()

tempnam()

tmpfile()

tmpnam()

umask()

unlink()

urandom()

utime()

waitforport()

write()

arexx

Msg()

Port()

dorexx()

Variables

  • __doc__
  • __file__
  • __name__

asl

This module contains AmigaOS-specific requester function for file and path queries, message boxes, ans similar aspects.

FileRequest()

 drawer, file = FileRequest ( title, drawer, filename, pattern )

Opens a file select requester with the given title, the drawer and filename gadgets predefined by drawer and title. If a pattern is given, a pattern gadget is also displayed and pre-set with the given pattern. The result is a tuple drawer, filename which relects the choice of the user.

Example

Opens up a file requester in T: with 'my.log' as a default name, and a filter set to '#?.log':

drawer, file = asl.FileRequest('Python File Request', 'T:', 'my.log', '#?.log' )

MessageBox()

 result = MessageBox( title, body_text, buttons )

Opens a message box with the given title and body text. The options on the dialog are taken from the 'buttons' argument. The 'buttons' string contains individual substrings separated by a '|'.

The result of this function is the button number selected by the user. Numbering starts from left with 1, 2 and so on, but the final button is 0.

Example

Puts up a requester asking for a 'Yes' or 'No' answer:

result = asl.MessageBox('Python Request', 'AmigaOS rules', 'Yes|No')

Selecting 'Yes' returns 1 and selecting 'No' returns 0.

Variables

  • __doc__
  • __file__
  • __name__

catalog

icon

DiskObject()

 disk_object = DiskObject( path )

Opens an icon file. The path argument is a path to the icon file to be opened without the icon file extension ".info". On success, the DiskObject method will return a "DiskObject" object which contains the following attributes:

Attribute Description
tooltypes Tool types
deftool The default tool
stacksize Stack size

Attributes can be manipulated and saved back to the icon using the PutIcon() method.

Example

Open the "SYS:System/Shell" icon file ("SYS:System/Shell.info") and print its attributes.

import icon # Include icon module
 
ic = icon.DiskObject( 'SYS:System/Shell' )
print( 'Tool types: ' + str( ic.tooltypes ) )
print( 'Default tool: ' + str( ic.deftool ) )
print( 'Stack size: ' + str( ic.stacksize ) )

Amiga Specific Packages

The current Amiga Python release does not contain any Amiga specific packages.