From d299b87a145ff1ad39972696c41b518a9ba17cc0 Mon Sep 17 00:00:00 2001 From: Josh Pollock <josh@calderawp.com> Date: Wed, 4 Apr 2018 20:41:21 -0400 Subject: [PATCH] Clean up code --- Tests/Traits/CanCreateEntryWithEmailField.php | 12 +++++----- Tests/Traits/HasFactories.php | 2 +- Tests/Traits/UsersMockFormAsDBForm.php | 2 -- Tests/Unit/Delete/DeleteQueryBuilderTest.php | 9 +++----- ...{DoesQueries.php => CreatesSqlQueries.php} | 7 +++++- src/Delete/DeleteQueryBuilder.php | 5 ++--- src/Delete/DoesDeleteQuery.php | 4 +--- src/Delete/Entry.php | 3 +-- src/Delete/EntryValues.php | 10 ++++----- src/EntryQueries.php | 5 +++++ src/Escape.php | 8 +++---- src/QueriesEntries.php | 5 +++++ src/QueryBuilder.php | 22 ++++++++++++------- src/Select/EntryValues.php | 2 +- src/Select/SelectQueryBuilder.php | 8 ++----- 15 files changed, 55 insertions(+), 49 deletions(-) rename src/{DoesQueries.php => CreatesSqlQueries.php} (72%) diff --git a/Tests/Traits/CanCreateEntryWithEmailField.php b/Tests/Traits/CanCreateEntryWithEmailField.php index c3de5af..16d01bd 100644 --- a/Tests/Traits/CanCreateEntryWithEmailField.php +++ b/Tests/Traits/CanCreateEntryWithEmailField.php @@ -19,19 +19,19 @@ trait CanCreateEntryWithEmailField * * @return int */ - protected function createEntryWithEmail( $email = 'hiroy@hiroy.club' ) + protected function createEntryWithEmail($email = 'hiroy@hiroy.club') { $fieldData = []; $emailFieldConfig = $this->getEmailField(); - foreach( $this->mock_form[ 'fields' ] as $fieldId => $fieldConfig ){ - if ( $fieldId === $emailFieldConfig[ 'ID'] ) { + foreach ($this->mock_form[ 'fields' ] as $fieldId => $fieldConfig) { + if ($fieldId === $emailFieldConfig[ 'ID']) { $fieldData[ $fieldId ] = $email; } else { $fieldData[ $fieldId ] = rand() . $fieldId; } } - return \Caldera_Forms_Save_Final::create_entry( $this->mock_form, $fieldData ); + return \Caldera_Forms_Save_Final::create_entry($this->mock_form, $fieldData); } /** @@ -41,7 +41,7 @@ trait CanCreateEntryWithEmailField */ protected function getEmailField() { - return \Caldera_Forms_Field_Util::get_field_by_slug( 'email', $this->mock_form ); + return \Caldera_Forms_Field_Util::get_field_by_slug('email', $this->mock_form); } /** @@ -53,4 +53,4 @@ trait CanCreateEntryWithEmailField { return $this->getEmailField()[ 'slug' ]; } -} \ No newline at end of file +} diff --git a/Tests/Traits/HasFactories.php b/Tests/Traits/HasFactories.php index ad3e5eb..378b308 100644 --- a/Tests/Traits/HasFactories.php +++ b/Tests/Traits/HasFactories.php @@ -84,7 +84,7 @@ trait HasFactories protected function getWPDB() { global $wpdb; - if (! class_exists( '\WP_User')) { + if (! class_exists('\WP_User')) { include_once dirname(dirname(__FILE__)) . '/Mock/wpdb.php'; } diff --git a/Tests/Traits/UsersMockFormAsDBForm.php b/Tests/Traits/UsersMockFormAsDBForm.php index 595bc9a..cb44455 100644 --- a/Tests/Traits/UsersMockFormAsDBForm.php +++ b/Tests/Traits/UsersMockFormAsDBForm.php @@ -23,6 +23,4 @@ trait UsersMockFormAsDBForm $this->mock_form = \Caldera_Forms_Forms::get_form($this->mock_form_id); parent::setUp(); } - - } diff --git a/Tests/Unit/Delete/DeleteQueryBuilderTest.php b/Tests/Unit/Delete/DeleteQueryBuilderTest.php index e7ad222..a52929f 100644 --- a/Tests/Unit/Delete/DeleteQueryBuilderTest.php +++ b/Tests/Unit/Delete/DeleteQueryBuilderTest.php @@ -3,7 +3,6 @@ namespace calderawp\CalderaFormsQuery\Tests\Unit\Delete; - use calderawp\CalderaFormsQuery\Delete\DeleteQueryBuilder; use calderawp\CalderaFormsQuery\MySqlBuilder; use calderawp\CalderaFormsQuery\Tests\Unit\TestCase; @@ -40,7 +39,6 @@ class DeleteQueryBuilderTest extends TestCase $entryValues = $this->entryValuesDeleteGeneratorFactory(); $this->assertTrue(is_a($entryValues->getBuilder(), MySqlBuilder::class)); - } /** @@ -56,7 +54,6 @@ class DeleteQueryBuilderTest extends TestCase $entryValues = $this->entryValuesDeleteGeneratorFactory(); $this->assertTrue(is_a($entryValues->getDeleteQuery(), Delete::class)); - } /** @@ -68,10 +65,10 @@ class DeleteQueryBuilderTest extends TestCase public function testGetDeleteQueryAndCurrentQueryAreSame() { $entry = $this->entryDeleteGeneratorFactory(); - $this->assertSame( $entry->getDeleteQuery(), $entry->getCurrentQuery() ); + $this->assertSame($entry->getDeleteQuery(), $entry->getCurrentQuery()); $entryValues = $this->entryValuesDeleteGeneratorFactory(); - $this->assertSame( $entryValues->getDeleteQuery(), $entryValues->getCurrentQuery() ); + $this->assertSame($entryValues->getDeleteQuery(), $entryValues->getCurrentQuery()); } /** @@ -99,4 +96,4 @@ class DeleteQueryBuilderTest extends TestCase ->getName() ); } -} \ No newline at end of file +} diff --git a/src/DoesQueries.php b/src/CreatesSqlQueries.php similarity index 72% rename from src/DoesQueries.php rename to src/CreatesSqlQueries.php index 858870f..546475d 100644 --- a/src/DoesQueries.php +++ b/src/CreatesSqlQueries.php @@ -3,7 +3,12 @@ namespace calderawp\CalderaFormsQuery; -interface DoesQueries +/** + * Interface CreatesSqlQueries + * + * Interface that all classes that create SQL queries MUST impliment + */ +interface CreatesSqlQueries { /** diff --git a/src/Delete/DeleteQueryBuilder.php b/src/Delete/DeleteQueryBuilder.php index 3f5d487..f55c08a 100644 --- a/src/Delete/DeleteQueryBuilder.php +++ b/src/Delete/DeleteQueryBuilder.php @@ -3,7 +3,6 @@ namespace calderawp\CalderaFormsQuery\Delete; - use calderawp\CalderaFormsQuery\QueryBuilder; use NilPortugues\Sql\QueryBuilder\Manipulation\Delete; @@ -20,7 +19,7 @@ abstract class DeleteQueryBuilder extends QueryBuilder implements DoesDeleteQuer */ public function getDeleteQuery() { - if( ! $this->deleteQuery ){ + if (! $this->deleteQuery) { $this->deleteQuery = new Delete($this->getTableName()); } @@ -34,4 +33,4 @@ abstract class DeleteQueryBuilder extends QueryBuilder implements DoesDeleteQuer { return $this->getDeleteQuery(); } -} \ No newline at end of file +} diff --git a/src/Delete/DoesDeleteQuery.php b/src/Delete/DoesDeleteQuery.php index f01a333..a8b1571 100644 --- a/src/Delete/DoesDeleteQuery.php +++ b/src/Delete/DoesDeleteQuery.php @@ -3,7 +3,6 @@ namespace calderawp\CalderaFormsQuery\Delete; - use NilPortugues\Sql\QueryBuilder\Manipulation\Delete; /** @@ -20,5 +19,4 @@ interface DoesDeleteQuery * @return Delete */ public function getCurrentQuery(); - -} \ No newline at end of file +} diff --git a/src/Delete/Entry.php b/src/Delete/Entry.php index 1d550bf..edbf882 100644 --- a/src/Delete/Entry.php +++ b/src/Delete/Entry.php @@ -3,7 +3,6 @@ namespace calderawp\CalderaFormsQuery\Delete; - class Entry extends DeleteQueryBuilder { @@ -39,4 +38,4 @@ class Entry extends DeleteQueryBuilder { return $this->is('user_id', $userId); } -} \ No newline at end of file +} diff --git a/src/Delete/EntryValues.php b/src/Delete/EntryValues.php index 5207537..4995cb7 100644 --- a/src/Delete/EntryValues.php +++ b/src/Delete/EntryValues.php @@ -3,7 +3,6 @@ namespace calderawp\CalderaFormsQuery\Delete; - class EntryValues extends DeleteQueryBuilder { @@ -18,7 +17,7 @@ class EntryValues extends DeleteQueryBuilder $this ->getDeleteQuery() ->where() - ->equals( 'entry_id', (int)$entryId ) + ->equals('entry_id', (int)$entryId) ; return $this; } @@ -35,15 +34,14 @@ class EntryValues extends DeleteQueryBuilder $this ->getDeleteQuery() ->where() - ->equals( 'value', $fieldValue ) + ->equals('value', $fieldValue) ; $this ->getDeleteQuery() ->where() - ->equals( 'slug', $fieldSlug ); + ->equals('slug', $fieldSlug); return $this; } - -} \ No newline at end of file +} diff --git a/src/EntryQueries.php b/src/EntryQueries.php index 8bf04f7..c54876e 100644 --- a/src/EntryQueries.php +++ b/src/EntryQueries.php @@ -6,6 +6,11 @@ namespace calderawp\CalderaFormsQuery; use calderawp\CalderaFormsQuery\Select\Entry; use calderawp\CalderaFormsQuery\Select\EntryValues; +/** + * Class EntryQueries + * + * Used to query entry data, using SQL created by genrators + */ class EntryQueries implements QueriesEntries { /** diff --git a/src/Escape.php b/src/Escape.php index f09d066..5191caa 100644 --- a/src/Escape.php +++ b/src/Escape.php @@ -33,8 +33,8 @@ class Escape * @return string Text in the form of a LIKE phrase. The output is not SQL safe. Call $wpdb::prepare() * or real_escape next. */ - public static function like( $text ) { - return addcslashes( $text, '_%\\' ); + public static function like($text) + { + return addcslashes($text, '_%\\'); } - -} \ No newline at end of file +} diff --git a/src/QueriesEntries.php b/src/QueriesEntries.php index 4b173f6..d7f5c4e 100644 --- a/src/QueriesEntries.php +++ b/src/QueriesEntries.php @@ -6,6 +6,11 @@ namespace calderawp\CalderaFormsQuery; use calderawp\CalderaFormsQuery\Select\Entry; use calderawp\CalderaFormsQuery\Select\EntryValues; +/** + * Interface QueriesEntries + * + * Interface that all classes that query for entries MUST impliment + */ interface QueriesEntries { /** diff --git a/src/QueryBuilder.php b/src/QueryBuilder.php index f4075a3..67ef15c 100644 --- a/src/QueryBuilder.php +++ b/src/QueryBuilder.php @@ -3,11 +3,16 @@ namespace calderawp\CalderaFormsQuery; - use calderawp\CalderaFormsQuery\Select\DoesSelectQuery; use NilPortugues\Sql\QueryBuilder\Manipulation\AbstractBaseQuery; -abstract class QueryBuilder implements DoesQueries +/** + * Class QueryBuilder + * + * + * Used to create SQL queries, NOT run SQL queries + */ +abstract class QueryBuilder implements CreatesSqlQueries { const ASC = 'ASC'; const DESC = 'DESC'; @@ -64,7 +69,7 @@ abstract class QueryBuilder implements DoesQueries * @param string $value * @return $this */ - protected function addWhereEquals( AbstractBaseQuery $queryBuilder, $column, $value ) + protected function addWhereEquals(AbstractBaseQuery $queryBuilder, $column, $value) { $queryBuilder ->where() @@ -101,7 +106,8 @@ abstract class QueryBuilder implements DoesQueries */ protected function getSecondDeliminator() { - return $this->isLike ? "%'" : "'"; } + return $this->isLike ? "%'" : "'"; + } /** * Surround one value with quotes or % @@ -112,10 +118,10 @@ abstract class QueryBuilder implements DoesQueries protected function surroundValue($value) { $value = "{$this->getFirstDeliminator()}$value{$this->getSecondDeliminator()}"; - if( ! $this->isLike){ + if (! $this->isLike) { return $value; } - return Escape::like( $value ); + return Escape::like($value); } @@ -128,7 +134,7 @@ abstract class QueryBuilder implements DoesQueries */ protected function is($column, $value) { - return $this->addWhereEquals($this->getCurrentQuery(),$column, $value); + return $this->addWhereEquals($this->getCurrentQuery(), $column, $value); } /** @inheritdoc */ @@ -136,4 +142,4 @@ abstract class QueryBuilder implements DoesQueries { return $this->substituteValues($this->getBuilder()->write($this->getCurrentQuery())); } -} \ No newline at end of file +} diff --git a/src/Select/EntryValues.php b/src/Select/EntryValues.php index d46d3ce..a2f1860 100644 --- a/src/Select/EntryValues.php +++ b/src/Select/EntryValues.php @@ -29,7 +29,7 @@ class EntryValues extends SelectQueryBuilder * @param string $fieldSlug Field slug * @param string $fieldValue Field value * @param string $type Optional. Type of comparison. Values: equals|notEquals|like Default: 'equals' - * @param string $whereOperator Optional. Type of where. Default is 'AND'. Any valid MySQL where operator is accepted + * @param string $whereOperator Optional. Type of where. Default is 'AND'. Any valid WHERE operator is accepted * @return $this */ public function queryByFieldValue($fieldSlug, $fieldValue, $type = 'equals', $whereOperator = 'AND') diff --git a/src/Select/SelectQueryBuilder.php b/src/Select/SelectQueryBuilder.php index c21ab94..16f8fbf 100644 --- a/src/Select/SelectQueryBuilder.php +++ b/src/Select/SelectQueryBuilder.php @@ -3,14 +3,14 @@ namespace calderawp\CalderaFormsQuery\Select; -use calderawp\CalderaFormsQuery\DoesQueries; +use calderawp\CalderaFormsQuery\CreatesSqlQueries; use calderawp\CalderaFormsQuery\MySqlBuilder; use calderawp\CalderaFormsQuery\QueryBuilder; use NilPortugues\Sql\QueryBuilder\Manipulation\AbstractBaseQuery; use NilPortugues\Sql\QueryBuilder\Manipulation\Delete; use NilPortugues\Sql\QueryBuilder\Manipulation\Select; -abstract class SelectQueryBuilder extends QueryBuilder implements DoesSelectQuery +abstract class SelectQueryBuilder extends QueryBuilder implements DoesSelectQuery { /** @@ -47,8 +47,4 @@ abstract class SelectQueryBuilder extends QueryBuilder implements DoesSelectQue $this->getCurrentQuery()->orderBy($column, $order); return $this; } - - - - } -- GitLab