Skip to content

Commit

Permalink
UPDATE Usage.rst Installation.rst
Browse files Browse the repository at this point in the history
  • Loading branch information
K-Gazdikova committed Jun 16, 2017
1 parent 1a886ba commit 8f14a9a
Show file tree
Hide file tree
Showing 2 changed files with 11 additions and 8 deletions.
2 changes: 2 additions & 0 deletions read-the-docs/source/Installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,9 @@ Installation
pip install ticketutil
* ticketutil is compatible with Python 2.7, 3.3, 3.4, 3.5, and 3.6.

.. note::

For Python 2.6 and lower, an additional package, importlib, may need to be installed.

* If not installing with pip, a short list of packages defined in the requirements.txt file need to be installed. To install the required packages with,
Expand Down
17 changes: 9 additions & 8 deletions read-the-docs/source/Usage.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,13 @@ Usage

**The general usage workflow for creating new tickets is:**

* Create a *JiraTicket*, *RTTicket*, *RedmineTicket*, *BugzillaTicket*
or *ServiceNowTicket* object with ``<url>``, ``<project>`` and ``<auth>``.
This verifies that you are able to properly authenticate to the ticketing tool.
* Create a JiraTicket, RTTicket, RedmineTicket, BugzillaTicket
or ServiceNowTicket object with ``<url>``, ``<project>`` and ``<auth>``. This
verifies that you are able to properly authenticate to the ticketing tool.
To use HTTP Basic Authentication, the ``<auth>`` parameter should contain the
username and password specified as a tuple. For tools that support kerberos
authentication (JIRA and RT), the ``<auth>`` parameter should contain'kerberos'.
authentication (JIRA and RT), the ``<auth>`` parameter should contain
'kerberos'.

* Create a ticket with the ``create()`` method. This sets the ``ticket_id``
instance variable, allowing you to perform more tasks on the ticket.
Expand All @@ -31,7 +32,6 @@ Usage

* Close ticket Requests session with ``close_requests_session()``.


* There is also a ``set_ticket_id()`` method for a Ticket object. This is
useful if you are working with a Ticket object that already has the
``<ticket_id>`` instance variable set, but would like to begin working
Expand All @@ -43,15 +43,16 @@ Usage
``get_ticket_id()`` or ``get_ticket_url()`` methods.

* To run unit tests in Bash terminal use this command:

.. code-block:: python
python3 -m unittest discover ./tests/
.. role:: rubric
:rubric: See the docstrings in the code or the tool-specific files in the docs and examples directories for more information.
See the docstrings in the code or the tool-specific files in the docs
and examples directories for more information.

.. note::
To enable debug logging for ticketutil, set an environment
Note on logging: To enable debug logging for ticketutil, set an environment
variable named TICKETUTIL_LOG_LEVEL to 'DEBUG'. You may specify the following
log levels using this environment variable: DEBUG, INFO, WARNING, ERROR,
CRITICAL. If this environment variable does not exist, the log level will be
Expand Down

0 comments on commit 8f14a9a

Please sign in to comment.