Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add In HA Event Callback #1

Open
wants to merge 773 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
773 commits
Select commit Hold shift + click to select a range
fc4c04a
Merge branch 'pr/5'
yanick Jul 18, 2013
b34c8f6
changelog
yanick Jul 18, 2013
8c9b77b
fill the version with a dummy value for dev
yanick May 23, 2013
7677507
release preps
yanick Jul 29, 2013
c5b3018
release preps
yanick Aug 23, 2013
9a82515
POD syntax fixes
gregoa Aug 30, 2013
b259e18
changelog
yanick Aug 30, 2013
2f6fd0a
POD typos
gregoa Aug 30, 2013
1ae5bcc
changelog
yanick Aug 30, 2013
e737d30
fix pod errors in Hpux troubleshooting
Aug 9, 2013
88b2615
remove mention of deleted files
yanick Sep 8, 2013
f3bed5e
changelog
yanick Sep 8, 2013
f6d62eb
Merge branch 'pr/7'
yanick Sep 8, 2013
479ecdd
RT88135 and RT89491 fixes
Oct 29, 2013
801a76f
Merge branch 'pr/8'
yanick Nov 5, 2013
2d30bc9
release preps
yanick Nov 5, 2013
ff0e52e
changelog
yanick Nov 25, 2013
a1dc07f
release preps
yanick Nov 25, 2013
6aa9541
Fix rt91698
Jan 9, 2014
eecc88d
Merge branch 'pr/10'
yanick Jan 14, 2014
f10171b
tweak changelog
yanick Jan 14, 2014
92136df
changelog
yanick Jan 14, 2014
10383db
version bump
yanick Jan 14, 2014
f387cf9
put back OCI_THREADED setting
yanick Jan 19, 2014
a029c4b
Fix RT 92134
yanick Jan 19, 2014
d9c0a61
Merge branch 'pr/11'
yanick Jan 19, 2014
d6671c1
sid=foo is an alias for 'foo'
yanick Jan 14, 2014
5a147bd
Merge branch 'rt-91775'
yanick Jan 19, 2014
b6648cf
RT91473: added support for ORA_SYSBACKUP, ORA_SYSDG and ORA_SYSKM
yanick Jan 20, 2014
3dbc8c5
Merge branch 'rt91473'
yanick Jan 20, 2014
21fd3ad
bump version
yanick Jan 20, 2014
c986a3b
version bump
yanick Feb 12, 2014
209bf8a
Fix rt91217 - CHOOSE hint deprecated
Feb 20, 2014
de8eb69
changelog
Mar 7, 2014
0ef5493
recognizes __CYGWIN64__
Mar 7, 2014
5badfc7
Merge branch 'cygwin-64'
Mar 7, 2014
957f547
possible fix for rt 88185 - UTF-8 flag incorrect with multiple connec…
Dec 17, 2013
84f356d
changelog
Mar 7, 2014
5a8e357
Merge branch 'rt88185'
Mar 7, 2014
8d93500
steal from ETHER
Mar 7, 2014
c0843bc
CONTRIBUTING is a template
Mar 14, 2014
ad99214
changelog
Mar 14, 2014
3db6f02
Merge branch 'contributing'
Mar 14, 2014
a1202d5
add SELinux trick
Mar 14, 2014
3af37ce
preps for release
Mar 31, 2014
e2fc06b
release prep
Apr 14, 2014
1ef5f5e
Revert "possible fix for rt 88185 - UTF-8 flag incorrect with multipl…
Apr 23, 2014
0ced09b
changelog
Apr 23, 2014
17c04be
release preps
Apr 23, 2014
23c248d
Bring in mje's fix for #14
Apr 23, 2014
cb011d2
promoting to 1.74
yanick Apr 25, 2014
5ac5ac0
Allow symbolic links in $LD_LIBRARY_PATH et all
Apr 15, 2014
7810c11
merge checks
yanick Apr 25, 2014
c404578
Merge branch 'pr/13'
yanick Apr 25, 2014
3078313
typo in docs
May 26, 2014
a699ecb
cleanup
May 26, 2014
12ed8f1
add TODO
Jul 31, 2014
b9296c1
Move mentions of README to troubleshooting guides
Jul 31, 2014
b48449c
Merge branch 'issue-17'
Jul 31, 2014
10f508b
remove the test plan and use 'done_testing'
Aug 1, 2014
dbc8943
Change DBD::Pg to DBD::Oracle
yanick Oct 20, 2014
295e1b6
Fix git issues 21 and 15 - previous unrelated fix broke this
Nov 10, 2014
6999332
Additional changes for 1.75_2 I did not check in
Jan 16, 2015
8275bce
fix git issue 20 - add instanclient path for mac
mjegh Jan 20, 2015
08796eb
Fix git issue 23 - disabled constraints not ignored and update Changes
mjegh Jan 20, 2015
655ee5f
Merge pull request #19 from yanick/pg-to-oracle
deanpearce Feb 4, 2015
be4620a
Merge pull request #22 from mjegh/master
deanpearce Feb 4, 2015
97a416c
Merge pull request #24 from mjegh/issue20
deanpearce Feb 4, 2015
18e2d04
Merge pull request #25 from mjegh/issue23
deanpearce Feb 4, 2015
d51447a
Connection informational messages were being lost
mjegh May 15, 2015
721372e
Merge branch 'master' of https://github.com/pythian/DBD-Oracle
mjegh May 15, 2015
dceaf07
oci8.c: fix format error in PerlIO_printf() call
arc Dec 9, 2015
3458dce
ocitrace.h: fix format errors in PerlIO_printf() calls
arc Dec 9, 2015
7c6d316
Treat ROWID descriptors differently from ROWIDs - allow more storage
mjegh Dec 12, 2016
6b95844
add change comment for rowid change
mjegh Dec 12, 2016
e4e14f4
Merge pull request #29 from mjegh/master
deanpearce May 3, 2017
ce425ad
Set zero-length lob to undef when using ora_piece_lob option
alicemaz Jun 13, 2017
2a8ed67
Search for Oracle Instant Client .mk file location when compiling for…
whindsx Jul 21, 2017
c496c70
Merge pull request #49 from whindsx/master
deanpearce Jul 31, 2017
2032235
Merge pull request #34 from arc/master
deanpearce Aug 1, 2017
e148e25
Merge pull request #46 from alicemaz/master
deanpearce Aug 1, 2017
5b3c9cb
GH#48 Fix for error in test where 31lob.t was failing due to a statem…
Aug 1, 2017
2221d8b
Have ora_libdir check $ORACLE_HOME/lib/64 when it exists
whindsx Aug 1, 2017
091ed01
Fix for Oracle version default value.
Aug 1, 2017
0477201
Merge pull request #50 from whindsx/master
deanpearce Aug 1, 2017
e7d932f
Merge pull request #51 from pythian/feature/ora-version
deanpearce Aug 1, 2017
ceed9e9
Fix warnings from gcc/clang, correct a few typos
daglem Sep 16, 2016
d19338a
Avoid use of inactive database handle in statement destructor
daglem Sep 16, 2016
591617a
Plug various environment handle leaks
daglem Sep 17, 2016
b07d637
Correct setting of default driver name
daglem Sep 17, 2016
acc03fe
Add configuration for Oracle Fast Application Notification (FAN)
daglem Sep 17, 2016
a3472a2
Fix for GH36
Apr 23, 2018
6e1527c
Fix in/from #56
Apr 23, 2018
eed913c
Add configuration for Oracle Fast Application Notification (FAN)
daglem Sep 17, 2016
11cac2d
Rewrite DRCP session pooling to work as intended
daglem Sep 17, 2016
e752b47
Get correct "tag found" status from OCISessionGet
daglem Sep 30, 2016
14c1258
Fix up for GH36
Apr 24, 2018
c4b35e5
Fix compile warnings about int vs long unsigned
Apr 24, 2018
d2f40e1
Make a passing reference to other authors
May 14, 2018
d0a1d09
Tidy up TODO
May 17, 2018
def8071
Rename from Todo to TODO
May 17, 2018
4ed1483
https://lintian.debian.org/tags/spelling-error-in-manpage.html etc
Apr 25, 2018
b8dc0fa
Overhaul tests, dzil usage, perltidy and tweaks
djzort May 18, 2018
2816e07
Update mailmap file
Jun 18, 2018
9d1160a
Add Travis CI file
Jun 18, 2018
22b04e4
Fix awkwardness and spelling
Jan 12, 2018
68fe0c5
Change misspelling of SH_LIBRARY_PATH in quoted text
moregan Jan 12, 2018
533527e
stop referring to the VARCHAR2 as deprecated
moregan Jan 17, 2018
d388c97
Update changes based on included PR's and GH bugs
Jun 20, 2018
b3fafb1
Fix #57 based upon suggestions from @tonycoz.
Aug 20, 2018
357f7bb
Update changelog for GH#57
djzort Aug 22, 2018
1a510be
Update Changes file for 1.75_42
djzort Nov 14, 2018
03b744e
Find ORACLE_HOME based off Operating System (Linux) when other attemp…
whindsx Nov 15, 2018
57b8e8f
Bump to 1.75
Nov 21, 2018
2b533cb
Adjust NextRelease to be consistent with Changes format we're using
Nov 21, 2018
43a7127
Bump to v1.76
Nov 22, 2018
75cfa63
Merge pull request #62 from ByteFoundryAU/winc
mjegh Jan 4, 2019
a6ff09c
correct the type passed to OCIAttrGet() for OCI_ATTR_TAF_ENABLED
tonycoz Jan 14, 2019
8323b28
Merge pull request #78 from tonycoz/fix35
mjegh Mar 26, 2019
8f3c9eb
A few typos
CarstenGrohmann Mar 30, 2019
b19e988
Remove Authority section as PYTHIAN is no longer involved
djzort Apr 6, 2019
f94132c
Merge pull request #83 from ByteFoundryAU/update-authority
mjegh Apr 6, 2019
2137762
Merge pull request #81 from CarstenGrohmann/Typos
mjegh Apr 6, 2019
872417e
Minor adjustments to README file
djzort Apr 7, 2019
736eb89
Keep all lines under 80 columns
djzort Apr 7, 2019
9c7f5c4
Merge pull request #88 from ByteFoundryAU/updatereadme
mjegh Apr 7, 2019
d80e567
Move freeing global envhp to destruction of last dbh
CarstenGrohmann Apr 14, 2019
d0bffb9
Enable testing against 5.28
djzort Apr 14, 2019
bcc5f5d
A few typos more
CarstenGrohmann Apr 25, 2019
3fd2829
Merge pull request #91 from CarstenGrohmann/More_typos
mjegh Apr 28, 2019
0c2d118
Merge pull request #74 from whindsx/make-linux-rpm
mjegh Apr 28, 2019
ec90ede
Enable travis helpers DEBUG options
CarstenGrohmann Jun 22, 2019
6f30bb5
Remove disconnect() which should no longer be needed
djzort Apr 15, 2019
2483516
Try the dzil build command again manually
djzort Jul 7, 2019
5f10aac
Try something different
djzort Jul 7, 2019
a83998a
Try excluding cpanfile stuff
djzort Jul 7, 2019
ff66d4c
Revert "Try excluding cpanfile stuff"
djzort Jul 7, 2019
ae237d5
Try excluding Git::Check
djzort Jul 7, 2019
7830197
Avoid GCC-ism so that HP-UX can compile. GH#92
Jul 8, 2019
e6a7c66
Revert "Try excluding Git::Check"
Jul 8, 2019
56bb947
Try disabling Git::CommitBuild as recommended by @kentnl
Jul 8, 2019
6a6b182
Merge remote-tracking branch 'refs/remotes/perl5-dbi/master'
mjegh Jul 8, 2019
c0a0ca0
disable Git::CommitBuild
mjegh Jul 8, 2019
95d9ee4
Merge pull request #96 from mjegh/master
mjegh Jul 8, 2019
527b044
Merge pull request #95 from ByteFoundryAU/gh92
mjegh Jul 8, 2019
106b3fa
Delete dist.ini
mjegh Jul 8, 2019
586066f
remove dist.ini change
mjegh Jul 8, 2019
a337a60
Merge branch 'ByteFoundryAU-destroy_envhp_with_last_dbh'
mjegh Jul 8, 2019
bc6c32d
Merge remote-tracking branch 'refs/remotes/perl5-dbi/master'
mjegh Jul 8, 2019
59048a7
Merge pull request #97 from mjegh/master
mjegh Jul 8, 2019
2f4bc05
Merge pull request #90 from ByteFoundryAU/testp28
mjegh Jul 8, 2019
89eeded
Remove debug line, this wasnt supposed to go to master
djzort Jul 9, 2019
529d623
Remove Git things we arent using or worried about
djzort Jul 9, 2019
95aaddf
Merge pull request #98 from ByteFoundryAU/p5master
mjegh Jul 9, 2019
6804a45
Update github path
djzort Jul 9, 2019
18547fa
Add another mailmap entry for Dean Hamstead
djzort Jul 9, 2019
41f043e
Update mailmap file
djzort Jul 9, 2019
3f21ba7
up version for deve release
mjegh Jul 9, 2019
386dcd8
Merge remote-tracking branch 'refs/remotes/perl5-dbi/master'
mjegh Jul 9, 2019
9bf5b36
Merge pull request #100 from mjegh/master
mjegh Jul 9, 2019
b1a44df
Merge pull request #99 from ByteFoundryAU/p5master
mjegh Jul 9, 2019
cd711f1
Remove x flag
djzort Jul 9, 2019
0356931
Remove references to long gone EXAMPLE FILES section
djzort Jul 9, 2019
e63c8a5
Unlink 'LOB Locator Method Interface' as there is no section for it
djzort Jul 9, 2019
3645047
Merge pull request #102 from ByteFoundryAU/kwalitee_1_77_1
mjegh Jul 10, 2019
212392f
Bump to 1.78
mjegh Jul 19, 2019
2c439a8
Merge remote-tracking branch 'refs/remotes/perl5-dbi/master'
mjegh Jul 19, 2019
b435b95
Merge pull request #104 from mjegh/master
mjegh Jul 20, 2019
4c61703
Bump version
mjegh Jul 20, 2019
38776a0
Bump to 1.791
mjegh Jul 22, 2019
50c22b2
Run orphaned test code
mjegh Jul 22, 2019
cfc9176
Updated bugtracker to git
mjegh Jul 22, 2019
dc7492c
Update version to 1.80 because it causes packagers a problem
mjegh Jul 25, 2019
5d93619
Add perl 5.30 to travis
djzort Jun 24, 2020
65d1cff
Remove dead links from README
djzort Jun 24, 2020
a75ce7f
Adjust deprecated .travis.yml syntax
djzort Jun 24, 2020
5705cf2
Add perl 5.32
djzort Jun 24, 2020
edd3522
Tweaks to dist.ini to make the release cleaner
djzort Jun 24, 2020
1b194e1
Remove POD sections that are now being inserted automatically
djzort Jun 24, 2020
09bd658
Small adjustments to the script that installs oracle xe for testing
djzort Jun 25, 2020
016b044
spit out the sha256 of oracle-xe. maybe check it later
djzort Jun 25, 2020
23cd1a2
Add a Dockfile to help people hack on DBD::Oracle quickly
djzort Jun 25, 2020
51c94dd
Update comments in Dockerfile
djzort Jun 25, 2020
c05f112
Add some debugging
djzort Jun 26, 2020
20b7f18
Move t/README to /TESTING.md for GH#119
djzort Sep 3, 2020
9a78fec
Update README with some minor improvements
djzort Sep 3, 2020
e08a7f8
Update markdown in TESTING.md
djzort Sep 3, 2020
b4174a3
Dont test 5.32 as Travi's perl install for it seems broken
djzort Sep 3, 2020
e51bade
Mention mkta.pl in TESTING.md
djzort Sep 3, 2020
1a11325
Update project links in Makefile.PL
djzort Sep 3, 2020
ab7e8a3
Update MANIFEST
djzort Sep 3, 2020
da936b5
Adjust prerequisites in dist.ini
djzort Jul 24, 2019
7c32384
Add $OH/include as a possible header location
djzort Dec 23, 2019
cfb2073
Extend documentation about leaking handles
CarstenGrohmann Sep 20, 2019
3610ab2
Add instantclient 18.3 and 18.5 to travis, use xenial instead of trusty
djzort Sep 9, 2020
f3d640f
Add instantclient 19.6 to travis
djzort Sep 10, 2020
8e3eac4
Ensure strict and warnings are first
djzort Sep 10, 2020
7704961
Swap tabs to spaces in Makefile.PL
djzort Sep 10, 2020
026fdab
Run nonassigned pl/sql tests based off versions known to have the issue.
whindsx Sep 17, 2020
406b546
Oracle Instant Client 21 has been released
Tux Dec 14, 2020
7b8bf9a
Add rpath to ORACLE_HOME to DBD/Oracle/Oracle.bundle
hakonhagland Apr 13, 2021
4fcf394
fix materialised views being misclassified as tables in ->table_info …
Dec 24, 2021
250e165
Fix bugtracker ref in dist metadata github #130
Dec 24, 2021
9d13079
Update Changes
djzort Dec 24, 2021
0508f75
v1.81
djzort Dec 24, 2021
8857dbf
fix github metadata woes as best as possible
Dec 28, 2021
fe94f7a
Build DBD::Oracle on Debian systems without LD_LIBRARY_PATH
alexm Oct 31, 2019
0940787
Apply fix to debian only
alexm Dec 2, 2019
0b1ccdd
Hint ld that libclntsh deps are needed
alexm Nov 13, 2020
62918b9
The CPAN doesnt recognize .mkd as markdown. Move to .md
djzort Dec 29, 2021
bec4df4
Note merged PR
djzort Dec 29, 2021
3f21a16
prep 1.83 for release
Jan 17, 2022
3759e70
Updated list of OCI versions known to have bind_param_inout
whindsx Jan 19, 2022
978a88b
Include 21.4 in OCI versions known to have bind_param_inout
whindsx Jan 19, 2022
3d7b774
Update changes for GH#140
djzort Jan 22, 2022
caa11e3
Check for appropriate permissions before running 28array_bind.t tests.
whindsx Jan 21, 2022
73d6dcc
Update Changes for GH#141
djzort Jan 22, 2022
2238685
Update 25plsql.t
kjetillll Jan 29, 2022
d4b2b7b
Update Oracle.pm
kjetillll Jan 29, 2022
21c907e
Check for appropriate permissions before running 56embbeded.t tests.
whindsx Jan 27, 2022
cac781e
Have find_headers() also search for header files based off the
whindsx Jan 24, 2022
a4545c2
Update Changes from serveral merged PR
djzort Feb 1, 2022
2511625
Update .mailmap
deanpearce Feb 17, 2022
6449040
Update MANIFEST
djzort Feb 20, 2022
a69f0ca
Update mailmap
djzort Feb 20, 2022
4dd996e
Rewrite of login6
avorop Mar 17, 2022
d516423
Update changes for PR#150
djzort Mar 24, 2022
ac43585
Bump version to dev of v1.90
djzort Mar 24, 2022
ba9d91d
Swap from MetaYAML to MetaJSON
djzort Mar 24, 2022
3ad9cd2
Fix up bugtracker data in META information
djzort Mar 24, 2022
ad42341
Bump docker image to 5.32.1
djzort Mar 25, 2022
d37ca32
Add protection for older OCI
avorop Apr 9, 2022
376714f
Update changelog and bump version to 1.90_2
djzort Apr 14, 2022
3614e6a
Update dbdcnx.c
avorop Apr 20, 2022
8d19502
Update Changes, bump version
djzort Apr 21, 2022
d176dcd
Move from TravisCI to Github Actions (GHA).
whindsx Apr 7, 2022
423d737
Update changes for PR#152
djzort Apr 21, 2022
3ecb172
Convert inline functions to macros
avorop Aug 13, 2022
d3b3718
Add DBI to ConfigureRequires, BuildRequires, and Test Requires - (GH#…
djzort Aug 30, 2022
30849ec
Bump to v1.90_4
djzort Aug 30, 2022
a432797
dbivport.h should be installed as well. GH#159
whindsx Dec 29, 2022
6d0a466
Update changes file and bump version to 1.90_5
djzort Jan 14, 2023
aa8687e
Update README. Point to ::Troubleshooting:: and remove files long
djzort Mar 1, 2023
49dbeaa
specify resources metadata explicitly in dist.ini
haarg Mar 21, 2023
c9b21c1
It's now 2024
djzort Apr 16, 2024
70ef408
Update changes for GH#162
djzort Apr 16, 2024
120e777
Bump version to 1.90
djzort Apr 16, 2024
9dc2ca0
Changing 'return' to block statement, fixing a problem created while …
lzsiga Jun 25, 2024
5122724
Makefile.PL: help ora_libdir find ORACLE_HOME on Gentoo
thesamesam May 27, 2023
a02c0d9
Remove oracle v21 specific code
djzort Jul 18, 2024
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
54 changes: 54 additions & 0 deletions .github/workflows/action.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
name: build

on:
push:
branches:
- "*"
pull_request:
branches:
- "*"
workflow_dispatch:

##
# Adjust container-image for different Perl version
# Adjust services-oracle-image for different OracleXE DB versions
# Adjust container-env-ORACLEV for different InstantClient versions
##
jobs:
build-job:
name: Build Latest
runs-on: ubuntu-latest
container:
image: perldocker/perl-tester:latest
env:
ORACLEV: latest
ORACLE_USERID: kermit/foobar
ORACLE_DSN: 'dbi:Oracle://oracle:1521/XEPDB1'
services:
# Oracle service (label used to access the service container)
oracle:
# Docker Hub image (change the tag "latest" to any other available one)
image: gvenzl/oracle-xe:latest
# Provide passwords and other environment variables to container
env:
ORACLE_PASSWORD: adminpass
APP_USER: kermit
APP_USER_PASSWORD: foobar
# Forward Oracle port
ports:
- 1521:1521
# Provide healthcheck script options for startup
options: >-
--health-cmd healthcheck.sh
--health-interval 10s
--health-timeout 5s
--health-retries 10
steps:
- uses: actions/checkout@v2
- run: apt-get update -y
- run: apt-get install -y libaio1 libaio-dev bc sudo alien
- run: sudo -E maint/scripts/03_install_oracle_instantclient_rpm.bash
- run: . /etc/profile
- run: perl -V
- run: cpanm DBI Test::NoWarnings
- run: perl Makefile.PL && make && make test
16 changes: 16 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
pm_to_blib
MYMETA.yml
Makefile
Makefile.old
Oracle.bs
Oracle.c
Oracle.o
Oracle.xsi
blib
MYMETA.json
dbdimp.o
mk.pm
oci8.o
DBD-Oracle*
project.vim
cpanfile
20 changes: 20 additions & 0 deletions .mailmap
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
Alex Muntada <[email protected]> <[email protected]>
Dean Hamstead <[email protected]> <[email protected]>
Dean Hamstead <[email protected]> <[email protected]>
Dean Hamstead <[email protected]> <[email protected]>
Dean Pearce <[email protected]> <[email protected]>
H.Merijn Brand - Tux <[email protected]> <[email protected]>
John Scoles <[email protected]> <byterock@50811bd7-b8ce-0310-adc1-d9db26280581>
Martin J. Evans <[email protected]> <[email protected]>
Martin J. Evans <[email protected]> <[email protected]>
Martin J. Evans <[email protected]> <[email protected]>
Martin J. Evans <[email protected]> <[email protected]>
Martin J. Evans <[email protected]> <mjevans@50811bd7-b8ce-0310-adc1-d9db26280581>
Michael Portnoy <[email protected]> <[email protected]>
Mike O'Regan <[email protected]> <[email protected]>
Tim Bunce <[email protected]> <timbo@50811bd7-b8ce-0310-adc1-d9db26280581>
Tim Bunce <[email protected]> <[email protected]>
Wesley Hinds <[email protected]> <[email protected]>
Yanick Champoux <[email protected]> <[email protected]>
Yanick Champoux <[email protected]> <yanick@50811bd7-b8ce-0310-adc1-d9db26280581>
Yanick Champoux <[email protected]> <[email protected]>
111 changes: 111 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,111 @@
# CONTRIBUTING

Thank you for considering contributing to {{ $dist }}.
This file contains instructions that will help you work with
the source code.

## Repository branches structure

The two main branches of this repository are:

* **master**

The main development branch. This branch has to
be processed by Dist::Zilla to generate the
code as it will appear in the CPAN distribution. See the
next section for more details.

* **releases**

Contains the code as it appears on CPAN. Each official
release is also tagged with its version.

## Working on the master branch

The distribution is managed with [Dist::Zilla][distzilla].
This means than many of the usual files you might expect
are not in the repository, but are generated at release time.

However, you can run tests directly using the 'prove' tool:

``` bash
$ prove -l
$ prove -lv t/some_test_file.t
$ prove -lvr t/
```

In most cases, 'prove' is entirely sufficient for you to test any
patches you have.

You may need to satisfy some dependencies. The easiest way to satisfy
dependencies is to install the last release -- this is available at
https://metacpan.org/release/{{ $dist }}.

If you use cpanminus, you can do it without downloading the tarball first:

``` bash
$ cpanm --reinstall --installdeps --with-recommends {{ $dist =~ s/-/::/gr }}
```

Dist::Zilla is a very powerful authoring tool, but requires a number of
author-specific plugins. If you would like to use it for contributing,
install it from CPAN, then run one of the following commands, depending on
your CPAN client:

``` bash
$ cpan `dzil authordeps --missing`
$ dzil authordeps --missing | cpanm
```

You should then also install any additional requirements not needed by the
dzil build but may be needed by tests or other development:

``` bash
# cpan `dzil listdeps --author --missing`
$ dzil listdeps --author --missing | cpanm
```

You can also do this via cpanm directly:

``` bash
$ cpanm --reinstall --installdeps --with-develop --with-recommends {{ $dist =~ s/-/::/gr }}
```

Once installed, here are some dzil commands you might try:

``` bash
$ dzil build
$ dzil test
$ dzil test --release
$ dzil xtest
$ dzil listdeps --json
$ dzil build --notgz
```


## This Is Complicated. Is There an Easier Way?

Actually, yes there is. You can also work directly on the `releases` branch,
which corresponds to the code is generated by Dist::Zilla and
correspond to what is uploaded to CPAN.

It won't contain any of the changes brought to the codebase since the last
CPAN release, but for a small patch that shouldn't be a problem.

## Sending Patches

The code for this distribution is hosted on [GitHub][repository].

You can submit bug reports via the [repository's issue track][bugtracker].

You can also submit code changes by forking the repository, pushing your code
changes to your clone, and then submitting a pull request. Detailed
instructions for doing that is available here:

* https://help.github.com/
* https://help.github.com/articles/creating-a-pull-request

[distzilla]: http://dzil.org/.
[repository]: https://github.com/perl5-dbi/DBD-Oracle/
[bugtracker]: https://github.com/perl5-dbi/DBD-Oracle/issues

Loading