Releasing version 3.22.1

Co-authored-by: Hamada Ibrahim <[email protected]>
Co-authored-by: Harsh Kumar <[email protected]>
Co-authored-by: Kanvi Pasricha <[email protected]>
Co-authored-by: Alex Le <[email protected]>
Co-authored-by: Nupur Gupta <[email protected]>
Co-authored-by: Karthik Kamath <[email protected]>
Co-authored-by: Mandy Tsai <[email protected]>
Co-authored-by: Pankaj Joshi <[email protected]>
Co-authored-by: Anup Singh <[email protected]>

Author: 9 people

CHANGELOG.rst

@@ -6,7 +6,7 @@ All notable changes to this project will be documented in this file.
 
 The format is based on `Keep a Changelog <http://keepachangelog.com/>`__.
 
-3.22.0 - 2022-12-13
+3.22.1 - 2023-01-10
 --------------------
 Added
 ~~~~~

requirements.txt

@@ -14,12 +14,12 @@ Jinja2==3.0.3
 jmespath==0.10.0
 ndg-httpsclient==0.4.2
 mock==2.0.0
-oci==2.90.0
+oci==2.90.1
 packaging==20.2
 pluggy==0.13.0
 py==1.10.0
 pyasn1==0.2.3
-pyOpenSSL>=22.1.0
+pyOpenSSL>=17.5.0,<=22.1.0
 pycparser==2.20
 pyparsing==2.2.0
 pytest==3.2.3

scripts/examples/project_o/README.md

@@ -89,8 +89,27 @@ Public Subnet VLKn:US-ASHBURN-AD-1 AVAILABLE 10.0.0.0/24 sales
     - `o ocids compartment` *instantly* shows the full OCIDs for all compartments
     - `o ocid  sales/bastion` *instantly* shows the full OCIDs for all compartments
 
+#### New features in version 1.3 (2022-12-15)
+ - get paginated results with `o <repeat-last-command> -page next`
+ - take JSON input from a file and format output with `o`
+   - `o -i data.json -o name#id#date`
+ - select child fields from complex output with `-o key.subkey`
+   - note: some fields are dicts or lists that only present well in "text" format
+
+## Installation
+
+**``o``** is a single file. To install, download **``o``**, place it in your PATH (probably in the same place as ``oci``), and make it executable.
+  **``o``** works in Linux, Mac, WSL and CloudShell.
+
+Use these commands to get ``o`` from github and install it next to ``oci``.
+```
+o_src=https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/examples/project_o/o
+where=$(which oci) && to=${where%ci} && wget -q $o_src -O $to && chmod a+x $to
+```
+When you first run `o` it will tell you how to create the commands file *$HOME/.oci/oci_commands*, and then `o` helps you to initialize your *$HOME/.oci/ocids* file.
+
 ## How **``o``** works  
- - **``o``** compares your input with thousands of ``oci`` commands, and uses an intelligent algorithm to find the best match.
+ - **``o``** compares your input with thousands of ``oci`` commands, and uses an fuzzy matching to find the command you want.
 
  - **``o <command>``** provides a usage synopsis, showing required and optional parameters for matching commands.  Add "help" to the end to see global parameters as well.  E.g. <nobr>``o <command> help``</nobr> provides the usage synopsis with global parameters, while <nobr>``o <command> --help go``</nobr> runs <nobr>``oci <command> --help``</nobr>.
 
@@ -118,15 +137,6 @@ You will need:
     - Minimally you need permission to **inspect** resources in order for most commands to work.
 - ``oci`` must be in your PATH so that ``o`` can find it
 
-## Installation
-
-**``o``** should be in your PATH, probably in the same place as ``oci``.  Use these commands to download ``o`` from github and install it next to ``oci``.
-```
-o_src=https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/examples/project_o/o
-where=$(which oci) && wget -q $o_src -O ${where%ci} && chmod a+x ${where%ci}
-```
-When you first run `o` it will tell you how to create the commands file *$HOME/.oci/oci_commands*, and then `o` helps you to initialize your *$HOME/.oci/ocids* file.
-
 **OCIDs File**
 
 **``o``** uses a local cache of OCID-to-name mappings called the OCIDs file, located at *$HOME/.oci/ocids*.  This is populated during setup when you run `o <tenancy_ocid>`.