p4ruby 2019.1.1873991 → 2020.1.1970474

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc6c6adb6935f0ef33af6ccf75f4d9cc93b37b6cd6425dec8c9450164224ce5a
-  data.tar.gz: 032f6179c0a3a4860a50bbdec0c3a2d114b4853291296daf0f8d1b5a33f6382f
+  metadata.gz: 60cd8b09fe3d292d552829136727ad57e79d396972ae16406bc2075b70bd5312
+  data.tar.gz: 733ab6750c83fd84ea4075a60c450d836bde824eaf29365f33b420b8d60e98be
 SHA512:
-  metadata.gz: 734d2d4d99d9980830de784d0184b9dbf577578c0e51a4cd53cadc5276fd7d45d763eb8b9b4a48852f489e160f67d1c008ba64c6b878737db53a9dfcbd0fb0ce
-  data.tar.gz: 99cd9fe1f32dc810e7736d95b22b46882366d84a922ae289c6405464ae9bf1edcff99d6cbe406ef4bd5e48f44c8f62564e7902473677b96231b47a5b8fcd385f
+  metadata.gz: 8d36c05e105836b5f8b2c9acf6d7dc44d0088ee7ddb6de1048100293ad20691da7f943e1444b7a6a0f8731d4010a1370868e43b31a52fa4e206e462c21c37bdb
+  data.tar.gz: 118c4f3eb92f4867db3e1655e5a2be37557e1f125588c069c824d7ba2ad7ba4ff1b87869b3a690615b0a875b101d8b09e46725e2553336a3f83fb1f2e338bfb6

data/README.md

