Metadata-Version: 1.1
Name: it4i.portal.clients
Version: 0.8.3
Summary: Client tools for accessing various client APIs of IT4I portals
Home-page: http://www.it4i.cz/
Author: IT4Innovations
Author-email: support@it4i.cz
License: BSD
Description: it4i-portal-clients
        ===================
        
        it4i-portal-clients provides simple user-friendly shell interface to
        call `IT4I API <https://docs.it4i.cz/apiv1/>`__ requests and display
        their respond.
        
        Python 2.7 is required.
        
        Limits are placed on the number of requests you may make to `IT4I
        API <https://docs.it4i.cz/apiv1/>`__. Rate limit can be changed without
        any warning at any time, but the default is 6 requests per minute.
        Exceeding the limit will lead to your ip address being temporarily
        blocked from making further requests. The block will automatically be
        lifted by waiting an hour.
        
        List of available utilities
        ---------------------------
        
        -  `it4icheckaccess <#it4icheckaccess>`__ - Shows if IT4I account and/or
           related project has the access to specified queue.
        -  `it4idedicatedtime <#it4idedicatedtime>`__ - Shows IT4I dedicated
           time.
        -  `it4ifree <#it4ifree>`__ - Shows some basic information from IT4I PBS
           accounting.
        -  `it4ifsusage <#it4ifsusage>`__ - Shows user filesystem usage of IT4I
           cluster storage systems.
        -  `it4imotd <#it4imotd>`__ - Shows IT4I messages of the day into
           formatted text or HTML page (using TAL / Zope Page Template).
        
        Installation / upgrading
        ------------------------
        
        .. code:: bash
        
           pip install --upgrade it4i.portal.clients
        
        Sample config file main.cfg
        ---------------------------
        
        .. code:: bash
        
           [main]
        
           # IT4I API
           api_url = https://scs.it4i.cz/api/v1/
           it4ifreetoken = <your_token>
        
        Username is taken from OS, therefore the script has to be run under the
        same user login name as you use to log into clusters.
        
        -  System-wide config file path:
           ``/usr/local/etc/it4i-portal-clients/main.cfg``
        -  Local user’s config file path: ``~/.it4ifree``
        
        it4icheckaccess
        ---------------
        
        Help of IT4ICHECKACCESS
        ~~~~~~~~~~~~~~~~~~~~~~~
        
        .. code:: console
        
           $ it4icheckaccess -h
           usage: it4icheckaccess [-h] -l LOGIN -q QUEUE [-p PROJECT]
        
           The command shows if IT4I account and/or related project has the access to
           specified queue. \ Return exit code 99 if access is not granted.
        
           optional arguments:
             -h, --help            show this help message and exit
             -l LOGIN, --login LOGIN
                                   user login
             -q QUEUE, --queue QUEUE
                                   queue
             -p PROJECT, --project PROJECT
                                   project id, not required if querying projectless queue
        
        Example of IT4ICHECKACCESS
        ~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        .. code:: console
        
           $ it4icheckaccess -l XXX -q qexp
           OK Access granted for projectless queue.
        
        it4idedicatedtime
        -----------------
        
        Help of IT4IDEDICATEDTIME
        ~~~~~~~~~~~~~~~~~~~~~~~~~
        
        .. code:: console
        
           $ it4idedicatedtime -h
           usage: it4idedicatedtime [-h] [-m {active,planned}]
                                    [-c {anselm,salomon,barbora}]
        
           The command shows IT4I dedicated time. By default all planned and active
           outages of all clusters are displayed. Return exit code 99 if there is no
           outage, otherwise return 0.
        
           optional arguments:
             -h, --help            show this help message and exit
             -m {active,planned}, --message {active,planned}
                                   select type of dedicated time. Planned contains also
                                   active
             -c {anselm,salomon,barbora}, --cluster {anselm,salomon,barbora}
                                   select cluster
        
        Example of IT4IDEDICATEDTIME
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        .. code:: console
        
           $ it4idedicatedtime
           Cluster    Start                End                  Last update
           ---------  -------------------  -------------------  -------------------
           anselm     2019-03-19 08:00:00  2019-03-19 09:30:00  2019-03-08 08:24:33
           salomon    2019-03-19 08:00:00  2019-03-19 09:30:00  2019-03-08 08:23:40
        
        it4ifree
        --------
        
        Help of IT4IFREE
        ~~~~~~~~~~~~~~~~
        
        .. code:: console
        
           $ it4ifree -h
           usage: it4ifree [-h] [-p] [-u {wch,nch,both}]
        
           The command shows some basic information from IT4I PBS accounting. The
           data is related to the current user and to all projects in which user
           participates.
        
           optional arguments:
             -h, --help            show this help message and exit
             -p, --percent
                                   show values in percentage. Projects with unlimited resources are not displayed
             -u {wch,nch,both}, --unit {wch,nch,both}
                                   unit
        
           Columns of "Projects I am participating in":
                    PID: Project ID/account string.
                   Type: Standard or multiyear project.
              Days left: Days till the given project expires.
                  Total: Core-hours allocated to the given project.
                   Used: Sum of core-hours used by all project members.
                     My: Core-hours used by the current user only.
                   Free: Core-hours that haven't yet been utilized.
        
           Columns of "Projects I am Primarily Investigating" (if present):
                    PID: Project ID/account string.
                   Type: Standard or multiyear project.
                  Login: Project member's login name.
                   Used: Project member's used core-hours.
        
        Example of IT4IFREE
        ~~~~~~~~~~~~~~~~~~~
        
        .. code:: console
        
           $ it4ifree
        
           Projects I am participating in
           ==============================
           PID        Type    Days left      Total    Used NCHs    My NCHs     Free
           ---------  ------  -----------  -------  -----------  ---------   ------
           OPEN-XX-XX S       323                0      5169947      50001  1292555
        
        
           Projects I am Primarily Investigating
           =====================================
           PID        Type    Login         Used NCHs
           ---------  ------  ----------  -----------
           OPEN-XX-XX M-1     user1            376670
                              user2           4793277
        
           Legend
           ======
           WCH   =    Wall-clock Core Hour
           NCH   =    Normalized Core Hour
        
        it4ifsusage
        -----------
        
        Help of IT4IFSUSAGE
        ~~~~~~~~~~~~~~~~~~~
        
        .. code:: console
        
           $ it4ifsusage -h
           usage: it4ifsusage [-h] [-c {all,anselm,salomon,barbora}]
        
           The command shows user filesystem usage of IT4I cluster storage systems
        
           optional arguments:
             -h, --help            show this help message and exit
             -c {all,anselm,salomon,barbora}, --cluster {all,anselm,salomon,barbora}
                                   select cluster
        
        Example of IT4IFSUSAGE
        ~~~~~~~~~~~~~~~~~~~~~~
        
        .. code:: console
        
           $ it4ifsusage
           Cluster    File System    Space used    Space limit      Entries used  Entries limit    Last update
           ---------  -------------  ------------  -------------  --------------  ---------------  -------------------
           anselm     /home          1.1 MiB       238.4 GiB                  22  500,000          2020-02-18 12:55:19
           barbora    /home          40.0 KiB      23.8 GiB                   10  500,000          2020-02-18 12:50:12
           salomon    /home          1.6 GiB       238.4 GiB                 170  500,000          2020-02-18 12:50:06
           anselm     /scratch       0 Bytes       93.1 TiB                    0  10,000,000       2020-02-18 12:55:37
           barbora    /scratch       0 Bytes       9.3 TiB                     0  10,000,000       2020-02-18 12:50:26
           salomon    /scratch       16.0 KiB      93.1 TiB                    2  10,000,000       2020-02-18 12:50:39
           salomon    /scratch/work  16.0 KiB      N/A                         2                   2020-02-18 12:50:44
        
        it4imotd
        --------
        
        Help of IT4IMOTD
        ~~~~~~~~~~~~~~~~
        
        .. code:: console
        
           $ it4imotd -h
           usage: it4imotd [-h] [-t TEMPLATE] [-w WIDTH] [-c]
        
           The command shows IT4I messages of the day into formatted text or HTML page.
        
           optional arguments:
             -h, --help            show this help message and exit
             -t TEMPLATE, --template TEMPLATE
                                   path to TAL / Zope Page Template, output will be
                                   formatted into HTML page
             -w WIDTH, --width WIDTH
                                   maximum line width (intended for text rendering,
                                   default of 78 columns)
             -c, --cron            sleep from 10 up to 60 seconds prior to any actions
             -m {important,notice}, --message {important,notice}
                                   select type of messages
        
        Example of IT4IMOTD
        ~~~~~~~~~~~~~~~~~~~
        
        .. code:: console
        
           $ it4imotd
        
                                  Message of the Day (DD/MM/YYYY)
                                       (YYYY-MM-DD hh:mm:ss)
        
           More on https://...
        
        Changelog
        ---------
        
        0.8.3 (2020-10-29)
        ------------------
        
        Other
        ~~~~~
        
        -  Fix multiyear periods. [Marek Chrastina]
        
        .. _section-1:
        
        0.8.2 (2020-05-06)
        ------------------
        
        .. _other-1:
        
        Other
        ~~~~~
        
        -  Add multiyear into it4ifree. [Marek Chrastina]
        
        -  Update CI. [Marek Chrastina]
        
        .. _section-2:
        
        0.8.1 (2020-03-25)
        ------------------
        
        .. _other-2:
        
        Other
        ~~~~~
        
        -  Add python safety to CI. [Marek Chrastina]
        
        .. _section-3:
        
        0.8.0 (2020-02-18)
        ------------------
        
        .. _other-3:
        
        Other
        ~~~~~
        
        -  Add Barbora cluster and IT4I API url. [Marek Chrastina]
        
        .. _section-4:
        
        0.7.8 (2019-03-22)
        ------------------
        
        .. _other-4:
        
        Other
        ~~~~~
        
        -  Add it4ifsusage command. [Marek Chrastina]
        
        .. _section-5:
        
        0.7.7 (2019-03-11)
        ------------------
        
        .. _other-5:
        
        Other
        ~~~~~
        
        -  Add it4icheckaccess command. [Marek Chrastina]
        
        -  Add it4idedicatedtime command. [Marek Chrastina]
        
        .. _section-6:
        
        0.7.6 (2019-03-06)
        ------------------
        
        .. _other-6:
        
        Other
        ~~~~~
        
        -  Add options to select type of motd messages. [Marek Chrastina]
        
        .. _section-7:
        
        0.7.5 (2019-03-06)
        ------------------
        
        .. _other-7:
        
        Other
        ~~~~~
        
        -  Extract json related code to separated library. [Marek Chrastina]
        
        -  It4ifreetoken configuration option will be mandatory just for
           it4ifree command. [Marek Chrastina]
        
        -  Remove functionaless options. [Marek Chrastina]
        
        -  Rename motd_rss to it4imotd. [Marek Chrastina]
        
        .. _section-8:
        
        0.7.4 (2019-03-05)
        ------------------
        
        .. _other-8:
        
        Other
        ~~~~~
        
        -  Add option to show values in percentage for it4ifree. [Marek
           Chrastina]
        
        -  Replace argument parser library in it4ifree. [Marek Chrastina]
        
        -  New api url in config. [Marek Chrastina]
        
        .. _section-9:
        
        0.7.3 (2019-03-04)
        ------------------
        
        .. _other-9:
        
        Other
        ~~~~~
        
        -  Update documentation. [Marek Chrastina]
        
        -  Fix help bug. [Marek Chrastina]
        
        .. _section-10:
        
        0.7.2 (2019-03-01)
        ------------------
        
        .. _other-10:
        
        Other
        ~~~~~
        
        -  Update documentation. [Marek Chrastina]
        
        -  Do not allow CI failure. [Marek Chrastina]
        
        -  Fix pylint complaints. [Marek Chrastina]
        
        -  Install required pip packages before run pylint. [Marek Chrastina]
        
        -  Fix pylint complaints. [Marek Chrastina]
        
        -  Fix shellcheck complaints. [Marek Chrastina]
        
        -  Change automatic upload to manual. [Marek Chrastina]
        
        .. _section-11:
        
        0.7.1 (2019-02-28)
        ------------------
        
        .. _other-11:
        
        Other
        ~~~~~
        
        -  Exclude merge commits from changelog. [Marek Chrastina]
        
        -  Add CI deploy. [Marek Chrastina]
        
        -  Add CI pylint. [Marek Chrastina]
        
        -  Add CI shellcheck. [Marek Chrastina]
        
        -  Fix mdl complaints. [Marek Chrastina]
        
        -  Add CI mdcheck. [Marek Chrastina]
        
        .. _section-12:
        
        0.6.7 (2017-09-08)
        ------------------
        
        .. _other-12:
        
        Other
        ~~~~~
        
        -  Core hour => core-hour. [David Hrbáč]
        
        -  Standard CH => Normalized CH. [David Hrbáč]
        
        .. _section-13:
        
        0.6.6 (2017-09-08)
        ------------------
        
        .. _other-13:
        
        Other
        ~~~~~
        
        -  Code lint. [David Hrbáč]
        
        -  Clean-up unused imports. [David Hrbáč]
        
        .. _section-14:
        
        0.6.5 (2017-09-05)
        ------------------
        
        .. _other-14:
        
        Other
        ~~~~~
        
        -  Core Hours to Wall-clock Core Hours; Fixes
           it4i-admins/it4i-portal-clients#4. [David Hrbáč]
        
        .. _section-15:
        
        0.6.4 (2017-09-05)
        ------------------
        
        .. _other-15:
        
        Other
        ~~~~~
        
        -  Core Hours to Wall-clock Core Hours; Fixes
           it4i-admins/it4i-portal-clients#4. [David Hrbáč]
        
        .. _section-16:
        
        0.6.3 (2017-08-08)
        ------------------
        
        .. _other-16:
        
        Other
        ~~~~~
        
        -  Beutify format. [Jan Krupa]
        
        -  Fixed Standart -> Standard. [Jan Krupa]
        
        -  Fixed labels. [kru0096]
        
        -  Display normalized core hours. [kru0096]
        
        .. _section-17:
        
        0.6.2 (2017-07-25)
        ------------------
        
        .. _other-17:
        
        Other
        ~~~~~
        
        -  Use the JSON for HTML render. [David Hrbáč]
        
        .. _section-18:
        
        0.6.1 (2017-07-25)
        ------------------
        
        .. _other-18:
        
        Other
        ~~~~~
        
        -  Use the JSON. [David Hrbáč]
        
        .. _section-19:
        
        0.5.12 (2017-07-25)
        -------------------
        
        .. _other-19:
        
        Other
        ~~~~~
        
        -  Require dateutil. [David Hrbáč]
        
        .. _section-20:
        
        0.5.11 (2017-07-25)
        -------------------
        
        .. _other-20:
        
        Other
        ~~~~~
        
        -  Use 24 hours. [David Hrbáč]
        
        .. _section-21:
        
        0.5.10 (2017-07-25)
        -------------------
        
        .. _other-21:
        
        Other
        ~~~~~
        
        -  Use the JSON. [David Hrbáč]
        
        .. _section-22:
        
        0.5.9 (2017-07-21)
        ------------------
        
        .. _other-22:
        
        Other
        ~~~~~
        
        -  Release 0.5.9. [David Hrbáč]
        
        -  Typo. [David Hrbáč]
        
        .. _section-23:
        
        0.5.8 (2017-07-21)
        ------------------
        
        .. _other-23:
        
        Other
        ~~~~~
        
        -  Move to HTTPS channel. [David Hrbáč]
        
        -  Convert it4ifree to SCS, motd deprecated. [David Hrbáč]
        
        .. _section-24:
        
        0.5.7 (2017-02-06)
        ------------------
        
        .. _other-24:
        
        Other
        ~~~~~
        
        -  Handle long titles. [David Hrbáč]
        
        .. _section-25:
        
        0.5.6 (2017-02-03)
        ------------------
        
        .. _other-25:
        
        Other
        ~~~~~
        
        -  Corrections to README. [David Hrbáč]
        
        -  Test commit. [Jan Krupa]
        
        .. _section-26:
        
        0.5.5 (2017-02-02)
        ------------------
        
        .. _other-26:
        
        Other
        ~~~~~
        
        -  Enable to display timerange for events. [David Hrbáč]
        
        .. _section-27:
        
        0.5.2 (2016-10-10)
        ------------------
        
        .. _other-27:
        
        Other
        ~~~~~
        
        -  Format text. [Jan Krupa]
        
        .. _section-28:
        
        0.5.1 (2016-10-10)
        ------------------
        
        .. _other-28:
        
        Other
        ~~~~~
        
        -  Pypandoc version pinned. [Filip Valder]
        
        .. _section-29:
        
        0.5 (2016-10-10)
        ----------------
        
        .. _other-29:
        
        Other
        ~~~~~
        
        -  License changed. [Jan Krupa]
        
        .. _section-30:
        
        0.4.9 (2016-06-24)
        ------------------
        
        .. _other-30:
        
        Other
        ~~~~~
        
        -  A helpful script for testing installs. [Filip Valder]
        
        .. _section-31:
        
        0.4.8 (2016-06-24)
        ------------------
        
        .. _other-31:
        
        Other
        ~~~~~
        
        -  A more advanced solution for setup.py. [Filip Valder]
        
        -  Without the dot. [Filip Valder]
        
        -  A more advanced solution for setup.py. [Filip Valder]
        
        .. _section-32:
        
        0.4.7 (2016-06-24)
        ------------------
        
        .. _other-32:
        
        Other
        ~~~~~
        
        -  Handle KeyError: ‘IT4I_FACTORY_PREBUILD’ [Filip Valder]
        
        .. _section-33:
        
        0.4.6 (2016-06-24)
        ------------------
        
        .. _other-33:
        
        Other
        ~~~~~
        
        -  Setup_requires depends on the evironment: IT4I factory versus
           end-user. [Filip Valder]
        
        .. _section-34:
        
        0.4.5 (2016-06-24)
        ------------------
        
        .. _other-34:
        
        Other
        ~~~~~
        
        -  Get python interpreter from the environment. [Filip Valder]
        
        .. _section-35:
        
        0.4.4 (2016-06-24)
        ------------------
        
        .. _other-35:
        
        Other
        ~~~~~
        
        -  Setup deps. [Filip Valder]
        
        .. _section-36:
        
        0.4.3 (2016-06-24)
        ------------------
        
        .. _other-36:
        
        Other
        ~~~~~
        
        -  Some ignores added. [Filip Valder]
        
        .. _section-37:
        
        0.4.2 (2016-06-23)
        ------------------
        
        .. _other-37:
        
        Other
        ~~~~~
        
        -  The other way round. [Filip Valder]
        
        -  Exclude git-related stuff from MANIFEST.in. [Filip Valder]
        
        -  Additional requirements for setup. [Filip Valder]
        
        -  Some gitchangelog rc file. [Filip Valder]
        
        -  Mising comma. [Filip Valder]
        
        -  Auto-versioning accto git tags. [Filip Valder]
        
        -  See the hint in it4ifree.py. [Filip Valder]
        
        -  White space. [Filip Valder]
        
        -  Instructions re-ordered. [Filip Valder]
        
        .. _section-38:
        
        0.4.1 (2016-06-01)
        ------------------
        
        .. _other-38:
        
        Other
        ~~~~~
        
        -  Keywords added. [Filip Valder]
        
        -  Important functional improvements & introduced README. [Filip Valder]
        
        .. _section-39:
        
        0.4 (2016-06-01)
        ----------------
        
        .. _other-39:
        
        Other
        ~~~~~
        
        -  Config module introduced. [Filip Valder]
        
        -  Sample config file. [Filip Valder]
        
        -  README.txt -> README.md due to GL (the change will also appear in
           setup.py) [Filip Valder]
        
        -  Init & use module name ; not filename. [Filip Valder]
        
        -  Get ready for 0.4 release. [Filip Valder]
        
        -  Use module name ; not filename. [Filip Valder]
        
        -  Bug fixes. [Filip Valder]
        
        -  Support for sorting. [Filip Valder]
        
        -  Support for published date/time. [Filip Valder]
        
        -  CStringIO for full module usage support. [Filip Valder]
        
        .. _section-40:
        
        0.3.4 (2016-05-19)
        ------------------
        
        .. _other-40:
        
        Other
        ~~~~~
        
        -  Support for stdin and various feed sources. [Filip Valder]
        
        -  Logging goes to separate file. [Filip Valder]
        
        -  Write to stderr instead of stdout. [Filip Valder]
        
        -  Egg-info for 0.3.3.post2. [Filip Valder]
        
        -  Repository moved, project IT4I-ized… [Filip Valder]
        
        -  0.3.3.post1 released: setuptools is already dep of PIP, it may mess
           things up during install. [Filip Valder]
        
        .. _section-41:
        
        0.3.3 (2016-02-25)
        ------------------
        
        .. _other-41:
        
        Other
        ~~~~~
        
        -  Egg-info files for 0.3.3. [Filip Valder]
        
        -  0.3.3 released. [Filip Valder]
        
        -  Support for verbose and width opts; short opt for cron changed.
           [Filip Valder]
        
        -  Default template fixes. [Filip Valder]
        
        -  Sync with MANIFEST.in. [Filip Valder]
        
        -  Remove dist from repository. [Filip Valder]
        
        -  0.3.2 stable with unicode encoding fixed. [Filip Valder]
        
        -  Add README. [Filip Valder]
Keywords: accounting api client extranet feed it4i it4innovations it4i.portal.clients it4i-portal-clients motd pbs portal rss tool
Platform: UNKNOWN
Classifier: Programming Language :: Python
