You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I made the change for that the guide don't say that ut3 has the last develop version,
if not that It has the version of utPLSQL of your current branch in your locally repository.
Another change I made was that the last line in the "That's it" section say
this: At any time, if you need to refresh your database, the below scripts might
be helpful.
But next to that section is the "Running unit tests" section, they are not the
script that was being talked about, because they are in the secction following
"Running unit tests". So I changed the order
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+28-29Lines changed: 28 additions & 29 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,19 +1,19 @@
1
1
# How to contribute
2
2
3
3
The following are the guidelines everyone should use to contribute to utPLSQL.
4
-
Changes are welcome from all members of the Community.
4
+
Changes are welcome from all members of the Community.
5
5
6
6
# Getting Started
7
7
8
8
1. Create a [GitHub Account](https://github.com/join).
9
9
2. Fork the utPLSQL Repository and setup your local Repository. _See [how to Fork](https://help.github.com/articles/fork-a-repo) article_
10
-
* Each of the steps below are detailed in **Get started with development** section.
10
+
* Each of the steps below are detailed in **Get started with development** section.
11
11
* Clone your Fork to your local machine.
12
12
* Configure "upstream" remote to the [utPLSQL repository](https://github.com/utPLSQL/utPLSQL.git).
13
13
3. For each change you want to make:
14
14
* Make sure your forked repository is up to date with upstream before you start coding. See [syncing your local repository](https://help.github.com/articles/syncing-a-fork) with upstream utPLSQL repository.
15
15
* Create a new branch for your change. We use `feature/feature_name` or `bugfix/fixed_issue_name` to identify branch types.
16
-
* Make your change in your new branch.
16
+
* Make your change in your new branch.
17
17
* Make sure your change is covered with unit tests.
18
18
***Verify code compiles and all existing and new unit tests pass.**
19
19
* The quickest way to have a Pull Request not approved, is to submit code that does not compile or pass tests.
@@ -27,24 +27,24 @@ Changes are welcome from all members of the Community.
27
27
* We use snake case for all identifiers in PLSQL code. This separates keywords in names with underscores. `execute_test`
28
28
* All code is lower case.
29
29
* Prefixes:
30
-
* Arguments to procedures and functions will start with `a_` an Example would be procedure `is_valid(a_owner_name varchar2)`
30
+
* Arguments to procedures and functions will start with `a_`, an Example would be procedure `is_valid(a_owner_name varchar2)`
31
31
* Object types and packages will start with `ut_`
32
32
* Local variables `l_`
33
33
* Global variables `g_`
34
34
* Global Constants start with `gc_`
35
35
* Types in packages, objects start with `t_`
36
36
* Nested Tables start with `tt_`
37
-
* varchar2 lengths are set in characters not bytes
37
+
* varchar2 lengths are set in characters not bytes
38
38
39
39
40
40
# Configuring local environment
41
41
42
-
Your local environment can be of any flavor (Unix/Linux/Windows/Mac).
42
+
Your local environment can be of any flavor (Unix/Linux/Windows/Mac).
43
43
At minimum you need to have Oracle database 11.2 XE accessible for the project and SYS account access to install and develop utPLSQL.
44
44
45
45
We use four different database accounts (users) for development process.
46
46
*`ut3_latest_release` - holds latest released version of utPLSQL. This schema holds the testing framework used for self-testing of utPLSQL development.
47
-
*`ut3` - holds latest (current) development version of utPLSQL. This is the schema you will be working on.
47
+
*`ut3` - holds the version of utPLSQL of your current branch. This is the schema you will be working on.
48
48
*`ut3_tester` - holds unit test packages for development of utPLSQL.
49
49
*`ut3$user#` - used for testing accessibility to schema names with special characters.
50
50
@@ -56,7 +56,7 @@ To get started with development, follow the below steps.
56
56
57
57
_If you're using Windows, run the shell scripts using `GIT bash` - Windows-based bash command line._
58
58
59
-
### Clone your fork of utPLSQL git repository
59
+
### Clone your fork of utPLSQL git repository
60
60
61
61
```bash
62
62
# clone your fork of utPLSQL
@@ -73,7 +73,7 @@ git fetch --all
73
73
74
74
### Prepare environment script
75
75
76
-
Copy the environment variables template `development/template.env.sh` to `development/env.sh`
76
+
Copy the environment variables template `development/template.env.sh` to `development/env.sh`
77
77
```bash
78
78
cp development/template.env.sh development/env.sh
79
79
chmod u+w development/env.sh
@@ -107,10 +107,26 @@ You now have the following:
107
107
- sources from `master` branch of utPLSQL/utPLSQL repository in `utPLSQL/ut3_latest_release` directory
108
108
- binaries of `utplsql-cli` in `utPLSQL/utPLSQL-cli` directory
109
109
- database users created
110
-
-utPLSQL develop version deployed to`ut3` schema
110
+
-your current branch of utPLSQL deployed into`ut3` schema
111
111
- utPLSQL released version deployed to `ut3_latest_release`
112
112
113
-
At any time, if you need to refresh your database, the below scripts might be helpful.
113
+
At any time, if you need to refresh your database, the below scripts might be helpful.
114
+
115
+
## Cleanup of utPLSQL installation in local database
116
+
117
+
```bash
118
+
development/cleanup.sh
119
+
```
120
+
121
+
## Reinstalling utPLSQL development in `ut3` schema
122
+
123
+
```bash
124
+
development/refresh_ut3.sh
125
+
```
126
+
127
+
## Refreshing after release
128
+
129
+
Whenever a new version of utPLSQL or a new version of utPLSQL-cli is available, use `development/refresh_sources.sh` to refresh files in your local project folders.
You can review the results of tests as well as see information about code coverage in `./old_tests/coverage.html, ./coverage.html` files.
141
157
142
158
143
-
## Cleanup of utPLSQL installation in local database
144
-
145
-
```bash
146
-
development/cleanup.sh
147
-
```
148
-
149
-
## Reinstalling utPLSQL development in `ut3` schema
150
-
151
-
```bash
152
-
development/refresh_ut3.sh
153
-
```
154
-
155
-
## Refreshing after release
156
-
157
-
Whenever a new version of utPLSQL or a new version of utPLSQL-cli is available, use `development/refresh_sources.sh` to refresh files in your local project folders.
158
-
159
-
160
159
## Modules
161
160
162
161
Below diagram gives a high-level overview of utPLSQL v3 modules and their dependencies.
@@ -212,4 +211,4 @@ If you are new to GIT here are some links to help you with understanding how it
0 commit comments