@@ -1,880 +1,4 @@
-# Release Notes for P4Ruby, Perforce's script API for Ruby
+[![Support](https://img.shields.io/badge/Support-Official-green.svg)](mailto:support@perforce.com)
 
-Version 2017.1
-
-## Introduction
-
-P4Ruby is a native Ruby gem that allows you to run Perforce commands from
-Ruby applications, and retrieve the results in a Ruby-friendly format.
-
-P4Ruby is intended to work against a corresponding version of the Perforce
-C++ API, e.g., P4Ruby 2017.1 will be compiled using a 2017.1 version
-of the P4API. You can always install P4Ruby specifying a specific version of
-the P4API.
-
-To determine the version of your P4Ruby, and which version of the
-P4API it has been built with, issue the following command:
-
-    ruby -rP4 -e "puts P4.identify"
-
---------------------------------------------------------------------------
-
-### Installing P4Ruby
-
-As of 2014.2, the recommended mechanism for installing P4Ruby is via
-rubygems.org.
-
-Before installing, please take care that any older version of P4Ruby that
-may have been installed outside of the Gem process is removed from your
-gempath. The older installation process can not be easily removed and may
-conflict with a gem-based install. Make sure that both P4.rb and P4.so (or
-P4.bundle on OS X) are not available within the load path of Ruby. You can
-use the `puts $:` command in `irb` to determine your current load path.
-
-Outside of Windows, p4ruby gem installs must be compiled locally against
-your installation of Ruby. If you can build the core Ruby distribution
-locally, you likely can install P4Ruby without incident. On Windows,
-precompiled gems are available, which already include the P4API and OpenSSL.
-
-The main command to install p4ruby is via gem or bundler. (When using the
-default system rubies from OS X or the CentOS Software Collections Library,
-see 'Problems Specifying P4API' below.)
-
-    gem install p4ruby
-
-This will download a corresponding version of the p4api from ftp.perforce.com,
-and will automatically include the openssl version you have locally.
-
-If you have downloaded the p4api and unpacked it, you can specify it using the
-`--with-p4api-dir` option.
-
-    gem install p4ruby -- --with-p4api-dir=DIR
-
-In this case, the DIR above is the path to the C++ API distribution that
-should match the major and minor version of P4Ruby. If you omit the
---with-p4api-dir option, the gem will attempt to download a version of the
-API itself from ftp.perforce.com.
-
-Alternatively, you can use Bundler (http://bundler.io). In your Gemfile,
-specify
-
-    gem 'p4ruby', '~> 2017.1'
-
-And then execute:
-
-    bundle --with-p4api-dir=DIR
-
-#### Problems Specifying P4API
-
-On older Ruby platforms, such as the default OS X or ruby193 CentOS
-distributions, issues can arise when specifying the P4API directly via
-the command line.
-
-In these cases, you may need to indicate the include and lib directories
-directly:
-
-    gem install p4ruby -- --with-p4api-dir=DIR \
-       --with-p4-api-include=DIR/include \
-       --with-p4-api-lib=DIR/lib
-
-An alternative is to specify the P4API directory using the `p4api_dir`
-environment variable.
-
-
---------------------------------------------------------------------------
-
-### Building P4Ruby from Source on Linux or OS X
-
-1. Download the Perforce C++ API from the Perforce FTP site at
-   "ftp://ftp.perforce.com/perforce". The API archive is located
-   in release and platform-specific subdirectories and is named
-   "p4api.tgz".
-
-   __IMPORTANT__: Mac OS X users MUST use the 'darwin' variant
-   of the Perforce API. Using the 'macos' variant
-   does not work.
-
-   Note: 32-bit builds of P4Ruby require a 32-bit version of the
-   C++ API and a 32-bit version of Ruby. 64-bit builds of
-   P4Ruby require a 64-bit version of the C++ API and a
-   64-bit version of Ruby.
-
-   Unzip the archive into an empty directory.
-
-2. Extract the P4Ruby API archive into a new, empty directory.
-
-3. In the p4ruby source directory, install dependencies:
-
-        bundle install
-
-3. In the p4ruby source directory, build the gem:
-
-        p4api_dir=<absolute path to Perforce C++ API> rake compile
-
-4. Test your distribution, which relies on a locally installed p4d.
-
-        rake test
-
-    If `p4d` is not available on your path, indicate it via the `P4D_BIN`
-    environment variable before running `rake test`.
-
-5. Install P4Ruby into your local gem cache:
-
-    rake install
-
-#### SSL support
-
-Perforce Server 2012.1 and later supports SSL connections and the
-C++ API has been compiled with this support. For applications that
-do not requireSSL support the C++ API provides a stub library
-(libp4sslstub.*) to satisfy the linker requirements.
-
-If the P4Ruby build detects that OpenSSL is available, it will be
-included by default. To disable, execute the gem command using
---without-ssllib. If you want to use libraries deployed to nonstandard
-paths, you will have to alter ext/P4/extconf.rb and include the
-dir_config() directives appropriate for your system.
-
---------------------------------------------------------------------------
-
-### Compatibility Statements
-
-#### Server Compatibility
-
-You can use any release of P4Ruby with any release of the
-Perforce server later than 2001.1
-
-You should use a version of P4Ruby built against a corresponding version
-of the P4API that matches your Perforce server version. Since 2014.2,
-you should try to use the same major and minor variation of P4Ruby as
-used by the Perforce server. Ergo, against Perforce server version 2017.1,
-you would want a P4Ruby version that starts with 2017.1.
-
-#### API Compatibility
-
-The 2017.1 release of P4Ruby supports the 2017.1 Perforce API.
-Older releases might work but are not supported.
-
-#### Ruby Compatibility
-
-The 2017.1 release of P4Ruby is supported by installing the gem
-with Ruby MRI releases 2.0, 2.1, 2.2, and 2.3, with shared library
-support.
-
-For detailed compatibility, please check the following table:
-
-    Ruby Release | P4Ruby Release
-    ===================================
-         <2.0    | 2011.1 or later (unsupported)
-         2.0     | 2014.1 or later
-         2.1     | 2014.2 or later
-         2.2     | 2014.2 or later
-         2.3     | 2017.1 or later
-
-It is recommended that you use a Ruby distribution that can deploy
-native gems easily, which, outside of Windows means obtaining a source
-distribution of ruby and building it locally. This is easily done via RVM,
-and can be installed system-wide, with other features (like wrappers) that
-allow you to update the local installation of Ruby as security patches are
-released. If using RVM, be sure to use --disable-binary when installing
-your version of Ruby, to avoid any precompiled distributions that may not
-have shared library support configured, which is needed for Ruby
-extensions.
-
-In general, Ruby VMs installed via package managers are not officially
-coordinated with the MRI releases available on ruby-lang.org.
-
-We do verify that p4ruby works with Ruby 1.9 on Debian (and Ubuntu), and
-on CentOS 6 using the Software Collections Library. These are considered
-"stable" distributions, and do receive security updates.
-
-Other versions of Ruby, such as the default distribution of OS X may not
-work. The default OS X Ruby is infrequently updated by Apple, and is known
-to contain issues that do not seem to be patched.
-
-#### OpenSSL Compatibility
-
-To build P4Ruby with encrypted communication support, you must
-use the version of OpenSSL that Perforce C/C++ API has been
-built against.  Running P4Ruby linked to an older library will
-fail with the error:
-
-    "SSL library must be at least version 1.0.1."
-
-The 2017.1 release of P4Ruby is supported with OpenSSL 1.0.2
-
-For detailed compatibility, please check the following table:
-
-    Perforce C/C++ API Version | OpenSSL Release
-    ============================================
-         2012.1                | 	1.0.0
-         2012.2                | 	1.0.1g+
-         2014.1                | 	1.0.1g+
-         2014.2                | 	1.0.1i+
-         2015.1                | 	1.0.1i+
-         2015.2                | 	1.0.1i+
-         2017.1                |  1.0.2l+
-
-
-#### Platform Compatibility
-
-Note: As of 2012.1, a universal build of the Perforce C/C++
-API is no longer available for Darwin. P4Ruby is now
-a 64-bit only library on Darwin and must be built with
-a 64-bit version of the Perforce C/C++ API for Darwin.
-This has been tested with a universal build of Ruby and
-is known to work.
-
-#### Compiler Compatibility
-
-To build P4Ruby from source, you must use a version of Ruby that
-has been compiled with the same compiler used to build the
-Perforce C++ API: for most platforms, use gcc/g++.
-
-Attempting to use a different compiler or a different version
-of the compiler causes linker errors due to differences in name
-handling between compilers.
-
-#### Compatibility with Previous Releases
-
-Unless otherwise stated below, the 2017.1 release of P4Ruby is
-compatible with previous releases from Perforce Software.
-
-#### Known Limitations
-
-The Perforce client-server protocol is not designed to support
-multiple concurrent queries over the same connection. For this
-reason, multi-threaded applications using the C++ API or the
-script APIs (P4Perl, P4Ruby, etc.) should ensure that a
-separate connection is used for each thread or that only one
-thread may use a shared connection at a time.
-
-
-## Deleted Methods
-
-The following methods have been deleted from the `P4` class and
-are no longer available:
-
-- `output` The output is returned by the `run*` methods
-- `parse_forms` Form parsing is now always on
-- `tagged` See tagged? and tagged= below.
-
-## Tagged Mode and Form Parsing
-
-In P4Ruby, both form parsing and tagged output are on by
-default.
-
-Form parsing cannot be explicitly disabled, but tagged output can
-be turned on and off by setting p4.tagged as follows:
-
-    p4.tagged = false	# Disabled
-    p4.tagged = true	# Enabled
-
-Because form parsing does not work when tagged output is disabled,
-this method can be used to disable form parsing if necessary.
-
---------------------------------------------------------------------------
-## Change overview
-
-This document lists all user-visible changes to P4Ruby
-from release 2007.3, the first supported P4Ruby release.
-
-Perforce numbers releases YYYY.R/CCCCC, e.g. 2002.1/30547.
-YYYY is the year; R is the release of that year; CCCCC is the
-bug fix change level. Each bug fix in these release notes is
-marked by its change number. Any build includes (1) all bug fixes
-of all previous releases and (2) all bug fixes of the current
-release up to the bug fix change level.
-
---------------------------------------------------------------------------
-
-New functionality in 2017.1
-
-- (SIR#96305/ P4RUBY-214)
-    Add get/set trust file location to api
-
-- (SIR#93993 / P4RUBY-206)
-
-    Add a reset() method for resetting p4 client data (messages, output, etc.)
-    between calls to run
-
-- (SIR#92235 / P4RUBY-204)
-
-    Support graph depot commands
-
-New functionality in 2015.2
-
-- (SIR#78548 / P4RUBY-193)
-
-    Release native P4Ruby gems for x86-mingw32 and x64-mingw32.
-    Until this point, the only source gems have been available. These gems
-    will allow Windows users for 32 or 64-bit Ruby 2.0, 2.1 or 2.2 to easily
-    install P4Ruby.
-
-Changes in both 2015.2.0.pre0 and 2015.1.0
-
-- Applied change to P4ClientApi::SetCharset, that if it is set to "none", then
-  we will ignore the setting. The P4API enviro file handling seems to always
-  create this setting and apply it in various circumstances.
-
-Changes in 2015.1.0
-
-- Updated spec mappings in specmgr.cpp to be up to date with the 2015.1 P4API
-
-- Allow the P4_BIN environment variable to be set to point to a p4d for the
-  testing library (used by the `rake test` task).
-
-New functionality in 2014.2
-
-- (SIR#28879 / P4RUBY-25)
-
-    Release P4Ruby as Gem. Until this point, the gems available
-    on rubygems.org were unofficial builds, and prone to fail in
-    non-interactive environments like bundler.
-
-- (SIR#75097 / P4RUBY-169)
-
-    Add `enviro_file` property to P4 object, which underneath, uses the
-    new `SetEnviroFile`/`GetEnviroFile` mechanism from the 14.2 C++ API.
-
-Changes in 2014.2.0.pre6
-
-- Documented workarounds to installation failures on the OS X default Ruby
-  installation.
-
-Changes in 2014.2.0.pre5
-
-- Fixed an issue where using the --with-p4api-dir option to gem install
-  would not actually set up the include and lib compilation directory
-  correctly.
-
-- No longer distributing precompiled builds for linux or OS X due to
-  inadequate information from gem to match the Ruby distribution correctly.
-
-- No longer embedding the C++ P4API to keep the total file size down to
-  allow the gem to be distributed via RubyGems.org.
-
-- Changed logic to call p4.charset=nil if charset is already nil or resolves
-  to 'none'. Internally, this will trigger a call to ClientApi::SetTrans(0),
-  which should disable character set autodetection.
-
-Bugs fixed in 2014.2.0.pre4
-
-- (BUG#77207 / P4RUBY-176)
-    If the user has specified 'P4CHARSET=none' in a configuration file, or
-    has not set p4.charset='auto' (and it's default value was initialized to
-    'none' by the C++ API), automatically disable character set detection.
-    This can cause the API to break when connecting to non-unicode servers
-    even though it appears to be configured to not be a unicode client.
-
-- The default C++ API version should be included with the gem source, to
-  avoid calls to ftp.perforce.com.
-
-Bugs fixed in 2014.2.0.pre3
-
-- (BUG#75096 / P4RUBY-168)
-    Spec mappings updated to 14.2 definitions.
-
-- (TASK#76795 / P4RUBY-176)
-    Configuring pre-compiled gems for Linux and OS X, for supported
-    Ruby versions (2.0, 2.1, 2.2).
-
-Bugs fixed in 2014.2.0.pre2
-
-- (BUG#76321 / P4RUBY-171)
-    `gem install` fails using source gem distribution inside of a Docker
-    environment due to passive FTP mode not enabled early enough.
-
---------------------------------------------------------------------------
-
-New functionality in 2014.1
-
-- 807216 (SIR#70070)
-
-    P4Ruby now supports the P4IGNORE file feature introduced
-    in the 2013.2 server. Three new methods have been added
-    to support this functionality:
-
-        P4#ignore_file		- Report current file
-        P4#ignore_file=		- Set ignore file
-        P4#ignored?( <file> )	- Test if <file> is
-                      ignored
-
-- 807216, 750979 (SIR#70093)
-
-    P4Ruby now supports the Ruby 2.0 series of rubies.
-
---------------------------------------------------------------------------
-
-Bugs fixed in 2013.1
-
-- 733921 (Bug#63887)
-
-    P4Ruby no longer crashes when an exception is raised from
-    the block passed to P4#run_resolve.
-
---------------------------------------------------------------------------
-
-New functionality in 2012.2
-
-- 525301 (Bug #59803)
-
-    P4Ruby now supports Apple Mountain Lion (10.8).
-
-- 509253 (Bug #56480)
-
-    Added P4#run_tickets() method to list local tickets.
-    Note that P4.run('tickets') still gives the old error
-    message "Must upgrade to 2004.2 p4 to access tickets."
-
-- 505980 (Bug #56514)
-
-    Support for the new progress indicator API. P4Ruby
-    supplies a new progress attribute, which can take an
-    instance of P4::Progress class or subclass. Progress
-    information is currently only supported for submits and
-    'sync -q'. Details can be found in the documentation.
-
-- 499586 (Bug #56520)
-
-    New convenience method P4#each_<specs>() that allows
-    easy iteration through some or all spec objects such as
-    clients or changes. Details can be found in the documentation.
-
-Bugs fixed in 2012.2
-
-- 525097 (Bug #59786)
-
-    Building P4Ruby with MinGW could generate the link error.
-
-        g++: unrecognized option '-static-libstdc++'
-
-    This has been fixed.
-
-- 505548 (Bug #58649)
-
-    P4#parse_client could raise the exception "Unknown field name
-    'StreamAtChange'." when parsing a stream client workspace.
-    Internal spec definition has been updated to resolve this.
-
---------------------------------------------------------------------------
-
-New functionality in 2012.1
-
-- 419591 (Bug #51895)
-
-    P4Ruby supports SSL connections if compiled with SSL support.
-    Instructions on how to compile with SSL support can be found
-    at the top of this document under "Building P4Ruby from Source"
-    and in the documentation.
-
-    P4.identify will report the version of the OpenSSL library
-    used to build the Perforce C++ API (not the version P4Ruby
-    is linked against).
-
-- 415643
-
-    P4Ruby will now only build a 64-bit version of the library
-    on Darwin.
-
-- 413362 (Bug #51899)
-
-    Enable "action resolve" to support resolves of branches,
-    deletes and file types. The existing P4::MergeData class
-    has been extended and the additional attributes will be
-    populated for an 'action resolve'.  Details of the
-    additional attributes can be found in the documentation.
-
-Bugs fixed in 2012.1
-
-- 420839 (Bug #52952)
-
-    Accessing the base_name attribute of a P4::MergeData
-    object resulted in a segmentation fault when resolving
-    binary files.  This has now been fixed and all empty
-    fields will return Nil.
-
-- 410916, 410702 (Bug #52320)
-
-    Exceptions thrown during P4.run_resolve are now raised
-    up to the user.  If an exception is encountered during the
-    block's execution, P4Ruby will skip the remaining files.
-
---------------------------------------------------------------------------
-
-New functionality in 2011.1
-
-- 405913
-
-    New method P4#messages() returns all messages from the
-    server as objects. Script writers can test the severity
-    of the messages to know if they are output messages (E_INFO),
-    warnings (E_WARN), or errors (E_FAILED/E_FATAL).
-
-    P4#errors() and P4#warnings still return the errors and
-    warnings as strings for backwards compatibility.
-
-    P4::Message objects have the following methods:
-
-    P4::Message#severity	- Returns the severity of the
-                  message, which may be one of the
-                  following values:
-
-      E_EMPTY	# nothing yet
-      E_INFO	# something good happened
-      E_WARN	# something not good happened
-      E_FAILED	# user did something wrong
-      E_FATAL	# system broken -- nothing can continue
-
-    P4::Message#generic	- Returns the generic class of
-                  the error, which may be one
-                  of the following values:
-
-      EV_NONE	# misc
-      EV_USAGE	# request not consistent with dox
-      EV_UNKNOWN	# using unknown entity
-      EV_CONTEXT	# using entity in wrong context
-      EV_ILLEGAL	# trying to do something you can't
-      EV_NOTYET	# something must be corrected first
-      EV_PROTECT	# protections prevented operation
-      EV_EMPTY	# action returned empty results
-      EV_FAULT	# inexplicable program fault
-      EV_CLIENT	# client side program errors
-      EV_ADMIN	# server administrative action required
-      EV_CONFIG	# client configuration inadequate
-      EV_UPGRADE	# client or server too old to interact
-      EV_COMM	# communications error
-      EV_TOOBIG	# not even Perforce can handle this much
-
-    P4::Message#msgid	- Return the unique ID of the
-                  message.
-
-    P4::Message#to_s	- Convert the object to a string
-
-    P4::Message#inspect	- Debugging support
-
-
-- 338410 (Bug #47374)
-
-    P4Ruby supports setting values in the registry (on those
-    platforms that support it).
-
-    The command P4#set_env( var, val ) will set a registry
-    variable on platforms that support this action or raise
-    a P4Exception for those that don't.
-
-    The command P4#set_env( var, "" ) unsets a registry variable.
-
-- 333292 (Bug #36121)
-
-    P4Ruby now supports Ruby 1.9
-
-- 331384
-
-    P4Ruby can now be compiled with the Mingw compiler using
-    the MinGW P4Api build.
-
-- 328203 (Bug #45861)
-
-    Enable streams in P4Ruby by default. With this change,
-    streams specific specs such as streams depots are listed.
-    Disable the listing of streams specific specs by either
-    setting the api_level to a value below 70 or by disabling
-    stream handling explicitly through the P4.streams attribute:
-
-          p4.streams = false
-
-- 322353 (Bug #42250)
-
-    P4Ruby supports a callback interface by providing a
-    P4#handler attribute. Set P4#handler to an instance of a
-    subclass of P4::OutputHandler to enable callbacks.
-    When a handler is defined, P4Ruby will invoke the handler
-    for every response it receives from the Perforce Server
-    immediately instead of collecting all results together in
-    an array first. This can be used to make applications more
-    scalable and more responsive if large results are expected.
-    See the documentation for details on the OutputHandler class.
-
-Bugs fixed in 2011.1
-
-- 405913 (Bug #43426)
-
-    Running 'print' on a file that started with '---' would
-    cause an exception in Ruby. This is now fixed.
-
-    There is still an oddity when p4.track = 1 and a user runs
-    p4.run_print() on a file that only has lines starting with
-    '--- '. In that case, the output of the print is lost.
-
-    Disable tracking by setting p4.track = 0 (the default) will
-    solve this problem.
-
-- 405913 (Bug #41350)
-
-    Info messages now shown in P4#Messages.
-
-- 385159 (Bug #49324)
-
-    On Windows Vista, Windows 7, or Windows 2008, a client running as
-    Administrator would fail to properly process file names in
-    non-ASCII character sets (such as Shift-JIS).
-
-- 338903 (Bug #44589)
-
-    Extra dot at the end of the extracted directory path has been
-    removed.
-
-- 338437 (Bug #39580)
-
-    P4#identify() reports the platform on AMD64 as X86_64
-    in line with all other Perforce products.
-
-- 332453
-
-    Updated the stored spec templates for client, change, group,
-    spec and user.  Added spec template for new spec type
-    streams. These are required, for example, for form-triggers
-    that do not connect to the server first.
-
-- 329351 (Bug #41271)
-
-    Include 'extraTag' fields in P4::Spec objects
-
-- 328578 (Bug #39264)
-
-    P4#identify() now reports P4Ruby as P4RUBY in line with all
-    other Perforce products.  It will also include the build
-    number of the Perforce C/C++ API that it is built with.
-
---------------------------------------------------------------------------
-
-New functionality in 2010.2
-
-- 260859
-
-    Added new SetTrack() and GetTrack() methods.
-
-    For more details about server performance tracking see:
-    http://kb.perforce.com/article/883
-
-- 255945, 255949, 269012
-
-    New method P4#messages() returns all messages from the
-    server as objects. Script writers can test the severity
-    of the messages to know if they are output messages (E_INFO),
-    warnings (E_WARN), or errors (E_FAILED/E_FATAL).
-
-    P4#errors() and P4#warnings still return the errors and
-    warnings as strings for backwards compatibility.
-
-    P4::Message objects have the following methods:
-
-    `P4::Message#severity`	- Returns the severity of the
-      message, which may be one of the
-      following values:
-
-          E_EMPTY	# nothing yet
-          E_INFO	# something good happened
-          E_WARN	# something not good happened
-          E_FAILED	# user did something wrong
-          E_FATAL	# system broken -- nothing can continue
-
-    `P4::Message#generic`	- Returns the generic class of
-      the error, which may be one
-      of the following values:
-
-          EV_NONE	# misc
-          EV_USAGE	# request not consistent with dox
-          EV_UNKNOWN	# using unknown entity
-          EV_CONTEXT	# using entity in wrong context
-          EV_ILLEGAL	# trying to do something you can't
-          EV_NOTYET	# something must be corrected first
-          EV_PROTECT	# protections prevented operation
-          EV_EMPTY	# action returned empty results
-          EV_FAULT	# inexplicable program fault
-          EV_CLIENT	# client side program errors
-          EV_ADMIN	# server administrative action required
-          EV_CONFIG	# client configuration inadequate
-          EV_UPGRADE	# client or server too old to interact
-          EV_COMM	# communications error
-          EV_TOOBIG	# not even Perforce can handle this much
-
-    `P4::Message#msgid`	- Return the unique ID of the message.
-
-    `P4::Message#to_s`	- Convert the object to a string
-
-    `P4::Message#inspect`	- Debugging support
-
-Bugs fixed in 2010.2
-
-- 287185 (Bug #43426)
-
-    Running 'print' on a file that started with '---' would
-    cause an exception in Ruby. This is now fixed.
-    There is still an oddity when p4.track = 1 and a user runs
-    p4.run_print() on a file that only has lines starting with
-    '--- '. In that case, the output of the print is lost.
-    Disable tracking by setting p4.track = 0 (the default) will
-    solve this problem.
-
---------------------------------------------------------------------------
-
-New functionality in 2010.1
-
-- 232984
-
-     Removed old Ruby 1.6 compatibility code that was no longer
-     required. This paves the way for Ruby 1.9 compatibility.
-
-- 230644
-
-     It's now unnecessary to run a command before calling the
-     following methods:
-
-           P4#server_level
-           P4#server_case_sensitive?
-           P4#server_unicode?
-
-     If no command has been run, P4Ruby will automatically run a
-     'p4 info' in order to gather the required information.
-
-- 230191
-
-     Added new P4#server_unicode? method that allows script
-     writers to test whether or not a Perforce Server is in
-     internationalized (unicode) mode. At least one Perforce
-     command must have been executed against the server before
-     this method can be called.
-
-- 230190
-
-     Added new P4::VERSION, P4::OS, and P4::PATCHLEVEL constants
-     so that script writers can test the installation of P4Ruby
-     without having to parse the output of P4::Identify()
-
---------------------------------------------------------------------------
-
-New functionality in 2009.2
-
-- 214454 (Bug #32916)
-
-    P4#port= now raises a P4Exception if called after P4#connect().
-
-- 214449 (Bug #35416)
-
-    Added a P4#server_case_sensitive? method that enables scripts
-    to detect whether the server is case-sensitive. Cannot be
-    called until a command has been issued to the server.
-
-Bugs fixed in 2009.2
-
-- 214445,214999 (Bug #35410)
-
-    P4Ruby now correctly tracks disconnects from the server.
-
-- 222727 (Bug #36568)
-
-    The Map class removed '-' and '+' from the path if the
-    form Map.insert(lhs, rhs) was used, even if these characters
-    did not appear at the beginning of the path.
-    Now dashes and pluses are preserved within the path.
-
---------------------------------------------------------------------------
-
-New functionality in 2009.1
-
-- 191900 (Bug #26729)
-
-    A new method:
-
-        P4#tagged( aBool ) { block }
-
-    has been added to the P4 class. This method temporarily
-    toggles the use of tagged output for the duration of
-    the block and resets it when the block terminates.
-
-Bugs fixed in 2009.1
-
-- 191889 (Bug #29911)
-
-    Calling P4#run_resolve() or P4#run( 'resolve' ) without
-    a block or a previous call to P4#input no longer causes an
-    infinite loop.
-
-- 191623,191627 (Bug #32918)
-
-    P4Ruby now correctly parses jobs when the jobspec contains
-    field names ending in numbers.
-
---------------------------------------------------------------------------
-
-New functionality in 2008.2
-
-- 162422 (Bug #30364), 166158
-
-    A new class, P4::Map, enables users to
-    create and use Perforce mappings without requiring
-    a connection to a server. Methods in the P4::Map class are:
-
-        P4::Map.new	    Constructor
-        P4::Map.join	    Join two maps to create a third
-        P4::Map#clear	    Empty a map
-        P4::Map#count	    Return the number of entries
-        P4::Map#empty?	    Tests whether a map object is empty
-        P4::Map#insert	    Inserts an entry into the map
-        P4::Map#translate   Translate a string through a map
-        P4::Map#includes?   Tests whether a path is mapped
-        P4::Map#reverse	    Swap left and right sides of the mapping
-        P4::Map#lhs	    Returns the left side as an array
-        P4::Map#rhs	    Returns the right side as an array
-        P4::Map#to_a	    Returns the map as an array
-
-Bugs fixed in 2008.2
-
-- 169159 (Bug #29935, Bug #31096), 165338
-
-    P4Ruby now correctly loads the value of P4CHARSET from the
-    environment.
-
---------------------------------------------------------------------------
-
-New functionality in 2008.1
-
-- 152356 (Bug #29022)
-
-    A new method 'P4#env( var )' method has been added to
-    the P4 class. This instance method enables the caller
-    to interrogate the Perforce environment, including
-    reading Perforce variables from P4CONFIG files and,
-    on Windows, the registry. P4#cwd= now loads any
-    P4CONFIG file settings that are appropriate to the
-    new working directory.
-
-- 153005 (Bug #29308)
-
-    P4Ruby now supports Mac OS X 10.5.
-
---------------------------------------------------------------------------
-
-Bugs fixed in 2007.3
-
-- 151167 (Bug #28774)
-
-    The Makefile generated on some Linux platforms (notably
-    Ubuntu 7.10) was not correct, and attempted to link P4Ruby
-    using 'cc' instead of 'c++', causing an 'undefined symbol'
-    error (typically '_ZTVN10__cxxabiv120__si_class_type_infoE') ,
-    when attempting to use P4Ruby. This problem has been corrected.
-
-- 150577 (Bug #28704)
-
-    The presence of deleted revisions in a file's history
-    might lead to incorrect fileSize and digest
-    attributes for other revisions in the output of
-    P4#run_filelog. This problem has been corrected.
-
-- 150576 (Bug #28773)
-
-    P4::Revision#filesize() always returned nil. This
-    problem has been corrected.
+# p4ruby
+P4Ruby is a wrapper for the P4 C++ API in Ruby.

data/ext/P4/extconf.rb

@@ -6,10 +6,19 @@ require 'mkmf'
 require 'net/ftp'
 require 'P4/version'
 require 'rbconfig'
+require 'openssl'
 
 # Set this to the main version directory we look up in ftp.perforce.com for the P4API
 # This is ignored if you specify the version on the command line.
-P4API_VERSION_DIR = 'r19.1'
+# Changed the hardcoded string so that the version is now derived from version.rb file
+#P4API_VERSION_DIR = 'r19.1'
+def p4api_version_dir
+        ver=P4::Version.split(".")
+        p4_major = ver[0].chars.last(2).join
+        p4_minor = ver[1]
+        dir = "r" + p4_major + "." + p4_minor
+end
+
 
 #==============================================================================
 # Provide platform variables in P4-specific format
@@ -102,6 +111,15 @@ def calculate_p4osver
   return ver
 end
 
+def gcc
+  @gcc ||= calculate_gcc
+end
+
+def calculate_gcc
+  gcc = RbConfig::CONFIG["GCC"]
+  return gcc
+end
+
 def uname_platform
   @uname_platform ||= calculate_uname_platform
 end
@@ -155,6 +173,13 @@ def set_platform_opts
   end
 end
 
+def set_platform_cxxflags
+  if (p4osname == 'LINUX') && (gcc == 'yes')
+    $CXXFLAGS += " -std=c++11 "
+  end
+end
+
+
 def set_platform_cppflags
   $CPPFLAGS += "-DOS_#{p4osname} "
   $CPPFLAGS += "-DOS_#{p4osname}#{p4osver} "
@@ -446,13 +471,34 @@ def ftp_download_dir(version)
 end
 
 def filename
+  openssl_number = OpenSSL::OPENSSL_VERSION.split(' ')[1].to_s
+  openssl_number = openssl_number.slice(0, (openssl_number.rindex('.')))
+
   if RbConfig::CONFIG['target_os'].downcase =~ /nt|mswin|mingw/
-    'p4api.zip'
+    filename = 'p4api.zip'
+    if !openssl_number.to_s.empty?
+        case openssl_number.to_s
+            when /1.1/
+                filename = 'p4api-openssl1.1.1.zip'
+            when /1.0/
+                filename = 'p4api-openssl1.0.2.zip'
+             end
+    end
   else
-    'p4api.tgz'
+    filename = 'p4api.tgz'
+    if !openssl_number.to_s.empty?
+        case openssl_number.to_s
+            when /1.1/
+                filename = 'p4api-glibc2.3-openssl1.1.1.tgz'
+            when /1.0/
+                filename = 'p4api-glibc2.3-openssl1.0.2.tgz'
+        end
+    end
   end
+  return filename
 end
 
+
 def remote_files_matching(ftp, dir, regex)
   ftp.ls(dir.to_s).map { |entry|
     if match = entry.match(regex)
@@ -500,9 +546,8 @@ def download_api_via_ftp
   # At one point, we allowed the gem build to just find the most recent p4api build.
   # P4Ruby probably shouldn't do that by default.
   #version_dir = find_latest_version_dir(ftp)
-  version_dir = P4API_VERSION_DIR
 
-  dir = ftp_download_dir(version_dir)
+  dir = ftp_download_dir(p4api_version_dir)
   ftp.chdir(dir)
 
   puts "downloading #{filename} from #{dir} on ftp.perforce.com"
@@ -537,9 +582,11 @@ set_platform_opts
 # based solely on platform detection.
 set_platform_cppflags
 set_platform_cflags
+set_platform_cxxflags
 
 puts "$CPPFLAGS #{$CPPFLAGS}"
 puts "$CFLAGS #{$CFLAGS}"
+puts "$CXXFLAGS #{$CXXFLAGS}"
 
 # Setup additional system library definitions based on platform type before
 # we setup other libraries, in order to preserve linking order
@@ -556,14 +603,11 @@ resolve_ssl_dirs
 if RbConfig::CONFIG['target_os'].downcase =~ /mingw/
   have_library('gdi32') or raise
   have_library('ole32') or raise
+  have_library('crypt32') or raise
 end
 
-do_ssl = have_library('crypto') and have_library('ssl')
-
-unless do_ssl
-  have_library('p4sslstub') or raise
-end
-
+have_library('crypto') or raise
+have_library('ssl') or raise
 have_library('supp') or raise
 have_library('p4script_sqlite') or raise
 have_library('p4script_curl') or raise

data/ext/P4/p4.cpp

@@ -679,13 +679,6 @@ static VALUE p4_get_messages( VALUE self )
     return p4->GetMessages();
 }
 
-static VALUE p4_reset( VALUE self )
-{
-    P4ClientApi *p4;
-    Data_Get_Struct( self, P4ClientApi, p4 );
-    return p4->Reset();
-}
-
 static VALUE p4_get_warnings( VALUE self )
 {
     P4ClientApi	*p4;
@@ -1305,7 +1298,6 @@ void	Init_P4()
     rb_define_method( cP4, "connect", 	RUBY_METHOD_FUNC(p4_connect)     , 0 );
     rb_define_method( cP4, "connected?",RUBY_METHOD_FUNC(p4_connected)   , 0 );
     rb_define_method( cP4, "disconnect", RUBY_METHOD_FUNC(p4_disconnect) , 0 );
-    rb_define_method( cP4, "reset",  RUBY_METHOD_FUNC(p4_reset), 0 );
 
     // Running commands - general purpose commands
     rb_define_method( cP4, "run", 	RUBY_METHOD_FUNC(p4_run)         ,-2 );

data/ext/P4/p4clientapi.cpp

@@ -323,6 +323,9 @@ P4ClientApi::Disconnect()
     // Clear the specdef cache.
     specMgr.Reset();
 
+    // Clear out any results from the last command
+    ui.Reset();
+
     return Qtrue;
 }
 
@@ -426,12 +429,6 @@ P4ClientApi::IsIgnored( const char *path )
     return ignore->Reject( p, client.GetIgnoreFile() );
 }
 
-VALUE
-P4ClientApi::Reset()
-{
-    ui.Reset();
-}
-
 //
 // Run returns the results of the command. If the client has not been
 // connected, then an exception is raised but errors from Perforce
@@ -763,4 +760,3 @@ P4ClientApi::Except( const char *func, Error *e )
     e->Fmt( &m );
     Except( func, m.Text() );
 }
-

data/ext/P4/p4clientapi.h

@@ -121,7 +121,6 @@ public:
     VALUE Connect();		// P4Exception on error
     VALUE Connected();		// Return true if connected and not dropped.
     VALUE Disconnect();
-    VALUE Reset();          // Clear out any results from the previous command
 
     // Executing commands.
     VALUE Run( const char *cmd, int argc, char * const *argv );
@@ -248,4 +247,3 @@ private:
     int			maxScanRows;
     int			maxLockTime;
 };
-

data/ext/P4/p4result.cpp

@@ -57,6 +57,7 @@ P4Result::P4Result()
     VALUE cP4	= rb_const_get_at( rb_cObject, idP4 );
     cP4Msg	= rb_const_get_at( cP4, idP4Msg );
 
+    Reset();
 }
 
 

data/ext/P4/specmgr.cpp

@@ -63,22 +63,6 @@ struct defaultspec {
             "unlocked/locked;;"
         "View;code:311;type:wlist;words:2;len:64;;"
     },
-    {
-        "changeX",
-        "Change;code:201;rq;ro;fmt:L;seq:1;len:10;;"
-        "Date;code:202;type:date;ro;fmt:R;seq:3;len:20;;"
-        "Client;code:203;ro;fmt:L;seq:2;len:32;;"
-        "User;code:204;ro;fmt:L;seq:4;len:32;;"
-        "Status;code:205;ro;fmt:R;seq:5;len:10;;"
-        "Type;code:211;seq:6;type:select;fmt:L;len:10;"
-            "val:public/restricted;;"
-        "ImportedBy;code:212;type:line;ro;fmt:L;len:32;;"
-        "Identity;code:213;type:line;;"
-        "Description;code:206;type:text;rq;;"
-        "Jobs;code:209;type:wlist;words:2;len:32;;"
-        "Stream;code:214;type:line;len:64;;"
-        "Files;code:210;type:llist;len:64;;"
-    },
     {
         "change",
         "Change;code:201;rq;ro;fmt:L;seq:1;len:10;;"
@@ -123,42 +107,6 @@ struct defaultspec {
         "View;code:311;type:wlist;words:2;len:64;;"
         "ChangeView;code:317;type:llist;len:64;;"
     },
-    {
-        "clientX",
-        "Client;code:301;rq;ro;seq:1;len:32;;"
-        "Update;code:302;type:date;ro;seq:2;fmt:L;len:20;;"
-        "Access;code:303;type:date;ro;seq:4;fmt:L;len:20;;"
-        "Owner;code:304;seq:3;fmt:R;len:32;;"
-        "Host;code:305;seq:5;fmt:R;len:32;;"
-        "Description;code:306;type:text;len:128;;"
-        "Root;code:307;rq;type:line;len:64;;"
-        "AltRoots;code:308;type:llist;len:64;;"
-        "Options;code:309;type:line;len:64;val:"
-            "noallwrite/allwrite,noclobber/clobber,nocompress/compress,"
-            "unlocked/locked,nomodtime/modtime,normdir/rmdir;;"
-        "SubmitOptions;code:313;type:select;fmt:L;len:25;val:"
-            "submitunchanged/submitunchanged+reopen/revertunchanged/"
-            "revertunchanged+reopen/leaveunchanged/leaveunchanged+reopen;;"
-        "LineEnd;code:310;type:select;fmt:L;len:12;val:"
-            "local/unix/mac/win/share;;"
-        "View;code:311;type:wlist;words:2;len:64;;"
-    },
-    {
-        "clientSpecing021",
-        "Client;code:301;rq;ro;len:32;;"
-        "Update;code:302;type:date;ro;len:20;;"
-        "Access;code:303;type:date;ro;len:20;;"
-        "Owner;code:304;len:32;;"
-        "Host;code:305;len:32;;"
-        "Description;code:306;type:text;len:128;;"
-        "Root;code:307;rq;type:line;len:64;;"
-        "AltRoots;code:308;type:text;len:64;;"
-        "Options;code:309;type:line;len:64;val:"
-            "noallwrite/allwrite,noclobber/clobber,nocompress/compress,"
-            "unlocked/locked,nomodtime/modtime,normdir/rmdir;;"
-        "LineEnd;code:310;type:select;len:12;val:local/unix/mac/win/share;;"
-        "View;code:311;type:wlist;words:2;len:64;;"
-    },
     {
         "depot",
         "Depot;code:251;rq;ro;len:32;;"
@@ -172,40 +120,6 @@ struct defaultspec {
         "Map;code:257;rq;len:64;;"
         "SpecMap;code:259;type:wlist;len:64;;"
     },
-    {
-        "extensionGbl",
-	"ExtName;code:901;type:line;opt:once;len:64;;"
-	"ExtDescription;code:902;type:text;opt:once;len:128;;"
-	"ExtVersion;code:903;type:line;opt:once;len:32;;"
-	"ExtUUID;code:904;type:line;opt:once;len:36;;"
-	"ExtRev;code:905;type:word;opt:once;len:20;;"
-	"ExtMaxScriptTime;code:913;type:word;len:12;;"
-	"ExtMaxScriptMem;code:914;type:word;len:12;;"
-	"ExtAllowedGroups;code:915;type:wlist;len:32;opt:default;;"
-	"ExtEnabled;code:916;type:word;opt:default;len:12;;"
-	"ExtP4USER;code:917;type:word;opt:default;len:12;;"
-	"Name;code:906;type:line;opt:default;len:32;;"
-	"Owner;code:907;type:word;opt:default;len:36;;"
-	"Update;code:908;type:date;opt:always;fmt:L;len:20;;"
-	"Description;code:909;type:text;opt:required;len:128;;"
-	"ExtConfig;code:912;type:text;opt:required;len:256;;"
-    },
-    {
-        "extensionIns",
-	"ExtName;code:901;type:line;opt:once;len:64;;"
-	"ExtDescription;code:902;type:text;opt:once;len:128;;"
-	"ExtVersion;code:903;type:line;opt:once;len:32;;"
-	"ExtUUID;code:904;type:line;opt:once;len:36;;"
-	"ExtRev;code:905;type:word;opt:once;len:20;;"
-	"ExtMaxScriptTime;code:913;type:word;len:12;;"
-	"ExtMaxScriptMem;code:914;type:word;len:12;;"
-	"ExtEnabled;code:916;type:word;opt:default;len:12;;"
-	"Name;code:906;type:line;opt:default;len:32;;"
-	"Owner;code:907;type:word;opt:default;len:36;;"
-	"Update;code:908;type:date;opt:always;fmt:L;len:20;;"
-	"Description;code:909;type:text;opt:required;len:128;;"
-	"ExtConfig;code:912;type:text;opt:required;len:256;;"
-    },
     {
         "group",
         "Group;code:401;rq;ro;len:32;;"
@@ -321,6 +235,7 @@ struct defaultspec {
 	"DefaultBranch;code:1007;len:32;;"
 	"MirroredFrom;code:1008;len:32;;"
 	"Options;code:1009;type:select;len:10;val:lfs/nolfs;;"
+	"GconnMirrorServerId;code:1010;len:32;;"
     },
     {
         "server",
@@ -336,22 +251,12 @@ struct defaultspec {
 	"Description;code:757;type:text;len:128;;"
 	"User;code:761;type:line;len:64;;"
 	"AllowedAddresses;code:763;type:wlist;len:64;;"
+	"UpdateCachedRepos;code:766;type:wlist;len:64;;"
 	"ClientDataFilter;code:758;type:wlist;len:64;;"
 	"RevisionDataFilter;code:759;type:wlist;len:64;;"
 	"ArchiveDataFilter;code:760;type:wlist;len:64;;"
 	"DistributedConfig;code:762;type:text;len:128;;"
     },
-    {
-        "specW",
-        "Fields;code:351;type:wlist;words:5;rq;;"
-        "Required;code:357;type:wlist;;"
-        "Readonly;code:358;type:wlist;;"
-        "Words;code:352;type:wlist;words:2;;"
-        "Formats;code:353;type:wlist;words:3;;"
-        "Values;code:354;type:wlist;words:2;;"
-        "Presets;code:355;type:wlist;words:2;;"
-        "Comments;code:356;type:text;;"
-    },
     {
         "spec",
         "Fields;code:351;type:wlist;words:5;rq;;"

data/lib/P4/version.rb

@@ -1,3 +1,3 @@
-class P4
-  Version = VERSION = '2019.1.1873991'
-end
+class P4
+    Version = VERSION = '2020.1.1970474'
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: p4ruby
 version: !ruby/object:Gem::Version
-  version: 2019.1.1873991
+  version: 2020.1.1970474
 platform: ruby
 authors:
 - Perforce Software, Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-10-25 00:00:00.000000000 Z
+date: 2020-06-10 00:00:00.000000000 Z
 dependencies: []
 description: Ruby extensions to the C++ Perforce API.
 email: support@perforce.com
@@ -46,10 +46,11 @@ files:
 - ext/P4/undefdups.h
 - lib/P4.rb
 - lib/P4/version.rb
-homepage: https://swarm.workshop.perforce.com/projects/perforce-software-p4ruby/
+homepage: https://github.com/perforce/p4ruby
 licenses:
 - MIT
-metadata: {}
+metadata:
+  documentation_uri: https://www.perforce.com/manuals/p4ruby/Content/P4Ruby/Home-p4ruby.html
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -65,7 +66,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: Ruby extensions to the C++ Perforce API