Commit 9f3dfb3baf1cc99fb7dbc5795cabc5243fb083d7

Authored by caveenj
1 parent b095547d
Exists in master and in 1 other branch odf2csvP3

Ajout des petits guides d'installation et du fichier MANIFEST

pour la construction de la distribution
Ajout des 'docstrings' dans les fonctions et methodes
Ajout des programmmes odf2csvm21 et odf2csv121
src/LISEZ-MOI 0 → 100644
... ... @@ -0,0 +1,79 @@
  1 + GUIDE D'INSTALLATION DE ODF2CSV VERSION 1.0
  2 +
  3 +
  4 +1- Installation sous Linux/Unix
  5 +
  6 + Avant d'installer le paquetage odf2csv, vous devez installer le
  7 + logiciel Python sur votre machine. Python est disponible
  8 + sur le site http://www.python.org
  9 +
  10 + Une fois Python installe, vous n'avez qu'a telecharger le paquetage
  11 + odf2csv a partir du site Web du SGDO-ISMER (http://sgdoqo.uqar.qc.ca).
  12 + Odf2csv pour Linux/Unix est livre en format tar compresse
  13 + (odf2csv-1.0.tar.gz).
  14 +
  15 + L'installation se fait comme suit:
  16 +
  17 +
  18 + 1- tar zxvf odf2csv-1.0.tar.gz
  19 + (ou gunzip -c odf2csv-1.0.tar.gz | tar xvf -)
  20 + 2- cd odf2csv-1.0
  21 + 3- su - root (devenir super utilisateur)
  22 + 3- python setup.py install
  23 +
  24 + Les trois applications composant odf2csv (odf2csv.py,
  25 + odf2csv121.py and odf2csvm21.py) seront maintenant
  26 + disponibles.
  27 +
  28 +
  29 +2- Installation des codes source sous Windows
  30 +
  31 + Avant d'installer le paquetage odf2csv, vous devez installer le
  32 + logiciel Python sur votre machine. Python est disponible
  33 + sur le site http://www.python.org
  34 +
  35 + Une fois Python installe, vous n'avez qu'a telecharger le paquetage
  36 + odf2csv a partir du site Web du SGDO-ISMER (http://sgdoqo.uqar.qc.ca).
  37 + Le code source de Odf2csv pour Windows est livre en format zip.
  38 + (odf2csv-1.0.zip). L'installation se fait de la facon suivante:
  39 +
  40 +
  41 + 1- Telecharger le fichier zip dans un repertoire tel c:\temp
  42 + 2- Extraire le contenu de l'archive odf2csv-1.0.zip (winzip)
  43 + 3- Ouvrir une invite de commande DOS (cmd)
  44 + 4- cd c:\temp\odf2csv-1.0
  45 + 5- python setup.py install
  46 +
  47 + Lors de l'installation, les trois applications de odf2csv
  48 + (odf2csv.py,odf2csv121.py and odf2csvm21.py) seront copiees dans
  49 + le repertoire Scripts de votre installation de
  50 + Python (e.g., c:\Python24\Scripts). Pour que ces applications
  51 + soient disponibles a partir de n'importe quel repertoire de
  52 + votre systeme, vous devrez ajouter ce chemin a la variable
  53 + d'environnement PATH.
  54 +
  55 +
  56 +
  57 +3- Installation avec l'auto-installateur pour Windows
  58 +
  59 +
  60 + Avant d'installer le paquetage odf2csv, vous devez installer le
  61 + logiciel Python sur votre machine. Python est disponible
  62 + sur le site http://www.python.org
  63 +
  64 + Une fois Python installe, vous n'avez qu'a telecharger et executer
  65 + le programme d'installation odf2csv-1.0.win32.exe disponible sur
  66 + le site du SGDO-ISMER (http://sgdoqoweb.uqar.qc.ca)
  67 +
  68 +
  69 + Lors de l'installation, les trois applications de odf2csv
  70 + (odf2csv.py,odf2csv121.py and odf2csvm21.py) seront copiees dans
  71 + le repertoire Scripts de votre installation de
  72 + Python (e.g., c:\Python24\Scripts). Pour que ces applications
  73 + soient disponibles a partir de n'importe quel repertoire de
  74 + votre systeme, vous devrez ajouter ce chemin a la variable
  75 + d'environnement PATH.
  76 +
  77 +
  78 +
  79 +
... ...
src/MANIFEST 0 → 100644
... ... @@ -0,0 +1,8 @@
  1 +class_variable.py
  2 +odf2csv.py
  3 +odf2csv121.py
  4 +odf2csvm21.py
  5 +odf_fcns.py
  6 +setup.py
  7 +README
  8 +LISEZ-MOI
... ...
src/README 0 → 100644
... ... @@ -0,0 +1,73 @@
  1 + ODF2CSV VERSION 1.0 INSTALLATION GUIDE
  2 +
  3 +
  4 +1- Installation on Linux/Unix
  5 +
  6 + Prior to installing the odf2csv package, you must install
  7 + the Python Programming Language environnement on your system.
  8 + The Python software is available for download at http://www.python.org.
  9 +
  10 + Once python is installed on your system, simply download the
  11 + odf2csv package from the ISMER-ODMS Web site
  12 + (http://sgdoqoweb.uqar.qc.ca). The package for Linux/Unix comes
  13 + as a gzip tar file. To install, follow these steps:
  14 +
  15 + 1- tar zxvf odf2csv-1.0.tar.gz
  16 + (or gunzip -c odf2csv-1.0.tar.gz | tar xvf -)
  17 + 2- cd odf2csv-1.0
  18 + 3- su - root (become superuser)
  19 + 4- python setup.py install
  20 +
  21 + The three applications of the odf2csv package (odf2csv.py,
  22 + odf2csv121.py and odf2csvm21.py) should now be
  23 + available for execution.
  24 +
  25 +
  26 +2- Installation of the source code on Windows
  27 +
  28 + Prior to installing the odf2csv package, you must install
  29 + the Python Programming Language environnement on your system.
  30 + The Python software is available for download at http://www.python.org.
  31 +
  32 + Once python is installed on your system, simply download the
  33 + odf2csv package from the ISMER-ODMS Web site
  34 + (http://sgdoqoweb.uqar.qc.ca). The source code package for
  35 + Windows comes as a zip file. To install, follow these steps:
  36 +
  37 + 1- Download the zip file to a directory such as c:\temp
  38 + 2- Unzip odf2csv-1.0.zip
  39 + 3- Open a command window
  40 + 4- cd c:\temp\odf2csv-1.0
  41 + 5- python setup.py install
  42 +
  43 +
  44 + During the installation process, the three applications of the
  45 + odf2csv package (odf2csv.py,odf2csv121.py and odf2csvm21.py)
  46 + will have been copied to the Scripts directory of your Python
  47 + installation (e.g., c:\Python24\Scripts). In order to use
  48 + the odf2csv package from anywhere on your machine, you must
  49 + add this directory to your PATH environnement variable.
  50 +
  51 +
  52 +
  53 +3- Installation with the Windows auto-installer
  54 +
  55 + Prior to installing the odf2csv package, you must install
  56 + the Python Programming Language environnement on your system.
  57 + The Python software is available for download at http://www.python.org.
  58 +
  59 + Once python is installed on your system, simply download and execute the
  60 + odf2csv auto-installer odf2csv-1.0.win32.exe available at the
  61 + ISMER-ODMS Web site (http://sgdoqoweb.uqar.qc.ca).
  62 +
  63 + During the installation process, the three applications of the
  64 + odf2csv package (odf2csv.py,odf2csv121.py and odf2csvm21.py)
  65 + will have been copied to the Scripts directory of your Python
  66 + installation (e.g., c:\Python24\Scripts). In order to use
  67 + the odf2csv package from anywhere on your machine, you must
  68 + add this directory to your PATH environnement variable.
  69 +
  70 +
  71 +
  72 +
  73 +
... ...
src/class_variable.py
... ... @@ -39,31 +39,48 @@ class variable:
39 39  
40 40  
41 41 def getnumero(self):
  42 + '''Obtenir le numero sequentiel de la variable'''
42 43 return self.numero
43 44 def getnom (self):
  45 + '''Obtenir le nom complet de la variable,
  46 + Par exemple: Sensor depth below surface'''
44 47 return self.nom
45 48 def getcode (self):
  49 + '''Obtenir le nom court de la variable.
  50 + Par exemple: DEPH01'''
46 51 return self.code
47 52 def getunites (self):
  53 + '''Obtenir les unites de la variable'''
48 54 return self.unites
49 55 def getp_f_w (self):
  56 + '''Obtenir le PFW (floating point width) de la variable'''
50 57 return self.p_f_w
51 58 def getp_d_p (self):
  59 + '''Obtenir le PDP (Precision decimal places) de la variable'''
52 60 return self.p_d_p
53 61  
54 62 def getnbval(self):
  63 + '''Obtenir le nombre de valeurs associees a la variable'''
55 64 return len(self.valeurs)
56 65  
57 66 def addvaleur(self,valeur):
  67 + '''Ajouter une valeur a la suite des valeurs presentes'''
58 68 self.valeurs.append(valeur)
59 69  
60 70 def setvaleur(self,index, valeur):
  71 + '''Modifier la valeur valeur[index]'''
61 72 self.valeurs[index] = valeur
62 73  
63 74 def replaceallvaleurs(self, valeurs):
  75 + '''Remplacer toutes les valeurs de la variable par une
  76 + nouvelle liste de valeurs'''
64 77 self.valeurs[:] = valeurs
65 78  
66 79 def getvaleur(self,index):
  80 + '''Obtenir la valeur de valeur[index]
  81 + en format float en utilisant les attributs de p_f_w et p_d_p
  82 + pour afficher'''
  83 +
67 84 format1 = '%'
68 85 format2 = '%d.%df' % (self.p_f_w,self.p_d_p)
69 86 format = format1 + format2
... ... @@ -71,6 +88,7 @@ class variable:
71 88  
72 89  
73 90 def getallvaleurs(self):
  91 + '''Obtenir toutes les valeurs de la variable'''
74 92 for val in self.valeurs:
75 93 print val
76 94  
... ...
src/odf2csv121.py 0 → 100755
... ... @@ -0,0 +1,75 @@
  1 +#!/usr/bin/env python
  2 +#! python
  3 +
  4 +#####################################
  5 +#
  6 +#Conversion de fichiers ODF a csv
  7 +#Ce programme appelle odf2csv a repetition
  8 +#avec le nom de tous les fichiers odf du repertoire
  9 +#courant et met le resultat de la conversion
  10 +#dans un fichier csv par fichier odf d'ou le nom odf2csv121 pour
  11 +#odf2csv one odf files to one csv file
  12 +#
  13 +#
  14 +#Auteur: James Caveen
  15 +#
  16 +#
  17 +####################################
  18 +
  19 +import sys
  20 +import getopt
  21 +import os
  22 +import odf_fcns
  23 +
  24 +
  25 +parametres = ""
  26 +
  27 +#On recupere les parametres d'appel
  28 +
  29 +try:
  30 + opts,args = getopt.getopt(sys.argv[1:], \
  31 + 'o:m:deh',\
  32 + ['output=',\
  33 + 'mean=','error',\
  34 + 'doubtfull','help'])
  35 +except getopt.error, msg:
  36 + print msg
  37 + odf_fcns.usagem21()
  38 + sys.exit(2)
  39 +#Processing des parametres
  40 +
  41 +for o , a in opts:
  42 + if o in ("-h","--help"):
  43 + odf_fcns.usage121()
  44 + sys.exit(2)
  45 + elif o in ("-m","--mean"):
  46 + if a in ("--doubtfull","-e","--error","-h","--help","--mean","-m"):
  47 + odf_fcns.usage121()
  48 + sys.exit(2)
  49 + parametres = parametres + " --mean " + a
  50 + elif o in ("-d","--doubtfull"):
  51 + parametres = parametres + " -d"
  52 + elif o in ("-e","--error"):
  53 + parametres = parametres + " -e"
  54 + else:
  55 + print "Option inconnue"
  56 + odf_fcns.usage121()
  57 + sys.exit(2)
  58 +
  59 +#
  60 +#
  61 +#On fait l'appel a odf2csv pour tous
  62 +#les fichiers odf du repertoire courant
  63 +#
  64 +#
  65 +
  66 +for file in os.listdir(os.getcwd()):
  67 + if ".odf" in (file) or ".ODF" in (file):
  68 + s = os.path.splitext(file)
  69 + sortie = s[0] + ".csv"
  70 + commande = "odf2csv.py --input " + file + " --output " + sortie + parametres
  71 + os.system(commande)
  72 +
  73 +
  74 +
  75 +
... ...
src/odf2csvm21.py 0 → 100755
... ... @@ -0,0 +1,86 @@
  1 +#!/usr/bin/env python
  2 +#! python
  3 +
  4 +#####################################
  5 +#
  6 +#Conversion de fichiers ODF a csv
  7 +#Ce programme appelle odf2csv a repetition
  8 +#avec le nom de tous les fichiers odf du repertoire
  9 +#courant et concatene le resultat de la conversion
  10 +#dans un seul fichier csv d'ou le nom odf2csvm21 pour
  11 +#odf2csv many odf files to one csv file
  12 +#
  13 +#
  14 +#Auteur: James Caveen
  15 +#
  16 +#
  17 +####################################
  18 +
  19 +import sys
  20 +import getopt
  21 +import os
  22 +import odf_fcns
  23 +
  24 +
  25 +parametres = ""
  26 +
  27 +#On recupere les parametres d'appel
  28 +
  29 +try:
  30 + opts,args = getopt.getopt(sys.argv[1:], \
  31 + 'o:m:deh',\
  32 + ['output=',\
  33 + 'mean=','error',\
  34 + 'doubtfull','help'])
  35 +except getopt.error, msg:
  36 + print msg
  37 + odf_fcns.usagem21()
  38 + sys.exit(2)
  39 +#Processing des parametres
  40 +
  41 +for o , a in opts:
  42 + if o in ("-h","--help"):
  43 + odf_fcns.usagem21()
  44 + sys.exit(2)
  45 +
  46 + elif o in ("-o","--output"):
  47 + if a in ("-o","--output","-d",\
  48 + "--doubtfull","-e","--error","-h","--help","--mean","-m"):
  49 + odf_fcns.usagem21()
  50 + sys.exit(2)
  51 + parametres = parametres + " -o " + a
  52 + elif o in ("-m","--mean"):
  53 + if a in ("-o","--output","-d",\
  54 + "--doubtfull","-e","--error","-h","--help","--mean","-m"):
  55 + odf_fcns.usagem21()
  56 + sys.exit(2)
  57 + parametres = parametres + " --mean " + a
  58 + elif o in ("-d","--doubtfull"):
  59 + parametres = parametres + " -d"
  60 + elif o in ("-e","--error"):
  61 + parametres = parametres + " -e"
  62 + else:
  63 + print "Option inconnue"
  64 + odf_fcns.usagem21()
  65 + sys.exit(2)
  66 +
  67 +#
  68 +#
  69 +#On fait l'appel a odf2csv pour tous
  70 +#les fichiers odf du repertoire courant
  71 +#
  72 +#
  73 +
  74 +for file in os.listdir(os.getcwd()):
  75 + if ".odf" in (file) or ".ODF" in (file):
  76 + commande = "odf2csv.py --input " + file + parametres
  77 + os.system(commande)
  78 +
  79 +
  80 +
  81 +
  82 +
  83 +
  84 +
  85 +
  86 +
... ...
src/setup.py
1 1 from distutils.core import setup
2 2  
3 3 auteur = "James Caveen"
  4 +entretient = "James Caveen"
  5 +auteur_email="james_caveen@uqar.qc.ca"
  6 +entretient_email="james_caveen@uqar.qc.ca"
  7 +lien="http://sgdoqoweb.uqar.qc.ca"
4 8 nom="odf2csv"
5 9 ver="1.0"
6 10  
7 11 modules = ["class_variable","odf_fcns"]
8   -script = ["odf2csv.py"]
  12 +script = ["odf2csv.py","odf2csvm21.py","odf2csv121.py"]
  13 +
  14 +setup(name=nom,author=auteur,version=ver,py_modules=modules, \
  15 + scripts=script,maintainer=entretient, maintainer_email=entretient_email,\
  16 + author_email=auteur_email,url=lien)
9 17  
10   -setup(name=nom,author=auteur,version=ver,py_modules = modules,console=script)
... ...